REAP LogoREAPdocsv0.17.7
ガイド

Life Cycle

ライフサイクルはREAPの心臓部です — 各世代は5つのステージ（Learning → Planning → Implementation → Validation → Completion）を流れ、各ステップでアーティファクトを生成します。Completionには4つのフェーズがあります：reflect → fitness → adapt → commit。

アーティファクト構造

text
.reap/life/
├── current.yml          # 現在のGeneration状態（id、goal、stage、timeline）
├── 01-learning.md       # コンテキスト探索、genome/environmentレビュー
├── 02-planning.md       # タスク分解、依存関係
├── 03-implementation.md # 実装ログ、変更内容
├── 04-validation.md     # テスト結果、完了基準チェック
├── 05-completion.md     # reflect + fitness + adapt + commit
└── backlog/             # 次世代へのアイテム
    ├── fix-auth-bug.md  #   type: task
    └── add-index.md     #   type: genome-change

各ステージは.reap/life/にアーティファクトを生成します。Generationが完了すると、すべてのアーティファクトが.reap/lineage/gen-XXX-hash-slug/にアーカイブされ、current.ymlは次のGenerationのためにクリアされます。

/reap.evolve — 主要な作業方法

/reap.evolveを実行し、AIエージェントにすべてのステージを自律的に進行させるのが基本です。Generation全体をサブエージェントに委任でき、本当にブロックされた場合（曖昧な目標、重大なトレードオフ、genome競合、予期しないエラー）にのみ介入を求めます。サブエージェントは開始、各ステージの実行、進行、アーカイブを処理します。

細かい制御が必要な場合は、個別のステージコマンドを実行できます。詳細はコマンドリファレンスを参照してください。커맨드 레퍼런스

ステージ別ウォークスルー

1. Learning

プロジェクトを探索しコンテキストを構築します。AIはgenome、environment、lineageをレビューし、明確性レベルを評価します。目標設定の前に現在の状態を徹底的に理解します。

Output: 01-learning.md — コンテキスト探索、genome/environmentレビュー、明確性評価。

2. Planning

目標を実行可能なタスクに分解します。AIはlearningのコンテキストを読み、genomeのコンベンションと制約を参照し、アーキテクチャ決定を含む実装計画を提案します。

Output: 02-planning.md — フェーズ分けされたタスクリスト、依存関係、並列可能タスクは[P]でマーク。

3. Implementation

コードを構築します。タスクは順次実行され、各完了は即座に記録されます。genomeやenvironmentの欠陥が発見された場合はbacklogに記録され、直接適用されることはありません。保留中のgenome変更に依存するタスクは[deferred]とマークされます。

Output: 03-implementation.md — 完了タスクテーブル、遅延タスク、genome-changeバックログアイテム。

4. Validation

作業を検証します。テスト、lint、ビルド、型チェックを実行します。完了基準を確認し、軽微な修正（5分以内、設計変更なし）を適用します。判定はpass、partial（一部基準を遅延）、またはfailです。

Output: 04-validation.md — 実際のコマンド出力を含むテスト結果、基準チェックテーブル、判定。

5. Completion（4フェーズ）

Reflect：振り返りを書き、environmentを更新。Fitness：人間のフィードバックを収集（cruiseモードでは自己評価）。Adapt：genomeをレビューし、backlogの変更を適用し、次世代の目標を提案。Commit：lineageにアーカイブ + gitコミット。

Output: 05-completion.md — 振り返り、フィットネスフィードバック、genome変更ログ、次世代へのヒント。

マイクロループ（リグレッション）

どのステージでも前のステージに戻ることができます。これは一般的なことです — validationが失敗してimplementationに戻る、またはimplementation中にplanningの欠陥が見つかりplanningに戻るなど。リグレッションの理由はタイムラインと対象アーティファクトに記録されます。

リグレッション時のアーティファクト処理：

  • 対象ステージより前： そのまま保持
  • 対象ステージ： 上書き（implementationのみ追記）
  • 対象ステージより後： 保持され、再入時に上書き

軽微な修正

些細な問題（タイポ、lintエラーなど）は、5分以内に解決でき設計変更が不要な場合、リグレッションなしで現在のステージで直接修正できます。修正はステージアーティファクトに記録されます。

役割分担

誰が役割
CLI (reap)プロジェクトのセットアップとメンテナンス — init、status、run
AIエージェントワークフロー実行者 — スラッシュコマンドで各ステージの作業を遂行
人間意思決定者 — 目標設定、コードレビュー、フィットネスフィードバックの提供