@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.
- package/CHANGELOG.md +56 -56
- package/CLAUDE.md +149 -149
- package/LICENSE +21 -21
- package/README.md +247 -247
- package/dashboard/bin/cli.js +25 -25
- package/dashboard/package.json +34 -34
- package/dashboard/public/css/layout.css +406 -406
- package/dashboard/public/css/status-colors.css +98 -98
- package/dashboard/public/js/htmx-title.js +5 -5
- package/dashboard/public/js/sidebar-toggle.js +20 -20
- package/dashboard/src/app.js +78 -78
- package/dashboard/src/middleware/errorHandler.js +52 -52
- package/dashboard/src/middleware/notFoundHandler.js +9 -9
- package/dashboard/src/repositories/planning.repository.js +128 -128
- package/dashboard/src/routes/events.routes.js +40 -40
- package/dashboard/src/routes/index.routes.js +31 -31
- package/dashboard/src/routes/pages.routes.js +245 -195
- package/dashboard/src/server.js +42 -42
- package/dashboard/src/services/dashboard.service.js +222 -222
- package/dashboard/src/services/phase.service.js +220 -167
- package/dashboard/src/services/project.service.js +57 -57
- package/dashboard/src/services/roadmap.service.js +171 -171
- package/dashboard/src/services/sse.service.js +58 -58
- package/dashboard/src/services/todo.service.js +254 -254
- package/dashboard/src/services/watcher.service.js +48 -48
- package/dashboard/src/views/coming-soon.ejs +11 -11
- package/dashboard/src/views/error.ejs +13 -13
- package/dashboard/src/views/index.ejs +5 -5
- package/dashboard/src/views/layout.ejs +1 -1
- package/dashboard/src/views/partials/dashboard-content.ejs +77 -77
- package/dashboard/src/views/partials/footer.ejs +3 -3
- package/dashboard/src/views/partials/head.ejs +21 -21
- package/dashboard/src/views/partials/header.ejs +12 -12
- package/dashboard/src/views/partials/layout-bottom.ejs +15 -15
- package/dashboard/src/views/partials/layout-top.ejs +8 -8
- package/dashboard/src/views/partials/phase-content.ejs +188 -181
- package/dashboard/src/views/partials/phase-doc-content.ejs +38 -0
- package/dashboard/src/views/partials/phases-content.ejs +117 -117
- package/dashboard/src/views/partials/roadmap-content.ejs +142 -142
- package/dashboard/src/views/partials/sidebar.ejs +38 -38
- package/dashboard/src/views/partials/todo-create-content.ejs +53 -53
- package/dashboard/src/views/partials/todo-detail-content.ejs +38 -38
- package/dashboard/src/views/partials/todos-content.ejs +53 -53
- package/dashboard/src/views/phase-detail.ejs +5 -5
- package/dashboard/src/views/phase-doc.ejs +5 -0
- package/dashboard/src/views/phases.ejs +5 -5
- package/dashboard/src/views/roadmap.ejs +5 -5
- package/dashboard/src/views/todo-create.ejs +5 -5
- package/dashboard/src/views/todo-detail.ejs +5 -5
- package/dashboard/src/views/todos.ejs +5 -5
- package/package.json +57 -57
- package/plugins/cursor-pbr/.cursor-plugin/plugin.json +22 -0
- package/plugins/cursor-pbr/agents/.gitkeep +0 -0
- package/plugins/cursor-pbr/assets/.gitkeep +0 -0
- package/plugins/cursor-pbr/hooks/hooks.json +11 -0
- package/plugins/cursor-pbr/references/.gitkeep +0 -0
- package/plugins/cursor-pbr/rules/.gitkeep +0 -0
- package/plugins/cursor-pbr/skills/.gitkeep +0 -0
- package/plugins/cursor-pbr/templates/.gitkeep +0 -0
- package/plugins/pbr/.claude-plugin/plugin.json +13 -13
- package/plugins/pbr/UI-CONSISTENCY-GAPS.md +61 -61
- package/plugins/pbr/agents/codebase-mapper.md +279 -271
- package/plugins/pbr/agents/debugger.md +281 -281
- package/plugins/pbr/agents/executor.md +428 -407
- package/plugins/pbr/agents/general.md +164 -164
- package/plugins/pbr/agents/integration-checker.md +169 -141
- package/plugins/pbr/agents/plan-checker.md +296 -280
- package/plugins/pbr/agents/planner.md +358 -358
- package/plugins/pbr/agents/researcher.md +363 -363
- package/plugins/pbr/agents/synthesizer.md +230 -230
- package/plugins/pbr/agents/verifier.md +489 -454
- package/plugins/pbr/commands/begin.md +5 -5
- package/plugins/pbr/commands/build.md +5 -5
- package/plugins/pbr/commands/config.md +5 -5
- package/plugins/pbr/commands/continue.md +5 -5
- package/plugins/pbr/commands/debug.md +5 -5
- package/plugins/pbr/commands/discuss.md +5 -5
- package/plugins/pbr/commands/explore.md +5 -5
- package/plugins/pbr/commands/health.md +5 -5
- package/plugins/pbr/commands/help.md +5 -5
- package/plugins/pbr/commands/import.md +5 -5
- package/plugins/pbr/commands/milestone.md +5 -5
- package/plugins/pbr/commands/note.md +5 -5
- package/plugins/pbr/commands/pause.md +5 -5
- package/plugins/pbr/commands/plan.md +5 -5
- package/plugins/pbr/commands/quick.md +5 -5
- package/plugins/pbr/commands/resume.md +5 -5
- package/plugins/pbr/commands/review.md +5 -5
- package/plugins/pbr/commands/scan.md +5 -5
- package/plugins/pbr/commands/setup.md +5 -5
- package/plugins/pbr/commands/status.md +5 -5
- package/plugins/pbr/commands/todo.md +5 -5
- package/plugins/pbr/contexts/dev.md +27 -27
- package/plugins/pbr/contexts/research.md +28 -28
- package/plugins/pbr/contexts/review.md +36 -36
- package/plugins/pbr/hooks/hooks.json +183 -183
- package/plugins/pbr/references/agent-anti-patterns.md +24 -24
- package/plugins/pbr/references/agent-interactions.md +134 -134
- package/plugins/pbr/references/agent-teams.md +54 -54
- package/plugins/pbr/references/checkpoints.md +157 -157
- package/plugins/pbr/references/common-bug-patterns.md +13 -13
- package/plugins/pbr/references/config-reference.md +441 -0
- package/plugins/pbr/references/continuation-format.md +212 -212
- package/plugins/pbr/references/deviation-rules.md +112 -112
- package/plugins/pbr/references/git-integration.md +226 -226
- package/plugins/pbr/references/integration-patterns.md +117 -117
- package/plugins/pbr/references/model-profiles.md +99 -99
- package/plugins/pbr/references/model-selection.md +31 -31
- package/plugins/pbr/references/pbr-rules.md +193 -193
- package/plugins/pbr/references/plan-authoring.md +181 -181
- package/plugins/pbr/references/plan-format.md +287 -283
- package/plugins/pbr/references/planning-config.md +213 -213
- package/plugins/pbr/references/questioning.md +214 -214
- package/plugins/pbr/references/reading-verification.md +127 -127
- package/plugins/pbr/references/stub-patterns.md +160 -160
- package/plugins/pbr/references/subagent-coordination.md +119 -119
- package/plugins/pbr/references/ui-formatting.md +461 -399
- package/plugins/pbr/references/verification-patterns.md +198 -198
- package/plugins/pbr/references/wave-execution.md +95 -95
- package/plugins/pbr/scripts/auto-continue.js +80 -80
- package/plugins/pbr/scripts/check-dangerous-commands.js +136 -136
- package/plugins/pbr/scripts/check-doc-sprawl.js +102 -102
- package/plugins/pbr/scripts/check-phase-boundary.js +196 -196
- package/plugins/pbr/scripts/check-plan-format.js +270 -270
- package/plugins/pbr/scripts/check-roadmap-sync.js +322 -252
- package/plugins/pbr/scripts/check-skill-workflow.js +262 -262
- package/plugins/pbr/scripts/check-state-sync.js +476 -476
- package/plugins/pbr/scripts/check-subagent-output.js +144 -144
- package/plugins/pbr/scripts/config-schema.json +251 -251
- package/plugins/pbr/scripts/context-budget-check.js +287 -287
- package/plugins/pbr/scripts/event-handler.js +151 -151
- package/plugins/pbr/scripts/event-logger.js +92 -92
- package/plugins/pbr/scripts/hook-logger.js +80 -76
- package/plugins/pbr/scripts/hooks-schema.json +79 -79
- package/plugins/pbr/scripts/log-subagent.js +164 -152
- package/plugins/pbr/scripts/log-tool-failure.js +88 -88
- package/plugins/pbr/scripts/pbr-tools.js +1378 -1301
- package/plugins/pbr/scripts/post-write-dispatch.js +66 -66
- package/plugins/pbr/scripts/post-write-quality.js +207 -207
- package/plugins/pbr/scripts/pre-bash-dispatch.js +86 -56
- package/plugins/pbr/scripts/pre-write-dispatch.js +97 -62
- package/plugins/pbr/scripts/progress-tracker.js +281 -228
- package/plugins/pbr/scripts/run-hook.js +92 -0
- package/plugins/pbr/scripts/session-cleanup.js +254 -254
- package/plugins/pbr/scripts/status-line.js +288 -285
- package/plugins/pbr/scripts/suggest-compact.js +119 -119
- package/plugins/pbr/scripts/task-completed.js +45 -45
- package/plugins/pbr/scripts/track-context-budget.js +149 -119
- package/plugins/pbr/scripts/validate-commit.js +200 -200
- package/plugins/pbr/scripts/validate-plugin-structure.js +183 -172
- package/plugins/pbr/scripts/validate-task.js +106 -0
- package/plugins/pbr/skills/begin/SKILL.md +594 -545
- package/plugins/pbr/skills/begin/templates/PROJECT.md.tmpl +33 -33
- package/plugins/pbr/skills/begin/templates/REQUIREMENTS.md.tmpl +18 -18
- package/plugins/pbr/skills/begin/templates/STATE.md.tmpl +49 -49
- package/plugins/pbr/skills/begin/templates/config.json.tmpl +64 -63
- package/plugins/pbr/skills/begin/templates/researcher-prompt.md.tmpl +19 -19
- package/plugins/pbr/skills/begin/templates/roadmap-prompt.md.tmpl +30 -30
- package/plugins/pbr/skills/begin/templates/synthesis-prompt.md.tmpl +16 -16
- package/plugins/pbr/skills/build/SKILL.md +943 -962
- package/plugins/pbr/skills/config/SKILL.md +256 -241
- package/plugins/pbr/skills/continue/SKILL.md +164 -127
- package/plugins/pbr/skills/debug/SKILL.md +515 -489
- package/plugins/pbr/skills/debug/templates/continuation-prompt.md.tmpl +16 -16
- package/plugins/pbr/skills/debug/templates/initial-investigation-prompt.md.tmpl +27 -27
- package/plugins/pbr/skills/discuss/SKILL.md +347 -338
- package/plugins/pbr/skills/discuss/templates/CONTEXT.md.tmpl +61 -61
- package/plugins/pbr/skills/discuss/templates/decision-categories.md +9 -9
- package/plugins/pbr/skills/explore/SKILL.md +378 -362
- package/plugins/pbr/skills/health/SKILL.md +221 -186
- package/plugins/pbr/skills/health/templates/check-pattern.md.tmpl +30 -30
- package/plugins/pbr/skills/health/templates/output-format.md.tmpl +63 -63
- package/plugins/pbr/skills/help/SKILL.md +155 -140
- package/plugins/pbr/skills/import/SKILL.md +504 -490
- package/plugins/pbr/skills/milestone/SKILL.md +704 -673
- package/plugins/pbr/skills/milestone/templates/audit-report.md.tmpl +48 -48
- package/plugins/pbr/skills/milestone/templates/stats-file.md.tmpl +30 -30
- package/plugins/pbr/skills/note/SKILL.md +231 -212
- package/plugins/pbr/skills/pause/SKILL.md +249 -235
- package/plugins/pbr/skills/pause/templates/continue-here.md.tmpl +71 -71
- package/plugins/pbr/skills/plan/SKILL.md +685 -628
- package/plugins/pbr/skills/plan/decimal-phase-calc.md +98 -98
- package/plugins/pbr/skills/plan/templates/checker-prompt.md.tmpl +21 -21
- package/plugins/pbr/skills/plan/templates/gap-closure-prompt.md.tmpl +32 -32
- package/plugins/pbr/skills/plan/templates/planner-prompt.md.tmpl +38 -38
- package/plugins/pbr/skills/plan/templates/researcher-prompt.md.tmpl +19 -19
- package/plugins/pbr/skills/plan/templates/revision-prompt.md.tmpl +23 -23
- package/plugins/pbr/skills/quick/SKILL.md +354 -335
- package/plugins/pbr/skills/resume/SKILL.md +402 -388
- package/plugins/pbr/skills/review/SKILL.md +686 -652
- package/plugins/pbr/skills/review/templates/debugger-prompt.md.tmpl +60 -60
- package/plugins/pbr/skills/review/templates/gap-planner-prompt.md.tmpl +40 -40
- package/plugins/pbr/skills/review/templates/verifier-prompt.md.tmpl +115 -115
- package/plugins/pbr/skills/scan/SKILL.md +304 -269
- package/plugins/pbr/skills/scan/templates/mapper-prompt.md.tmpl +201 -201
- package/plugins/pbr/skills/setup/SKILL.md +253 -227
- package/plugins/pbr/skills/shared/commit-planning-docs.md +35 -35
- package/plugins/pbr/skills/shared/config-loading.md +102 -102
- package/plugins/pbr/skills/shared/context-budget.md +40 -40
- package/plugins/pbr/skills/shared/context-loader-task.md +86 -86
- package/plugins/pbr/skills/shared/digest-select.md +79 -79
- package/plugins/pbr/skills/shared/domain-probes.md +125 -125
- package/plugins/pbr/skills/shared/error-reporting.md +79 -79
- package/plugins/pbr/skills/shared/gate-prompts.md +388 -388
- package/plugins/pbr/skills/shared/phase-argument-parsing.md +45 -45
- package/plugins/pbr/skills/shared/progress-display.md +53 -53
- package/plugins/pbr/skills/shared/revision-loop.md +81 -81
- package/plugins/pbr/skills/shared/state-loading.md +62 -62
- package/plugins/pbr/skills/shared/state-update.md +161 -161
- package/plugins/pbr/skills/shared/universal-anti-patterns.md +33 -33
- package/plugins/pbr/skills/status/SKILL.md +367 -353
- package/plugins/pbr/skills/todo/SKILL.md +198 -181
- package/plugins/pbr/templates/CONTEXT.md.tmpl +52 -52
- package/plugins/pbr/templates/INTEGRATION-REPORT.md.tmpl +151 -151
- package/plugins/pbr/templates/RESEARCH-SUMMARY.md.tmpl +97 -97
- package/plugins/pbr/templates/ROADMAP.md.tmpl +40 -40
- package/plugins/pbr/templates/SUMMARY.md.tmpl +81 -81
- package/plugins/pbr/templates/VERIFICATION-DETAIL.md.tmpl +116 -116
- package/plugins/pbr/templates/codebase/ARCHITECTURE.md.tmpl +98 -98
- package/plugins/pbr/templates/codebase/CONCERNS.md.tmpl +93 -93
- package/plugins/pbr/templates/codebase/CONVENTIONS.md.tmpl +104 -104
- package/plugins/pbr/templates/codebase/INTEGRATIONS.md.tmpl +78 -78
- package/plugins/pbr/templates/codebase/STACK.md.tmpl +78 -78
- package/plugins/pbr/templates/codebase/STRUCTURE.md.tmpl +80 -80
- package/plugins/pbr/templates/codebase/TESTING.md.tmpl +107 -107
- package/plugins/pbr/templates/continue-here.md.tmpl +73 -73
- package/plugins/pbr/templates/prompt-partials/phase-project-context.md.tmpl +37 -37
- package/plugins/pbr/templates/research/ARCHITECTURE.md.tmpl +124 -124
- package/plugins/pbr/templates/research/STACK.md.tmpl +71 -71
- package/plugins/pbr/templates/research/SUMMARY.md.tmpl +112 -112
- package/plugins/pbr/templates/research-outputs/phase-research.md.tmpl +81 -81
- package/plugins/pbr/templates/research-outputs/project-research.md.tmpl +99 -99
- 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}*
|