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