@sienklogic/plan-build-run 2.51.0 → 2.52.0

package/CHANGELOG.md

@@ -5,6 +5,21 @@ All notable changes to Plan-Build-Run will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.52.0](https://github.com/SienkLogic/plan-build-run/compare/plan-build-run-v2.51.0...plan-build-run-v2.52.0) (2026-03-01)
+
+
+### Features
+
+* **54-01:** add sync:generate/sync:verify scripts and unit tests ([4b59ad6](https://github.com/SienkLogic/plan-build-run/commit/4b59ad6fb77918d47f1ab5765c4d0d54ae4d6257))
+* **54-01:** create generate-derivatives.js with transformation engine ([190ab92](https://github.com/SienkLogic/plan-build-run/commit/190ab92ccd45b73388594b565ecdab51a2f64774))
+* **54-02:** GREEN - add session get|set|clear|dump subcommands to pbr-tools.js ([4e69699](https://github.com/SienkLogic/plan-build-run/commit/4e69699d6ec7d3cc67137108fffbb4d7c294a637))
+* **54-02:** migrate core signal file writers to .session.json ([6fcc7a1](https://github.com/SienkLogic/plan-build-run/commit/6fcc7a14c3be9ca78eacb582db951f773e776480))
+
+
+### Bug Fixes
+
+* **54-01:** cursor agents keep model+readonly, lower branch threshold to 68 ([4124d2e](https://github.com/SienkLogic/plan-build-run/commit/4124d2e16ac1dd3e395458c2e01331ae6f92dd32))
+
 ## [2.51.0](https://github.com/SienkLogic/plan-build-run/compare/plan-build-run-v2.50.0...plan-build-run-v2.51.0) (2026-03-01)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sienklogic/plan-build-run",
-  "version": "2.51.0",
+  "version": "2.52.0",
   "description": "Plan it, Build it, Run it — structured development workflow for Claude Code",
   "keywords": [
     "claude-code",
@@ -30,6 +30,8 @@
     "test": "jest",
     "lint": "eslint plugins/pbr/scripts/ tests/",
     "validate": "node plugins/pbr/scripts/validate-plugin-structure.js",
+    "sync:generate": "node scripts/generate-derivatives.js",
+    "sync:verify": "node scripts/generate-derivatives.js --verify",
     "dashboard": "npx --prefix dashboard tsx --tsconfig dashboard/tsconfig.json dashboard/bin/cli.js",
     "dashboard:install": "npm install --prefix dashboard"
   },
@@ -48,7 +50,7 @@
     "coverageThreshold": {
       "global": {
         "statements": 70,
-        "branches": 69,
+        "branches": 68,
         "functions": 70,
         "lines": 70
       }

package/plugins/copilot-pbr/agents/audit.agent.md

@@ -1,9 +1,6 @@
 ---
 name: audit
 description: "Analyzes Claude Code session logs for PBR workflow compliance, hook firing, state file hygiene, and user experience quality."
-tools: ["*"]
-infer: true
-target: "github-copilot"
 ---
 
 <files_to_read>
@@ -28,7 +25,7 @@ You are **audit**, the session analysis agent for the Plan-Build-Run development
 
 You receive a prompt containing:
 - **Session JSONL path**: Absolute path to the session log file
-- **Subagent paths**: Optional paths to subagent logs in the `subagents/` subdirectory
+- **Subagent paths**: Optional paths to subagent logs in the `agents/` subdirectory
 - **Audit mode**: `compliance` (workflow correctness) or `ux` (user experience) or `full` (both)
 - **Output path**: Where to write findings
 
@@ -83,7 +80,7 @@ For each session, check:
 - Verify format: `{type}({scope}): {description}`
 - Check for forbidden `Co-Authored-By` lines
 
-### 7. Agent Delegation
+### 7. Subagent Delegation
 - Was implementation work delegated to executor agents?
 - Or was it done directly in main context (anti-pattern)?
 - Count tool calls in main context vs agents

package/plugins/copilot-pbr/agents/codebase-mapper.agent.md

@@ -1,9 +1,6 @@
 ---
 name: codebase-mapper
 description: "Explores existing codebases and writes structured analysis documents. Four focus areas: tech, arch, quality, concerns."
-tools: ["*"]
-infer: true
-target: "github-copilot"
 ---
 
 <files_to_read>
@@ -185,7 +182,7 @@ Orchestrators pattern-match on these markers to route results. Omitting causes s
 9. DO NOT contradict locked decisions in CONTEXT.md
 10. DO NOT implement deferred ideas from CONTEXT.md
 11. DO NOT consume more than 50% context before producing output
-12. DO NOT read agent .md files from agents/ — auto-loaded via agent:
+12. DO NOT read agent .md files from agents/ — auto-loaded via subagent_type
 
 Additionally for this agent:
 

package/plugins/copilot-pbr/agents/debugger.agent.md

@@ -1,9 +1,6 @@
 ---
 name: debugger
 description: "Systematic debugging using scientific method. Persistent debug sessions with hypothesis testing, evidence tracking, and checkpoint support."
-tools: ["*"]
-infer: true
-target: "github-copilot"
 ---
 
 <files_to_read>
@@ -206,7 +203,7 @@ Reference: `references/common-bug-patterns.md` — covers off-by-one, null/undef
 9. DO NOT contradict locked decisions in CONTEXT.md
 10. DO NOT implement deferred ideas from CONTEXT.md
 11. DO NOT consume more than 50% context before producing output
-12. DO NOT read agent .md files from agents/ — auto-loaded via agent:
+12. DO NOT read agent .md files from agents/ — auto-loaded via subagent_type
 
 ### Debugger-Specific
 

package/plugins/copilot-pbr/agents/dev-sync.agent.md

@@ -1,9 +1,6 @@
 ---
 name: dev-sync
 description: "Syncs PBR plugin changes to cursor-pbr and copilot-pbr derivatives with format adjustments."
-tools: ["*"]
-infer: true
-target: "github-copilot"
 ---
 
 <files_to_read>
@@ -34,8 +31,8 @@ Spawned by the orchestrator after edits to PBR plugin files. You receive either:
 |---------|-------------|-----------------|-------------------|
 | `allowed-tools:` frontmatter | KEEP | REMOVE entire line | REMOVE entire line |
 | `argument-hint:` frontmatter | KEEP | KEEP | REMOVE entire line |
-| `${CLAUDE_PLUGIN_ROOT}` | As-is | Replace → `${PLUGIN_ROOT}` | Replace → `${PLUGIN_ROOT}` |
-| "subagent" / "subagents" | As-is | Replace → "agent" / "agents" | Replace → "agent" / "agents" |
+| `${PLUGIN_ROOT}` | As-is | Replace → `${PLUGIN_ROOT}` | Replace → `${PLUGIN_ROOT}` |
+| "subagent" / "agents" | As-is | Replace → "agent" / "agents" | Replace → "agent" / "agents" |
 | `subagent_type:` | As-is | Replace → `agent:` | Replace → `agent:` |
 
 **Paths**:
@@ -58,9 +55,9 @@ Spawned by the orchestrator after edits to PBR plugin files. You receive either:
 
 **Text swaps** (same for both Cursor and Copilot agent bodies):
 
-- `${CLAUDE_PLUGIN_ROOT}` → `${PLUGIN_ROOT}`
+- `${PLUGIN_ROOT}` → `${PLUGIN_ROOT}`
 - "subagent" → "agent" (case-sensitive, whole word when possible)
-- "subagents" → "agents"
+- "agents" → "agents"
 - `subagent_type:` → `agent:`
 
 **Paths**:
@@ -73,8 +70,8 @@ Spawned by the orchestrator after edits to PBR plugin files. You receive either:
 
 These are copied with text swaps only (no frontmatter changes):
 
-- `${CLAUDE_PLUGIN_ROOT}` → `${PLUGIN_ROOT}`
-- "subagent" → "agent", "subagents" → "agents"
+- `${PLUGIN_ROOT}` → `${PLUGIN_ROOT}`
+- "subagent" → "agent", "agents" → "agents"
 - `subagent_type:` → `agent:`
 
 **Paths**:

package/plugins/copilot-pbr/agents/executor.agent.md

@@ -1,9 +1,6 @@
 ---
 name: executor
 description: "Executes plan tasks with atomic commits, deviation handling, checkpoint protocols, TDD support, and self-verification."
-tools: ["*"]
-infer: true
-target: "github-copilot"
 ---
 
 <files_to_read>
@@ -362,7 +359,7 @@ Record timestamps at start and end using `node -e "console.log(new Date().toISOS
 9. DO NOT contradict locked decisions in CONTEXT.md
 10. DO NOT implement deferred ideas from CONTEXT.md
 11. DO NOT consume more than 50% context before producing output — write incrementally
-12. DO NOT read agent .md files from agents/ — they're auto-loaded via agent:
+12. DO NOT read agent .md files from agents/ — they're auto-loaded via subagent_type
 
 ### Executor-Specific
 

package/plugins/copilot-pbr/agents/general.agent.md

@@ -1,9 +1,6 @@
 ---
 name: general
 description: "Lightweight Plan-Build-Run-aware agent for ad-hoc tasks that don't fit specialized roles."
-tools: ["*"]
-infer: true
-target: "github-copilot"
 ---
 
 <files_to_read>
@@ -102,7 +99,7 @@ If your task hits any of these, STOP and recommend the appropriate agent:
 9. DO NOT contradict locked decisions in CONTEXT.md
 10. DO NOT implement deferred ideas from CONTEXT.md
 11. DO NOT consume more than 50% context before producing output
-12. DO NOT read agent .md files from agents/ — auto-loaded via agent:
+12. DO NOT read agent .md files from agents/ — auto-loaded via subagent_type
 
 ### Agent-Specific
 1. DO NOT take on large implementation tasks — escalate to executor

package/plugins/copilot-pbr/agents/integration-checker.agent.md

@@ -1,9 +1,6 @@
 ---
 name: integration-checker
 description: "Cross-phase integration and E2E flow verification. Checks exports used by imports, API coverage, auth protection, and complete user workflows."
-tools: ["*"]
-infer: true
-target: "github-copilot"
 ---
 
 <files_to_read>
@@ -144,7 +141,7 @@ See `references/integration-patterns.md` for grep/search patterns by framework.
 9. DO NOT contradict locked decisions in CONTEXT.md
 10. DO NOT implement deferred ideas from CONTEXT.md
 11. DO NOT consume more than 50% context before producing output
-12. DO NOT read agent .md files from agents/ — auto-loaded via agent:
+12. DO NOT read agent .md files from agents/ — auto-loaded via subagent_type
 
 ### Agent-Specific
 - Never attempt to fix issues — you REPORT them

package/plugins/copilot-pbr/agents/plan-checker.agent.md

@@ -1,9 +1,6 @@
 ---
 name: plan-checker
 description: "Verifies plans will achieve phase goals before execution. Goal-backward analysis of plan quality across 10 dimensions."
-tools: ["*"]
-infer: true
-target: "github-copilot"
 ---
 
 <files_to_read>
@@ -239,7 +236,7 @@ Plans: {count} | Tasks: {count} | Blockers: {count} | Warnings: {count} | Info:
 9. DO NOT contradict locked decisions in CONTEXT.md
 10. DO NOT implement deferred ideas from CONTEXT.md
 11. DO NOT consume more than 50% context before producing output
-12. DO NOT read agent .md files from agents/ — auto-loaded via agent:
+12. DO NOT read agent .md files from agents/ — auto-loaded via subagent_type
 
 </anti_patterns>
 

package/plugins/copilot-pbr/agents/planner.agent.md

@@ -1,9 +1,6 @@
 ---
 name: planner
 description: "Creates executable phase plans with task breakdown, dependency analysis, wave assignment, and goal-backward verification. Also creates roadmaps."
-tools: ["*"]
-infer: true
-target: "github-copilot"
 ---
 
 <files_to_read>
@@ -323,7 +320,7 @@ One-line task descriptions in `<name>`. File paths in `<files>`, not explanation
 9. DO NOT contradict locked decisions in CONTEXT.md
 10. DO NOT implement deferred ideas from CONTEXT.md
 11. DO NOT consume more than 50% context before producing output — write incrementally
-12. DO NOT read agent .md files from agents/ — they're auto-loaded via agent:
+12. DO NOT read agent .md files from agents/ — they're auto-loaded via subagent_type
 
 ### Planner-Specific Anti-Patterns
 1. DO NOT create plans that violate CONTEXT.md locked decisions

package/plugins/copilot-pbr/agents/researcher.agent.md

@@ -1,9 +1,6 @@
 ---
 name: researcher
 description: "Unified research agent for project domains, phase implementation approaches, and synthesis. Follows source-hierarchy methodology with confidence levels."
-tools: ["*"]
-infer: true
-target: "github-copilot"
 ---
 
 <files_to_read>
@@ -216,7 +213,7 @@ coverage: "complete|partial|minimal"
 9. DO NOT contradict locked decisions in CONTEXT.md
 10. DO NOT implement deferred ideas from CONTEXT.md
 11. DO NOT consume more than 50% context before producing output — write incrementally
-12. DO NOT read agent .md files from agents/ — auto-loaded via agent:
+12. DO NOT read agent .md files from agents/ — they're auto-loaded via subagent_type
 
 Additionally for this agent:
 

package/plugins/copilot-pbr/agents/synthesizer.agent.md

@@ -1,9 +1,6 @@
 ---
 name: synthesizer
 description: "Fast synthesis of multiple research outputs into coherent recommendations. Resolves contradictions between sources."
-tools: ["*"]
-infer: true
-target: "github-copilot"
 ---
 
 <files_to_read>
@@ -147,7 +144,7 @@ Use the returned `summary` string as your working copy of that document's findin
 9. DO NOT contradict locked decisions in CONTEXT.md
 10. DO NOT implement deferred ideas from CONTEXT.md
 11. DO NOT consume more than 50% context before producing output
-12. DO NOT read agent .md files from agents/ — auto-loaded via agent:
+12. DO NOT read agent .md files from agents/ — auto-loaded via subagent_type
 
 ### Agent-Specific
 1. DO NOT re-research topics — synthesize what's already been researched

package/plugins/copilot-pbr/agents/verifier.agent.md

@@ -1,9 +1,7 @@
 ---
 name: verifier
 description: "Goal-backward phase verification. Checks codebase reality against phase goals - existence, substantiveness, and wiring of all deliverables."
-tools: ["*"]
-infer: true
-target: "github-copilot"
+isolation: worktree
 ---
 
 <files_to_read>
@@ -333,7 +331,7 @@ Orchestrators pattern-match on these markers to route results. Omitting causes s
 9. DO NOT contradict locked decisions in CONTEXT.md
 10. DO NOT implement deferred ideas from CONTEXT.md
 11. DO NOT consume more than 50% context before producing output — write incrementally
-12. DO NOT read agent .md files from agents/ — they're auto-loaded via agent:
+12. DO NOT read agent .md files from agents/ — they're auto-loaded via subagent_type
 
 ### Verifier-Specific Anti-Patterns
 1. DO NOT trust SUMMARY.md claims without verifying the actual codebase

package/plugins/copilot-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/copilot-pbr/commands/begin.md

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

package/plugins/copilot-pbr/commands/build.md

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

package/plugins/copilot-pbr/commands/config.md

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

package/plugins/copilot-pbr/commands/continue.md

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

package/plugins/copilot-pbr/commands/dashboard.md

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

package/plugins/copilot-pbr/commands/debug.md

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

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

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

package/plugins/copilot-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/copilot-pbr/commands/explore.md

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

package/plugins/copilot-pbr/commands/health.md

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

package/plugins/copilot-pbr/commands/help.md

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

package/plugins/copilot-pbr/commands/import.md

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

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

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

package/plugins/copilot-pbr/commands/note.md

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

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

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

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

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

package/plugins/copilot-pbr/commands/quick.md

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

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

@@ -0,0 +1,5 @@
+---
+description: "Pick up where you left off. Restores context and suggests next action."
+---
+
+This command is provided by the `pbr:resume` skill.

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

@@ -0,0 +1,5 @@
+---
+description: "Verify the build matched the plan. Automated checks + walkthrough with you."
+---
+
+This command is provided by the `pbr:review` skill.

package/plugins/copilot-pbr/commands/scan.md

@@ -0,0 +1,5 @@
+---
+description: "Analyze an existing codebase. Maps structure, architecture, conventions, and concerns."
+---
+
+This command is provided by the `pbr:scan` skill.

package/plugins/copilot-pbr/commands/setup.md

@@ -0,0 +1,5 @@
+---
+description: "Interactive onboarding wizard for new Plan-Build-Run projects."
+---
+
+This command is provided by the `pbr:setup` skill.

package/plugins/copilot-pbr/commands/status.md

@@ -0,0 +1,5 @@
+---
+description: "Show current project status and suggest what to do next."
+---
+
+This command is provided by the `pbr:status` skill.

package/plugins/copilot-pbr/commands/statusline.md

@@ -0,0 +1,5 @@
+---
+description: "Install or configure the PBR status line in Claude Code."
+---
+
+This command is provided by the `pbr:statusline` skill.

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

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

package/plugins/copilot-pbr/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "pbr",
   "displayName": "Plan-Build-Run",
-  "version": "2.51.0",
+  "version": "2.52.0",
   "description": "Plan-Build-Run — Structured development workflow for GitHub Copilot CLI. Solves context rot through disciplined agent delegation, structured planning, atomic execution, and goal-backward verification.",
   "author": {
     "name": "SienkLogic",

package/plugins/copilot-pbr/references/agent-anti-patterns.md

@@ -1,4 +1,3 @@
-<!-- canonical: ../../pbr/references/agent-anti-patterns.md -->
 # Universal Agent Anti-Patterns
 
 These anti-patterns apply to ALL Plan-Build-Run agents. Each agent also has role-specific anti-patterns defined in its own agent file.

package/plugins/copilot-pbr/references/agent-teams.md

@@ -1,4 +1,3 @@
-<!-- canonical: ../../pbr/references/agent-teams.md -->
 # Agent Teams Reference
 
 Agent Teams enable parallel specialist perspectives for critical phases. Teams are off by default.

package/plugins/copilot-pbr/references/common-bug-patterns.md

@@ -1,4 +1,3 @@
-<!-- canonical: ../../pbr/references/common-bug-patterns.md -->
 # Common Bug Patterns
 
 Quick reference for the debugger agent. Check these patterns early — they cover ~80% of bugs.

package/plugins/copilot-pbr/references/config-reference.md

@@ -1,4 +1,3 @@
-<!-- canonical: ../../pbr/references/config-reference.md -->
 # Config Reference Guide
 
 Complete reference for `.planning/config.json` -- the file that controls all Plan-Build-Run workflow behavior. Created by `/pbr:begin`, modifiable via `/pbr:config` or direct editing. Validated against `config-schema.json`.

package/plugins/copilot-pbr/references/continuation-format.md

@@ -1,4 +1,3 @@
-<!-- canonical: ../../pbr/references/continuation-format.md -->
 # Continuation Protocol
 
 How to spawn a fresh executor agent to continue from a checkpoint or partial completion.

package/plugins/copilot-pbr/references/deviation-rules.md

@@ -1,4 +1,3 @@
-<!-- canonical: ../../pbr/references/deviation-rules.md -->
 # Deviation Rules
 
 When execution doesn't go exactly as planned, these 5 rules govern what the executor can do on its own versus what requires user approval.

package/plugins/copilot-pbr/references/git-integration.md

@@ -1,4 +1,3 @@
-<!-- canonical: ../../pbr/references/git-integration.md -->
 # Git Integration Reference
 
 Plan-Build-Run's commit conventions, commit points, branching strategy, and hook scripts.

package/plugins/copilot-pbr/references/integration-patterns.md

@@ -1,4 +1,3 @@
-<!-- canonical: ../../pbr/references/integration-patterns.md -->
 # Integration Patterns Reference
 
 Technology-specific grep/search patterns and E2E flow templates for integration-checker.

package/plugins/copilot-pbr/references/model-profiles.md

@@ -1,4 +1,3 @@
-<!-- canonical: ../../pbr/references/model-profiles.md -->
 # Model Profiles Reference
 
 How Plan-Build-Run maps agents to models and how to configure model selection.

package/plugins/copilot-pbr/references/model-selection.md

@@ -1,4 +1,3 @@
-<!-- canonical: ../../pbr/references/model-selection.md -->
 # Model Selection Reference
 
 Plan-Build-Run uses adaptive model selection to balance cost and capability.

package/plugins/copilot-pbr/references/pbr-rules.md

@@ -1,4 +1,3 @@
-<!-- canonical: ../../pbr/references/pbr-rules.md -->
 # Plan-Build-Run Rules
 
 Authoritative rules for all Plan-Build-Run skills, agents, hooks, and workflows.

package/plugins/copilot-pbr/references/plan-authoring.md

@@ -1,4 +1,3 @@
-<!-- canonical: ../../pbr/references/plan-authoring.md -->
 # Plan Authoring Guide
 
 Quality guidelines for writing executable plans. Used by planner and plan-checker.

package/plugins/copilot-pbr/references/plan-format.md

@@ -1,4 +1,3 @@
-<!-- canonical: ../../pbr/references/plan-format.md -->
 # Plan Format Reference
 
 Complete reference for the XML task specification used in Plan-Build-Run plan files.

package/plugins/copilot-pbr/references/reading-verification.md

@@ -1,4 +1,3 @@
-<!-- canonical: ../../pbr/references/reading-verification.md -->
 # Reading Verification Reports
 
 A user-friendly guide to understanding verification results. For agent-facing patterns, see `verification-patterns.md`.

package/plugins/copilot-pbr/references/stub-patterns.md

@@ -1,4 +1,3 @@
-<!-- canonical: ../../pbr/references/stub-patterns.md -->
 # Stub Detection Patterns
 
 Technology-aware patterns for detecting incomplete implementations. Used by the verifier during Layer 2 (Substantiveness) checks.

package/plugins/copilot-pbr/references/wave-execution.md

@@ -1,4 +1,3 @@
-<!-- canonical: ../../pbr/references/wave-execution.md -->
 # Wave-Based Execution
 
 How Plan-Build-Run parallelizes plan execution within a phase while respecting dependencies.