Leitfaden

Vision

Vision ist die Schicht, die die Richtung bestimmt. Der Mensch definiert, wohin das Projekt geht — setzt Ziele, Meilensteine und Prioritäten. Die KI referenziert die Vision während der adapt-Phase, um Lücken zu analysieren und das nächste Ziel vorzuschlagen, aber der Mensch besitzt die Vision.

Struktur

text

.reap/vision/
  goals.md              # North star objectives and milestones
  docs/                 # Planning documents, specs, design notes
  memory/               # AI memory (3-tier)
    longterm.md          #   Project lifetime — lessons, decision rationale
    midterm.md           #   Multi-generation — ongoing plans, agreed directions
    shortterm.md         #   1-2 sessions — next session handoff, immediate context

Ziele

goals.md enthält die langfristigen Ziele des Projekts als Checkliste. Während der adapt-Phase analysiert die KI Lücken zwischen Vision und aktuellem Zustand, um das Ziel der nächsten Generation vorzuschlagen. Abgeschlossene Ziele werden automatisch abgehakt.

markdown

# Vision Goals

## Ultimate Goal
Build a self-evolving development pipeline.

## Goal Items
- [x] Core lifecycle implementation
- [x] Merge lifecycle
- [ ] README rewrite for v0.16
- [ ] External project validation

Gedächtnis

Gedächtnis ist ein freiformiges Aufzeichnungssystem, in dem die KI Kontext über Sitzungen und Generationen hinweg persistiert. Im Gegensatz zum Genome (mit Modifikationsbeschränkungen) oder Lineage (wird komprimiert) ist das Gedächtnis immer zugänglich und frei beschreibbar.

Ebene	Rolle	Entscheidungsregel
Shortterm	Session-Übergabe — Kontext für die nächste Sitzung	"Wird das gerade jetzt gebraucht?"
Midterm	Laufende Tracks — generationsübergreifende Arbeit	"Ist das ein unabgeschlossener großer Track?"
Longterm	Design-Lektionen — später erneut lesenswert	"Verhindert das einen wiederholten Fehler?"

Wann aktualisieren

Reflect-Phase — natürlicher Zeitpunkt zum Aktualisieren des Gedächtnisses (shortterm ist bei jeder Generation obligatorisch)
Jederzeit — Gedächtnis kann in jeder Phase aktualisiert werden, wenn nützlicher Kontext entsteht
Shortterm-Bereinigung — erledigte Einträge entfernen

Was NICHT ins Gedächtnis schreiben

Code-Änderungsdetails — gehören in Environment
Testanzahlen oder Build-Status — gehören in Artefakte
Bereits im Genome enthaltene Prinzipien — keine Duplizierung

Lückengesteuerte Evolution

Während der adapt-Phase der Completion führt die KI folgendes aus:

goals.md lesen und Backlog scannen
Unerledigte Ziele und ausstehende Aufgaben identifizieren
Mit dem aktuellen Projektzustand querverweisen
Das Ziel der nächsten Generation basierend auf der wirkungsvollsten Lücke vorschlagen