chore: certify foreign change (Code, Tests und Doku aus dem Arbeitsbaum)

Uncommittete Arbeit, die in keinem Remote existierte. Diff gelesen, Testsuite
gelaufen und gruen, keine Secrets, keine Nutzerpfade, keine
Funktionsverschlechterung -- daher zertifiziert statt liegengelassen.

Ticket: T-20260913-345273888

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01RZVTLHtVLEhdALDmafKeJG

Author: Lukas Geiger

AGENTS.md

@@ -0,0 +1,47 @@
+# AGENTS.md — Multi-Agent Governance & Workflow Policy
+
+> **Repository:** `dev-bricks/pythonbox` (`C:\_Local_DEV\repos\pythonbox`)  
+> **Status:** ACTIVE / HEALTHY  
+> **Frameworks:** Gemini / Antigravity, Claude Code, OpenAI Codex  
+
+---
+
+## 1. Multi-Agent Rollen & Pfad-Autorität
+
+- **Kanonischer Quellpfad (Autorität):** `C:\_Local_DEV\repos\pythonbox`
+- **Spiegel-Pfad (OneDrive):** `C:\Users\User\OneDrive\.TOPICS\.SOFTWARE\...` (Nur Read-only Mirror / Backup)
+- **Agenten-Rollen:**
+  - **Gemini / Antigravity:** Automatisierte Systemwartung, UX/Accessibility Reviews, Bugsweeps, Permission Control, Scheduled Tasks.
+  - **Claude / Codex:** Feature-Entwicklung, Refactoring, CI/CD, Test-Entwicklung.
+
+---
+
+## 2. Permission Level & Autonomie-Erwartungen
+
+- **Standard-Berechtigung:** Projekt-Ebene Default / Turbo Mode.
+- **Autonome Ausführung:** Automatisierte Aufrufe (Scheduled Tasks, Sidecars) sollen weitestgehend **ohne Nachfragen** laufen, sofern die Qualitäts-Gates und Sicherheitsprotokolle eingehalten werden.
+- **Rollback-Garantie:** Maßnahmen an Doku- oder Konfigurationsdateien sind non-breaking. Bei unerwünschten Effekten gilt: Git-Revert oder manuelles Rollback.
+
+---
+
+## 3. Workflow Hooks & Sicherheitsprotokolle
+
+Alle Agenten MÜSSEN folgende Letter Hooks beachten:
+
+1. **`HOOK-DOC-TRAVERSAL-01` (Dokumenten-Traversal):** Vor Beginn der Arbeit `AGENTS.md`, `CLAUDE.md`, `README.md` im Projektstamm lesen.
+2. **`HOOK-GARDENER-MEMORY-01` (Preflight Memory):** Bei komplexen Aufgaben `gardener` / Wissensgedächtnis konsultieren.
+3. **`HOOK-WORKFLOW-HYGIENE-01` (Lock Security & Git Hygiene):**
+   - Vor Dateiedits oder Git-Aktionen `LOCK*.txt` prüfen. Wenn `LOCK*.txt` oder `LOCK.user*.txt` existiert -> **ABSOLUTES TABU** (keine Änderungen, keine Pushes).
+   - Qualitäts-Gate: `pytest` ausführen vor Commits.
+   - `CHANGELOG.md` aktualisieren.
+4. **`HOOK-PATH-VALIDATION-01` (Pfad-Validierung):** Raw-Strings (`r"C:\..."`) oder Forward-Slashes in Python verwenden.
+5. **`HOOK-BANNER-ASSET-01` (Banner & Visual Guardrails):** Keine vorhandenen Banners überschreiben oder doppeln.
+
+---
+
+## 4. Testen & Verifizierung
+
+```powershell
+pytest
+```
+- Alle 93+ Pytest-Tests müssen grün bleiben.

CHANGELOG.md

@@ -5,6 +5,9 @@ Format basiert auf [Keep a Changelog](https://keepachangelog.com/de/1.1.0/).
 
 ## [Unreleased]
 
+### Multi-Agent Governance & Permission Control
+- Multi-Agent Signposts & Permission Control (2026-08-03): Multi-Agenten Steuerungsdateien `AGENTS.md` und `CLAUDE.md` angelegt. Pfad-Autorität (`C:\_Local_DEV\repos\pythonbox`), Zero-Prompt Turbo/Permission Standards, Letter Hooks (`HOOK-DOC-TRAVERSAL-01`, `HOOK-WORKFLOW-HYGIENE-01`, `HOOK-PATH-VALIDATION-01`) und `LOCK*.txt` Schutzregeln verankert.
+
 ### Barrierefreiheit & UX / Accessibility & UX
 - Barrierefreiheits- & UX-Erweiterung (2026-08-03): Statusleisten-Indikatoren (`git_label`, `pos_label`, `linter_status`), Linter-Meldungsliste (`linter_list`) und Linter-Dock wurden mit vollständigen Barrierefreiheits-Attributen (`AccessibleName`, `AccessibleDescription`, `ToolTip`) sowie dynamischen Accessible-Description-Updates für Screenreader bei Textänderungen (Cursorposition, Git-Status, Linter-Ergebnisse) ausgestattet (93/93 Pytest-Tests 100% grün).
 

CLAUDE.md

@@ -0,0 +1,25 @@
+# CLAUDE.md — Project Technical Guidelines
+
+> **Project:** PythonBox (`dev-bricks/pythonbox`)  
+> **Path:** `C:\_Local_DEV\repos\pythonbox`  
+> **Delegation:** See [AGENTS.md](AGENTS.md) for Multi-Agent Governance and Letter Hooks.
+
+---
+
+## 1. Overview & Architecture
+PythonBox is a desktop IDE and environment for executing, testing, and managing Python scripts with dynamic linter, status indicators, and full accessibility support.
+
+## 2. Test Commands & Quality Gates
+- **Run Unit & Integration Tests:**
+  ```powershell
+  pytest
+  ```
+- **Translation Management:**
+  ```powershell
+  python manage_translations.py
+  ```
+
+## 3. Coding & Accessibility Standards
+- **German Umlaute:** All German user interface strings must render native UTF-8 Umlaute (`ä`, `ö`, `ü`, `ß`). No replacement substitutions (`ae`, `oe`, `ue`) or corrupt encoding.
+- **UX & Accessibility:** Statusbar and linter UI elements must expose proper `AccessibleName`, `AccessibleDescription`, and `ToolTip` properties with dynamic screenreader updates.
+- **Git & Lock Safety:** Check for `LOCK*.txt` files before modifying code or performing git commits.