# 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.

![Repo-Lineage](assets/repo-lineage.svg)

## 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.