@c-d-cc/reap 0.2.1 → 0.3.0

package/README.ja.md

@@ -38,6 +38,7 @@ REAPは**世代ベースの進化モデル**でこれらの問題を解決しま
 - AIエージェントが毎セッション開始時に現在のコンテキストを自動認識（SessionStart Hook）
 - 実装中に発見した設計問題はbacklogに記録、Completionで反映
 - レトロスペクティブ（Completion）で導き出した教訓がGenomeに蓄積
+- 世代を重ねて繰り返される手作業を自動検出し、ユーザー確認の上でHookとして生成
 
 ## インストール
 
@@ -97,7 +98,7 @@ Objective → Planning → Implementation ⟷ Validation → Completion
 | **Planning** | タスク分解、実装アプローチ、依存関係 | `02-planning.md` |
 | **Implementation** | AI+Human協力でコード実装 | `03-implementation.md` |
 | **Validation** | テスト実行、完了条件の確認 | `04-validation.md` |
-| **Completion** | レトロスペクティブ + Genome変更反映 + アーカイブ | `05-completion.md` |
+| **Completion** | レトロスペクティブ + Genome変更反映 + Hook提案 + アーカイブ | `05-completion.md` |
 
 ## コアコンセプト
 
@@ -110,7 +111,8 @@ Objective → Planning → Implementation ⟷ Validation → Completion
 ├── principles.md      # アーキテクチャ原則/決定
 ├── domain/            # ビジネスルール（モジュール別）
 ├── conventions.md     # 開発ルール/コンベンション
-└── constraints.md     # 技術制約/選択
+├── constraints.md     # 技術制約/選択
+└── source-map.md      # C4 Container/Componentダイアグラム（Mermaid）
 ```
 
 **Genome不変原則**: 現在の世代ではGenomeを直接変更しません。問題を発見した場合はbacklogに記録し、Completionステージでのみ反映します。
@@ -182,7 +184,7 @@ REAPはスラッシュコマンドとセッションフックを通じてAIエ
 | `/reap.back` | 前のステージに回帰（micro loop） |
 | `/reap.status` | 現在のGeneration状態とプロジェクト健全性を表示 |
 | `/reap.sync` | ソースコードベースでGenomeを最新化 |
-| `/reap.help` | 現在の状態に応じたcontextual AIヘルプ（topic: workflow, commands, strict, genome, backlog） |
+| `/reap.help` | 24+トピックのcontextual AIヘルプ（workflow, genome, backlog, strict, agents, hooks, config, evolve, regression, authorおよび全コマンド名） |
 | `/reap.update` | REAPのアップデート確認と最新バージョンへのアップグレード |
 | **`/reap.evolve`** | **1つのGeneration全体を最初から最後まで実行（推奨）** |
 
@@ -193,6 +195,8 @@ REAPはスラッシュコマンドとセッションフックを通じてAIエ
 - REAPワークフロー全体のガイド（Genome、ライフサイクル、4軸構造など）
 - 現在のGeneration状態（どのステージにいるか、次に何をすべきか）
 - REAPライフサイクルに従うルール
+- Genome鮮度検出 — 最後のGenome更新以降にコード関連のコミット（`src/`、`tests/`、`package.json`、`tsconfig.json`、`scripts/`）があったかを確認（ドキュメントのみの変更は除外）
+- Source-mapドリフト検出 — `source-map.md`に記録されたコンポーネントとプロジェクト内の実際のファイルを比較
 
 これにより、新しいセッションを開いてもエージェントがプロジェクトコンテキストを即座に把握します。
 
@@ -220,22 +224,28 @@ Strictモードはデフォルトで無効です（`strict: false`）。
 
 ### REAP Hooks
 
-`.reap/config.yml`にhookを定義して、ライフサイクルイベントでコマンドやAIプロンプトを実行できます：
+Hookはファイルベースで`.reap/hooks/`に保存されます。各Hookは`{event}.{name}.{md|sh}`形式のファイルです：
+
+- `.md`ファイルはAIプロンプトを含みます（AIエージェントが実行）
+- `.sh`ファイルはシェルスクリプトを含みます（直接実行）
 
-```yaml
-hooks:
-  onGenerationStart:
-    - command: "echo 'Generation started'"
-  onStageTransition:
-    - command: "echo 'Stage changed'"
-  onGenerationComplete:
-    - command: "reap update"
-    - prompt: "今回のGenerationで変更された機能があればREADMEに反映せよ。"
-  onRegression:
-    - command: "echo 'Regressed'"
 ```
+.reap/hooks/
+├── onGenerationStart.context-load.md
+├── onGenerationComplete.version-bump.md
+├── onGenerationComplete.readme-update.md
+├── onStageTransition.notify.sh
+└── onRegression.alert.sh
+```
+
+各Hookファイルは以下のフィールドを持つfrontmatterをサポートします：
 
-各hookは`command`（シェルコマンド）または`prompt`（AIエージェント指示）のいずれかを使用します。
+```yaml
+---
+condition: has-code-changes   # always | has-code-changes | version-bumped
+order: 10                     # 実行順序（小さいほど先に実行）
+---
+```
 
 | イベント | トリガー |
 |----------|----------|
@@ -244,7 +254,7 @@ hooks:
 | `onGenerationComplete` | `/reap.next`で完了したGenerationをアーカイブ後 |
 | `onRegression` | `/reap.back`で前のステージに回帰後 |
 
-HookはAIエージェントがプロジェクトルートディレクトリで実行します。
+HookはAIエージェントがプロジェクトルートディレクトリで実行します。`onGenerationComplete` Hookには自動バージョンバンプ判定が含まれています — patchレベルは自動適用され、minor/majorバンプはユーザー確認が必要です。
 
 ## `reap init`後のプロジェクト構造
 
@@ -257,7 +267,9 @@ my-project/
     │   ├── principles.md
     │   ├── domain/
     │   ├── conventions.md
-    │   └── constraints.md
+    │   ├── constraints.md
+    │   └── source-map.md
+    ├── hooks/                    # Lifecycle hooks (.md/.sh)
     ├── environment/              # 外部環境
     ├── life/                     # 現在の世代
     │   ├── current.yml
@@ -275,10 +287,10 @@ my-project/
 
 | レベル | 入力 | 出力 | 最大行数 | トリガー |
 |--------|------|------|----------|----------|
-| **Level 1** | 世代フォルダ（5つの成果物） | `gen-XXX.md` | 40行 | lineage > 10,000行 + 5世代以上 |
+| **Level 1** | 世代フォルダ（5つの成果物） | `gen-XXX.md` | 40行 | lineage > 5,000行 + 5世代以上 |
 | **Level 2** | Level 1ファイル5つ | `epoch-XXX.md` | 60行 | Level 1が5つ以上 |
 
-圧縮は世代完了時に自動実行されます。圧縮されたファイルは目標（Objective）と結果（Completion）を中心に保存し、中間過程は特記事項のみを残します。
+圧縮は世代完了時に自動実行されます。直近3世代は常に圧縮から保護されます。圧縮されたファイルは目標（Objective）と結果（Completion）を中心に保存し、中間過程は特記事項のみを残します。
 
 ## 進化フロー（Evolution Flow）
 
@@ -316,6 +328,10 @@ reap init my-project --preset bun-hono-react
 | `migration` | 既存システムを参照しながら新規構築 |
 | `adoption` | 既存コードベースにREAPを適用 |
 
+## 作者
+
+**HyeonIL Choi** — [hichoi@c-d.cc](mailto:hichoi@c-d.cc) | [c-d.cc](https://c-d.cc) | [LinkedIn](https://www.linkedin.com/in/hichoi-dev) | [GitHub](https://github.com/casamia918)
+
 ## ライセンス
 
 MIT

package/README.ko.md

@@ -38,6 +38,7 @@ REAP은 **세대 기반 진화 모델**로 이 문제들을 해결합니다:
 - AI 에이전트가 매 세션 시작 시 현재 맥락을 자동으로 인식 (SessionStart Hook)
 - 구현 중 발견한 설계 문제는 backlog에 기록, Completion에서 반영
 - 회고(Completion)에서 도출한 교훈이 Genome에 축적
+- 세대를 거듭하며 반복되는 수작업을 자동 감지하고, 사용자 확인 후 Hook으로 생성
 
 ## 설치
 
@@ -97,7 +98,7 @@ Objective → Planning → Implementation ⟷ Validation → Completion
 | **Planning** | 태스크 분해, 구현 접근법, 의존관계 | `02-planning.md` |
 | **Implementation** | AI+Human 협업으로 코드 구현 | `03-implementation.md` |
 | **Validation** | 테스트 실행, 완료 조건 점검 | `04-validation.md` |
-| **Completion** | 회고 + Genome 변경 반영 + 아카이빙 | `05-completion.md` |
+| **Completion** | 회고 + Genome 변경 반영 + Hook 제안 + 아카이빙 | `05-completion.md` |
 
 ## 핵심 개념
 
@@ -110,7 +111,8 @@ Application의 유전 정보 — 아키텍처 원칙, 비즈니스 규칙, 개
 ├── principles.md      # 아키텍처 원칙/결정
 ├── domain/            # 비즈니스 규칙 (모듈별)
 ├── conventions.md     # 개발 규칙/컨벤션
-└── constraints.md     # 기술 제약/선택
+├── constraints.md     # 기술 제약/선택
+└── source-map.md      # C4 Container/Component 다이어그램 (Mermaid)
 ```
 
 **Genome 불변 원칙**: 현재 세대에서는 Genome을 직접 수정하지 않습니다. 문제를 발견하면 backlog에 기록하고, Completion 단계에서만 반영합니다.
@@ -182,7 +184,7 @@ Slash command가 `.claude/commands/`에 설치되어 전체 워크플로우를
 | `/reap.back` | 이전 stage로 복귀 (micro loop) |
 | `/reap.status` | 현재 Generation 상태 및 프로젝트 건강 상태 표시 |
 | `/reap.sync` | 소스 코드 기반 Genome 최신화 |
-| `/reap.help` | 현재 상태에 따른 contextual AI 도움말 (topic: workflow, commands, strict, genome, backlog) |
+| `/reap.help` | 24+ 주제의 contextual AI 도움말 (workflow, genome, backlog, strict, agents, hooks, config, evolve, regression, author 및 모든 커맨드 이름) |
 | `/reap.update` | REAP 업데이트 확인 및 최신 버전으로 업그레이드 |
 | **`/reap.evolve`** | **한 Generation 전체를 처음부터 끝까지 실행 (권장)** |
 
@@ -193,6 +195,8 @@ Slash command가 `.claude/commands/`에 설치되어 전체 워크플로우를
 - REAP 워크플로우 전체 가이드 (Genome, Life Cycle, 4축 구조 등)
 - 현재 Generation 상태 (어떤 stage인지, 다음에 뭘 해야 하는지)
 - REAP lifecycle을 따르라는 규칙
+- Genome 최신성 감지 — 마지막 Genome 업데이트 이후 코드 관련 커밋(`src/`, `tests/`, `package.json`, `tsconfig.json`, `scripts/`)이 있었는지 확인 (문서 전용 변경은 제외)
+- Source-map 드리프트 감지 — `source-map.md`에 기록된 컴포넌트와 프로젝트의 실제 파일을 비교
 
 이를 통해 새 세션을 열어도 에이전트가 프로젝트 맥락을 즉시 파악합니다.
 
@@ -220,22 +224,28 @@ Strict 모드는 기본적으로 비활성화되어 있습니다 (`strict: false
 
 ### REAP Hooks
 
-`.reap/config.yml`에 hook을 정의하여 lifecycle 이벤트에 명령 또는 AI 프롬프트를 실행할 수 있습니다:
+Hook은 파일 기반이며 `.reap/hooks/`에 저장됩니다. 각 Hook은 `{event}.{name}.{md|sh}` 형식의 파일입니다:
+
+- `.md` 파일은 AI 프롬프트를 담고 있습니다 (AI 에이전트가 실행)
+- `.sh` 파일은 셸 스크립트를 담고 있습니다 (직접 실행)
 
-```yaml
-hooks:
-  onGenerationStart:
-    - command: "echo 'Generation started'"
-  onStageTransition:
-    - command: "echo 'Stage changed'"
-  onGenerationComplete:
-    - command: "reap update"
-    - prompt: "이번 Generation 변경사항을 README에 반영하라."
-  onRegression:
-    - command: "echo 'Regressed'"
 ```
+.reap/hooks/
+├── onGenerationStart.context-load.md
+├── onGenerationComplete.version-bump.md
+├── onGenerationComplete.readme-update.md
+├── onStageTransition.notify.sh
+└── onRegression.alert.sh
+```
+
+각 Hook 파일은 다음 필드를 가진 frontmatter를 지원합니다:
 
-각 hook은 `command` (shell 명령) 또는 `prompt` (AI 에이전트 지시) 중 하나를 사용합니다.
+```yaml
+---
+condition: has-code-changes   # always | has-code-changes | version-bumped
+order: 10                     # 실행 순서 (낮을수록 먼저 실행)
+---
+```
 
 | 이벤트 | 트리거 |
 |--------|--------|
@@ -244,7 +254,7 @@ hooks:
 | `onGenerationComplete` | `/reap.next`로 완료된 Generation 아카이빙 후 |
 | `onRegression` | `/reap.back`으로 이전 stage 복귀 후 |
 
-Hook은 AI 에이전트가 프로젝트 루트 디렉토리에서 실행합니다.
+Hook은 AI 에이전트가 프로젝트 루트 디렉토리에서 실행합니다. `onGenerationComplete` Hook에는 자동 버전 범프 판단이 포함되어 있습니다 — patch 수준은 자동으로 적용되고, minor/major 범프는 사용자 확인을 거칩니다.
 
 ## `reap init` 후 프로젝트 구조
 
@@ -257,7 +267,9 @@ my-project/
     │   ├── principles.md
     │   ├── domain/
     │   ├── conventions.md
-    │   └── constraints.md
+    │   ├── constraints.md
+    │   └── source-map.md
+    ├── hooks/                    # Lifecycle hooks (.md/.sh)
     ├── environment/              # 외부 환경
     ├── life/                     # 현재 세대
     │   ├── current.yml
@@ -275,10 +287,10 @@ my-project/
 
 | 레벨 | 입력 | 출력 | 최대 줄 수 | 트리거 |
 |------|------|------|-----------|--------|
-| **Level 1** | 세대 폴더 (5개 산출물) | `gen-XXX.md` | 40줄 | lineage > 10,000줄 + 5세대 이상 |
+| **Level 1** | 세대 폴더 (5개 산출물) | `gen-XXX.md` | 40줄 | lineage > 5,000줄 + 5세대 이상 |
 | **Level 2** | Level 1 파일 5개 | `epoch-XXX.md` | 60줄 | Level 1이 5개 이상 |
 
-압축은 세대 완료 시 자동 실행됩니다. 압축된 파일은 목표(Objective)와 결과(Completion)를 중심으로 보존하고, 중간 과정은 특이사항만 남깁니다.
+압축은 세대 완료 시 자동 실행됩니다. 가장 최근 3개 세대는 항상 압축에서 보호됩니다. 압축된 파일은 목표(Objective)와 결과(Completion)를 중심으로 보존하고, 중간 과정은 특이사항만 남깁니다.
 
 ## 진화 흐름 (Evolution Flow)
 
@@ -316,6 +328,10 @@ reap init my-project --preset bun-hono-react
 | `migration` | 기존 시스템을 참조하여 새로 구축 |
 | `adoption` | 기존 코드베이스에 REAP을 적용 |
 
+## 저자
+
+**HyeonIL Choi** — [hichoi@c-d.cc](mailto:hichoi@c-d.cc) | [c-d.cc](https://c-d.cc) | [LinkedIn](https://www.linkedin.com/in/hichoi-dev) | [GitHub](https://github.com/casamia918)
+
 ## 라이선스
 
 MIT

package/README.md

@@ -38,6 +38,7 @@ REAP solves these with a **generation-based evolution model**:
 - The AI agent automatically picks up current context at every session start (SessionStart Hook)
 - Design issues discovered during implementation are logged in the backlog and addressed at Completion
 - Lessons drawn from retrospectives (Completion) accumulate in the Genome
+- Repeated manual tasks are automatically detected across generations, with user-confirmed hook creation
 
 ## Installation
 
@@ -96,7 +97,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 + archive | `05-completion.md` |
+| **Completion** | Retrospective + apply Genome changes + hook suggestion + archive | `05-completion.md` |
 
 ## Core Concepts
 
@@ -109,7 +110,8 @@ The application's genetic information — a collection of architecture principle
 ├── principles.md      # Architecture principles/decisions
 ├── domain/            # Business rules (per module)
 ├── conventions.md     # Development rules/conventions
-└── constraints.md     # Technical constraints/choices
+├── constraints.md     # Technical constraints/choices
+└── source-map.md      # C4 Container/Component diagram (Mermaid)
 ```
 
 **Genome Immutability Principle**: The Genome is never modified directly during the current generation. When an issue is found, it is recorded in the backlog and only applied at the Completion stage.
@@ -181,7 +183,7 @@ Slash commands are installed in `.claude/commands/` and drive the entire workflo
 | `/reap.back` | Return to a previous stage (micro loop) |
 | `/reap.status` | Show current generation state and project health |
 | `/reap.sync` | Synchronize Genome with current source code |
-| `/reap.help` | Contextual AI help based on current state (topic: workflow, commands, strict, genome, backlog) |
+| `/reap.help` | Contextual AI help with 24+ topics (workflow, genome, backlog, strict, agents, hooks, config, evolve, regression, author, and all command names) |
 | `/reap.update` | Check for REAP updates and upgrade to the latest version |
 | **`/reap.evolve`** | **Run an entire generation from start to finish (recommended)** |
 
@@ -192,6 +194,8 @@ Runs automatically at the start of every session, injecting the following into t
 - The full REAP workflow guide (Genome, Life Cycle, Four-Axis Structure, etc.)
 - Current generation state (which stage you're in, what to do next)
 - Rules to follow the REAP lifecycle
+- Genome staleness detection — checks if code-related commits (`src/`, `tests/`, `package.json`, `tsconfig.json`, `scripts/`) have occurred since the last Genome update (docs-only changes are excluded)
+- Source-map drift detection — compares documented components in `source-map.md` against actual files in the project
 
 This ensures the agent immediately understands the project context even in a brand-new session.
 
@@ -219,22 +223,28 @@ Strict mode is disabled by default (`strict: false`).
 
 ### REAP Hooks
 
-Projects can define hooks in `.reap/config.yml` to run commands or AI prompts at lifecycle events:
+Hooks are file-based and stored in `.reap/hooks/`. Each hook is a file named `{event}.{name}.{md|sh}`:
+
+- `.md` files contain AI prompts (executed by the AI agent)
+- `.sh` files contain shell scripts (executed directly)
 
-```yaml
-hooks:
-  onGenerationStart:
-    - command: "echo 'Generation started'"
-  onStageTransition:
-    - command: "echo 'Stage changed'"
-  onGenerationComplete:
-    - command: "reap update"
-    - prompt: "Update README if this generation changed any features."
-  onRegression:
-    - command: "echo 'Regressed'"
 ```
+.reap/hooks/
+├── onGenerationStart.context-load.md
+├── onGenerationComplete.version-bump.md
+├── onGenerationComplete.readme-update.md
+├── onStageTransition.notify.sh
+└── onRegression.alert.sh
+```
+
+Each hook file supports frontmatter with the following fields:
 
-Each hook supports `command` (shell) or `prompt` (AI agent instruction).
+```yaml
+---
+condition: has-code-changes   # always | has-code-changes | version-bumped
+order: 10                     # execution order (lower runs first)
+---
+```
 
 | Event | Trigger |
 |-------|---------|
@@ -243,7 +253,7 @@ Each hook supports `command` (shell) or `prompt` (AI agent instruction).
 | `onGenerationComplete` | After `/reap.next` archives a completed generation |
 | `onRegression` | After `/reap.back` returns to a previous stage |
 
-Hooks are executed by the AI agent in the project root directory.
+Hooks are executed by the AI agent in the project root directory. The `onGenerationComplete` hooks include automatic version bump judgment — patch-level bumps are applied automatically, while minor/major bumps require user confirmation.
 
 ## Project Structure After `reap init`
 
@@ -256,7 +266,9 @@ my-project/
     │   ├── principles.md
     │   ├── domain/
     │   ├── conventions.md
-    │   └── constraints.md
+    │   ├── constraints.md
+    │   └── source-map.md
+    ├── hooks/                    # Lifecycle hooks (.md/.sh)
     ├── environment/              # External context
     ├── life/                     # Current generation
     │   ├── current.yml
@@ -274,10 +286,10 @@ As generations accumulate, the lineage directory grows. REAP manages this with a
 
 | Level | Input | Output | Max lines | Trigger |
 |-------|-------|--------|-----------|---------|
-| **Level 1** | Generation folder (5 artifacts) | `gen-XXX.md` | 40 lines | lineage > 10,000 lines + 5+ generations |
+| **Level 1** | Generation folder (5 artifacts) | `gen-XXX.md` | 40 lines | lineage > 5,000 lines + 5+ generations |
 | **Level 2** | 5 Level 1 files | `epoch-XXX.md` | 60 lines | 5+ Level 1 files |
 
-Compression runs automatically when a generation completes. Compressed files preserve objectives and completion results while retaining only notable findings from intermediate stages.
+Compression runs automatically when a generation completes. The most recent 3 generations are always protected from compression. Compressed files preserve objectives and completion results while retaining only notable findings from intermediate stages.
 
 ## Evolution Flow
 
@@ -315,6 +327,10 @@ reap init my-project --preset bun-hono-react
 | `migration` | Build anew while referencing an existing system |
 | `adoption` | Apply REAP to an existing codebase |
 
+## Author
+
+**HyeonIL Choi** — [hichoi@c-d.cc](mailto:hichoi@c-d.cc) | [c-d.cc](https://c-d.cc) | [LinkedIn](https://www.linkedin.com/in/hichoi-dev) | [GitHub](https://github.com/casamia918)
+
 ## License
 
 MIT

package/README.zh-CN.md

@@ -38,6 +38,7 @@ REAP通过**基于世代的进化模型**解决这些问题：
 - AI代理在每次会话开始时自动获取当前上下文（SessionStart Hook）
 - 实现过程中发现的设计问题记录在backlog中，在Completion时反映
 - 回顾（Completion）中提取的教训积累在Genome中
+- 跨世代自动检测重复的手动操作，经用户确认后生成Hook
 
 ## 安装
 
@@ -97,7 +98,7 @@ Objective → Planning → Implementation ⟷ Validation → Completion
 | **Planning** | 任务分解、实施方案、依赖关系 | `02-planning.md` |
 | **Implementation** | AI+人类协作编写代码 | `03-implementation.md` |
 | **Validation** | 执行测试、检查完成条件 | `04-validation.md` |
-| **Completion** | 回顾 + 应用Genome变更 + 归档 | `05-completion.md` |
+| **Completion** | 回顾 + 应用Genome变更 + Hook建议 + 归档 | `05-completion.md` |
 
 ## 核心概念
 
@@ -110,7 +111,8 @@ Objective → Planning → Implementation ⟷ Validation → Completion
 ├── principles.md      # 架构原则/决策
 ├── domain/            # 业务规则（按模块）
 ├── conventions.md     # 开发规则/约定
-└── constraints.md     # 技术约束/选择
+├── constraints.md     # 技术约束/选择
+└── source-map.md      # C4 Container/Component图（Mermaid）
 ```
 
 **Genome不变原则**：当前世代不直接修改Genome。发现问题时记录在backlog中，仅在Completion阶段反映。
@@ -182,7 +184,7 @@ REAP通过斜杠命令和会话钩子与AI代理集成。当前支持的代理
 | `/reap.back` | 回到前一个阶段（micro loop） |
 | `/reap.status` | 显示当前Generation状态和项目健康度 |
 | `/reap.sync` | 基于源代码同步Genome |
-| `/reap.help` | 基于当前状态的上下文AI帮助（topic: workflow, commands, strict, genome, backlog） |
+| `/reap.help` | 24+主题的上下文AI帮助（workflow, genome, backlog, strict, agents, hooks, config, evolve, regression, author及所有命令名） |
 | `/reap.update` | 检查REAP更新并升级到最新版本 |
 | **`/reap.evolve`** | **从头到尾运行一个完整的Generation（推荐）** |
 
@@ -193,6 +195,8 @@ REAP通过斜杠命令和会话钩子与AI代理集成。当前支持的代理
 - REAP工作流完整指南（Genome、生命周期、四轴结构等）
 - 当前Generation状态（在哪个阶段、下一步做什么）
 - 遵循REAP生命周期的规则
+- Genome新鲜度检测 — 检查上次Genome更新后是否有代码相关提交（`src/`、`tests/`、`package.json`、`tsconfig.json`、`scripts/`），纯文档变更除外
+- Source-map漂移检测 — 将`source-map.md`中记录的组件与项目中的实际文件进行比对
 
 这确保即使打开新会话，代理也能立即理解项目上下文。
 
@@ -220,22 +224,28 @@ Strict模式默认禁用（`strict: false`）。
 
 ### REAP Hooks
 
-在`.reap/config.yml`中定义hook，在生命周期事件时执行命令或AI提示：
+Hook基于文件，存储在`.reap/hooks/`中。每个Hook是一个以`{event}.{name}.{md|sh}`命名的文件：
+
+- `.md`文件包含AI提示词（由AI代理执行）
+- `.sh`文件包含Shell脚本（直接执行）
 
-```yaml
-hooks:
-  onGenerationStart:
-    - command: "echo 'Generation started'"
-  onStageTransition:
-    - command: "echo 'Stage changed'"
-  onGenerationComplete:
-    - command: "reap update"
-    - prompt: "如果本Generation有功能变更，请更新README。"
-  onRegression:
-    - command: "echo 'Regressed'"
 ```
+.reap/hooks/
+├── onGenerationStart.context-load.md
+├── onGenerationComplete.version-bump.md
+├── onGenerationComplete.readme-update.md
+├── onStageTransition.notify.sh
+└── onRegression.alert.sh
+```
+
+每个Hook文件支持包含以下字段的frontmatter：
 
-每个hook使用`command`（shell命令）或`prompt`（AI代理指令）之一。
+```yaml
+---
+condition: has-code-changes   # always | has-code-changes | version-bumped
+order: 10                     # 执行顺序（数值越小越先执行）
+---
+```
 
 | 事件 | 触发时机 |
 |------|----------|
@@ -244,7 +254,7 @@ hooks:
 | `onGenerationComplete` | `/reap.next`归档已完成的Generation后 |
 | `onRegression` | `/reap.back`回到前一阶段后 |
 
-Hook由AI代理在项目根目录中执行。
+Hook由AI代理在项目根目录中执行。`onGenerationComplete` Hook包含自动版本号升级判断 — patch级别自动应用，minor/major级别需要用户确认。
 
 ## `reap init`后的项目结构
 
@@ -257,7 +267,9 @@ my-project/
     │   ├── principles.md
     │   ├── domain/
     │   ├── conventions.md
-    │   └── constraints.md
+    │   ├── constraints.md
+    │   └── source-map.md
+    ├── hooks/                    # Lifecycle hooks (.md/.sh)
     ├── environment/              # 外部环境
     ├── life/                     # 当前世代
     │   ├── current.yml
@@ -275,10 +287,10 @@ my-project/
 
 | 级别 | 输入 | 输出 | 最大行数 | 触发条件 |
 |------|------|------|----------|----------|
-| **Level 1** | 世代文件夹（5个产出物） | `gen-XXX.md` | 40行 | lineage > 10,000行 + 5个以上世代 |
+| **Level 1** | 世代文件夹（5个产出物） | `gen-XXX.md` | 40行 | lineage > 5,000行 + 5个以上世代 |
 | **Level 2** | 5个Level 1文件 | `epoch-XXX.md` | 60行 | Level 1达到5个以上 |
 
-压缩在世代完成时自动执行。压缩后的文件以目标（Objective）和结果（Completion）为中心保存，中间过程仅保留特别事项。
+压缩在世代完成时自动执行。最近3个世代始终受到保护，不会被压缩。压缩后的文件以目标（Objective）和结果（Completion）为中心保存，中间过程仅保留特别事项。
 
 ## 进化流程（Evolution Flow）
 
@@ -316,6 +328,10 @@ reap init my-project --preset bun-hono-react
 | `migration` | 参考现有系统进行新建 |
 | `adoption` | 将REAP应用到现有代码库 |
 
+## 作者
+
+**HyeonIL Choi** — [hichoi@c-d.cc](mailto:hichoi@c-d.cc) | [c-d.cc](https://c-d.cc) | [LinkedIn](https://www.linkedin.com/in/hichoi-dev) | [GitHub](https://github.com/casamia918)
+
 ## 许可证
 
 MIT