super-backlog 0.3.1

package/dist/templates/guard-hook.sh

@@ -0,0 +1,25 @@
+# >>> super-backlog guard {{VERSION}} >>>
+# Validates staged backlog/** task files structurally.
+# Escape hatch: git commit --no-verify
+staged=$(git diff --cached --name-only --diff-filter=ACMR -- 'backlog/*' 2>/dev/null || true)
+if [ -n "$staged" ]; then
+  staged="$staged" node --input-type=commonjs -e '
+    const fs = require("fs");
+    const errs = [];
+    for (const f of process.env.staged.split("\n").filter(Boolean)) {
+      if (!/^backlog\/tasks\/.+\.md$/.test(f)) continue;
+      const content = fs.readFileSync(f, "utf8");
+      const fm = /^---\r?\n([\s\S]*?)\r?\n---/.exec(content);
+      if (!fm) { errs.push(`${f}: missing frontmatter (use the backlog CLI)`); continue; }
+      const get = (n) => { const m = new RegExp("^" + n + ":\\s*(.*?)\\s*$", "m").exec(fm[1]); return m ? m[1].replace(/^["\x27]|["\x27]$/g, "") : null; };
+      const id = get("id"), title = get("title");
+      const stem = f.replace(/^backlog\/tasks\//, "").replace(/\.md$/, "");
+      const base = stem.includes(" - ") ? stem.split(" - ")[0] : stem;
+      if (!id) errs.push(`${f}: missing id`);
+      else if (id.toLowerCase() !== base.toLowerCase()) errs.push(`${f}: id ${id} != filename stem ${base}`);
+      if (!title) errs.push(`${f}: empty title`);
+    }
+    if (errs.length) { console.error("super-backlog guard rejected this commit:\n" + errs.map(e => "  - " + e).join("\n") + "\nBypass: git commit --no-verify"); process.exit(1); }
+  ' || exit 1
+fi
+# <<< super-backlog guard <<<

package/dist/templates/skill-backlog-status-report.md

@@ -0,0 +1,31 @@
+---
+name: backlog-status-report
+description: Summarize current project state from Backlog.md (task counts, in-progress work, milestones) and point to the Project Dashboard. Use when the user asks for status, progress, or a project overview.
+---
+
+# Backlog Status Report: project state at a glance
+
+Read-only summary of the Backlog.md data in this project.
+
+## When this skill runs
+
+- The user asks for status, progress, or an overview ("where are we?").
+- Before or after a work session, to orient.
+
+## Procedure
+
+1. Read `backlog instructions overview` if not already loaded this session.
+2. Collect data: `backlog task list --json` plus milestones via the backlog CLI.
+3. Report compactly in chat:
+   - Counts per status (To Do / In Progress / Done)
+   - Every In Progress task: ID, title, open acceptance criteria
+   - Milestones with done/total
+   - Blocked or stale items worth flagging
+4. Point to the visual surfaces: `sbl dashboard --serve` (live dashboard) or
+   `backlog browser` (interactive Kanban).
+
+## Boundaries
+
+- Strictly read-only: never change task status, never edit tasks.
+- Never guess state from memory — always read fresh CLI output.
+- Keep the report short; link details instead of pasting them.

package/dist/templates/skill-spec-to-backlog.md

@@ -0,0 +1,32 @@
+---
+name: spec-to-backlog
+description: Convert an approved design/implementation plan (from brainstorming/writing-plans) into reviewed Backlog.md tasks with acceptance criteria, milestones and dependencies. Use after a design is approved, when the user asks to decompose work into tasks, or before starting planned work in this project.
+---
+
+# Spec → Backlog: turn plan units into tracked tasks
+
+Bridge between Superpowers (brainstorming, writing-plans) and Backlog.md.
+
+## When this skill runs
+
+1. After an approved design doc (end of brainstorming), BEFORE implementing.
+2. After writing-plans, to materialize plan units as tasks.
+3. When the user asks to split work into tasks.
+
+## Procedure
+
+1. Read `backlog instructions overview` and `backlog instructions task-creation` first.
+2. Decompose: every plan unit becomes ONE task, small enough for one session/PR.
+3. Create per task:
+   backlog task create "Title" -d "<goal/context>" --ac "<criterion 1>" --ac "<criterion 2>" --type feature --label feature --ref "<path/to/plan-doc>"
+   - Dependencies: --dep TASK-y (order follows the plan).
+   - Larger efforts: backlog milestone add `"<Name>"`, attach via -m.
+   - Reference the plan doc via --ref; NEVER copy it into the task.
+4. Never set --plan or --notes at create time — those belong to the "task started" checkpoint after codebase research.
+5. STOP at the review gate: the human reviews specs and acceptance criteria (backlog board / backlog browser / dashboard.html) before any code exists.
+
+## Boundaries
+
+- Never hand-edit task markdown; use the backlog CLI exclusively.
+- No code, no worktrees, no status changes inside this skill.
+- Project-specific human-gate topics get their own tasks with an explicit review gate.

package/dist/templates/skill-task-review-gate.md

@@ -0,0 +1,30 @@
+---
+name: task-review-gate
+description: Enforce the human review checkpoint before implementation starts. Use after tasks were created from a plan, or when the user asks to implement a specific task, to present the task and its acceptance criteria and wait for explicit approval before any code.
+---
+
+# Task Review Gate: no code before an explicit yes
+
+Human checkpoint between reviewed specs and the first line of code.
+
+## When this skill runs
+
+1. Right after spec-to-backlog created tasks (review specs + acceptance criteria).
+2. When the user asks to implement a specific task (restate scope before starting).
+
+## Procedure
+
+1. Load the task: `backlog task view <ID> --plain`.
+2. Present compactly: goal, every acceptance criterion, dependencies, and the
+   recorded plan if one exists.
+3. STOP and wait for the user's explicit approval. Silence or a topic change
+   is NOT approval.
+4. Only after approval: set the task In Progress via the backlog CLI and start
+   with a plan-before-code pass if no plan is recorded yet.
+
+## Boundaries
+
+- Never approve the gate yourself; vague consent is not approval.
+- Trivial edits stay exempt only on explicit user instruction.
+- If acceptance criteria look wrong or incomplete, send the user back to task
+  editing instead of starting.

package/dist/templates/workflow-block.md

@@ -0,0 +1,31 @@
+## Workflow system
+
+This section is managed by super-backlog {{VERSION}}.
+
+**Roles:** Backlog.md = WHAT — specs, acceptance criteria, status and history,
+managed exclusively through the `backlog` CLI. Superpowers = HOW — the
+methodology skills that decide how the work is done.
+
+### Pipeline (follow in order)
+
+| # | Phase | Gate to pass |
+|---|-------|--------------|
+| 1 | Idea | User states a need; capture it before doing anything else |
+| 2 | Brainstorming | Explore intent, requirements and design before any creative work |
+| 3 | Design gate | Human approves the design document |
+| 4 | Spec-to-backlog | Decompose the approved design into reviewed tasks with acceptance criteria |
+| 5 | Review gate | Human reviews specs and acceptance criteria before any code exists |
+| 6 | Plan-before-code | A written implementation plan is approved by the human |
+| 7 | TDD implementation | Failing test first, then code; one task per session/PR |
+| 8 | Verification & final summary | Run tests/lint/typecheck; verification evidence before success claims |
+| 9 | Merge & archive | Merge the branch, then close/archive the task via the backlog CLI |
+
+### Binding rules
+
+1. No task, no code — trivial edits only on explicit user instruction.
+2. Plan before code — implementation starts only after an approved written plan.
+3. Task status changes always go through the CLI backed by verification evidence, never from memory.
+4. Skills take precedence over habit whenever a matching skill exists.
+
+Project-specific human gates are intentionally out of scope for this block.
+Add project-specific human gates below the block.

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "super-backlog",
+  "version": "0.3.1",
+  "description": "One command to equip any project with Backlog.md + Superpowers, plus a Project Dashboard.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/adam-s-k-i/super-backlog"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "bin": {
+    "sbl": "dist/cli.js",
+    "super-backlog": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json && node scripts/copy-templates.mjs",
+    "pretest": "npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "markdownlint-cli2 \"**/*.md\" && cspell --no-progress --no-summary \"**/*.md\"",
+    "tasks": "backlog task list",
+    "board": "backlog board",
+    "browser": "backlog browser",
+    "dashboard": "super-backlog dashboard"
+  },
+  "devDependencies": {
+    "@types/node": "^26.2.0",
+    "backlog.md": "^1.50.1",
+    "cspell": "^10.1.1",
+    "markdownlint-cli2": "^0.23.2",
+    "super-backlog": "file:.",
+    "typescript": "^7.0.2",
+    "vitepress": "^1.6.4",
+    "vitest": "^4.1.11"
+  }
+}