@c-d-cc/reap 0.10.2 → 0.11.0

package/README.ja.md

@@ -13,7 +13,7 @@
 
 <table align="center">
 <tr>
-<td align="center"><strong>Genome</strong><br><sub>設計とナレッジ</sub></td>
+<td align="center"><strong>Knowledge Base</strong><br><sub>Genome + Environment</sub></td>
 <td align="center">→</td>
 <td align="center"><strong>Evolution</strong><br><sub>世代を超えた進化</sub></td>
 <td align="center">→</td>
@@ -21,7 +21,7 @@
 </tr>
 </table>
 
-REAPはアプリケーションの遺伝情報（Genome）を定義し、各世代で目標を設定して実装し、その過程で発見したGenomeの欠陥を次のステージにフィードバックします。世代を重ねるごとにGenomeが進化し、Source Code（Civilization）が成長します。
+REAPはアプリケーションの設計知識 — Genome（アーキテクチャ、コンベンション、制約）とEnvironment（外部API、インフラ） — を記録し、各世代で目標を設定して実装します。その過程で発見した欠陥はKnowledge Baseにフィードバックされます。世代を重ねるごとに知識が進化し、Source Code（Civilization）が成長します。
 
 ## 目次
 
@@ -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

@@ -13,7 +13,7 @@
 
 <table align="center">
 <tr>
-<td align="center"><strong>Genome</strong><br><sub>설계와 지식</sub></td>
+<td align="center"><strong>Knowledge Base</strong><br><sub>Genome + Environment</sub></td>
 <td align="center">→</td>
 <td align="center"><strong>Evolution</strong><br><sub>세대를 거친 진화</sub></td>
 <td align="center">→</td>
@@ -21,7 +21,7 @@
 </tr>
 </table>
 
-REAP은 Application의 유전 정보(Genome)를 정의하고, 각 세대에서 목표를 설정하여 구현하고, 그 과정에서 발견한 Genome 결함을 다음 단계에서 반영합니다. 세대를 거듭하며 Genome이 진화하고, Source Code(Civilization)가 성장합니다.
+REAP은 Application의 설계 지식 — Genome(아키텍처, 컨벤션, 제약사항)과 Environment(외부 API, 인프라) — 을 기록하고, 각 세대에서 목표를 설정하여 구현합니다. 그 과정에서 발견한 결함은 Knowledge Base에 반영됩니다. 세대를 거듭하며 지식이 진화하고, Source Code(Civilization)가 성장합니다.
 
 ## 목차
 
@@ -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

@@ -13,7 +13,7 @@
 
 <table align="center">
 <tr>
-<td align="center"><strong>Genome</strong><br><sub>Design & Knowledge</sub></td>
+<td align="center"><strong>Knowledge Base</strong><br><sub>Genome + Environment</sub></td>
 <td align="center">→</td>
 <td align="center"><strong>Evolution</strong><br><sub>Generational Progress</sub></td>
 <td align="center">→</td>
@@ -21,7 +21,7 @@
 </tr>
 </table>
 
-REAP defines an application's genetic information (Genome), sets objectives for each generation to implement, and feeds back any Genome defects discovered along the way into subsequent stages. As generations accumulate, the Genome evolves and the Source Code (Civilization) grows.
+REAP captures an application's design knowledge — the Genome (architecture, conventions, constraints) and Environment (external APIs, infrastructure) — then sets objectives for each generation to implement. Defects discovered along the way feed back into the Knowledge Base. As generations accumulate, knowledge evolves and the Source Code (Civilization) grows.
 
 ## Table of Contents
 
@@ -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

@@ -13,7 +13,7 @@
 
 <table align="center">
 <tr>
-<td align="center"><strong>Genome</strong><br><sub>设计与知识</sub></td>
+<td align="center"><strong>Knowledge Base</strong><br><sub>Genome + Environment</sub></td>
 <td align="center">→</td>
 <td align="center"><strong>Evolution</strong><br><sub>代际进化</sub></td>
 <td align="center">→</td>
@@ -21,7 +21,7 @@
 </tr>
 </table>
 
-REAP定义应用程序的遗传信息（Genome），为每个世代设定目标进行实现，并将过程中发现的Genome缺陷反馈到后续阶段。随着世代的积累，Genome不断进化，Source Code（Civilization）持续成长。
+REAP记录应用程序的设计知识 — Genome（架构、约定、约束）和Environment（外部API、基础设施） — 并在每个世代设定目标进行实现。过程中发现的缺陷反馈到Knowledge Base。随着世代的积累，知识不断进化，Source Code（Civilization）持续成长。
 
 ## 目录
 
@@ -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）