Sonstiges

Migrationsleitfaden (v0.15 → v0.16)

REAP v0.16 ist eine vollständige Neuentwicklung basierend auf der Architektur der selbstentwickelnden Pipeline. Der Lebenszyklus, die Genome-Struktur, die Konfiguration und das Vision-System wurden alle neu gestaltet. Ein geführtes Migrationstool übernimmt den Übergang automatisch.

Warum migrieren?

Lebenszyklus neu gestaltet: learning ersetzt objective als erste Phase
Genome in 3 fokussierte Dateien umstrukturiert (application.md, evolution.md, invariants.md)
Vision-Schicht mit 3-Ebenen-Gedächtnis für generationsübergreifende Kontextpersistenz
Merge-Lebenszyklus mit Genome-first-Abstimmung
Dateibasierte Hooks ersetzen Inline-Hook-Konfiguration

Migrationsschritte

Step 1: v0.16 global installieren. Dies stellt automatisch v0.16-Skills bereit und entfernt alte v0.15-Projektebene-Skills.

bash

npm install -g @c-d-cc/reap

Step 2: Öffnen Sie Claude Code in Ihrem Projekt und führen Sie den Migrationsbefehl aus.

bash

/reap.update

Step 3: Folgen Sie der 5-Phasen-geführten Migration:

Phase	Was passiert	Ihre Rolle
confirm	Zeigt an, was sich ändert, erstellt Backup unter .reap/v15/	Überprüfen und bestätigen
execute	Verzeichnisse umstrukturieren, config/hooks/lineage/backlog migrieren	Automatisch
genome-convert	KI rekonstruiert Genome aus v0.15-Dateien in neue 3-Datei-Struktur	KI-Arbeit überprüfen
vision	vision/goals.md und Gedächtnis-Ebenendateien einrichten	Projektrichtung angeben
complete	Zusammenfassung der Migrationsergebnisse	Verifizieren

Step 4: Überprüfen Sie, ob die Migration erfolgreich war.

bash

/reap.status
/reap.evolve

Was sich ändert

Bereich	v0.15	v0.16
Lifecycle	objective → planning → impl → validation → completion (5 Phasen)	learning → planning → impl → validation → completion (4 Phasen)
Genome	Mehrere Dateien, flache Struktur	3 Dateien: application.md + evolution.md + invariants.md
Config	JSON-basierte Konfiguration	YAML-basierte config.yml mit cruiseCount, strictEdit, strictMerge, autoSubagent
Vision	Kein Vision-System	vision/goals.md + 3-Ebenen-Gedächtnis
Hooks	Inline-Konfiguration	Dateibasiert: .reap/hooks/{event}.{name}.{md\|sh}
Environment	Einzelne Wissensdatei	2-Ebenen: summary.md (immer geladen) + domain/ (bei Bedarf)

Unterbrochene Migration

Wenn die Migration unterbrochen wird (API-Fehler, Sitzungsabbruch usw.), wird der Fortschritt in .reap/migration-state.yml gespeichert. Diese Datei verfolgt, welche Phasen abgeschlossen wurden.

Zum Fortsetzen: Führen Sie /reap.update erneut aus. Es überspringt abgeschlossene Phasen und fährt dort fort, wo es aufgehört hat.

Zum Neustart: Löschen Sie .reap/migration-state.yml und führen Sie /reap.update erneut aus.

yaml

# .reap/migration-state.yml (example)
version: "0.16"
phases:
  confirm: completed
  execute: completed
  genome-convert: in-progress
  vision: pending
  complete: pending

Backup

Alle v0.15-Dateien werden während der confirm-Phase unter .reap/v15/ aufbewahrt. Dies ist ein vollständiger Snapshot Ihres Vor-Migrations-Zustands.

Das Backup wird erstellt, bevor destruktive Änderungen auftreten
Nach Überprüfung der Migration (/reap.status, /reap.evolve) können Sie .reap/v15/ sicher löschen
Behalten Sie das Backup mindestens eine vollständige Generation lang, um zu bestätigen, dass alles funktioniert

Veraltete Befehle

Mehrere v0.15-Slash-Befehle wurden in v0.16 umbenannt oder zusammengefasst.

v0.15-Befehl	v0.16-Ersatz	Hinweise
/reap.sync	/reap.knowledge	Verwaltet Genome, Environment und Kontextwissen
/reap.refreshKnowledge	/reap.knowledge reload	Alle Wissensdaten von der Festplatte neu laden
/reap.objective	/reap.run	Phasenweise Befehle durch reap run <stage> ersetzt
/reap.complete	/reap.run	Phasenweise Befehle durch reap run <stage> ersetzt

Alte v0.15-Projektebene-Skill-Dateien werden während npm install automatisch entfernt. Falls noch welche in .claude/commands/ vorhanden sind, können sie sicher gelöscht werden.