@c-d-cc/reap 0.15.0 → 0.15.2

package/README.ja.md

@@ -84,8 +84,9 @@ reap init my-project
 cd my-project
 reap init
 
-# 2. Claude Codeで1つのGeneration全体を実行
+# 2. Claude Codeでナレッジを同期してからGeneration全体を実行
 claude
+> /reap.sync
 > /reap.evolve "ユーザー認証の実装"
 ```
 
@@ -221,9 +222,9 @@ Machine A:
 | `reap init <name>` | プロジェクト初期化。`.reap/`構造を作成 |
 | `reap status` | 現在のGeneration状態を確認 |
 | `reap update` | コマンド/テンプレート/hookを最新バージョンに同期 |
-| `reap fix` | `.reap/`構造の診断と修復 |
+| `reap fix` | `.reap/`構造の診断と修復（`--check`で読み取り専用モード） |
 | `reap clean` | 対話式オプションでREAPプロジェクトをリセット |
-| `reap destroy` | プロジェクトからすべてのREAPファイルを削除（確認が必要） |
+| `reap destroy` | プロジェクトからすべてのREAPファイルを削除（"yes destroy"の入力で確認） |
 | `reap help` | CLIコマンド + スラッシュコマンド + ワークフロー概要を出力（バージョン + 最新状況表示） |
 | `reap run <cmd>` | スラッシュコマンドのスクリプトを直接実行（1行`.md`ラッパーが内部的に使用） |
 
@@ -241,7 +242,7 @@ REAPはスラッシュコマンドとセッションフックを通じてAIエ
 
 ### Script Orchestratorアーキテクチャ
 
-v0.11.0より、28個のスラッシュコマンドが**1行`.md`ラッパー + TypeScriptスクリプト**構造に移行しました。各`.md`ファイルは`reap run <cmd>`を呼び出し、TSスクリプト（`src/cli/commands/run/`）がすべての決定論的ロジックを処理して、AIエージェントにstructured JSONで指示します。一貫性とテスト容易性が大幅に向上しました。
+v0.11.0より、31個のスラッシュコマンドが**1行`.md`ラッパー + TypeScriptスクリプト**構造に移行しました。各`.md`ファイルは`reap run <cmd>`を呼び出し、TSスクリプト（`src/cli/commands/run/`）がすべての決定論的ロジックを処理して、AIエージェントにstructured JSONで指示します。一貫性とテスト容易性が大幅に向上しました。
 
 ### 署名ベースロック（Signature-Based Locking） [↗](https://reap.cc/docs/advanced)
 
@@ -315,7 +316,9 @@ autoIssueReport: true    # デフォルト: true（gh CLIがある場合）
 | `/reap.report` | REAPプロジェクトにバグ/フィードバックを報告（プライバシー保護） |
 | `/reap.help` | 24+トピックのcontextual AIヘルプ |
 | `/reap.update` | REAPパッケージのアップグレード + コマンド/テンプレート/hook同期 |
+| `/reap.update-genome` | Generationなしで保留中のgenome-change backlogを適用 |
 | **`/reap.evolve`** | **1つのGeneration全体を最初から最後まで実行（推奨）** |
+| **`/reap.evolve.recovery`** | **失敗/中断したGenerationからの復旧** |
 | **`/reap.pull <branch>`** | **Fetch + マージGeneration全体を実行（分散版 `/reap.evolve`）** |
 | **`/reap.merge <branch>`** | **ローカルブランチのマージGeneration全体を実行（fetchなし）** |
 | `/reap.push` | REAP状態を検証して現在のブランチをpush |
@@ -326,7 +329,7 @@ autoIssueReport: true    # デフォルト: true（gh CLIがある場合）
 | `/reap.merge.sync` | Genome-ソース間の整合性を検証（AI比較、ユーザー確認） |
 | `/reap.merge.validation` | 機械的テストを実行（bun test、tsc、build） |
 | **`/reap.merge.evolve`** | **マージライフサイクル全体を自動実行** |
-| `/reap.refreshKnowledge` | サブエージェント用REAPコンテキストのロード（Genome、Environment、状態） |
+| `/reap.refreshKnowledge` | REAPコンテキストの再ロード（Genome、Environment、状態）。context compaction後やサブエージェントで使用 |
 
 ### SessionStart Hook [↗](https://reap.cc/docs/hooks)
 
@@ -360,7 +363,7 @@ strict:
 |------|------|
 | アクティブGenerationなし / 実装ステージ外 | コード変更は完全にブロック |
 | Implementationステージ | `02-planning.md`の範囲内でのみ変更許可 |
-| エスケープハッチ | ユーザーが「override」「bypass strict」等を明示的に要求した場合に許可 |
+| エスケープハッチ | ユーザーが「override」「bypass strict」等を明示的に要求した場合、その特定のアクションに限り許可。完了後strictモード再適用 |
 
 **`strict.merge`** — Gitコマンド制御：有効にすると`git pull`/`push`/`merge`の直接使用が制限されます。エージェントが`/reap.pull`、`/reap.push`、`/reap.merge`の使用を案内します。
 

package/README.ko.md

@@ -84,8 +84,9 @@ reap init my-project
 cd my-project
 reap init
 
-# 2. Claude Code에서 한 Generation 전체 실행
+# 2. Claude Code에서 지식 동기화 후 한 Generation 전체 실행
 claude
+> /reap.sync
 > /reap.evolve "사용자 인증 구현"
 ```
 
@@ -221,9 +222,9 @@ Machine A:
 | `reap init <name>` | 프로젝트 초기화. `.reap/` 구조 생성 |
 | `reap status` | 현재 Generation 상태 확인 |
 | `reap update` | 커맨드/템플릿/훅을 최신 버전으로 동기화 |
-| `reap fix` | `.reap/` 구조 진단 및 복구 |
+| `reap fix` | `.reap/` 구조 진단 및 복구 (`--check`로 읽기 전용 모드) |
 | `reap clean` | 대화형 옵션으로 REAP 프로젝트 초기화 |
-| `reap destroy` | 프로젝트에서 모든 REAP 파일 제거 (확인 필요) |
+| `reap destroy` | 프로젝트에서 모든 REAP 파일 제거 ("yes destroy" 입력으로 확인) |
 | `reap help` | CLI 명령어 + 슬래시 커맨드 + 워크플로우 요약 출력 (버전 + 최신 여부 표시) |
 | `reap run <cmd>` | 슬래시 커맨드의 스크립트를 직접 실행 (1줄 `.md` wrapper가 내부적으로 사용) |
 
@@ -241,7 +242,7 @@ REAP은 슬래시 커맨드와 세션 훅을 통해 AI 에이전트와 통합됩
 
 ### Script Orchestrator 아키텍처
 
-v0.11.0부터 28개 슬래시 커맨드가 **1줄 `.md` wrapper + TypeScript 스크립트** 구조로 전환되었습니다. 각 `.md` 파일은 `reap run <cmd>`를 호출하고, TS 스크립트(`src/cli/commands/run/`)가 모든 결정적 로직을 처리하여 AI에게 structured JSON으로 지시합니다. 일관성과 테스트 용이성이 크게 향상되었습니다.
+v0.11.0부터 31개 슬래시 커맨드가 **1줄 `.md` wrapper + TypeScript 스크립트** 구조로 전환되었습니다. 각 `.md` 파일은 `reap run <cmd>`를 호출하고, TS 스크립트(`src/cli/commands/run/`)가 모든 결정적 로직을 처리하여 AI에게 structured JSON으로 지시합니다. 일관성과 테스트 용이성이 크게 향상되었습니다.
 
 ### 서명 기반 잠금 (Signature-Based Locking) [↗](https://reap.cc/docs/advanced)
 
@@ -315,7 +316,9 @@ Slash command가 `.claude/commands/`에 설치되어 전체 워크플로우를
 | `/reap.report` | REAP 프로젝트에 버그/피드백 보고 (개인정보 보호) |
 | `/reap.help` | 24+ 주제의 contextual AI 도움말 |
 | `/reap.update` | REAP 패키지 업그레이드 + 커맨드/템플릿/훅 동기화 |
+| `/reap.update-genome` | Generation 없이 대기 중인 genome-change backlog 적용 |
 | **`/reap.evolve`** | **한 Generation 전체를 처음부터 끝까지 실행 (권장)** |
+| **`/reap.evolve.recovery`** | **실패/중단된 Generation에서 복구** |
 | **`/reap.pull <branch>`** | **Fetch + 전체 머지 Generation 실행 (분산 `/reap.evolve`)** |
 | **`/reap.merge <branch>`** | **로컬 브랜치 전체 머지 Generation 실행 (fetch 없음)** |
 | `/reap.push` | REAP 상태 검증 후 현재 브랜치 push |
@@ -326,7 +329,7 @@ Slash command가 `.claude/commands/`에 설치되어 전체 워크플로우를
 | `/reap.merge.sync` | Genome-소스 간 일관성 검증 (AI 비교, 사용자 확인) |
 | `/reap.merge.validation` | 기계적 테스트 실행 (bun test, tsc, build) |
 | **`/reap.merge.evolve`** | **전체 머지 라이프사이클 자동 실행** |
-| `/reap.refreshKnowledge` | 서브에이전트용 REAP 컨텍스트 로드 (Genome, Environment, 상태) |
+| `/reap.refreshKnowledge` | REAP 컨텍스트 재로드 (Genome, Environment, 상태). context compaction 후 또는 서브에이전트에서 사용 |
 
 ### SessionStart Hook [↗](https://reap.cc/docs/hooks)
 
@@ -360,7 +363,7 @@ strict:
 |------|------|
 | 활성 Generation 없음 / 구현 단계 외 | 코드 수정 완전 차단 |
 | Implementation 단계 | `02-planning.md` 범위 내에서만 수정 허용 |
-| Escape hatch | 사용자가 "override", "bypass strict" 등 명시적 요청 시 허용 |
+| Escape hatch | 사용자가 "override", "bypass strict" 등 명시적 요청 시 해당 작업에 한해 허용, 완료 후 strict 모드 재적용 |
 
 **`strict.merge`** — Git 명령 제어: 활성화 시 `git pull`/`push`/`merge` 직접 사용이 제한됩니다. 에이전트가 `/reap.pull`, `/reap.push`, `/reap.merge` 사용을 안내합니다.
 

package/README.md

@@ -84,8 +84,9 @@ reap init my-project
 cd my-project
 reap init
 
-# 2. Open Claude Code and run a full generation
+# 2. Open Claude Code, sync knowledge, then run a full generation
 claude
+> /reap.sync
 > /reap.evolve "Implement user authentication"
 ```
 
@@ -220,9 +221,9 @@ All distributed operations run through your AI agent:
 | `reap init <name>` | Initialize project. Creates the `.reap/` structure |
 | `reap status` | Check the current generation's status |
 | `reap update` | Sync commands/templates/hooks to the latest version |
-| `reap fix` | Diagnose and repair the `.reap/` structure |
+| `reap fix` | Diagnose and repair the `.reap/` structure (`--check` for read-only mode) |
 | `reap clean` | Reset REAP project with interactive options |
-| `reap destroy` | Remove all REAP files from project (requires confirmation) |
+| `reap destroy` | Remove all REAP files from project (requires typing "yes destroy" to confirm) |
 | `reap help` | Print CLI commands, slash commands, and workflow summary |
 | `reap run <cmd>` | Execute a slash command's script directly (used internally by 1-line `.md` wrappers) |
 
@@ -240,7 +241,7 @@ REAP integrates with AI agents through slash commands and session hooks. Current
 
 ### Script Orchestrator Architecture
 
-Since v0.11.0, all 28 slash commands follow a **1-line `.md` wrapper + TypeScript script** pattern. Each `.md` file simply calls `reap run <cmd>`, and the TS script (`src/cli/commands/run/`) handles all deterministic logic — returning structured JSON instructions for the AI agent. This ensures consistency and testability.
+Since v0.11.0, all 31 slash commands follow a **1-line `.md` wrapper + TypeScript script** pattern. Each `.md` file simply calls `reap run <cmd>`, and the TS script (`src/cli/commands/run/`) handles all deterministic logic — returning structured JSON instructions for the AI agent. This ensures consistency and testability.
 
 ### Signature-Based Locking [↗](https://reap.cc/docs/advanced)
 
@@ -314,7 +315,9 @@ Slash commands are installed in `.claude/commands/` and drive the entire workflo
 | `/reap.report` | Report a bug or feedback to the REAP project (privacy-safe) |
 | `/reap.help` | Contextual AI help with 24+ topics |
 | `/reap.update` | Upgrade REAP package + sync commands/templates/hooks |
+| `/reap.update-genome` | Apply pending genome-change backlog without a generation |
 | **`/reap.evolve`** | **Run an entire generation from start to finish (recommended)** |
+| **`/reap.evolve.recovery`** | **Recover from a failed/interrupted generation** |
 | **`/reap.pull <branch>`** | **Fetch + run full merge generation (distributed `/reap.evolve`)** |
 | **`/reap.merge <branch>`** | **Run full merge generation for a local branch (no fetch)** |
 | `/reap.push` | Validate REAP state and push current branch |
@@ -325,7 +328,7 @@ Slash commands are installed in `.claude/commands/` and drive the entire workflo
 | `/reap.merge.sync` | Verify genome–source consistency (AI compares, user confirms) |
 | `/reap.merge.validation` | Run mechanical testing (bun test, tsc, build) |
 | **`/reap.merge.evolve`** | **Run the full merge lifecycle automatically** |
-| `/reap.refreshKnowledge` | Load REAP context for subagents (Genome, Environment, state) |
+| `/reap.refreshKnowledge` | Reload REAP context (Genome, Environment, state). Useful after context compaction or in subagents |
 
 ### SessionStart Hook [↗](https://reap.cc/docs/hooks)
 
@@ -361,7 +364,7 @@ strict:
 |---------|----------|
 | No active generation / non-implementation stage | Code modifications are fully blocked |
 | Implementation stage | Only modifications within the scope of `02-planning.md` are allowed |
-| Escape hatch | User explicitly requests "override" or "bypass strict" to allow modifications |
+| Escape hatch | User explicitly requests "override" or "bypass strict" — bypass applies to that specific action only, then strict mode re-engages |
 
 **`strict.merge`** — Git command control: when enabled, direct `git pull`/`push`/`merge` are restricted. The agent guides users to use `/reap.pull`, `/reap.push`, `/reap.merge` instead.
 

package/README.zh-CN.md

@@ -84,8 +84,9 @@ reap init my-project
 cd my-project
 reap init
 
-# 2. 在Claude Code中运行一个完整的Generation
+# 2. 在Claude Code中同步知识后运行一个完整的Generation
 claude
+> /reap.sync
 > /reap.evolve "实现用户认证"
 ```
 
@@ -221,9 +222,9 @@ Machine A:
 | `reap init <name>` | 初始化项目。创建`.reap/`结构 |
 | `reap status` | 查看当前Generation状态 |
 | `reap update` | 将命令/模板/hook同步到最新版本 |
-| `reap fix` | 诊断和修复`.reap/`结构 |
+| `reap fix` | 诊断和修复`.reap/`结构（`--check`为只读模式） |
 | `reap clean` | 通过交互式选项重置REAP项目 |
-| `reap destroy` | 从项目中删除所有REAP文件（需要确认） |
+| `reap destroy` | 从项目中删除所有REAP文件（需输入"yes destroy"确认） |
 | `reap help` | 输出CLI命令 + 斜杠命令 + 工作流摘要（显示版本 + 最新状态） |
 | `reap run <cmd>` | 直接执行斜杠命令的脚本（由1行`.md` wrapper内部调用） |
 
@@ -241,7 +242,7 @@ REAP通过斜杠命令和会话钩子与AI代理集成。当前支持的代理
 
 ### Script Orchestrator架构
 
-从v0.11.0开始，28个斜杠命令全部采用**1行`.md` wrapper + TypeScript脚本**模式。每个`.md`文件仅调用`reap run <cmd>`，TS脚本（`src/cli/commands/run/`）处理所有确定性逻辑，以structured JSON形式指示AI代理。大幅提升了一致性和可测试性。
+从v0.11.0开始，31个斜杠命令全部采用**1行`.md` wrapper + TypeScript脚本**模式。每个`.md`文件仅调用`reap run <cmd>`，TS脚本（`src/cli/commands/run/`）处理所有确定性逻辑，以structured JSON形式指示AI代理。大幅提升了一致性和可测试性。
 
 ### 签名锁定（Signature-Based Locking） [↗](https://reap.cc/docs/advanced)
 
@@ -315,7 +316,9 @@ autoIssueReport: true    # 默认值: true（检测到gh CLI时）
 | `/reap.report` | 向REAP项目报告bug/反馈（隐私保护） |
 | `/reap.help` | 24+主题的上下文AI帮助 |
 | `/reap.update` | 升级REAP包 + 同步命令/模板/hook |
+| `/reap.update-genome` | 无需Generation即可应用待处理的genome-change backlog |
 | **`/reap.evolve`** | **从头到尾运行一个完整的Generation（推荐）** |
+| **`/reap.evolve.recovery`** | **从失败/中断的Generation中恢复** |
 | **`/reap.pull <branch>`** | **Fetch + 运行完整合并Generation（分布式 `/reap.evolve`）** |
 | **`/reap.merge <branch>`** | **本地分支完整合并Generation（无需fetch）** |
 | `/reap.push` | 验证REAP状态并push当前分支 |
@@ -326,7 +329,7 @@ autoIssueReport: true    # 默认值: true（检测到gh CLI时）
 | `/reap.merge.sync` | 验证Genome与源代码的一致性（AI比较，用户确认） |
 | `/reap.merge.validation` | 运行机械化测试（bun test、tsc、build） |
 | **`/reap.merge.evolve`** | **自动运行完整的合并生命周期** |
-| `/reap.refreshKnowledge` | 为子代理加载REAP上下文（Genome、Environment、状态） |
+| `/reap.refreshKnowledge` | 重新加载REAP上下文（Genome、Environment、状态）。context compaction后或在子代理中使用 |
 
 ### SessionStart Hook [↗](https://reap.cc/docs/hooks)
 
@@ -360,7 +363,7 @@ strict:
 |------|------|
 | 无活跃Generation / 非实现阶段 | 代码修改完全阻止 |
 | Implementation阶段 | 仅允许`02-planning.md`范围内的修改 |
-| 逃生舱 | 用户明确请求"override"或"bypass strict"时允许 |
+| 逃生舱 | 用户明确请求"override"或"bypass strict"时，仅对该特定操作允许，完成后strict模式重新生效 |
 
 **`strict.merge`** — Git命令控制：启用后，直接使用`git pull`/`push`/`merge`将被限制。代理会引导用户使用`/reap.pull`、`/reap.push`、`/reap.merge`。