@c-d-cc/reap 0.16.1 → 0.16.3

package/README.de.md

@@ -30,7 +30,7 @@ REAP ist eine generationsbasierte Entwicklungspipeline, in der KI und Menschen z
 - [Konfiguration](#konfiguration-)
 - [Upgrade von v0.15](#upgrade-von-v015)
 
-## Was ist REAP?
+## Was ist REAP? [↗](https://reap.cc/docs/introduction)
 
 Sind Ihnen bei der Entwicklung mit KI-Agenten schon einmal diese Probleme begegnet?
 
@@ -59,7 +59,7 @@ npm install -g @c-d-cc/reap
 
 > **Voraussetzungen**: [Node.js](https://nodejs.org) v18+, [Claude Code](https://claude.ai/claude-code) CLI.
 
-## Schnellstart
+## Schnellstart [↗](https://reap.cc/docs/quick-start)
 
 Öffnen Sie Ihren KI-Agenten (Claude Code) und verwenden Sie Slash Commands:
 
@@ -202,7 +202,7 @@ N Generationen für autonome Ausführung vorab genehmigen:
 - Bei erkannter Unsicherheit oder Risiko pausiert der Cruise-Modus und fordert menschliches Feedback an
 - Nach Abschluss aller N Generationen überprüft der Mensch das Ergebnis
 
-## Slash Commands
+## Slash Commands [↗](https://reap.cc/docs/command-reference)
 
 | Befehl | Beschreibung |
 |--------|-------------|
@@ -283,7 +283,7 @@ Wichtige Einstellungen:
 - **`strictMerge`**: Beschränkt direktes git pull/push/merge — verwenden Sie stattdessen `/reap.pull`, `/reap.push`, `/reap.merge`.
 - **`agentClient`**: Bestimmt, welcher Adapter für die Skill-Bereitstellung verwendet wird.
 
-## Upgrade von v0.15
+## Upgrade von v0.15 [↗](https://reap.cc/docs/migration-guide)
 
 REAP v0.16 ist eine vollständige Neuentwicklung, basierend auf der [Self-Evolving Pipeline](https://reap.cc/docs/self-evolving)-Architektur.
 
@@ -336,7 +336,7 @@ Alle v0.15-Dateien werden unter `.reap/v15/` aufbewahrt. Nach Überprüfung der
 **Vision-Ebene hinzugefügt:**
 - `vision/goals.md` — Langfristige Ziele, lückengetriebene Zielauswahl in der Adapt-Phase
 - `vision/memory/` — 3-stufiges Gedächtnis (longterm, midterm, shortterm) für generationsübergreifenden Kontext
-- `vision/docs/` — Planungsdokumente und Spezifikationen
+- `vision/design/` — Planungsdokumente und Spezifikationen
 
 **Genome umstrukturiert (3 Dateien):**
 - `application.md` — Projektidentität, Architektur, Konventionen, Einschränkungen

package/README.ja.md

@@ -30,7 +30,7 @@ REAPは、AIと人間が協力してソフトウェアを構築・進化させ
 - [設定](#設定-)
 - [v0.15からのアップグレード](#v015からのアップグレード)
 
-## REAPとは？
+## REAPとは？ [↗](https://reap.cc/docs/introduction)
 
 AIエージェントを使った開発で、こんな問題に遭遇したことはありませんか？
 
@@ -59,7 +59,7 @@ npm install -g @c-d-cc/reap
 
 > **要件**: [Node.js](https://nodejs.org) v18以上、[Claude Code](https://claude.ai/claude-code) CLI。
 
-## クイックスタート
+## クイックスタート [↗](https://reap.cc/docs/quick-start)
 
 AIエージェント（Claude Code）を開き、スラッシュコマンドを使います：
 
@@ -202,7 +202,7 @@ N世代分の自律実行を事前承認：
 - 不確実性やリスクが検出された場合、cruise を一時停止して人間のフィードバックを要求
 - 全N世代の完了後、人間がバッチをレビュー
 
-## スラッシュコマンド
+## スラッシュコマンド [↗](https://reap.cc/docs/command-reference)
 
 | コマンド | 説明 |
 |----------|------|
@@ -283,7 +283,7 @@ agentClient: claude-code       # AIエージェントクライアント
 - **`strictMerge`**: 直接の git pull/push/merge を制限します — 代わりに `/reap.pull`、`/reap.push`、`/reap.merge` を使用してください。
 - **`agentClient`**: スキルのデプロイに使用するアダプターを決定します。
 
-## v0.15からのアップグレード
+## v0.15からのアップグレード [↗](https://reap.cc/docs/migration-guide)
 
 REAP v0.16 は [Self-Evolving Pipeline](https://reap.cc/docs/self-evolving) アーキテクチャに基づく完全な書き直しです。
 
@@ -336,7 +336,7 @@ REAP v0.16 は [Self-Evolving Pipeline](https://reap.cc/docs/self-evolving) ア
 **Vision レイヤーの追加:**
 - `vision/goals.md` — 長期目標、adapt フェーズでのギャップ駆動目標選択
 - `vision/memory/` — 3層メモリ（longterm, midterm, shortterm）によるジェネレーション間コンテキスト
-- `vision/docs/` — 計画ドキュメントと仕様書
+- `vision/design/` — 計画ドキュメントと仕様書
 
 **Genome の再構成（3ファイル）:**
 - `application.md` — プロジェクトのアイデンティティ、アーキテクチャ、コンベンション、制約

package/README.ko.md

@@ -30,7 +30,7 @@ REAP는 AI와 인간이 협력하여 소프트웨어를 구축하고 진화시
 - [설정](#설정-)
 - [v0.15에서 업그레이드](#v015에서-업그레이드)
 
-## REAP란 무엇인가?
+## REAP란 무엇인가? [↗](https://reap.cc/docs/introduction)
 
 AI 에이전트와 개발할 때 이런 문제를 겪어 본 적 있으신가요?
 
@@ -59,7 +59,7 @@ npm install -g @c-d-cc/reap
 
 > **요구 사항**: [Node.js](https://nodejs.org) v18+, [Claude Code](https://claude.ai/claude-code) CLI.
 
-## 빠른 시작
+## 빠른 시작 [↗](https://reap.cc/docs/quick-start)
 
 AI 에이전트(Claude Code)를 열고 슬래시 명령어를 사용하세요:
 
@@ -202,7 +202,7 @@ N개 세대를 사전 승인하여 자율 실행:
 - 불확실성이나 위험이 감지되면 cruise가 일시 정지하고 인간 피드백을 요청
 - N개 세대 모두 완료 후 인간이 일괄 검토
 
-## 슬래시 명령어
+## 슬래시 명령어 [↗](https://reap.cc/docs/command-reference)
 
 | 명령어 | 설명 |
 |--------|------|
@@ -283,7 +283,7 @@ agentClient: claude-code       # AI 에이전트 클라이언트
 - **`strictMerge`**: 직접 git pull/push/merge를 제한합니다 — 대신 `/reap.pull`, `/reap.push`, `/reap.merge`를 사용하세요.
 - **`agentClient`**: 스킬 배포에 사용할 어댑터를 결정합니다.
 
-## v0.15에서 업그레이드
+## v0.15에서 업그레이드 [↗](https://reap.cc/docs/migration-guide)
 
 REAP v0.16은 [Self-Evolving Pipeline](https://reap.cc/docs/self-evolving) 아키텍처를 기반으로 완전히 재작성되었습니다.
 
@@ -336,7 +336,7 @@ REAP v0.16은 [Self-Evolving Pipeline](https://reap.cc/docs/self-evolving) 아
 **Vision 레이어 추가:**
 - `vision/goals.md` — 장기 목표, 적응 단계에서 간극 기반 목표 선택
 - `vision/memory/` — 3계층 메모리 (longterm, midterm, shortterm), 세대 간 컨텍스트 유지
-- `vision/docs/` — 기획 문서 및 스펙
+- `vision/design/` — 기획 문서 및 스펙
 
 **Genome 재구성 (3파일):**
 - `application.md` — 프로젝트 정체성, 아키텍처, 컨벤션, 제약 조건

package/README.md

@@ -1,4 +1,4 @@
-> [한국어](README.ko.md) | [日本語](README.ja.md) | [简体中文](README.zh-CN.md) | [Deutsch](README.de.md)
+> [한국어](https://github.com/c-d-cc/reap/blob/main/README.ko.md) | [日本語](https://github.com/c-d-cc/reap/blob/main/README.ja.md) | [简体中文](https://github.com/c-d-cc/reap/blob/main/README.zh-CN.md) | [Deutsch](https://github.com/c-d-cc/reap/blob/main/README.de.md)
 
 <p align="center">
   <img src="https://raw.githubusercontent.com/c-d-cc/reap/main/media/logo.png" alt="REAP" width="80" height="80" />
@@ -32,7 +32,7 @@ REAP is a generation-based development pipeline where AI and humans collaborate
 - [Configuration](#configuration-)
 - [Upgrading from v0.15](#upgrading-from-v015)
 
-## What is REAP?
+## What is REAP? [↗](https://reap.cc/docs/introduction)
 
 Have you ever run into these problems when developing with AI agents?
 
@@ -61,7 +61,7 @@ npm install -g @c-d-cc/reap
 
 > **Requirements**: [Node.js](https://nodejs.org) v18+, [Claude Code](https://claude.ai/claude-code) CLI.
 
-## Quick Start
+## Quick Start [↗](https://reap.cc/docs/quick-start)
 
 Open your AI agent (Claude Code) and use slash commands:
 
@@ -204,7 +204,7 @@ Pre-approve N generations for autonomous execution:
 - If uncertainty or risk is detected, cruise pauses and requests human feedback
 - After all N generations complete, human reviews the batch
 
-## Slash Commands
+## Slash Commands [↗](https://reap.cc/docs/command-reference)
 
 | Command | Description |
 |---------|-------------|
@@ -284,7 +284,7 @@ Key settings:
 - **`strictMerge`**: Restricts direct git pull/push/merge — use `/reap.pull`, `/reap.push`, `/reap.merge` instead.
 - **`agentClient`**: Determines which adapter is used for skill deployment.
 
-## Upgrading from v0.15
+## Upgrading from v0.15 [↗](https://reap.cc/docs/migration-guide)
 
 REAP v0.16 is a complete rewrite built on the [Self-Evolving Pipeline](https://reap.cc/docs/self-evolving) architecture.
 
@@ -337,7 +337,7 @@ All v0.15 files are preserved at `.reap/v15/`. After verifying the migration, yo
 **Vision layer added:**
 - `vision/goals.md` — long-term objectives, gap-driven goal selection at adapt phase
 - `vision/memory/` — 3-tier memory (longterm, midterm, shortterm) for cross-generation context
-- `vision/docs/` — planning documents and specs
+- `vision/design/` — planning documents and specs
 
 **Genome restructured (3 files):**
 - `application.md` — project identity, architecture, conventions, constraints

package/README.zh-CN.md

@@ -30,7 +30,7 @@ REAP 是一个基于代际迭代的开发管道，AI 与人类协作构建和进
 - [配置](#配置-)
 - [从 v0.15 升级](#从-v015-升级)
 
-## 什么是 REAP？
+## 什么是 REAP？ [↗](https://reap.cc/docs/introduction)
 
 在使用 AI 智能体进行开发时，你是否遇到过以下问题？
 
@@ -59,7 +59,7 @@ npm install -g @c-d-cc/reap
 
 > **前提条件**：[Node.js](https://nodejs.org) v18+，[Claude Code](https://claude.ai/claude-code) CLI。
 
-## 快速开始
+## 快速开始 [↗](https://reap.cc/docs/quick-start)
 
 打开你的 AI 智能体（Claude Code）并使用斜杠命令：
 
@@ -202,7 +202,7 @@ AI 根据当前上下文的明确程度调整其沟通风格：
 - 如果检测到不确定性或风险，cruise 暂停并请求人类反馈
 - 所有 N 个代际迭代完成后，人类审阅整批结果
 
-## 斜杠命令
+## 斜杠命令 [↗](https://reap.cc/docs/command-reference)
 
 | 命令 | 描述 |
 |------|------|
@@ -283,7 +283,7 @@ agentClient: claude-code       # AI 智能体客户端
 - **`strictMerge`**：限制直接 git pull/push/merge——请改用 `/reap.pull`、`/reap.push`、`/reap.merge`。
 - **`agentClient`**：决定使用哪个适配器进行技能部署。
 
-## 从 v0.15 升级
+## 从 v0.15 升级 [↗](https://reap.cc/docs/migration-guide)
 
 REAP v0.16 是基于[自进化管道](https://reap.cc/docs/self-evolving)架构的完全重写。
 
@@ -336,7 +336,7 @@ REAP v0.16 是基于[自进化管道](https://reap.cc/docs/self-evolving)架构
 **新增 Vision 层：**
 - `vision/goals.md` — 长期目标，在适应阶段进行差距驱动的目标选择
 - `vision/memory/` — 3层记忆（longterm、midterm、shortterm）用于跨代际迭代的上下文
-- `vision/docs/` — 规划文档和规范
+- `vision/design/` — 规划文档和规范
 
 **Genome 重构（3个文件）：**
 - `application.md` — 项目身份、架构、规范、约束

package/RELEASE_NOTICE.md

@@ -1,5 +1,23 @@
 # Release Notices
 
+## v0.16.3
+### en
+Rename vision/docs to vision/design to avoid confusion with root docs/. Add Design section to Vision (separate from Memory for independent design documents). Add Evaluator Agent design doc. Fix README language links for npm compatibility.
+### ko
+vision/docs를 vision/design으로 리네이밍하여 루트 docs/와의 혼동 방지. Vision에 Design 섹션 추가 (Memory와 구분되는 독립 설계 문서 공간). Evaluator Agent 설계 문서 추가. npm 호환을 위해 README 언어 링크 수정.
+
+## v0.16.2
+### en
+Add `reap make hook` CLI command for creating hooks with correct format. Restore default hook conditions (always, has-code-changes, version-bumped). Remove outdated Presets and Session Context Loading from docs.
+### ko
+`reap make hook` CLI 커맨드 추가 — 올바른 형식의 hook 파일 생성. 기본 hook conditions 복원 (always, has-code-changes, version-bumped). docs에서 outdated된 Presets, Session Context Loading 섹션 제거.
+
+## v0.16.1
+### en
+Fix npm README images not displaying. Restore SPA routing for docs site (404.html fallback). Fix broken docs links in README. Add docs workflow trigger paths.
+### ko
+npm README 이미지 미표시 수정. docs 사이트 SPA 라우팅 복원 (404.html fallback). README 문서 링크 수정. docs workflow 트리거 경로 추가.
+
 ## v0.16.0
 ### en
 First v0.16.0 release. Major rewrite from v0.15 — new lifecycle engine, nonce-based stage verification, 2-level lineage compression, merge lifecycle, and adapter-based agent client support.

package/dist/cli/index.js

@@ -7098,7 +7098,7 @@ async function checkDirectoryStructure(paths, errors) {
     { path: paths.environmentDomain, name: "environment/domain/" },
     { path: paths.environmentResources, name: "environment/resources/" },
     { path: paths.environmentDocs, name: "environment/docs/" },
-    { path: paths.visionDocs, name: "vision/docs/" },
+    { path: paths.visionDesign, name: "vision/design/" },
     { path: paths.memory, name: "vision/memory/" }
   ];
   for (const dir of requiredDirs) {
@@ -7542,6 +7542,7 @@ __export(exports_common, {
 });
 import { join as join3, dirname as dirname2 } from "path";
 import { fileURLToPath } from "url";
+import { readdir as readdir2, copyFile, chmod } from "fs/promises";
 function distPath(...segments) {
   const __dirname2 = dirname2(fileURLToPath(import.meta.url));
   return join3(__dirname2, "..", "templates", ...segments);
@@ -7558,7 +7559,7 @@ async function initCommon(paths, projectName) {
   await ensureDir(paths.backlog);
   await ensureDir(paths.lineage);
   await ensureDir(paths.vision);
-  await ensureDir(paths.visionDocs);
+  await ensureDir(paths.visionDesign);
   await ensureDir(paths.memory);
   await ensureDir(paths.hooks);
   const config = {
@@ -7583,6 +7584,7 @@ async function initCommon(paths, projectName) {
 `);
   await writeTextFile(paths.memoryShortterm, `# Shortterm Memory
 `);
+  await installHookTemplates(paths.hooks);
   await ensureClaudeMd(paths.root, projectName);
   return config;
 }
@@ -7645,6 +7647,33 @@ async function ensureClaudeMd(root, projectName) {
     return "created";
   }
 }
+async function installHookTemplates(hooksDir) {
+  const templateDir = distPath("hooks");
+  const conditionsTemplateDir = join3(templateDir, "conditions");
+  const conditionsDir = join3(hooksDir, "conditions");
+  await ensureDir(conditionsDir);
+  try {
+    const conditionFiles = await readdir2(conditionsTemplateDir);
+    for (const file of conditionFiles) {
+      const dest = join3(conditionsDir, file);
+      if (!await fileExists(dest)) {
+        await copyFile(join3(conditionsTemplateDir, file), dest);
+        await chmod(dest, 493);
+      }
+    }
+  } catch {}
+  try {
+    const hookFiles = await readdir2(templateDir);
+    for (const file of hookFiles) {
+      if (!file.endsWith(".example"))
+        continue;
+      const dest = join3(hooksDir, file);
+      if (!await fileExists(dest)) {
+        await copyFile(join3(templateDir, file), dest);
+      }
+    }
+  } catch {}
+}
 var import_yaml2, DEFAULT_INVARIANTS = `# Invariants
 
 > Absolute constraints. Human-only modification.
@@ -7668,7 +7697,7 @@ var init_common = __esm(() => {
 
 // src/cli/index.ts
 import { readFileSync as readFileSync4 } from "fs";
-import { join as join23, dirname as dirname9 } from "path";
+import { join as join24, dirname as dirname9 } from "path";
 import { fileURLToPath as fileURLToPath7 } from "url";
 
 // src/libs/cli.ts
@@ -8359,7 +8388,7 @@ class Command {
 var program = new Command;
 
 // src/cli/commands/init/index.ts
-import { readdir as readdir4 } from "fs/promises";
+import { readdir as readdir5 } from "fs/promises";
 import { join as join6 } from "path";
 
 // src/core/paths.ts
@@ -8391,7 +8420,7 @@ function createPaths(root) {
     lineage: join(reap, "lineage"),
     vision,
     visionGoals: join(vision, "goals.md"),
-    visionDocs: join(vision, "docs"),
+    visionDesign: join(vision, "design"),
     memory,
     memoryLongterm: join(memory, "longterm.md"),
     memoryMidterm: join(memory, "midterm.md"),
@@ -8540,7 +8569,7 @@ init_common();
 
 // src/core/scanner.ts
 init_fs();
-import { readdir as readdir2, stat as stat2 } from "fs/promises";
+import { readdir as readdir3, stat as stat2 } from "fs/promises";
 import { join as join4, relative } from "path";
 async function scanCodebase(root) {
   let packageJson = null;
@@ -8585,7 +8614,7 @@ async function buildTree(root, dir, depth) {
     return [];
   let entries;
   try {
-    entries = await readdir2(dir);
+    entries = await readdir3(dir);
   } catch {
     return [];
   }
@@ -8923,7 +8952,7 @@ async function execute3(paths) {
 // src/cli/commands/migrate.ts
 init_fs();
 var import_yaml4 = __toESM(require_dist(), 1);
-import { readdir as readdir3, cp, rename, rm as rm2 } from "fs/promises";
+import { readdir as readdir4, cp, rename, rm as rm2 } from "fs/promises";
 import { join as join5, dirname as dirname3 } from "path";
 import { execSync as execSync2 } from "child_process";
 import { fileURLToPath as fileURLToPath2 } from "url";
@@ -9200,7 +9229,7 @@ async function scanV15Structure(paths) {
   const genomeDir = join5(paths.reap, "v15", "genome");
   const currentGenomeDir = paths.genome;
   try {
-    const entries = await readdir3(currentGenomeDir);
+    const entries = await readdir4(currentGenomeDir);
     for (const e of entries) {
       if (e.endsWith(".md"))
         genomeFiles.push(e);
@@ -9209,7 +9238,7 @@ async function scanV15Structure(paths) {
   const domainFiles = [];
   const domainDir = join5(currentGenomeDir, "domain");
   try {
-    const entries = await readdir3(domainDir);
+    const entries = await readdir4(domainDir);
     for (const e of entries) {
       if (e.endsWith(".md"))
         domainFiles.push(e);
@@ -9217,18 +9246,18 @@ async function scanV15Structure(paths) {
   } catch {}
   let lineageCount = 0;
   try {
-    const entries = await readdir3(paths.lineage);
+    const entries = await readdir4(paths.lineage);
     lineageCount = entries.filter((e) => e.startsWith("gen-")).length;
   } catch {}
   let backlogCount = 0;
   try {
-    const entries = await readdir3(paths.backlog);
+    const entries = await readdir4(paths.backlog);
     backlogCount = entries.filter((e) => e.endsWith(".md")).length;
   } catch {}
   const hooks = [];
   const hooksMappingNeeded = [];
   try {
-    const entries = await readdir3(paths.hooks);
+    const entries = await readdir4(paths.hooks);
     for (const e of entries) {
       if (e.startsWith("on") && (e.endsWith(".sh") || e.endsWith(".md"))) {
         hooks.push(e);
@@ -9458,7 +9487,7 @@ async function executeMain(paths) {
   const domainFiles = [];
   const v15DomainDir = join5(v15Dir, "genome", "domain");
   try {
-    const entries = await readdir3(v15DomainDir);
+    const entries = await readdir4(v15DomainDir);
     domainFiles.push(...entries.filter((e) => e.endsWith(".md")));
   } catch {}
   await step("environment-copy", async () => {
@@ -9469,7 +9498,7 @@ async function executeMain(paths) {
     const v15EnvDomain = join5(v15Dir, "environment", "domain");
     if (await fileExists(v15EnvDomain)) {
       try {
-        const entries = await readdir3(v15EnvDomain);
+        const entries = await readdir4(v15EnvDomain);
         for (const e of entries) {
           await cp(join5(v15EnvDomain, e), join5(paths.environmentDomain, e), { recursive: true });
         }
@@ -9478,7 +9507,7 @@ async function executeMain(paths) {
     const v15EnvResources = join5(v15Dir, "environment", "resources");
     if (await fileExists(v15EnvResources)) {
       try {
-        const entries = await readdir3(v15EnvResources);
+        const entries = await readdir4(v15EnvResources);
         for (const e of entries) {
           await cp(join5(v15EnvResources, e), join5(paths.environmentResources, e), { recursive: true });
         }
@@ -9487,7 +9516,7 @@ async function executeMain(paths) {
     const v15EnvDocs = join5(v15Dir, "environment", "docs");
     if (await fileExists(v15EnvDocs)) {
       try {
-        const entries = await readdir3(v15EnvDocs);
+        const entries = await readdir4(v15EnvDocs);
         for (const e of entries) {
           await cp(join5(v15EnvDocs, e), join5(paths.environmentDocs, e), { recursive: true });
         }
@@ -9510,7 +9539,7 @@ async function executeMain(paths) {
     const v15Lineage = join5(v15Dir, "lineage");
     if (await fileExists(v15Lineage)) {
       try {
-        const entries = await readdir3(v15Lineage);
+        const entries = await readdir4(v15Lineage);
         for (const e of entries) {
           await cp(join5(v15Lineage, e), join5(paths.lineage, e), { recursive: true });
         }
@@ -9521,7 +9550,7 @@ async function executeMain(paths) {
     const v15Backlog = join5(v15Dir, "life", "backlog");
     if (await fileExists(v15Backlog)) {
       try {
-        const entries = await readdir3(v15Backlog);
+        const entries = await readdir4(v15Backlog);
         for (const e of entries) {
           await cp(join5(v15Backlog, e), join5(paths.backlog, e), { recursive: true });
         }
@@ -9534,7 +9563,7 @@ async function executeMain(paths) {
     const v15Hooks = join5(v15Dir, "hooks");
     if (await fileExists(v15Hooks)) {
       try {
-        const entries = await readdir3(v15Hooks);
+        const entries = await readdir4(v15Hooks);
         for (const e of entries) {
           if (e === "conditions") {
             const condSrc = join5(v15Hooks, "conditions");
@@ -9733,17 +9762,17 @@ async function executeComplete(paths) {
   await clearMigrationState(paths);
   let lineageCount = 0;
   try {
-    const entries = await readdir3(paths.lineage);
+    const entries = await readdir4(paths.lineage);
     lineageCount = entries.filter((e) => e.startsWith("gen-")).length;
   } catch {}
   let backlogCount = 0;
   try {
-    const entries = await readdir3(paths.backlog);
+    const entries = await readdir4(paths.backlog);
     backlogCount = entries.filter((e) => e.endsWith(".md")).length;
   } catch {}
   let hookCount = 0;
   try {
-    const entries = await readdir3(paths.hooks);
+    const entries = await readdir4(paths.hooks);
     hookCount = entries.filter((e) => e.startsWith("on")).length;
   } catch {}
   emitOutput({
@@ -9836,7 +9865,7 @@ async function detectMode(root) {
   }
   let entries;
   try {
-    entries = await readdir4(root);
+    entries = await readdir5(root);
   } catch {
     return "greenfield";
   }
@@ -9877,7 +9906,7 @@ async function execute5(projectName, mode, repair, migrate, phase) {
 
 // src/cli/commands/status.ts
 var import_yaml5 = __toESM(require_dist(), 1);
-import { readdir as readdir5 } from "fs/promises";
+import { readdir as readdir6 } from "fs/promises";
 init_fs();
 init_integrity();
 async function execute6() {
@@ -9898,7 +9927,7 @@ async function execute6() {
   }
   let completedGenerations = 0;
   try {
-    const entries = await readdir5(paths.lineage);
+    const entries = await readdir6(paths.lineage);
     completedGenerations = entries.filter((e) => e.startsWith("gen-")).length;
   } catch {}
   const hasGenome = {
@@ -9963,7 +9992,7 @@ init_fs();
 var import_yaml6 = __toESM(require_dist(), 1);
 import { createHash as createHash2 } from "crypto";
 import { hostname } from "os";
-import { readdir as readdir6 } from "fs/promises";
+import { readdir as readdir7 } from "fs/promises";
 
 // src/core/nonce.ts
 import { createHash, randomBytes } from "crypto";
@@ -10042,7 +10071,7 @@ class GenerationManager {
   }
   async countLineage() {
     try {
-      const entries = await readdir6(this.paths.lineage);
+      const entries = await readdir7(this.paths.lineage);
       return entries.filter((e) => e.startsWith("gen-")).length;
     } catch {
       return 0;
@@ -10050,7 +10079,7 @@ class GenerationManager {
   }
   async lastGenerationIds() {
     try {
-      const entries = await readdir6(this.paths.lineage);
+      const entries = await readdir7(this.paths.lineage);
       const gens = entries.filter((e) => e.startsWith("gen-")).sort();
       if (gens.length === 0)
         return [];
@@ -10073,7 +10102,7 @@ init_fs();
 // src/core/hooks.ts
 init_fs();
 var import_yaml7 = __toESM(require_dist(), 1);
-import { readdir as readdir7 } from "fs/promises";
+import { readdir as readdir8 } from "fs/promises";
 import { join as join7 } from "path";
 import { execSync as execSync4 } from "child_process";
 async function executeHooks(hooksDir, event, projectRoot) {
@@ -10105,7 +10134,7 @@ async function executeHooks(hooksDir, event, projectRoot) {
 async function scanHooks(hooksDir, event) {
   let entries;
   try {
-    entries = await readdir7(hooksDir);
+    entries = await readdir8(hooksDir);
   } catch {
     return [];
   }
@@ -10214,12 +10243,12 @@ async function executeMdHook(hook, event, hooksDir) {
 
 // src/core/backlog.ts
 init_fs();
-import { readdir as readdir8 } from "fs/promises";
+import { readdir as readdir9 } from "fs/promises";
 import { join as join8 } from "path";
 async function scanBacklog(backlogDir) {
   let entries;
   try {
-    entries = await readdir8(backlogDir);
+    entries = await readdir9(backlogDir);
   } catch {
     return [];
   }
@@ -10422,7 +10451,7 @@ Then run: reap run start --phase create --goal "<goal>" [--backlog <filename>]`
 
 // src/cli/commands/run/learning.ts
 init_fs();
-import { readdir as readdir9 } from "fs/promises";
+import { readdir as readdir10 } from "fs/promises";
 import { join as join11 } from "path";
 
 // src/core/lifecycle.ts
@@ -10590,7 +10619,7 @@ async function performMergeTransition(state, gm, paths) {
 init_fs();
 import { join as join10, dirname as dirname4 } from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
-import { copyFile } from "fs/promises";
+import { copyFile as copyFile2 } from "fs/promises";
 var STAGE_ARTIFACTS2 = {
   learning: "01-learning.md",
   planning: "02-planning.md",
@@ -10620,7 +10649,7 @@ async function copyArtifactTemplate(stage, artifactPath, isMerge) {
   if (!await fileExists(templatePath))
     return;
   await ensureDir(dirname4(destPath));
-  await copyFile(templatePath, destPath);
+  await copyFile2(templatePath, destPath);
 }
 
 // src/cli/commands/run/learning.ts
@@ -10648,7 +10677,7 @@ async function execute8(paths, phase) {
     let prevCompletion = null;
     let prevFitness = null;
     try {
-      const lineageEntries = await readdir9(paths.lineage);
+      const lineageEntries = await readdir10(paths.lineage);
       const genDirs = lineageEntries.filter((e) => e.startsWith("gen-")).sort();
       if (genDirs.length > 0) {
         const lastGen = genDirs[genDirs.length - 1];
@@ -11065,12 +11094,12 @@ init_fs();
 init_fs();
 var import_yaml9 = __toESM(require_dist(), 1);
 import { join as join13 } from "path";
-import { readdir as readdir11, rm as rm4, unlink } from "fs/promises";
+import { readdir as readdir12, rm as rm4, unlink } from "fs/promises";
 
 // src/core/compression.ts
 init_fs();
 var import_yaml8 = __toESM(require_dist(), 1);
-import { readdir as readdir10, rm as rm3 } from "fs/promises";
+import { readdir as readdir11, rm as rm3 } from "fs/promises";
 import { join as join12 } from "path";
 var LEVEL1_THRESHOLD = 20;
 var PROTECTED_RECENT = 20;
@@ -11078,7 +11107,7 @@ var LEVEL2_THRESHOLD = 100;
 async function compressLineage(lineageDir) {
   let entries;
   try {
-    entries = await readdir10(lineageDir);
+    entries = await readdir11(lineageDir);
   } catch {
     return 0;
   }
@@ -11132,7 +11161,7 @@ async function compressLineage(lineageDir) {
 async function compressToEpoch(lineageDir) {
   let entries;
   try {
-    entries = await readdir10(lineageDir);
+    entries = await readdir11(lineageDir);
   } catch {
     return 0;
   }
@@ -11237,7 +11266,7 @@ async function archiveGeneration(paths, state, fitnessFeedback) {
   const goalSlug = state.goal.toLowerCase().replace(/[^a-z0-9가-힣]+/g, "-").slice(0, 40).replace(/-+$/, "");
   const archiveDir = join13(paths.lineage, `${state.id}-${goalSlug}`);
   await ensureDir(archiveDir);
-  const lifeEntries = await readdir11(paths.life);
+  const lifeEntries = await readdir12(paths.life);
   for (const entry of lifeEntries) {
     if (entry === "current.yml" || entry === "backlog")
       continue;
@@ -11986,7 +12015,7 @@ async function execute12(paths, phase, feedback) {
 
 // src/cli/commands/run/evolve.ts
 var import_yaml12 = __toESM(require_dist(), 1);
-import { readdir as readdir12 } from "fs/promises";
+import { readdir as readdir13 } from "fs/promises";
 init_fs();
 
 // src/core/prompt.ts
@@ -12245,7 +12274,7 @@ async function collectClarityInput(paths, generationType) {
   const highPriorityBacklog = pendingItems.filter((b) => b.priority === "high").length;
   let lineageCount = 0;
   try {
-    const entries = await readdir12(paths.lineage);
+    const entries = await readdir13(paths.lineage);
     lineageCount = entries.filter((e) => e.endsWith(".md")).length;
   } catch {}
   const [hasShortterm, hasMidterm, hasLongterm] = await Promise.all([
@@ -12392,7 +12421,7 @@ async function execute15(paths) {
 }
 
 // src/cli/commands/run/abort.ts
-import { readdir as readdir13, rm as rm5 } from "fs/promises";
+import { readdir as readdir14, rm as rm5 } from "fs/promises";
 import { join as join14 } from "path";
 init_fs();
 function parseExtra(extra) {
@@ -12464,7 +12493,7 @@ createdAt: ${new Date().toISOString()}
       savedBacklogFile = filename;
     }
     const revertedCount = await revertBacklogConsumed(paths.backlog, id);
-    const lifeEntries = await readdir13(paths.life);
+    const lifeEntries = await readdir14(paths.life);
     for (const entry of lifeEntries) {
       if (entry === "backlog")
         continue;
@@ -13339,32 +13368,114 @@ async function execute25(stage, options) {
   }
 }
 
-// src/cli/commands/make.ts
+// src/cli/commands/make/index.ts
 init_integrity();
+
+// src/cli/commands/make/backlog.ts
+async function makeBacklog(paths, options) {
+  if (!options.type || !options.title) {
+    emitError("make", 'Usage: reap make backlog --type <type> --title "<title>" [--body "<body>"] [--priority <priority>]');
+  }
+  const filename = await createBacklog(paths.backlog, {
+    type: options.type,
+    title: options.title,
+    body: options.body,
+    priority: options.priority
+  });
+  emitOutput({
+    status: "ok",
+    command: "make",
+    context: { resource: "backlog", filename },
+    message: `Backlog item created: ${filename}`,
+    prompt: `The backlog file has been created with template sections (Problem, Solution, Files to Change). You MUST now use the Edit tool to fill in these sections with concrete content. Do not leave <!-- --> placeholders.`
+  });
+}
+
+// src/cli/commands/make/hook.ts
+import { join as join15 } from "path";
+import { chmod as chmod2 } from "fs/promises";
+init_fs();
+var VALID_EVENTS = [
+  "onLifeStarted",
+  "onLifeLearned",
+  "onLifePlanned",
+  "onLifeImplemented",
+  "onLifeValidated",
+  "onLifeCompleted",
+  "onLifeTransited",
+  "onMergeStarted",
+  "onMergeDetected",
+  "onMergeMated",
+  "onMergeMerged",
+  "onMergeReconciled",
+  "onMergeValidated",
+  "onMergeCompleted",
+  "onMergeTransited"
+];
+async function makeHook(paths, options) {
+  const event = options.event;
+  const name = options.name;
+  const type = options.type ?? "md";
+  const condition = options.condition ?? "always";
+  const order = parseInt(options.order ?? "50", 10);
+  if (!event || !VALID_EVENTS.includes(event)) {
+    emitError("make", `Invalid or missing --event. Valid events:
+${VALID_EVENTS.join(`
+`)}`);
+  }
+  if (!name || !/^[a-zA-Z0-9_-]+$/.test(name)) {
+    emitError("make", "Invalid or missing --name. Use alphanumeric, dash, or underscore only.");
+  }
+  if (type !== "sh" && type !== "md") {
+    emitError("make", "Invalid --type. Use 'sh' or 'md'.");
+  }
+  const filename = `${event}.${name}.${type}`;
+  const filePath = join15(paths.hooks, filename);
+  await ensureDir(paths.hooks);
+  if (await fileExists(filePath)) {
+    emitError("make", `Hook already exists: ${filename}`);
+  }
+  const content = type === "sh" ? `#!/usr/bin/env bash
+# condition: ${condition}
+# order: ${order}
+
+# TODO: Add your hook logic here
+echo "${event}.${name} executed"
+` : `---
+condition: ${condition}
+order: ${order}
+---
+
+<!-- TODO: Add your hook prompt here -->
+<!-- This prompt will be executed by the AI agent when the ${event} event fires. -->
+`;
+  await writeTextFile(filePath, content);
+  if (type === "sh") {
+    await chmod2(filePath, 493);
+  }
+  const prompt = type === "sh" ? `Hook file created: ${filename}. You MUST now use the Edit tool to replace the TODO placeholder with the actual shell commands this hook should execute.` : `Hook file created: ${filename}. You MUST now use the Edit tool to replace the TODO placeholder with the actual AI prompt instructions this hook should execute when the ${event} event fires.`;
+  emitOutput({
+    status: "ok",
+    command: "make",
+    context: { resource: "hook", filename, event, name, type, condition, order },
+    message: `Hook created: ${filename}`,
+    prompt
+  });
+}
+
+// src/cli/commands/make/index.ts
+var RESOURCES = ["backlog", "hook"];
 async function execute26(resource, options) {
   const paths = createPaths(process.cwd());
   if (await detectV15(paths)) {
     emitError("make", "This project uses REAP v0.15 structure. Run '/reap.update' to upgrade to v0.16.");
   }
   if (resource === "backlog") {
-    if (!options.type || !options.title) {
-      emitError("make", 'Usage: reap make backlog --type <type> --title "<title>" [--body "<body>"] [--priority <priority>]');
-    }
-    const filename = await createBacklog(paths.backlog, {
-      type: options.type,
-      title: options.title,
-      body: options.body,
-      priority: options.priority
-    });
-    emitOutput({
-      status: "ok",
-      command: "make",
-      context: { resource: "backlog", filename },
-      message: `Backlog item created: ${filename}`,
-      prompt: `The backlog file has been created with template sections (Problem, Solution, Files to Change). You MUST now use the Edit tool to fill in these sections with concrete content. Do not leave <!-- --> placeholders.`
-    });
+    await makeBacklog(paths, options);
+  } else if (resource === "hook") {
+    await makeHook(paths, options);
   } else {
-    emitError("make", `Unknown resource '${resource}'. Available: backlog`);
+    emitError("make", `Unknown resource '${resource}'. Available: ${RESOURCES.join(", ")}`);
   }
 }
 
@@ -13390,30 +13501,30 @@ async function execute27(count) {
 
 // src/adapters/claude-code/install.ts
 init_fs();
-import { readdir as readdir14, cp as cp2, unlink as unlink2, readFile as readFile3, writeFile as writeFile3 } from "fs/promises";
-import { join as join15, dirname as dirname5 } from "path";
+import { readdir as readdir15, cp as cp2, unlink as unlink2, readFile as readFile3, writeFile as writeFile3 } from "fs/promises";
+import { join as join16, dirname as dirname5 } from "path";
 import { fileURLToPath as fileURLToPath4 } from "url";
 import { homedir as homedir3 } from "os";
 var __dirname2 = dirname5(fileURLToPath4(import.meta.url));
-var SKILLS_DIR = __dirname2.includes("dist") ? join15(__dirname2, "..", "adapters", "claude-code", "skills") : join15(__dirname2, "skills");
+var SKILLS_DIR = __dirname2.includes("dist") ? join16(__dirname2, "..", "adapters", "claude-code", "skills") : join16(__dirname2, "skills");
 var SKILL_PATTERN = /^reap\..+\.md$/;
 async function cleanupStaleSkills(targetDir) {
-  const files = await readdir14(targetDir);
+  const files = await readdir15(targetDir);
   const staleFiles = files.filter((f) => SKILL_PATTERN.test(f));
   for (const file of staleFiles) {
-    await unlink2(join15(targetDir, file));
+    await unlink2(join16(targetDir, file));
   }
   return staleFiles;
 }
 async function installSkills(_projectRoot) {
-  const targetDir = join15(homedir3(), ".claude", "commands");
+  const targetDir = join16(homedir3(), ".claude", "commands");
   await ensureDir(targetDir);
   const cleaned = await cleanupStaleSkills(targetDir);
-  const files = await readdir14(SKILLS_DIR);
+  const files = await readdir15(SKILLS_DIR);
   const mdFiles = files.filter((f) => f.endsWith(".md"));
   let installed = 0;
   for (const file of mdFiles) {
-    await cp2(join15(SKILLS_DIR, file), join15(targetDir, file));
+    await cp2(join16(SKILLS_DIR, file), join16(targetDir, file));
     installed++;
   }
   await installReapGuide();
@@ -13433,29 +13544,29 @@ async function installSkills(_projectRoot) {
   });
 }
 async function installAgents() {
-  const agentsDir = join15(homedir3(), ".claude", "agents");
+  const agentsDir = join16(homedir3(), ".claude", "agents");
   await ensureDir(agentsDir);
-  const templateDir = __dirname2.includes("dist") ? join15(__dirname2, "..", "templates", "agents") : join15(__dirname2, "..", "..", "templates", "agents");
+  const templateDir = __dirname2.includes("dist") ? join16(__dirname2, "..", "templates", "agents") : join16(__dirname2, "..", "..", "templates", "agents");
   try {
-    const files = await readdir14(templateDir);
+    const files = await readdir15(templateDir);
     for (const file of files) {
       if (file.endsWith(".md")) {
-        await cp2(join15(templateDir, file), join15(agentsDir, file));
+        await cp2(join16(templateDir, file), join16(agentsDir, file));
       }
     }
   } catch {}
 }
 async function installReapGuide() {
-  const reapHome = join15(homedir3(), ".reap");
+  const reapHome = join16(homedir3(), ".reap");
   await ensureDir(reapHome);
-  const templateDir = __dirname2.includes("dist") ? join15(__dirname2, "..", "templates") : join15(__dirname2, "..", "..", "templates");
-  const src = join15(templateDir, "reap-guide.md");
+  const templateDir = __dirname2.includes("dist") ? join16(__dirname2, "..", "templates") : join16(__dirname2, "..", "..", "templates");
+  const src = join16(templateDir, "reap-guide.md");
   if (await fileExists(src)) {
-    await cp2(src, join15(reapHome, "reap-guide.md"));
+    await cp2(src, join16(reapHome, "reap-guide.md"));
   }
 }
 async function registerCleanupHook() {
-  const settingsPath = join15(homedir3(), ".claude", "settings.json");
+  const settingsPath = join16(homedir3(), ".claude", "settings.json");
   const hookCommand = "reap check-version 2>/dev/null || true";
   try {
     let settings = {};
@@ -13493,7 +13604,7 @@ async function execute28() {
 // src/cli/commands/fix.ts
 var import_yaml16 = __toESM(require_dist(), 1);
 import { mkdir as mkdir3, stat as stat3 } from "fs/promises";
-import { join as join16, dirname as dirname6 } from "path";
+import { join as join17, dirname as dirname6 } from "path";
 import { fileURLToPath as fileURLToPath5 } from "url";
 import { homedir as homedir4 } from "os";
 init_fs();
@@ -13575,13 +13686,13 @@ async function fixProject(projectRoot) {
       issues.push(`genome/${gf.name} is missing. Run 'reap init --repair' to restore.`);
     }
   }
-  const guidePath = join16(homedir4(), ".reap", "reap-guide.md");
+  const guidePath = join17(homedir4(), ".reap", "reap-guide.md");
   if (!await fileExists(guidePath)) {
     const __dir = dirname6(fileURLToPath5(import.meta.url));
-    const srcGuide = await readTextFile(join16(__dir, "..", "templates", "reap-guide.md"));
+    const srcGuide = await readTextFile(join17(__dir, "..", "templates", "reap-guide.md"));
     if (srcGuide) {
       const { ensureDir: ensDir } = await Promise.resolve().then(() => (init_fs(), exports_fs));
-      await ensDir(join16(homedir4(), ".reap"));
+      await ensDir(join17(homedir4(), ".reap"));
       await writeTextFile(guidePath, srcGuide);
       fixed.push("Restored missing ~/.reap/reap-guide.md");
     } else {
@@ -13607,7 +13718,7 @@ async function fixProject(projectRoot) {
       fixed.push(`Created missing vision/memory/${mf.name}`);
     }
   }
-  const claudeMdPath = join16(paths.root, "CLAUDE.md");
+  const claudeMdPath = join17(paths.root, "CLAUDE.md");
   const claudeMd = await readTextFile(claudeMdPath);
   if (!claudeMd || !claudeMd.includes(".reap/genome/")) {
     const { ensureClaudeMd: ensureClaudeMd2 } = await Promise.resolve().then(() => (init_common(), exports_common));
@@ -13663,7 +13774,7 @@ async function execute29(check) {
 // src/cli/commands/destroy.ts
 var import_yaml17 = __toESM(require_dist(), 1);
 import { rm as rm6 } from "fs/promises";
-import { join as join17 } from "path";
+import { join as join18 } from "path";
 init_fs();
 init_integrity();
 async function getProjectName(projectRoot) {
@@ -13681,7 +13792,7 @@ async function getProjectName(projectRoot) {
 async function destroyProject(projectRoot) {
   const removed = [];
   const skipped = [];
-  const reapDir = join17(projectRoot, ".reap");
+  const reapDir = join18(projectRoot, ".reap");
   if (await fileExists(reapDir)) {
     await rm6(reapDir, { recursive: true, force: true });
     removed.push(".reap/");
@@ -13693,7 +13804,7 @@ async function destroyProject(projectRoot) {
   return { removed, skipped };
 }
 async function cleanClaudeMd(projectRoot, removed, skipped) {
-  const claudeMdPath = join17(projectRoot, "CLAUDE.md");
+  const claudeMdPath = join18(projectRoot, "CLAUDE.md");
   const content = await readTextFile(claudeMdPath);
   if (content === null) {
     skipped.push("CLAUDE.md (not found)");
@@ -13718,7 +13829,7 @@ async function cleanClaudeMd(projectRoot, removed, skipped) {
   }
 }
 async function cleanGitignore(projectRoot, removed, skipped) {
-  const gitignorePath = join17(projectRoot, ".gitignore");
+  const gitignorePath = join18(projectRoot, ".gitignore");
   const content = await readTextFile(gitignorePath);
   if (content === null) {
     skipped.push(".gitignore (not found)");
@@ -13782,8 +13893,8 @@ async function execute30(confirm) {
 }
 
 // src/cli/commands/clean.ts
-import { rm as rm7, readdir as readdir15, mkdir as mkdir4 } from "fs/promises";
-import { join as join18 } from "path";
+import { rm as rm7, readdir as readdir16, mkdir as mkdir4 } from "fs/promises";
+import { join as join19 } from "path";
 init_fs();
 init_integrity();
 async function cleanProject(projectRoot, options) {
@@ -13810,7 +13921,7 @@ async function cleanLineage(lineageDir, mode, actions) {
   }
   let entries;
   try {
-    entries = await readdir15(lineageDir);
+    entries = await readdir16(lineageDir);
   } catch {
     actions.push("Lineage: read failed (skip)");
     return;
@@ -13822,7 +13933,7 @@ async function cleanLineage(lineageDir, mode, actions) {
   }
   if (mode === "delete") {
     for (const entry of entries) {
-      await rm7(join18(lineageDir, entry), { recursive: true, force: true });
+      await rm7(join19(lineageDir, entry), { recursive: true, force: true });
     }
     actions.push(`Lineage: deleted ${entries.length} item(s)`);
   } else {
@@ -13838,9 +13949,9 @@ async function cleanLineage(lineageDir, mode, actions) {
     ].join(`
 `);
     for (const dir of genDirs) {
-      await rm7(join18(lineageDir, dir), { recursive: true, force: true });
+      await rm7(join19(lineageDir, dir), { recursive: true, force: true });
     }
-    await writeTextFile(join18(lineageDir, `${epochId}.md`), summary);
+    await writeTextFile(join19(lineageDir, `${epochId}.md`), summary);
     actions.push(`Lineage: compressed ${genDirs.length} generation(s) into ${epochId}`);
   }
 }
@@ -13851,7 +13962,7 @@ async function cleanLife(lifeDir, actions) {
   }
   let entries;
   try {
-    entries = await readdir15(lifeDir);
+    entries = await readdir16(lifeDir);
   } catch {
     actions.push("Life: read failed (skip)");
     return;
@@ -13860,7 +13971,7 @@ async function cleanLife(lifeDir, actions) {
   for (const entry of entries) {
     if (entry === "backlog")
       continue;
-    await rm7(join18(lifeDir, entry), { recursive: true, force: true });
+    await rm7(join19(lifeDir, entry), { recursive: true, force: true });
     removedCount++;
   }
   actions.push(`Life: cleaned ${removedCount} file(s)`);
@@ -13923,11 +14034,11 @@ init_integrity();
 var import_yaml18 = __toESM(require_dist(), 1);
 import { execSync as execSync6 } from "child_process";
 import { readFileSync as readFileSync2 } from "fs";
-import { join as join20 } from "path";
+import { join as join21 } from "path";
 
 // src/core/notice.ts
 import { readFileSync } from "fs";
-import { join as join19, dirname as dirname7 } from "path";
+import { join as join20, dirname as dirname7 } from "path";
 function findPackageRoot() {
   try {
     const pkgPath = __require.resolve("@c-d-cc/reap/package.json");
@@ -13948,7 +14059,7 @@ var LANG_MAP = {
 };
 function fetchReleaseNotice(version, language) {
   try {
-    const noticePath = join19(findPackageRoot(), "RELEASE_NOTICE.md");
+    const noticePath = join20(findPackageRoot(), "RELEASE_NOTICE.md");
     const content = readFileSync(noticePath, "utf-8");
     const versionTag = version.startsWith("v") ? version : `v${version}`;
     const versionPattern = new RegExp(`^## ${versionTag.replace(/\./g, "\\.")}\\s*$`, "m");
@@ -14100,7 +14211,7 @@ async function execute32() {
   const result = performAutoUpdate(root);
   if (result.action === "upgraded" && result.to) {
     try {
-      const configPath = join20(root, ".reap", "config.yml");
+      const configPath = join21(root, ".reap", "config.yml");
       const configContent = readFileSync2(configPath, "utf-8");
       const config = import_yaml18.default.parse(configContent);
       const language = config?.language ?? "english";
@@ -14149,7 +14260,7 @@ async function execute33() {
 // src/cli/commands/update.ts
 var import_yaml20 = __toESM(require_dist(), 1);
 import { readFileSync as readFileSync3 } from "fs";
-import { join as join21, dirname as dirname8 } from "path";
+import { join as join22, dirname as dirname8 } from "path";
 import { fileURLToPath as fileURLToPath6 } from "url";
 init_fs();
 init_integrity();
@@ -14157,7 +14268,7 @@ init_common();
 function getPackageVersion() {
   try {
     const __dir = dirname8(fileURLToPath6(import.meta.url));
-    for (const rel of [join21(__dir, "..", "..", "package.json"), join21(__dir, "..", "package.json")]) {
+    for (const rel of [join22(__dir, "..", "..", "package.json"), join22(__dir, "..", "package.json")]) {
       try {
         return JSON.parse(readFileSync3(rel, "utf-8")).version;
       } catch {}
@@ -14185,7 +14296,7 @@ function getRequiredDirs(paths) {
     paths.backlog,
     paths.lineage,
     paths.vision,
-    paths.visionDocs,
+    paths.visionDesign,
     paths.memory,
     paths.hooks
   ];
@@ -14305,7 +14416,7 @@ async function execute34(phase, postUpgrade) {
 }
 
 // src/cli/commands/help.ts
-import { join as join22 } from "path";
+import { join as join23 } from "path";
 init_fs();
 var SUPPORTED_LANGUAGES = ["en", "ko", "ja", "zh-CN"];
 var LANGUAGE_ALIASES = {
@@ -14477,7 +14588,7 @@ async function execute35(topic) {
   const stateDisplay = buildStateDisplay(state, lang);
   const lines = buildHelpLines(lang, stateDisplay);
   if (topic) {
-    const reapGuidePath = join22(paths.reap, "reap-guide.md");
+    const reapGuidePath = join23(paths.reap, "reap-guide.md");
     const reapGuide = await readTextFile(reapGuidePath) ?? "";
     emitOutput({
       status: "prompt",
@@ -14523,14 +14634,14 @@ async function execute35(topic) {
 function readVersion() {
   const __dir = dirname9(fileURLToPath7(import.meta.url));
   let version = "0.0.0";
-  for (const rel of [join23(__dir, "..", "..", "package.json"), join23(__dir, "..", "package.json")]) {
+  for (const rel of [join24(__dir, "..", "..", "package.json"), join24(__dir, "..", "package.json")]) {
     try {
       version = JSON.parse(readFileSync4(rel, "utf-8")).version;
       break;
     } catch {}
   }
   try {
-    const hash = readFileSync4(join23(__dir, "..", ".dev-build"), "utf-8").trim();
+    const hash = readFileSync4(join24(__dir, "..", ".dev-build"), "utf-8").trim();
     if (hash)
       version += `+dev.${hash}`;
   } catch {}
@@ -14547,7 +14658,7 @@ program2.command("status").description("Show current project status").action(asy
 program2.command("run <stage>").description("Run a lifecycle stage (start, learning, planning, ...)").option("--phase <phase>", "Stage phase (work, complete, reflect, fitness, adapt, commit)").option("--goal <goal>", "Goal for start command").option("--type <type>", "Generation type (embryo, normal, merge)").option("--parents <parents>", "Parent generation IDs for merge (comma-separated)").option("--feedback <feedback>", "Fitness feedback text").option("--reason <reason>", "Reason for back regression or abort").option("--backlog <backlog>", "Backlog filename to consume for this generation").option("--source-action <sourceAction>", "Source action for abort (rollback, stash, hold, none)").option("--save-backlog", "Save progress to backlog on abort").action(async (stage, options) => {
   await execute25(stage, options);
 });
-program2.command("make <resource>").description("Create a resource from template (backlog)").option("--type <type>", "Backlog type (genome-change, environment-change, task)").option("--title <title>", "Resource title").option("--body <body>", "Optional description body").option("--priority <priority>", "Priority (high, medium, low)").action(async (resource, options) => {
+program2.command("make <resource>").description("Create a resource from template (backlog, hook)").option("--type <type>", "Resource type (backlog: genome-change/environment-change/task, hook: sh/md)").option("--title <title>", "Resource title").option("--body <body>", "Optional description body").option("--priority <priority>", "Priority (high, medium, low)").option("--event <event>", "Hook event (e.g. onLifeCompleted)").option("--name <name>", "Hook name").option("--condition <condition>", "Hook condition (default: always)").option("--order <order>", "Hook execution order (default: 50)").action(async (resource, options) => {
   await execute26(resource, options);
 });
 program2.command("cruise <count>").description("Enable cruise mode for N generations").action(async (count) => {

package/dist/templates/evolution.md

@@ -84,11 +84,20 @@ Decision rule: "If a new agent in the next session doesn't know about this chang
 
 ## Vision
 
-Vision consists of Goals and Memory.
+Vision consists of Goals, Memory, and Design.
 
 ### Goals (`vision/goals.md`)
 Long-term project objectives. During the adapt phase, gap analysis against goals determines the next generation's direction.
 
+Goals cleanup: goals.md is a space for **future** objectives, not an archive of past achievements. When completed items (`[x]`) accumulate and the document loses focus as a forward-looking plan, propose specific items for removal to the human for approval. This is a contextual judgment — recently completed items may still have reference value, while long-stable items can be cleared. Always get human confirmation before removing.
+
+### Design (`vision/design/`)
+Space for project design documents. Distinction from Memory:
+- **Design** — Documents with a specific scope (architecture designs, feature specs, etc.). Managed as independent documents.
+- **Memory** — General-purpose context records (lessons, progress, handoff). Single file per tier.
+
+Decision rule: "Is this content worth documenting as an independent topic?" → Yes = Design, No = Memory.
+
 ### Memory (`vision/memory/`)
 Free-form space for the AI to record project-related knowledge. 3-tier structure:
 - **longterm.md** — Project lifetime. Recurring lessons, decision backgrounds, architecture rationale

package/dist/templates/hooks/conditions/always.sh

@@ -0,0 +1,3 @@
+#!/usr/bin/env bash
+# Always true — hook always executes
+exit 0

package/dist/templates/hooks/conditions/has-code-changes.sh

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+# True if src/ files were changed in the most recent commit
+# Exit 0 = condition met, Exit 1 = condition not met
+last_commit=$(git log -1 --format="%H" 2>/dev/null)
+if [ -z "$last_commit" ]; then
+  exit 1
+fi
+changes=$(git diff-tree --no-commit-id --name-only -r "$last_commit" -- src/ 2>/dev/null)
+if [ -n "$changes" ]; then
+  exit 0
+else
+  exit 1
+fi

package/dist/templates/hooks/conditions/version-bumped.sh

@@ -0,0 +1,17 @@
+#!/usr/bin/env bash
+# True if package.json version differs from the last git tag
+# Exit 0 = version was bumped, Exit 1 = same version
+last_tag=$(git describe --tags --abbrev=0 2>/dev/null)
+if [ -z "$last_tag" ]; then
+  exit 1
+fi
+tag_version="${last_tag#v}"
+pkg_version=$(node -e "console.log(require('./package.json').version)" 2>/dev/null)
+if [ -z "$pkg_version" ]; then
+  exit 1
+fi
+if [ "$tag_version" != "$pkg_version" ]; then
+  exit 0
+else
+  exit 1
+fi

package/dist/templates/hooks/onCompleted.example-notify.sh.example

@@ -0,0 +1,11 @@
+#!/usr/bin/env bash
+# condition: always
+# order: 90
+#
+# Example: Send a notification when a generation completes.
+# Rename this file to remove .example suffix to activate.
+#
+# onCompleted.notify.sh
+
+echo "Generation completed at $(date)"
+# osascript -e 'display notification "Generation done" with title "REAP"'

package/dist/templates/hooks/onCompleted.example-review.md.example

@@ -0,0 +1,17 @@
+---
+condition: has-code-changes
+order: 50
+---
+
+<!--
+Example: AI-driven code review after generation completes.
+Rename this file to remove .example suffix to activate.
+
+Filename: onCompleted.review.md
+-->
+
+Review the changes made in this generation:
+
+1. Check for any code quality issues
+2. Verify test coverage for new code
+3. Report findings to the user

package/dist/templates/reap-guide.md

@@ -212,6 +212,17 @@ Merge: `onMergeStarted`, `onMergeDetected`, `onMergeMated`, `onMergeMerged`, `on
 
 Conditions are executable scripts in `.reap/hooks/conditions/`. Exit code 0 = condition met, non-zero = skip. If no condition is specified, the hook always runs (default: `always`).
 
+Default conditions (installed by `reap init`):
+- `always` — Always true
+- `has-code-changes` — True if the last commit changed `src/`
+- `version-bumped` — True if `package.json` version differs from the last git tag
+
+### Creating Hooks
+
+**Always use the CLI to create hooks**: `reap make hook --event <event> --name <name> [--type md|sh] [--condition <condition>] [--order <order>]`. Never create hook files directly — the CLI ensures correct filename convention and frontmatter format.
+
+After creating a hook, fill in the TODO placeholder with your hook logic (for `.sh`) or prompt (for `.md`).
+
 ## Slash Commands
 
 All REAP interactions go through `/reap.*` slash commands. These are the primary interface for both users and AI agents.
@@ -241,6 +252,7 @@ All REAP interactions go through `/reap.*` slash commands. These are the primary
 
 ## CLI Commands (no slash command equivalent)
 - `reap make backlog --type <type> --title <title> [--body <body>] [--priority <priority>]` — Create backlog item (type: genome-change, environment-change, task)
+- `reap make hook --event <event> --name <name> [--type md|sh] [--condition <condition>] [--order <order>]` — Create hook file with correct naming and frontmatter
 - `reap cruise <count>` — Set cruise mode (pre-approve N generations for autonomous execution)
 - `reap update` — Update project structure to match current REAP version (v0.15 migrate, v0.16 sync)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c-d-cc/reap",
-  "version": "0.16.1",
+  "version": "0.16.3",
   "description": "Recursive Evolutionary Autonomous Pipeline — AI and humans evolve software across generations",
   "type": "module",
   "bin": {