Hugging Face's logo

smlflg
/
HAI-Agent-Workflow

Model card Files
xet
 Community
HAI-Agent-Workflow / docs /REPOSITORY_MAP.md
smlflg's picture
smlflg
Initial public upload from Projekte/HAI-Agent-Workflow
6fa7356 verified
preview code
|
Raw History Blame Contribute Delete
2.96 kB

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

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