| # Repository Map |
|
|
| Kurzer Wegweiser fuer den HAI-Agent-Workflow-Slice. |
|
|
| ## Was dieses Repo ist |
|
|
| Dieses Repo ist die kanonische Quelle fuer den HAI-Agent/Executor/Validator-Workflow ab V1.6. Es ist ein privater, lauffaehiger Extrakt aus `~/Projekte/HAI/V1.6/` und ersetzt diesen Monorepo-Pfad als Bearbeitungsort fuer den Agent/Workflow-Slice. |
|
|
|  |
|
|
| ## Top-Level-Struktur |
|
|
| | Pfad | Rolle | Status | |
| |---|---|---| |
| | `profiles/hai-agent/` | Owner-facing HAI-Agent mit SOUL, Config und HAI-Skills | zentrale Steuerflaeche | |
| | `profiles/hai-executer/` | gebundener Executor fuer akzeptierte `EXECUTION_STEP`s | feste Execution-Kette | |
| | `profiles/hai-validator/` | read-only Validator nach Executor-Report | feste Kontrollkette | |
| | `cursor-executer/` | optionale Cursor/Composer-Executor-Lane | Pilot, nicht Default | |
| | `hermes-registry/` | Registry-Auszug fuer Hermes-Agentenrollen | Nachschlageflaeche | |
| | `hai-capability-ledger/` | collect-only Capability-Ledger Skill | Instrumentierung | |
| | `docs/` | V1.6-Spezifikation, Patchplan, Changelog und Contract | Dokumentationskern | |
| | `versions/` | eingefrorene Monorepo-Staende V1 … V2 | Archiv, read-only | |
| | `codex-skills/` | Codex-seitige Skills (`github-autonomy-loop`, `hai-version-cycle`) | Werkzeugkasten | |
| | `Projek-Managment/archify/` | Archify-Diagramme zum Repo-Aufbau | Doku-Beiwerk | |
|
|
| ## Einstiegspunkte |
|
|
| 1. `README.md` lesen: Zweck, Status, Sicherheitsgrenzen. |
| 2. `docs/DIAGRAMS.md` lesen: Bilder und Schaubilder. |
| 3. `docs/README.md` lesen: V1.6-Verhalten und Preserve-Regeln. |
| 4. `docs/V1.6_EXECUTOR_CONTRACT.md` lesen: harte Executor-/Validator-Gates. |
| 5. `profiles/hai-agent/SOUL.md` lesen: Owner-Interface und aktuelle HAI-Regeln. |
|
|
| ## Kanonische Linie |
|
|
| - Kanonisch: dieses Repo. |
| - Herkunft: `~/Projekte/HAI/V1.6/`. |
| - Drift-Risiko: Aenderungen im alten Monorepo-Pfad koennen still auseinanderlaufen. |
| - Empfohlene Regel: Neue Aenderungen hier machen; Monorepo-Pfad spaeter auf Symlink oder Submodule reduzieren. |
| - `versions/` ist eingefroren: Archiv-Snapshots, kein Bearbeitungsort. `versions/V1.6/` doppelt |
| bewusst das Top-Level — kanonisch ist immer das Top-Level, nie die Archiv-Kopie. |
|
|
| ## Nicht im Repo |
|
|
| - Curator-Tarballs aus `skills/.curator_backups/` (11 MB ueber alle Versionen). |
| - Grosse Medien liegen in Git LFS (`*.m4a`), nicht direkt in der Git-Historie. |
| Clone ohne LFS liefert nur Pointer-Dateien; `git lfs pull` holt die Inhalte nach. |
| - Lokale Runtime-Zustaende wie `.hermes/`, `.codex/`, `.agents/`, `sessions/`. |
| - Credentials. `api_key`-Felder in Configs bleiben leer oder lokal injiziert. |
|
|
| ## Sicherheitsgrenzen |
|
|
| - Kein Push, Deploy, Auth-Setup oder Credentials durch den HAI-Agenten ohne Human Gate. |
| - Cursor/Composer ist nur eine optionale narrow-coding Lane; Validator und Human Gate bleiben erhalten. |
| - `hai-executer` committet hoechstens lokal nach Validator-`ACCEPT` und nur wenn die kanonischen Artefakte das eindeutig erlauben. |
|
|
