@c-d-cc/reap 0.10.3 → 0.11.0

package/README.ja.md

@@ -116,7 +116,7 @@ Objective → Planning → Implementation ⟷ Validation → Completion
 | **Planning** | タスク分解、実装アプローチ、依存関係 | `02-planning.md` |
 | **Implementation** | AI+Human協力でコード実装 | `03-implementation.md` |
 | **Validation** | テスト実行、完了条件の確認 | `04-validation.md` |
-| **Completion** | レトロスペクティブ + Genome変更反映 + Hook提案 + アーカイブ | `05-completion.md` |
+| **Completion** | レトロスペクティブ + Genome変更反映 + Hook提案 + 自動アーカイブ（consume + archive + commit） | `05-completion.md` |
 
 ## コアコンセプト [↗](https://reap.cc/docs/core-concepts)
 
@@ -218,10 +218,11 @@ Machine A:
 | コマンド | 説明 |
 |----------|------|
 | `reap init <name>` | プロジェクト初期化。`.reap/`構造を作成 |
-| `reap status` | 現在のGeneration状態を確認 |
-| `reap update` | コマンド/テンプレート/hookを最新バージョンに同期 |
+| `reap status` | 現在のGeneration状態を確認（バージョン + 最新状況表示） |
+| `reap update` | コマンド/テンプレート/hookを最新バージョンに同期。`~/.claude/commands/`のレガシーを自動クリーンアップ |
 | `reap fix` | `.reap/`構造の診断と修復 |
-| `reap help` | CLIコマンド + スラッシュコマンド + ワークフロー概要を出力 |
+| `reap help` | CLIコマンド + スラッシュコマンド + ワークフロー概要を出力（バージョン + 最新状況表示） |
+| `reap run <cmd>` | スラッシュコマンドのスクリプトを直接実行（1行`.md`ラッパーが内部的に使用） |
 
 ### オプション
 
@@ -235,6 +236,21 @@ reap update --dry-run                   # 変更のプレビュー
 
 REAPはスラッシュコマンドとセッションフックを通じてAIエージェントと統合します。現在サポートされているエージェント：**Claude Code**、**OpenCode**。
 
+### Script Orchestratorアーキテクチャ
+
+v0.11.0より、28個のスラッシュコマンドが**1行`.md`ラッパー + TypeScriptスクリプト**構造に移行しました。各`.md`ファイルは`reap run <cmd>`を呼び出し、TSスクリプト（`src/cli/commands/run/`）がすべての決定論的ロジックを処理して、AIエージェントにstructured JSONで指示します。一貫性とテスト容易性が大幅に向上しました。
+
+### autoSubagentモード
+
+`/reap.evolve`実行時、自動的にsubagentにGenerationライフサイクル全体を委任できます：
+
+```yaml
+# .reap/config.yml
+autoSubagent: true    # デフォルト: true
+```
+
+Subagentは完全なコンテキストを受け取り、すべてのステージを自律的に実行します。本当にブロックされた場合のみユーザーに確認を求めます。
+
 ### スラッシュコマンド [↗](https://reap.cc/docs/command-reference)
 
 スラッシュコマンドが`.claude/commands/`にインストールされ、ワークフロー全体を駆動します：
@@ -380,9 +396,15 @@ my-project/
     │   └── backlog/
     └── lineage/                  # 完了した世代のアーカイブ
 
-~/.claude/                        # ユーザーレベル（reap initでインストール）
-├── commands/                     # スラッシュコマンド（/reap.*）
+~/.reap/                          # ユーザーレベル（reap initでインストール）
+├── commands/                     # スラッシュコマンド原本（1行.mdラッパー）
+└── templates/                    # Artifactテンプレート
+
+~/.claude/
 └── settings.json                 # SessionStart hookの登録
+
+.claude/commands/                 # プロジェクトレベル（セッション開始時にsymlink）
+└── reap.*.md                     # アクティブなスラッシュコマンド（`reap run <cmd>`を呼び出し）
 ```
 
 ## 系譜圧縮（Lineage Compression）

package/README.ko.md

@@ -116,7 +116,7 @@ Objective → Planning → Implementation ⟷ Validation → Completion
 | **Planning** | 태스크 분해, 구현 접근법, 의존관계 | `02-planning.md` |
 | **Implementation** | AI+Human 협업으로 코드 구현 | `03-implementation.md` |
 | **Validation** | 테스트 실행, 완료 조건 점검 | `04-validation.md` |
-| **Completion** | 회고 + Genome 변경 반영 + Hook 제안 + 아카이빙 | `05-completion.md` |
+| **Completion** | 회고 + Genome 변경 반영 + Hook 제안 + 자동 아카이빙 (consume + archive + commit) | `05-completion.md` |
 
 ## 핵심 개념 [↗](https://reap.cc/docs/core-concepts)
 
@@ -218,10 +218,11 @@ Machine A:
 | 명령어 | 설명 |
 |--------|------|
 | `reap init <name>` | 프로젝트 초기화. `.reap/` 구조 생성 |
-| `reap status` | 현재 Generation 상태 확인 |
-| `reap update` | 커맨드/템플릿/훅을 최신 버전으로 동기화 |
+| `reap status` | 현재 Generation 상태 확인 (버전 + 최신 여부 표시) |
+| `reap update` | 커맨드/템플릿/훅을 최신 버전으로 동기화. `~/.claude/commands/` 레거시 자동 정리 |
 | `reap fix` | `.reap/` 구조 진단 및 복구 |
-| `reap help` | CLI 명령어 + 슬래시 커맨드 + 워크플로우 요약 출력 |
+| `reap help` | CLI 명령어 + 슬래시 커맨드 + 워크플로우 요약 출력 (버전 + 최신 여부 표시) |
+| `reap run <cmd>` | 슬래시 커맨드의 스크립트를 직접 실행 (1줄 `.md` wrapper가 내부적으로 사용) |
 
 ### 옵션
 
@@ -235,6 +236,21 @@ reap update --dry-run                   # 변경사항 미리보기
 
 REAP은 슬래시 커맨드와 세션 훅을 통해 AI 에이전트와 통합됩니다. 현재 지원 에이전트: **Claude Code**, **OpenCode**.
 
+### Script Orchestrator 아키텍처
+
+v0.11.0부터 28개 슬래시 커맨드가 **1줄 `.md` wrapper + TypeScript 스크립트** 구조로 전환되었습니다. 각 `.md` 파일은 `reap run <cmd>`를 호출하고, TS 스크립트(`src/cli/commands/run/`)가 모든 결정적 로직을 처리하여 AI에게 structured JSON으로 지시합니다. 일관성과 테스트 용이성이 크게 향상되었습니다.
+
+### autoSubagent 모드
+
+`/reap.evolve` 실행 시 자동으로 subagent에게 Generation lifecycle 전체를 위임할 수 있습니다:
+
+```yaml
+# .reap/config.yml
+autoSubagent: true    # 기본값: true
+```
+
+Subagent는 전체 컨텍스트를 받아 모든 stage를 자율적으로 실행하며, 정말로 막혔을 때만 사용자에게 확인을 요청합니다.
+
 ### Slash Commands
 
 Slash command가 `.claude/commands/`에 설치되어 전체 워크플로우를 구동합니다:
@@ -380,9 +396,15 @@ my-project/
     │   └── backlog/
     └── lineage/                  # 완료된 세대 아카이브
 
-~/.claude/                        # 사용자 레벨 (reap init 시 설치)
-├── commands/                     # Slash commands (/reap.*)
+~/.reap/                          # 사용자 레벨 (reap init 시 설치)
+├── commands/                     # Slash command 원본 (1줄 .md wrapper)
+└── templates/                    # Artifact 템플릿
+
+~/.claude/
 └── settings.json                 # SessionStart hook 등록
+
+.claude/commands/                 # 프로젝트 레벨 (세션 시작 시 symlink)
+└── reap.*.md                     # 활성 슬래시 커맨드 (`reap run <cmd>` 호출)
 ```
 
 ## 계보 압축 (Lineage Compression)

package/README.md

@@ -115,7 +115,7 @@ Objective → Planning → Implementation ⟷ Validation → Completion
 | **Planning** | Break down tasks, choose approach, map dependencies | `02-planning.md` |
 | **Implementation** | Build with AI + human collaboration | `03-implementation.md` |
 | **Validation** | Run tests, verify completion criteria | `04-validation.md` |
-| **Completion** | Retrospective + apply Genome changes + hook suggestion + archive | `05-completion.md` |
+| **Completion** | Retrospective + apply Genome changes + hook suggestion + auto-archive (consume + archive + commit) | `05-completion.md` |
 
 ## Core Concepts [↗](https://reap.cc/docs/core-concepts)
 
@@ -221,6 +221,7 @@ All distributed operations run through your AI agent:
 | `reap update` | Sync commands/templates/hooks to the latest version |
 | `reap fix` | Diagnose and repair the `.reap/` structure |
 | `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) |
 
 ### Options
 
@@ -234,6 +235,21 @@ reap update --dry-run                   # Preview changes before applying
 
 REAP integrates with AI agents through slash commands and session hooks. Currently supported agents: **Claude Code** and **OpenCode**.
 
+### 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.
+
+### autoSubagent Mode
+
+When `/reap.evolve` is run, REAP can automatically delegate the entire generation lifecycle to a subagent. This is controlled by:
+
+```yaml
+# .reap/config.yml
+autoSubagent: true    # default: true
+```
+
+The subagent receives the full context and runs autonomously through all stages, only surfacing when genuinely blocked.
+
 ### Slash Commands [↗](https://reap.cc/docs/command-reference)
 
 Slash commands are installed in `.claude/commands/` and drive the entire workflow:
@@ -385,14 +401,14 @@ my-project/
     └── lineage/                  # Completed generation archive
 
 ~/.reap/                            # User-level (installed by reap init)
-├── commands/                       # Slash command originals
+├── commands/                       # Slash command originals (1-line .md wrappers)
 └── templates/                      # Artifact templates
 
 ~/.claude/
 └── settings.json                   # SessionStart hook registration
 
-.claude/commands/                   # Project-level (copied by session-start hook)
-└── reap.*.md                       # Active slash commands (auto-synced)
+.claude/commands/                   # Project-level slash commands
+└── reap.*.md                       # Active slash commands (each calls `reap run <cmd>`)
 ```
 
 ## Lineage Compression [↗](https://reap.cc/docs/lineage)

package/README.zh-CN.md

@@ -116,7 +116,7 @@ Objective → Planning → Implementation ⟷ Validation → Completion
 | **Planning** | 任务分解、实施方案、依赖关系 | `02-planning.md` |
 | **Implementation** | AI+人类协作编写代码 | `03-implementation.md` |
 | **Validation** | 执行测试、检查完成条件 | `04-validation.md` |
-| **Completion** | 回顾 + 应用Genome变更 + Hook建议 + 归档 | `05-completion.md` |
+| **Completion** | 回顾 + 应用Genome变更 + Hook建议 + 自动归档（consume + archive + commit） | `05-completion.md` |
 
 ## 核心概念 [↗](https://reap.cc/docs/core-concepts)
 
@@ -218,10 +218,11 @@ Machine A:
 | 命令 | 说明 |
 |------|------|
 | `reap init <name>` | 初始化项目。创建`.reap/`结构 |
-| `reap status` | 查看当前Generation状态 |
-| `reap update` | 将命令/模板/hook同步到最新版本 |
+| `reap status` | 查看当前Generation状态（显示版本 + 最新状态） |
+| `reap update` | 将命令/模板/hook同步到最新版本。自动清理`~/.claude/commands/`旧版文件 |
 | `reap fix` | 诊断和修复`.reap/`结构 |
-| `reap help` | 输出CLI命令 + 斜杠命令 + 工作流摘要 |
+| `reap help` | 输出CLI命令 + 斜杠命令 + 工作流摘要（显示版本 + 最新状态） |
+| `reap run <cmd>` | 直接执行斜杠命令的脚本（由1行`.md` wrapper内部调用） |
 
 ### 选项
 
@@ -235,6 +236,21 @@ reap update --dry-run                   # 预览变更
 
 REAP通过斜杠命令和会话钩子与AI代理集成。当前支持的代理：**Claude Code**、**OpenCode**。
 
+### Script Orchestrator架构
+
+从v0.11.0开始，28个斜杠命令全部采用**1行`.md` wrapper + TypeScript脚本**模式。每个`.md`文件仅调用`reap run <cmd>`，TS脚本（`src/cli/commands/run/`）处理所有确定性逻辑，以structured JSON形式指示AI代理。大幅提升了一致性和可测试性。
+
+### autoSubagent模式
+
+执行`/reap.evolve`时，可自动将整个Generation生命周期委托给subagent：
+
+```yaml
+# .reap/config.yml
+autoSubagent: true    # 默认值: true
+```
+
+Subagent接收完整上下文后自主执行所有阶段，仅在确实遇到阻碍时才向用户确认。
+
 ### 斜杠命令 [↗](https://reap.cc/docs/command-reference)
 
 斜杠命令安装在`.claude/commands/`中，驱动整个工作流：
@@ -380,9 +396,15 @@ my-project/
     │   └── backlog/
     └── lineage/                  # 已完成世代的归档
 
-~/.claude/                        # 用户级别（reap init时安装）
-├── commands/                     # 斜杠命令（/reap.*）
+~/.reap/                          # 用户级别（reap init时安装）
+├── commands/                     # 斜杠命令原件（1行.md wrapper）
+└── templates/                    # Artifact模板
+
+~/.claude/
 └── settings.json                 # SessionStart hook注册
+
+.claude/commands/                 # 项目级别（会话启动时symlink）
+└── reap.*.md                     # 活跃斜杠命令（调用`reap run <cmd>`）
 ```
 
 ## 谱系压缩（Lineage Compression）