@sienklogic/plan-build-run 2.0.0 → 2.0.1

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 (225) 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/pbr/.claude-plugin/plugin.json +13 -13
  53. package/plugins/pbr/UI-CONSISTENCY-GAPS.md +61 -61
  54. package/plugins/pbr/agents/codebase-mapper.md +279 -271
  55. package/plugins/pbr/agents/debugger.md +281 -281
  56. package/plugins/pbr/agents/executor.md +428 -407
  57. package/plugins/pbr/agents/general.md +164 -164
  58. package/plugins/pbr/agents/integration-checker.md +169 -141
  59. package/plugins/pbr/agents/plan-checker.md +296 -280
  60. package/plugins/pbr/agents/planner.md +358 -358
  61. package/plugins/pbr/agents/researcher.md +363 -363
  62. package/plugins/pbr/agents/synthesizer.md +230 -230
  63. package/plugins/pbr/agents/verifier.md +489 -454
  64. package/plugins/pbr/commands/begin.md +5 -5
  65. package/plugins/pbr/commands/build.md +5 -5
  66. package/plugins/pbr/commands/config.md +5 -5
  67. package/plugins/pbr/commands/continue.md +5 -5
  68. package/plugins/pbr/commands/debug.md +5 -5
  69. package/plugins/pbr/commands/discuss.md +5 -5
  70. package/plugins/pbr/commands/explore.md +5 -5
  71. package/plugins/pbr/commands/health.md +5 -5
  72. package/plugins/pbr/commands/help.md +5 -5
  73. package/plugins/pbr/commands/import.md +5 -5
  74. package/plugins/pbr/commands/milestone.md +5 -5
  75. package/plugins/pbr/commands/note.md +5 -5
  76. package/plugins/pbr/commands/pause.md +5 -5
  77. package/plugins/pbr/commands/plan.md +5 -5
  78. package/plugins/pbr/commands/quick.md +5 -5
  79. package/plugins/pbr/commands/resume.md +5 -5
  80. package/plugins/pbr/commands/review.md +5 -5
  81. package/plugins/pbr/commands/scan.md +5 -5
  82. package/plugins/pbr/commands/setup.md +5 -5
  83. package/plugins/pbr/commands/status.md +5 -5
  84. package/plugins/pbr/commands/todo.md +5 -5
  85. package/plugins/pbr/contexts/dev.md +27 -27
  86. package/plugins/pbr/contexts/research.md +28 -28
  87. package/plugins/pbr/contexts/review.md +36 -36
  88. package/plugins/pbr/hooks/hooks.json +183 -183
  89. package/plugins/pbr/references/agent-anti-patterns.md +24 -24
  90. package/plugins/pbr/references/agent-interactions.md +134 -134
  91. package/plugins/pbr/references/agent-teams.md +54 -54
  92. package/plugins/pbr/references/checkpoints.md +157 -157
  93. package/plugins/pbr/references/common-bug-patterns.md +13 -13
  94. package/plugins/pbr/references/config-reference.md +441 -0
  95. package/plugins/pbr/references/continuation-format.md +212 -212
  96. package/plugins/pbr/references/deviation-rules.md +112 -112
  97. package/plugins/pbr/references/git-integration.md +226 -226
  98. package/plugins/pbr/references/integration-patterns.md +117 -117
  99. package/plugins/pbr/references/model-profiles.md +99 -99
  100. package/plugins/pbr/references/model-selection.md +31 -31
  101. package/plugins/pbr/references/pbr-rules.md +193 -193
  102. package/plugins/pbr/references/plan-authoring.md +181 -181
  103. package/plugins/pbr/references/plan-format.md +287 -283
  104. package/plugins/pbr/references/planning-config.md +213 -213
  105. package/plugins/pbr/references/questioning.md +214 -214
  106. package/plugins/pbr/references/reading-verification.md +127 -127
  107. package/plugins/pbr/references/stub-patterns.md +160 -160
  108. package/plugins/pbr/references/subagent-coordination.md +119 -119
  109. package/plugins/pbr/references/ui-formatting.md +461 -399
  110. package/plugins/pbr/references/verification-patterns.md +198 -198
  111. package/plugins/pbr/references/wave-execution.md +95 -95
  112. package/plugins/pbr/scripts/auto-continue.js +80 -80
  113. package/plugins/pbr/scripts/check-dangerous-commands.js +136 -136
  114. package/plugins/pbr/scripts/check-doc-sprawl.js +102 -102
  115. package/plugins/pbr/scripts/check-phase-boundary.js +196 -196
  116. package/plugins/pbr/scripts/check-plan-format.js +270 -270
  117. package/plugins/pbr/scripts/check-roadmap-sync.js +322 -252
  118. package/plugins/pbr/scripts/check-skill-workflow.js +262 -262
  119. package/plugins/pbr/scripts/check-state-sync.js +476 -476
  120. package/plugins/pbr/scripts/check-subagent-output.js +144 -144
  121. package/plugins/pbr/scripts/config-schema.json +251 -251
  122. package/plugins/pbr/scripts/context-budget-check.js +287 -287
  123. package/plugins/pbr/scripts/event-handler.js +151 -151
  124. package/plugins/pbr/scripts/event-logger.js +92 -92
  125. package/plugins/pbr/scripts/hook-logger.js +80 -76
  126. package/plugins/pbr/scripts/hooks-schema.json +79 -79
  127. package/plugins/pbr/scripts/log-subagent.js +164 -152
  128. package/plugins/pbr/scripts/log-tool-failure.js +88 -88
  129. package/plugins/pbr/scripts/pbr-tools.js +1378 -1301
  130. package/plugins/pbr/scripts/post-write-dispatch.js +66 -66
  131. package/plugins/pbr/scripts/post-write-quality.js +207 -207
  132. package/plugins/pbr/scripts/pre-bash-dispatch.js +86 -56
  133. package/plugins/pbr/scripts/pre-write-dispatch.js +97 -62
  134. package/plugins/pbr/scripts/progress-tracker.js +281 -228
  135. package/plugins/pbr/scripts/run-hook.js +92 -0
  136. package/plugins/pbr/scripts/session-cleanup.js +254 -254
  137. package/plugins/pbr/scripts/status-line.js +288 -285
  138. package/plugins/pbr/scripts/suggest-compact.js +119 -119
  139. package/plugins/pbr/scripts/task-completed.js +45 -45
  140. package/plugins/pbr/scripts/track-context-budget.js +149 -119
  141. package/plugins/pbr/scripts/validate-commit.js +200 -200
  142. package/plugins/pbr/scripts/validate-plugin-structure.js +183 -172
  143. package/plugins/pbr/scripts/validate-task.js +106 -0
  144. package/plugins/pbr/skills/begin/SKILL.md +594 -545
  145. package/plugins/pbr/skills/begin/templates/PROJECT.md.tmpl +33 -33
  146. package/plugins/pbr/skills/begin/templates/REQUIREMENTS.md.tmpl +18 -18
  147. package/plugins/pbr/skills/begin/templates/STATE.md.tmpl +49 -49
  148. package/plugins/pbr/skills/begin/templates/config.json.tmpl +64 -63
  149. package/plugins/pbr/skills/begin/templates/researcher-prompt.md.tmpl +19 -19
  150. package/plugins/pbr/skills/begin/templates/roadmap-prompt.md.tmpl +30 -30
  151. package/plugins/pbr/skills/begin/templates/synthesis-prompt.md.tmpl +16 -16
  152. package/plugins/pbr/skills/build/SKILL.md +943 -962
  153. package/plugins/pbr/skills/config/SKILL.md +256 -241
  154. package/plugins/pbr/skills/continue/SKILL.md +164 -127
  155. package/plugins/pbr/skills/debug/SKILL.md +515 -489
  156. package/plugins/pbr/skills/debug/templates/continuation-prompt.md.tmpl +16 -16
  157. package/plugins/pbr/skills/debug/templates/initial-investigation-prompt.md.tmpl +27 -27
  158. package/plugins/pbr/skills/discuss/SKILL.md +347 -338
  159. package/plugins/pbr/skills/discuss/templates/CONTEXT.md.tmpl +61 -61
  160. package/plugins/pbr/skills/discuss/templates/decision-categories.md +9 -9
  161. package/plugins/pbr/skills/explore/SKILL.md +378 -362
  162. package/plugins/pbr/skills/health/SKILL.md +221 -186
  163. package/plugins/pbr/skills/health/templates/check-pattern.md.tmpl +30 -30
  164. package/plugins/pbr/skills/health/templates/output-format.md.tmpl +63 -63
  165. package/plugins/pbr/skills/help/SKILL.md +155 -140
  166. package/plugins/pbr/skills/import/SKILL.md +504 -490
  167. package/plugins/pbr/skills/milestone/SKILL.md +704 -673
  168. package/plugins/pbr/skills/milestone/templates/audit-report.md.tmpl +48 -48
  169. package/plugins/pbr/skills/milestone/templates/stats-file.md.tmpl +30 -30
  170. package/plugins/pbr/skills/note/SKILL.md +231 -212
  171. package/plugins/pbr/skills/pause/SKILL.md +249 -235
  172. package/plugins/pbr/skills/pause/templates/continue-here.md.tmpl +71 -71
  173. package/plugins/pbr/skills/plan/SKILL.md +685 -628
  174. package/plugins/pbr/skills/plan/decimal-phase-calc.md +98 -98
  175. package/plugins/pbr/skills/plan/templates/checker-prompt.md.tmpl +21 -21
  176. package/plugins/pbr/skills/plan/templates/gap-closure-prompt.md.tmpl +32 -32
  177. package/plugins/pbr/skills/plan/templates/planner-prompt.md.tmpl +38 -38
  178. package/plugins/pbr/skills/plan/templates/researcher-prompt.md.tmpl +19 -19
  179. package/plugins/pbr/skills/plan/templates/revision-prompt.md.tmpl +23 -23
  180. package/plugins/pbr/skills/quick/SKILL.md +354 -335
  181. package/plugins/pbr/skills/resume/SKILL.md +402 -388
  182. package/plugins/pbr/skills/review/SKILL.md +686 -652
  183. package/plugins/pbr/skills/review/templates/debugger-prompt.md.tmpl +60 -60
  184. package/plugins/pbr/skills/review/templates/gap-planner-prompt.md.tmpl +40 -40
  185. package/plugins/pbr/skills/review/templates/verifier-prompt.md.tmpl +115 -115
  186. package/plugins/pbr/skills/scan/SKILL.md +304 -269
  187. package/plugins/pbr/skills/scan/templates/mapper-prompt.md.tmpl +201 -201
  188. package/plugins/pbr/skills/setup/SKILL.md +253 -227
  189. package/plugins/pbr/skills/shared/commit-planning-docs.md +35 -35
  190. package/plugins/pbr/skills/shared/config-loading.md +102 -102
  191. package/plugins/pbr/skills/shared/context-budget.md +40 -40
  192. package/plugins/pbr/skills/shared/context-loader-task.md +86 -86
  193. package/plugins/pbr/skills/shared/digest-select.md +79 -79
  194. package/plugins/pbr/skills/shared/domain-probes.md +125 -125
  195. package/plugins/pbr/skills/shared/error-reporting.md +79 -79
  196. package/plugins/pbr/skills/shared/gate-prompts.md +388 -388
  197. package/plugins/pbr/skills/shared/phase-argument-parsing.md +45 -45
  198. package/plugins/pbr/skills/shared/progress-display.md +53 -53
  199. package/plugins/pbr/skills/shared/revision-loop.md +81 -81
  200. package/plugins/pbr/skills/shared/state-loading.md +62 -62
  201. package/plugins/pbr/skills/shared/state-update.md +161 -161
  202. package/plugins/pbr/skills/shared/universal-anti-patterns.md +33 -33
  203. package/plugins/pbr/skills/status/SKILL.md +367 -353
  204. package/plugins/pbr/skills/todo/SKILL.md +198 -181
  205. package/plugins/pbr/templates/CONTEXT.md.tmpl +52 -52
  206. package/plugins/pbr/templates/INTEGRATION-REPORT.md.tmpl +151 -151
  207. package/plugins/pbr/templates/RESEARCH-SUMMARY.md.tmpl +97 -97
  208. package/plugins/pbr/templates/ROADMAP.md.tmpl +40 -40
  209. package/plugins/pbr/templates/SUMMARY.md.tmpl +81 -81
  210. package/plugins/pbr/templates/VERIFICATION-DETAIL.md.tmpl +116 -116
  211. package/plugins/pbr/templates/codebase/ARCHITECTURE.md.tmpl +98 -98
  212. package/plugins/pbr/templates/codebase/CONCERNS.md.tmpl +93 -93
  213. package/plugins/pbr/templates/codebase/CONVENTIONS.md.tmpl +104 -104
  214. package/plugins/pbr/templates/codebase/INTEGRATIONS.md.tmpl +78 -78
  215. package/plugins/pbr/templates/codebase/STACK.md.tmpl +78 -78
  216. package/plugins/pbr/templates/codebase/STRUCTURE.md.tmpl +80 -80
  217. package/plugins/pbr/templates/codebase/TESTING.md.tmpl +107 -107
  218. package/plugins/pbr/templates/continue-here.md.tmpl +73 -73
  219. package/plugins/pbr/templates/prompt-partials/phase-project-context.md.tmpl +37 -37
  220. package/plugins/pbr/templates/research/ARCHITECTURE.md.tmpl +124 -124
  221. package/plugins/pbr/templates/research/STACK.md.tmpl +71 -71
  222. package/plugins/pbr/templates/research/SUMMARY.md.tmpl +112 -112
  223. package/plugins/pbr/templates/research-outputs/phase-research.md.tmpl +81 -81
  224. package/plugins/pbr/templates/research-outputs/project-research.md.tmpl +99 -99
  225. 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}*