@c-d-cc/reap 0.10.3 → 0.12.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)
 
@@ -221,7 +221,8 @@ Machine A:
 | `reap status` | 現在のGeneration状態を確認 |
 | `reap update` | コマンド/テンプレート/hookを最新バージョンに同期 |
 | `reap fix` | `.reap/`構造の診断と修復 |
-| `reap help` | CLIコマンド + スラッシュコマンド + ワークフロー概要を出力 |
+| `reap help` | CLIコマンド + スラッシュコマンド + ワークフロー概要を出力（バージョン + 最新状況表示） |
+| `reap run <cmd>` | スラッシュコマンドのスクリプトを直接実行（1行`.md`ラッパーが内部的に使用） |
 
 ### オプション
 
@@ -235,6 +236,40 @@ 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は完全なコンテキストを受け取り、すべてのステージを自律的に実行します。本当にブロックされた場合のみユーザーに確認を求めます。
+
+### エラー時の自動Issue報告
+
+`reap run`の実行中に予期しないエラーが発生した場合、`gh issue create`を通じてGitHub Issueを自動作成できます：
+
+```yaml
+# .reap/config.yml
+autoIssueReport: true    # デフォルト: true（gh CLIがある場合）
+```
+
+### AI Migration Agent
+
+`reap update`の実行時にプロジェクトと最新REAPバージョン間の構造的な差分（不足しているconfigフィールド、古いテンプレートなど）が検出されると、AI支援のマイグレーションプロンプトが表示されます。エージェントが差分を分析し、対話的に変更を適用するため、手動マイグレーションは不要です。
+
+`reap init`ではすべてのconfigフィールドを明示的に宣言し、`reap update`時に不足しているフィールドは自動的に補完されます。
+
+### CLAUDE.md連携
+
+`reap init`と`reap update`の実行時に、`.claude/CLAUDE.md`にREAP管理セクションを追加し、Claude Codeセッションに必要なプロジェクトコンテキストを提供します。
+
 ### スラッシュコマンド [↗](https://reap.cc/docs/command-reference)
 
 スラッシュコマンドが`.claude/commands/`にインストールされ、ワークフロー全体を駆動します：
@@ -254,6 +289,7 @@ REAPはスラッシュコマンドとセッションフックを通じてAIエ
 | `/reap.sync` | GenomeとEnvironmentを同時に同期 |
 | `/reap.sync.genome` | ソースコードベースでGenomeを最新化 |
 | `/reap.sync.environment` | 外部環境依存関係の発見と文書化 |
+| `/reap.config` | 現在のプロジェクト設定を表示 |
 | `/reap.report` | REAPプロジェクトにバグ/フィードバックを報告（プライバシー保護） |
 | `/reap.help` | 24+トピックのcontextual AIヘルプ |
 | `/reap.update` | REAPパッケージのアップグレード + コマンド/テンプレート/hook同期 |
@@ -380,9 +416,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/                 # プロジェクトレベルのスラッシュコマンド
+└── 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)
 
@@ -221,7 +221,8 @@ Machine A:
 | `reap status` | 현재 Generation 상태 확인 |
 | `reap update` | 커맨드/템플릿/훅을 최신 버전으로 동기화 |
 | `reap fix` | `.reap/` 구조 진단 및 복구 |
-| `reap help` | CLI 명령어 + 슬래시 커맨드 + 워크플로우 요약 출력 |
+| `reap help` | CLI 명령어 + 슬래시 커맨드 + 워크플로우 요약 출력 (버전 + 최신 여부 표시) |
+| `reap run <cmd>` | 슬래시 커맨드의 스크립트를 직접 실행 (1줄 `.md` wrapper가 내부적으로 사용) |
 
 ### 옵션
 
@@ -235,6 +236,40 @@ 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를 자율적으로 실행하며, 정말로 막혔을 때만 사용자에게 확인을 요청합니다.
+
+### 에러 시 자동 이슈 리포트
+
+`reap run` 실행 중 예상치 못한 에러가 발생하면, `gh issue create`를 통해 GitHub Issue를 자동으로 생성할 수 있습니다:
+
+```yaml
+# .reap/config.yml
+autoIssueReport: true    # 기본값: true (gh CLI가 있을 때)
+```
+
+### AI Migration Agent
+
+`reap update` 실행 시 프로젝트와 최신 REAP 버전 사이의 구조적 차이(누락된 config 필드, 오래된 템플릿 등)가 감지되면, AI 기반 마이그레이션 프롬프트를 제공합니다. 에이전트가 차이를 분석하고 대화형으로 변경을 적용하므로 수동 마이그레이션이 필요 없습니다.
+
+`reap init`도 모든 config 필드를 명시적으로 선언하며, `reap update` 시 누락된 필드는 자동으로 채워집니다.
+
+### CLAUDE.md 연동
+
+`reap init`과 `reap update` 시 `.claude/CLAUDE.md`에 REAP 관리 섹션을 추가하여 Claude Code 세션에 필요한 프로젝트 컨텍스트를 제공합니다.
+
 ### Slash Commands
 
 Slash command가 `.claude/commands/`에 설치되어 전체 워크플로우를 구동합니다:
@@ -254,6 +289,7 @@ Slash command가 `.claude/commands/`에 설치되어 전체 워크플로우를
 | `/reap.sync` | Genome + Environment 동시 동기화 |
 | `/reap.sync.genome` | 소스 코드 기반 Genome 최신화 |
 | `/reap.sync.environment` | 외부 환경 의존성 탐색 및 문서화 |
+| `/reap.config` | 현재 프로젝트 설정 표시 |
 | `/reap.report` | REAP 프로젝트에 버그/피드백 보고 (개인정보 보호) |
 | `/reap.help` | 24+ 주제의 contextual AI 도움말 |
 | `/reap.update` | REAP 패키지 업그레이드 + 커맨드/템플릿/훅 동기화 |
@@ -380,9 +416,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/                 # 프로젝트 레벨 슬래시 커맨드
+└── 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,40 @@ 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.
+
+### Auto Issue Report
+
+When an unexpected error occurs during `reap run`, REAP can automatically create a GitHub Issue via `gh issue create`. This is controlled by:
+
+```yaml
+# .reap/config.yml
+autoIssueReport: true    # default: true (when gh CLI is available)
+```
+
+### AI Migration Agent
+
+When `reap update` detects structural gaps between your project and the latest REAP version (e.g., missing config fields, outdated templates), it offers an AI-assisted migration prompt. The agent analyzes the differences and applies changes interactively — no manual migration needed.
+
+`reap init` also ensures all config fields are explicitly declared, and `reap update` backfills any missing fields automatically.
+
+### CLAUDE.md Integration
+
+During `reap init` and `reap update`, REAP adds a managed section to `.claude/CLAUDE.md` containing essential project context for Claude Code sessions.
+
 ### Slash Commands [↗](https://reap.cc/docs/command-reference)
 
 Slash commands are installed in `.claude/commands/` and drive the entire workflow:
@@ -253,6 +288,7 @@ Slash commands are installed in `.claude/commands/` and drive the entire workflo
 | `/reap.sync` | Synchronize both Genome and Environment |
 | `/reap.sync.genome` | Synchronize Genome with current source code |
 | `/reap.sync.environment` | Discover and document external environment dependencies |
+| `/reap.config` | Display current project configuration |
 | `/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 |
@@ -385,14 +421,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)
 
@@ -221,7 +221,8 @@ Machine A:
 | `reap status` | 查看当前Generation状态 |
 | `reap update` | 将命令/模板/hook同步到最新版本 |
 | `reap fix` | 诊断和修复`.reap/`结构 |
-| `reap help` | 输出CLI命令 + 斜杠命令 + 工作流摘要 |
+| `reap help` | 输出CLI命令 + 斜杠命令 + 工作流摘要（显示版本 + 最新状态） |
+| `reap run <cmd>` | 直接执行斜杠命令的脚本（由1行`.md` wrapper内部调用） |
 
 ### 选项
 
@@ -235,6 +236,40 @@ 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接收完整上下文后自主执行所有阶段，仅在确实遇到阻碍时才向用户确认。
+
+### 错误时自动Issue报告
+
+当`reap run`执行中发生意外错误时，可通过`gh issue create`自动创建GitHub Issue：
+
+```yaml
+# .reap/config.yml
+autoIssueReport: true    # 默认值: true（检测到gh CLI时）
+```
+
+### AI Migration Agent
+
+`reap update`执行时，如果检测到项目与最新REAP版本之间的结构性差异（缺失的config字段、过时的模板等），会提供AI辅助的迁移提示。代理分析差异并交互式地应用变更，无需手动迁移。
+
+`reap init`会明确声明所有config字段，`reap update`时自动补全缺失字段。
+
+### CLAUDE.md集成
+
+`reap init`和`reap update`执行时，会在`.claude/CLAUDE.md`中添加REAP管理段落，为Claude Code会话提供必要的项目上下文。
+
 ### 斜杠命令 [↗](https://reap.cc/docs/command-reference)
 
 斜杠命令安装在`.claude/commands/`中，驱动整个工作流：
@@ -254,6 +289,7 @@ REAP通过斜杠命令和会话钩子与AI代理集成。当前支持的代理
 | `/reap.sync` | 同时同步Genome和Environment |
 | `/reap.sync.genome` | 基于源代码同步Genome |
 | `/reap.sync.environment` | 发现和记录外部环境依赖 |
+| `/reap.config` | 显示当前项目配置 |
 | `/reap.report` | 向REAP项目报告bug/反馈（隐私保护） |
 | `/reap.help` | 24+主题的上下文AI帮助 |
 | `/reap.update` | 升级REAP包 + 同步命令/模板/hook |
@@ -380,9 +416,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/                 # 项目级斜杠命令
+└── reap.*.md                     # 活跃斜杠命令（调用`reap run <cmd>`）
 ```
 
 ## 谱系压缩（Lineage Compression）