@c-d-cc/reap 0.11.0 → 0.13.0

package/README.ja.md

@@ -218,8 +218,8 @@ Machine A:
 | コマンド | 説明 |
 |----------|------|
 | `reap init <name>` | プロジェクト初期化。`.reap/`構造を作成 |
-| `reap status` | 現在のGeneration状態を確認（バージョン + 最新状況表示） |
-| `reap update` | コマンド/テンプレート/hookを最新バージョンに同期。`~/.claude/commands/`のレガシーを自動クリーンアップ |
+| `reap status` | 現在のGeneration状態を確認 |
+| `reap update` | コマンド/テンプレート/hookを最新バージョンに同期 |
 | `reap fix` | `.reap/`構造の診断と修復 |
 | `reap help` | CLIコマンド + スラッシュコマンド + ワークフロー概要を出力（バージョン + 最新状況表示） |
 | `reap run <cmd>` | スラッシュコマンドのスクリプトを直接実行（1行`.md`ラッパーが内部的に使用） |
@@ -251,6 +251,25 @@ 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/`にインストールされ、ワークフロー全体を駆動します：
@@ -270,6 +289,7 @@ Subagentは完全なコンテキストを受け取り、すべてのステージ
 | `/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同期 |
@@ -403,7 +423,7 @@ my-project/
 ~/.claude/
 └── settings.json                 # SessionStart hookの登録
 
-.claude/commands/                 # プロジェクトレベル（セッション開始時にsymlink）
+.claude/commands/                 # プロジェクトレベルのスラッシュコマンド
 └── reap.*.md                     # アクティブなスラッシュコマンド（`reap run <cmd>`を呼び出し）
 ```
 

package/README.ko.md

@@ -218,8 +218,8 @@ Machine A:
 | 명령어 | 설명 |
 |--------|------|
 | `reap init <name>` | 프로젝트 초기화. `.reap/` 구조 생성 |
-| `reap status` | 현재 Generation 상태 확인 (버전 + 최신 여부 표시) |
-| `reap update` | 커맨드/템플릿/훅을 최신 버전으로 동기화. `~/.claude/commands/` 레거시 자동 정리 |
+| `reap status` | 현재 Generation 상태 확인 |
+| `reap update` | 커맨드/템플릿/훅을 최신 버전으로 동기화 |
 | `reap fix` | `.reap/` 구조 진단 및 복구 |
 | `reap help` | CLI 명령어 + 슬래시 커맨드 + 워크플로우 요약 출력 (버전 + 최신 여부 표시) |
 | `reap run <cmd>` | 슬래시 커맨드의 스크립트를 직접 실행 (1줄 `.md` wrapper가 내부적으로 사용) |
@@ -251,6 +251,25 @@ 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/`에 설치되어 전체 워크플로우를 구동합니다:
@@ -270,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 패키지 업그레이드 + 커맨드/템플릿/훅 동기화 |
@@ -403,7 +423,7 @@ my-project/
 ~/.claude/
 └── settings.json                 # SessionStart hook 등록
 
-.claude/commands/                 # 프로젝트 레벨 (세션 시작 시 symlink)
+.claude/commands/                 # 프로젝트 레벨 슬래시 커맨드
 └── reap.*.md                     # 활성 슬래시 커맨드 (`reap run <cmd>` 호출)
 ```
 

package/README.md

@@ -250,6 +250,25 @@ 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:
@@ -269,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 |

package/README.zh-CN.md

@@ -218,8 +218,8 @@ Machine A:
 | 命令 | 说明 |
 |------|------|
 | `reap init <name>` | 初始化项目。创建`.reap/`结构 |
-| `reap status` | 查看当前Generation状态（显示版本 + 最新状态） |
-| `reap update` | 将命令/模板/hook同步到最新版本。自动清理`~/.claude/commands/`旧版文件 |
+| `reap status` | 查看当前Generation状态 |
+| `reap update` | 将命令/模板/hook同步到最新版本 |
 | `reap fix` | 诊断和修复`.reap/`结构 |
 | `reap help` | 输出CLI命令 + 斜杠命令 + 工作流摘要（显示版本 + 最新状态） |
 | `reap run <cmd>` | 直接执行斜杠命令的脚本（由1行`.md` wrapper内部调用） |
@@ -251,6 +251,25 @@ 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/`中，驱动整个工作流：
@@ -270,6 +289,7 @@ Subagent接收完整上下文后自主执行所有阶段，仅在确实遇到阻
 | `/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 |
@@ -403,7 +423,7 @@ my-project/
 ~/.claude/
 └── settings.json                 # SessionStart hook注册
 
-.claude/commands/                 # 项目级别（会话启动时symlink）
+.claude/commands/                 # 项目级斜杠命令
 └── reap.*.md                     # 活跃斜杠命令（调用`reap run <cmd>`）
 ```