はじめに

クイックスタート

Upgrading from v0.15? See the Migration Guide instead.

前提条件

必須Node.jsv18以降
必須npmNode.jsに同梱
必須Claude Code or OpenCodeAIエージェントCLI(少なくとも1つ必要)
任意Bun代替パッケージマネージャー

インストール

Global installation required. Local project-level installation is blocked.

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

# or Bun
bun install -g @c-d-cc/reap

プロジェクトの初期化

bash
# In Claude Code, initialize REAP in your project
> /reap.init

最初のGenerationを実行

プロジェクトディレクトリでAIエージェント(Claude Code または OpenCode)を開きます:

bash
# Start a generation — /reap.start will prompt for a goal
> /reap.evolve
/reap.evolve がメインコマンドです

Generationライフサイクル全体 — Learning、Planning、Implementation、Validation、Completion — を自律的に実行します。AIエージェントがすべてのステージを駆動し、本当にブロックされた場合にのみ停止します。日常の開発で最も使用するコマンドです。

手動ステージ制御

各ステージを個別に制御することもできます:

bash
> /reap.start            # Start a new generation (prompts for goal)
> /reap.next             # Advance to next stage
> /reap.back             # Return to previous stage

Generation中に何が起こるか

ステージ内容アーティファクト
Learningプロジェクトの探索、コンテキストの構築、genomeとenvironmentのレビュー01-learning.md
Planningタスクの分解、アプローチの選択、依存関係のマッピング02-planning.md
ImplementationAI + 人間のコラボレーションによる実装03-implementation.md
Validationテストの実行、完了基準の検証04-validation.md
Completion振り返り、フィットネスフィードバックの収集、genome適応、アーカイブ05-completion.md

コマンドの読み込み方法

REAPスラッシュコマンドはREAPプロジェクトでのみ読み込まれます — 非REAPプロジェクトでは表示されません。

ソースコマンドのオリジナルは~/.reap/commands/に保存されます(reap initとreap updateでインストール)
読み込みREAPプロジェクトを開くと、セッションhookが自動的にコマンドを.claude/commands/にシンボリックリンクします
非REAPプロジェクトシンボリックリンクが作成されないため、AIエージェントのスキルリストにREAPスキルは表示されません
後方互換性~/.claude/commands/のリダイレクトスタブにより、移行中の古いセットアップも動作し続けます