@sienklogic/plan-build-run 2.21.0 → 2.21.2

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-fix.md

@@ -0,0 +1,5 @@
+---
+description: "Run audit, prioritize findings, auto-fix via quick tasks, test, and commit."
+---
+
+This command is provided by the `pbr:audit-fix` skill.

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/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/backlog.md

@@ -0,0 +1,6 @@
+---
+description: "Manage backlog items — ideas not ready for active planning. Add, review, promote, or remove."
+argument-hint: "add <description> | review | promote <N>"
+---
+
+This command is provided by the `pbr:backlog` 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 `pbr:config` 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/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/fast.md

@@ -0,0 +1,6 @@
+---
+description: "Execute a trivial task inline without subagent overhead. No planning, no research — just do it and commit."
+argument-hint: "<task description>"
+---
+
+This command is provided by the `pbr:fast` skill.

package/plugins/pbr/commands/forensics.md

@@ -0,0 +1,6 @@
+---
+description: "Post-mortem investigation for failed or stuck workflows. Analyzes git history and planning artifacts."
+argument-hint: "[description of what went wrong]"
+---
+
+This command is provided by the `pbr:forensics` 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 `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,5 @@
+---
+description: "Surface Claude's assumptions about a phase before planning begins."
+---
+
+This command is provided by the `pbr:list-phase-assumptions` skill.

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-summary.md

@@ -0,0 +1,6 @@
+---
+description: "Generate comprehensive milestone summary from archived artifacts. For team onboarding and stakeholder review."
+argument-hint: "[version]"
+---
+
+This command is provided by the `pbr:milestone-summary` 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/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/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/plant-seed.md

@@ -0,0 +1,6 @@
+---
+description: "Plant forward-looking ideas with trigger conditions that auto-surface at the right milestone."
+argument-hint: "<idea description>"
+---
+
+This command is provided by the `pbr:seed` 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 `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>

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

@@ -0,0 +1,59 @@
+---
+description: "Research how to implement a phase (standalone — usually use /pbr:plan-phase instead)"
+argument-hint: "[phase]"
+allowed-tools:
+  - Read
+  - Bash
+  - Task
+---
+
+<objective>
+Research how to implement a phase. Spawns researcher agent with phase context.
+
+**Note:** This is a standalone research command. For most workflows, use `/pbr:plan-phase` which integrates research automatically.
+
+**Use this command when:**
+- You want to research without planning yet
+- You want to re-research after planning is complete
+- You need to investigate before deciding if a phase is feasible
+</objective>
+
+<context>
+Phase number: $ARGUMENTS (required)
+
+@.planning/ROADMAP.md
+@.planning/STATE.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. Extract phase_number, phase_name, goal.
+
+## 2. Check Existing Research
+
+Look for `.planning/phases/{NN}-*/RESEARCH.md`.
+If exists, offer: 1) Update research, 2) View existing, 3) Skip.
+
+## 3. Gather Context
+
+Read phase description, requirements, and prior decisions.
+
+## 4. Spawn Researcher
+
+```
+Task({
+  subagent_type: "pbr:researcher",
+  prompt: "Research implementation approach for Phase {N}: {name}\n\nPhase goal: {goal}\nRequirements: {requirements}\nPrior decisions: {decisions}\n\nWrite to: .planning/phases/{NN}-{slug}/{NN}-RESEARCH.md"
+})
+```
+
+## 5. Handle Return
+
+- `## RESEARCH COMPLETE`: Display summary, offer `/pbr:plan-phase {N}`
+- `## RESEARCH INCONCLUSIVE`: Show what was attempted, offer options
+</process>

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

@@ -0,0 +1,5 @@
+---
+description: "Resume work from previous session with full context restoration"
+---
+
+This command is provided by the `pbr:resume` skill.

package/plugins/pbr/commands/seed.md

@@ -0,0 +1,6 @@
+---
+description: "Plant forward-looking ideas with trigger conditions that auto-surface at the right milestone."
+argument-hint: "<idea description>"
+---
+
+This command is provided by the `pbr:seed` skill.

package/plugins/pbr/commands/session-report.md

@@ -0,0 +1,5 @@
+---
+description: "Generate post-session summary with work performed, outcomes, and resource usage."
+---
+
+This command is provided by the `pbr:session-report` skill.

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

@@ -0,0 +1,6 @@
+---
+description: "Switch model profile for PBR agents (quality/balanced/budget)"
+argument-hint: "<profile>"
+---
+
+This command is provided by the `pbr:profile` skill.

package/plugins/pbr/commands/settings.md

@@ -0,0 +1,5 @@
+---
+description: "Configure PBR workflow toggles and model profile"
+---
+
+This command is provided by the `pbr:config` skill.

package/plugins/pbr/commands/setup.md

@@ -1,5 +1,5 @@
 ---
-description: "Interactive onboarding wizard for new Plan-Build-Run projects."
+description: "Reconfigure an existing Plan-Build-Run project (models, features, CLAUDE.md)."
 ---
 
 This command is provided by the `pbr:setup` skill.

package/plugins/pbr/commands/ship.md

@@ -0,0 +1,5 @@
+---
+description: "Create a rich PR from planning artifacts (SUMMARY one-liners, requirement coverage, verification status)."
+---
+
+This command is provided by the `pbr:ship` skill.

package/plugins/pbr/commands/stats.md

@@ -0,0 +1,6 @@
+---
+description: "Display project statistics — phases, plans, requirements, git metrics, and timeline."
+argument-hint: "[--json]"
+---
+
+This command is provided by the `pbr:stats` skill.

package/plugins/pbr/commands/test.md

@@ -0,0 +1,5 @@
+---
+description: "Generate tests for completed phase code. Detects test framework and targets key files."
+---
+
+This command is provided by the `pbr:test` skill.

package/plugins/pbr/commands/thread.md

@@ -0,0 +1,6 @@
+---
+description: "Persistent context threads for cross-session work that spans phases. Lighter than pause/resume."
+argument-hint: "[name | list | resume <name>]"
+---
+
+This command is provided by the `pbr:thread` skill.

package/plugins/pbr/commands/todo.md

@@ -1,5 +1,5 @@
 ---
-description: "Persistent file-based todos that survive across sessions. Add, list, and complete todo items."
+description: "File-based persistent todos. Add, list, complete — survives sessions."
 ---
 
 This command is provided by the `pbr:todo` skill.

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

@@ -0,0 +1,5 @@
+---
+description: "Generate UI-SPEC.md design contracts for frontend-heavy phases."
+---
+
+This command is provided by the `pbr:ui-phase` skill.

package/plugins/pbr/commands/ui-review.md

@@ -0,0 +1,5 @@
+---
+description: "Retroactive visual audit of UI implementation with 1-4 scoring per dimension."
+---
+
+This command is provided by the `pbr:ui-review` skill.