Al0olo/Agents-village

Übergabe

Das Ziel: Der nächste Agent, der keine Erinnerung an diese Unterhaltung hat, setzt fort, ohne jemanden zu fragen und ohne etwas neu abzuleiten.

Zu Beginn

1. Lies docs/HANDOFF.md vollständig, dann die obersten 3 Einträge von docs/handoff/LOG.md.
2. Überprüfe es gegen die Realität: git status, git log --oneline -10, git branch -a und offene PRs (gh api repos/al0olo/agents-village/pulls --jq '.[].title').
3. Wenn Übergabe und Realität nicht übereinstimmen, glaube der Realität, korrigiere dann die Übergabe, bevor du neue Arbeit beginnst, und vermerke dies im Log.
4. Gib dem Benutzer den nächsten Schritt in ein oder zwei Sätzen wieder und führe ihn dann aus.

Während der Arbeit

Aktualisiere docs/HANDOFF.md sofort, wenn eines dieser Ereignisse eintritt: eine Arbeitseinheit wird abgeschlossen, eine Entscheidung wird getroffen, ein Ansatz schlägt fehl, du entdeckst eine Eigenart der Umgebung, du erstellst oder schließt einen PR.

Am Ende (oder wenn unterbrochen)

1. Schreibe docs/HANDOFF.md mit der folgenden Vorlage neu. Es ist der aktuelle Zustand, nicht die Historie: ersetze veraltete Zeilen, häufe keine an.
2. Füge einen datierten Eintrag in docs/handoff/LOG.md ein (neueste zuerst): was du getan hast, warum, was fehlgeschlagen ist, Links. Die Historie lebt dort.
3. Führe scripts/check-handoff.sh aus und committe die Übergabe mit der Arbeit.
4. Letzte Nachricht an den Benutzer: was erledigt ist, was als nächstes kommt, alles, was seine Entscheidung benötigt.

Vorlage für docs/HANDOFF.md

# Handoff
Aktualisiert: YYYY-MM-DD von <Agent/Modell> · Branch: <Name> · Letzter Commit: <SHA>

## Ziel
Ein Absatz: was das Projekt gerade erreichen will.

## Zustand
- Erledigt: Element (PR #n)
- In Bearbeitung: Element, genau wo es gestoppt wurde, nicht committete Dateien falls vorhanden
- Nicht begonnen: Element

## Nächster Schritt
Die einzelne nächste Aktion, konkret genug, um sofort zu beginnen, mit Befehlen.

## Warteschlange
Geordnete Liste nach dem nächsten Schritt.

## Offene Entscheidungen (Eigentümer muss entscheiden)
Frage, Optionen, meine Empfehlung.

## Stolperfallen
Eigenarten der Umgebung, fehlgeschlagene Ansätze und warum, Dinge, die falsch aussehen aber beabsichtigt sind.

## So überprüfst du
Befehle, die beweisen, dass der aktuelle Zustand in Ordnung ist.

## Verweise
Dateien und Dokumente zum vertiefenden Lesen.

Qualitätsanspruch

• Nenne Dateien, Branches, PR-Nummern, Befehle. Kein „wie oben“, kein „das besprochene Ding“.
• Halte fehlgeschlagene Ansätze und warum fest, damit niemand sie wiederholt.
• Trenne, was du überprüft hast, von dem, was du annimmst, und sage, was was ist.
• Halte docs/HANDOFF.md unter etwa 150 Zeilen; verschiebe Historie ins Log.