@c-d-cc/reap 0.13.4 → 0.15.0

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

@@ -5,6 +5,8 @@ CLI Commands:
   reap status         Show current project and Generation status
   reap update         Sync slash commands, templates, and hooks
   reap fix            Diagnose and repair .reap/ directory
+  reap clean          Reset REAP project with interactive options
+  reap destroy        Remove all REAP files from project
   reap help           Show this help message
 
 Slash Commands (use in Claude Code):
@@ -20,6 +22,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

@@ -5,6 +5,8 @@ CLI 명령어:
   reap status         현재 프로젝트 및 Generation 상태 확인
   reap update         슬래시 커맨드, 템플릿, 훅을 최신 버전으로 동기화
   reap fix            .reap/ 디렉토리 구조 진단 및 복구
+  reap clean          대화형 옵션으로 REAP 프로젝트 초기화
+  reap destroy        프로젝트에서 모든 REAP 파일 제거
   reap help           이 도움말 표시
 
 슬래시 커맨드 (Claude Code에서 사용):
@@ -20,6 +22,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
@@ -161,16 +161,18 @@ REAP supports multiple AI agents simultaneously through the AgentAdapter abstrac
 objective → planning → implementation → validation → completion
 ```
 
-**Execution sequence**:
+**Execution sequence** (auto-transition):
 1. `/reap.start` — Create a new Generation
-2. `/reap.objective` — Define goal + requirements → `/reap.next`
-3. `/reap.planning` — Task decomposition + plan → `/reap.next`
-4. `/reap.implementation` — Code implementation → `/reap.next`
-5. `/reap.validation` — Verification → `/reap.next`
+2. `/reap.objective` — Define goal + requirements → `--phase complete` auto-advances to planning
+3. `/reap.planning` — Task decomposition + plan → `--phase complete` auto-advances to implementation
+4. `/reap.implementation` — Code implementation → `--phase complete` auto-advances to validation
+5. `/reap.validation` — Verification → `--phase complete` auto-advances to 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.
+Each `--phase complete` generates a stage chain token (nonce), auto-transitions to the next stage, and creates the next artifact template. The next stage command verifies the token at entry — this ensures stages cannot be skipped.
+
+`/reap.next` is maintained as a **fallback command**. If auto-transition already occurred, it confirms the transition. If not, it errors.
+`/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.4",
+  "version": "0.15.0",
   "description": "Recursive Evolutionary Autonomous Pipeline — AI and humans evolve software across generations",
   "type": "module",
   "license": "MIT",