@sienklogic/plan-build-run 2.0.0 → 2.0.2

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 (233) hide show
  1. package/CHANGELOG.md +56 -56
  2. package/CLAUDE.md +149 -149
  3. package/LICENSE +21 -21
  4. package/README.md +247 -247
  5. package/dashboard/bin/cli.js +25 -25
  6. package/dashboard/package.json +34 -34
  7. package/dashboard/public/css/layout.css +406 -406
  8. package/dashboard/public/css/status-colors.css +98 -98
  9. package/dashboard/public/js/htmx-title.js +5 -5
  10. package/dashboard/public/js/sidebar-toggle.js +20 -20
  11. package/dashboard/src/app.js +78 -78
  12. package/dashboard/src/middleware/errorHandler.js +52 -52
  13. package/dashboard/src/middleware/notFoundHandler.js +9 -9
  14. package/dashboard/src/repositories/planning.repository.js +128 -128
  15. package/dashboard/src/routes/events.routes.js +40 -40
  16. package/dashboard/src/routes/index.routes.js +31 -31
  17. package/dashboard/src/routes/pages.routes.js +245 -195
  18. package/dashboard/src/server.js +42 -42
  19. package/dashboard/src/services/dashboard.service.js +222 -222
  20. package/dashboard/src/services/phase.service.js +220 -167
  21. package/dashboard/src/services/project.service.js +57 -57
  22. package/dashboard/src/services/roadmap.service.js +171 -171
  23. package/dashboard/src/services/sse.service.js +58 -58
  24. package/dashboard/src/services/todo.service.js +254 -254
  25. package/dashboard/src/services/watcher.service.js +48 -48
  26. package/dashboard/src/views/coming-soon.ejs +11 -11
  27. package/dashboard/src/views/error.ejs +13 -13
  28. package/dashboard/src/views/index.ejs +5 -5
  29. package/dashboard/src/views/layout.ejs +1 -1
  30. package/dashboard/src/views/partials/dashboard-content.ejs +77 -77
  31. package/dashboard/src/views/partials/footer.ejs +3 -3
  32. package/dashboard/src/views/partials/head.ejs +21 -21
  33. package/dashboard/src/views/partials/header.ejs +12 -12
  34. package/dashboard/src/views/partials/layout-bottom.ejs +15 -15
  35. package/dashboard/src/views/partials/layout-top.ejs +8 -8
  36. package/dashboard/src/views/partials/phase-content.ejs +188 -181
  37. package/dashboard/src/views/partials/phase-doc-content.ejs +38 -0
  38. package/dashboard/src/views/partials/phases-content.ejs +117 -117
  39. package/dashboard/src/views/partials/roadmap-content.ejs +142 -142
  40. package/dashboard/src/views/partials/sidebar.ejs +38 -38
  41. package/dashboard/src/views/partials/todo-create-content.ejs +53 -53
  42. package/dashboard/src/views/partials/todo-detail-content.ejs +38 -38
  43. package/dashboard/src/views/partials/todos-content.ejs +53 -53
  44. package/dashboard/src/views/phase-detail.ejs +5 -5
  45. package/dashboard/src/views/phase-doc.ejs +5 -0
  46. package/dashboard/src/views/phases.ejs +5 -5
  47. package/dashboard/src/views/roadmap.ejs +5 -5
  48. package/dashboard/src/views/todo-create.ejs +5 -5
  49. package/dashboard/src/views/todo-detail.ejs +5 -5
  50. package/dashboard/src/views/todos.ejs +5 -5
  51. package/package.json +57 -57
  52. package/plugins/cursor-pbr/.cursor-plugin/plugin.json +22 -0
  53. package/plugins/cursor-pbr/agents/.gitkeep +0 -0
  54. package/plugins/cursor-pbr/assets/.gitkeep +0 -0
  55. package/plugins/cursor-pbr/hooks/hooks.json +11 -0
  56. package/plugins/cursor-pbr/references/.gitkeep +0 -0
  57. package/plugins/cursor-pbr/rules/.gitkeep +0 -0
  58. package/plugins/cursor-pbr/skills/.gitkeep +0 -0
  59. package/plugins/cursor-pbr/templates/.gitkeep +0 -0
  60. package/plugins/pbr/.claude-plugin/plugin.json +13 -13
  61. package/plugins/pbr/UI-CONSISTENCY-GAPS.md +61 -61
  62. package/plugins/pbr/agents/codebase-mapper.md +279 -271
  63. package/plugins/pbr/agents/debugger.md +281 -281
  64. package/plugins/pbr/agents/executor.md +428 -407
  65. package/plugins/pbr/agents/general.md +164 -164
  66. package/plugins/pbr/agents/integration-checker.md +169 -141
  67. package/plugins/pbr/agents/plan-checker.md +296 -280
  68. package/plugins/pbr/agents/planner.md +358 -358
  69. package/plugins/pbr/agents/researcher.md +363 -363
  70. package/plugins/pbr/agents/synthesizer.md +230 -230
  71. package/plugins/pbr/agents/verifier.md +489 -454
  72. package/plugins/pbr/commands/begin.md +5 -5
  73. package/plugins/pbr/commands/build.md +5 -5
  74. package/plugins/pbr/commands/config.md +5 -5
  75. package/plugins/pbr/commands/continue.md +5 -5
  76. package/plugins/pbr/commands/debug.md +5 -5
  77. package/plugins/pbr/commands/discuss.md +5 -5
  78. package/plugins/pbr/commands/explore.md +5 -5
  79. package/plugins/pbr/commands/health.md +5 -5
  80. package/plugins/pbr/commands/help.md +5 -5
  81. package/plugins/pbr/commands/import.md +5 -5
  82. package/plugins/pbr/commands/milestone.md +5 -5
  83. package/plugins/pbr/commands/note.md +5 -5
  84. package/plugins/pbr/commands/pause.md +5 -5
  85. package/plugins/pbr/commands/plan.md +5 -5
  86. package/plugins/pbr/commands/quick.md +5 -5
  87. package/plugins/pbr/commands/resume.md +5 -5
  88. package/plugins/pbr/commands/review.md +5 -5
  89. package/plugins/pbr/commands/scan.md +5 -5
  90. package/plugins/pbr/commands/setup.md +5 -5
  91. package/plugins/pbr/commands/status.md +5 -5
  92. package/plugins/pbr/commands/todo.md +5 -5
  93. package/plugins/pbr/contexts/dev.md +27 -27
  94. package/plugins/pbr/contexts/research.md +28 -28
  95. package/plugins/pbr/contexts/review.md +36 -36
  96. package/plugins/pbr/hooks/hooks.json +183 -183
  97. package/plugins/pbr/references/agent-anti-patterns.md +24 -24
  98. package/plugins/pbr/references/agent-interactions.md +134 -134
  99. package/plugins/pbr/references/agent-teams.md +54 -54
  100. package/plugins/pbr/references/checkpoints.md +157 -157
  101. package/plugins/pbr/references/common-bug-patterns.md +13 -13
  102. package/plugins/pbr/references/config-reference.md +441 -0
  103. package/plugins/pbr/references/continuation-format.md +212 -212
  104. package/plugins/pbr/references/deviation-rules.md +112 -112
  105. package/plugins/pbr/references/git-integration.md +226 -226
  106. package/plugins/pbr/references/integration-patterns.md +117 -117
  107. package/plugins/pbr/references/model-profiles.md +99 -99
  108. package/plugins/pbr/references/model-selection.md +31 -31
  109. package/plugins/pbr/references/pbr-rules.md +193 -193
  110. package/plugins/pbr/references/plan-authoring.md +181 -181
  111. package/plugins/pbr/references/plan-format.md +287 -283
  112. package/plugins/pbr/references/planning-config.md +213 -213
  113. package/plugins/pbr/references/questioning.md +214 -214
  114. package/plugins/pbr/references/reading-verification.md +127 -127
  115. package/plugins/pbr/references/stub-patterns.md +160 -160
  116. package/plugins/pbr/references/subagent-coordination.md +119 -119
  117. package/plugins/pbr/references/ui-formatting.md +461 -399
  118. package/plugins/pbr/references/verification-patterns.md +198 -198
  119. package/plugins/pbr/references/wave-execution.md +95 -95
  120. package/plugins/pbr/scripts/auto-continue.js +80 -80
  121. package/plugins/pbr/scripts/check-dangerous-commands.js +136 -136
  122. package/plugins/pbr/scripts/check-doc-sprawl.js +102 -102
  123. package/plugins/pbr/scripts/check-phase-boundary.js +196 -196
  124. package/plugins/pbr/scripts/check-plan-format.js +270 -270
  125. package/plugins/pbr/scripts/check-roadmap-sync.js +322 -252
  126. package/plugins/pbr/scripts/check-skill-workflow.js +262 -262
  127. package/plugins/pbr/scripts/check-state-sync.js +476 -476
  128. package/plugins/pbr/scripts/check-subagent-output.js +144 -144
  129. package/plugins/pbr/scripts/config-schema.json +251 -251
  130. package/plugins/pbr/scripts/context-budget-check.js +287 -287
  131. package/plugins/pbr/scripts/event-handler.js +151 -151
  132. package/plugins/pbr/scripts/event-logger.js +92 -92
  133. package/plugins/pbr/scripts/hook-logger.js +80 -76
  134. package/plugins/pbr/scripts/hooks-schema.json +79 -79
  135. package/plugins/pbr/scripts/log-subagent.js +164 -152
  136. package/plugins/pbr/scripts/log-tool-failure.js +88 -88
  137. package/plugins/pbr/scripts/pbr-tools.js +1378 -1301
  138. package/plugins/pbr/scripts/post-write-dispatch.js +66 -66
  139. package/plugins/pbr/scripts/post-write-quality.js +207 -207
  140. package/plugins/pbr/scripts/pre-bash-dispatch.js +86 -56
  141. package/plugins/pbr/scripts/pre-write-dispatch.js +97 -62
  142. package/plugins/pbr/scripts/progress-tracker.js +281 -228
  143. package/plugins/pbr/scripts/run-hook.js +92 -0
  144. package/plugins/pbr/scripts/session-cleanup.js +254 -254
  145. package/plugins/pbr/scripts/status-line.js +288 -285
  146. package/plugins/pbr/scripts/suggest-compact.js +119 -119
  147. package/plugins/pbr/scripts/task-completed.js +45 -45
  148. package/plugins/pbr/scripts/track-context-budget.js +149 -119
  149. package/plugins/pbr/scripts/validate-commit.js +200 -200
  150. package/plugins/pbr/scripts/validate-plugin-structure.js +183 -172
  151. package/plugins/pbr/scripts/validate-task.js +106 -0
  152. package/plugins/pbr/skills/begin/SKILL.md +594 -545
  153. package/plugins/pbr/skills/begin/templates/PROJECT.md.tmpl +33 -33
  154. package/plugins/pbr/skills/begin/templates/REQUIREMENTS.md.tmpl +18 -18
  155. package/plugins/pbr/skills/begin/templates/STATE.md.tmpl +49 -49
  156. package/plugins/pbr/skills/begin/templates/config.json.tmpl +64 -63
  157. package/plugins/pbr/skills/begin/templates/researcher-prompt.md.tmpl +19 -19
  158. package/plugins/pbr/skills/begin/templates/roadmap-prompt.md.tmpl +30 -30
  159. package/plugins/pbr/skills/begin/templates/synthesis-prompt.md.tmpl +16 -16
  160. package/plugins/pbr/skills/build/SKILL.md +943 -962
  161. package/plugins/pbr/skills/config/SKILL.md +256 -241
  162. package/plugins/pbr/skills/continue/SKILL.md +164 -127
  163. package/plugins/pbr/skills/debug/SKILL.md +515 -489
  164. package/plugins/pbr/skills/debug/templates/continuation-prompt.md.tmpl +16 -16
  165. package/plugins/pbr/skills/debug/templates/initial-investigation-prompt.md.tmpl +27 -27
  166. package/plugins/pbr/skills/discuss/SKILL.md +347 -338
  167. package/plugins/pbr/skills/discuss/templates/CONTEXT.md.tmpl +61 -61
  168. package/plugins/pbr/skills/discuss/templates/decision-categories.md +9 -9
  169. package/plugins/pbr/skills/explore/SKILL.md +378 -362
  170. package/plugins/pbr/skills/health/SKILL.md +221 -186
  171. package/plugins/pbr/skills/health/templates/check-pattern.md.tmpl +30 -30
  172. package/plugins/pbr/skills/health/templates/output-format.md.tmpl +63 -63
  173. package/plugins/pbr/skills/help/SKILL.md +155 -140
  174. package/plugins/pbr/skills/import/SKILL.md +504 -490
  175. package/plugins/pbr/skills/milestone/SKILL.md +704 -673
  176. package/plugins/pbr/skills/milestone/templates/audit-report.md.tmpl +48 -48
  177. package/plugins/pbr/skills/milestone/templates/stats-file.md.tmpl +30 -30
  178. package/plugins/pbr/skills/note/SKILL.md +231 -212
  179. package/plugins/pbr/skills/pause/SKILL.md +249 -235
  180. package/plugins/pbr/skills/pause/templates/continue-here.md.tmpl +71 -71
  181. package/plugins/pbr/skills/plan/SKILL.md +685 -628
  182. package/plugins/pbr/skills/plan/decimal-phase-calc.md +98 -98
  183. package/plugins/pbr/skills/plan/templates/checker-prompt.md.tmpl +21 -21
  184. package/plugins/pbr/skills/plan/templates/gap-closure-prompt.md.tmpl +32 -32
  185. package/plugins/pbr/skills/plan/templates/planner-prompt.md.tmpl +38 -38
  186. package/plugins/pbr/skills/plan/templates/researcher-prompt.md.tmpl +19 -19
  187. package/plugins/pbr/skills/plan/templates/revision-prompt.md.tmpl +23 -23
  188. package/plugins/pbr/skills/quick/SKILL.md +354 -335
  189. package/plugins/pbr/skills/resume/SKILL.md +402 -388
  190. package/plugins/pbr/skills/review/SKILL.md +686 -652
  191. package/plugins/pbr/skills/review/templates/debugger-prompt.md.tmpl +60 -60
  192. package/plugins/pbr/skills/review/templates/gap-planner-prompt.md.tmpl +40 -40
  193. package/plugins/pbr/skills/review/templates/verifier-prompt.md.tmpl +115 -115
  194. package/plugins/pbr/skills/scan/SKILL.md +304 -269
  195. package/plugins/pbr/skills/scan/templates/mapper-prompt.md.tmpl +201 -201
  196. package/plugins/pbr/skills/setup/SKILL.md +253 -227
  197. package/plugins/pbr/skills/shared/commit-planning-docs.md +35 -35
  198. package/plugins/pbr/skills/shared/config-loading.md +102 -102
  199. package/plugins/pbr/skills/shared/context-budget.md +40 -40
  200. package/plugins/pbr/skills/shared/context-loader-task.md +86 -86
  201. package/plugins/pbr/skills/shared/digest-select.md +79 -79
  202. package/plugins/pbr/skills/shared/domain-probes.md +125 -125
  203. package/plugins/pbr/skills/shared/error-reporting.md +79 -79
  204. package/plugins/pbr/skills/shared/gate-prompts.md +388 -388
  205. package/plugins/pbr/skills/shared/phase-argument-parsing.md +45 -45
  206. package/plugins/pbr/skills/shared/progress-display.md +53 -53
  207. package/plugins/pbr/skills/shared/revision-loop.md +81 -81
  208. package/plugins/pbr/skills/shared/state-loading.md +62 -62
  209. package/plugins/pbr/skills/shared/state-update.md +161 -161
  210. package/plugins/pbr/skills/shared/universal-anti-patterns.md +33 -33
  211. package/plugins/pbr/skills/status/SKILL.md +367 -353
  212. package/plugins/pbr/skills/todo/SKILL.md +198 -181
  213. package/plugins/pbr/templates/CONTEXT.md.tmpl +52 -52
  214. package/plugins/pbr/templates/INTEGRATION-REPORT.md.tmpl +151 -151
  215. package/plugins/pbr/templates/RESEARCH-SUMMARY.md.tmpl +97 -97
  216. package/plugins/pbr/templates/ROADMAP.md.tmpl +40 -40
  217. package/plugins/pbr/templates/SUMMARY.md.tmpl +81 -81
  218. package/plugins/pbr/templates/VERIFICATION-DETAIL.md.tmpl +116 -116
  219. package/plugins/pbr/templates/codebase/ARCHITECTURE.md.tmpl +98 -98
  220. package/plugins/pbr/templates/codebase/CONCERNS.md.tmpl +93 -93
  221. package/plugins/pbr/templates/codebase/CONVENTIONS.md.tmpl +104 -104
  222. package/plugins/pbr/templates/codebase/INTEGRATIONS.md.tmpl +78 -78
  223. package/plugins/pbr/templates/codebase/STACK.md.tmpl +78 -78
  224. package/plugins/pbr/templates/codebase/STRUCTURE.md.tmpl +80 -80
  225. package/plugins/pbr/templates/codebase/TESTING.md.tmpl +107 -107
  226. package/plugins/pbr/templates/continue-here.md.tmpl +73 -73
  227. package/plugins/pbr/templates/prompt-partials/phase-project-context.md.tmpl +37 -37
  228. package/plugins/pbr/templates/research/ARCHITECTURE.md.tmpl +124 -124
  229. package/plugins/pbr/templates/research/STACK.md.tmpl +71 -71
  230. package/plugins/pbr/templates/research/SUMMARY.md.tmpl +112 -112
  231. package/plugins/pbr/templates/research-outputs/phase-research.md.tmpl +81 -81
  232. package/plugins/pbr/templates/research-outputs/project-research.md.tmpl +99 -99
  233. package/plugins/pbr/templates/research-outputs/synthesis.md.tmpl +36 -36
@@ -1,73 +1,73 @@
1
- <!-- Source: skills/pause/SKILL.md | Purpose: Handoff file for session pause/resume, placed in the active phase directory -->
2
-
3
- # Template: Continue Here Handoff File
4
- # Used by: pause/SKILL.md (Step 4)
5
- # Output path: .planning/phases/{NN}-{phase-name}/.continue-here.md
6
- # Variables: {datetime}, {hours}, {phase}, {plan}, {status}, {session work}, {remaining}, {decisions}, {blockers}, {context}, {next steps}
7
-
8
- # Continue Here
9
-
10
- **Paused:** {ISO datetime}
11
- **Session duration:** ~{estimated hours} (based on git log timestamps)
12
-
13
- ## Position
14
-
15
- Phase: {N} -- {name}
16
- Plan: {M} of {total} (or "between plans" / "phase complete")
17
- Status: {in-progress / between-plans / reviewing / planning}
18
-
19
- ## Completed This Session
20
-
21
- {List of work done, with commit references where available}
22
-
23
- - Plan {A}: {summary} (commit: {short hash})
24
- - Plan {B}: {summary} (commit: {short hash})
25
- - Quick task: {description} (commit: {short hash})
26
-
27
- {If nothing was completed:}
28
- - No plans completed this session (discussion/planning only)
29
-
30
- ## Remaining
31
-
32
- {What still needs to be done in this phase}
33
-
34
- - Plan {C}: {brief description from plan frontmatter}
35
- - Plan {D}: {brief description from plan frontmatter}
36
-
37
- {If phase is complete:}
38
- - Phase {N} is complete. Next: {review or next phase}
39
-
40
- ## Decisions Made
41
-
42
- {Key decisions from this session that affect future work}
43
-
44
- - {decision 1}: {brief description}
45
- - {decision 2}: {brief description}
46
-
47
- {If no notable decisions:}
48
- - No major decisions this session
49
-
50
- ## Blockers
51
-
52
- {Any issues preventing progress}
53
-
54
- - {blocker description}
55
-
56
- {If no blockers:}
57
- - None
58
-
59
- ## Context Notes
60
-
61
- {Any additional context that would help the next session}
62
-
63
- - {note about something tricky}
64
- - {note about something to watch out for}
65
- - {note about user preferences expressed during this session}
66
-
67
- ## Next Steps
68
-
69
- {Ordered list of what to do when resuming}
70
-
71
- 1. {Specific first action with command}
72
- 2. {Following action}
73
- 3. {And so on}
1
+ <!-- Source: skills/pause/SKILL.md | Purpose: Handoff file for session pause/resume, placed in the active phase directory -->
2
+
3
+ # Template: Continue Here Handoff File
4
+ # Used by: pause/SKILL.md (Step 4)
5
+ # Output path: .planning/phases/{NN}-{phase-name}/.continue-here.md
6
+ # Variables: {datetime}, {hours}, {phase}, {plan}, {status}, {session work}, {remaining}, {decisions}, {blockers}, {context}, {next steps}
7
+
8
+ # Continue Here
9
+
10
+ **Paused:** {ISO datetime}
11
+ **Session duration:** ~{estimated hours} (based on git log timestamps)
12
+
13
+ ## Position
14
+
15
+ Phase: {N} -- {name}
16
+ Plan: {M} of {total} (or "between plans" / "phase complete")
17
+ Status: {in-progress / between-plans / reviewing / planning}
18
+
19
+ ## Completed This Session
20
+
21
+ {List of work done, with commit references where available}
22
+
23
+ - Plan {A}: {summary} (commit: {short hash})
24
+ - Plan {B}: {summary} (commit: {short hash})
25
+ - Quick task: {description} (commit: {short hash})
26
+
27
+ {If nothing was completed:}
28
+ - No plans completed this session (discussion/planning only)
29
+
30
+ ## Remaining
31
+
32
+ {What still needs to be done in this phase}
33
+
34
+ - Plan {C}: {brief description from plan frontmatter}
35
+ - Plan {D}: {brief description from plan frontmatter}
36
+
37
+ {If phase is complete:}
38
+ - Phase {N} is complete. Next: {review or next phase}
39
+
40
+ ## Decisions Made
41
+
42
+ {Key decisions from this session that affect future work}
43
+
44
+ - {decision 1}: {brief description}
45
+ - {decision 2}: {brief description}
46
+
47
+ {If no notable decisions:}
48
+ - No major decisions this session
49
+
50
+ ## Blockers
51
+
52
+ {Any issues preventing progress}
53
+
54
+ - {blocker description}
55
+
56
+ {If no blockers:}
57
+ - None
58
+
59
+ ## Context Notes
60
+
61
+ {Any additional context that would help the next session}
62
+
63
+ - {note about something tricky}
64
+ - {note about something to watch out for}
65
+ - {note about user preferences expressed during this session}
66
+
67
+ ## Next Steps
68
+
69
+ {Ordered list of what to do when resuming}
70
+
71
+ 1. {Specific first action with command}
72
+ 2. {Following action}
73
+ 3. {And so on}
@@ -1,37 +1,37 @@
1
- <!-- Source: templates/prompt-partials/ | Purpose: Shared context blocks for agent prompt templates -->
2
- <!-- Usage: Read this file and fill in placeholders, then include the result in agent prompts. -->
3
- <!-- Orchestrators should omit sections that don't apply to their agent type. -->
4
-
5
- <phase_context>
6
- Phase: {NN} - {phase_name}
7
- Phase directory: .planning/phases/{NN}-{slug}/
8
- Phase goal: {goal from roadmap}
9
- Phase requirements: {REQ-IDs mapped to this phase, or "None"}
10
- Phase depends on: {dependency phases, or "None"}
11
- Success criteria from roadmap:
12
- {success criteria list, or omit if not applicable}
13
- </phase_context>
14
-
15
- <project_context>
16
- {Decision Summary from .planning/CONTEXT.md — compact locked/deferred/discretion list}
17
- {If no CONTEXT.md exists: "No project-level context."}
18
-
19
- Phase-specific decisions:
20
- {Decision Summary from .planning/phases/{NN}-{slug}/CONTEXT.md}
21
- {If no phase-level CONTEXT.md exists: "No phase-specific discussion captured."}
22
-
23
- Full context files (Read on-demand if you need scope/quality/integration details):
24
- - .planning/CONTEXT.md
25
- - .planning/phases/{NN}-{slug}/CONTEXT.md
26
- </project_context>
27
-
28
- <prior_work>
29
- The following prior phase summaries are available. Read any you need via the Read tool.
30
-
31
- | Phase | Summary File | Status | Key Exports |
32
- |-------|-------------|--------|-------------|
33
- {For each preceding phase SUMMARY.md:}
34
- | {M} - {name} | {absolute path to SUMMARY.md} | {complete/partial} | {one-line provides list} |
35
-
36
- {If no prior phases: "No prior phases completed."}
37
- </prior_work>
1
+ <!-- Source: templates/prompt-partials/ | Purpose: Shared context blocks for agent prompt templates -->
2
+ <!-- Usage: Read this file and fill in placeholders, then include the result in agent prompts. -->
3
+ <!-- Orchestrators should omit sections that don't apply to their agent type. -->
4
+
5
+ <phase_context>
6
+ Phase: {NN} - {phase_name}
7
+ Phase directory: .planning/phases/{NN}-{slug}/
8
+ Phase goal: {goal from roadmap}
9
+ Phase requirements: {REQ-IDs mapped to this phase, or "None"}
10
+ Phase depends on: {dependency phases, or "None"}
11
+ Success criteria from roadmap:
12
+ {success criteria list, or omit if not applicable}
13
+ </phase_context>
14
+
15
+ <project_context>
16
+ {Decision Summary from .planning/CONTEXT.md — compact locked/deferred/discretion list}
17
+ {If no CONTEXT.md exists: "No project-level context."}
18
+
19
+ Phase-specific decisions:
20
+ {Decision Summary from .planning/phases/{NN}-{slug}/CONTEXT.md}
21
+ {If no phase-level CONTEXT.md exists: "No phase-specific discussion captured."}
22
+
23
+ Full context files (Read on-demand if you need scope/quality/integration details):
24
+ - .planning/CONTEXT.md
25
+ - .planning/phases/{NN}-{slug}/CONTEXT.md
26
+ </project_context>
27
+
28
+ <prior_work>
29
+ The following prior phase summaries are available. Read any you need via the Read tool.
30
+
31
+ | Phase | Summary File | Status | Key Exports |
32
+ |-------|-------------|--------|-------------|
33
+ {For each preceding phase SUMMARY.md:}
34
+ | {M} - {name} | {absolute path to SUMMARY.md} | {complete/partial} | {one-line provides list} |
35
+
36
+ {If no prior phases: "No prior phases completed."}
37
+ </prior_work>
@@ -1,124 +1,124 @@
1
- <!-- Source: agents/researcher.md | Purpose: Output format for research project ARCHITECTURE.md -->
2
- # Architecture Research
3
-
4
- **Domain:** {domain}
5
- **Researched:** {date}
6
- **Confidence:** {confidence}
7
-
8
- ## Standard Architecture
9
-
10
- ### System Overview
11
-
12
- ```
13
- {ascii_architecture_diagram}
14
- ```
15
-
16
- ### Component Responsibilities
17
-
18
- | Component | Responsibility | Typical Implementation |
19
- |-----------|----------------|------------------------|
20
- | {component} | {responsibility} | {implementation} |
21
-
22
- ## Recommended Project Structure
23
-
24
- ```
25
- src/
26
- {project_structure}
27
- ```
28
-
29
- ### Structure Rationale
30
-
31
- - **{folder}/:** {rationale}
32
-
33
- ## Architectural Patterns
34
-
35
- ### Pattern 1: {pattern_name}
36
-
37
- **What:** {description}
38
- **When to use:** {conditions}
39
- **Trade-offs:** {pros_and_cons}
40
-
41
- **Example:**
42
- ```{language}
43
- {code_example}
44
- ```
45
-
46
- ### Pattern 2: {pattern_name}
47
-
48
- **What:** {description}
49
- **When to use:** {conditions}
50
- **Trade-offs:** {pros_and_cons}
51
-
52
- ### Pattern 3: {pattern_name}
53
-
54
- **What:** {description}
55
- **When to use:** {conditions}
56
- **Trade-offs:** {pros_and_cons}
57
-
58
- ## Data Flow
59
-
60
- ### Request Flow
61
-
62
- ```
63
- {request_flow_diagram}
64
- ```
65
-
66
- ### State Management
67
-
68
- ```
69
- {state_management_diagram}
70
- ```
71
-
72
- ### Key Data Flows
73
-
74
- 1. **{flow_name}:** {description}
75
- 2. **{flow_name}:** {description}
76
-
77
- ## Scaling Considerations
78
-
79
- | Scale | Architecture Adjustments |
80
- |-------|--------------------------|
81
- | 0-1k users | {approach} |
82
- | 1k-100k users | {approach} |
83
- | 100k+ users | {approach} |
84
-
85
- ### Scaling Priorities
86
-
87
- 1. **First bottleneck:** {description}
88
- 2. **Second bottleneck:** {description}
89
-
90
- ## Anti-Patterns
91
-
92
- ### Anti-Pattern 1: {name}
93
-
94
- **What people do:** {mistake}
95
- **Why it's wrong:** {problem}
96
- **Do this instead:** {correct_approach}
97
-
98
- ### Anti-Pattern 2: {name}
99
-
100
- **What people do:** {mistake}
101
- **Why it's wrong:** {problem}
102
- **Do this instead:** {correct_approach}
103
-
104
- ## Integration Points
105
-
106
- ### External Services
107
-
108
- | Service | Integration Pattern | Notes |
109
- |---------|---------------------|-------|
110
- | {service} | {pattern} | {notes} |
111
-
112
- ### Internal Boundaries
113
-
114
- | Boundary | Communication | Notes |
115
- |----------|---------------|-------|
116
- | {boundary} | {communication} | {notes} |
117
-
118
- ## Sources
119
-
120
- - {sources}
121
-
122
- ---
123
- *Architecture research for: {domain}*
124
- *Researched: {date}*
1
+ <!-- Source: agents/researcher.md | Purpose: Output format for research project ARCHITECTURE.md -->
2
+ # Architecture Research
3
+
4
+ **Domain:** {domain}
5
+ **Researched:** {date}
6
+ **Confidence:** {confidence}
7
+
8
+ ## Standard Architecture
9
+
10
+ ### System Overview
11
+
12
+ ```
13
+ {ascii_architecture_diagram}
14
+ ```
15
+
16
+ ### Component Responsibilities
17
+
18
+ | Component | Responsibility | Typical Implementation |
19
+ |-----------|----------------|------------------------|
20
+ | {component} | {responsibility} | {implementation} |
21
+
22
+ ## Recommended Project Structure
23
+
24
+ ```
25
+ src/
26
+ {project_structure}
27
+ ```
28
+
29
+ ### Structure Rationale
30
+
31
+ - **{folder}/:** {rationale}
32
+
33
+ ## Architectural Patterns
34
+
35
+ ### Pattern 1: {pattern_name}
36
+
37
+ **What:** {description}
38
+ **When to use:** {conditions}
39
+ **Trade-offs:** {pros_and_cons}
40
+
41
+ **Example:**
42
+ ```{language}
43
+ {code_example}
44
+ ```
45
+
46
+ ### Pattern 2: {pattern_name}
47
+
48
+ **What:** {description}
49
+ **When to use:** {conditions}
50
+ **Trade-offs:** {pros_and_cons}
51
+
52
+ ### Pattern 3: {pattern_name}
53
+
54
+ **What:** {description}
55
+ **When to use:** {conditions}
56
+ **Trade-offs:** {pros_and_cons}
57
+
58
+ ## Data Flow
59
+
60
+ ### Request Flow
61
+
62
+ ```
63
+ {request_flow_diagram}
64
+ ```
65
+
66
+ ### State Management
67
+
68
+ ```
69
+ {state_management_diagram}
70
+ ```
71
+
72
+ ### Key Data Flows
73
+
74
+ 1. **{flow_name}:** {description}
75
+ 2. **{flow_name}:** {description}
76
+
77
+ ## Scaling Considerations
78
+
79
+ | Scale | Architecture Adjustments |
80
+ |-------|--------------------------|
81
+ | 0-1k users | {approach} |
82
+ | 1k-100k users | {approach} |
83
+ | 100k+ users | {approach} |
84
+
85
+ ### Scaling Priorities
86
+
87
+ 1. **First bottleneck:** {description}
88
+ 2. **Second bottleneck:** {description}
89
+
90
+ ## Anti-Patterns
91
+
92
+ ### Anti-Pattern 1: {name}
93
+
94
+ **What people do:** {mistake}
95
+ **Why it's wrong:** {problem}
96
+ **Do this instead:** {correct_approach}
97
+
98
+ ### Anti-Pattern 2: {name}
99
+
100
+ **What people do:** {mistake}
101
+ **Why it's wrong:** {problem}
102
+ **Do this instead:** {correct_approach}
103
+
104
+ ## Integration Points
105
+
106
+ ### External Services
107
+
108
+ | Service | Integration Pattern | Notes |
109
+ |---------|---------------------|-------|
110
+ | {service} | {pattern} | {notes} |
111
+
112
+ ### Internal Boundaries
113
+
114
+ | Boundary | Communication | Notes |
115
+ |----------|---------------|-------|
116
+ | {boundary} | {communication} | {notes} |
117
+
118
+ ## Sources
119
+
120
+ - {sources}
121
+
122
+ ---
123
+ *Architecture research for: {domain}*
124
+ *Researched: {date}*
@@ -1,71 +1,71 @@
1
- <!-- Source: agents/researcher.md | Purpose: Output format for research project STACK.md (external tech evaluation) -->
2
- # Stack Research
3
-
4
- **Domain:** {domain}
5
- **Researched:** {date}
6
- **Confidence:** {confidence}
7
-
8
- ## Recommended Stack
9
-
10
- ### Core Technologies
11
-
12
- | Technology | Version | Purpose | Why Recommended |
13
- |------------|---------|---------|-----------------|
14
- | {technology} | {version} | {purpose} | {rationale} |
15
-
16
- ### Supporting Libraries
17
-
18
- | Library | Version | Purpose | When to Use |
19
- |---------|---------|---------|-------------|
20
- | {library} | {version} | {purpose} | {use_case} |
21
-
22
- ### Development Tools
23
-
24
- | Tool | Purpose | Notes |
25
- |------|---------|-------|
26
- | {tool} | {purpose} | {notes} |
27
-
28
- ## Installation
29
-
30
- ```bash
31
- # Core
32
- {core_install_commands}
33
-
34
- # Supporting
35
- {supporting_install_commands}
36
-
37
- # Dev dependencies
38
- {dev_install_commands}
39
- ```
40
-
41
- ## Alternatives Considered
42
-
43
- | Recommended | Alternative | When to Use Alternative |
44
- |-------------|-------------|-------------------------|
45
- | {our_choice} | {alternative} | {conditions} |
46
-
47
- ## What NOT to Use
48
-
49
- | Avoid | Why | Use Instead |
50
- |-------|-----|-------------|
51
- | {technology} | {problem} | {alternative} |
52
-
53
- ## Stack Patterns by Variant
54
-
55
- **If {condition}:**
56
- - Use {variation}
57
- - Because {reason}
58
-
59
- ## Version Compatibility
60
-
61
- | Package A | Compatible With | Notes |
62
- |-----------|-----------------|-------|
63
- | {package_a} | {package_b} | {notes} |
64
-
65
- ## Sources
66
-
67
- - {sources}
68
-
69
- ---
70
- *Stack research for: {domain}*
71
- *Researched: {date}*
1
+ <!-- Source: agents/researcher.md | Purpose: Output format for research project STACK.md (external tech evaluation) -->
2
+ # Stack Research
3
+
4
+ **Domain:** {domain}
5
+ **Researched:** {date}
6
+ **Confidence:** {confidence}
7
+
8
+ ## Recommended Stack
9
+
10
+ ### Core Technologies
11
+
12
+ | Technology | Version | Purpose | Why Recommended |
13
+ |------------|---------|---------|-----------------|
14
+ | {technology} | {version} | {purpose} | {rationale} |
15
+
16
+ ### Supporting Libraries
17
+
18
+ | Library | Version | Purpose | When to Use |
19
+ |---------|---------|---------|-------------|
20
+ | {library} | {version} | {purpose} | {use_case} |
21
+
22
+ ### Development Tools
23
+
24
+ | Tool | Purpose | Notes |
25
+ |------|---------|-------|
26
+ | {tool} | {purpose} | {notes} |
27
+
28
+ ## Installation
29
+
30
+ ```bash
31
+ # Core
32
+ {core_install_commands}
33
+
34
+ # Supporting
35
+ {supporting_install_commands}
36
+
37
+ # Dev dependencies
38
+ {dev_install_commands}
39
+ ```
40
+
41
+ ## Alternatives Considered
42
+
43
+ | Recommended | Alternative | When to Use Alternative |
44
+ |-------------|-------------|-------------------------|
45
+ | {our_choice} | {alternative} | {conditions} |
46
+
47
+ ## What NOT to Use
48
+
49
+ | Avoid | Why | Use Instead |
50
+ |-------|-----|-------------|
51
+ | {technology} | {problem} | {alternative} |
52
+
53
+ ## Stack Patterns by Variant
54
+
55
+ **If {condition}:**
56
+ - Use {variation}
57
+ - Because {reason}
58
+
59
+ ## Version Compatibility
60
+
61
+ | Package A | Compatible With | Notes |
62
+ |-----------|-----------------|-------|
63
+ | {package_a} | {package_b} | {notes} |
64
+
65
+ ## Sources
66
+
67
+ - {sources}
68
+
69
+ ---
70
+ *Stack research for: {domain}*
71
+ *Researched: {date}*