@c-d-cc/reap 0.13.3 → 0.14.0

package/README.ja.md

@@ -324,6 +324,7 @@ autoIssueReport: true    # デフォルト: true（gh CLIがある場合）
 | `/reap.merge.sync` | Genome-ソース間の整合性を検証（AI比較、ユーザー確認） |
 | `/reap.merge.validation` | 機械的テストを実行（bun test、tsc、build） |
 | **`/reap.merge.evolve`** | **マージライフサイクル全体を自動実行** |
+| `/reap.refreshKnowledge` | サブエージェント用REAPコンテキストのロード（Genome、Environment、状態） |
 
 ### SessionStart Hook [↗](https://reap.cc/docs/hooks)
 

package/README.ko.md

@@ -324,6 +324,7 @@ Slash command가 `.claude/commands/`에 설치되어 전체 워크플로우를
 | `/reap.merge.sync` | Genome-소스 간 일관성 검증 (AI 비교, 사용자 확인) |
 | `/reap.merge.validation` | 기계적 테스트 실행 (bun test, tsc, build) |
 | **`/reap.merge.evolve`** | **전체 머지 라이프사이클 자동 실행** |
+| `/reap.refreshKnowledge` | 서브에이전트용 REAP 컨텍스트 로드 (Genome, Environment, 상태) |
 
 ### SessionStart Hook [↗](https://reap.cc/docs/hooks)
 

package/README.md

@@ -323,6 +323,7 @@ Slash commands are installed in `.claude/commands/` and drive the entire workflo
 | `/reap.merge.sync` | Verify genome–source consistency (AI compares, user confirms) |
 | `/reap.merge.validation` | Run mechanical testing (bun test, tsc, build) |
 | **`/reap.merge.evolve`** | **Run the full merge lifecycle automatically** |
+| `/reap.refreshKnowledge` | Load REAP context for subagents (Genome, Environment, state) |
 
 ### SessionStart Hook [↗](https://reap.cc/docs/hooks)
 

package/README.zh-CN.md

@@ -324,6 +324,7 @@ autoIssueReport: true    # 默认值: true（检测到gh CLI时）
 | `/reap.merge.sync` | 验证Genome与源代码的一致性（AI比较，用户确认） |
 | `/reap.merge.validation` | 运行机械化测试（bun test、tsc、build） |
 | **`/reap.merge.evolve`** | **自动运行完整的合并生命周期** |
+| `/reap.refreshKnowledge` | 为子代理加载REAP上下文（Genome、Environment、状态） |
 
 ### SessionStart Hook [↗](https://reap.cc/docs/hooks)
 

package/dist/cli.js

@@ -10814,6 +10814,77 @@ __export(exports_completion, {
   execute: () => execute4
 });
 import { join as join16 } from "path";
+import { execSync as execSync6 } from "child_process";
+function detectGenomeImpact(projectRoot) {
+  const impact = {
+    newCommands: [],
+    packageJsonChanged: false,
+    coreChanges: []
+  };
+  let changedFiles;
+  try {
+    const output = execSync6("git diff --name-only HEAD~1", {
+      cwd: projectRoot,
+      encoding: "utf-8",
+      timeout: 5000
+    });
+    changedFiles = output.trim().split(`
+`).filter(Boolean);
+  } catch {
+    return impact;
+  }
+  for (const file of changedFiles) {
+    if (file.startsWith("src/cli/commands/") && file.endsWith(".ts")) {
+      impact.newCommands.push(file);
+    }
+    if (file === "package.json") {
+      impact.packageJsonChanged = true;
+    }
+    if (file.startsWith("src/core/") && file.endsWith(".ts")) {
+      impact.coreChanges.push(file);
+    }
+  }
+  return impact;
+}
+function buildGenomeImpactPrompt(impact) {
+  const lines = [];
+  if (impact.newCommands.length > 0) {
+    lines.push(`- **Commands changed/added** (${impact.newCommands.length}): constraints.md의 Slash Commands 목록 업데이트 필요 여부 확인`);
+  }
+  if (impact.packageJsonChanged) {
+    lines.push("- **package.json changed**: constraints.md의 Tech Stack 및 environment.md 업데이트 필요 여부 확인");
+  }
+  if (impact.coreChanges.length > 0) {
+    lines.push(`- **Core modules changed** (${impact.coreChanges.length}): principles.md 및 source-map.md 업데이트 필요 여부 확인`);
+  }
+  if (lines.length === 0)
+    return "";
+  return [
+    "",
+    "",
+    "## Genome/Environment Impact Detection",
+    "다음 변경이 감지되었습니다. genome-change 또는 environment-change backlog 작성이 필요한지 검토하라:",
+    "",
+    ...lines
+  ].join(`
+`);
+}
+function buildMdHookPrompt(hookResults) {
+  const mdHooks = hookResults.filter((h) => h.type === "md" && h.status === "executed" && h.content);
+  if (mdHooks.length === 0)
+    return "";
+  const sections = mdHooks.map((h) => `### ${h.name}
+${h.content}`);
+  return [
+    "",
+    "",
+    "## Hook Prompts",
+    "다음 hook prompt를 순서대로 실행하라:",
+    "",
+    ...sections
+  ].join(`
+`);
+}
 async function execute4(paths, phase) {
   const gm = new GenerationManager(paths);
   const state = await gm.current();
@@ -10856,11 +10927,11 @@ async function execute4(paths, phase) {
         validationSummary: validationContent?.slice(0, 2000),
         implSummary: implContent?.slice(0, 2000)
       },
-      prompt: "Fill 05-completion.md: Summary (goal, period, result, key changes), Lessons Learned (max 5), Genome Change Proposals, Garbage Collection (check conventions violations), Backlog Cleanup (add deferred tasks). Then run: reap run completion --phase genome",
-      nextCommand: "reap run completion --phase genome"
+      prompt: "Fill 05-completion.md: Summary (goal, period, result, key changes), Lessons Learned (max 5), Genome Change Proposals, Garbage Collection (check conventions violations), Backlog Cleanup (add deferred tasks). Then run: reap run completion --phase feedKnowledge",
+      nextCommand: "reap run completion --phase feedKnowledge"
     });
   }
-  if (phase === "genome") {
+  if (phase === "feedKnowledge") {
     const backlogItems = await scanBacklog(paths.backlog);
     const genomeChanges = backlogItems.filter((b) => b.type === "genome-change" && b.status !== "consumed");
     const envChanges = backlogItems.filter((b) => b.type === "environment-change" && b.status !== "consumed");
@@ -10868,6 +10939,8 @@ async function execute4(paths, phase) {
     for (const item of toConsume) {
       await markBacklogConsumed(paths.backlog, item.filename, state.id);
     }
+    const genomeImpact = detectGenomeImpact(paths.projectRoot);
+    const impactPrompt = buildGenomeImpactPrompt(genomeImpact);
     const hookResults = await executeHooks(paths.hooks, "onLifeCompleted", paths.projectRoot);
     const submodules = checkSubmodules(paths.projectRoot);
     const dirtySubmodules = submodules.filter((s) => s.dirty);
@@ -10897,9 +10970,10 @@ async function execute4(paths, phase) {
         consumedCount: toConsume.length,
         compression: { level1: compression.level1.length, level2: compression.level2.length },
         hookResults,
-        dirtySubmodules
+        dirtySubmodules,
+        genomeImpact
       },
-      prompt: dirtySubmodules.length > 0 ? `Dirty submodules detected: ${dirtySubmodules.map((s) => s.path).join(", ")}. Commit and push inside each submodule first, then commit the parent repo. Commit message: feat/fix/chore(${state.id}): [goal summary]. Generation complete.` : `Commit all changes (code + .reap/ artifacts). Commit message: feat/fix/chore(${state.id}): [goal summary]. Generation complete.`,
+      prompt: (dirtySubmodules.length > 0 ? `Dirty submodules detected: ${dirtySubmodules.map((s) => s.path).join(", ")}. Commit and push inside each submodule first, then commit the parent repo. Commit message: feat/fix/chore(${state.id}): [goal summary]. Generation complete.` : `Commit all changes (code + .reap/ artifacts). Commit message: feat/fix/chore(${state.id}): [goal summary]. Generation complete.`) + impactPrompt + buildMdHookPrompt(hookResults),
       message: `Generation ${state.id} archived. ${hasChanges ? "Genome/env changes applied." : "No genome/environment changes."} ${toConsume.length} backlog item(s) consumed.`
     });
   }
@@ -10936,7 +11010,7 @@ async function execute4(paths, phase) {
         hookResults,
         dirtySubmodules
       },
-      prompt: dirtySubmodules.length > 0 ? `Dirty submodules detected: ${dirtySubmodules.map((s) => s.path).join(", ")}. Commit and push inside each submodule first, then commit the parent repo. Commit message: feat/fix/chore(${state.id}): [goal summary]. Generation complete.` : `Commit all changes (code + .reap/ artifacts). Commit message: feat/fix/chore(${state.id}): [goal summary]. Generation complete.`,
+      prompt: (dirtySubmodules.length > 0 ? `Dirty submodules detected: ${dirtySubmodules.map((s) => s.path).join(", ")}. Commit and push inside each submodule first, then commit the parent repo. Commit message: feat/fix/chore(${state.id}): [goal summary]. Generation complete.` : `Commit all changes (code + .reap/ artifacts). Commit message: feat/fix/chore(${state.id}): [goal summary]. Generation complete.`) + buildMdHookPrompt(hookResults),
       message: `Generation ${state.id} archived.`
     });
   }
@@ -11627,6 +11701,10 @@ function buildSubagentPrompt(paths, state, genomeSummaries, backlogSummary) {
   const lines = [];
   lines.push("# REAP Subagent Instructions");
   lines.push("");
+  lines.push("## FIRST: Load REAP Context");
+  lines.push("Before doing anything else, run `reap run refreshKnowledge` to load full REAP context (Genome, Environment, Generation state, Workflow Guide).");
+  lines.push("Incorporate the returned context into your working knowledge before proceeding.");
+  lines.push("");
   lines.push("## Rules");
   lines.push("- ALWAYS use `reap run <cmd>` commands to drive lifecycle. NEVER modify `current.yml` directly.");
   lines.push("- Use `/reap.next` to advance stages and `/reap.back` to regress.");
@@ -11676,7 +11754,7 @@ function buildSubagentPrompt(paths, state, genomeSummaries, backlogSummary) {
   lines.push("3. Write the required artifact BEFORE completing the stage.");
   lines.push("4. Run the stage complete phase if applicable (e.g., `reap run <stage> --phase complete`).");
   lines.push("5. If current stage is NOT `completion`: run `/reap.next` to advance, then go to step 1.");
-  lines.push("6. If current stage IS `completion`: `/reap.completion` auto-archives after genome phase. Done.");
+  lines.push("6. If current stage IS `completion`: `/reap.completion` auto-archives after feedKnowledge phase. Done.");
   lines.push("");
   lines.push("Note: `/reap.next` is a transition command, NOT a lifecycle stage.");
   lines.push("");
@@ -11693,6 +11771,16 @@ function buildSubagentPrompt(paths, state, genomeSummaries, backlogSummary) {
   lines.push("- Create a git commit after implementation and after completion.");
   lines.push("- Use conventional commit format: `feat|fix|chore(scope): description`");
   lines.push("- Include the generation ID in the commit message.");
+  lines.push("");
+  lines.push("## Hook Prompt Execution");
+  lines.push("- completion output의 `prompt` 필드에 '## Hook Prompts' 섹션이 포함되어 있으면, 해당 hook prompt를 반드시 순서대로 실행하라.");
+  lines.push("- Hook prompt는 `.md` hook 파일의 내용으로, AI가 따라야 할 지시사항이다.");
+  lines.push("- Hook prompt에 유저 확인이 필요한 경우(예: 프리뷰+컨펌), autonomous mode에서도 이를 존중하라.");
+  lines.push("");
+  lines.push("## Interrupt Protection");
+  lines.push('- 사용자의 새 메시지가 중간에 들어와도, 명시적 kill/중단 요청("중단", "stop", "abort")이 아닌 한 현재 작업을 끝까지 완료하라.');
+  lines.push("- 작업을 shortcut으로 건너뛰거나 결과를 추정하지 마라. 모든 validation은 실제 실행 결과를 확인하라.");
+  lines.push("- E2E 테스트 등 외부 실행이 포함된 작업은 반드시 실제 실행하고 결과를 확인하라.");
   return lines.join(`
 `);
 }
@@ -12094,9 +12182,9 @@ async function execute15(paths) {
   const gm = new GenerationManager(paths);
   const state = await gm.current();
   const configContent = await readTextFile(paths.config);
-  const configVersion = configContent?.match(/version:\s*([\d.]+)/)?.[1] ?? "0.0.0";
+  const installedVersion = "0.14.0";
   const autoUpdate = configContent?.match(/autoUpdate:\s*(true|false)/)?.[1] === "true";
-  const versionDisplay = formatVersionLine(configVersion, !autoUpdate);
+  const versionDisplay = formatVersionLine(installedVersion, !autoUpdate);
   const rawLang = detectLanguage(configContent);
   const supported = isSupportedLanguage(rawLang);
   const lang = supported ? rawLang : "en";
@@ -13596,12 +13684,177 @@ var init_config2 = __esm(() => {
   init_config();
 });
 
+// src/cli/commands/run/refresh-knowledge.ts
+var exports_refresh_knowledge = {};
+__export(exports_refresh_knowledge, {
+  execute: () => execute28
+});
+import { join as join26 } from "path";
+import { readdir as readdir18 } from "fs/promises";
+async function loadGenome(genomeDir) {
+  let content = "";
+  let l1Lines = 0;
+  let smLimit = null;
+  const smContent = await readTextFile(join26(genomeDir, "source-map.md"));
+  if (smContent) {
+    const limitMatch = smContent.match(/줄 수 한도:\s*~?(\d+)줄/);
+    if (limitMatch)
+      smLimit = parseInt(limitMatch[1], 10);
+  }
+  for (const file of L1_FILES) {
+    const fileContent = await readTextFile(join26(genomeDir, file));
+    if (!fileContent)
+      continue;
+    const lines = fileContent.split(`
+`).length;
+    const limit = file === "source-map.md" && smLimit ? smLimit : L1_LIMIT;
+    l1Lines += lines;
+    if (l1Lines <= limit) {
+      content += `
+### ${file}
+${fileContent}
+`;
+    } else {
+      content += `
+### ${file} [TRUNCATED — L1 budget exceeded]
+${fileContent.split(`
+`).slice(0, 20).join(`
+`)}
+...
+`;
+    }
+  }
+  const domainDir = join26(genomeDir, "domain");
+  if (await fileExists(domainDir)) {
+    let l2Lines = 0;
+    let l2Overflow = false;
+    try {
+      const domainFiles = (await readdir18(domainDir)).filter((f) => f.endsWith(".md")).sort();
+      for (const file of domainFiles) {
+        const fileContent = await readTextFile(join26(domainDir, file));
+        if (!fileContent)
+          continue;
+        const lines = fileContent.split(`
+`).length;
+        l2Lines += lines;
+        if (!l2Overflow && l2Lines <= L2_LIMIT) {
+          content += `
+### domain/${file}
+${fileContent}
+`;
+        } else {
+          l2Overflow = true;
+          const firstLine = fileContent.split(`
+`).find((l) => l.startsWith(">")) || fileContent.split(`
+`)[0];
+          content += `
+### domain/${file} [summary]
+${firstLine}
+`;
+        }
+      }
+    } catch {}
+  }
+  return { content, l1Lines };
+}
+function buildStrictSection(strict, genStage) {
+  let sections = "";
+  if (strict.edit) {
+    if (genStage === "implementation") {
+      sections += `
+
+## Strict Mode — Edit (ACTIVE — SCOPED MODIFICATION ALLOWED)`;
+    } else if (genStage === "none") {
+      sections += `
+
+## Strict Mode — Edit (ACTIVE — CODE MODIFICATION BLOCKED)`;
+    } else {
+      sections += `
+
+## Strict Mode — Edit (ACTIVE — stage '${genStage}', CODE MODIFICATION BLOCKED)`;
+    }
+  }
+  if (strict.merge) {
+    sections += `
+
+## Strict Mode — Merge (ACTIVE)`;
+  }
+  return sections;
+}
+async function execute28(paths) {
+  const guidePath = join26(ReapPaths.packageHooksDir, "reap-guide.md");
+  const reapGuide = await readTextFile(guidePath) || "";
+  const { content: genomeContent } = await loadGenome(paths.genome);
+  const envSummary = await readTextFile(paths.environmentSummary) || "";
+  const gm = new GenerationManager(paths);
+  const state = await gm.current();
+  let generationContext;
+  let genStage;
+  if (state && state.id) {
+    genStage = state.stage;
+    generationContext = `Active Generation: ${state.id} | Goal: ${state.goal} | Stage: ${state.stage}`;
+  } else {
+    genStage = "none";
+    generationContext = "No active Generation.";
+  }
+  let strict = { edit: false, merge: false };
+  try {
+    const config = await ConfigManager.read(paths);
+    strict = ConfigManager.resolveStrict(config.strict);
+  } catch {}
+  const strictSection = buildStrictSection(strict, genStage);
+  const envSection = envSummary ? `
+
+---
+
+## Environment (External Context)
+${envSummary}` : "";
+  const reapContext = [
+    "<REAP_CONTEXT>",
+    reapGuide,
+    "",
+    "---",
+    "",
+    "## Genome (Project Knowledge)",
+    genomeContent,
+    envSection,
+    "",
+    "---",
+    "",
+    "## Current State",
+    generationContext,
+    strictSection,
+    "</REAP_CONTEXT>"
+  ].join(`
+`);
+  emitOutput({
+    status: "ok",
+    command: "refreshKnowledge",
+    phase: "done",
+    completed: ["load-guide", "load-genome", "load-environment", "load-state"],
+    context: {
+      hasGeneration: !!state?.id,
+      generationId: state?.id || null,
+      stage: genStage
+    },
+    prompt: reapContext
+  });
+}
+var L1_LIMIT = 500, L2_LIMIT = 200, L1_FILES;
+var init_refresh_knowledge = __esm(() => {
+  init_paths();
+  init_fs();
+  init_config();
+  init_generation();
+  L1_FILES = ["principles.md", "conventions.md", "constraints.md", "source-map.md"];
+});
+
 // src/cli/commands/run/index.ts
 var exports_run = {};
 __export(exports_run, {
   runCommand: () => runCommand
 });
-import { execSync as execSync6 } from "child_process";
+import { execSync as execSync7 } from "child_process";
 async function runCommand(command, phase, argv = []) {
   const cwd = process.cwd();
   const paths = new ReapPaths(cwd);
@@ -13619,7 +13872,7 @@ async function runCommand(command, phase, argv = []) {
     try {
       const config = await ConfigManager.read(paths);
       if (config.autoIssueReport) {
-        const version = "0.13.3";
+        const version = "0.14.0";
         const errMsg = err instanceof Error ? err.message : String(err);
         const title = `[auto] reap run ${command}: ${errMsg.slice(0, 80)}`;
         const body = [
@@ -13629,7 +13882,7 @@ async function runCommand(command, phase, argv = []) {
           `**OS**: ${process.platform} ${process.arch}`,
           `**Node**: ${process.version}`
         ].join("\\n");
-        execSync6(`gh issue create --repo c-d-cc/reap --title "${title}" --label "auto-reported,bug" --body "${body}"`, { stdio: "ignore", timeout: 1e4 });
+        execSync7(`gh issue create --repo c-d-cc/reap --title "${title}" --label "auto-reported,bug" --body "${body}"`, { stdio: "ignore", timeout: 1e4 });
       }
     } catch {}
     emitError(command, err instanceof Error ? err.message : String(err));
@@ -13666,7 +13919,8 @@ var init_run = __esm(() => {
     "merge-evolve": () => Promise.resolve().then(() => (init_merge_evolve(), exports_merge_evolve)),
     merge: () => Promise.resolve().then(() => (init_merge2(), exports_merge)),
     pull: () => Promise.resolve().then(() => (init_pull(), exports_pull)),
-    config: () => Promise.resolve().then(() => (init_config2(), exports_config))
+    config: () => Promise.resolve().then(() => (init_config2(), exports_config)),
+    refreshKnowledge: () => Promise.resolve().then(() => (init_refresh_knowledge(), exports_refresh_knowledge))
   };
 });
 
@@ -14169,7 +14423,8 @@ var COMMAND_NAMES = [
   "reap.merge",
   "reap.pull",
   "reap.push",
-  "reap.config"
+  "reap.config",
+  "reap.refreshKnowledge"
 ];
 async function initProject(projectRoot, projectName, entryMode, preset, onProgress) {
   const log = onProgress ?? (() => {});
@@ -14205,7 +14460,7 @@ async function initProject(projectRoot, projectName, entryMode, preset, onProgre
   }
   const detectedLanguage = await AgentRegistry.readLanguage();
   const config = {
-    version: "0.13.3",
+    version: "0.14.0",
     project: projectName,
     entryMode,
     strict: false,
@@ -14278,6 +14533,11 @@ async function initProject(projectRoot, projectName, entryMode, preset, onProgre
   if (detectedAgents.length === 0) {
     log("  No AI agents detected.");
   }
+  const autoSynced = (entryMode === "adoption" || entryMode === "migration") && !preset;
+  if (!autoSynced) {
+    log(`
+\uD83D\uDCA1 Run /reap.sync to synchronize Genome with your project's actual state.`);
+  }
   return { agents: detectedAgents.map((a) => a.displayName) };
 }
 
@@ -14774,37 +15034,47 @@ async function updateProject(projectRoot, dryRun = false) {
         result.updated.push(`Config: added ${backfillResult.added.join(", ")}`);
       }
     }
-    const projectClaudeCommands = join10(paths.projectRoot, ".claude", "commands");
-    await mkdir6(projectClaudeCommands, { recursive: true });
+    const projectClaudeSkills = join10(paths.projectRoot, ".claude", "skills");
     const reapCmdFiles = (await readdir9(ReapPaths.userReapCommands)).filter((f) => f.startsWith("reap.") && f.endsWith(".md"));
     let cmdInstalled = 0;
     for (const file of reapCmdFiles) {
       const src = await readTextFileOrThrow(join10(ReapPaths.userReapCommands, file));
-      const destPath = join10(projectClaudeCommands, file);
-      try {
-        const s = await import("fs/promises").then((m) => m.lstat(destPath));
-        if (s.isSymbolicLink()) {
-          if (!dryRun)
-            await unlink4(destPath);
-        } else {
-          const existing = await readTextFile(destPath);
-          if (existing !== null && existing === src)
-            continue;
-          if (!dryRun)
-            await unlink4(destPath);
-        }
-      } catch {}
-      if (!dryRun)
-        await writeTextFile(destPath, src);
+      const name = file.replace(/\.md$/, "");
+      const skillDir = join10(projectClaudeSkills, name);
+      const skillFile = join10(skillDir, "SKILL.md");
+      const fmMatch = src.match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/);
+      const description = fmMatch ? fmMatch[1].match(/^description:\s*"?([^"\n]*)"?/m)?.[1]?.trim() ?? "" : "";
+      const body = fmMatch ? fmMatch[2] : src;
+      const skillContent = `---
+name: ${name}
+description: "${description}"
+---
+${body}`;
+      const existing = await readTextFile(skillFile);
+      if (existing !== null && existing === skillContent)
+        continue;
+      if (!dryRun) {
+        await mkdir6(skillDir, { recursive: true });
+        await writeTextFile(skillFile, skillContent);
+      }
       cmdInstalled++;
     }
     if (cmdInstalled > 0) {
-      result.updated.push(`.claude/commands/ (${cmdInstalled} synced)`);
+      result.updated.push(`.claude/skills/ (${cmdInstalled} synced)`);
     } else {
-      result.skipped.push(`.claude/commands/ (${reapCmdFiles.length} unchanged)`);
+      result.skipped.push(`.claude/skills/ (${reapCmdFiles.length} unchanged)`);
     }
+    const projectClaudeCommands = join10(paths.projectRoot, ".claude", "commands");
+    try {
+      const legacyFiles = (await readdir9(projectClaudeCommands)).filter((f) => f.startsWith("reap.") && f.endsWith(".md"));
+      for (const file of legacyFiles) {
+        if (!dryRun)
+          await unlink4(join10(projectClaudeCommands, file));
+        result.removed.push(`.claude/commands/${file} (legacy)`);
+      }
+    } catch {}
     await migrateLegacyFiles(paths, dryRun, result);
-    const currentVersion = "0.13.3";
+    const currentVersion = "0.14.0";
     const migrationResult = await MigrationRunner.run(paths, currentVersion, dryRun);
     for (const m of migrationResult.migrated) {
       result.updated.push(`[migration] ${m}`);
@@ -15001,8 +15271,8 @@ init_paths();
 init_fs();
 init_version();
 init_config();
-import { join as join26 } from "path";
-program.name("reap").description("REAP — Recursive Evolutionary Autonomous Pipeline").version("0.13.3");
+import { join as join27 } from "path";
+program.name("reap").description("REAP — Recursive Evolutionary Autonomous Pipeline").version("0.14.0");
 program.command("init").description("Initialize a new REAP project (Genesis)").argument("[project-name]", "Project name (defaults to current directory name)").option("-m, --mode <mode>", "Entry mode: greenfield, migration, adoption", "greenfield").option("-p, --preset <preset>", "Bootstrap with a genome preset (e.g., bun-hono-react)").action(async (projectName, options) => {
   try {
     const cwd = process.cwd();
@@ -15058,7 +15328,8 @@ program.command("status").description("Show current project and Generation statu
     const paths = new ReapPaths(cwd);
     const config = await ConfigManager.read(paths);
     const skipCheck = config.autoUpdate === false;
-    const versionLine = formatVersionLine(status.version, skipCheck);
+    const installedVersion = "0.14.0";
+    const versionLine = formatVersionLine(installedVersion, skipCheck);
     console.log(`${versionLine} | Project: ${status.project} (${status.entryMode})`);
     console.log(`Completed Generations: ${status.totalGenerations}`);
     if (status.generation) {
@@ -15136,10 +15407,10 @@ program.command("help").description("Show REAP commands, slash commands, and wor
     if (l === "korean" || l === "ko")
       lang = "ko";
   }
-  const helpDir = join26(ReapPaths.packageTemplatesDir, "help");
-  let helpText = await readTextFile(join26(helpDir, `${lang}.txt`));
+  const helpDir = join27(ReapPaths.packageTemplatesDir, "help");
+  let helpText = await readTextFile(join27(helpDir, `${lang}.txt`));
   if (!helpText)
-    helpText = await readTextFile(join26(helpDir, "en.txt"));
+    helpText = await readTextFile(join27(helpDir, "en.txt"));
   if (!helpText) {
     console.log("Help file not found. Run 'reap update' to install templates.");
     return;

package/dist/templates/commands/reap.refreshKnowledge.md

@@ -0,0 +1,6 @@
+---
+description: "REAP Refresh Knowledge — Load REAP context (Genome, Environment, Generation state)"
+---
+
+Run `reap run refreshKnowledge` and incorporate the returned REAP context into your working knowledge.
+This is useful when you don't have REAP context loaded (e.g., in a subagent or after context compaction).

package/dist/templates/help/en.txt

@@ -20,6 +20,7 @@ Slash Commands (use in Claude Code):
   /reap.status         Show current state
   /reap.sync           Synchronize Genome with source code
   /reap.help           Contextual help (AI-powered)
+  /reap.refreshKnowledge  Load REAP context for subagents
 
 Quick Start:
   1. reap init my-project

package/dist/templates/help/ko.txt

@@ -20,6 +20,7 @@ CLI 명령어:
   /reap.status         현재 상태 확인
   /reap.sync           Genome을 소스 코드와 동기화
   /reap.help           상황별 도움말 (AI 기반)
+  /reap.refreshKnowledge  서브에이전트용 REAP 컨텍스트 로드
 
 빠른 시작:
   1. reap init my-project

package/dist/templates/hooks/genome-loader.cjs

@@ -7,6 +7,17 @@ const { execSync } = require('child_process');
 const L1_LIMIT = 500;
 const L2_LIMIT = 200;
 const L1_FILES = ['principles.md', 'conventions.md', 'constraints.md', 'source-map.md'];
+const PLACEHOLDER_PATTERNS = [
+  /\(Add .+ here\)/,
+  /\(Describe .+\)/,
+  /\(language and version\)/,
+  /\(External .+\)/,
+  /\(runtime environment\)/,
+  /\(framework\)/,
+  /\(database\)/,
+  /^\|\s*\|\s*\|\s*\|\s*\|$/m,
+];
+
 const STAGE_COMMANDS = {
   objective: '/reap.objective',
   planning: '/reap.planning',
@@ -188,6 +199,17 @@ function buildStrictSection(strictEdit, strictMerge, genStage) {
   return sections;
 }
 
+/**
+ * Check if a genome file contains placeholder template content.
+ * @param {string} filePath - path to a genome file
+ * @returns {boolean} true if the file contains placeholder patterns
+ */
+function hasPlaceholders(filePath) {
+  const content = readFile(filePath);
+  if (!content) return false;
+  return PLACEHOLDER_PATTERNS.some(pattern => pattern.test(content));
+}
+
 /**
  * Build Genome health status for session init display.
  * @param {object} params
@@ -202,6 +224,22 @@ function buildGenomeHealth({ l1Lines, genomeDir, configFile, genomeStaleWarning,
     if (!check) { issues.push(`missing ${f}`); severity = 'danger'; }
   }
   if (!fileExists(configFile)) { issues.push('no config.yml'); severity = 'danger'; }
+
+  // Check for placeholder content in L1 files
+  const placeholderFiles = L1_FILES.filter(f => {
+    const fp = path.join(genomeDir, f);
+    return fileExists(fp) && hasPlaceholders(fp);
+  });
+  if (placeholderFiles.length > 0) {
+    if (placeholderFiles.length === L1_FILES.length) {
+      issues.push(`needs customization (${placeholderFiles.length}/${L1_FILES.length} files)`);
+      severity = 'danger';
+    } else {
+      issues.push(`needs customization (${placeholderFiles.length}/${L1_FILES.length} files)`);
+      if (severity === 'ok') severity = 'warn';
+    }
+  }
+
   if (genomeStaleWarning && commitsSince > 30) {
     issues.push(`severely stale (${commitsSince} commits)`);
     if (severity !== 'danger') severity = 'danger';
@@ -223,6 +261,7 @@ module.exports = {
   L2_LIMIT,
   L1_FILES,
   STAGE_COMMANDS,
+  PLACEHOLDER_PATTERNS,
   readFile,
   fileExists,
   dirExists,
@@ -233,4 +272,5 @@ module.exports = {
   detectStaleness,
   buildStrictSection,
   buildGenomeHealth,
+  hasPlaceholders,
 };

package/dist/templates/hooks/reap-guide.md

@@ -7,12 +7,12 @@ REAP (Recursive Evolutionary Autonomous Pipeline) is a development pipeline wher
 ## 3-Layer Model
 
 ```
-Genome (Genetic Information)  →  Evolution (Cross-generational Evolution)  →  Civilization (Source Code)
-  Design and knowledge             Life cycle, mutation, adaptation              Accumulated artifacts
+Knowledge Base (Genome + Environment)  →  Evolution (Generational Progress)  →  Civilization (Source Code)
+  Design, knowledge & external context      Life cycle, mutation, adaptation       Accumulated artifacts
 ```
 
-- **Genome** — Design and knowledge for building the Application. Stored in `.reap/genome/`.
-- **Evolution** — The process by which Genome evolves and Civilization grows through repeated Generations.
+- **Knowledge Base** — Genome (architecture, conventions, constraints) and Environment (external APIs, infrastructure). Stored in `.reap/genome/` and `.reap/environment/`.
+- **Evolution** — The process by which knowledge evolves and Civilization grows through repeated Generations.
 - **Civilization** — Source Code. The entire project codebase outside `.reap/`.
 
 ## Genome Structure
@@ -170,7 +170,7 @@ objective → planning → implementation → validation → completion
 6. `/reap.completion` — Retrospective + genome updates + archiving (auto)
 
 `/reap.next` is a **transition command**, not a lifecycle stage. It advances `current.yml` to the next stage.
-`/reap.completion` auto-archives after the genome phase — no separate `/reap.next` needed at the end.
+`/reap.completion` auto-archives after the feedKnowledge phase — no separate `/reap.next` needed at the end.
 
 ## Language
 

package/dist/templates/hooks/session-start.cjs

@@ -28,47 +28,89 @@ if (!gl.dirExists(reapDir)) {
   process.exit(0);
 }
 
-// Step 0: Install project-level command files (copy, not symlink — Claude Code doesn't follow symlinks)
+// Step 0: Install project-level skill files (.claude/skills/{name}/SKILL.md)
 const fs = require('fs');
 const os = require('os');
 const userReapCommands = path.join(os.homedir(), '.reap', 'commands');
-const projectClaudeCommands = path.join(projectRoot, '.claude', 'commands');
+const projectClaudeSkills = path.join(projectRoot, '.claude', 'skills');
+
+/**
+ * Parse frontmatter from a command .md file.
+ * Returns { description, body } where body is the content after frontmatter.
+ */
+function parseFrontmatter(content) {
+  const match = content.match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/);
+  if (!match) return { description: '', body: content };
+  const fm = match[1];
+  const body = match[2];
+  const descMatch = fm.match(/^description:\s*"?([^"\n]*)"?/m);
+  return { description: descMatch ? descMatch[1].trim() : '', body };
+}
 
 if (gl.dirExists(userReapCommands)) {
   try {
-    fs.mkdirSync(projectClaudeCommands, { recursive: true });
     const cmdFiles = fs.readdirSync(userReapCommands).filter(f => f.startsWith('reap.') && f.endsWith('.md'));
     let installed = 0;
     for (const file of cmdFiles) {
       const src = path.join(userReapCommands, file);
-      const dest = path.join(projectClaudeCommands, file);
+      const name = file.replace(/\.md$/, ''); // e.g. reap.objective
+      const skillDir = path.join(projectClaudeSkills, name);
+      const skillFile = path.join(skillDir, 'SKILL.md');
+
+      const srcContent = fs.readFileSync(src, 'utf-8');
+      const { description, body } = parseFrontmatter(srcContent);
+      const skillContent = `---\nname: ${name}\ndescription: "${description}"\n---\n${body}`;
+
+      // Skip if content is identical
       try {
-        const stat = fs.lstatSync(dest);
-        if (stat.isSymbolicLink()) {
-          fs.unlinkSync(dest); // replace legacy symlink with real file
-        } else {
-          // Skip if content is identical
-          const srcContent = fs.readFileSync(src);
-          const destContent = fs.readFileSync(dest);
-          if (srcContent.equals(destContent)) continue;
-          fs.unlinkSync(dest);
-        }
+        const existing = fs.readFileSync(skillFile, 'utf-8');
+        if (existing === skillContent) continue;
       } catch { /* dest doesn't exist */ }
-      fs.copyFileSync(src, dest);
+
+      fs.mkdirSync(skillDir, { recursive: true });
+      fs.writeFileSync(skillFile, skillContent, 'utf-8');
       installed++;
     }
-    // Ensure .gitignore excludes these files
+
+    // Clean up legacy .claude/commands/reap.* files
+    const projectClaudeCommands = path.join(projectRoot, '.claude', 'commands');
+    try {
+      if (fs.existsSync(projectClaudeCommands)) {
+        const legacyFiles = fs.readdirSync(projectClaudeCommands).filter(f => f.startsWith('reap.') && f.endsWith('.md'));
+        for (const file of legacyFiles) {
+          fs.unlinkSync(path.join(projectClaudeCommands, file));
+        }
+        if (legacyFiles.length > 0) {
+          process.stderr.write(`[REAP] Cleaned up ${legacyFiles.length} legacy .claude/commands/reap.* files\n`);
+        }
+      }
+    } catch { /* best effort */ }
+
+    // Ensure .gitignore excludes skill files (and migrate legacy entry)
     const gitignorePath = path.join(projectRoot, '.gitignore');
-    const gitignoreEntry = '.claude/commands/reap.*';
+    const newEntry = '.claude/skills/reap.*';
+    const legacyEntry = '.claude/commands/reap.*';
     try {
-      const gitignore = fs.existsSync(gitignorePath) ? fs.readFileSync(gitignorePath, 'utf-8') : '';
-      if (!gitignore.includes(gitignoreEntry)) {
-        fs.appendFileSync(gitignorePath, `\n# REAP command files (managed by session-start hook)\n${gitignoreEntry}\n`);
+      let gitignore = fs.existsSync(gitignorePath) ? fs.readFileSync(gitignorePath, 'utf-8') : '';
+      let changed = false;
+      // Replace legacy entry with new entry
+      if (gitignore.includes(legacyEntry)) {
+        gitignore = gitignore.replace(legacyEntry, newEntry);
+        changed = true;
+      }
+      // Add new entry if not present
+      if (!gitignore.includes(newEntry)) {
+        gitignore += `\n# REAP skill files (managed by session-start hook)\n${newEntry}\n`;
+        changed = true;
+      }
+      if (changed) {
+        fs.writeFileSync(gitignorePath, gitignore, 'utf-8');
       }
     } catch { /* best effort */ }
-    process.stderr.write(`[REAP] Installed ${installed} commands to .claude/commands/ (${cmdFiles.length - installed} unchanged)\n`);
+
+    process.stderr.write(`[REAP] Installed ${installed} skills to .claude/skills/ (${cmdFiles.length - installed} unchanged)\n`);
   } catch (err) {
-    process.stderr.write(`[REAP] Warning: failed to install commands: ${err.message}\n`);
+    process.stderr.write(`[REAP] Warning: failed to install skills: ${err.message}\n`);
   }
 }
 

package/package.json

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