@sienklogic/plan-build-run 2.11.0 → 2.12.1

package/plugins/pbr/commands/add-phase.md

@@ -0,0 +1,75 @@
+---
+description: "Add phase to end of current milestone in roadmap"
+argument-hint: "<description>"
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+---
+
+<objective>
+Add a new integer phase to the end of the current milestone in the roadmap.
+
+Handles:
+- Phase number calculation (next sequential integer)
+- Directory creation with slug generation
+- Roadmap structure updates
+- STATE.md roadmap evolution tracking
+</objective>
+
+<context>
+Description: $ARGUMENTS
+
+@.planning/ROADMAP.md
+@.planning/STATE.md
+</context>
+
+<process>
+## 1. Parse Arguments
+
+Extract phase description from $ARGUMENTS. If empty, ask user for a description.
+
+## 2. Validate State
+
+```bash
+node ${CLAUDE_PLUGIN_ROOT}/scripts/pbr-tools.js roadmap analyze
+```
+
+Check that ROADMAP.md exists and has at least one milestone.
+
+## 3. Calculate Next Phase Number
+
+Read ROADMAP.md, find the highest integer phase number in the current milestone, add 1.
+
+## 4. Generate Slug
+
+```bash
+SLUG=$(node ${CLAUDE_PLUGIN_ROOT}/scripts/pbr-tools.js generate-slug "$ARGUMENTS")
+```
+
+## 5. Create Phase Directory and Update Roadmap
+
+```bash
+node ${CLAUDE_PLUGIN_ROOT}/scripts/pbr-tools.js roadmap append-phase --goal "$ARGUMENTS"
+```
+
+Create `.planning/phases/{NN}-{slug}/` directory.
+
+## 6. Update State
+
+```bash
+node ${CLAUDE_PLUGIN_ROOT}/scripts/pbr-tools.js state record-activity "Added phase {NN}: {description}"
+```
+
+## 7. Commit
+
+```bash
+git add .planning/ROADMAP.md .planning/STATE.md .planning/phases/
+git commit -m "docs: add phase {NN} — {slug}"
+```
+
+## 8. Report
+
+Display: "Phase {NN}: {description} added to roadmap."
+Suggest: `/pbr:discuss-phase {NN}` or `/pbr:plan-phase {NN}` as next steps.
+</process>

package/plugins/pbr/commands/add-todo.md

@@ -0,0 +1,8 @@
+---
+description: "Capture idea or task as todo from current conversation context"
+argument-hint: "[optional description]"
+---
+
+This command is provided by the `pbr:todo` skill with subcommand `add`.
+
+Pass arguments as: `add $ARGUMENTS`

package/plugins/pbr/commands/audit-milestone.md

@@ -0,0 +1,8 @@
+---
+description: "Audit milestone completion against original intent before archiving"
+argument-hint: "[version]"
+---
+
+This command is provided by the `pbr:milestone` skill with subcommand `audit`.
+
+Pass arguments as: `audit $ARGUMENTS`

package/plugins/pbr/commands/audit.md

@@ -0,0 +1,5 @@
+---
+description: "Review past Claude Code sessions for PBR workflow compliance and UX quality."
+---
+
+This command is provided by the `pbr:audit` skill.

package/plugins/pbr/commands/autonomous.md

@@ -0,0 +1,5 @@
+---
+description: "Run multiple phases hands-free. Chains discuss, plan, build, and verify automatically."
+---
+
+This command is provided by the `pbr:autonomous` skill.

package/plugins/pbr/commands/begin.md

@@ -2,4 +2,4 @@
 description: "Start a new project. Deep questioning, research, requirements, and roadmap."
 ---
 
-This command is provided by the `dev:begin` skill.
+This command is provided by the `pbr:begin` skill.

package/plugins/pbr/commands/build.md

@@ -2,4 +2,4 @@
 description: "Execute all plans in a phase. Spawns agents to build in parallel, commits atomically."
 ---
 
-This command is provided by the `dev:build` skill.
+This command is provided by the `pbr:build` skill.

package/plugins/pbr/commands/check-todos.md

@@ -0,0 +1,8 @@
+---
+description: "List pending todos and select one to work on"
+argument-hint: "[area filter]"
+---
+
+This command is provided by the `pbr:todo` skill with subcommand `list`.
+
+Pass arguments as: `list $ARGUMENTS`

package/plugins/pbr/commands/complete-milestone.md

@@ -0,0 +1,8 @@
+---
+description: "Archive completed milestone and prepare for next version"
+argument-hint: "<version>"
+---
+
+This command is provided by the `pbr:milestone` skill with subcommand `complete`.
+
+Pass arguments as: `complete $ARGUMENTS`

package/plugins/pbr/commands/config.md

@@ -1,5 +1,5 @@
 ---
-description: "Configure Plan-Build-Run settings. Model selection, workflow toggles, depth, gates, and parallelization."
+description: "Configure settings: depth, model profiles, features, git, and gates."
 ---
 
-This command is provided by the `dev:config` skill.
+This command is provided by the `pbr:config` skill.

package/plugins/pbr/commands/continue.md

@@ -2,4 +2,4 @@
 description: "Execute the next logical step automatically. No prompts, no decisions — just do it."
 ---
 
-This command is provided by the `dev:continue` skill.
+This command is provided by the `pbr:continue` skill.

package/plugins/pbr/commands/dashboard.md

@@ -2,4 +2,4 @@
 description: "Launch the PBR web dashboard for the current project."
 ---
 
-This command is provided by the `dev:dashboard` skill.
+This command is provided by the `pbr:dashboard` skill.

package/plugins/pbr/commands/debug.md

@@ -2,4 +2,4 @@
 description: "Systematic debugging with hypothesis testing. Persistent across sessions."
 ---
 
-This command is provided by the `dev:debug` skill.
+This command is provided by the `pbr:debug` skill.

package/plugins/pbr/commands/discuss-phase.md

@@ -0,0 +1,6 @@
+---
+description: "Gather phase context through adaptive questioning before planning"
+argument-hint: "<phase>"
+---
+
+This command is provided by the `pbr:discuss` skill.

package/plugins/pbr/commands/discuss.md

@@ -2,4 +2,4 @@
 description: "Talk through a phase before planning. Identifies gray areas and captures your decisions."
 ---
 
-This command is provided by the `dev:discuss` skill.
+This command is provided by the `pbr:discuss` skill.

package/plugins/pbr/commands/do.md

@@ -0,0 +1,5 @@
+---
+description: "Route freeform text to the right PBR skill automatically."
+---
+
+This command is provided by the `pbr:do` skill.

package/plugins/pbr/commands/execute-phase.md

@@ -0,0 +1,6 @@
+---
+description: "Execute all plans in a phase with wave-based parallelization"
+argument-hint: "<phase-number> [--gaps-only]"
+---
+
+This command is provided by the `pbr:build` skill.

package/plugins/pbr/commands/explore.md

@@ -2,4 +2,4 @@
 description: "Explore ideas, think through approaches, and route insights to the right artifacts."
 ---
 
-This command is provided by the `dev:explore` skill.
+This command is provided by the `pbr:explore` skill.

package/plugins/pbr/commands/health.md

@@ -2,4 +2,4 @@
 description: "Check planning directory integrity. Find and fix corrupted state."
 ---
 
-This command is provided by the `dev:health` skill.
+This command is provided by the `pbr:health` skill.

package/plugins/pbr/commands/help.md

@@ -2,4 +2,4 @@
 description: "Command reference and workflow guide for Plan-Build-Run."
 ---
 
-This command is provided by the `dev:help` skill.
+This command is provided by the `pbr:help` skill.

package/plugins/pbr/commands/import.md

@@ -1,5 +1,5 @@
 ---
-description: "Import an external plan document. Validates against project context, detects conflicts, and generates PLAN.md files."
+description: "Import external plans. Validates context, detects conflicts, generates PLAN.md."
 ---
 
-This command is provided by the `dev:import` skill.
+This command is provided by the `pbr:import` skill.

package/plugins/pbr/commands/insert-phase.md

@@ -0,0 +1,65 @@
+---
+description: "Insert urgent work as decimal phase (e.g., 72.1) between existing phases"
+argument-hint: "<after> <description>"
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+---
+
+<objective>
+Insert a decimal phase for urgent work discovered mid-milestone that must be completed between existing integer phases.
+
+Uses decimal numbering (72.1, 72.2, etc.) to preserve the logical sequence of planned phases while accommodating urgent insertions.
+
+Purpose: Handle urgent work discovered during execution without renumbering entire roadmap.
+</objective>
+
+<context>
+Arguments: $ARGUMENTS (format: <after-phase-number> <description>)
+
+@.planning/ROADMAP.md
+@.planning/STATE.md
+</context>
+
+<process>
+## 1. Parse Arguments
+
+Extract after-phase-number and description from $ARGUMENTS. Error if either is missing.
+
+## 2. Calculate Decimal Phase Number
+
+Find existing decimal phases after the target number to determine next available decimal (e.g., if 3.1 exists, use 3.2).
+
+## 3. Generate Slug
+
+```bash
+SLUG=$(node ${CLAUDE_PLUGIN_ROOT}/scripts/pbr-tools.js generate-slug "{description}")
+```
+
+## 4. Create Phase
+
+```bash
+node ${CLAUDE_PLUGIN_ROOT}/scripts/pbr-tools.js roadmap insert-phase {after} --goal "{description}"
+```
+
+Create `.planning/phases/{NN.D}-{slug}/` directory.
+
+## 5. Update State
+
+```bash
+node ${CLAUDE_PLUGIN_ROOT}/scripts/pbr-tools.js state record-activity "Inserted phase {NN.D}: {description}"
+```
+
+## 6. Commit
+
+```bash
+git add .planning/
+git commit -m "docs: insert phase {NN.D} — {slug}"
+```
+
+## 7. Report
+
+Display: "Phase {NN.D}: {description} inserted after phase {NN}."
+Suggest: `/pbr:plan-phase {NN.D}` as next step.
+</process>

package/plugins/pbr/commands/intel.md

@@ -0,0 +1,5 @@
+---
+description: "Refresh or query codebase intelligence (file graph, APIs, dependencies, architecture)."
+---
+
+This command is provided by the `pbr:intel` skill.

package/plugins/pbr/commands/join-discord.md

@@ -0,0 +1,11 @@
+---
+description: "Join the PBR Discord community"
+---
+
+# Join the PBR Discord
+
+Connect with other Plan-Build-Run users, get help, share what you're building, and stay updated.
+
+**Invite link:** https://discord.gg/5JJgD5svVS
+
+Click the link or paste it into your browser to join.

package/plugins/pbr/commands/list-phase-assumptions.md

@@ -0,0 +1,69 @@
+---
+description: "Surface Claude's assumptions about a phase approach before planning"
+argument-hint: "[phase]"
+allowed-tools:
+  - Read
+  - Bash
+  - Grep
+  - Glob
+---
+
+<objective>
+Analyze a phase and present Claude's assumptions about technical approach, implementation order, scope boundaries, risk areas, and dependencies.
+
+Purpose: Help users see what Claude thinks BEFORE planning begins — enabling course correction early when assumptions are wrong.
+Output: Conversational output only (no file creation) — ends with "What do you think?" prompt.
+</objective>
+
+<context>
+Phase number: $ARGUMENTS (required)
+
+@.planning/STATE.md
+@.planning/ROADMAP.md
+</context>
+
+<process>
+## 1. Validate Phase
+
+```bash
+PHASE_INFO=$(node ${CLAUDE_PLUGIN_ROOT}/scripts/pbr-tools.js roadmap get-phase "$ARGUMENTS")
+```
+
+Error if phase not found.
+
+## 2. Gather Context
+
+Read:
+- Phase goal and description from ROADMAP.md
+- Research files if they exist (`.planning/phases/{NN}-*/RESEARCH.md`)
+- Requirements mapped to this phase
+- Prior phase decisions from STATE.md
+
+## 3. Surface Assumptions
+
+Present assumptions across five areas:
+
+### Technical Approach
+What libraries, patterns, and architecture you'd use.
+
+### Implementation Order
+What you'd build first and why.
+
+### Scope Boundaries
+What's included vs what you'd deliberately exclude.
+
+### Risk Areas
+What could go wrong and what's uncertain.
+
+### Dependencies
+What this phase needs from prior phases and what it provides to later ones.
+
+## 4. Invite Feedback
+
+End with: "What do you think? Any of these assumptions wrong?"
+
+Offer next steps:
+- `/pbr:discuss-phase {N}` — discuss context before planning
+- `/pbr:plan-phase {N}` — proceed to planning
+- Correct specific assumptions here
+</process>

package/plugins/pbr/commands/map-codebase.md

@@ -0,0 +1,6 @@
+---
+description: "Analyze codebase with parallel mapper agents to produce .planning/codebase/ documents"
+argument-hint: "[optional: specific area to map]"
+---
+
+This command is provided by the `pbr:scan` skill.

package/plugins/pbr/commands/milestone.md

@@ -2,4 +2,4 @@
 description: "Manage milestones: new, complete, audit, gaps."
 ---
 
-This command is provided by the `dev:milestone` skill.
+This command is provided by the `pbr:milestone` skill.

package/plugins/pbr/commands/new-milestone.md

@@ -0,0 +1,8 @@
+---
+description: "Start a new milestone cycle — update PROJECT.md and route to requirements"
+argument-hint: "[milestone name, e.g., 'v1.1 Notifications']"
+---
+
+This command is provided by the `pbr:milestone` skill with subcommand `new`.
+
+Pass arguments as: `new $ARGUMENTS`

package/plugins/pbr/commands/new-project.md

@@ -0,0 +1,6 @@
+---
+description: "Initialize a new project with deep context gathering and PROJECT.md"
+argument-hint: "[--auto]"
+---
+
+This command is provided by the `pbr:begin` skill.

package/plugins/pbr/commands/note.md

@@ -2,4 +2,4 @@
 description: "Zero-friction idea capture. Append, list, or promote notes to todos."
 ---
 
-This command is provided by the `dev:note` skill.
+This command is provided by the `pbr:note` skill.

package/plugins/pbr/commands/pause-work.md

@@ -0,0 +1,5 @@
+---
+description: "Create context handoff when pausing work mid-phase"
+---
+
+This command is provided by the `pbr:pause` skill.

package/plugins/pbr/commands/pause.md

@@ -2,4 +2,4 @@
 description: "Save your current session state for later resumption."
 ---
 
-This command is provided by the `dev:pause` skill.
+This command is provided by the `pbr:pause` skill.

package/plugins/pbr/commands/plan-milestone-gaps.md

@@ -0,0 +1,7 @@
+---
+description: "Create phases to close all gaps identified by milestone audit"
+---
+
+This command is provided by the `pbr:milestone` skill with subcommand `gaps`.
+
+Pass arguments as: `gaps`

package/plugins/pbr/commands/plan-phase.md

@@ -0,0 +1,6 @@
+---
+description: "Create detailed execution plan for a phase (PLAN.md) with verification loop"
+argument-hint: "[phase] [--research] [--skip-research] [--gaps] [--skip-verify]"
+---
+
+This command is provided by the `pbr:plan` skill.

package/plugins/pbr/commands/plan.md

@@ -2,4 +2,4 @@
 description: "Create a detailed plan for a phase. Research, plan, and verify before building."
 ---
 
-This command is provided by the `dev:plan` skill.
+This command is provided by the `pbr:plan` skill.

package/plugins/pbr/commands/profile-user.md

@@ -0,0 +1,5 @@
+---
+description: "Analyze Claude Code session history to generate a developer behavioral profile across 8 dimensions."
+---
+
+This command is provided by the `pbr:profile-user` skill.

package/plugins/pbr/commands/profile.md

@@ -0,0 +1,5 @@
+---
+description: "Switch the active model profile. Presets: quality, balanced, budget, adaptive. Supports custom profiles from config.json model_profiles."
+---
+
+This command is provided by the `pbr:profile` skill.

package/plugins/pbr/commands/progress.md

@@ -0,0 +1,6 @@
+---
+description: "Check project progress, show context, and route to next action"
+argument-hint: "[--next]"
+---
+
+This command is provided by the `pbr:status` skill.

package/plugins/pbr/commands/quick.md

@@ -1,5 +1,5 @@
 ---
-description: "Execute a quick ad-hoc task. Atomic commits + state tracking, skips full plan/review cycle."
+description: "Execute an ad-hoc task with atomic commits. Skips full plan/review."
 ---
 
-This command is provided by the `dev:quick` skill.
+This command is provided by the `pbr:quick` skill.

package/plugins/pbr/commands/reapply-patches.md

@@ -0,0 +1,47 @@
+---
+description: "Reapply local modifications after a PBR update"
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Bash
+  - Glob
+  - Grep
+  - AskUserQuestion
+---
+
+<objective>
+After a PBR update wipes and reinstalls files, merge user's previously saved local modifications back into the new version. Uses intelligent comparison to handle cases where the upstream file also changed.
+</objective>
+
+<process>
+## 1. Detect Backed-up Patches
+
+```bash
+PATCHES_DIR="${HOME}/.claude/pbr-local-patches"
+if [ ! -d "$PATCHES_DIR" ]; then
+  PATCHES_DIR="./.claude/pbr-local-patches"
+fi
+```
+
+Read `backup-meta.json` from the patches directory.
+If no patches found: "No local patches found. Nothing to reapply." Exit.
+
+## 2. Show Patch Summary
+
+List all backed-up files with status.
+
+## 3. Merge Each File
+
+For each file in backup-meta.json:
+1. Read backed-up version (user's modified copy)
+2. Read newly installed version (current file after update)
+3. Compare and merge:
+   - Identical: skip (modification incorporated upstream)
+   - Different: identify user modifications, apply to new version
+   - Conflict: show both versions, ask user which to keep
+
+## 4. Report
+
+Display merge results table with status per file.
+</process>

package/plugins/pbr/commands/release.md

@@ -0,0 +1,6 @@
+---
+description: "Generate or update changelog and release notes from project history."
+argument-hint: "[version] [--draft|--update|--clean]"
+---
+
+This command is provided by the `pbr:release` skill.

package/plugins/pbr/commands/remove-phase.md

@@ -0,0 +1,66 @@
+---
+description: "Remove a future phase from roadmap and renumber subsequent phases"
+argument-hint: "<phase-number>"
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - Glob
+---
+
+<objective>
+Remove an unstarted future phase from the roadmap and renumber all subsequent phases to maintain a clean, linear sequence.
+
+Purpose: Clean removal of work you've decided not to do, without polluting context with cancelled/deferred markers.
+Output: Phase deleted, all subsequent phases renumbered, git commit as historical record.
+</objective>
+
+<context>
+Phase: $ARGUMENTS
+
+@.planning/ROADMAP.md
+@.planning/STATE.md
+</context>
+
+<process>
+## 1. Validate Phase Number
+
+Parse $ARGUMENTS as phase number. Error if empty.
+
+## 2. Check Phase Status
+
+```bash
+node ${CLAUDE_PLUGIN_ROOT}/scripts/pbr-tools.js phase-info $ARGUMENTS
+```
+
+Verify the phase exists and has NOT been started (no PLAN.md or SUMMARY.md files). Refuse to remove completed or in-progress phases.
+
+## 3. Confirm Removal
+
+Display phase details and ask for confirmation:
+"Remove Phase {N}: {name}? This will renumber all subsequent phases."
+
+## 4. Remove Phase
+
+```bash
+node ${CLAUDE_PLUGIN_ROOT}/scripts/pbr-tools.js phase remove $ARGUMENTS
+node ${CLAUDE_PLUGIN_ROOT}/scripts/pbr-tools.js roadmap remove-phase $ARGUMENTS
+```
+
+## 5. Update State
+
+```bash
+node ${CLAUDE_PLUGIN_ROOT}/scripts/pbr-tools.js state record-activity "Removed phase {N}: {name}"
+```
+
+## 6. Commit
+
+```bash
+git add .planning/
+git commit -m "docs: remove phase {N} — {name}"
+```
+
+## 7. Report
+
+Display updated phase list and suggest `/pbr:progress` to review.
+</process>