@c-d-cc/reap 0.1.1 → 0.1.3

package/README.ja.md

@@ -0,0 +1,315 @@
+<p align="center">
+  <img src="media/logo.png" alt="REAP" width="80" height="80" />
+</p>
+
+<h1 align="center">REAP</h1>
+
+<p align="center">
+  <strong>Recursive Evolutionary Autonomous Pipeline</strong><br>
+  AIと人間がGenerationを重ねてソフトウェアを進化させる開発パイプライン。
+</p>
+
+> [English](README.md) | [한국어](README.ko.md) | [简体中文](README.zh-CN.md)
+
+<table align="center">
+<tr>
+<td align="center"><strong>Genome</strong><br><sub>設計とナレッジ</sub></td>
+<td align="center">→</td>
+<td align="center"><strong>Evolution</strong><br><sub>世代を超えた進化</sub></td>
+<td align="center">→</td>
+<td align="center"><strong>Civilization</strong><br><sub>Source Code</sub></td>
+</tr>
+</table>
+
+REAPはアプリケーションの遺伝情報（Genome）を定義し、各世代で目標を設定して実装し、その過程で発見したGenomeの欠陥を次のステージにフィードバックします。世代を重ねるごとにGenomeが進化し、Source Code（Civilization）が成長します。
+
+## なぜREAPか？
+
+AIエージェントと開発する際、こんな問題に遭遇したことはありませんか？
+
+- **コンテキストの喪失** — 新しいセッションを開くとエージェントがプロジェクトのコンテキストを忘れる
+- **散発的な開発** — 明確な目標なくあちこちのコードを修正
+- **設計とコードの乖離** — ドキュメントとコードが時間とともに離れていく
+- **教訓の忘却** — 苦労して得たインサイトが次の作業に反映されない
+
+REAPは**世代ベースの進化モデル**でこれらの問題を解決します：
+
+- 各世代は一つの目標に集中（Objective → Completion）
+- AIエージェントが毎セッション開始時に現在のコンテキストを自動認識（SessionStart Hook）
+- 実装中に発見した設計問題はbacklogに記録、Completionで反映
+- レトロスペクティブ（Completion）で導き出した教訓がGenomeに蓄積
+
+## インストール
+
+```bash
+# npm
+npm install -g @c-d-cc/reap
+
+# または Bun
+bun install -g @c-d-cc/reap
+```
+
+> **要件**: [Node.js](https://nodejs.org) v18+、[Claude Code](https://claude.ai/claude-code) CLI。[Bun](https://bun.sh)はオプションです。
+
+## クイックスタート
+
+```bash
+# 1. プロジェクトの初期化
+
+# 新規プロジェクト
+reap init my-project
+
+# 既存プロジェクト
+cd my-project
+reap init
+
+# 2. Claude Codeで1つのGeneration全体を実行
+claude
+> /reap.evolve "ユーザー認証の実装"
+```
+
+`/reap.evolve`は1つのGenerationのライフサイクル全体を — ObjectiveからCompletionまで — ユーザーと対話しながら自動実行します。Generation作成、各ステージの実行、ステージ間の前進をすべて処理します。日常の開発で最も多く使う中心的なコマンドです。
+
+より細かい制御が必要な場合は、各ステージを手動で進めることもできます：
+
+```bash
+> /reap.start            # 新しいGenerationを開始
+> /reap.objective        # 目標 + 仕様を定義
+> /reap.next             # 次のステージへ前進
+> /reap.planning         # 実装計画
+> /reap.next
+> /reap.implementation   # AI+Human協力でコード実装
+> ...
+```
+
+## ライフサイクル
+
+各Generation（世代）は5段階のライフサイクルを経ます：
+
+```
+Objective → Planning → Implementation ⟷ Validation → Completion
+（目標定義）  （計画）     （実装）             （検証）     （完了）
+```
+
+| ステージ | 内容 | 成果物 |
+|----------|------|--------|
+| **Objective** | 目標 + 要件 + 受入基準の定義 | `01-objective.md` |
+| **Planning** | タスク分解、実装アプローチ、依存関係 | `02-planning.md` |
+| **Implementation** | AI+Human協力でコード実装 | `03-implementation.md` |
+| **Validation** | テスト実行、完了条件の確認 | `04-validation.md` |
+| **Completion** | レトロスペクティブ + Genome変更反映 + アーカイブ | `05-completion.md` |
+
+## コアコンセプト
+
+### Genome
+
+アプリケーションの遺伝情報 — アーキテクチャ原則、ビジネスルール、開発コンベンション、技術制約の集合。
+
+```
+.reap/genome/
+├── principles.md      # アーキテクチャ原則/決定
+├── domain/            # ビジネスルール（モジュール別）
+├── conventions.md     # 開発ルール/コンベンション
+└── constraints.md     # 技術制約/選択
+```
+
+**Genome不変原則**: 現在の世代ではGenomeを直接変更しません。問題を発見した場合はbacklogに記録し、Completionステージでのみ反映します。
+
+**Environment不変原則**: 現在の世代ではEnvironmentを直接変更しません。外部環境の変化を発見した場合はbacklogに記録し、Completionステージで反映します。
+
+### Backlog
+
+`.reap/life/backlog/`に次に反映するすべての項目を保存します。各項目はmarkdown + frontmatter形式：
+
+- `type: genome-change` — CompletionでGenomeに反映
+- `type: environment-change` — CompletionでEnvironmentに反映
+- `type: task` — 次のObjectiveでのgoal候補（deferredタスク、技術的負債など）
+
+各項目は`status`フィールドも持ちます：
+
+- `status: pending` — 未処理項目（デフォルト）
+- `status: consumed` — 現在の世代で処理完了（`consumedBy: gen-XXX`必須）
+
+アーカイブ時点（`/reap.next` from Completion）で`consumed`項目はlineageに移動し、`pending`項目は次の世代のbacklogに繰り越されます。
+
+**部分完了は正常** — Genome変更に依存するタスクは`[deferred]`とマークし、次の世代に引き継ぎます。
+
+### 4軸構造
+
+```
+.reap/
+├── genome/        # 遺伝情報（世代を超えて進化）
+├── environment/   # 外部環境（APIドキュメント、インフラ、ビジネス制約）
+├── life/          # 現在の世代の状態と成果物
+└── lineage/       # 完了した世代のアーカイブ
+```
+
+## CLIコマンド
+
+| コマンド | 説明 |
+|----------|------|
+| `reap init <name>` | プロジェクト初期化。`.reap/`構造を作成 |
+| `reap status` | 現在のGeneration状態を確認 |
+| `reap update` | コマンド/テンプレート/hookを最新バージョンに同期 |
+| `reap fix` | `.reap/`構造の診断と修復 |
+| `reap help` | CLIコマンド + スラッシュコマンド + ワークフロー概要を出力 |
+
+### オプション
+
+```bash
+reap init my-project --mode adoption    # 既存プロジェクトにREAPを適用
+reap init my-project --preset bun-hono-react  # プリセットでGenomeを初期化
+reap update --dry-run                   # 変更のプレビュー
+```
+
+## Claude Code連携
+
+REAPはClaude Codeの2つのメカニズムでAIエージェントと統合します：
+
+### スラッシュコマンド
+
+スラッシュコマンドが`.claude/commands/`にインストールされ、ワークフロー全体を駆動します：
+
+| コマンド | 説明 |
+|----------|------|
+| `/reap.start` | 新しいGenerationを開始 |
+| `/reap.objective` | 目標 + 要件の定義 |
+| `/reap.planning` | タスク分解 + 実装計画 |
+| `/reap.implementation` | AI+Human協力でコード実装 |
+| `/reap.validation` | テスト実行、完了条件の確認 |
+| `/reap.completion` | レトロスペクティブ + Genome変更反映 |
+| `/reap.next` | 次のライフサイクルステージへ前進 |
+| `/reap.back` | 前のステージに回帰（micro loop） |
+| `/reap.status` | 現在のGeneration状態とプロジェクト健全性を表示 |
+| `/reap.sync` | ソースコードベースでGenomeを最新化 |
+| `/reap.help` | 現在の状態に応じたcontextual AIヘルプ（topic: workflow, commands, strict, genome, backlog） |
+| **`/reap.evolve`** | **1つのGeneration全体を最初から最後まで実行（推奨）** |
+
+### SessionStart Hook
+
+毎セッション開始時に自動実行され、AIエージェントに以下を注入します：
+
+- REAPワークフロー全体のガイド（Genome、ライフサイクル、4軸構造など）
+- 現在のGeneration状態（どのステージにいるか、次に何をすべきか）
+- REAPライフサイクルに従うルール
+
+これにより、新しいセッションを開いてもエージェントがプロジェクトコンテキストを即座に把握します。
+
+### Strictモード
+
+`.reap/config.yml`に`strict: true`を設定すると、AIエージェントがREAPワークフロー外でコードを変更することを制限します：
+
+```yaml
+# .reap/config.yml
+strict: true   # デフォルト: false
+```
+
+| 状況 | 動作 |
+|------|------|
+| アクティブGenerationなし / 実装ステージ外 | コード変更は完全にブロック |
+| Implementationステージ | `02-planning.md`の範囲内でのみ変更許可 |
+| エスケープハッチ | ユーザーが「override」「bypass strict」等を明示的に要求した場合に許可 |
+
+Strictモードはデフォルトで無効です（`strict: false`）。
+
+### REAP Hooks
+
+`.reap/config.yml`にhookを定義して、ライフサイクルイベントでコマンドやAIプロンプトを実行できます：
+
+```yaml
+hooks:
+  onGenerationStart:
+    - command: "echo 'Generation started'"
+  onStageTransition:
+    - command: "echo 'Stage changed'"
+  onGenerationComplete:
+    - command: "reap update"
+    - prompt: "今回のGenerationで変更された機能があればREADMEに反映せよ。"
+  onRegression:
+    - command: "echo 'Regressed'"
+```
+
+各hookは`command`（シェルコマンド）または`prompt`（AIエージェント指示）のいずれかを使用します。
+
+| イベント | トリガー |
+|----------|----------|
+| `onGenerationStart` | `/reap.start`で新しいGeneration作成後 |
+| `onStageTransition` | `/reap.next`で次のステージに前進後 |
+| `onGenerationComplete` | `/reap.next`で完了したGenerationをアーカイブ後 |
+| `onRegression` | `/reap.back`で前のステージに回帰後 |
+
+HookはAIエージェントがプロジェクトルートディレクトリで実行します。
+
+## `reap init`後のプロジェクト構造
+
+```
+my-project/
+├── src/                          # Civilization（ソースコード）
+└── .reap/
+    ├── config.yml                # プロジェクト設定
+    ├── genome/                   # 遺伝情報
+    │   ├── principles.md
+    │   ├── domain/
+    │   ├── conventions.md
+    │   └── constraints.md
+    ├── environment/              # 外部環境
+    ├── life/                     # 現在の世代
+    │   ├── current.yml
+    │   └── backlog/
+    └── lineage/                  # 完了した世代のアーカイブ
+
+~/.claude/                        # ユーザーレベル（reap initでインストール）
+├── commands/                     # スラッシュコマンド（/reap.*）
+└── settings.json                 # SessionStart hookの登録
+```
+
+## 系譜圧縮（Lineage Compression）
+
+世代が蓄積されるとlineageディレクトリが大きくなります。REAPは自動2段階圧縮でこれを管理します：
+
+| レベル | 入力 | 出力 | 最大行数 | トリガー |
+|--------|------|------|----------|----------|
+| **Level 1** | 世代フォルダ（5つの成果物） | `gen-XXX.md` | 40行 | lineage > 10,000行 + 5世代以上 |
+| **Level 2** | Level 1ファイル5つ | `epoch-XXX.md` | 60行 | Level 1が5つ以上 |
+
+圧縮は世代完了時に自動実行されます。圧縮されたファイルは目標（Objective）と結果（Completion）を中心に保存し、中間過程は特記事項のみを残します。
+
+## 進化フロー（Evolution Flow）
+
+```
+Generation #1 (Genome v1)
+  → Objective: "ユーザー認証の実装"
+  → Planning → Implementation
+  → Implementation中にOAuth2の必要性を発見 → backlogにgenome-changeを記録
+  → Validation (partial)
+  → Completion → レトロスペクティブ + genome反映 → Genome v2 → アーカイブ
+
+Generation #2 (Genome v2)
+  → Objective: "OAuth2連携 + 権限管理"
+  → 前世代のdeferredタスク + 新しい目標
+  → ...
+```
+
+## プリセット（Presets）
+
+`reap init --preset`で技術スタックに合ったGenome初期設定を適用できます。
+
+| プリセット | スタック |
+|------------|----------|
+| `bun-hono-react` | Bun + Hono + React |
+
+```bash
+reap init my-project --preset bun-hono-react
+```
+
+## エントリーモード（Entry Modes）
+
+| モード | 説明 |
+|--------|------|
+| `greenfield` | ゼロから新しいプロジェクトを構築（デフォルト） |
+| `migration` | 既存システムを参照しながら新規構築 |
+| `adoption` | 既存コードベースにREAPを適用 |
+
+## ライセンス
+
+MIT

package/README.ko.md

@@ -9,7 +9,7 @@
   AI와 인간이 세대(Generation)를 거듭하며 소프트웨어를 진화시키는 개발 파이프라인.
 </p>
 
-> For English version, see [README.md](README.md).
+> [English](README.md) | [日本語](README.ja.md) | [简体中文](README.zh-CN.md)
 
 <table align="center">
 <tr>
@@ -49,7 +49,7 @@ npm install -g @c-d-cc/reap
 bun install -g @c-d-cc/reap
 ```
 
-> **요구사항**: [Bun](https://bun.sh) 런타임, [Claude Code](https://claude.ai/claude-code) CLI
+> **요구사항**: [Node.js](https://nodejs.org) v18+, [Claude Code](https://claude.ai/claude-code) CLI. [Bun](https://bun.sh)은 선택사항.
 
 ## 빠른 시작
 

package/README.md

@@ -9,7 +9,7 @@
   A development pipeline where AI and humans evolve software across generations.
 </p>
 
-> 한국어 버전은 [README.ko.md](README.ko.md)를 참조하세요.
+> [한국어](README.ko.md) | [日本語](README.ja.md) | [简体中文](README.zh-CN.md)
 
 <table align="center">
 <tr>
@@ -49,7 +49,7 @@ npm install -g @c-d-cc/reap
 bun install -g @c-d-cc/reap
 ```
 
-> **Requirements**: [Bun](https://bun.sh) runtime, [Claude Code](https://claude.ai/claude-code) CLI
+> **Requirements**: [Node.js](https://nodejs.org) v18+, [Claude Code](https://claude.ai/claude-code) CLI. [Bun](https://bun.sh) is optional.
 
 ## Quick Start
 

package/README.zh-CN.md

@@ -0,0 +1,315 @@
+<p align="center">
+  <img src="media/logo.png" alt="REAP" width="80" height="80" />
+</p>
+
+<h1 align="center">REAP</h1>
+
+<p align="center">
+  <strong>Recursive Evolutionary Autonomous Pipeline</strong><br>
+  AI与人类通过迭代Generation来进化软件的开发管线。
+</p>
+
+> [English](README.md) | [한국어](README.ko.md) | [日本語](README.ja.md)
+
+<table align="center">
+<tr>
+<td align="center"><strong>Genome</strong><br><sub>设计与知识</sub></td>
+<td align="center">→</td>
+<td align="center"><strong>Evolution</strong><br><sub>代际进化</sub></td>
+<td align="center">→</td>
+<td align="center"><strong>Civilization</strong><br><sub>Source Code</sub></td>
+</tr>
+</table>
+
+REAP定义应用程序的遗传信息（Genome），为每个世代设定目标进行实现，并将过程中发现的Genome缺陷反馈到后续阶段。随着世代的积累，Genome不断进化，Source Code（Civilization）持续成长。
+
+## 为什么选择REAP？
+
+在使用AI代理进行开发时，你是否遇到过这些问题？
+
+- **上下文丢失** — 每次开启新会话，代理就会忘记项目上下文
+- **分散开发** — 没有明确目标地到处修改代码
+- **设计与代码脱节** — 文档和代码随着时间推移越来越不一致
+- **遗忘的教训** — 辛苦获得的经验教训无法带到下一次工作中
+
+REAP通过**基于世代的进化模型**解决这些问题：
+
+- 每个世代专注于一个目标（Objective → Completion）
+- AI代理在每次会话开始时自动获取当前上下文（SessionStart Hook）
+- 实现过程中发现的设计问题记录在backlog中，在Completion时反映
+- 回顾（Completion）中提取的教训积累在Genome中
+
+## 安装
+
+```bash
+# npm
+npm install -g @c-d-cc/reap
+
+# 或 Bun
+bun install -g @c-d-cc/reap
+```
+
+> **要求**：[Node.js](https://nodejs.org) v18+，[Claude Code](https://claude.ai/claude-code) CLI。[Bun](https://bun.sh)是可选的。
+
+## 快速开始
+
+```bash
+# 1. 初始化项目
+
+# 新项目
+reap init my-project
+
+# 现有项目
+cd my-project
+reap init
+
+# 2. 在Claude Code中运行一个完整的Generation
+claude
+> /reap.evolve "实现用户认证"
+```
+
+`/reap.evolve`会自动运行一个Generation的完整生命周期 — 从Objective到Completion — 与用户交互式进行。它处理Generation的创建、每个阶段的执行以及阶段间的推进。这是日常开发中最常用的核心命令。
+
+如果需要更精细的控制，也可以手动推进每个阶段：
+
+```bash
+> /reap.start            # 开始新的Generation
+> /reap.objective        # 定义目标 + 规格
+> /reap.next             # 前进到下一阶段
+> /reap.planning         # 实施计划
+> /reap.next
+> /reap.implementation   # AI+人类协作编写代码
+> ...
+```
+
+## 生命周期
+
+每个Generation经历5个阶段的生命周期：
+
+```
+Objective → Planning → Implementation ⟷ Validation → Completion
+（目标定义）  （计划）     （实现）             （验证）     （完成）
+```
+
+| 阶段 | 内容 | 产出物 |
+|------|------|--------|
+| **Objective** | 定义目标 + 需求 + 验收标准 | `01-objective.md` |
+| **Planning** | 任务分解、实施方案、依赖关系 | `02-planning.md` |
+| **Implementation** | AI+人类协作编写代码 | `03-implementation.md` |
+| **Validation** | 执行测试、检查完成条件 | `04-validation.md` |
+| **Completion** | 回顾 + 应用Genome变更 + 归档 | `05-completion.md` |
+
+## 核心概念
+
+### Genome
+
+应用程序的遗传信息 — 架构原则、业务规则、开发约定、技术约束的集合。
+
+```
+.reap/genome/
+├── principles.md      # 架构原则/决策
+├── domain/            # 业务规则（按模块）
+├── conventions.md     # 开发规则/约定
+└── constraints.md     # 技术约束/选择
+```
+
+**Genome不变原则**：当前世代不直接修改Genome。发现问题时记录在backlog中，仅在Completion阶段反映。
+
+**Environment不变原则**：当前世代不直接修改Environment。发现外部环境变化时记录在backlog中，在Completion阶段反映。
+
+### Backlog
+
+`.reap/life/backlog/`中存储所有待反映的项目。每个项目使用markdown + frontmatter格式：
+
+- `type: genome-change` — 在Completion时应用到Genome
+- `type: environment-change` — 在Completion时应用到Environment
+- `type: task` — 下一个Objective的目标候选（延期任务、技术债务等）
+
+每个项目还有`status`字段：
+
+- `status: pending` — 未处理项目（默认）
+- `status: consumed` — 在当前世代中已处理（需要`consumedBy: gen-XXX`）
+
+归档时（`/reap.next` from Completion），`consumed`项目移至lineage，`pending`项目结转到下一个世代的backlog。
+
+**部分完成是正常的** — 依赖Genome变更的任务标记为`[deferred]`并交接到下一个世代。
+
+### 四轴结构
+
+```
+.reap/
+├── genome/        # 遗传信息（跨世代进化）
+├── environment/   # 外部环境（API文档、基础设施、业务约束）
+├── life/          # 当前世代的状态和产出物
+└── lineage/       # 已完成世代的归档
+```
+
+## CLI命令
+
+| 命令 | 说明 |
+|------|------|
+| `reap init <name>` | 初始化项目。创建`.reap/`结构 |
+| `reap status` | 查看当前Generation状态 |
+| `reap update` | 将命令/模板/hook同步到最新版本 |
+| `reap fix` | 诊断和修复`.reap/`结构 |
+| `reap help` | 输出CLI命令 + 斜杠命令 + 工作流摘要 |
+
+### 选项
+
+```bash
+reap init my-project --mode adoption    # 将REAP应用到现有项目
+reap init my-project --preset bun-hono-react  # 使用预设初始化Genome
+reap update --dry-run                   # 预览变更
+```
+
+## Claude Code集成
+
+REAP通过Claude Code的两种机制与AI代理集成：
+
+### 斜杠命令
+
+斜杠命令安装在`.claude/commands/`中，驱动整个工作流：
+
+| 命令 | 说明 |
+|------|------|
+| `/reap.start` | 开始新的Generation |
+| `/reap.objective` | 定义目标 + 需求 |
+| `/reap.planning` | 任务分解 + 实施计划 |
+| `/reap.implementation` | AI+人类协作编写代码 |
+| `/reap.validation` | 执行测试、检查完成条件 |
+| `/reap.completion` | 回顾 + 应用Genome变更 |
+| `/reap.next` | 前进到下一个生命周期阶段 |
+| `/reap.back` | 回到前一个阶段（micro loop） |
+| `/reap.status` | 显示当前Generation状态和项目健康度 |
+| `/reap.sync` | 基于源代码同步Genome |
+| `/reap.help` | 基于当前状态的上下文AI帮助（topic: workflow, commands, strict, genome, backlog） |
+| **`/reap.evolve`** | **从头到尾运行一个完整的Generation（推荐）** |
+
+### SessionStart Hook
+
+每次会话开始时自动运行，向AI代理注入以下内容：
+
+- REAP工作流完整指南（Genome、生命周期、四轴结构等）
+- 当前Generation状态（在哪个阶段、下一步做什么）
+- 遵循REAP生命周期的规则
+
+这确保即使打开新会话，代理也能立即理解项目上下文。
+
+### Strict模式
+
+在`.reap/config.yml`中设置`strict: true`可以限制AI代理在REAP工作流之外修改代码：
+
+```yaml
+# .reap/config.yml
+strict: true   # 默认：false
+```
+
+| 情境 | 行为 |
+|------|------|
+| 无活跃Generation / 非实现阶段 | 代码修改完全阻止 |
+| Implementation阶段 | 仅允许`02-planning.md`范围内的修改 |
+| 逃生舱 | 用户明确请求"override"或"bypass strict"时允许 |
+
+Strict模式默认禁用（`strict: false`）。
+
+### REAP Hooks
+
+在`.reap/config.yml`中定义hook，在生命周期事件时执行命令或AI提示：
+
+```yaml
+hooks:
+  onGenerationStart:
+    - command: "echo 'Generation started'"
+  onStageTransition:
+    - command: "echo 'Stage changed'"
+  onGenerationComplete:
+    - command: "reap update"
+    - prompt: "如果本Generation有功能变更，请更新README。"
+  onRegression:
+    - command: "echo 'Regressed'"
+```
+
+每个hook使用`command`（shell命令）或`prompt`（AI代理指令）之一。
+
+| 事件 | 触发时机 |
+|------|----------|
+| `onGenerationStart` | `/reap.start`创建新Generation后 |
+| `onStageTransition` | `/reap.next`前进到下一阶段后 |
+| `onGenerationComplete` | `/reap.next`归档已完成的Generation后 |
+| `onRegression` | `/reap.back`回到前一阶段后 |
+
+Hook由AI代理在项目根目录中执行。
+
+## `reap init`后的项目结构
+
+```
+my-project/
+├── src/                          # Civilization（源代码）
+└── .reap/
+    ├── config.yml                # 项目配置
+    ├── genome/                   # 遗传信息
+    │   ├── principles.md
+    │   ├── domain/
+    │   ├── conventions.md
+    │   └── constraints.md
+    ├── environment/              # 外部环境
+    ├── life/                     # 当前世代
+    │   ├── current.yml
+    │   └── backlog/
+    └── lineage/                  # 已完成世代的归档
+
+~/.claude/                        # 用户级别（reap init时安装）
+├── commands/                     # 斜杠命令（/reap.*）
+└── settings.json                 # SessionStart hook注册
+```
+
+## 谱系压缩（Lineage Compression）
+
+随着世代的积累，lineage目录会变大。REAP通过自动两级压缩来管理：
+
+| 级别 | 输入 | 输出 | 最大行数 | 触发条件 |
+|------|------|------|----------|----------|
+| **Level 1** | 世代文件夹（5个产出物） | `gen-XXX.md` | 40行 | lineage > 10,000行 + 5个以上世代 |
+| **Level 2** | 5个Level 1文件 | `epoch-XXX.md` | 60行 | Level 1达到5个以上 |
+
+压缩在世代完成时自动执行。压缩后的文件以目标（Objective）和结果（Completion）为中心保存，中间过程仅保留特别事项。
+
+## 进化流程（Evolution Flow）
+
+```
+Generation #1 (Genome v1)
+  → Objective: "实现用户认证"
+  → Planning → Implementation
+  → Implementation中发现需要OAuth2 → 在backlog中记录genome-change
+  → Validation (partial)
+  → Completion → 回顾 + genome反映 → Genome v2 → 归档
+
+Generation #2 (Genome v2)
+  → Objective: "OAuth2集成 + 权限管理"
+  → 上一世代的延期任务 + 新目标
+  → ...
+```
+
+## 预设（Presets）
+
+使用`reap init --preset`应用适合技术栈的Genome初始配置。
+
+| 预设 | 技术栈 |
+|------|--------|
+| `bun-hono-react` | Bun + Hono + React |
+
+```bash
+reap init my-project --preset bun-hono-react
+```
+
+## 入口模式（Entry Modes）
+
+| 模式 | 说明 |
+|------|------|
+| `greenfield` | 从零开始构建新项目（默认） |
+| `migration` | 参考现有系统进行新建 |
+| `adoption` | 将REAP应用到现有代码库 |
+
+## 许可证
+
+MIT

package/dist/cli.js

@@ -9863,7 +9863,7 @@ async function fixProject(projectRoot) {
 
 // src/cli/index.ts
 import { join as join7 } from "path";
-program.name("reap").description("REAP — Recursive Evolutionary Autonomous Pipeline").version("0.1.0");
+program.name("reap").description("REAP — Recursive Evolutionary Autonomous Pipeline").version("0.1.3");
 program.command("init").description("Initialize a new REAP project (Genesis)").argument("[project-name]", "Project name (defaults to current directory name)").option("-m, --mode <mode>", "Entry mode: greenfield, migration, adoption", "greenfield").option("-p, --preset <preset>", "Bootstrap with a genome preset (e.g., bun-hono-react)").action(async (projectName, options) => {
   try {
     const cwd = process.cwd();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c-d-cc/reap",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Recursive Evolutionary Autonomous Pipeline — AI and humans evolve software across generations",
   "type": "module",
   "license": "MIT",
@@ -9,7 +9,7 @@
     "type": "git",
     "url": "git+https://github.com/c-d-cc/reap.git"
   },
-  "homepage": "https://github.com/c-d-cc/reap",
+  "homepage": "https://reap.cc",
   "keywords": [
     "ai",
     "development",
@@ -30,7 +30,7 @@
   },
   "scripts": {
     "dev": "bun run src/cli/index.ts",
-    "build": "bun build src/cli/index.ts --outfile dist/cli.js --target node && rm -rf dist/templates && cp -r src/templates dist/templates",
+    "build": "node scripts/build.js",
     "prepublishOnly": "npm run build",
     "test": "bun test"
   },