@sienklogic/plan-build-run 2.10.0 → 2.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (126) hide show
  1. package/CHANGELOG.md +51 -0
  2. package/package.json +1 -1
  3. package/plugins/copilot-pbr/agents/codebase-mapper.agent.md +42 -0
  4. package/plugins/copilot-pbr/agents/debugger.agent.md +4 -1
  5. package/plugins/copilot-pbr/agents/executor.agent.md +31 -1
  6. package/plugins/copilot-pbr/agents/integration-checker.agent.md +33 -2
  7. package/plugins/copilot-pbr/agents/planner.agent.md +58 -1
  8. package/plugins/copilot-pbr/agents/researcher.agent.md +23 -0
  9. package/plugins/copilot-pbr/agents/synthesizer.agent.md +24 -0
  10. package/plugins/copilot-pbr/agents/verifier.agent.md +35 -1
  11. package/plugins/copilot-pbr/plugin.json +1 -1
  12. package/plugins/copilot-pbr/references/agent-contracts.md +297 -0
  13. package/plugins/copilot-pbr/references/ui-formatting.md +38 -56
  14. package/plugins/copilot-pbr/skills/begin/SKILL.md +30 -7
  15. package/plugins/copilot-pbr/skills/build/SKILL.md +28 -31
  16. package/plugins/copilot-pbr/skills/config/SKILL.md +9 -12
  17. package/plugins/copilot-pbr/skills/continue/SKILL.md +6 -6
  18. package/plugins/copilot-pbr/skills/dashboard/SKILL.md +3 -3
  19. package/plugins/copilot-pbr/skills/debug/SKILL.md +23 -26
  20. package/plugins/copilot-pbr/skills/discuss/SKILL.md +20 -10
  21. package/plugins/copilot-pbr/skills/do/SKILL.md +3 -3
  22. package/plugins/copilot-pbr/skills/explore/SKILL.md +11 -14
  23. package/plugins/copilot-pbr/skills/health/SKILL.md +75 -19
  24. package/plugins/copilot-pbr/skills/help/SKILL.md +6 -6
  25. package/plugins/copilot-pbr/skills/import/SKILL.md +22 -18
  26. package/plugins/copilot-pbr/skills/milestone/SKILL.md +90 -48
  27. package/plugins/copilot-pbr/skills/note/SKILL.md +3 -3
  28. package/plugins/copilot-pbr/skills/pause/SKILL.md +11 -10
  29. package/plugins/copilot-pbr/skills/plan/SKILL.md +22 -9
  30. package/plugins/copilot-pbr/skills/plan/templates/planner-prompt.md.tmpl +1 -1
  31. package/plugins/copilot-pbr/skills/quick/SKILL.md +9 -12
  32. package/plugins/copilot-pbr/skills/resume/SKILL.md +9 -9
  33. package/plugins/copilot-pbr/skills/review/SKILL.md +17 -12
  34. package/plugins/copilot-pbr/skills/scan/SKILL.md +9 -11
  35. package/plugins/copilot-pbr/skills/setup/SKILL.md +31 -8
  36. package/plugins/copilot-pbr/skills/shared/error-reporting.md +2 -1
  37. package/plugins/copilot-pbr/skills/shared/progress-display.md +0 -1
  38. package/plugins/copilot-pbr/skills/shared/universal-anti-patterns.md +10 -6
  39. package/plugins/copilot-pbr/skills/status/SKILL.md +3 -3
  40. package/plugins/copilot-pbr/skills/statusline/SKILL.md +12 -8
  41. package/plugins/copilot-pbr/skills/todo/SKILL.md +51 -28
  42. package/plugins/cursor-pbr/.cursor-plugin/plugin.json +1 -1
  43. package/plugins/cursor-pbr/agents/codebase-mapper.md +42 -0
  44. package/plugins/cursor-pbr/agents/debugger.md +4 -1
  45. package/plugins/cursor-pbr/agents/executor.md +31 -1
  46. package/plugins/cursor-pbr/agents/integration-checker.md +33 -2
  47. package/plugins/cursor-pbr/agents/planner.md +58 -1
  48. package/plugins/cursor-pbr/agents/researcher.md +23 -0
  49. package/plugins/cursor-pbr/agents/synthesizer.md +24 -0
  50. package/plugins/cursor-pbr/agents/verifier.md +35 -1
  51. package/plugins/cursor-pbr/references/agent-contracts.md +297 -0
  52. package/plugins/cursor-pbr/references/ui-formatting.md +38 -56
  53. package/plugins/cursor-pbr/skills/begin/SKILL.md +30 -7
  54. package/plugins/cursor-pbr/skills/build/SKILL.md +28 -31
  55. package/plugins/cursor-pbr/skills/config/SKILL.md +9 -10
  56. package/plugins/cursor-pbr/skills/continue/SKILL.md +6 -6
  57. package/plugins/cursor-pbr/skills/dashboard/SKILL.md +3 -3
  58. package/plugins/cursor-pbr/skills/debug/SKILL.md +23 -23
  59. package/plugins/cursor-pbr/skills/discuss/SKILL.md +20 -10
  60. package/plugins/cursor-pbr/skills/do/SKILL.md +3 -3
  61. package/plugins/cursor-pbr/skills/explore/SKILL.md +11 -12
  62. package/plugins/cursor-pbr/skills/health/SKILL.md +75 -19
  63. package/plugins/cursor-pbr/skills/help/SKILL.md +6 -6
  64. package/plugins/cursor-pbr/skills/import/SKILL.md +22 -16
  65. package/plugins/cursor-pbr/skills/milestone/SKILL.md +90 -48
  66. package/plugins/cursor-pbr/skills/note/SKILL.md +3 -3
  67. package/plugins/cursor-pbr/skills/pause/SKILL.md +11 -9
  68. package/plugins/cursor-pbr/skills/plan/SKILL.md +22 -9
  69. package/plugins/cursor-pbr/skills/plan/templates/planner-prompt.md.tmpl +1 -1
  70. package/plugins/cursor-pbr/skills/quick/SKILL.md +9 -12
  71. package/plugins/cursor-pbr/skills/resume/SKILL.md +9 -9
  72. package/plugins/cursor-pbr/skills/review/SKILL.md +17 -12
  73. package/plugins/cursor-pbr/skills/scan/SKILL.md +9 -10
  74. package/plugins/cursor-pbr/skills/setup/SKILL.md +31 -8
  75. package/plugins/cursor-pbr/skills/shared/error-reporting.md +2 -1
  76. package/plugins/cursor-pbr/skills/shared/progress-display.md +0 -1
  77. package/plugins/cursor-pbr/skills/shared/universal-anti-patterns.md +10 -6
  78. package/plugins/cursor-pbr/skills/status/SKILL.md +3 -3
  79. package/plugins/cursor-pbr/skills/statusline/SKILL.md +12 -8
  80. package/plugins/cursor-pbr/skills/todo/SKILL.md +51 -28
  81. package/plugins/pbr/.claude-plugin/plugin.json +1 -1
  82. package/plugins/pbr/agents/codebase-mapper.md +42 -0
  83. package/plugins/pbr/agents/debugger.md +4 -1
  84. package/plugins/pbr/agents/executor.md +31 -1
  85. package/plugins/pbr/agents/integration-checker.md +34 -2
  86. package/plugins/pbr/agents/planner.md +58 -1
  87. package/plugins/pbr/agents/researcher.md +23 -0
  88. package/plugins/pbr/agents/synthesizer.md +24 -0
  89. package/plugins/pbr/agents/verifier.md +36 -1
  90. package/plugins/pbr/references/agent-contracts.md +297 -0
  91. package/plugins/pbr/references/ui-formatting.md +37 -54
  92. package/plugins/pbr/scripts/check-roadmap-sync.js +9 -1
  93. package/plugins/pbr/scripts/check-skill-workflow.js +11 -0
  94. package/plugins/pbr/scripts/check-state-sync.js +58 -0
  95. package/plugins/pbr/scripts/check-subagent-output.js +75 -6
  96. package/plugins/pbr/scripts/log-tool-failure.js +1 -1
  97. package/plugins/pbr/scripts/progress-tracker.js +14 -0
  98. package/plugins/pbr/scripts/track-context-budget.js +10 -1
  99. package/plugins/pbr/scripts/validate-task.js +81 -17
  100. package/plugins/pbr/skills/begin/SKILL.md +36 -11
  101. package/plugins/pbr/skills/build/SKILL.md +37 -25
  102. package/plugins/pbr/skills/config/SKILL.md +12 -10
  103. package/plugins/pbr/skills/continue/SKILL.md +11 -9
  104. package/plugins/pbr/skills/dashboard/SKILL.md +3 -3
  105. package/plugins/pbr/skills/debug/SKILL.md +29 -23
  106. package/plugins/pbr/skills/discuss/SKILL.md +20 -10
  107. package/plugins/pbr/skills/do/SKILL.md +3 -3
  108. package/plugins/pbr/skills/explore/SKILL.md +14 -12
  109. package/plugins/pbr/skills/health/SKILL.md +76 -20
  110. package/plugins/pbr/skills/help/SKILL.md +8 -6
  111. package/plugins/pbr/skills/import/SKILL.md +25 -16
  112. package/plugins/pbr/skills/milestone/SKILL.md +88 -45
  113. package/plugins/pbr/skills/note/SKILL.md +3 -3
  114. package/plugins/pbr/skills/pause/SKILL.md +13 -9
  115. package/plugins/pbr/skills/plan/SKILL.md +28 -13
  116. package/plugins/pbr/skills/plan/templates/planner-prompt.md.tmpl +1 -1
  117. package/plugins/pbr/skills/quick/SKILL.md +12 -10
  118. package/plugins/pbr/skills/resume/SKILL.md +11 -9
  119. package/plugins/pbr/skills/review/SKILL.md +35 -24
  120. package/plugins/pbr/skills/scan/SKILL.md +12 -10
  121. package/plugins/pbr/skills/setup/SKILL.md +30 -7
  122. package/plugins/pbr/skills/shared/error-reporting.md +2 -0
  123. package/plugins/pbr/skills/shared/universal-anti-patterns.md +10 -6
  124. package/plugins/pbr/skills/status/SKILL.md +8 -6
  125. package/plugins/pbr/skills/statusline/SKILL.md +12 -8
  126. package/plugins/pbr/skills/todo/SKILL.md +51 -28
@@ -11,9 +11,9 @@ allowed-tools: Read, Glob, Grep, AskUserQuestion
11
11
  **Before ANY tool calls**, display this banner:
12
12
 
13
13
  ```
14
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
15
- PLAN-BUILD-RUN ► PROJECT STATUS
16
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
14
+ ╔══════════════════════════════════════════════════════════════╗
15
+ PLAN-BUILD-RUN ► PROJECT STATUS
16
+ ╚══════════════════════════════════════════════════════════════╝
17
17
  ```
18
18
 
19
19
  Then proceed to Step 1.
@@ -268,9 +268,11 @@ Based on the project state, suggest the single most logical next action:
268
268
  **If only one reasonable next action exists**, present it with branded routing:
269
269
 
270
270
  ```
271
- ───────────────────────────────────────────────────────────────
272
271
 
273
- ## ▶ Next Up
272
+
273
+ ╔══════════════════════════════════════════════════════════════╗
274
+ ║ ▶ NEXT UP ║
275
+ ╚══════════════════════════════════════════════════════════════╝
274
276
 
275
277
  **{brief explanation}**
276
278
 
@@ -278,7 +280,7 @@ Based on the project state, suggest the single most logical next action:
278
280
 
279
281
  <sub>`/clear` first → fresh context window</sub>
280
282
 
281
- ───────────────────────────────────────────────────────────────
283
+
282
284
  ```
283
285
 
284
286
  **If multiple reasonable next actions exist** (2-3 alternatives), use the **action-routing** pattern (see `skills/shared/gate-prompts.md`):
@@ -12,9 +12,9 @@ argument-hint: "[install | uninstall | preview]"
12
12
  **Before ANY tool calls**, display this banner:
13
13
 
14
14
  ```
15
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
16
- PLAN-BUILD-RUN ► STATUS LINE
17
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
15
+ ╔══════════════════════════════════════════════════════════════╗
16
+ PLAN-BUILD-RUN ► STATUS LINE
17
+ ╚══════════════════════════════════════════════════════════════╝
18
18
  ```
19
19
 
20
20
  Then proceed to Step 1.
@@ -78,9 +78,12 @@ If "Install":
78
78
 
79
79
  **CRITICAL: Use Read tool to read the file, then Write to update it. Do NOT use sed or other text manipulation on JSON files.**
80
80
 
81
+ **CRITICAL: Back up settings.json NOW.** Write the original content to `~/.claude/settings.json.bak` before making any changes.
82
+
81
83
  1. Read `~/.claude/settings.json`
82
- 2. Parse the JSON
83
- 3. Set `statusLine` to:
84
+ 2. Write the original content to `~/.claude/settings.json.bak`
85
+ 3. Parse the JSON
86
+ 4. Set `statusLine` to:
84
87
  ```json
85
88
  {
86
89
  "type": "command",
@@ -88,7 +91,7 @@ If "Install":
88
91
  }
89
92
  ```
90
93
  Where `SCRIPT_PATH` is the resolved absolute path from Step 1. Use forward slashes even on Windows.
91
- 4. Write the updated JSON back (preserve all other settings, use 2-space indentation)
94
+ 5. Write the updated JSON back (preserve all other settings, use 2-space indentation)
92
95
 
93
96
  ### Step 4: Verify and confirm
94
97
 
@@ -115,8 +118,9 @@ Customize per-project via .planning/config.json:
115
118
 
116
119
  1. Read `~/.claude/settings.json`
117
120
  2. If no `statusLine` key: inform user "No status line configured." and stop
118
- 3. Remove the `statusLine` key from the JSON
119
- 4. Write the updated file
121
+ 3. **CRITICAL: Back up settings.json NOW.** Write the original content to `~/.claude/settings.json.bak` before making any changes.
122
+ 4. Remove the `statusLine` key from the JSON
123
+ 5. Write the updated file
120
124
  5. Display: `✓ PBR status line removed. Restart Claude Code to take effect.`
121
125
 
122
126
  ---
@@ -12,9 +12,9 @@ argument-hint: "add <description> | list [theme] | done <NNN> | work <NNN>"
12
12
  **Before ANY tool calls**, display this banner:
13
13
 
14
14
  ```
15
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
16
- PLAN-BUILD-RUN ► TODO
17
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
15
+ ╔══════════════════════════════════════════════════════════════╗
16
+ PLAN-BUILD-RUN ► TODO
17
+ ╚══════════════════════════════════════════════════════════════╝
18
18
  ```
19
19
 
20
20
  Then proceed to Step 1.
@@ -76,15 +76,17 @@ theme: {inferred-theme}
76
76
 
77
77
  8. Confirm with branded output:
78
78
  ```
79
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
80
- PLAN-BUILD-RUN ► TODO ADDED ✓
81
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
79
+ ╔══════════════════════════════════════════════════════════════╗
80
+ PLAN-BUILD-RUN ► TODO ADDED ✓
81
+ ╚══════════════════════════════════════════════════════════════╝
82
82
 
83
83
  **Todo {NNN}:** {description}
84
84
 
85
- ───────────────────────────────────────────────────────────────
86
85
 
87
- ## ▶ Next Up
86
+
87
+ ╔══════════════════════════════════════════════════════════════╗
88
+ ║ ▶ NEXT UP ║
89
+ ╚══════════════════════════════════════════════════════════════╝
88
90
 
89
91
  **Work on it now** or see your task list
90
92
 
@@ -92,13 +94,13 @@ theme: {inferred-theme}
92
94
 
93
95
  <sub>`/clear` first → fresh context window</sub>
94
96
 
95
- ───────────────────────────────────────────────────────────────
97
+
96
98
 
97
99
  **Also available:**
98
100
  - `/pbr:todo list` — see all pending todos
99
101
  - `/pbr:status` — see project status
100
102
 
101
- ───────────────────────────────────────────────────────────────
103
+
102
104
  ```
103
105
 
104
106
  ### `list [theme]`
@@ -118,21 +120,23 @@ Pending Todos:
118
120
 
119
121
  5. Offer actions with branded routing:
120
122
  ```
121
- ───────────────────────────────────────────────────────────────
122
123
 
123
- ## ▶ Next Up
124
+
125
+ ╔══════════════════════════════════════════════════════════════╗
126
+ ║ ▶ NEXT UP ║
127
+ ╚══════════════════════════════════════════════════════════════╝
124
128
 
125
129
  **Pick a todo** — mark one done or start working
126
130
 
127
131
  `/pbr:todo work <NNN>` — start working on a todo
128
132
  `/pbr:todo done <NNN>` — mark a todo as complete
129
133
 
130
- ───────────────────────────────────────────────────────────────
134
+
131
135
 
132
136
  **Also available:**
133
137
  - `/pbr:status` — see project status
134
138
 
135
- ───────────────────────────────────────────────────────────────
139
+
136
140
  ```
137
141
 
138
142
  ### `done <NNN>`
@@ -151,20 +155,37 @@ Todo {NNN} not found in pending todos.
151
155
  3. Ensure `.planning/todos/done/` directory exists (create if needed)
152
156
  4. Read the pending file content
153
157
  5. Update frontmatter in the content: set `status: done` and add `completed: {YYYY-MM-DD}`
158
+
159
+ **CRITICAL: Write to done/ FIRST, verify it exists, THEN delete from pending/. Do NOT delete pending before confirming done/ write succeeded.**
160
+
154
161
  6. Write the updated content to `.planning/todos/done/{NNN}-{slug}.md`
155
- 7. Delete the original file from `.planning/todos/pending/` (use `rm` via Bash)
162
+ 7. Verify the done/ file was written successfully: check that `.planning/todos/done/{NNN}-{slug}.md` exists and has content (use `ls` or Glob)
163
+ - If the done/ write failed, abort and display:
164
+ ```
165
+ ╔══════════════════════════════════════════════════════════════╗
166
+ ║ ERROR ║
167
+ ╚══════════════════════════════════════════════════════════════╝
168
+
169
+ Failed to write to done/. Pending file preserved.
170
+
171
+ **To fix:** Check that `.planning/todos/done/` exists and is writable.
172
+ ```
173
+ Do NOT proceed to delete the pending file.
174
+ 8. Only THEN delete the original file from `.planning/todos/pending/` (use `rm` via Bash)
156
175
  8. Update STATE.md
157
176
  9. Confirm with branded output:
158
177
  ```
159
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
160
- PLAN-BUILD-RUN ► TODO COMPLETED ✓
161
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
178
+ ╔══════════════════════════════════════════════════════════════╗
179
+ PLAN-BUILD-RUN ► TODO COMPLETED ✓
180
+ ╚══════════════════════════════════════════════════════════════╝
162
181
 
163
182
  **Todo {NNN}:** {title}
164
183
 
165
- ───────────────────────────────────────────────────────────────
166
184
 
167
- ## ▶ Next Up
185
+
186
+ ╔══════════════════════════════════════════════════════════════╗
187
+ ║ ▶ NEXT UP ║
188
+ ╚══════════════════════════════════════════════════════════════╝
168
189
 
169
190
  **See remaining tasks**
170
191
 
@@ -172,13 +193,13 @@ Todo {NNN} not found in pending todos.
172
193
 
173
194
  <sub>`/clear` first → fresh context window</sub>
174
195
 
175
- ───────────────────────────────────────────────────────────────
196
+
176
197
 
177
198
  **Also available:**
178
199
  - `/pbr:continue` — execute next logical step
179
200
  - `/pbr:status` — see project status
180
201
 
181
- ───────────────────────────────────────────────────────────────
202
+
182
203
  ```
183
204
 
184
205
  ### `work <NNN>`
@@ -210,9 +231,9 @@ Which approach?
210
231
 
211
232
  6. Display branded output:
212
233
  ```
213
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
214
- PLAN-BUILD-RUN ► WORKING ON TODO {NNN}
215
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
234
+ ╔══════════════════════════════════════════════════════════════╗
235
+ PLAN-BUILD-RUN ► WORKING ON TODO {NNN}
236
+ ╚══════════════════════════════════════════════════════════════╝
216
237
 
217
238
  **Todo {NNN}:** {title}
218
239
  **Routing to:** /pbr:{chosen-skill}
@@ -232,15 +253,17 @@ For `/pbr:plan`, if no phase exists for this work yet, suggest the user run `/pb
232
253
  8. When the skill completes, remind the user:
233
254
 
234
255
  ```
235
- ───────────────────────────────────────────────────────────────
236
256
 
237
- ## ▶ Next Up
257
+
258
+ ╔══════════════════════════════════════════════════════════════╗
259
+ ║ ▶ NEXT UP ║
260
+ ╚══════════════════════════════════════════════════════════════╝
238
261
 
239
262
  **Mark this todo as done if the work is complete**
240
263
 
241
264
  `/pbr:todo done {NNN}`
242
265
 
243
- ───────────────────────────────────────────────────────────────
266
+
244
267
  ```
245
268
 
246
269
  ### No arguments