prizmkit 1.0.13 → 1.0.14

package/src/scaffold.js

@@ -18,7 +18,8 @@ import {
   getTemplatesDir,
   getPipelineDir,
   getAdaptersDir,
-  getFrameworkRoot,
+  getRulesDir,
+  loadRulesMetadata,
 } from './metadata.js';
 import { generateGitignore } from './gitignore-template.js';
 
@@ -51,6 +52,20 @@ async function loadSharedFrontmatter() {
 async function resolveSkillList(suite) {
   const metadata = await loadMetadata();
 
+  // 处理 recommended:<type> 格式
+  if (suite && suite.startsWith('recommended:')) {
+    const projectType = suite.split(':')[1];
+    const rec = metadata.recommendations?.[projectType];
+    if (rec) {
+      const baseSkills = rec.base === '*'
+        ? Object.keys(metadata.skills)
+        : [...(metadata.suites[rec.base]?.skills || [])];
+      const includeSkills = rec.include || [];
+      const excludeSkills = new Set(rec.exclude || []);
+      return [...new Set([...baseSkills, ...includeSkills])].filter(s => !excludeSkills.has(s));
+    }
+  }
+
   const suiteDef = metadata.suites[suite] || metadata.suites.full;
   if (suiteDef.skills === '*') {
     return Object.keys(metadata.skills);
@@ -68,6 +83,13 @@ async function resolveSkillList(suite) {
 async function installSkills(platform, skills, projectRoot, dryRun) {
   const skillsDir = getSkillsDir();
   const { parseFrontmatter, buildMarkdown } = await loadSharedFrontmatter();
+  
+  // Load metadata to get skill -> category mapping
+  const metadata = await loadMetadata();
+  const skillCategories = {};
+  for (const [skillName, skillDef] of Object.entries(metadata.skills)) {
+    skillCategories[skillName] = skillDef.category;
+  }
 
   // Load Claude command adapter for skill conversion
   let convertSkillToCommand;
@@ -77,7 +99,31 @@ async function installSkills(platform, skills, projectRoot, dryRun) {
   }
 
   for (const skillName of skills) {
-    const corePath = path.join(skillsDir, skillName);
+    // Determine the category subdirectory (prizmkit-skill, prizmkit-tool-skill, Custom-skill)
+    const category = skillCategories[skillName];
+    if (!category) {
+      console.warn(`  ⚠ Skill ${skillName} has no category mapping in metadata, skipping`);
+      continue;
+    }
+
+    // Security: validate category and skillName contain no path traversal sequences.
+    if (category.includes('..') || category.includes('/') || skillName.includes('..') || skillName.includes('/')) {
+      console.warn(`  ⚠ Skill ${skillName} has invalid category or name, skipping`);
+      continue;
+    }
+
+    // Build path: prefer hierarchical layout (<skillsDir>/<category>/<skillName>),
+    // fallback to flat bundled layout (<skillsDir>/<skillName>) for npm package compatibility.
+    let corePath = path.resolve(skillsDir, category, skillName);
+    // Ensure resolved path stays within skillsDir
+    if (!corePath.startsWith(path.resolve(skillsDir))) {
+      console.warn(`  ⚠ Skill ${skillName} path escapes skills directory, skipping`);
+      continue;
+    }
+    if (!await fs.pathExists(corePath)) {
+      corePath = path.resolve(skillsDir, skillName);
+      if (!corePath.startsWith(path.resolve(skillsDir))) continue;
+    }
     if (!await fs.pathExists(corePath)) continue;
 
     const stat = await fs.stat(corePath);
@@ -292,11 +338,28 @@ async function installTeamConfig(platform, projectRoot, dryRun) {
  * 安装平台配置文件（settings/hooks/rules）
  */
 async function installSettings(platform, projectRoot, options, dryRun) {
+  // 从文件加载 rules
+  const rulesMeta = await loadRulesMetadata();
+  const rulesPreset = options.rules || 'recommended';
+  const preset = rulesMeta.presets[rulesPreset] || rulesMeta.presets.recommended;
+  const ruleNames = preset?.rules || [];
+  const rulesDir = getRulesDir();
+  const ruleFiles = [];
+  for (const name of ruleNames) {
+    const filePath = path.join(rulesDir, `${name}.md`);
+    if (await fs.pathExists(filePath)) {
+      ruleFiles.push({ name, content: await fs.readFile(filePath, 'utf8') });
+    }
+  }
+
   if (platform === 'codebuddy') {
     const settingsPath = path.join(projectRoot, '.codebuddy', 'settings.json');
 
     if (dryRun) {
       console.log(chalk.gray(`      [dry-run] .codebuddy/settings.json`));
+      if (ruleFiles.length > 0) {
+        console.log(chalk.gray(`      [dry-run] .codebuddy/rules/ (${ruleFiles.length} 条规则)`));
+      }
       return;
     }
 
@@ -309,12 +372,19 @@ async function installSettings(platform, projectRoot, options, dryRun) {
     await fs.writeFile(settingsPath, JSON.stringify(hookTemplate, null, 2));
     console.log(chalk.green(`      ✓ .codebuddy/settings.json`));
 
+    // Install rules for CodeBuddy
+    if (ruleFiles.length > 0) {
+      const { installRules: installCbRules } = await loadAdapter('codebuddy', 'rules-adapter.js');
+      await installCbRules(projectRoot, ruleFiles);
+      console.log(chalk.green(`      ✓ .codebuddy/rules/ (${ruleFiles.length} 条规则)`));
+    }
+
   } else if (platform === 'claude') {
     const claudeDir = path.join(projectRoot, '.claude');
 
     if (dryRun) {
       console.log(chalk.gray(`      [dry-run] .claude/settings.json`));
-      console.log(chalk.gray(`      [dry-run] .claude/rules/`));
+      console.log(chalk.gray(`      [dry-run] .claude/rules/ (${ruleFiles.length} 条规则)`));
       return;
     }
 
@@ -363,28 +433,9 @@ async function installSettings(platform, projectRoot, options, dryRun) {
     console.log(chalk.green(`      ✓ .claude/settings.json`));
 
     // Rules
-    const rulesDir = path.join(claudeDir, 'rules');
-    await fs.ensureDir(rulesDir);
-
-    const rules = [
-      {
-        filename: 'prizm-documentation.md',
-        content: `---\ndescription: "PrizmKit documentation rules"\nglobs:\n  - "**/*.ts"\n  - "**/*.tsx"\n  - "**/*.js"\n  - "**/*.jsx"\n  - "**/*.py"\n  - "**/*.go"\n  - "**/*.rs"\n  - "**/*.java"\n---\n\nWhen modifying source files in this project:\n1. Check if \`.prizm-docs/root.prizm\` exists\n2. If it does, read it before making changes to understand project structure\n3. After making changes, update affected \`.prizm-docs/\` files\n4. Follow the Prizm doc format (KEY: value, not prose)\n5. Size limits: L0 = 4KB, L1 = 3KB, L2 = 5KB\n`,
-      },
-      {
-        filename: 'prizm-commit-workflow.md',
-        content: `---\ndescription: "PrizmKit commit workflow rules"\n---\n\nBefore any git commit in this project:\n1. Update \`.prizm-docs/\` for affected modules\n2. Use Conventional Commits format: type(scope): description\n3. Bug fixes use \`fix()\` prefix, not \`feat()\`\n4. Do NOT create REGISTRY.md entries for bug fixes\n5. Use \`/prizmkit-committer\` command for the complete commit workflow\n`,
-      },
-      {
-        filename: 'prizm-progressive-loading.md',
-        content: `---\ndescription: "PrizmKit progressive context loading protocol"\n---\n\nThis project uses PrizmKit's progressive loading protocol:\n- ON SESSION START: Read \`.prizm-docs/root.prizm\` (L0 — project map)\n- ON TASK: Read L1 (\`.prizm-docs/<module>.prizm\`) for relevant modules\n- ON FILE EDIT: Read L2 (\`.prizm-docs/<module>/<submodule>.prizm\`) before modifying\n- NEVER load all .prizm docs at once\n- Arrow notation (->) in .prizm files indicates load pointers\n- DECISIONS and CHANGELOG in .prizm files are append-only\n`,
-      },
-    ];
-
-    for (const rule of rules) {
-      await fs.writeFile(path.join(rulesDir, rule.filename), rule.content);
-    }
-    console.log(chalk.green(`      ✓ .claude/rules/ (${rules.length} 条规则)`));
+    const { installRules: installClaudeRules } = await loadAdapter('claude', 'rules-adapter.js');
+    await installClaudeRules(projectRoot, ruleFiles);
+    console.log(chalk.green(`      ✓ .claude/rules/ (${ruleFiles.length} 条规则)`));
   }
 }
 
@@ -393,11 +444,19 @@ async function installSettings(platform, projectRoot, options, dryRun) {
  */
 async function installProjectMemory(platform, projectRoot, dryRun) {
   const templatesDir = getTemplatesDir();
+  const skillsDir = getSkillsDir();
   const templateName = platform === 'claude' ? 'claude-md-template.md' : 'codebuddy-md-template.md';
   const targetName = platform === 'claude' ? 'CLAUDE.md' : 'CODEBUDDY.md';
-  const templatePath = path.join(templatesDir, templateName);
   const targetPath = path.join(projectRoot, targetName);
 
+  // Prefer core/templates, fallback to prizm-kit/assets in hierarchical or flat skills layouts.
+  const templateCandidates = [
+    path.join(templatesDir, templateName),
+    path.join(skillsDir, 'prizmkit-skill', 'prizm-kit', 'assets', templateName),
+    path.join(skillsDir, 'prizm-kit', 'assets', templateName),
+  ];
+  const templatePath = templateCandidates.find(candidate => fs.pathExistsSync(candidate));
+
   if (await fs.pathExists(targetPath)) {
     console.log(chalk.yellow(`      ⚠ ${targetName} 已存在，跳过`));
     return;
@@ -408,7 +467,7 @@ async function installProjectMemory(platform, projectRoot, dryRun) {
     return;
   }
 
-  if (await fs.pathExists(templatePath)) {
+  if (templatePath && await fs.pathExists(templatePath)) {
     await fs.copy(templatePath, targetPath);
     console.log(chalk.green(`      ✓ ${targetName}`));
   } else {
@@ -492,14 +551,17 @@ async function installGitignore(projectRoot, options, dryRun) {
  * 执行纯净安装
  * @param {Object} config
  * @param {string} config.platform - 'codebuddy' | 'claude' | 'both'
- * @param {string} config.skills - 'full' | 'core' | 'minimal'
+ * @param {string} config.skills - 'full' | 'core' | 'minimal' | 'recommended:<type>'
  * @param {boolean} config.team - 是否启用团队模式
  * @param {boolean} config.pipeline - 是否安装 dev-pipeline
+ * @param {string} [config.rules] - Rules preset: 'recommended' | 'minimal' | 'none'
+ * @param {string} [config.aiCli] - AI CLI 可执行命令（写入 .prizmkit/config.json）
+ * @param {string[]} [config.externalSkills] - 要安装的外部 skill 名称列表
  * @param {string} config.projectRoot - 目标项目根目录
  * @param {boolean} config.dryRun - 是否为预览模式
  */
 export async function scaffold(config) {
-  const { platform, skills, team, pipeline, projectRoot, dryRun } = config;
+  const { platform, skills, team, pipeline, rules, aiCli, externalSkills, projectRoot, dryRun } = config;
   const platforms = platform === 'both' ? ['codebuddy', 'claude'] : [platform];
 
   if (dryRun) {
@@ -531,7 +593,7 @@ export async function scaffold(config) {
 
     // 4. Settings/Hooks/Rules
     console.log(chalk.blue('\n    平台配置:'));
-    await installSettings(p, projectRoot, { pipeline }, dryRun);
+    await installSettings(p, projectRoot, { pipeline, rules }, dryRun);
 
     // 5. Project Memory
     console.log(chalk.blue('\n    项目记忆文件:'));
@@ -551,6 +613,46 @@ export async function scaffold(config) {
   console.log(chalk.blue('    项目配置:'));
   await installGitignore(projectRoot, { pipeline }, dryRun);
 
+  // 8. 写入 .prizmkit/config.json（如果指定了 aiCli）
+  if (aiCli) {
+    const prizmkitDir = path.join(projectRoot, '.prizmkit');
+    const configPath = path.join(prizmkitDir, 'config.json');
+
+    if (dryRun) {
+      console.log(chalk.gray(`      [dry-run] .prizmkit/config.json (ai_cli: ${aiCli})`));
+    } else {
+      await fs.ensureDir(prizmkitDir);
+      let existingConfig = {};
+      if (await fs.pathExists(configPath)) {
+        existingConfig = await fs.readJSON(configPath);
+      }
+      existingConfig.ai_cli = aiCli;
+      await fs.writeJSON(configPath, existingConfig, { spaces: 2 });
+      console.log(chalk.green(`      ✓ .prizmkit/config.json (ai_cli: ${aiCli})`));
+    }
+  }
+
+  // 9. 安装外部 Skills（如果选择了）
+  if (externalSkills?.length) {
+    const { installExternalSkill } = await import('./external-skills.js');
+    const metadata = await loadMetadata();
+    const knownSkills = metadata.external_skills?.known || [];
+    console.log(chalk.blue('\n    外部技能:'));
+    for (const name of externalSkills) {
+      const skillDef = knownSkills.find(s => s.name === name);
+      if (skillDef) {
+        for (const p of platforms) {
+          try {
+            await installExternalSkill(skillDef, p, projectRoot, dryRun);
+            console.log(chalk.green(`      ✓ ${name} (external)`));
+          } catch (e) {
+            console.log(chalk.yellow(`      ⚠ ${name} 拉取失败，跳过: ${e.message}`));
+          }
+        }
+      }
+    }
+  }
+
   // === 完成 ===
   console.log('');
   console.log(chalk.bold('  ════════════════════════════════════════════════'));
@@ -581,16 +683,18 @@ export async function scaffold(config) {
     console.log('');
 
     // 安装统计
-    const metadata = await loadMetadata();
     const suiteLabel = skills === 'full' ? `全部 ${skillList.length} 个`
       : skills === 'core' ? `核心 ${skillList.length} 个`
-      : `最小 ${skillList.length} 个`;
+      : skills === 'minimal' ? `最小 ${skillList.length} 个`
+      : `推荐 ${skillList.length} 个`;
 
     console.log(chalk.gray(`  安装统计:`));
     console.log(chalk.gray(`    技能: ${suiteLabel}`));
     console.log(chalk.gray(`    平台: ${platforms.map(p => p === 'codebuddy' ? 'CodeBuddy' : 'Claude Code').join(' + ')}`));
     console.log(chalk.gray(`    团队: ${team ? '已启用' : '未启用'}`));
     console.log(chalk.gray(`    流水线: ${pipeline ? '已安装' : '未安装'}`));
+    console.log(chalk.gray(`    规则: ${rules || 'recommended'}`));
+    if (aiCli) console.log(chalk.gray(`    AI CLI: ${aiCli}`));
     console.log('');
   }
 }

package/bundled/skills/prizmkit-bug-fix-workflow/SKILL.md

@@ -1,356 +0,0 @@
----
-name: "prizmkit-bug-fix-workflow"
-tier: 1
-description: "[Tier 1] End-to-end bug fix workflow: triage → reproduce → fix → verify → commit. Orchestrates existing skills into a closed-loop 5-phase pipeline with standardized input/output artifacts. (project)"
----
-
-# PrizmKit Bug Fix Workflow
-
-End-to-end orchestration skill for bug fixes. Chains existing PrizmKit skills (error-triage, bug-reproducer, implement, code-review, committer) into a closed-loop 5-phase pipeline with standardized artifacts.
-
-## Overview
-
-```
-bug-planner → bug-fix-list.json → Bug Fix Pipeline → fix-plan.md + fix-report.md
-  (plan)         (input)             (5 phases)         (2 artifacts per bug)
-```
-
-### Pipeline Phases
-
-| Phase | Name | Skill Used | Artifact |
-|-------|------|-----------|----------|
-| 1 | Triage 分诊 | `prizmkit.error-triage` | → `fix-plan.md` |
-| 2 | Reproduce 复现 | `prizmkit.bug-reproduce` | (reproduction test) |
-| 3 | Fix 修复 | `prizmkit.implement` | (code changes) |
-| 4 | Verify 验证 | `prizmkit.code-review` | (review report) |
-| 5 | Commit & Learn | `prizmkit.committer` | → `fix-report.md` |
-
-### Artifacts — Fixed at 2, NEVER more
-
-Each bug produces exactly **2 artifact documents**:
-
-1. **`fix-plan.md`** — Generated after Phase 1 Triage. Contains root cause analysis, impact assessment, test strategy, and fix approach.
-2. **`fix-report.md`** — Generated after Phase 5 Commit. Contains fix details, verification results, knowledge captured, and acceptance criteria verification.
-
-Artifacts are stored at: `.prizmkit/bugfix/<BUG_ID>/`
-
-## Commands
-
-### prizmkit.bug-fix \<bug-description-or-error\>
-
-Execute the full bug fix pipeline for a single bug.
-
-**INPUT FORMATS** (any of the following):
-- Natural language bug description
-- Stack trace / error log
-- Failed test case output
-- User reproduction steps
-- Reference to a `bug-fix-list.json` entry
-
-### prizmkit.bug-fix-batch \<bug-fix-list.json\>
-
-Execute the bug fix pipeline for all pending bugs in a standardized `bug-fix-list.json` file.
-
-- Processes bugs in priority order (lower priority number = processed first)
-- Skips bugs with status ≠ `pending`
-- Updates status in `bug-fix-list.json` as each bug progresses through phases
-
----
-
-## Phase 1: Triage — 分诊分类
-
-**Goal**: Classify the bug, identify scope and severity, check known issues, produce `fix-plan.md`.
-
-**STEPS:**
-
-1. **Parse bug input**: Extract:
-   - Error message / stack trace (if provided)
-   - Expected vs actual behavior
-   - Steps to reproduce (if provided)
-   - Environment details (OS, runtime, browser)
-   - Affected feature / module (if identifiable)
-
-2. **Invoke `prizmkit.error-triage`**:
-   - Receive: error category, subcategory, root cause analysis, affected files
-   - Receive: severity rating (CRITICAL / HIGH / MEDIUM / LOW)
-
-3. **Check TRAPS for known issues**:
-   - Read `.prizm-docs/` TRAPS sections for identified modules
-   - If matching trap found:
-     - Set `KNOWN_ISSUE=true`, `SKIP_REPRODUCE=true`
-     - Include documented solution in fix-plan.md
-     - Jump to Phase 3
-
-4. **Generate `fix-plan.md`** at `.prizmkit/bugfix/<BUG_ID>/fix-plan.md`:
-
-   Required sections:
-   - **Bug Summary**: ID, title, severity, source type, affected feature
-   - **Root Cause Analysis**: error classification, root cause, call chain, TRAP match status
-   - **Impact Assessment**: directly affected files (with impact level), potentially affected modules (with risk level), cross-module impact notes
-   - **Test Strategy**: verification type, reproduction test design, regression test plan, manual verification steps (if verification_type=manual/hybrid)
-   - **Fix Approach**: proposed fix, fix scope (estimated lines changed), constraints
-
-**CHECKPOINT CP-BF-1**: `fix-plan.md` exists.
-
-**DECISION GATE — Fast Path**:
-- If severity ∈ {low, medium} AND root cause confidence is HIGH AND estimated change < 10 lines:
-  → Skip Phase 2, go directly to Phase 3
-- Otherwise → proceed to Phase 2
-
----
-
-## Phase 2: Reproduce — 复现确认
-
-**Goal**: Create an automated reproduction that proves the bug exists.
-
-**STEPS:**
-
-1. **Invoke `prizmkit.bug-reproduce`** with triage results and bug description
-
-2. **Receive and execute reproduction**:
-   - Run the generated reproduction test
-   - Verify it FAILS (proving the bug exists)
-
-3. **Handle reproduction result**:
-   - **Success** (test fails as expected): record as regression baseline, proceed to Phase 3
-   - **Failure** (cannot reproduce): refine and retry, **max 2 rounds**
-   - **After 2 failed rounds**: set status to `needs_info`, output questions for reporter, STOP
-
-**CHECKPOINT CP-BF-2**: Reproduction test exists and FAILS.
-
-**KEY RULES:**
-- Reproduction test MUST be automated
-- MUST fail with current code and pass after fix
-- Use project's existing test framework and conventions
-- Naming convention: `test_bugfix_<short-description>.<ext>`
-
----
-
-## Phase 3: Fix — 修复实现
-
-**Goal**: Implement the fix using TDD — reproduction test goes red → green.
-
-**STEPS:**
-
-1. **Read context**: fix-plan.md, reproduction test, `.prizm-docs/` (TRAPS, RULES, PATTERNS)
-
-2. **Plan fix** (lightweight, inline — NO spec/plan/tasks files):
-   - Identify exact code location(s) to modify
-   - Determine minimal fix approach
-   - Assess regression risk
-
-3. **Implement fix** via `prizmkit.implement` in TDD mode:
-   - Reproduction test is the "red test"
-   - Implement minimal code change to make it pass
-   - Ensure all existing tests still pass
-
-4. **Local verification**:
-   - Reproduction test → MUST PASS (green)
-   - Module test suite → MUST PASS (no regression)
-
-**CHECKPOINT CP-BF-3**: Reproduction test passes, module tests pass.
-
-**FIX LOOP**: Max 3 rounds. If still failing → escalate to user.
-
-**KEY RULES:**
-- Do NOT create `.prizmkit/specs/` directories
-- Do NOT create spec.md, plan.md, or tasks.md
-- Fix MUST be minimal and targeted — no scope creep
-- If fix requires architectural changes → STOP, recommend creating a Feature instead
-
----
-
-## Phase 4: Verify — 代码审查与回归验证
-
-**Goal**: Ensure fix correctness and zero regressions.
-
-**STEPS:**
-
-1. **Invoke `prizmkit.code-review`** (scoped to changed files only):
-   - Review dimensions for bug fix:
-     - **Fix correctness**: Does it address the root cause?
-     - **Regression safety**: Does it break existing behavior?
-     - **Code quality**: Is the fix clean and maintainable?
-     - **Test coverage**: Is the reproduction test adequate?
-   - Verdict: PASS / PASS_WITH_WARNINGS / NEEDS_FIXES
-
-2. **Run full test suite**: All tests MUST pass
-
-3. **Handle review results**:
-   - PASS / PASS_WITH_WARNINGS → proceed to Phase 5
-   - NEEDS_FIXES → return to Phase 3 (max 2 review rounds)
-
-**CHECKPOINT CP-BF-4**: Code review passes, all tests green.
-
-**MANUAL VERIFICATION GATE** (when verification_type=manual or hybrid):
-- Pipeline PAUSES after automated review passes
-- Output UAT checklist from fix-plan.md
-- Set status to `verifying`, wait for user confirmation
-- Resume to Phase 5 after user sign-off
-
----
-
-## Phase 5: Commit & Learn — 提交与知识积累
-
-**Goal**: Commit with proper conventions, capture lessons, generate `fix-report.md`.
-
-**STEPS:**
-
-1. **Invoke `prizmkit.committer`**:
-   - Commit message: `fix(<scope>): <description>`
-   - Include fix code + reproduction test
-   - Do NOT run `prizmkit.summarize` (no REGISTRY.md entry)
-   - Do NOT push
-
-2. **Update TRAPS** (if new pitfall discovered):
-   - Append to affected module's TRAPS section in `.prizm-docs/`
-   - Format: `- TRAP: <description> | FIX: <solution> | DATE: YYYY-MM-DD`
-   - If no new pitfall: skip
-
-3. **Generate `fix-report.md`** at `.prizmkit/bugfix/<BUG_ID>/fix-report.md`:
-
-   Required sections:
-   - **Bug Resolution Summary**: ID, title, status (✅ FIXED), phases completed, duration
-   - **What Was Fixed**: changes made (file, change type, description), diff summary, commit message
-   - **Verification Results**: reproduction test before/after, regression test results, review verdict
-   - **Knowledge Captured**: TRAPS updated (yes/no with details), prevention recommendation
-   - **Acceptance Criteria Verification**: checklist with pass/fail for each criterion
-
-   Additional sections (when verification_type=manual or hybrid):
-   - **Manual Verification Results**: UAT checklist results, sign-off status, reviewer, date
-
-**CHECKPOINT CP-BF-5**: Commit recorded, fix-report.md written.
-
----
-
-## Fast Path — 快速修复路径
-
-For LOW/MEDIUM severity bugs with obvious root cause and high confidence:
-
-```
-Phase 1 (Triage) → Phase 3 (Fix) → Phase 5 (Commit)
-```
-
-Skip Phase 2 (Reproduce) and Phase 4 (full Review).
-- Still write a basic test for the fix
-- Still use `fix(<scope>):` commit convention
-- Still update TRAPS if applicable
-- Still generate both fix-plan.md and fix-report.md
-
-**CRITERIA**:
-- Triage confidence is HIGH
-- Root cause is a single, obvious code error
-- Fix is less than 10 lines of code changes
-- No cross-module impact
-
----
-
-## Status Mapping
-
-`bug-fix-list.json` status values map to pipeline phases:
-
-| Phase | Entry Status | In-Progress | Success Exit | Failure Exit |
-|-------|-------------|-------------|-------------|-------------|
-| Phase 1: Triage | `pending` | `triaging` | → `reproducing` | → `failed` |
-| Phase 2: Reproduce | `reproducing` | `reproducing` | → `fixing` | → `needs_info` |
-| Phase 3: Fix | `fixing` | `fixing` | → `verifying` | → `failed` (3 rounds) |
-| Phase 4: Verify | `verifying` | `verifying` | → Phase 5 | → `fixing` (return) |
-| Phase 5: Commit | — | — | → `completed` | → `failed` |
-
----
-
-## Knowledge Accumulation Mechanism
-
-### Automatic TRAPS Update
-
-After each successful bug fix (Phase 5):
-- If new pitfall discovered (not previously in TRAPS):
-  → Append to `.prizm-docs/<affected-module>.prizm` TRAPS section
-- If `affected_feature` is set:
-  → Cross-reference original Feature ID in TRAPS entry
-
-### Bug Pattern Analysis (optional, manual trigger)
-
-When `.prizmkit/bugfix/` accumulates 5+ completed bugs:
-- Analyze `error_source.type` distribution
-- Analyze `severity` distribution trends
-- Analyze `affected_modules` frequency (identify fragile modules)
-- Output recommendations for preventive refactoring
-
-### Feature Quality Tracking
-
-When `affected_feature` is non-empty:
-- If same Feature accumulates 3+ bugs → flag as "needs-revisit"
-
----
-
-## Error Handling
-
-| Scenario | Action |
-|----------|--------|
-| Cannot parse bug description | Ask user for clarification |
-| Triage returns LOW confidence | Proceed with warning |
-| Cannot reproduce after 2 rounds | STOP, set `needs_info`, request more info |
-| Fix fails after 3 rounds | Escalate to user with analysis |
-| Review fails after 2 rounds | Escalate with review findings |
-| Full test suite has pre-existing failures | Warn user, isolate bug fix tests |
-| Fix requires architectural change | STOP, recommend Feature instead |
-| verification_type=manual and no user response | Keep status `verifying`, wait |
-
----
-
-## Relationship to Other Skills
-
-| Skill | Role in Bug Fix Workflow |
-|-------|------------------------|
-| `prizmkit-error-triage` | Phase 1: error classification and root cause analysis |
-| `prizmkit-bug-reproducer` | Phase 2: generate minimal reproduction |
-| `prizmkit-implement` | Phase 3: TDD-style fix implementation |
-| `prizmkit-code-review` | Phase 4: review fix correctness |
-| `prizmkit-committer` | Phase 5: commit with `fix()` convention |
-| `prizmkit-log-analyzer` | Optional: analyze logs if bug includes log files |
-| `bug-planner` | Pre-pipeline: generate standardized `bug-fix-list.json` |
-| `prizmkit-retrospective` | NOT used (bug fixes don't get retrospectives) |
-| `prizmkit-summarize` | NOT used (no REGISTRY entries for bugs) |
-| `prizmkit-specify` | NOT used (no spec.md for bugs) |
-| `prizmkit-plan` | NOT used (no plan.md for bugs) |
-| `prizmkit-tasks` | NOT used (no tasks.md for bugs) |
-| `refactor-workflow` | NOT used (separate pipeline for refactoring) |
-
----
-
-## Comparison with Feature and Refactor Pipelines
-
-| Dimension | Feature Pipeline | Refactor Workflow | Bug Fix Pipeline |
-|-----------|-----------------|-------------------|------------------|
-| Input Skill | `app-planner` (7-phase interactive) | Direct invocation (prizmkit.refactor) | `bug-planner` (multi-format parser) |
-| Input File | `feature-list.json` (F-NNN) | N/A (conversation trigger) | `bug-fix-list.json` (B-NNN) |
-| Schema Version | `dev-pipeline-feature-list-v1` | N/A | `dev-pipeline-bug-fix-list-v1` |
-| Pipeline Phases | 7 Phase (Fast Path: 5) | 6 Phase (Fast Path: 4) | 5 Phase (Fast Path: 3) |
-| Phase 1 | Specify (spec.md) | Analyze (refactor-analysis.md) | Triage (fix-plan.md) |
-| Artifact Docs | 3: spec.md + plan.md + tasks.md | 3: refactor-analysis.md + plan.md + tasks.md | 2: fix-plan.md + fix-report.md |
-| Artifact Path | `.prizmkit/specs/<feature-slug>/` | `.prizmkit/refactor/<slug>/` | `.prizmkit/bugfix/<bug-id>/` |
-| Prompt Template | `bootstrap-prompt.md` | N/A (in-session) | `bugfix-bootstrap-prompt.md` |
-| Skills Chain | specify → plan → tasks → implement → review → summarize → commit | tech-debt-tracker → plan → tasks → implement → review → commit | error-triage → bug-reproduce → implement → code-review → commit |
-| Commit Prefix | `feat(<scope>):` | `refactor(<scope>):` | `fix(<scope>):` |
-| REGISTRY Update | ✅ via summarize | ❌ not applicable | ❌ not applicable |
-| TRAPS Update | Only in retrospective | Resolved TRAPS removed | ✅ automatic after every fix |
-| Test Strategy | TDD per task | Full suite after EVERY task | Reproduction test |
-| Scope Guard | N/A | ✅ (enforced) | N/A |
-| Behavior Change | ✅ Expected | ❌ Forbidden | ✅ Fix behavior |
-| Manual Verification | None | None | Supported (verification_type=manual/hybrid) |
-| Agent Roles | PM → Dev → Reviewer → Doc | Dev → Reviewer (streamlined) | Dev → Reviewer (streamlined) |
-
-## Path References
-
-All internal asset paths MUST use `${SKILL_DIR}` placeholder for cross-IDE compatibility.
-
-## Output
-
-- `fix-plan.md` (Phase 1 artifact)
-- Reproduction test file (Phase 2)
-- Fix implementation (Phase 3)
-- Code review report (Phase 4, conversation only)
-- `fix-report.md` (Phase 5 artifact)
-- Git commit with `fix(<scope>):` prefix (Phase 5)
-- Updated `.prizm-docs/` TRAPS (if applicable)

package/bundled/templates/claude-md-template.md

@@ -1,38 +0,0 @@
-## PrizmKit Documentation Framework
-
-This project uses PrizmKit with the Prizm documentation system for AI-optimized progressive context loading.
-
-### Progressive Loading Protocol
-- ON SESSION START: Always read `.prizm-docs/root.prizm` first (L0 — project map)
-- ON TASK: Read L1 (`.prizm-docs/<module>.prizm`) for relevant modules referenced in MODULE_INDEX
-- ON FILE EDIT: Read L2 (`.prizm-docs/<module>/<submodule>.prizm`) before modifying files. Pay attention to TRAPS and DECISIONS.
-- NEVER load all .prizm docs at once. Load only what is needed for the current task.
-
-### Auto-Update Protocol
-- BEFORE EVERY COMMIT: Update affected `.prizm-docs/` files
-- The `.claude/rules/` files will enforce this automatically
-- Use `/prizmkit-committer` command for the complete commit workflow
-
-### Doc Format Rules
-- All `.prizm` files use KEY: value format, not prose
-- Size limits: L0 = 4KB, L1 = 3KB, L2 = 5KB
-- Arrow notation (->) indicates load pointers to other .prizm docs
-- DECISIONS and CHANGELOG are append-only (never delete entries)
-
-### Creating New L2 Docs
-- When you first modify files in a sub-module that has no L2 doc:
-  1. Read the source files in that sub-module
-  2. Generate a new L2 `.prizm` file following Prizm specification
-  3. Add a pointer in the parent L1 doc's SUBDIRS section
-
-### Available Commands
-Run `/prizm-kit` to see all available PrizmKit commands.
-
-### Fast Path for Simple Changes
-Not every change needs the full spec -> plan -> tasks workflow. Use fast path for:
-- Bug fixes with clear root cause, config tweaks, typo fixes, simple refactors
-- Documentation-only changes, test additions for existing code
-- Directly use `/prizmkit-implement` with inline task description, then `/prizmkit-committer`
-
-Use the full workflow (/prizmkit-specify -> /prizmkit-plan -> /prizmkit-tasks -> /prizmkit-analyze -> /prizmkit-implement) for:
-- New features, multi-file coordinated changes, architectural decisions, data model or API changes