HAI-Agent-Workflow / docs /README.md
smlflg's picture
Initial public upload from Projekte/HAI-Agent-Workflow
6fa7356 verified
|
Raw History Blame Contribute Delete
4.42 kB

HAI V1.6

Stand: 2026-06-05

Einstieg: REPOSITORY_MAP.md erklaert die Repo-Struktur, den kanonischen Pfad und die Drift-Grenze zum alten Monorepo-Slice.

V1.6 ist ein kleiner Patch auf der akzeptierten V1.5-Linie. Die Pre-Briefing-Kette, der einzelne NEXT_STEP.md-Loop und Gemini-MCP als reiner Fehler-/Unklarheits-Repair bleiben stabil. Neu ist ein eng begrenzter Pair-Modus: HAI darf genau zwei unabhaengige EXECUTION_STEP-Lanes vorbereiten und ausfuehren, wenn die Arbeit ohne menschliche Zwischenfrage sicher getrennt werden kann.

Ziel

HAI soll reibungsfreier arbeiten, ohne Samuels Ownership zu verschieben:

  • maximal zwei unabhaengige naechste Schritte gleichzeitig;
  • jede Lane bleibt ein atomarer EXECUTION_STEP;
  • jede Lane laeuft in einem isolierten Git-Worktree;
  • Samuel wird nur bei Ownership-, Taste-, Risiko-, Credential-, External-Side-Effect- oder echter Unklarheitsfrage zurueckgeholt;
  • erfolgreiche Lanes werden erst nach Validator-ACCEPT in einem Pair-Join zusammengefuehrt.

Preserve

  • Artifact-driven Pre-Briefing.
  • NEXT_STEP.md bleibt kanonisch.
  • Alte kanonische Next Steps bleiben verlustfrei auffindbar: vor jeder Ersetzung werden sie unter Projek-Managment/archive/next_steps/ archiviert und in NEXT_STEP_HISTORY.md indexiert.
  • Feste Kette: hai-executer dann hai-validator.
  • Pair-Lanes nutzen dieselben festen Rollen pro Lane; hai-agent wird nicht selbst zum Coder.
  • Human Gate fuer Commit, Push, Deploy, Auth, Credentials und externe Side Effects.
  • Kein breiter Agenten-Fanout: V1.6 ist ein 2-Lane-System, kein beliebiges Batch-N-System.
  • Entscheidungslast wird reduziert: HAI gibt eine klare Empfehlung mit Begruendung, maximal zwei echte Alternativen und macht die Empfehlung zum Default, wenn Samuel nicht widerspricht.

Implementation

  • Neuer Skill: hai-agent/skills/hai-pair-plan erzeugt Projek-Managment/PAIR_PLAN.md mit Lane A/B, Base Ref, Unabhaengigkeitsbeweis und Autonomy Verdict.
  • Neuer Skill: hai-agent/skills/hai-pair-execution-loop fuehrt die zwei Lanes in Worktrees aus, validiert sie und schreibt PAIR_STATUS.md / PAIR_JOIN_REPORT.md.
  • Bestehender Skill bleibt: hai-agent/skills/hai-execution-loop fuer normale single-step Ausfuehrung und V1.5-Gemini-Eskalation.
  • Neuer Abschluss-Skill: hai-agent/skills/hai-feierabend-podcast erzeugt am Session-Ende eine kurze Podcast-Quelle aus HAI-Artefakten und nutzt voice/multivoice-readaloud fuer mehrere deutsche Stimmen.
  • Kontextnotiz: hai-agent/SOUL.md beschreibt Pair-Modus, Stop-Fragen und die Grenze zu normaler Execution.
  • Registry-Update: hermes-registry/AGENT_REGISTRY.md.

Pair-Lane Boundary

Der Pair-Modus startet nur bei Pair Autonomy Verdict: AUTO_EXECUTION_ALLOWED.

Nicht pair-faehig sind unter anderem:

  • gleiche Datei oder ueberlappender Allowed Changes-Scope;
  • Lockfiles, Migrationen, globale Config oder breite Refactors;
  • Produkt-/Architekturentscheidungen;
  • unklare UI-/Copy-Geschmacksfragen;
  • Commit, Push, Deploy, Account-/Auth-Setup, Credentials oder externe Side Effects.

Wenn mehr als zwei Kandidaten sichtbar sind, waehlt HAI nur die zwei sichersten und nuetzlichsten Lanes und parkt den Rest. Wenn nur ein sicherer Step existiert, nutzt HAI den normalen single-step Loop.

Decision Burden

V1.6 behandelt Owner-Entscheidungen als Interface-Arbeit. HAI soll Samuels Kontrolle erhalten, aber nicht Entscheidungsarbeit auf ihn abladen:

  • eine klare Empfehlung zuerst;
  • kurze Begruendung;
  • hoechstens zwei echte Alternativen;
  • Default: Empfehlung wird kanonischer Next-Step-Shape, wenn Samuel nicht widerspricht;
  • Human Gate bleibt fuer Commit, Push, Deploy, Auth, Credentials, destruktive Befehle und externe Side Effects.

Feierabend Podcast

Wenn Samuel "Feierabend" oder Session-Ende signalisiert, erstellt HAI einen dauerhaften Closeout-Podcast unter Projek-Managment/:

  • FEIERABEND_PODCAST_SOURCE_YYYY-MM-DD_HHMM.md
  • FEIERABEND_PODCAST_REPORT_YYYY-MM-DD_HHMM.md

Die Quelle ist eine kurze multivoice / council-Rollen-Szene, keine rohe Log-Zusammenfassung. Sie nutzt Rollen wie Moderator, Analystin, Kritiker, Produktleiter, Morgenanker und Merksatz. Sie nennt Tagesfakten, Risiken, den Morgenanker und "Nicht heute". Wenn lokale Audioausgabe verfuegbar ist, wird sie mit multivoice-readaloud in mehreren deutschen Stimmen abgespielt; wenn nicht, bleibt der konkrete Playback-Blocker im Report.