claude-launchpad 1.9.0 → 1.10.0

package/dist/{chunk-RCYLZUU6.js → chunk-5KQ2JDZN.js}

@@ -32,20 +32,20 @@ async function readJsonOrNull(path) {
 }
 
 // src/lib/settings.ts
-import { readFile as readFile4, writeFile as writeFile4, mkdir as mkdir3 } from "fs/promises";
-import { join as join6 } from "path";
+import { readFile as readFile5, writeFile as writeFile5, mkdir as mkdir4 } from "fs/promises";
+import { join as join7 } from "path";
 
 // src/lib/output.ts
 import chalk from "chalk";
 
 // src/commands/doctor/fixer.ts
-import { readFile as readFile3, writeFile as writeFile3, mkdir as mkdir2, access as access2 } from "fs/promises";
-import { join as join5 } from "path";
+import { readFile as readFile4, writeFile as writeFile4, mkdir as mkdir3, access as access2 } from "fs/promises";
+import { join as join6 } from "path";
 import { homedir } from "os";
 
 // src/lib/sections.ts
 var SESSION_START_CONTENT = "- ALWAYS read @TASKS.md first \u2014 it tracks progress across sessions\n- Check the Session Log at the bottom of TASKS.md for where we left off\n- Update TASKS.md as you complete work";
-var BACKLOG_CONTENT = "- When a feature is discussed but deferred, add it to BACKLOG.md immediately\n- Never leave future ideas only in TASKS.md or conversation \u2014 they get lost\n- BACKLOG.md is the single source of truth for parked features";
+var BACKLOG_CONTENT = "- When a feature is discussed but deferred, add it to BACKLOG.md immediately\n- Never leave future ideas only in TASKS.md or conversation \u2014 they get lost\n- BACKLOG.md is the single source of truth for parked features\n- Every WP uses the 7-field template in BACKLOG.md \u2014 no freeform entries\n- Pull a WP into a sprint = **move**, not copy. A WP lives in exactly one file at a time";
 var STOP_AND_SWARM_CONTENT = "Three failed iterations on the same problem = stop iterating alone.\nOn the fourth attempt, spin up at least 3 parallel agents via the Agent tool, each investigating from a different angle:\n1. Root-cause debug agent\n2. Upstream library/docs research agent\n3. Alternative architecture agent\nWait for all agents to return, synthesize their findings, then act.\nDon't keep guessing in circles \u2014 rotate perspectives.";
 var OFF_LIMITS_CONTENT = "- Never hardcode secrets \u2014 use environment variables\n- Never write to `.env` files\n- Never expose internal error details in API responses";
 var SKILL_AUTHORING_CONTENT = 'When creating Claude Code skills (.claude/skills/*/SKILL.md):\n\n- Keep SKILL.md under 500 lines \u2014 move reference material to supporting files in the same directory\n- Front-load description (first 250 chars shown in listings) with TRIGGER when / DO NOT TRIGGER when clauses\n- Add allowed-tools in frontmatter to restrict tool access (e.g. Read, Glob, Grep for read-only skills)\n- Add argument-hint in frontmatter showing the expected input format (use $ARGUMENTS or $0, $1 for dynamic input)\n- Set disable-model-invocation: true for skills with side effects (deploy, send messages)\n- Structure as phases: Research, Plan, Execute, Verify with "Done when:" success criteria per phase\n- Handle edge cases and preconditions before execution';
@@ -350,7 +350,7 @@ DerivedData/
 }
 
 // src/commands/init/generators/skill-enhance.ts
-var ENHANCE_SKILL_VERSION = 8;
+var ENHANCE_SKILL_VERSION = 9;
 function generateEnhanceSkill() {
   return [
     "---",
@@ -392,7 +392,7 @@ function generateEnhanceSkill() {
     "2. **## Architecture** - 3-5 bullets describing codebase shape",
     "3. **## Conventions** - max 8 key patterns. Overflow to .claude/rules/conventions.md",
     "4. **## Off-Limits** - max 8 guardrails specific to this project",
-    "5. **## Memory** - ONLY if agentic-memory is configured in settings.json. Max 6 bullets.",
+    "5. **## Memory (agentic-memory)** - ONLY if agentic-memory is configured in settings.json. Max 6 bullets. Use this exact heading so `memory install` stays idempotent.",
     "6. **## Key Decisions** - only decisions that affect how Claude works in this codebase",
     "",
     "7. **Skill Authoring** - if .claude/rules/conventions.md lacks a Skill Authoring section, plan to add one",
@@ -557,6 +557,88 @@ function generateEnhanceSkill() {
   ].join("\n");
 }
 
+// src/commands/init/generators/backlog.ts
+function generateBacklogMd(options) {
+  const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+  return `# ${options.name} \u2014 Backlog
+
+> **Single source of truth for future work.** Every work package (WP) that's been proposed but not yet started lives here.
+>
+> Rules (see \`.claude/rules/workflow.md\` for the full lifecycle):
+> - Every WP uses the template below \u2014 no freeform entries.
+> - WPs are **moved** to \`TASKS.md\` when pulled into a sprint, not copied. A WP lives in exactly one file at a time.
+> - Priority ordering: **P0 > P1 > P2 > P3**. P0 items sit at the top.
+> - A WP ID is minted when the WP is first added here and never reused.
+
+---
+
+## Priority definitions
+
+| Priority | Meaning |
+|---|---|
+| **P0** | Blocks launch or an active sprint. Next sprint or sooner. |
+| **P1** | Important for MVP. Pulled within 2\u20133 sprints. |
+| **P2** | Post-MVP or nice-to-have. Review monthly. |
+| **P3** | Parked idea. Review quarterly; delete if still untouched. |
+
+---
+
+## Work package template (copy this exactly)
+
+\`\`\`markdown
+### WP-NNN \u2014 <short imperative title>
+
+- **Priority:** P0 | P1 | P2 | P3
+- **Proposed:** YYYY-MM-DD
+- **Stories / Docs:** links to specs, issues, or "none yet"
+- **Depends on:** WP-MMM (empty if none)
+- **Estimate:** XS (<1h) | S (half-day) | M (1\u20132 days) | L (full sprint) | XL (>1 sprint; must decompose)
+- **Trigger to pull:** What has to be true before this moves into a sprint.
+- **Definition of done:** Exactly what "done" looks like.
+
+One-paragraph description. Context, rationale, rough approach if known. Keep it tight.
+\`\`\`
+
+**Hard rules for entries:**
+- Title is an imperative ("Add referral banner", "Wire up StoreKit upgrade flow") \u2014 not a noun.
+- \`Trigger to pull\` and \`Definition of done\` are mandatory. A WP without either is incomplete.
+- \`XL\` estimates must be broken into multiple WPs before pulling into a sprint.
+- WP IDs are minted on first entry and never reused. Check the Changelog below for the highest ID before adding a new one.
+
+---
+
+## P0 \u2014 Next sprint
+
+<!-- Empty. WPs appear here when promoted from P1, or when a new blocker surfaces. -->
+
+---
+
+## P1 \u2014 Soon (within 2\u20133 sprints)
+
+<!-- Empty. Add WPs here as sprints approach. -->
+
+---
+
+## P2 \u2014 Post-MVP / nice-to-have
+
+<!-- Empty. Review monthly. -->
+
+---
+
+## P3 \u2014 Parked
+
+<!-- Empty. Move P2 items here if they survive 2 quarterly reviews without being pulled. -->
+
+---
+
+## Changelog
+
+Capture WP promotions, demotions, and deletions so you can audit backlog drift.
+
+- ${today}: Backlog established.
+`;
+}
+
 // src/lib/memory-placement.ts
 import { select } from "@inquirer/prompts";
 function hasMemoryPermissions(settings) {
@@ -705,6 +787,55 @@ if [ "$backlog_deletions" -eq 0 ]; then
   echo ""
 fi
 
+exit 0
+`;
+var WORKFLOW_CHECK = `#!/usr/bin/env bash
+# Warns on BACKLOG.md / TASKS.md drift. Non-blocking (always exits 0).
+#   1. Same WP ID present in BOTH BACKLOG.md and TASKS.md (violates move-not-copy).
+#   2. TASKS.md longer than 80 lines.
+#   3. \\\`## Current Sprint\\\` contains more than 15 items.
+#   4. \\\`## Session Log\\\` has more than 3 entries.
+
+set -u
+fp="\${TOOL_INPUT_FILE_PATH:-}"
+
+# Only act on edits to BACKLOG.md or TASKS.md.
+echo "$fp" | grep -qE '(^|/)(BACKLOG|TASKS)\\.md$' || exit 0
+
+warn() { printf '%s\\n' "$*"; }
+
+# 1. Duplicate WP IDs across both files.
+if [ -f BACKLOG.md ] && [ -f TASKS.md ]; then
+  dupes=$(grep -oE 'WP-[0-9]{3}' BACKLOG.md 2>/dev/null | sort -u | while read -r wp; do
+    grep -q "$wp" TASKS.md 2>/dev/null && echo "$wp"
+  done)
+  if [ -n "$dupes" ]; then
+    warn "Workflow bug: WP ID present in BOTH BACKLOG.md and TASKS.md (violates move-not-copy \u2014 see .claude/rules/workflow.md):"
+    printf '%s\\n' "$dupes"
+    warn "Move each listed WP to exactly one file."
+  fi
+fi
+
+# 2. TASKS.md length.
+if [ -f TASKS.md ]; then
+  tasks_lines=$(wc -l < TASKS.md 2>/dev/null | tr -d ' ')
+  if [ "\${tasks_lines:-0}" -gt 80 ]; then
+    warn "TASKS.md is $tasks_lines lines \u2014 should stay under 80. Prune Completed Sprints or Session Log."
+  fi
+
+  # 3. Current Sprint size.
+  current_count=$(awk '/^## Current/{flag=1; next} /^## /{flag=0} flag' TASKS.md 2>/dev/null | grep -cE '^[[:space:]]*- \\[[ x]\\]' || true)
+  if [ "\${current_count:-0}" -gt 15 ]; then
+    warn "## Current Sprint has $current_count items \u2014 split the sprint (see .claude/rules/workflow.md)."
+  fi
+
+  # 4. Session Log size.
+  log_count=$(awk '/^## Session Log/{flag=1; next} /^## /{flag=0} flag' TASKS.md 2>/dev/null | grep -cE '^- \\*\\*' || true)
+  if [ "\${log_count:-0}" -gt 3 ]; then
+    warn "## Session Log has $log_count entries \u2014 keep to 3 max."
+  fi
+fi
+
 exit 0
 `;
 async function writeSprintHygieneScripts(root) {
@@ -718,6 +849,14 @@ async function writeSprintHygieneScripts(root) {
   await chmod(openPath, 493);
   return { sizePath, openPath };
 }
+async function writeWorkflowCheckScript(root) {
+  const hooksDir = join2(root, ".claude", "hooks");
+  await mkdir(hooksDir, { recursive: true });
+  const scriptPath = join2(hooksDir, "workflow-check.sh");
+  await writeFile(scriptPath, WORKFLOW_CHECK);
+  await chmod(scriptPath, 493);
+  return scriptPath;
+}
 
 // src/commands/doctor/fixer-sprint.ts
 var WORKTREE_INCLUDE_TEMPLATE = `# Files copied into git worktrees that Claude Code creates for subagents.
@@ -758,6 +897,211 @@ async function addSprintCompleteNudge(root) {
     }]
   }, "Added sprint-complete nudge hook");
 }
+async function addWorkflowCheckHook(root) {
+  await writeWorkflowCheckScript(root);
+  return addHookToSettings(root, "PostToolUse", "workflow-check.sh", {
+    matcher: "Edit|Write",
+    hooks: [{ type: "command", command: "bash .claude/hooks/workflow-check.sh 2>/dev/null; exit 0" }]
+  }, "Added workflow-check hook (BACKLOG/TASKS staleness warnings)");
+}
+
+// src/commands/doctor/fixer-quality.ts
+import { readFile as readFile2, writeFile as writeFile3, mkdir as mkdir2 } from "fs/promises";
+import { join as join4 } from "path";
+
+// src/commands/init/generators/workflow-rule.ts
+var WORKFLOW_RULE_VERSION = 1;
+function generateWorkflowRule() {
+  return `---
+paths: ["BACKLOG.md", "TASKS.md"]
+---
+
+# Backlog \u2192 Tasks \u2192 Sprint Workflow Rules
+
+<!-- lp-workflow-version: ${WORKFLOW_RULE_VERSION} -->
+
+These rules apply whenever editing \`BACKLOG.md\` or \`TASKS.md\`. The workflow is load-bearing \u2014 drift here breaks sprint integrity.
+
+## The single rule that makes everything else work
+
+**A work package (WP) lives in exactly one of \`BACKLOG.md\` or \`TASKS.md\` at any time.**
+
+- Pulled into a sprint \u2192 move (delete from BACKLOG.md, add to TASKS.md under \`## Current Sprint\`) in a single edit.
+- Sprint closed \u2192 the WP leaves TASKS.md entirely (summarized into \`## Completed Sprints\`) and does not return to the backlog.
+- A WP ID appearing in both files at once = bug. A PostToolUse hook warns.
+
+## WP IDs
+
+- Format: \`WP-NNN\` (three digits, zero-padded).
+- Minted on first entry to \`BACKLOG.md\`.
+- Never reused, never renamed.
+- Highest-used ID lives at the end of \`BACKLOG.md ## Changelog\` \u2014 check there before minting a new one.
+
+## BACKLOG.md structure (mandatory sections, in order)
+
+1. Header + rules comment block
+2. \`## Priority definitions\` table
+3. \`## Work package template\` (the canonical format)
+4. \`## P0 \u2014 Next sprint\`
+5. \`## P1 \u2014 Soon (within 2\u20133 sprints)\`
+6. \`## P2 \u2014 Post-MVP / nice-to-have\`
+7. \`## P3 \u2014 Parked\`
+8. \`## Changelog\`
+
+### Every WP entry must include
+
+- \`Priority:\` exactly one of P0/P1/P2/P3
+- \`Proposed:\` ISO date (YYYY-MM-DD)
+- \`Stories / Docs:\` spec references, issues, or empty
+- \`Depends on:\` WP IDs or empty
+- \`Estimate:\` one of XS/S/M/L/XL (XL must be decomposed before pulling)
+- \`Trigger to pull:\` what event promotes this to an active sprint
+- \`Definition of done:\` concrete acceptance criteria
+- One-paragraph description
+
+### Priority discipline
+
+- P0 items are for the next sprint. If P0 is empty at sprint start, pull the top P1.
+- P1 \u2192 P0 promotion happens during sprint wrap-up, not mid-sprint.
+- P2 items get a monthly review. P3 items get a quarterly review and are deleted if still untouched.
+- Stale P0 items (>2 weeks without movement) are a flag: either pull or demote.
+
+### Changelog discipline
+
+- Every WP promotion, demotion, or deletion gets a one-line entry with the date.
+- A backlog audit that finds no changelog entries for 30+ days = staleness; force a review.
+
+## TASKS.md structure (mandatory sections, in order)
+
+1. Header + rules comment
+2. \`## Current Sprint\`
+3. \`## Completed Sprints\`
+4. \`## Session Log\`
+
+### \`## Current Sprint\` discipline
+
+- Contains ONLY the active sprint's WPs. Empty between sprints.
+- Format: \`- [ ] WP-NNN \u2014 short title\` (checkbox + WP ID + title from backlog).
+- Each pulled WP becomes one checklist item. Sub-tasks nest with two-space indent, still checkbox.
+- New ideas that surface mid-sprint go to \`BACKLOG.md\`, never appended here.
+
+### \`## Completed Sprints\` discipline
+
+- One line per sprint. Format: \`- **SN**: one-sentence outcome + key metric if any.\`
+- Never a wall of text. Detail lives in git history (or your review file).
+
+### \`## Session Log\` discipline
+
+- Max 3 entries, most recent 3 sessions only.
+- Each entry: \`- **YYYY-MM-DD (optional window):** what changed this session + what's next.\`
+- Older entries deleted, not archived \u2014 they're in git history if needed.
+
+### Size discipline
+
+- Whole file stays under 80 lines.
+- If \`## Current Sprint\` exceeds 15 checkboxes, the sprint is too big \u2014 split it (move some WPs back to \`BACKLOG.md\` P0).
+
+## Sprint lifecycle (the exact edit sequence)
+
+### Starting a sprint (one session, one commit)
+
+1. Pick top-priority WPs from \`BACKLOG.md\` (P0 first).
+2. **Same edit:** delete them from \`BACKLOG.md\`, add them to \`TASKS.md ## Current Sprint\`.
+3. Update \`BACKLOG.md ## Changelog\`: \`YYYY-MM-DD: WP-NNN pulled into Sprint SN\`.
+4. Write the sprint plan (outline approach, success criteria, tests to add).
+5. For hard-TDD surfaces, write the test spec **before** implementation.
+6. Commit the pull + plan together: \`chore(sprint-N): pull WP-NNN into sprint + plan\`.
+
+### Closing a sprint (one session, one commit)
+
+1. All \`## Current Sprint\` items checked off, or explicitly moved back to backlog with rationale.
+2. Run your review workflow \u2014 verify typecheck, tests, and convention compliance before declaring done.
+3. Add one-line summary to \`## Completed Sprints\`.
+4. Empty \`## Current Sprint\` back to the placeholder comment.
+5. Update \`## Session Log\` (prune to 3 entries).
+6. \`BACKLOG.md ## Changelog\`: \`YYYY-MM-DD: Sprint SN closed. WP-NNN done.\`
+
+## What triggers a staleness warning
+
+A PostToolUse hook fires warnings on these conditions (treat as bugs):
+
+- A WP ID appears in both \`BACKLOG.md\` and \`TASKS.md\`.
+- \`TASKS.md\` exceeds 80 lines.
+- \`## Current Sprint\` has >15 items.
+- \`## Session Log\` has >3 entries.
+
+## Do not
+
+- Don't append to \`TASKS.md\` without first checking \`BACKLOG.md\` for the WP \u2014 silent duplication breaks the source-of-truth rule.
+- Don't leave \`## Current Sprint\` populated between sprints. An empty sprint section is how you know the last sprint closed cleanly.
+- Don't invent ad-hoc WP formats. Use the template or update the template \u2014 never both.
+- Don't rewrite \`## Completed Sprints\` into prose. One line each. Forever.
+- Don't put anything in \`TASKS.md\` that hasn't passed through \`BACKLOG.md\` first. Ideas \u2192 backlog \u2192 sprint. No shortcuts.
+`;
+}
+
+// src/commands/doctor/fixer-quality.ts
+async function createWorkflowRule(root) {
+  const rulesDir = join4(root, ".claude", "rules");
+  const workflowPath = join4(rulesDir, "workflow.md");
+  if (await fileExists(workflowPath)) return false;
+  await mkdir2(rulesDir, { recursive: true });
+  await writeFile3(workflowPath, generateWorkflowRule());
+  log.success("Created .claude/rules/workflow.md (path-scoped BACKLOG/TASKS workflow rules)");
+  return true;
+}
+function isMemoryHeading(line) {
+  return /^## Memory( \(agentic-memory\))?\s*$/.test(line);
+}
+function findMemoryBlocks(lines) {
+  const blocks = [];
+  for (let i = 0; i < lines.length; i++) {
+    if (!isMemoryHeading(lines[i])) continue;
+    let end = lines.length;
+    for (let j = i + 1; j < lines.length; j++) {
+      if (/^## /.test(lines[j])) {
+        end = j;
+        break;
+      }
+    }
+    blocks.push({ startIdx: i, endIdx: end, tagged: lines[i].includes("(agentic-memory)") });
+    i = end - 1;
+  }
+  return blocks;
+}
+async function collapseMemoryHeadings(root) {
+  const claudeMdPath = join4(root, "CLAUDE.md");
+  let content;
+  try {
+    content = await readFile2(claudeMdPath, "utf-8");
+  } catch {
+    return false;
+  }
+  const lines = content.split("\n");
+  const blocks = findMemoryBlocks(lines);
+  if (blocks.length <= 1) return false;
+  const keeper = blocks.find((b) => b.tagged) ?? blocks[0];
+  const droppedByStart = new Map(
+    blocks.filter((b) => b !== keeper).map((b) => [b.startIdx, b])
+  );
+  const kept = [];
+  let skipUntil = -1;
+  for (let i = 0; i < lines.length; i++) {
+    if (i < skipUntil) continue;
+    const dropped = droppedByStart.get(i);
+    if (dropped) {
+      skipUntil = dropped.endIdx;
+      continue;
+    }
+    kept.push(lines[i]);
+  }
+  const canonical = kept.map(
+    (line) => /^## Memory\s*$/.test(line) ? "## Memory (agentic-memory)" : line
+  );
+  await writeFile3(claudeMdPath, canonical.join("\n"));
+  log.success(`Collapsed ${blocks.length - 1} duplicate ## Memory section(s) in CLAUDE.md`);
+  return true;
+}
 
 // src/commands/doctor/fixer-hooks.ts
 var FORMATTERS = {
@@ -814,8 +1158,8 @@ async function addSessionStartHook(root) {
 }
 
 // src/commands/doctor/fixer-memory.ts
-import { readFile as readFile2 } from "fs/promises";
-import { join as join4 } from "path";
+import { readFile as readFile3 } from "fs/promises";
+import { join as join5 } from "path";
 async function addPlacementHook(root, placement, event, dedupKeyword, entry, prepend, successMsg) {
   const read = placement === "local" ? readSettingsLocalJson : readSettingsJson;
   const write = placement === "local" ? writeSettingsLocalJson : writeSettingsJson;
@@ -969,9 +1313,9 @@ async function addAllowedMcpServers(root, placement) {
   if (settingsServers && typeof settingsServers === "object") {
     for (const name of Object.keys(settingsServers)) serverNames.add(name);
   }
-  const mcpJsonPath = join4(root, ".mcp.json");
+  const mcpJsonPath = join5(root, ".mcp.json");
   try {
-    const mcpJson = JSON.parse(await readFile2(mcpJsonPath, "utf-8"));
+    const mcpJson = JSON.parse(await readFile3(mcpJsonPath, "utf-8"));
     const mcpServers = mcpJson.mcpServers;
     if (mcpServers && typeof mcpServers === "object") {
       for (const name of Object.keys(mcpServers)) serverNames.add(name);
@@ -1032,8 +1376,10 @@ var FIX_TABLE = [
   { analyzer: "Quality", match: "Session Start", fix: (root) => addClaudeMdSection(root, "## Session Start", wrapStub(SESSION_START_CONTENT)) },
   { analyzer: "Quality", match: "Backlog", fix: (root) => addClaudeMdSection(root, "## Backlog", wrapStub(BACKLOG_CONTENT)) },
   { analyzer: "Quality", match: "Stop-and-Swarm", fix: (root) => addClaudeMdSection(root, "## Stop-and-Swarm", wrapStub(STOP_AND_SWARM_CONTENT)) },
+  { analyzer: "Quality", match: "Duplicate ## Memory", fix: (root) => collapseMemoryHeadings(root) },
   { 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/workflow.md", fix: (root) => createWorkflowRule(root) },
   { analyzer: "Rules", match: "No .claude/rules/", fix: (root) => createStarterRules(root) },
   { analyzer: "Hooks", match: "PostCompact", fix: (root) => addPostCompactHook(root) },
   { analyzer: "Permissions", match: "force-push", fix: (root) => addForcePushProtection(root) },
@@ -1045,6 +1391,7 @@ var FIX_TABLE = [
   { analyzer: "Hooks", match: "sprint-size-check", fix: (root) => addSprintSizeHook(root) },
   { analyzer: "Hooks", match: "sprint-open-check", fix: (root) => addSprintOpenHook(root) },
   { analyzer: "Hooks", match: "sprint-complete nudge", fix: (root) => addSprintCompleteNudge(root) },
+  { analyzer: "Hooks", match: "workflow-check.sh", fix: (root) => addWorkflowCheckHook(root) },
   { analyzer: "Rules", match: "No skill authoring conventions", fix: (root) => addSkillAuthoringConventions(root) },
   { analyzer: "Rules", match: "No /lp-enhance skill", fix: (root) => createEnhanceSkill(root) },
   { analyzer: "Rules", match: "lp-enhance skill is outdated", fix: (root) => updateEnhanceSkill(root) },
@@ -1060,7 +1407,7 @@ var FIX_TABLE = [
   { analyzer: "Memory", match: "SessionEnd push hook is not nohup-wrapped", fix: (root) => upgradeStaleSessionEndPushHook(root) },
   { analyzer: "Memory", match: "CLAUDE.md missing memory guidance", fix: (root, _det, placement) => {
     const content = "Use agentic-memory to persist knowledge across sessions:\n- Memories are automatically injected at session start\n- STORE IMMEDIATELY when: a dependency strategy changes, an architecture decision is made, a convention is established, a bug pattern is discovered, or a feature is killed/added\n- Use memory_search before memory_store to check for duplicates\n- NEVER store credentials, API keys, tokens, or secrets in memories";
-    const target = placement === "local" ? join5(root, ".claude", "CLAUDE.md") : void 0;
+    const target = placement === "local" ? join6(root, ".claude", "CLAUDE.md") : void 0;
     return addClaudeMdSection(root, "## Memory", wrapStub(content), target);
   } }
 ];
@@ -1117,27 +1464,27 @@ async function removeSandboxSettings(root) {
   return true;
 }
 async function addEnvToClaudeignore(root) {
-  const ignorePath = join5(root, ".claudeignore");
+  const ignorePath = join6(root, ".claudeignore");
   let content;
   try {
-    content = await readFile3(ignorePath, "utf-8");
+    content = await readFile4(ignorePath, "utf-8");
   } catch {
     return false;
   }
   const lines = content.split("\n").map((l) => l.trim());
   if (lines.some((l) => l === ".env" || l === ".env.*" || l === ".env*")) return false;
-  await writeFile3(ignorePath, content.trimEnd() + "\n.env\n.env.*\n");
+  await writeFile4(ignorePath, content.trimEnd() + "\n.env\n.env.*\n");
   log.success("Added .env to .claudeignore");
   return true;
 }
 async function addClaudeMdSection(root, heading, content, targetPath) {
-  const claudeMdPath = targetPath ?? join5(root, "CLAUDE.md");
+  const claudeMdPath = targetPath ?? join6(root, "CLAUDE.md");
   let existing;
   try {
-    existing = await readFile3(claudeMdPath, "utf-8");
+    existing = await readFile4(claudeMdPath, "utf-8");
   } catch {
     if (!targetPath) return false;
-    await mkdir2(join5(root, ".claude"), { recursive: true });
+    await mkdir3(join6(root, ".claude"), { recursive: true });
     existing = "# Local Claude Config\n";
   }
   if (existing.includes(heading)) return false;
@@ -1149,36 +1496,32 @@ ${content}
 
 `;
   const updated = existing.slice(0, insertAt) + section + existing.slice(insertAt);
-  await writeFile3(claudeMdPath, updated);
+  await writeFile4(claudeMdPath, updated);
   const label = targetPath ? ".claude/CLAUDE.md" : "CLAUDE.md";
   log.success(`Added "${heading}" section to ${label}`);
   return true;
 }
 async function createBacklogMd(root) {
-  const backlogPath = join5(root, "BACKLOG.md");
+  const backlogPath = join6(root, "BACKLOG.md");
   try {
     await access2(backlogPath);
     return false;
   } catch {
   }
   const name = root.split("/").pop() ?? "Project";
-  await writeFile3(backlogPath, `# ${name} - Backlog
-
-> Features discussed but deferred. Pick up when relevant.
-> Priority: P0 = next sprint, P1 = soon, P2 = when relevant.
-`);
-  log.success("Generated BACKLOG.md");
+  await writeFile4(backlogPath, generateBacklogMd({ name, description: "" }));
+  log.success("Generated BACKLOG.md (WP template + P0\u2013P3 sections + changelog)");
   return true;
 }
 async function createClaudeignore(root, detected) {
-  const ignorePath = join5(root, ".claudeignore");
+  const ignorePath = join6(root, ".claudeignore");
   try {
     await access2(ignorePath);
     return false;
   } catch {
   }
   const content = generateClaudeignore(detected);
-  await writeFile3(ignorePath, content);
+  await writeFile4(ignorePath, content);
   log.success("Generated .claudeignore with language-specific ignore patterns");
   return true;
 }
@@ -1188,15 +1531,15 @@ var SKILL_AUTHORING_SECTION = `
 ${SKILL_AUTHORING_CONTENT}
 `;
 async function createStarterRules(root) {
-  const rulesDir = join5(root, ".claude", "rules");
+  const rulesDir = join6(root, ".claude", "rules");
   try {
     await access2(rulesDir);
     return false;
   } catch {
   }
-  await mkdir2(rulesDir, { recursive: true });
-  await writeFile3(
-    join5(rulesDir, "conventions.md"),
+  await mkdir3(rulesDir, { recursive: true });
+  await writeFile4(
+    join6(rulesDir, "conventions.md"),
     `# Project Conventions
 
 - Use conventional commits (feat:, fix:, docs:, refactor:, test:, chore:)
@@ -1209,36 +1552,36 @@ ${SKILL_AUTHORING_SECTION}`
   return true;
 }
 async function addSkillAuthoringConventions(root) {
-  const conventionsPath = join5(root, ".claude", "rules", "conventions.md");
+  const conventionsPath = join6(root, ".claude", "rules", "conventions.md");
   let content;
   try {
-    content = await readFile3(conventionsPath, "utf-8");
+    content = await readFile4(conventionsPath, "utf-8");
   } catch {
     return false;
   }
   if (/^##\s+Skill\s+Authoring/im.test(content)) return false;
-  await writeFile3(conventionsPath, content.trimEnd() + "\n" + SKILL_AUTHORING_SECTION);
+  await writeFile4(conventionsPath, content.trimEnd() + "\n" + SKILL_AUTHORING_SECTION);
   log.success("Added Skill Authoring section to .claude/rules/conventions.md");
   return true;
 }
 async function createEnhanceSkill(root) {
-  const skillDir = join5(root, ".claude", "skills", "lp-enhance");
-  const skillPath = join5(skillDir, "SKILL.md");
-  const globalPath = join5(homedir(), ".claude", "skills", "lp-enhance", "SKILL.md");
-  const legacyProject = join5(root, ".claude", "commands", "lp-enhance.md");
-  const legacyGlobal = join5(homedir(), ".claude", "commands", "lp-enhance.md");
+  const skillDir = join6(root, ".claude", "skills", "lp-enhance");
+  const skillPath = join6(skillDir, "SKILL.md");
+  const globalPath = join6(homedir(), ".claude", "skills", "lp-enhance", "SKILL.md");
+  const legacyProject = join6(root, ".claude", "commands", "lp-enhance.md");
+  const legacyGlobal = join6(homedir(), ".claude", "commands", "lp-enhance.md");
   if (await fileExists(skillPath) || await fileExists(globalPath) || await fileExists(legacyProject) || await fileExists(legacyGlobal)) return false;
-  await mkdir2(skillDir, { recursive: true });
-  await writeFile3(skillPath, generateEnhanceSkill());
+  await mkdir3(skillDir, { recursive: true });
+  await writeFile4(skillPath, generateEnhanceSkill());
   log.success("Generated /lp-enhance skill (.claude/skills/lp-enhance/)");
   return true;
 }
 async function updateEnhanceSkill(root) {
-  const projectPath = join5(root, ".claude", "skills", "lp-enhance", "SKILL.md");
-  const globalPath = join5(homedir(), ".claude", "skills", "lp-enhance", "SKILL.md");
+  const projectPath = join6(root, ".claude", "skills", "lp-enhance", "SKILL.md");
+  const globalPath = join6(homedir(), ".claude", "skills", "lp-enhance", "SKILL.md");
   const targetPath = await fileExists(projectPath) ? projectPath : await fileExists(globalPath) ? globalPath : null;
   if (!targetPath) return false;
-  await writeFile3(targetPath, generateEnhanceSkill());
+  await writeFile4(targetPath, generateEnhanceSkill());
   log.success("Updated /lp-enhance skill to latest version");
   return true;
 }
@@ -1349,7 +1692,7 @@ function renderDoctorReport(results, options) {
 async function readJsonFile(path) {
   let raw;
   try {
-    raw = await readFile4(path, "utf-8");
+    raw = await readFile5(path, "utf-8");
   } catch (err) {
     const code = err.code;
     if (code === "ENOENT") return {};
@@ -1364,20 +1707,20 @@ async function readJsonFile(path) {
   }
 }
 async function readSettingsJson(root) {
-  return readJsonFile(join6(root, ".claude", "settings.json"));
+  return readJsonFile(join7(root, ".claude", "settings.json"));
 }
 async function writeSettingsJson(root, settings) {
-  const dir = join6(root, ".claude");
-  await mkdir3(dir, { recursive: true });
-  await writeFile4(join6(dir, "settings.json"), JSON.stringify(settings, null, 2) + "\n");
+  const dir = join7(root, ".claude");
+  await mkdir4(dir, { recursive: true });
+  await writeFile5(join7(dir, "settings.json"), JSON.stringify(settings, null, 2) + "\n");
 }
 async function readSettingsLocalJson(root) {
-  return readJsonFile(join6(root, ".claude", "settings.local.json"));
+  return readJsonFile(join7(root, ".claude", "settings.local.json"));
 }
 async function writeSettingsLocalJson(root, settings) {
-  const dir = join6(root, ".claude");
-  await mkdir3(dir, { recursive: true });
-  await writeFile4(join6(dir, "settings.local.json"), JSON.stringify(settings, null, 2) + "\n");
+  const dir = join7(root, ".claude");
+  await mkdir4(dir, { recursive: true });
+  await writeFile5(join7(dir, "settings.local.json"), JSON.stringify(settings, null, 2) + "\n");
 }
 
 export {
@@ -1393,6 +1736,7 @@ export {
   generateClaudeignore,
   ENHANCE_SKILL_VERSION,
   generateEnhanceSkill,
+  generateBacklogMd,
   readSettingsJson,
   writeSettingsJson,
   readSettingsLocalJson,
@@ -1401,10 +1745,12 @@ export {
   LP_STUB_OPEN,
   addOrUpdateHook,
   writeSprintHygieneScripts,
+  writeWorkflowCheckScript,
+  generateWorkflowRule,
   applyFixes,
   log,
   printBanner,
   printScoreCard,
   renderDoctorReport
 };
-//# sourceMappingURL=chunk-RCYLZUU6.js.map
+//# sourceMappingURL=chunk-5KQ2JDZN.js.map