Leitfaden

Environment

Environment ist das deskriptive Wissen des Projekts — was aktuell existiert. Es erfasst Tech-Stack, Quellstruktur, Build-Konfiguration, Domänenwissen und Code-Abhängigkeiten. Anders als das Genome (präskriptiv — wie man baut), beschreibt Environment den aktuellen Zustand.

2-Stufen-Struktur

text

.reap/environment/
├── summary.md      # Immer geladen (~250 Zeilen) — Tech-Stack, Quellstruktur, Build, Tests
├── domain/         # Domänenwissen (bei Bedarf)
├── resources/      # Externe Referenzdokumente — API-Docs, SDK-Spezifikationen (bei Bedarf)
├── docs/           # Projekt-Referenzdokumente — Designdokumente, Spezifikationen (bei Bedarf)
└── source-map.md   # Code-Struktur + Abhängigkeiten (bei Bedarf)

Stufen

Stufe	Laden	Inhalt	Limit
summary.md	Immer beim Sitzungsstart geladen	Tech-Stack, Quellstruktur, Build-Konfiguration, Test-Setup. Das Grundverständnis der KI.	~250 Zeilen
domain/	Bei Bedarf (geladen wenn nötig)	Domänenwissen — Geschäftsregeln, API-Spezifikationen, Infrastrukturdetails.	Kein Limit
resources/	Bei Bedarf (geladen wenn nötig)	Externe Referenzdokumente — API-Docs, SDK-Spezifikationen, Drittanbieter-Dokumentation.	Kein Limit
docs/	Bei Bedarf (geladen wenn nötig)	Projekt-Referenzdokumente — Designdokumente, Spezifikationen, Architekturentscheidungen.	Kein Limit
source-map.md	Bei Bedarf (geladen wenn nötig)	Aktuelle Code-Struktur und Abhängigkeitskarte.	Kein Limit

Environment-Unveränderlichkeit

Wie das Genome wird das Environment während einer Generation nie direkt verändert. Änderungen werden als environment-change Backlog-Einträge erfasst und während der Completion Reflect-Phase angewendet.

Durch das Erfassen von Änderungen im Backlog statt Environment während der Generation umzuschreiben, wird die Generation auf einer stabilen Grundlage abgeschlossen. Die Aktualisierung erfolgt einmalig, bewusst, während der Reflect-Phase mit vollem Kontext über das Entwickelte.

Ladestrategie

summary.md wird immer beim Sitzungsstart geladen. domain/ und source-map.md werden bei Bedarf geladen, wenn die KI tieferen Kontext für eine bestimmte Aufgabe benötigt.

Wissensmanagement

Verwenden Sie /reap.knowledge zum Überprüfen und Verwalten des Environment. Während der Completion Reflect-Phase aktualisiert die KI automatisch das Environment, um Änderungen widerzuspiegeln, die während der Generation vorgenommen wurden.

summary.md

Immer geladen

Kompakte Übersicht über den technischen Zustand des Projekts. In jede Sitzung geladen, damit die KI den Grundkontext hat.

domain/ + resources/ + docs/ + source-map.md

Bei Bedarf

Tieferes Wissen, geladen wenn die KI spezifischen Domänen-, externen Referenz- oder strukturellen Kontext für die aktuelle Aufgabe benötigt.

Die 2-Stufen-Strategie balanciert Kontextfenster-Effizienz (summary.md ist klein) mit Tiefe (domain/ und source-map.md sind bei Bedarf verfügbar).