Leitfaden

Life Cycle

Der Lebenszyklus ist der Herzschlag von REAP — jede Generation durchläuft 5 Phasen (Learning → Planning → Implementation → Validation → Completion) und erzeugt bei jedem Schritt Artefakte. Completion hat 4 Phasen: reflect → fitness → adapt → commit.

Artefaktstruktur

text

.reap/life/
├── current.yml          # Aktueller Generationsstatus (ID, Ziel, Phase, Timeline)
├── 01-learning.md       # Kontexterkundung, Genome/Environment-Prüfung
├── 02-planning.md       # Aufgabenzerlegung, Abhängigkeiten
├── 03-implementation.md # Implementierungsprotokoll, vorgenommene Änderungen
├── 04-validation.md     # Testergebnisse, Abschlusskriterienprüfung
├── 05-completion.md     # Reflect + Fitness + Adapt + Commit
└── backlog/             # Einträge für nächste Generation
    ├── fix-auth-bug.md  #   type: task
    └── add-index.md     #   type: genome-change

Jede Phase erzeugt ihr Artefakt in .reap/life/. Wenn die Generation abgeschlossen ist, werden alle Artefakte in .reap/lineage/gen-XXX-hash-slug/ archiviert und current.yml wird für die nächste Generation geleert.

/reap.evolve — Die primäre Arbeitsweise

Meistens führen Sie /reap.evolve aus und lassen den KI-Agenten autonom durch alle Phasen steuern. Er kann die gesamte Generation an einen Subagenten delegieren, der alle Phasen durchläuft und nur auftaucht, wenn er wirklich blockiert ist (mehrdeutiges Ziel, bedeutsamer Kompromiss, Genome-Konflikt oder unerwarteter Fehler). Der Subagent übernimmt das Starten, die Ausführung jeder Phase, das Fortschreiten und die Archivierung.

Für feinkörnige Kontrolle können Sie einzelne Phasenbefehle ausführen. Siehe Befehlsreferenz für Details.커맨드 레퍼런스

Phasen-Durchgang

1. Learning

Erkunden Sie das Projekt und bauen Sie Kontext auf. Die KI prüft Genome, Environment, Lineage und bewertet das Klarheitsniveau. Sie baut ein gründliches Verständnis des aktuellen Zustands auf, bevor ein Ziel festgelegt wird.

Output: 01-learning.md — Kontexterkundung, Genome/Environment-Prüfung, Klarheitsbewertung.

2. Planning

Zerlegen Sie das Ziel in umsetzbare Aufgaben. Die KI liest den Kontext aus dem Learning, referenziert Genome-Konventionen und -Einschränkungen und schlägt einen Implementierungsplan mit Architekturentscheidungen vor.

Output: 02-planning.md — phasenweise Aufgabenliste, Abhängigkeiten, parallelisierbare Aufgaben markiert mit [P].

3. Implementation

Schreiben Sie den Code. Aufgaben werden sequenziell ausgeführt, wobei jeder Abschluss sofort erfasst wird. Wenn Genome- oder Environment-Defekte entdeckt werden, werden sie im Backlog protokolliert — nie direkt angewendet. Aufgaben, die von ausstehenden Genome-Änderungen abhängen, werden als [deferred] markiert.

Output: 03-implementation.md — abgeschlossene Aufgabentabelle, aufgeschobene Aufgaben, genome-change Backlog-Einträge.

4. Validation

Überprüfen Sie die Arbeit. Führen Sie Tests, Lint, Build und Typprüfungen aus. Prüfen Sie die Abschlusskriterien und wenden Sie kleinere Korrekturen an (5 Minuten oder weniger, keine Designänderungen). Das Urteil lautet pass, partial (einige Kriterien aufgeschoben) oder fail.

Output: 04-validation.md — Testergebnisse mit tatsächlicher Befehlsausgabe, Kriterienprüfungstabelle, Urteil.

5. Completion (4 Phasen)

Reflect: Retrospektive schreiben + Environment aktualisieren. Fitness: menschliches Feedback sammeln (oder Selbstbewertung im Cruise-Modus). Adapt: Genome prüfen, Backlog-Änderungen anwenden, nächste Generationsziele vorschlagen. Commit: In Lineage archivieren + Git-Commit.

Output: 05-completion.md — Retrospektive, Fitness-Feedback, Genome-Änderungsprotokoll, Hinweise für nächste Generation.

Mikro-Schleife (Regression)

Jede Phase kann zu einer vorherigen Phase zurückkehren. Das ist üblich — Validation schlägt fehl und man kehrt zur Implementation zurück, oder ein Planungsfehler wird während der Implementation entdeckt und man geht zurück zum Planning. Der Regressionsgrund wird in der Timeline und dem Zielartefakt festgehalten.

Artefaktbehandlung bei Regression:

Vor der Zielphase: Unverändert erhalten
Zielphase: Überschrieben (Implementation hängt nur an)
Nach der Zielphase: Erhalten, bei erneutem Eintritt überschrieben

Kleinere Korrektur

Triviale Probleme (Tippfehler, Lint-Fehler usw.) können direkt in der aktuellen Phase ohne Regression behoben werden, solange sie innerhalb von 5 Minuten lösbar sind und keine Designänderungen erfordern. Die Korrektur wird im Phasenartefakt festgehalten.

Rollentrennung

Wer	Rolle
CLI (reap)	Projektsetup und -wartung — init, status, run
KI-Agent	Workflow-Ausführer — führt die Arbeit jeder Phase über Slash-Befehle aus
Mensch	Entscheidungsträger — setzt Ziele, prüft Code, gibt Fitness-Feedback