なぜREAP？
AIエージェントは強力ですが、構造がなければ開発は混沌とします。コンテキストは毎セッションでリセットされ、コード変更は目的なく散在し、設計ドキュメントは現実と乖離し、過去の作業からの教訓は消え去ります。
コンテキストの喪失
CLAUDE.md + Memoryが毎セッションでプロジェクトのフルコンテキストを自動的に復元します
散在した開発
各世代は構造化されたライフサイクルを通じて一つの目標に集中します
設計とコードの乖離
実装中に発見されたGenomeの変更はbacklogを通じてフィードバックされます
忘れられた教訓
振り返りはGenomeに蓄積され、LineageがすべてのGenerationをアーカイブします
コラボレーションの混乱
Genome優先のmergeワークフローが並行ブランチを調整します — コードの競合より先に設計の競合を解決します
4層アーキテクチャ
REAPは相互接続された4つの層で構成されています：Knowledgeが基盤を提供し、Visionが方向性を示し、Generationが作業を実行し、Civilizationが進化していきます。
Knowledge
Genome + Environment
Genome（規範的 — アーキテクチャ、コンベンション、制約）とEnvironment（記述的 — 技術スタック、ソース構造、ドメイン）。各世代の作業の基盤となります。
Vision
Goals + Memory
長期的な目標と方向性。Visionが各世代を駆動し、次に追求すべき目標を決定します。Memoryはセッション間でコンテキストを持続させます。
Generation
進化サイクル
各GenerationはLearning → Planning → Implementation → Validation → Completionを実行します。完了時にlineageにアーカイブされます。
Civilization
ソースコード
.reap/以外のすべて。世代が進化させるもの。教訓はKnowledgeにフィードバックされます。
Generationライフサイクル
各世代は、目標定義から振り返りとアーカイブまで、5つのステージを経て進行します。
Learning→Planning→Implementation⟷Validation→Completion
| ステージ | 内容 | アーティファクト |
|---|---|---|
| Learning | プロジェクトの探索、コンテキストの構築、genomeとenvironmentのレビュー | 01-learning.md |
| Planning | タスクの分解、アプローチの選択、依存関係のマッピング | 02-planning.md |
| Implementation | AI + 人間のコラボレーションによる実装 | 03-implementation.md |
| Validation | テストの実行、完了基準の検証 | 04-validation.md |
| Completion | 振り返り + フィットネスフィードバック + genome適応 + アーカイブ（4フェーズ） | 05-completion.md |
インストール
1. グローバルにインストール
bash
npm install -g @c-d-cc/reap # Global installation required2. AIエージェント（Claude Code または OpenCode）を開き、初期化して開始
bash
claude
> /reap.init # Set up genome, environment, vision through guided conversation
> /reap.evolve # Run a full generation lifecycle/reap.evolve はLearningからCompletionまでの完全なGenerationライフサイクルを自律的に実行します。ステージコマンドで手動で制御することもできます。
主要コンセプト
Genomeの不変性
Genomeは通常のGeneration中には変更されません。問題はgenome-changeバックログアイテムとして記録され、Completionのadaptフェーズで適用されます。（Embryo generationでは自由な変更が可能です。）
BacklogとDeferral
.reap/life/backlog/のアイテムにはtype: genome-change | environment-change | taskがあります。部分的な完了は正常です — 遅延タスクは次の世代に引き継がれます。
VisionとMemory
Vision（.reap/vision/）が各世代の目標を駆動します。Memoryは3層の自由形式記録システム（longterm/midterm/shortterm）で、AIがセッション間でコンテキストを持続させます。
Lineage
完了したGenerationは.reap/lineage/にアーカイブされます。振り返りはそこに蓄積されます。時間とともに圧縮されます（Level 1 → gen-XXX-{hash}.md、Level 2 → epoch.md）。
4層アーキテクチャ
Vision（目標 + memory）、Knowledge（genome + environment）、Generation（ライフサイクル）、Civilization（ソースコード）。
分散ワークフロー
複数の開発者やエージェントが別々のブランチで並行作業します。/reap.pullがフェッチしてgenome優先のmerge generationを実行します。/reap.pushがプッシュ前に状態を検証します。サーバー不要 — Gitがトランスポート層です。
ドキュメント
イントロダクション
REAPとは何か、なぜ使うのか、4層アーキテクチャ。
クイックスタート
インストールして最初のGenerationをステップバイステップで実行。
コアコンセプト
Genome、ライフサイクル、BacklogとDeferralの詳細。
Life Cycle
/reap.evolve、ステージコマンド、マイクロループ、completionフェーズ。
自己進化
明確性駆動インタラクション、cruiseモード、memory、ギャップ駆動進化。
コマンドリファレンス
/reap.evolve、ステージコマンド、/reap.status — すべてのスラッシュコマンド。
Hookリファレンス
ライフサイクルhooks：ファイルベースのイベントhook、条件、実行順序。
移行ガイド
v0.15からのアップグレード — レジューム対応のステップバイステップ移行。
比較
REAPと従来のスペック駆動開発ツールの比較。
上級
署名ベースのロック、lineage圧縮、エントリーモード。