claude-launchpad 0.9.1 → 0.9.2-dev.0

package/README.md

@@ -241,7 +241,7 @@ Score below threshold = exit code 1 = PR blocked.
 
 **Doctor** reads your files and runs static analysis. No API calls. No network. No cost.
 
-**Init** scans manifest files (package.json, go.mod, pyproject.toml, etc.), detects your stack, and generates 7 files: CLAUDE.md (with sprint reviews and memory management), TASKS.md (with deferred issues section), settings.json (with credential deny rules, sandbox enabled, bypass mode disabled, hooks including sprint review and PostCompact), .claude/.gitignore, .claudeignore, /lp-enhance skill, and language-specific rules. Formatter hooks use hardcoded safe commands only.
+**Init** scans manifest files (package.json, go.mod, pyproject.toml, etc.), detects your stack, and generates 8 files: CLAUDE.md (with sprint reviews and backlog management), TASKS.md (with deferred issues section), BACKLOG.md (priority-tiered feature parking), settings.json (with credential deny rules, sandbox enabled, bypass mode disabled, hooks including sprint review and PostCompact), .claude/.gitignore, .claudeignore, /lp-enhance skill, and language-specific rules. Formatter hooks use hardcoded safe commands only.
 
 **Enhance** is a `/lp-enhance` skill installed during `init`. It runs inside your active Claude Code session - no separate process, no overhead. Claude already has your codebase context, so it produces better results than an external command.
 

package/dist/cli.js

@@ -256,7 +256,12 @@ function generateClaudeMd(options, detected) {
   sections.push("", `## Session Start
 - ALWAYS read @TASKS.md first \u2014 it tracks progress across sessions
 - Check the Session Log at the bottom of TASKS.md for where we left off
-- Update TASKS.md as you complete work`);
+- Update TASKS.md as you complete work
+
+## Backlog
+- When a feature is discussed but deferred, add it to BACKLOG.md immediately
+- Never leave future ideas only in TASKS.md or conversation \u2014 they get lost
+- BACKLOG.md is the single source of truth for parked features`);
   sections.push("", `## Sprint Reviews
 When all tasks in the current sprint are complete, do a quick quality check before committing:
 - Scan changed files for dead code, debug logs, and TODO hacks
@@ -584,6 +589,20 @@ Also review .claude/settings.json hooks:
 `;
 }
 
+// src/commands/init/generators/backlog.ts
+function generateBacklogMd(options) {
+  return `# ${options.name} \u2014 Backlog
+
+> Features discussed but deferred. Pick up when relevant.
+> Priority: P0 = next sprint, P1 = soon, P2 = when relevant.
+
+<!-- Add deferred features here. Format:
+## [P1] Feature Name
+One-line description. Context for why it was deferred and when to revisit.
+-->
+`;
+}
+
 // src/commands/init/index.ts
 function createInitCommand() {
   return new Command("init").description("Set up Claude Code configuration for any project").option("-n, --name <name>", "Project name").option("-y, --yes", "Accept all defaults").action(async (opts) => {
@@ -628,11 +647,14 @@ async function scaffold(root, options, detected, skipPrompts) {
   log.step("Generating configuration...");
   const claudeMd = generateClaudeMd(options, detected);
   const tasksMd = generateTasksMd(options);
+  const backlogMd = generateBacklogMd(options);
   const settings = generateSettings(detected);
   const claudeignore = generateClaudeignore(detected);
   await mkdir(join2(root, ".claude", "rules"), { recursive: true });
   const settingsPath = join2(root, ".claude", "settings.json");
   const mergedSettings = await mergeSettings(settingsPath, settings);
+  const backlogPath = join2(root, "BACKLOG.md");
+  const hasBacklog = await fileExists(backlogPath);
   const claudeignorePath = join2(root, ".claudeignore");
   const hasClaudeignore = await fileExists(claudeignorePath);
   const claudeGitignorePath = join2(root, ".claude", ".gitignore");
@@ -644,6 +666,9 @@ async function scaffold(root, options, detected, skipPrompts) {
     writeFile(join2(root, "TASKS.md"), tasksMd),
     writeFile(settingsPath, JSON.stringify(mergedSettings, null, 2) + "\n")
   ];
+  if (!hasBacklog) {
+    writes.push(writeFile(backlogPath, backlogMd));
+  }
   if (!hasClaudeignore) {
     writes.push(writeFile(claudeignorePath, claudeignore));
   }
@@ -665,6 +690,7 @@ async function scaffold(root, options, detected, skipPrompts) {
   await Promise.all(writes);
   log.success("Generated CLAUDE.md");
   log.success("Generated TASKS.md");
+  if (!hasBacklog) log.success("Generated BACKLOG.md");
   log.success("Generated .claude/settings.json (schema, permissions, hooks)");
   if (!hasClaudeGitignore) log.success("Generated .claude/.gitignore");
   if (!hasClaudeignore) log.success("Generated .claudeignore");
@@ -1099,6 +1125,15 @@ import { homedir as homedir2 } from "os";
 async function analyzeRules(config) {
   const issues = [];
   const projectRoot = config.claudeMdPath ? dirname(config.claudeMdPath) : process.cwd();
+  const hasBacklog = await fileExists(join4(projectRoot, "BACKLOG.md"));
+  if (!hasBacklog) {
+    issues.push({
+      analyzer: "Rules",
+      severity: "low",
+      message: "No BACKLOG.md found \u2014 deferred features get lost in conversation history",
+      fix: "Run `claude-launchpad init` or `doctor --fix` to generate one"
+    });
+  }
   const hasClaudeignore = await fileExists(join4(projectRoot, ".claudeignore"));
   if (!hasClaudeignore) {
     issues.push({
@@ -1507,6 +1542,7 @@ var FIX_TABLE = [
     return addClaudeMdSection(root, "## Stack", content);
   } },
   { analyzer: "Quality", match: "Session Start", fix: (root) => addClaudeMdSection(root, "## Session Start", "- ALWAYS read @TASKS.md first - it tracks progress across sessions\n- Update TASKS.md as you complete work") },
+  { analyzer: "Rules", match: "No BACKLOG.md", fix: (root) => createBacklogMd(root) },
   { analyzer: "Rules", match: "No .claudeignore", fix: (root, detected) => createClaudeignore(root, detected) },
   { analyzer: "Rules", match: "No .claude/rules/", fix: (root) => createStarterRules(root) },
   { analyzer: "Hooks", match: "PostCompact", fix: (root) => addPostCompactHook(root) },
@@ -1712,6 +1748,22 @@ ${content}
   log.success(`Added "${heading}" section to CLAUDE.md`);
   return true;
 }
+async function createBacklogMd(root) {
+  const backlogPath = join5(root, "BACKLOG.md");
+  try {
+    await access4(backlogPath);
+    return false;
+  } catch {
+  }
+  const name = root.split("/").pop() ?? "Project";
+  await writeFile2(backlogPath, `# ${name} \u2014 Backlog
+
+> Features discussed but deferred. Pick up when relevant.
+> Priority: P0 = next sprint, P1 = soon, P2 = when relevant.
+`);
+  log.success("Generated BACKLOG.md");
+  return true;
+}
 async function createClaudeignore(root, detected) {
   const ignorePath = join5(root, ".claudeignore");
   try {
@@ -2644,7 +2696,7 @@ function createMemoryCommand() {
 }
 
 // src/cli.ts
-var program = new Command5().name("claude-launchpad").description("CLI toolkit that makes Claude Code setups measurably good").version("0.9.1", "-v, --version").action(async () => {
+var program = new Command5().name("claude-launchpad").description("CLI toolkit that makes Claude Code setups measurably good").version("0.9.2-dev.0", "-v, --version").action(async () => {
   const hasConfig = await fileExists(join11(process.cwd(), "CLAUDE.md")) || await fileExists(join11(process.cwd(), ".claude", "settings.json"));
   if (hasConfig) {
     await program.commands.find((c) => c.name() === "doctor")?.parseAsync([], { from: "user" });