REAP LogoREAPdocsv0.17.7
その他

マイグレーションガイド (v0.15 → v0.16)

REAP v0.16 は自己進化パイプラインアーキテクチャに基づく完全な書き直しです。ライフサイクル、genome 構造、設定、ビジョンシステムがすべて再設計されました。ガイド付きマイグレーションツールが自動的に移行を処理します。

なぜマイグレーションが必要？

  • ライフサイクルの再設計：learning が最初のステージとして objective を置換
  • Genome が 3 つの焦点ファイルに再構成（application.md、evolution.md、invariants.md）
  • Generation 間のコンテキスト永続化のための 3 層メモリを持つビジョンレイヤー
  • Genome ファーストの調整を持つ Merge ライフサイクル
  • ファイルベースの Hook がインライン Hook 設定を置換

マイグレーション手順

Step 1: v0.16 をグローバルにインストールします。v0.16 スキルが自動デプロイされ、レガシー v0.15 プロジェクトレベルスキルが削除されます。

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

Step 2: プロジェクトで Claude Code を開き、マイグレーションコマンドを実行します。

bash
/reap.update

Step 3: 5 フェーズのガイド付きマイグレーションに従います：

フェーズ実行内容あなたの役割
confirm変更内容を表示し、.reap/v15/ にバックアップを作成確認
executeディレクトリ再構成、config/hooks/lineage/backlog のマイグレーション自動
genome-convertAI が v0.15 ファイルから新しい 3 ファイル構造に genome を再構築AI の作業を確認
visionvision/goals.md とメモリ階層ファイルのセットアッププロジェクトの方向を提供
completeマイグレーション結果のサマリー検証

Step 4: マイグレーションが成功したか確認します。

bash
/reap.status
/reap.evolve

変更点

領域v0.15v0.16
Lifecycleobjective → planning → impl → validation → completion（5 フェーズ）learning → planning → impl → validation → completion（4 フェーズ）
Genome複数ファイル、フラット構造3 ファイル：application.md + evolution.md + invariants.md
ConfigJSON ベースの設定YAML ベースの config.yml（cruiseCount、strictEdit、strictMerge、autoSubagent）
Visionビジョンシステムなしvision/goals.md + 3 層メモリ
Hooksインライン設定ファイルベース：.reap/hooks/{event}.{name}.{md|sh}
Environment単一の知識ファイル2 層：summary.md（常時ロード）+ domain/（オンデマンド）

中断されたマイグレーション

マイグレーションが中断された場合（API エラー、セッション切断など）、進行状況は .reap/migration-state.yml に保存されます。このファイルは完了したフェーズを追跡します。

再開するには： /reap.update を再度実行してください。完了したフェーズをスキップし、中断した箇所から続行します。

最初からやり直すには： .reap/migration-state.yml を削除し、/reap.update を再度実行してください。

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

バックアップ

すべての v0.15 ファイルは confirm フェーズで .reap/v15/ に保存されます。これはマイグレーション前の状態の完全なスナップショットです。

  • バックアップは破壊的な変更が行われる前に作成されます
  • マイグレーションの動作確認後（/reap.status、/reap.evolve）、.reap/v15/ を安全に削除できます
  • すべてが正常に動作することを確認するため、少なくとも 1 つの完全な Generation の間バックアップを保持してください

非推奨コマンド

いくつかの v0.15 スラッシュコマンドが v0.16 で名前変更または統合されました。

v0.15 コマンドv0.16 代替備考
/reap.sync/reap.knowledgegenome、environment、コンテキスト知識の管理
/reap.refreshKnowledge/reap.knowledge reloadディスクからすべての知識を再読み込み
/reap.objective/reap.runステージごとのコマンドが reap run <stage> に置換
/reap.complete/reap.runステージごとのコマンドが reap run <stage> に置換

レガシー v0.15 プロジェクトレベルスキルファイルは npm install 時に自動的に削除されます。.claude/commands/ に残っている場合は安全に削除できます。