@claude-pw/framework 0.3.0

package/install.js

@@ -0,0 +1,593 @@
+#!/usr/bin/env node
+// ============================================================
+// claude-pw — Structured Project Workflow for Claude Code
+// https://github.com/dcdeve/claude-pw
+//
+// Usage:
+//   npx @claude-pw/framework my-project   (npm)
+//   npx @claude-pw/framework --update     (update existing)
+//   node install.js my-project            (local)
+//   node install.js --update              (update .claude/ only)
+// ============================================================
+
+const fs = require('fs');
+const path = require('path');
+const readline = require('readline');
+const { execSync } = require('child_process');
+
+const VERSION = '0.3.0';
+
+// --- Colors ---
+const c = {
+  red: (s) => `\x1b[31m${s}\x1b[0m`,
+  green: (s) => `\x1b[32m${s}\x1b[0m`,
+  yellow: (s) => `\x1b[33m${s}\x1b[0m`,
+  bold: (s) => `\x1b[1m${s}\x1b[0m`,
+};
+
+const info = (msg) => console.log(`${c.green('>')} ${msg}`);
+const warn = (msg) => console.log(`${c.yellow('!')} ${msg}`);
+const error = (msg) => console.error(`${c.red('x')} ${msg}`);
+const header = (msg) => console.log(`\n${c.bold(msg)}`);
+
+// --- Version comparison ---
+function versionLt(a, b) {
+  if (a === b) return false;
+  const pa = a.split('.').map(Number);
+  const pb = b.split('.').map(Number);
+  for (let i = 0; i < 3; i++) {
+    if ((pa[i] || 0) < (pb[i] || 0)) return true;
+    if ((pa[i] || 0) > (pb[i] || 0)) return false;
+  }
+  return false;
+}
+
+// --- Changelog display ---
+function showChangelog(from, to, releasesFile) {
+  if (!fs.existsSync(releasesFile)) return;
+  const lines = fs.readFileSync(releasesFile, 'utf8').split('\n');
+  let inRange = false;
+  console.log('');
+  for (const line of lines) {
+    const match = line.match(/^## \[(\d+\.\d+\.\d+)\]/);
+    if (match) {
+      const ver = match[1];
+      inRange = versionLt(from, ver) && !versionLt(to, ver);
+    }
+    if (inRange) console.log(`  ${line}`);
+  }
+  console.log('');
+}
+
+// --- File utilities ---
+function mkdirp(dir) {
+  fs.mkdirSync(dir, { recursive: true });
+}
+
+function copyFile(src, dest) {
+  mkdirp(path.dirname(dest));
+  fs.copyFileSync(src, dest);
+}
+
+function copyTemplate(src, dest, vars) {
+  mkdirp(path.dirname(dest));
+  if (src.endsWith('.tpl')) {
+    let content = fs.readFileSync(src, 'utf8');
+    for (const [key, value] of Object.entries(vars)) {
+      content = content.replace(new RegExp(`\\{\\{${key}\\}\\}`, 'g'), value);
+    }
+    fs.writeFileSync(dest, content);
+  } else {
+    fs.copyFileSync(src, dest);
+  }
+}
+
+function copyGlob(srcDir, destDir, ext) {
+  mkdirp(destDir);
+  const files = fs.readdirSync(srcDir).filter((f) => f.endsWith(ext));
+  for (const f of files) {
+    fs.copyFileSync(path.join(srcDir, f), path.join(destDir, f));
+  }
+  return files;
+}
+
+function copyIfMissing(src, dest) {
+  if (!fs.existsSync(dest) && fs.existsSync(src)) {
+    mkdirp(path.dirname(dest));
+    fs.copyFileSync(src, dest);
+  }
+}
+
+// --- Model profile application ---
+function applyModelProfile(agentsDir, configFile) {
+  if (!fs.existsSync(configFile)) return;
+
+  let config;
+  try {
+    config = JSON.parse(fs.readFileSync(configFile, 'utf8'));
+  } catch {
+    return;
+  }
+
+  const profile = config.modelProfile || 'balanced';
+  const overrides = config.modelOverrides || {};
+
+  const profiles = {
+    quality: {
+      'phase-validator': 'opus', 'session-recovery': 'opus', debugger: 'opus',
+      researcher: 'opus', 'codebase-mapper': 'opus', 'plan-checker': 'opus',
+      'spike-explorer': 'opus', 'decision-impact': 'opus', 'interface-reviewer': 'opus',
+      'learning-extractor': 'opus', implementer: 'opus',
+    },
+    budget: {
+      'phase-validator': 'sonnet', 'session-recovery': 'haiku', debugger: 'haiku',
+      researcher: 'sonnet', 'codebase-mapper': 'haiku', 'plan-checker': 'haiku',
+      'spike-explorer': 'haiku', 'decision-impact': 'haiku', 'interface-reviewer': 'haiku',
+      'learning-extractor': 'haiku', implementer: 'sonnet',
+    },
+  };
+
+  // Apply profile (skip balanced — it's the template default)
+  const profileMap = profiles[profile];
+  if (profileMap) {
+    for (const [agent, model] of Object.entries(profileMap)) {
+      const file = path.join(agentsDir, `${agent}.md`);
+      if (fs.existsSync(file)) {
+        let content = fs.readFileSync(file, 'utf8');
+        content = content.replace(/^model: .*/m, `model: ${model}`);
+        fs.writeFileSync(file, content);
+      }
+    }
+  }
+
+  // Apply per-agent overrides
+  for (const [agent, model] of Object.entries(overrides)) {
+    const file = path.join(agentsDir, `${agent}.md`);
+    if (fs.existsSync(file)) {
+      let content = fs.readFileSync(file, 'utf8');
+      content = content.replace(/^model: .*/m, `model: ${model}`);
+      fs.writeFileSync(file, content);
+      info(`Model override: ${agent} -> ${model}`);
+    }
+  }
+
+  if (profile !== 'balanced') {
+    info(`Model profile aplicado: ${profile}`);
+  }
+}
+
+// --- Settings.json merge ---
+function mergeSettings(templateFile, projectFile) {
+  try {
+    const tpl = JSON.parse(fs.readFileSync(templateFile, 'utf8'));
+    const proj = JSON.parse(fs.readFileSync(projectFile, 'utf8'));
+
+    // Start with template, overlay project top-level keys (except hooks)
+    const merged = { ...tpl, ...proj };
+
+    // Merge hooks: template as base, add project custom hooks that aren't in template
+    const tplHooks = tpl.hooks || {};
+    const projHooks = proj.hooks || {};
+    merged.hooks = {};
+
+    const allHookTypes = new Set([...Object.keys(tplHooks), ...Object.keys(projHooks)]);
+    for (const hookType of allHookTypes) {
+      const tplArr = tplHooks[hookType] || [];
+      const projArr = projHooks[hookType] || [];
+      const tplMatchers = new Set(tplArr.map((h) => h.matcher || ''));
+      const customHooks = projArr.filter((h) => !tplMatchers.has(h.matcher || ''));
+      merged.hooks[hookType] = [...tplArr, ...customHooks];
+    }
+
+    // Preserve statusLine from template if project doesn't have one
+    if (tpl.statusLine && !proj.statusLine) {
+      merged.statusLine = tpl.statusLine;
+    }
+
+    fs.writeFileSync(projectFile, JSON.stringify(merged, null, 2) + '\n');
+    info('settings.json mergeado (hooks custom preservados)');
+    return true;
+  } catch (e) {
+    warn(`settings.json: merge fallo — no modificado (${e.message})`);
+    return false;
+  }
+}
+
+// --- Gitignore merge ---
+function mergeGitignore(templateFile, projectFile) {
+  if (!fs.existsSync(templateFile)) return;
+  const tplLines = fs.readFileSync(templateFile, 'utf8').split('\n');
+  const existing = fs.existsSync(projectFile)
+    ? fs.readFileSync(projectFile, 'utf8')
+    : '';
+  const existingLines = new Set(existing.split('\n'));
+
+  const toAdd = tplLines.filter(
+    (line) => line && !line.startsWith('#') && !existingLines.has(line)
+  );
+
+  if (toAdd.length > 0) {
+    const append = (existing && !existing.endsWith('\n') ? '\n' : '') + toAdd.join('\n') + '\n';
+    fs.appendFileSync(projectFile, append);
+    for (const line of toAdd) info(`.gitignore: agregado '${line}'`);
+  }
+}
+
+// --- Prompt user for input ---
+function askQuestion(question) {
+  return new Promise((resolve) => {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.trim());
+    });
+  });
+}
+
+// --- Detect custom files (not from template) ---
+function detectCustomFiles(dir, templateDir, subdir) {
+  const projDir = path.join(dir, '.claude', subdir);
+  const tplDir = path.join(templateDir, 'claude', subdir);
+  if (!fs.existsSync(projDir) || !fs.existsSync(tplDir)) return;
+
+  const tplFiles = new Set(fs.readdirSync(tplDir));
+  for (const f of fs.readdirSync(projDir)) {
+    if (!tplFiles.has(f)) {
+      // Only warn about cpw-* files not in template (likely renamed/removed framework files)
+      // Non-cpw files are user's custom files — don't warn
+      if (f.startsWith('cpw-')) {
+        warn(`.claude/${subdir}/${f} has cpw- prefix but is not in the template (was it renamed?)`);
+      }
+    }
+  }
+}
+
+// --- Detect modified framework files ---
+function detectModifiedFiles(templateDir, destDir, ext) {
+  const tplFiles = fs.readdirSync(templateDir).filter((f) => f.endsWith(ext));
+  const modified = [];
+  for (const f of tplFiles) {
+    const destFile = path.join(destDir, f);
+    if (fs.existsSync(destFile)) {
+      const tplContent = fs.readFileSync(path.join(templateDir, f), 'utf8');
+      const destContent = fs.readFileSync(destFile, 'utf8');
+      if (tplContent !== destContent) {
+        modified.push(f);
+      }
+    }
+  }
+  return modified;
+}
+
+// --- Merge new fields into config.json ---
+function mergeConfig(templateFile, projectFile) {
+  if (!fs.existsSync(projectFile) || !fs.existsSync(templateFile)) return;
+  try {
+    const tpl = JSON.parse(fs.readFileSync(templateFile, 'utf8'));
+    const proj = JSON.parse(fs.readFileSync(projectFile, 'utf8'));
+    let added = 0;
+    for (const [key, value] of Object.entries(tpl)) {
+      if (!(key in proj)) {
+        proj[key] = value;
+        added++;
+        info(`config.json: added new field '${key}' (default: ${JSON.stringify(value)})`);
+      }
+    }
+    if (added > 0) {
+      fs.writeFileSync(projectFile, JSON.stringify(proj, null, 2) + '\n');
+    }
+  } catch (e) {
+    warn(`config.json merge failed: ${e.message}`);
+  }
+}
+
+// ============================================================
+// MAIN
+// ============================================================
+async function main() {
+  const args = process.argv.slice(2);
+  let updateOnly = false;
+  let projectName = '';
+
+  // Parse arguments
+  for (const arg of args) {
+    if (arg === '--update') updateOnly = true;
+    else if (arg === '--version') { console.log(`claude-pw ${VERSION}`); process.exit(0); }
+    else if (arg === '--help' || arg === '-h') {
+      console.log('claude-pw — Structured Project Workflow for Claude Code\n');
+      console.log('Usage:');
+      console.log('  claude-pw [project-name]    Create new project');
+      console.log('  claude-pw --update          Update .claude/ in existing project');
+      console.log('  claude-pw --version         Show version');
+      process.exit(0);
+    } else if (arg.startsWith('-')) {
+      error(`Unknown flag: ${arg}`);
+      process.exit(1);
+    } else {
+      projectName = arg;
+    }
+  }
+
+  // Locate templates directory (next to this script)
+  const scriptDir = __dirname;
+  const templatesDir = path.join(scriptDir, 'templates');
+  if (!fs.existsSync(templatesDir)) {
+    error('Templates directory not found');
+    process.exit(1);
+  }
+
+  const date = new Date().toISOString().slice(0, 10);
+
+  // ============================================================
+  // UPDATE MODE
+  // ============================================================
+  if (updateOnly) {
+    header('Actualizando .claude/ ...');
+
+    if (!fs.existsSync('.claude')) {
+      error('No hay .claude/ en el directorio actual. Estas en un proyecto claude-pw?');
+      process.exit(1);
+    }
+
+    // Read installed version
+    const versionFile = path.join('.claude', '.claude-pw-version');
+    const installedVersion = fs.existsSync(versionFile)
+      ? fs.readFileSync(versionFile, 'utf8').trim()
+      : '0.0.0';
+
+    if (installedVersion === VERSION) {
+      info(`Ya actualizado a claude-pw v${VERSION}`);
+      process.exit(0);
+    }
+
+    info(`Actualizando v${installedVersion} → v${VERSION}`);
+
+    // Show changelog
+    const releasesFile = path.join(scriptDir, 'RELEASES.md');
+    if (fs.existsSync(releasesFile)) {
+      header('Cambios:');
+      showChangelog(installedVersion, VERSION, releasesFile);
+    }
+
+    // Detect modified framework files before overwriting
+    const dirs = [
+      { tpl: path.join(templatesDir, 'claude', 'commands'), dest: path.join('.claude', 'commands'), ext: '.md', label: 'commands' },
+      { tpl: path.join(templatesDir, 'claude', 'agents'), dest: path.join('.claude', 'agents'), ext: '.md', label: 'agents' },
+      { tpl: path.join(templatesDir, 'claude', 'rules'), dest: path.join('.claude', 'rules'), ext: '.md', label: 'rules' },
+      { tpl: path.join(templatesDir, 'claude', 'hooks'), dest: path.join('.claude', 'hooks'), ext: '.js', label: 'hooks' },
+    ];
+
+    const allModified = [];
+    for (const d of dirs) {
+      const modified = detectModifiedFiles(d.tpl, d.dest, d.ext);
+      for (const f of modified) allModified.push(`.claude/${d.label}/${f}`);
+    }
+
+    // Show summary and confirm
+    const tplCounts = dirs.map((d) => {
+      const files = fs.existsSync(d.tpl) ? fs.readdirSync(d.tpl).filter((f) => f.endsWith(d.ext)).length : 0;
+      return `${files} ${d.label}`;
+    });
+    console.log(`\n  ${tplCounts.join(', ')} (overwrite)`);
+    console.log('  settings.json (merge, custom hooks preserved)');
+    console.log('  config.json (merge new fields)');
+    if (allModified.length > 0) {
+      console.log(`\n  ${c.yellow('Modified by you (will be overwritten):')}`);
+      for (const f of allModified) console.log(`    ${f}`);
+    }
+    console.log(`\n  Backup: .claude.backup.* (created before changes)\n`);
+
+    const confirm = await askQuestion('Apply? [y/N]: ');
+    if (!/^[yYsS]$/.test(confirm)) {
+      info('Cancelled.');
+      process.exit(0);
+    }
+
+    // Backup
+    const backupDir = `.claude.backup.${Date.now()}`;
+    fs.cpSync('.claude', backupDir, { recursive: true });
+    info(`Backup creado en ${backupDir}`);
+
+    // Copy commands, agents, rules, hooks
+    for (const d of dirs) {
+      mkdirp(d.dest);
+      copyGlob(d.tpl, d.dest, d.ext);
+    }
+
+    // Apply model profile
+    applyModelProfile(path.join('.claude', 'agents'), path.join('.planning', 'config.json'));
+
+    // Merge settings.json
+    const projSettings = path.join('.claude', 'settings.json');
+    const tplSettings = path.join(templatesDir, 'claude', 'settings.json');
+    if (fs.existsSync(projSettings)) {
+      mergeSettings(tplSettings, projSettings);
+    } else {
+      copyFile(tplSettings, projSettings);
+    }
+
+    // Merge .gitignore
+    mergeGitignore(path.join(templatesDir, 'gitignore'), '.gitignore');
+
+    // Create missing directories/files
+    mkdirp(path.join('.planning', 'quick'));
+    mkdirp(path.join('.planning', 'debug', 'resolved'));
+    mkdirp(path.join('.planning', 'learnings'));
+
+    copyIfMissing(path.join(templatesDir, 'planning', 'quick', 'log.md'), path.join('.planning', 'quick', 'log.md'));
+    copyIfMissing(path.join(templatesDir, 'planning', 'learnings', 'queue.md'), path.join('.planning', 'learnings', 'queue.md'));
+    copyIfMissing(path.join(templatesDir, 'planning', 'learnings', 'applied.md'), path.join('.planning', 'learnings', 'applied.md'));
+    copyIfMissing(path.join(templatesDir, 'planning', 'config.json'), path.join('.planning', 'config.json'));
+
+    // Merge new config fields from template
+    mergeConfig(path.join(templatesDir, 'planning', 'config.json'), path.join('.planning', 'config.json'));
+
+    // Detect custom files
+    detectCustomFiles('.', templatesDir, 'commands');
+    detectCustomFiles('.', templatesDir, 'agents');
+
+    // Write version
+    fs.writeFileSync(versionFile, VERSION);
+    info(`Actualizado a claude-pw v${VERSION}`);
+    process.exit(0);
+  }
+
+  // ============================================================
+  // NEW PROJECT MODE
+  // ============================================================
+
+  // Interactive prompt if no project name
+  if (!projectName) {
+    console.log(`${c.bold('claude-pw')} v${VERSION}\n`);
+    projectName = await askQuestion('Nombre del proyecto: ');
+    if (!projectName) {
+      error('Nombre requerido');
+      process.exit(1);
+    }
+  }
+
+  const projectDir = projectName;
+  projectName = path.basename(path.resolve(projectName));
+
+  header(`claude-pw v${VERSION} — ${projectName}`);
+
+  // Create directory
+  if (!fs.existsSync(projectDir)) {
+    mkdirp(projectDir);
+    info(`Directorio creado: ${projectDir}`);
+  }
+
+  process.chdir(projectDir);
+
+  // Check for existing project
+  if (fs.existsSync('CLAUDE.md') || fs.existsSync(path.join('.claude', 'commands'))) {
+    const confirm = await askQuestion('Este directorio ya tiene archivos de claude-pw. Sobreescribir? [y/N]: ');
+    if (!/^[yYsS]$/.test(confirm)) {
+      info('Cancelado. Usa --update para actualizar solo .claude/');
+      process.exit(0);
+    }
+  }
+
+  // Create directory structure
+  info('Creando estructura...');
+  for (const dir of [
+    '.claude/rules', '.claude/commands', '.claude/agents', '.claude/hooks',
+    '.husky', 'plans', 'docs', 'docs/research',
+    'src/interfaces',
+    'tests/unit', 'tests/integration', 'tests/contracts',
+    '.planning/quick', '.planning/debug/resolved', '.planning/learnings',
+  ]) {
+    mkdirp(dir);
+  }
+
+  // Copy templates
+  info('Copiando templates...');
+
+  // .claude/
+  copyGlob(path.join(templatesDir, 'claude', 'commands'), path.join('.claude', 'commands'), '.md');
+  copyGlob(path.join(templatesDir, 'claude', 'agents'), path.join('.claude', 'agents'), '.md');
+  copyGlob(path.join(templatesDir, 'claude', 'rules'), path.join('.claude', 'rules'), '.md');
+  copyGlob(path.join(templatesDir, 'claude', 'hooks'), path.join('.claude', 'hooks'), '.js');
+  copyFile(path.join(templatesDir, 'claude', 'settings.json'), path.join('.claude', 'settings.json'));
+  fs.writeFileSync(path.join('.claude', '.claude-pw-version'), VERSION);
+
+  // Apply model profile
+  applyModelProfile(path.join('.claude', 'agents'), path.join('.planning', 'config.json'));
+
+  // Husky
+  copyFile(path.join(templatesDir, 'husky', 'pre-commit'), path.join('.husky', 'pre-commit'));
+  try { fs.chmodSync(path.join('.husky', 'pre-commit'), 0o755); } catch { /* Windows */ }
+
+  // Plans and docs (only if missing)
+  for (const f of ['plans/phase-0.md', 'plans/phase-1.md', 'plans/decisions.md']) {
+    copyIfMissing(path.join(templatesDir, f), f);
+  }
+  for (const f of [
+    'docs/architecture.md', 'docs/interfaces.md', 'docs/tooling.md',
+    'docs/conventions.md', 'docs/codebase-map.md', 'docs/tech-debt.md',
+  ]) {
+    copyIfMissing(path.join(templatesDir, f), f);
+  }
+
+  // Planning state (local, gitignored)
+  copyIfMissing(path.join(templatesDir, 'planning', 'quick', 'log.md'), path.join('.planning', 'quick', 'log.md'));
+  copyIfMissing(path.join(templatesDir, 'planning', 'learnings', 'queue.md'), path.join('.planning', 'learnings', 'queue.md'));
+  copyIfMissing(path.join(templatesDir, 'planning', 'learnings', 'applied.md'), path.join('.planning', 'learnings', 'applied.md'));
+  copyIfMissing(path.join(templatesDir, 'planning', 'config.json'), path.join('.planning', 'config.json'));
+
+  // Root files with template variable substitution
+  const vars = { PROJECT_NAME: projectName, DATE: date };
+  if (!fs.existsSync('CLAUDE.md')) copyTemplate(path.join(templatesDir, 'CLAUDE.md.tpl'), 'CLAUDE.md', vars);
+  if (!fs.existsSync('PLAN.md')) copyTemplate(path.join(templatesDir, 'PLAN.md.tpl'), 'PLAN.md', vars);
+  if (!fs.existsSync('STATUS.md')) copyTemplate(path.join(templatesDir, 'STATUS.md.tpl'), 'STATUS.md', vars);
+  copyIfMissing(path.join(templatesDir, 'CHANGELOG.md'), 'CHANGELOG.md');
+  copyIfMissing(path.join(templatesDir, 'Makefile'), 'Makefile');
+
+  // .gitignore — handle commitPlanning setting
+  let commitPlanning = false;
+  const configPath = path.join('.planning', 'config.json');
+  if (fs.existsSync(configPath)) {
+    try {
+      commitPlanning = JSON.parse(fs.readFileSync(configPath, 'utf8')).commitPlanning === true;
+    } catch { /* ignore */ }
+  }
+
+  const tplGitignore = path.join(templatesDir, 'gitignore');
+  if (fs.existsSync(tplGitignore)) {
+    let gitignoreContent = fs.readFileSync(tplGitignore, 'utf8');
+    if (commitPlanning) {
+      gitignoreContent = gitignoreContent.split('\n').filter((l) => !l.startsWith('.planning/')).join('\n');
+    }
+
+    if (fs.existsSync('.gitignore')) {
+      const existing = fs.readFileSync('.gitignore', 'utf8');
+      if (!existing.includes('claude-pw')) {
+        fs.appendFileSync('.gitignore', '\n' + gitignoreContent);
+        info('.gitignore updated');
+      }
+    } else {
+      fs.writeFileSync('.gitignore', gitignoreContent);
+    }
+  }
+
+  // Git init
+  if (!fs.existsSync('.git')) {
+    try {
+      execSync('git init -q', { stdio: 'ignore' });
+      info('Git initialized');
+    } catch {
+      warn('git init failed — initialize manually');
+    }
+  }
+
+  // Summary
+  header('Listo');
+  console.log('');
+  console.log(`  ${projectName}/`);
+  console.log('  ├── .claude/commands/    10 commands (/cpw-startup, /cpw-next-step, /cpw-quick, ...)');
+  console.log('  ├── .claude/agents/      11 agentes (plan-checker, debugger, researcher, implementer, ...)');
+  console.log('  ├── .claude/rules/       3 reglas (interfaces, testing, git)');
+  console.log('  ├── .claude/hooks/       2 hooks (statusline, context monitor)');
+  console.log('  ├── plans/               Sub-planes (phase-0, phase-1, decisions)');
+  console.log('  ├── docs/                Arquitectura, interfaces, tooling');
+  console.log('  ├── .planning/           Estado local (quick tasks, debug sessions)');
+  console.log('  ├── CLAUDE.md            Instrucciones para Claude Code');
+  console.log('  ├── PLAN.md              Indice del proyecto');
+  console.log('  ├── STATUS.md            Puntero de sesion');
+  console.log('  └── Makefile             Comandos estandarizados');
+  console.log('');
+
+  header('Siguiente paso');
+  console.log('');
+  if (projectDir !== '.') {
+    console.log(`  cd ${projectDir}`);
+  }
+  console.log('  claude');
+  console.log('  /cpw-startup');
+  console.log('');
+}
+
+main().catch((e) => {
+  error(e.message);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@claude-pw/framework",
+  "version": "0.3.0",
+  "description": "Structured Project Workflow for Claude Code — adaptive pipeline, context management, quality gates",
+  "bin": {
+    "claude-pw": "./install.js"
+  },
+  "files": [
+    "install.js",
+    "templates",
+    "RELEASES.md"
+  ],
+  "keywords": [
+    "claude",
+    "claude-code",
+    "workflow",
+    "project-management",
+    "ai",
+    "context-engineering",
+    "meta-prompting"
+  ],
+  "author": "dcdeve",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dcdeve/claude-pw.git"
+  },
+  "homepage": "https://github.com/dcdeve/claude-pw",
+  "scripts": {
+    "test": "node --test"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/templates/CHANGELOG.md

@@ -0,0 +1,6 @@
+# Changelog
+
+Auto-generated from conventional commits. Manually edited on releases.
+
+## [Unreleased]
+<!-- Auto-generated by changelogen/release-please. Do not edit. -->

package/templates/CLAUDE.md.tpl

@@ -0,0 +1,38 @@
+# {{PROJECT_NAME}}
+
+## Stack
+TODO: Phase 0
+
+## Context rules
+- FIRST: Read STATUS.md — it tells you the current phase, step, stage, and which files to load
+- Load ONLY files listed in "Required context" from STATUS.md — nothing else
+- If `.planning/config.json` exists, load it for workflow settings
+- If `plans/phase-N-context.md` exists for the current phase, load it (discussion decisions)
+- Do NOT load files from other phases, previous steps, or unrelated docs
+- Do not modify files outside the scope of the current step
+- Do not modify src/interfaces/ without an RFC in plans/decisions.md
+- Use `make` for all commands
+- After each stage, update STATUS.md
+- Adaptive pipeline: evaluate which stages apply at the start of the step
+- Mandatory stages: DESIGN, ACCEPTANCE, CLOSE
+- If there is technical uncertainty -> SPIKE (explore and discard code)
+- At phase start, tooling is audited: search for skills/MCPs matching phase technologies, propose disabling tools no longer needed
+- NEVER git commit --no-verify
+- Big decisions -> /cpw-impact -> context reset
+- Ad-hoc tasks that don't affect the plan -> /cpw-quick
+- Debug that may take several sessions -> /cpw-debug (persists state)
+- If something seems broken or inconsistent -> /cpw-health
+- If the user corrects you, capture the correction in .planning/learnings/queue.md (include the active command in the Command field)
+- Learnings are auto-processed based on config (autoReflect: off/remind/auto)
+- When you discover something non-obvious (debug, workaround), evaluate for skill extraction → .claude/skills/
+- Context monitor: statusline tracks usage, warns at 65% (WARNING) and 80% (CRITICAL) — run /cpw-pause at CRITICAL
+
+## Structure
+- STATUS.md — Session pointer. Read FIRST. Tells you what to load.
+- PLAN.md — Project index (phases overview)
+- plans/phase-N.md — Sub-plan for phase N (load only current phase)
+- plans/phase-N-context.md — Discussion context (load if exists)
+- plans/decisions.md — Decisions and RFCs
+- src/interfaces/ — Contracts (RFC required to modify)
+- .planning/ — Project state (gitignored by default, set commitPlanning: true to track)
+- .planning/config.json — Workflow config (autoAdvance, granularity, modelProfile, modelOverrides, gitStrategy, commitPlanning, toolingSources, maxConsecutiveFailures, autoReflect)