@sienklogic/plan-build-run 2.1.0 → 2.1.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 (1238) hide show
  1. package/CHANGELOG.md +51 -49
  2. package/CLAUDE.md +48 -32
  3. package/LICENSE +2 -1
  4. package/README.md +771 -87
  5. package/agents/pbr-audit.md +266 -0
  6. package/agents/pbr-codebase-mapper.md +236 -0
  7. package/agents/pbr-debugger.md +312 -0
  8. package/agents/pbr-dev-sync.md +220 -0
  9. package/agents/pbr-executor.md +559 -0
  10. package/agents/pbr-general.md +191 -0
  11. package/agents/pbr-integration-checker.md +237 -0
  12. package/agents/pbr-nyquist-auditor.md +252 -0
  13. package/agents/pbr-plan-checker.md +312 -0
  14. package/agents/pbr-planner.md +495 -0
  15. package/agents/pbr-researcher.md +314 -0
  16. package/agents/pbr-roadmapper.md +346 -0
  17. package/agents/pbr-synthesizer.md +271 -0
  18. package/agents/pbr-verifier.md +495 -0
  19. package/bin/install.js +2752 -0
  20. package/commands/pbr/add-phase.md +75 -0
  21. package/commands/pbr/add-todo.md +8 -0
  22. package/commands/pbr/audit-milestone.md +8 -0
  23. package/commands/pbr/audit.md +5 -0
  24. package/commands/pbr/check-todos.md +8 -0
  25. package/commands/pbr/complete-milestone.md +8 -0
  26. package/commands/pbr/config.md +5 -0
  27. package/commands/pbr/continue.md +5 -0
  28. package/commands/pbr/dashboard.md +5 -0
  29. package/commands/pbr/debug.md +5 -0
  30. package/commands/pbr/discuss-phase.md +6 -0
  31. package/commands/pbr/do.md +5 -0
  32. package/commands/pbr/execute-phase.md +6 -0
  33. package/commands/pbr/explore.md +5 -0
  34. package/commands/pbr/health.md +5 -0
  35. package/commands/pbr/help.md +5 -0
  36. package/commands/pbr/import.md +5 -0
  37. package/commands/pbr/insert-phase.md +65 -0
  38. package/commands/pbr/join-discord.md +11 -0
  39. package/commands/pbr/list-phase-assumptions.md +69 -0
  40. package/commands/pbr/map-codebase.md +6 -0
  41. package/commands/pbr/new-milestone.md +8 -0
  42. package/commands/pbr/new-project.md +6 -0
  43. package/commands/pbr/note.md +5 -0
  44. package/commands/pbr/pause-work.md +5 -0
  45. package/commands/pbr/plan-milestone-gaps.md +7 -0
  46. package/commands/pbr/plan-phase.md +6 -0
  47. package/commands/pbr/progress.md +6 -0
  48. package/commands/pbr/quick.md +5 -0
  49. package/commands/pbr/reapply-patches.md +40 -0
  50. package/commands/pbr/remove-phase.md +66 -0
  51. package/commands/pbr/research-phase.md +59 -0
  52. package/commands/pbr/resume-work.md +5 -0
  53. package/commands/pbr/set-profile.md +6 -0
  54. package/commands/pbr/settings.md +5 -0
  55. package/commands/pbr/setup.md +5 -0
  56. package/commands/pbr/statusline.md +5 -0
  57. package/commands/pbr/test.md +5 -0
  58. package/commands/pbr/undo.md +5 -0
  59. package/commands/pbr/update.md +37 -0
  60. package/commands/pbr/verify-work.md +6 -0
  61. package/dashboard/bin/cli.cjs +85 -0
  62. package/dashboard/eslint.config.js +37 -0
  63. package/dashboard/index.html +20 -0
  64. package/dashboard/package.json +28 -23
  65. package/dashboard/server/index.js +134 -0
  66. package/dashboard/server/lib/frontmatter.js +92 -0
  67. package/dashboard/server/middleware/static.js +35 -0
  68. package/dashboard/server/package.json +16 -0
  69. package/dashboard/server/routes/agents.js +213 -0
  70. package/dashboard/server/routes/config.js +64 -0
  71. package/dashboard/server/routes/health.js +21 -0
  72. package/dashboard/server/routes/memory.js +107 -0
  73. package/dashboard/server/routes/planning.js +234 -0
  74. package/dashboard/server/routes/projects.js +36 -0
  75. package/dashboard/server/routes/requirements.js +40 -0
  76. package/dashboard/server/routes/roadmap.js +69 -0
  77. package/dashboard/server/routes/status.js +25 -0
  78. package/dashboard/server/routes/telemetry.js +171 -0
  79. package/dashboard/server/services/file-watcher.js +105 -0
  80. package/dashboard/server/services/planning-reader.js +679 -0
  81. package/dashboard/server/test/cli.test.js +34 -0
  82. package/dashboard/server/test/frontmatter.test.js +104 -0
  83. package/dashboard/server/test/isolation.test.js +32 -0
  84. package/dashboard/server/test/planning-reader.test.js +151 -0
  85. package/dashboard/server/test/routes.test.js +91 -0
  86. package/dashboard/server/test/ws.test.js +81 -0
  87. package/dashboard/server/ws.js +96 -0
  88. package/dashboard/src/App.jsx +147 -0
  89. package/dashboard/src/components/charts/BudgetBars.jsx +42 -0
  90. package/dashboard/src/components/charts/ContextRadar.jsx +34 -0
  91. package/dashboard/src/components/charts/PhaseDonut.jsx +66 -0
  92. package/dashboard/src/components/charts/SuccessTrend.jsx +45 -0
  93. package/dashboard/src/components/charts/TokenChart.jsx +55 -0
  94. package/dashboard/src/components/charts/index.js +5 -0
  95. package/dashboard/src/components/config/CfgSection.jsx +93 -0
  96. package/dashboard/src/components/layout/Header.jsx +89 -0
  97. package/dashboard/src/components/layout/ProjectSwitcher.jsx +160 -0
  98. package/dashboard/src/components/layout/Sidebar.jsx +161 -0
  99. package/dashboard/src/components/ui/AutoModeBanner.jsx +138 -0
  100. package/dashboard/src/components/ui/BackButton.jsx +27 -0
  101. package/dashboard/src/components/ui/Badge.jsx +27 -0
  102. package/dashboard/src/components/ui/Card.jsx +23 -0
  103. package/dashboard/src/components/ui/ChartTooltip.jsx +48 -0
  104. package/dashboard/src/components/ui/CheckpointBox.jsx +110 -0
  105. package/dashboard/src/components/ui/CodeBlock.jsx +27 -0
  106. package/dashboard/src/components/ui/ConfidenceBadge.jsx +20 -0
  107. package/dashboard/src/components/ui/ConfirmModal.jsx +161 -0
  108. package/dashboard/src/components/ui/ConnectionBanner.jsx +60 -0
  109. package/dashboard/src/components/ui/ErrorBoundary.jsx +106 -0
  110. package/dashboard/src/components/ui/ErrorBox.jsx +107 -0
  111. package/dashboard/src/components/ui/KeyValue.jsx +33 -0
  112. package/dashboard/src/components/ui/LoadingSkeleton.jsx +84 -0
  113. package/dashboard/src/components/ui/MetricCard.jsx +58 -0
  114. package/dashboard/src/components/ui/NextUpBlock.jsx +92 -0
  115. package/dashboard/src/components/ui/NumberInput.jsx +44 -0
  116. package/dashboard/src/components/ui/PBRBanner.jsx +47 -0
  117. package/dashboard/src/components/ui/PipelineView.jsx +130 -0
  118. package/dashboard/src/components/ui/ProgressBar.jsx +28 -0
  119. package/dashboard/src/components/ui/ProgressDisplay.jsx +47 -0
  120. package/dashboard/src/components/ui/QualityGateBadge.jsx +15 -0
  121. package/dashboard/src/components/ui/SectionTitle.jsx +35 -0
  122. package/dashboard/src/components/ui/SelectInput.jsx +45 -0
  123. package/dashboard/src/components/ui/StatusDot.jsx +51 -0
  124. package/dashboard/src/components/ui/StatusSymbol.jsx +49 -0
  125. package/dashboard/src/components/ui/TabBar.jsx +41 -0
  126. package/dashboard/src/components/ui/TextInput.jsx +42 -0
  127. package/dashboard/src/components/ui/Toast.jsx +117 -0
  128. package/dashboard/src/components/ui/Toggle.jsx +70 -0
  129. package/dashboard/src/components/ui/index.js +29 -0
  130. package/dashboard/src/hooks/useDocumentTitle.js +16 -0
  131. package/dashboard/src/hooks/useFetch.js +50 -0
  132. package/dashboard/src/hooks/useToast.jsx +43 -0
  133. package/dashboard/src/hooks/useWebSocket.js +103 -0
  134. package/dashboard/src/lib/api.js +112 -0
  135. package/dashboard/src/lib/configSchema.js +189 -0
  136. package/dashboard/src/lib/constants.js +16 -0
  137. package/dashboard/src/main.jsx +15 -0
  138. package/dashboard/src/pages/AgentsPage.jsx +191 -0
  139. package/dashboard/src/pages/ConfigPage.jsx +298 -0
  140. package/dashboard/src/pages/HooksPage.jsx +412 -0
  141. package/dashboard/src/pages/LiveFeed.jsx +274 -0
  142. package/dashboard/src/pages/MemoryPage.jsx +107 -0
  143. package/dashboard/src/pages/Overview.jsx +360 -0
  144. package/dashboard/src/pages/PhaseDetailView.jsx +216 -0
  145. package/dashboard/src/pages/PlanningPage.jsx +181 -0
  146. package/dashboard/src/pages/RoadmapPage.jsx +251 -0
  147. package/dashboard/src/pages/Telemetry.jsx +113 -0
  148. package/dashboard/src/pages/planning/DecisionsTab.jsx +153 -0
  149. package/dashboard/src/pages/planning/FilesTab.jsx +420 -0
  150. package/dashboard/src/pages/planning/MilestoneDetail.jsx +319 -0
  151. package/dashboard/src/pages/planning/MilestonesTab.jsx +151 -0
  152. package/dashboard/src/pages/planning/NotesTab.jsx +251 -0
  153. package/dashboard/src/pages/planning/PhasesTab.jsx +218 -0
  154. package/dashboard/src/pages/planning/QuickTab.jsx +50 -0
  155. package/dashboard/src/pages/planning/ResearchTab.jsx +103 -0
  156. package/dashboard/src/pages/planning/TodosTab.jsx +297 -0
  157. package/dashboard/src/theme/ThemeProvider.jsx +38 -0
  158. package/dashboard/src/theme/tokens.js +17 -0
  159. package/dashboard/tests/components/ConfirmModal.test.jsx +179 -0
  160. package/dashboard/tests/components/ConnectionBanner.test.jsx +37 -0
  161. package/dashboard/tests/components/ErrorBoundary.test.jsx +59 -0
  162. package/dashboard/tests/components/LoadingSkeleton.test.jsx +46 -0
  163. package/dashboard/tests/components/ToastContainer.test.jsx +47 -0
  164. package/dashboard/tests/components/Toggle.test.jsx +61 -0
  165. package/dashboard/tests/hooks/useFetch.test.jsx +77 -0
  166. package/dashboard/tests/hooks/useToast.test.jsx +78 -0
  167. package/dashboard/tests/hooks/useWebSocket.test.jsx +128 -0
  168. package/dashboard/tests/pages/ConfigPage.test.jsx +199 -0
  169. package/dashboard/tests/pages/PlanningPage.test.jsx +119 -0
  170. package/dashboard/tests/pages/planning/FilesTab.test.jsx +198 -0
  171. package/dashboard/tests/pages/planning/NotesTab.test.jsx +178 -0
  172. package/dashboard/tests/pages/planning/TodosTab.test.jsx +188 -0
  173. package/dashboard/tests/performance.test.jsx +46 -0
  174. package/dashboard/tests/routes/config.test.js +98 -0
  175. package/dashboard/tests/routes/health.test.js +40 -0
  176. package/dashboard/tests/routes/planning.test.js +112 -0
  177. package/dashboard/tests/routes/roadmap.test.js +91 -0
  178. package/dashboard/tests/routes/status.test.js +131 -0
  179. package/dashboard/tests/server/planning-reader.test.js +153 -0
  180. package/dashboard/tests/setup.js +7 -0
  181. package/dashboard/vite.config.js +41 -0
  182. package/hooks/dist/auto-continue.js +201 -0
  183. package/hooks/dist/block-skill-self-read.js +77 -0
  184. package/hooks/dist/branding-audit.js +232 -0
  185. package/hooks/dist/check-agent-state-write.js +63 -0
  186. package/hooks/dist/check-config-change.js +188 -0
  187. package/hooks/dist/check-dangerous-commands.js +184 -0
  188. package/hooks/dist/check-doc-sprawl.js +102 -0
  189. package/hooks/dist/check-phase-boundary.js +190 -0
  190. package/hooks/dist/check-plan-format.js +654 -0
  191. package/hooks/dist/check-roadmap-sync.js +491 -0
  192. package/hooks/dist/check-skill-workflow.js +353 -0
  193. package/hooks/dist/check-state-sync.js +612 -0
  194. package/hooks/dist/check-subagent-output.js +754 -0
  195. package/hooks/dist/check-summary-gate.js +198 -0
  196. package/hooks/dist/context-bridge.js +342 -0
  197. package/hooks/dist/context-budget-check.js +441 -0
  198. package/hooks/dist/enforce-pbr-workflow.js +277 -0
  199. package/hooks/dist/event-handler.js +217 -0
  200. package/hooks/dist/event-logger.js +92 -0
  201. package/hooks/dist/hook-logger.js +80 -0
  202. package/hooks/dist/hook-server-client.js +341 -0
  203. package/hooks/dist/hook-server.js +336 -0
  204. package/hooks/dist/hooks-schema.json +85 -0
  205. package/hooks/dist/hooks.json +288 -0
  206. package/hooks/dist/instructions-loaded.js +107 -0
  207. package/hooks/dist/intercept-plan-mode.js +48 -0
  208. package/hooks/dist/log-notification.js +87 -0
  209. package/hooks/dist/log-subagent.js +303 -0
  210. package/hooks/dist/log-tool-failure.js +140 -0
  211. package/hooks/dist/milestone-learnings.js +290 -0
  212. package/hooks/dist/post-bash-triage.js +151 -0
  213. package/hooks/dist/post-write-dispatch.js +227 -0
  214. package/hooks/dist/post-write-quality.js +207 -0
  215. package/hooks/dist/pre-bash-dispatch.js +137 -0
  216. package/hooks/dist/pre-write-dispatch.js +156 -0
  217. package/hooks/dist/progress-tracker.js +742 -0
  218. package/hooks/dist/prompt-routing.js +152 -0
  219. package/hooks/dist/run-hook.js +144 -0
  220. package/hooks/dist/session-cleanup.js +455 -0
  221. package/hooks/dist/session-tracker.js +78 -0
  222. package/hooks/dist/status-line.js +471 -0
  223. package/hooks/dist/suggest-compact.js +220 -0
  224. package/hooks/dist/sync-context-to-claude.js +100 -0
  225. package/hooks/dist/task-completed.js +167 -0
  226. package/hooks/dist/track-context-budget.js +317 -0
  227. package/hooks/dist/validate-commit.js +265 -0
  228. package/hooks/dist/validate-plugin-structure.js +193 -0
  229. package/hooks/dist/validate-skill-args.js +219 -0
  230. package/hooks/dist/validate-task.js +256 -0
  231. package/hooks/dist/worktree-create.js +144 -0
  232. package/hooks/dist/worktree-remove.js +147 -0
  233. package/package.json +53 -40
  234. package/plan-build-run/bin/config-schema.json +406 -0
  235. package/plan-build-run/bin/dashboard-launch.cjs +114 -0
  236. package/plan-build-run/bin/event-logger.cjs +92 -0
  237. package/plan-build-run/bin/lib/alternatives.cjs +198 -0
  238. package/plan-build-run/bin/lib/build.cjs +717 -0
  239. package/plan-build-run/bin/lib/circuit-state.cjs +133 -0
  240. package/plan-build-run/bin/lib/commands.cjs +482 -0
  241. package/plan-build-run/bin/lib/config.cjs +681 -0
  242. package/plan-build-run/bin/lib/context.cjs +216 -0
  243. package/plan-build-run/bin/lib/core.cjs +1548 -0
  244. package/plan-build-run/bin/lib/frontmatter.cjs +299 -0
  245. package/plan-build-run/bin/lib/gates/advisories.cjs +129 -0
  246. package/plan-build-run/bin/lib/gates/build-dependency.cjs +100 -0
  247. package/plan-build-run/bin/lib/gates/build-executor.cjs +79 -0
  248. package/plan-build-run/bin/lib/gates/doc-existence.cjs +46 -0
  249. package/plan-build-run/bin/lib/gates/helpers.cjs +74 -0
  250. package/plan-build-run/bin/lib/gates/milestone-complete.cjs +120 -0
  251. package/plan-build-run/bin/lib/gates/plan-executor.cjs +36 -0
  252. package/plan-build-run/bin/lib/gates/quick-executor.cjs +76 -0
  253. package/plan-build-run/bin/lib/gates/review-planner.cjs +61 -0
  254. package/plan-build-run/bin/lib/gates/review-verifier.cjs +69 -0
  255. package/plan-build-run/bin/lib/history.cjs +147 -0
  256. package/plan-build-run/bin/lib/init.cjs +304 -0
  257. package/plan-build-run/bin/lib/learnings.cjs +312 -0
  258. package/plan-build-run/bin/lib/local-llm/health.cjs +12 -0
  259. package/plan-build-run/bin/lib/local-llm/index.cjs +89 -0
  260. package/plan-build-run/bin/lib/local-llm/metrics.cjs +20 -0
  261. package/plan-build-run/bin/lib/local-llm/operations/classify-artifact.cjs +4 -0
  262. package/plan-build-run/bin/lib/local-llm/operations/classify-commit.cjs +4 -0
  263. package/plan-build-run/bin/lib/local-llm/operations/classify-error.cjs +4 -0
  264. package/plan-build-run/bin/lib/local-llm/operations/classify-file-intent.cjs +4 -0
  265. package/plan-build-run/bin/lib/local-llm/operations/triage-test-output.cjs +12 -0
  266. package/plan-build-run/bin/lib/local-llm/operations/validate-task.cjs +4 -0
  267. package/plan-build-run/bin/lib/migrate.cjs +248 -0
  268. package/plan-build-run/bin/lib/milestone.cjs +245 -0
  269. package/plan-build-run/bin/lib/phase.cjs +1021 -0
  270. package/plan-build-run/bin/lib/preview.cjs +174 -0
  271. package/plan-build-run/bin/lib/reference.cjs +234 -0
  272. package/plan-build-run/bin/lib/roadmap.cjs +909 -0
  273. package/plan-build-run/bin/lib/skill-section.cjs +98 -0
  274. package/plan-build-run/bin/lib/spot-check.cjs +116 -0
  275. package/plan-build-run/bin/lib/state.cjs +641 -0
  276. package/plan-build-run/bin/lib/step-verify.cjs +149 -0
  277. package/plan-build-run/bin/lib/template.cjs +222 -0
  278. package/plan-build-run/bin/lib/todo.cjs +300 -0
  279. package/plan-build-run/bin/lib/verify.cjs +820 -0
  280. package/plan-build-run/bin/pbr-tools.cjs +1287 -0
  281. package/plan-build-run/references/CLAUDE.md +7 -0
  282. package/plan-build-run/references/agent-contracts.md +324 -0
  283. package/plan-build-run/references/agent-teams.md +54 -0
  284. package/plan-build-run/references/behavioral-contexts.md +53 -0
  285. package/plan-build-run/references/checkpoints.md +776 -0
  286. package/plan-build-run/references/config-reference.md +363 -0
  287. package/plan-build-run/references/continuation-format.md +249 -0
  288. package/plan-build-run/references/debugging/CLAUDE.md +7 -0
  289. package/plan-build-run/references/decimal-phase-calculation.md +65 -0
  290. package/plan-build-run/references/git-integration.md +248 -0
  291. package/plan-build-run/references/git-planning-commit.md +38 -0
  292. package/plan-build-run/references/model-profile-resolution.md +34 -0
  293. package/plan-build-run/references/model-profiles.md +92 -0
  294. package/plan-build-run/references/model-selection.md +53 -0
  295. package/plan-build-run/references/phase-argument-parsing.md +61 -0
  296. package/plan-build-run/references/plan-authoring.md +246 -0
  297. package/plan-build-run/references/plan-format.md +351 -0
  298. package/plan-build-run/references/planning-config.md +200 -0
  299. package/plan-build-run/references/questioning.md +162 -0
  300. package/plan-build-run/references/reading-verification.md +93 -0
  301. package/plan-build-run/references/stub-patterns.md +160 -0
  302. package/plan-build-run/references/tdd.md +263 -0
  303. package/plan-build-run/references/ui-brand.md +187 -0
  304. package/plan-build-run/references/verification-overrides.md +38 -0
  305. package/plan-build-run/references/verification-patterns.md +612 -0
  306. package/plan-build-run/references/wave-execution.md +52 -0
  307. package/plan-build-run/skills/audit/SKILL.md +348 -0
  308. package/plan-build-run/skills/begin/SKILL.md +891 -0
  309. package/{plugins/cursor-pbr → plan-build-run}/skills/begin/templates/PROJECT.md.tmpl +0 -1
  310. package/{plugins/cursor-pbr → plan-build-run}/skills/begin/templates/REQUIREMENTS.md.tmpl +0 -1
  311. package/{plugins/cursor-pbr → plan-build-run}/skills/begin/templates/STATE.md.tmpl +1 -3
  312. package/{plugins/cursor-pbr → plan-build-run}/skills/begin/templates/config.json.tmpl +7 -2
  313. package/plan-build-run/skills/begin/templates/project-CONTEXT.md.tmpl +19 -0
  314. package/plan-build-run/skills/begin/templates/researcher-prompt.md.tmpl +47 -0
  315. package/plan-build-run/skills/begin/templates/roadmap-prompt.md.tmpl +49 -0
  316. package/plan-build-run/skills/begin/templates/synthesis-prompt.md.tmpl +44 -0
  317. package/plan-build-run/skills/build/SKILL.md +1007 -0
  318. package/plan-build-run/skills/build/templates/continuation-prompt.md.tmpl +26 -0
  319. package/plan-build-run/skills/build/templates/executor-prompt.md.tmpl +70 -0
  320. package/plan-build-run/skills/build/templates/inline-verifier-prompt.md.tmpl +33 -0
  321. package/plan-build-run/skills/config/SKILL.md +342 -0
  322. package/plan-build-run/skills/continue/SKILL.md +190 -0
  323. package/plan-build-run/skills/dashboard/SKILL.md +12 -0
  324. package/plan-build-run/skills/debug/SKILL.md +539 -0
  325. package/plan-build-run/skills/debug/templates/continuation-prompt.md.tmpl +27 -0
  326. package/plan-build-run/skills/debug/templates/initial-investigation-prompt.md.tmpl +34 -0
  327. package/plan-build-run/skills/discuss/SKILL.md +440 -0
  328. package/{plugins/cursor-pbr → plan-build-run}/skills/discuss/templates/CONTEXT.md.tmpl +1 -2
  329. package/{plugins/cursor-pbr → plan-build-run}/skills/discuss/templates/decision-categories.md +0 -1
  330. package/plan-build-run/skills/discuss/templates/project-CONTEXT.md.tmpl +19 -0
  331. package/plan-build-run/skills/do/SKILL.md +70 -0
  332. package/plan-build-run/skills/explore/SKILL.md +443 -0
  333. package/plan-build-run/skills/health/SKILL.md +332 -0
  334. package/{plugins/cursor-pbr → plan-build-run}/skills/health/templates/check-pattern.md.tmpl +0 -1
  335. package/{plugins/cursor-pbr → plan-build-run}/skills/health/templates/output-format.md.tmpl +0 -1
  336. package/plan-build-run/skills/help/SKILL.md +236 -0
  337. package/plan-build-run/skills/import/SKILL.md +816 -0
  338. package/plan-build-run/skills/milestone/SKILL.md +659 -0
  339. package/plan-build-run/skills/milestone/templates/audit-output.md.tmpl +76 -0
  340. package/{plugins/cursor-pbr → plan-build-run}/skills/milestone/templates/audit-report.md.tmpl +0 -1
  341. package/plan-build-run/skills/milestone/templates/complete-output.md.tmpl +32 -0
  342. package/plan-build-run/skills/milestone/templates/edge-cases.md +54 -0
  343. package/plan-build-run/skills/milestone/templates/gaps-output.md.tmpl +25 -0
  344. package/plan-build-run/skills/milestone/templates/integration-checker-prompt.md.tmpl +25 -0
  345. package/plan-build-run/skills/milestone/templates/new-output.md.tmpl +29 -0
  346. package/{plugins/cursor-pbr → plan-build-run}/skills/milestone/templates/stats-file.md.tmpl +0 -1
  347. package/plan-build-run/skills/note/SKILL.md +221 -0
  348. package/plan-build-run/skills/pause/SKILL.md +259 -0
  349. package/{plugins/cursor-pbr → plan-build-run}/skills/pause/templates/continue-here.md.tmpl +0 -1
  350. package/plan-build-run/skills/plan/SKILL.md +700 -0
  351. package/plan-build-run/skills/plan/decimal-phase-calc.md +98 -0
  352. package/{plugins/cursor-pbr → plan-build-run}/skills/plan/templates/checker-prompt.md.tmpl +0 -1
  353. package/plan-build-run/skills/plan/templates/completion-output.md.tmpl +27 -0
  354. package/{plugins/cursor-pbr → plan-build-run}/skills/plan/templates/gap-closure-prompt.md.tmpl +0 -1
  355. package/{plugins/cursor-pbr → plan-build-run}/skills/plan/templates/planner-prompt.md.tmpl +1 -2
  356. package/plan-build-run/skills/plan/templates/prompt-partials/phase-project-context.md.tmpl +21 -0
  357. package/{plugins/cursor-pbr → plan-build-run}/skills/plan/templates/researcher-prompt.md.tmpl +0 -1
  358. package/{plugins/cursor-pbr → plan-build-run}/skills/plan/templates/revision-prompt.md.tmpl +0 -1
  359. package/plan-build-run/skills/profile/SKILL.md +173 -0
  360. package/plan-build-run/skills/quick/SKILL.md +440 -0
  361. package/plan-build-run/skills/resume/SKILL.md +404 -0
  362. package/plan-build-run/skills/review/SKILL.md +711 -0
  363. package/{plugins/cursor-pbr → plan-build-run}/skills/review/templates/debugger-prompt.md.tmpl +0 -1
  364. package/{plugins/cursor-pbr → plan-build-run}/skills/review/templates/gap-planner-prompt.md.tmpl +0 -1
  365. package/{plugins/cursor-pbr → plan-build-run}/skills/review/templates/verifier-prompt.md.tmpl +0 -1
  366. package/plan-build-run/skills/scan/SKILL.md +326 -0
  367. package/{plugins/cursor-pbr → plan-build-run}/skills/scan/templates/mapper-prompt.md.tmpl +1 -2
  368. package/plan-build-run/skills/setup/SKILL.md +236 -0
  369. package/plan-build-run/skills/shared/commit-planning-docs.md +43 -0
  370. package/plan-build-run/skills/shared/config-loading.md +102 -0
  371. package/plan-build-run/skills/shared/context-budget.md +92 -0
  372. package/plan-build-run/skills/shared/context-loader-task.md +93 -0
  373. package/plan-build-run/skills/shared/digest-select.md +79 -0
  374. package/plan-build-run/skills/shared/domain-probes.md +125 -0
  375. package/plan-build-run/skills/shared/error-reporting.md +67 -0
  376. package/plan-build-run/skills/shared/gate-prompts.md +390 -0
  377. package/plan-build-run/skills/shared/phase-argument-parsing.md +45 -0
  378. package/plan-build-run/skills/shared/revision-loop.md +81 -0
  379. package/plan-build-run/skills/shared/state-update.md +153 -0
  380. package/plan-build-run/skills/shared/universal-anti-patterns.md +59 -0
  381. package/plan-build-run/skills/status/SKILL.md +485 -0
  382. package/plan-build-run/skills/statusline/SKILL.md +151 -0
  383. package/plan-build-run/skills/test/SKILL.md +212 -0
  384. package/plan-build-run/skills/todo/SKILL.md +301 -0
  385. package/plan-build-run/skills/undo/SKILL.md +216 -0
  386. package/plan-build-run/templates/CLAUDE.md +7 -0
  387. package/plan-build-run/templates/DEBUG.md +164 -0
  388. package/plan-build-run/templates/UAT.md +247 -0
  389. package/plan-build-run/templates/VALIDATION.md +76 -0
  390. package/plan-build-run/templates/codebase/architecture.md +255 -0
  391. package/plan-build-run/templates/codebase/concerns.md +310 -0
  392. package/plan-build-run/templates/codebase/conventions.md +307 -0
  393. package/plan-build-run/templates/codebase/integrations.md +280 -0
  394. package/plan-build-run/templates/codebase/stack.md +186 -0
  395. package/plan-build-run/templates/codebase/structure.md +285 -0
  396. package/plan-build-run/templates/codebase/testing.md +480 -0
  397. package/plan-build-run/templates/config.json +37 -0
  398. package/plan-build-run/templates/context.md +297 -0
  399. package/plan-build-run/templates/continue-here.md +78 -0
  400. package/plan-build-run/templates/crud-flow-verification.md +277 -0
  401. package/plan-build-run/templates/debug-subagent-prompt.md +91 -0
  402. package/plan-build-run/templates/deferred-items.md +19 -0
  403. package/plan-build-run/templates/discovery.md +146 -0
  404. package/plan-build-run/templates/milestone-archive.md +123 -0
  405. package/plan-build-run/templates/milestone.md +115 -0
  406. package/plan-build-run/templates/phase-prompt.md +569 -0
  407. package/plan-build-run/templates/planner-subagent-prompt.md +117 -0
  408. package/plan-build-run/templates/project.md +184 -0
  409. package/plan-build-run/templates/requirements.md +231 -0
  410. package/plan-build-run/templates/research-outputs/ARCHITECTURE.md.tmpl +86 -0
  411. package/plan-build-run/templates/research-outputs/FEATURES.md.tmpl +77 -0
  412. package/plan-build-run/templates/research-outputs/PITFALLS.md.tmpl +65 -0
  413. package/plan-build-run/templates/research-outputs/STACK.md.tmpl +80 -0
  414. package/plan-build-run/templates/research-project/ARCHITECTURE.md +204 -0
  415. package/plan-build-run/templates/research-project/FEATURES.md +147 -0
  416. package/plan-build-run/templates/research-project/PITFALLS.md +200 -0
  417. package/plan-build-run/templates/research-project/STACK.md +120 -0
  418. package/plan-build-run/templates/research-project/SUMMARY.md +170 -0
  419. package/plan-build-run/templates/research.md +552 -0
  420. package/plan-build-run/templates/retrospective.md +54 -0
  421. package/plan-build-run/templates/roadmap.md +202 -0
  422. package/plan-build-run/templates/seed.md +16 -0
  423. package/plan-build-run/templates/state.md +176 -0
  424. package/plan-build-run/templates/summary-complex.md +59 -0
  425. package/plan-build-run/templates/summary-minimal.md +41 -0
  426. package/plan-build-run/templates/summary-standard.md +48 -0
  427. package/plan-build-run/templates/summary.md +248 -0
  428. package/plan-build-run/templates/user-setup.md +311 -0
  429. package/plan-build-run/templates/verification-report.md +322 -0
  430. package/plan-build-run/workflows/add-phase.md +111 -0
  431. package/plan-build-run/workflows/add-todo.md +157 -0
  432. package/plan-build-run/workflows/audit-milestone.md +241 -0
  433. package/plan-build-run/workflows/check-todos.md +176 -0
  434. package/plan-build-run/workflows/complete-milestone.md +644 -0
  435. package/plan-build-run/workflows/diagnose-issues.md +219 -0
  436. package/plan-build-run/workflows/discovery-phase.md +289 -0
  437. package/plan-build-run/workflows/discuss-phase.md +429 -0
  438. package/plan-build-run/workflows/execute-phase.md +439 -0
  439. package/plan-build-run/workflows/execute-plan.md +437 -0
  440. package/plan-build-run/workflows/explore.md +150 -0
  441. package/plan-build-run/workflows/help.md +470 -0
  442. package/plan-build-run/workflows/insert-phase.md +129 -0
  443. package/plan-build-run/workflows/list-phase-assumptions.md +178 -0
  444. package/plan-build-run/workflows/map-codebase.md +327 -0
  445. package/plan-build-run/workflows/new-milestone.md +373 -0
  446. package/plan-build-run/workflows/new-project.md +1009 -0
  447. package/plan-build-run/workflows/note.md +90 -0
  448. package/plan-build-run/workflows/pause-work.md +122 -0
  449. package/plan-build-run/workflows/plan-milestone-gaps.md +256 -0
  450. package/plan-build-run/workflows/plan-phase.md +376 -0
  451. package/plan-build-run/workflows/progress.md +431 -0
  452. package/plan-build-run/workflows/quick.md +230 -0
  453. package/plan-build-run/workflows/remove-phase.md +154 -0
  454. package/plan-build-run/workflows/research-phase.md +74 -0
  455. package/plan-build-run/workflows/resume-project.md +306 -0
  456. package/plan-build-run/workflows/set-profile.md +80 -0
  457. package/plan-build-run/workflows/settings.md +145 -0
  458. package/plan-build-run/workflows/transition.md +539 -0
  459. package/plan-build-run/workflows/update.md +212 -0
  460. package/plan-build-run/workflows/verify-phase.md +226 -0
  461. package/plan-build-run/workflows/verify-work.md +465 -0
  462. package/plugins/codex-pbr/.codex/config.toml +101 -0
  463. package/plugins/codex-pbr/AGENTS.md +653 -0
  464. package/plugins/codex-pbr/README.md +116 -0
  465. package/plugins/codex-pbr/agents/audit.md +240 -0
  466. package/plugins/codex-pbr/agents/codebase-mapper.md +225 -0
  467. package/plugins/codex-pbr/agents/debugger.md +300 -0
  468. package/plugins/codex-pbr/agents/dev-sync.md +198 -0
  469. package/plugins/codex-pbr/agents/executor.md +549 -0
  470. package/plugins/codex-pbr/agents/general.md +151 -0
  471. package/plugins/codex-pbr/agents/integration-checker.md +230 -0
  472. package/plugins/codex-pbr/agents/nyquist-auditor.md +244 -0
  473. package/plugins/codex-pbr/agents/plan-checker.md +306 -0
  474. package/plugins/codex-pbr/agents/planner.md +464 -0
  475. package/plugins/codex-pbr/agents/researcher.md +304 -0
  476. package/plugins/codex-pbr/agents/roadmapper.md +339 -0
  477. package/plugins/codex-pbr/agents/synthesizer.md +267 -0
  478. package/plugins/codex-pbr/agents/verifier.md +488 -0
  479. package/plugins/codex-pbr/commands/add-phase.md +75 -0
  480. package/plugins/codex-pbr/commands/add-todo.md +8 -0
  481. package/plugins/codex-pbr/commands/audit-milestone.md +8 -0
  482. package/plugins/codex-pbr/commands/audit.md +5 -0
  483. package/plugins/codex-pbr/commands/check-todos.md +8 -0
  484. package/plugins/codex-pbr/commands/complete-milestone.md +8 -0
  485. package/plugins/codex-pbr/commands/config.md +5 -0
  486. package/plugins/codex-pbr/commands/continue.md +5 -0
  487. package/plugins/codex-pbr/commands/dashboard.md +5 -0
  488. package/plugins/codex-pbr/commands/debug.md +5 -0
  489. package/plugins/codex-pbr/commands/discuss-phase.md +6 -0
  490. package/plugins/codex-pbr/commands/do.md +5 -0
  491. package/plugins/codex-pbr/commands/execute-phase.md +6 -0
  492. package/plugins/codex-pbr/commands/explore.md +5 -0
  493. package/plugins/codex-pbr/commands/health.md +5 -0
  494. package/plugins/codex-pbr/commands/help.md +5 -0
  495. package/plugins/codex-pbr/commands/import.md +5 -0
  496. package/plugins/codex-pbr/commands/insert-phase.md +65 -0
  497. package/plugins/codex-pbr/commands/join-discord.md +11 -0
  498. package/plugins/codex-pbr/commands/list-phase-assumptions.md +69 -0
  499. package/plugins/codex-pbr/commands/map-codebase.md +6 -0
  500. package/plugins/codex-pbr/commands/new-milestone.md +8 -0
  501. package/plugins/codex-pbr/commands/new-project.md +6 -0
  502. package/plugins/codex-pbr/commands/note.md +5 -0
  503. package/plugins/codex-pbr/commands/pause-work.md +5 -0
  504. package/plugins/codex-pbr/commands/plan-milestone-gaps.md +7 -0
  505. package/plugins/codex-pbr/commands/plan-phase.md +6 -0
  506. package/plugins/codex-pbr/commands/progress.md +6 -0
  507. package/plugins/codex-pbr/commands/quick.md +5 -0
  508. package/plugins/codex-pbr/commands/reapply-patches.md +40 -0
  509. package/plugins/codex-pbr/commands/remove-phase.md +66 -0
  510. package/plugins/codex-pbr/commands/research-phase.md +59 -0
  511. package/plugins/codex-pbr/commands/resume-work.md +5 -0
  512. package/plugins/codex-pbr/commands/set-profile.md +6 -0
  513. package/plugins/codex-pbr/commands/settings.md +5 -0
  514. package/plugins/codex-pbr/commands/setup.md +5 -0
  515. package/plugins/codex-pbr/commands/statusline.md +5 -0
  516. package/plugins/codex-pbr/commands/test.md +5 -0
  517. package/plugins/codex-pbr/commands/undo.md +5 -0
  518. package/plugins/codex-pbr/commands/update.md +37 -0
  519. package/plugins/codex-pbr/commands/verify-work.md +6 -0
  520. package/plugins/codex-pbr/references/agent-contracts.md +324 -0
  521. package/plugins/codex-pbr/references/agent-teams.md +54 -0
  522. package/plugins/codex-pbr/references/common-bug-patterns.md +13 -0
  523. package/plugins/codex-pbr/references/config-reference.md +587 -0
  524. package/plugins/codex-pbr/references/continuation-format.md +212 -0
  525. package/plugins/codex-pbr/references/deviation-rules.md +112 -0
  526. package/plugins/codex-pbr/references/git-integration.md +284 -0
  527. package/plugins/codex-pbr/references/integration-patterns.md +117 -0
  528. package/plugins/codex-pbr/references/model-profiles.md +143 -0
  529. package/plugins/codex-pbr/references/model-selection.md +31 -0
  530. package/plugins/codex-pbr/references/pbr-tools-cli.md +400 -0
  531. package/plugins/codex-pbr/references/plan-authoring.md +246 -0
  532. package/plugins/codex-pbr/references/plan-format.md +351 -0
  533. package/plugins/codex-pbr/references/questioning.md +303 -0
  534. package/plugins/codex-pbr/references/reading-verification.md +127 -0
  535. package/plugins/codex-pbr/references/signal-files.md +41 -0
  536. package/plugins/codex-pbr/references/stub-patterns.md +160 -0
  537. package/plugins/codex-pbr/references/tmux-setup.md +286 -0
  538. package/plugins/codex-pbr/references/ui-formatting.md +449 -0
  539. package/plugins/codex-pbr/references/wave-execution.md +95 -0
  540. package/plugins/codex-pbr/skills/audit/SKILL.md +346 -0
  541. package/plugins/codex-pbr/skills/begin/SKILL.md +886 -0
  542. package/plugins/codex-pbr/skills/build/SKILL.md +992 -0
  543. package/plugins/codex-pbr/skills/config/SKILL.md +341 -0
  544. package/plugins/codex-pbr/skills/continue/SKILL.md +172 -0
  545. package/plugins/codex-pbr/skills/dashboard/SKILL.md +56 -0
  546. package/plugins/codex-pbr/skills/debug/SKILL.md +537 -0
  547. package/plugins/codex-pbr/skills/discuss/SKILL.md +438 -0
  548. package/plugins/codex-pbr/skills/do/SKILL.md +68 -0
  549. package/plugins/codex-pbr/skills/explore/SKILL.md +441 -0
  550. package/plugins/codex-pbr/skills/health/SKILL.md +330 -0
  551. package/plugins/codex-pbr/skills/help/SKILL.md +231 -0
  552. package/plugins/codex-pbr/skills/import/SKILL.md +814 -0
  553. package/plugins/codex-pbr/skills/milestone/SKILL.md +637 -0
  554. package/plugins/codex-pbr/skills/note/SKILL.md +219 -0
  555. package/plugins/codex-pbr/skills/pause/SKILL.md +258 -0
  556. package/plugins/codex-pbr/skills/plan/SKILL.md +689 -0
  557. package/plugins/codex-pbr/skills/profile/SKILL.md +171 -0
  558. package/plugins/codex-pbr/skills/quick/SKILL.md +437 -0
  559. package/plugins/codex-pbr/skills/resume/SKILL.md +403 -0
  560. package/plugins/codex-pbr/skills/review/SKILL.md +693 -0
  561. package/plugins/codex-pbr/skills/scan/SKILL.md +325 -0
  562. package/plugins/codex-pbr/skills/setup/SKILL.md +235 -0
  563. package/plugins/codex-pbr/skills/shared/commit-planning-docs.md +43 -0
  564. package/plugins/codex-pbr/skills/shared/config-loading.md +102 -0
  565. package/plugins/codex-pbr/skills/shared/context-budget.md +92 -0
  566. package/plugins/codex-pbr/skills/shared/context-loader-task.md +93 -0
  567. package/plugins/codex-pbr/skills/shared/digest-select.md +79 -0
  568. package/plugins/codex-pbr/skills/shared/domain-probes.md +125 -0
  569. package/plugins/codex-pbr/skills/shared/error-reporting.md +59 -0
  570. package/plugins/codex-pbr/skills/shared/gate-prompts.md +390 -0
  571. package/plugins/codex-pbr/skills/shared/phase-argument-parsing.md +45 -0
  572. package/plugins/codex-pbr/skills/shared/revision-loop.md +81 -0
  573. package/plugins/codex-pbr/skills/shared/state-update.md +153 -0
  574. package/plugins/codex-pbr/skills/shared/universal-anti-patterns.md +59 -0
  575. package/plugins/codex-pbr/skills/status/SKILL.md +484 -0
  576. package/plugins/codex-pbr/skills/statusline/SKILL.md +149 -0
  577. package/plugins/codex-pbr/skills/test/SKILL.md +210 -0
  578. package/plugins/codex-pbr/skills/todo/SKILL.md +281 -0
  579. package/plugins/codex-pbr/skills/undo/SKILL.md +214 -0
  580. package/plugins/codex-pbr/templates/CONTEXT.md.tmpl +52 -0
  581. package/plugins/codex-pbr/templates/INTEGRATION-REPORT.md.tmpl +167 -0
  582. package/plugins/codex-pbr/templates/PROJECT.md.tmpl +111 -0
  583. package/plugins/codex-pbr/templates/REQUIREMENTS.md.tmpl +96 -0
  584. package/plugins/codex-pbr/templates/ROADMAP.md.tmpl +105 -0
  585. package/plugins/codex-pbr/templates/SUMMARY-complex.md.tmpl +112 -0
  586. package/plugins/codex-pbr/templates/SUMMARY-minimal.md.tmpl +48 -0
  587. package/plugins/codex-pbr/templates/SUMMARY.md.tmpl +81 -0
  588. package/plugins/codex-pbr/templates/VERIFICATION-DETAIL.md.tmpl +119 -0
  589. package/plugins/codex-pbr/templates/codebase/ARCHITECTURE.md.tmpl +98 -0
  590. package/plugins/codex-pbr/templates/codebase/CONCERNS.md.tmpl +93 -0
  591. package/plugins/codex-pbr/templates/codebase/CONVENTIONS.md.tmpl +104 -0
  592. package/plugins/codex-pbr/templates/codebase/INTEGRATIONS.md.tmpl +78 -0
  593. package/plugins/codex-pbr/templates/codebase/STACK.md.tmpl +78 -0
  594. package/plugins/codex-pbr/templates/codebase/STRUCTURE.md.tmpl +80 -0
  595. package/plugins/codex-pbr/templates/codebase/TESTING.md.tmpl +107 -0
  596. package/plugins/codex-pbr/templates/continue-here.md.tmpl +73 -0
  597. package/plugins/codex-pbr/templates/pr-body.md.tmpl +22 -0
  598. package/plugins/codex-pbr/templates/project-CONTEXT.md.tmpl +43 -0
  599. package/plugins/codex-pbr/templates/prompt-partials/phase-project-context.md.tmpl +37 -0
  600. package/plugins/codex-pbr/templates/research-outputs/ARCHITECTURE.md.tmpl +91 -0
  601. package/plugins/codex-pbr/templates/research-outputs/FEATURES.md.tmpl +64 -0
  602. package/plugins/codex-pbr/templates/research-outputs/PITFALLS.md.tmpl +50 -0
  603. package/plugins/codex-pbr/templates/research-outputs/STACK.md.tmpl +63 -0
  604. package/plugins/codex-pbr/templates/research-outputs/SUMMARY.md.tmpl +98 -0
  605. package/plugins/copilot-pbr/CHANGELOG.md +19 -0
  606. package/plugins/copilot-pbr/README.md +139 -0
  607. package/plugins/copilot-pbr/agents/audit.agent.md +240 -0
  608. package/plugins/copilot-pbr/agents/codebase-mapper.agent.md +225 -0
  609. package/plugins/copilot-pbr/agents/debugger.agent.md +300 -0
  610. package/plugins/copilot-pbr/agents/dev-sync.agent.md +198 -0
  611. package/plugins/copilot-pbr/agents/executor.agent.md +549 -0
  612. package/plugins/copilot-pbr/agents/general.agent.md +151 -0
  613. package/plugins/copilot-pbr/agents/integration-checker.agent.md +230 -0
  614. package/plugins/copilot-pbr/agents/nyquist-auditor.agent.md +244 -0
  615. package/plugins/copilot-pbr/agents/plan-checker.agent.md +306 -0
  616. package/plugins/copilot-pbr/agents/planner.agent.md +464 -0
  617. package/plugins/copilot-pbr/agents/researcher.agent.md +304 -0
  618. package/plugins/copilot-pbr/agents/roadmapper.agent.md +339 -0
  619. package/plugins/copilot-pbr/agents/synthesizer.agent.md +267 -0
  620. package/plugins/copilot-pbr/agents/verifier.agent.md +488 -0
  621. package/plugins/copilot-pbr/commands/add-phase.md +75 -0
  622. package/plugins/copilot-pbr/commands/add-todo.md +8 -0
  623. package/plugins/copilot-pbr/commands/audit-milestone.md +8 -0
  624. package/plugins/copilot-pbr/commands/audit.md +5 -0
  625. package/plugins/copilot-pbr/commands/check-todos.md +8 -0
  626. package/plugins/copilot-pbr/commands/complete-milestone.md +8 -0
  627. package/plugins/copilot-pbr/commands/config.md +5 -0
  628. package/plugins/copilot-pbr/commands/continue.md +5 -0
  629. package/plugins/copilot-pbr/commands/dashboard.md +5 -0
  630. package/plugins/copilot-pbr/commands/debug.md +5 -0
  631. package/plugins/copilot-pbr/commands/discuss-phase.md +6 -0
  632. package/plugins/copilot-pbr/commands/do.md +5 -0
  633. package/plugins/copilot-pbr/commands/execute-phase.md +6 -0
  634. package/plugins/copilot-pbr/commands/explore.md +5 -0
  635. package/plugins/copilot-pbr/commands/health.md +5 -0
  636. package/plugins/copilot-pbr/commands/help.md +5 -0
  637. package/plugins/copilot-pbr/commands/import.md +5 -0
  638. package/plugins/copilot-pbr/commands/insert-phase.md +65 -0
  639. package/plugins/copilot-pbr/commands/join-discord.md +11 -0
  640. package/plugins/copilot-pbr/commands/list-phase-assumptions.md +69 -0
  641. package/plugins/copilot-pbr/commands/map-codebase.md +6 -0
  642. package/plugins/copilot-pbr/commands/new-milestone.md +8 -0
  643. package/plugins/copilot-pbr/commands/new-project.md +6 -0
  644. package/plugins/copilot-pbr/commands/note.md +5 -0
  645. package/plugins/copilot-pbr/commands/pause-work.md +5 -0
  646. package/plugins/copilot-pbr/commands/plan-milestone-gaps.md +7 -0
  647. package/plugins/copilot-pbr/commands/plan-phase.md +6 -0
  648. package/plugins/copilot-pbr/commands/progress.md +6 -0
  649. package/plugins/copilot-pbr/commands/quick.md +5 -0
  650. package/plugins/copilot-pbr/commands/reapply-patches.md +40 -0
  651. package/plugins/copilot-pbr/commands/remove-phase.md +66 -0
  652. package/plugins/copilot-pbr/commands/research-phase.md +59 -0
  653. package/plugins/copilot-pbr/commands/resume-work.md +5 -0
  654. package/plugins/copilot-pbr/commands/set-profile.md +6 -0
  655. package/plugins/copilot-pbr/commands/settings.md +5 -0
  656. package/plugins/copilot-pbr/commands/setup.md +5 -0
  657. package/plugins/copilot-pbr/commands/statusline.md +5 -0
  658. package/plugins/copilot-pbr/commands/test.md +5 -0
  659. package/plugins/copilot-pbr/commands/undo.md +5 -0
  660. package/plugins/copilot-pbr/commands/update.md +37 -0
  661. package/plugins/copilot-pbr/commands/verify-work.md +6 -0
  662. package/plugins/copilot-pbr/hooks/hooks.json +309 -0
  663. package/plugins/copilot-pbr/plugin.json +30 -0
  664. package/plugins/copilot-pbr/references/agent-contracts.md +324 -0
  665. package/plugins/copilot-pbr/references/agent-teams.md +54 -0
  666. package/plugins/copilot-pbr/references/common-bug-patterns.md +13 -0
  667. package/plugins/copilot-pbr/references/config-reference.md +587 -0
  668. package/plugins/copilot-pbr/references/continuation-format.md +212 -0
  669. package/plugins/copilot-pbr/references/deviation-rules.md +112 -0
  670. package/plugins/copilot-pbr/references/git-integration.md +284 -0
  671. package/plugins/copilot-pbr/references/integration-patterns.md +117 -0
  672. package/plugins/copilot-pbr/references/model-profiles.md +143 -0
  673. package/plugins/copilot-pbr/references/model-selection.md +31 -0
  674. package/plugins/copilot-pbr/references/pbr-tools-cli.md +400 -0
  675. package/plugins/copilot-pbr/references/plan-authoring.md +246 -0
  676. package/plugins/copilot-pbr/references/plan-format.md +351 -0
  677. package/plugins/copilot-pbr/references/questioning.md +303 -0
  678. package/plugins/copilot-pbr/references/reading-verification.md +127 -0
  679. package/plugins/copilot-pbr/references/signal-files.md +41 -0
  680. package/plugins/copilot-pbr/references/stub-patterns.md +160 -0
  681. package/plugins/copilot-pbr/references/tmux-setup.md +286 -0
  682. package/plugins/copilot-pbr/references/ui-formatting.md +449 -0
  683. package/plugins/copilot-pbr/references/wave-execution.md +95 -0
  684. package/plugins/copilot-pbr/rules/pbr-workflow.mdc +48 -0
  685. package/plugins/copilot-pbr/setup.ps1 +93 -0
  686. package/plugins/copilot-pbr/setup.sh +93 -0
  687. package/plugins/copilot-pbr/skills/audit/SKILL.md +346 -0
  688. package/plugins/copilot-pbr/skills/begin/SKILL.md +886 -0
  689. package/plugins/copilot-pbr/skills/build/SKILL.md +992 -0
  690. package/plugins/copilot-pbr/skills/config/SKILL.md +341 -0
  691. package/plugins/copilot-pbr/skills/continue/SKILL.md +172 -0
  692. package/plugins/copilot-pbr/skills/dashboard/SKILL.md +56 -0
  693. package/plugins/copilot-pbr/skills/debug/SKILL.md +537 -0
  694. package/plugins/copilot-pbr/skills/discuss/SKILL.md +438 -0
  695. package/plugins/copilot-pbr/skills/do/SKILL.md +68 -0
  696. package/plugins/copilot-pbr/skills/explore/SKILL.md +441 -0
  697. package/plugins/copilot-pbr/skills/health/SKILL.md +330 -0
  698. package/plugins/copilot-pbr/skills/help/SKILL.md +231 -0
  699. package/plugins/copilot-pbr/skills/import/SKILL.md +814 -0
  700. package/plugins/copilot-pbr/skills/milestone/SKILL.md +637 -0
  701. package/plugins/copilot-pbr/skills/note/SKILL.md +219 -0
  702. package/plugins/copilot-pbr/skills/pause/SKILL.md +258 -0
  703. package/plugins/copilot-pbr/skills/plan/SKILL.md +689 -0
  704. package/plugins/copilot-pbr/skills/profile/SKILL.md +171 -0
  705. package/plugins/copilot-pbr/skills/quick/SKILL.md +437 -0
  706. package/plugins/copilot-pbr/skills/resume/SKILL.md +403 -0
  707. package/plugins/copilot-pbr/skills/review/SKILL.md +693 -0
  708. package/plugins/copilot-pbr/skills/scan/SKILL.md +325 -0
  709. package/plugins/copilot-pbr/skills/setup/SKILL.md +235 -0
  710. package/plugins/copilot-pbr/skills/shared/commit-planning-docs.md +43 -0
  711. package/plugins/copilot-pbr/skills/shared/config-loading.md +102 -0
  712. package/plugins/copilot-pbr/skills/shared/context-budget.md +92 -0
  713. package/plugins/copilot-pbr/skills/shared/context-loader-task.md +93 -0
  714. package/plugins/copilot-pbr/skills/shared/digest-select.md +79 -0
  715. package/plugins/copilot-pbr/skills/shared/domain-probes.md +125 -0
  716. package/plugins/copilot-pbr/skills/shared/error-reporting.md +59 -0
  717. package/plugins/copilot-pbr/skills/shared/gate-prompts.md +390 -0
  718. package/plugins/copilot-pbr/skills/shared/phase-argument-parsing.md +45 -0
  719. package/plugins/copilot-pbr/skills/shared/revision-loop.md +81 -0
  720. package/plugins/copilot-pbr/skills/shared/state-update.md +153 -0
  721. package/plugins/copilot-pbr/skills/shared/universal-anti-patterns.md +59 -0
  722. package/plugins/copilot-pbr/skills/status/SKILL.md +484 -0
  723. package/plugins/copilot-pbr/skills/statusline/SKILL.md +149 -0
  724. package/plugins/copilot-pbr/skills/test/SKILL.md +210 -0
  725. package/plugins/copilot-pbr/skills/todo/SKILL.md +281 -0
  726. package/plugins/copilot-pbr/skills/undo/SKILL.md +214 -0
  727. package/plugins/copilot-pbr/templates/CONTEXT.md.tmpl +52 -0
  728. package/plugins/copilot-pbr/templates/INTEGRATION-REPORT.md.tmpl +167 -0
  729. package/plugins/copilot-pbr/templates/PROJECT.md.tmpl +111 -0
  730. package/plugins/copilot-pbr/templates/REQUIREMENTS.md.tmpl +96 -0
  731. package/plugins/copilot-pbr/templates/ROADMAP.md.tmpl +105 -0
  732. package/plugins/copilot-pbr/templates/SUMMARY-complex.md.tmpl +112 -0
  733. package/plugins/copilot-pbr/templates/SUMMARY-minimal.md.tmpl +48 -0
  734. package/plugins/copilot-pbr/templates/SUMMARY.md.tmpl +81 -0
  735. package/plugins/copilot-pbr/templates/VERIFICATION-DETAIL.md.tmpl +119 -0
  736. package/plugins/copilot-pbr/templates/codebase/ARCHITECTURE.md.tmpl +98 -0
  737. package/plugins/copilot-pbr/templates/codebase/CONCERNS.md.tmpl +93 -0
  738. package/plugins/copilot-pbr/templates/codebase/CONVENTIONS.md.tmpl +104 -0
  739. package/plugins/copilot-pbr/templates/codebase/INTEGRATIONS.md.tmpl +78 -0
  740. package/plugins/copilot-pbr/templates/codebase/STACK.md.tmpl +78 -0
  741. package/plugins/copilot-pbr/templates/codebase/STRUCTURE.md.tmpl +80 -0
  742. package/plugins/copilot-pbr/templates/codebase/TESTING.md.tmpl +107 -0
  743. package/plugins/copilot-pbr/templates/continue-here.md.tmpl +73 -0
  744. package/plugins/copilot-pbr/templates/pr-body.md.tmpl +22 -0
  745. package/plugins/copilot-pbr/templates/project-CONTEXT.md.tmpl +43 -0
  746. package/plugins/copilot-pbr/templates/prompt-partials/phase-project-context.md.tmpl +37 -0
  747. package/plugins/copilot-pbr/templates/research-outputs/ARCHITECTURE.md.tmpl +91 -0
  748. package/plugins/copilot-pbr/templates/research-outputs/FEATURES.md.tmpl +64 -0
  749. package/plugins/copilot-pbr/templates/research-outputs/PITFALLS.md.tmpl +50 -0
  750. package/plugins/copilot-pbr/templates/research-outputs/STACK.md.tmpl +63 -0
  751. package/plugins/copilot-pbr/templates/research-outputs/SUMMARY.md.tmpl +98 -0
  752. package/plugins/cursor-pbr/.cursor-plugin/plugin.json +13 -3
  753. package/plugins/cursor-pbr/README.md +32 -7
  754. package/plugins/cursor-pbr/agents/audit.md +242 -0
  755. package/plugins/cursor-pbr/agents/codebase-mapper.md +134 -15
  756. package/plugins/cursor-pbr/agents/debugger.md +160 -26
  757. package/plugins/cursor-pbr/agents/dev-sync.md +200 -0
  758. package/plugins/cursor-pbr/agents/executor.md +354 -39
  759. package/plugins/cursor-pbr/agents/general.md +70 -4
  760. package/plugins/cursor-pbr/agents/integration-checker.md +171 -26
  761. package/plugins/cursor-pbr/agents/nyquist-auditor.md +246 -0
  762. package/plugins/cursor-pbr/agents/plan-checker.md +152 -42
  763. package/plugins/cursor-pbr/agents/planner.md +315 -29
  764. package/plugins/cursor-pbr/agents/researcher.md +174 -30
  765. package/plugins/cursor-pbr/agents/roadmapper.md +341 -0
  766. package/plugins/cursor-pbr/agents/synthesizer.md +191 -23
  767. package/plugins/cursor-pbr/agents/verifier.md +320 -23
  768. package/plugins/cursor-pbr/commands/add-phase.md +75 -0
  769. package/plugins/cursor-pbr/commands/add-todo.md +8 -0
  770. package/plugins/cursor-pbr/commands/audit-milestone.md +8 -0
  771. package/plugins/cursor-pbr/commands/audit.md +5 -0
  772. package/plugins/cursor-pbr/commands/check-todos.md +8 -0
  773. package/plugins/cursor-pbr/commands/complete-milestone.md +8 -0
  774. package/plugins/cursor-pbr/commands/config.md +5 -0
  775. package/plugins/cursor-pbr/commands/continue.md +5 -0
  776. package/plugins/cursor-pbr/commands/dashboard.md +5 -0
  777. package/plugins/cursor-pbr/commands/debug.md +5 -0
  778. package/plugins/cursor-pbr/commands/discuss-phase.md +6 -0
  779. package/plugins/cursor-pbr/commands/do.md +5 -0
  780. package/plugins/cursor-pbr/commands/execute-phase.md +6 -0
  781. package/plugins/cursor-pbr/commands/explore.md +5 -0
  782. package/plugins/cursor-pbr/commands/health.md +5 -0
  783. package/plugins/cursor-pbr/commands/help.md +5 -0
  784. package/plugins/cursor-pbr/commands/import.md +5 -0
  785. package/plugins/cursor-pbr/commands/insert-phase.md +65 -0
  786. package/plugins/cursor-pbr/commands/join-discord.md +11 -0
  787. package/plugins/cursor-pbr/commands/list-phase-assumptions.md +69 -0
  788. package/plugins/cursor-pbr/commands/map-codebase.md +6 -0
  789. package/plugins/cursor-pbr/commands/new-milestone.md +8 -0
  790. package/plugins/cursor-pbr/commands/new-project.md +6 -0
  791. package/plugins/cursor-pbr/commands/note.md +5 -0
  792. package/plugins/cursor-pbr/commands/pause-work.md +5 -0
  793. package/plugins/cursor-pbr/commands/plan-milestone-gaps.md +7 -0
  794. package/plugins/cursor-pbr/commands/plan-phase.md +6 -0
  795. package/plugins/cursor-pbr/commands/progress.md +6 -0
  796. package/plugins/cursor-pbr/commands/quick.md +5 -0
  797. package/plugins/cursor-pbr/commands/reapply-patches.md +40 -0
  798. package/plugins/cursor-pbr/commands/remove-phase.md +66 -0
  799. package/plugins/cursor-pbr/commands/research-phase.md +59 -0
  800. package/plugins/cursor-pbr/commands/resume-work.md +5 -0
  801. package/plugins/cursor-pbr/commands/set-profile.md +6 -0
  802. package/plugins/cursor-pbr/commands/settings.md +5 -0
  803. package/plugins/cursor-pbr/commands/setup.md +5 -0
  804. package/plugins/cursor-pbr/commands/statusline.md +5 -0
  805. package/plugins/cursor-pbr/commands/test.md +5 -0
  806. package/plugins/cursor-pbr/commands/undo.md +5 -0
  807. package/plugins/cursor-pbr/commands/update.md +37 -0
  808. package/plugins/cursor-pbr/commands/verify-work.md +6 -0
  809. package/plugins/cursor-pbr/hooks/hooks.json +96 -28
  810. package/plugins/cursor-pbr/references/agent-contracts.md +324 -0
  811. package/plugins/cursor-pbr/references/agent-teams.md +3 -4
  812. package/plugins/cursor-pbr/references/common-bug-patterns.md +0 -1
  813. package/plugins/cursor-pbr/references/config-reference.md +155 -10
  814. package/plugins/cursor-pbr/references/continuation-format.md +0 -1
  815. package/plugins/cursor-pbr/references/deviation-rules.md +0 -1
  816. package/plugins/cursor-pbr/references/git-integration.md +80 -23
  817. package/plugins/cursor-pbr/references/integration-patterns.md +0 -1
  818. package/plugins/cursor-pbr/references/model-profiles.md +51 -8
  819. package/plugins/cursor-pbr/references/model-selection.md +1 -2
  820. package/plugins/cursor-pbr/references/pbr-tools-cli.md +400 -0
  821. package/plugins/cursor-pbr/references/plan-authoring.md +65 -1
  822. package/plugins/cursor-pbr/references/plan-format.md +72 -9
  823. package/plugins/cursor-pbr/references/questioning.md +138 -50
  824. package/plugins/cursor-pbr/references/reading-verification.md +3 -4
  825. package/plugins/cursor-pbr/references/signal-files.md +41 -0
  826. package/plugins/cursor-pbr/references/stub-patterns.md +0 -1
  827. package/plugins/cursor-pbr/references/tmux-setup.md +286 -0
  828. package/plugins/cursor-pbr/references/ui-formatting.md +67 -80
  829. package/plugins/cursor-pbr/references/wave-execution.md +0 -1
  830. package/plugins/cursor-pbr/rules/pbr-workflow.mdc +6 -6
  831. package/plugins/cursor-pbr/setup.ps1 +1 -1
  832. package/plugins/cursor-pbr/setup.sh +1 -1
  833. package/plugins/cursor-pbr/skills/audit/SKILL.md +347 -0
  834. package/plugins/cursor-pbr/skills/begin/SKILL.md +461 -141
  835. package/plugins/cursor-pbr/skills/build/SKILL.md +420 -329
  836. package/plugins/cursor-pbr/skills/config/SKILL.md +107 -19
  837. package/plugins/cursor-pbr/skills/continue/SKILL.md +49 -36
  838. package/plugins/cursor-pbr/skills/dashboard/SKILL.md +57 -0
  839. package/plugins/cursor-pbr/skills/debug/SKILL.md +60 -34
  840. package/plugins/cursor-pbr/skills/discuss/SKILL.md +125 -30
  841. package/plugins/cursor-pbr/skills/do/SKILL.md +69 -0
  842. package/plugins/cursor-pbr/skills/explore/SKILL.md +90 -23
  843. package/plugins/cursor-pbr/skills/health/SKILL.md +144 -31
  844. package/plugins/cursor-pbr/skills/help/SKILL.md +124 -45
  845. package/plugins/cursor-pbr/skills/import/SKILL.md +346 -30
  846. package/plugins/cursor-pbr/skills/milestone/SKILL.md +189 -252
  847. package/plugins/cursor-pbr/skills/note/SKILL.md +47 -55
  848. package/plugins/cursor-pbr/skills/pause/SKILL.md +28 -16
  849. package/plugins/cursor-pbr/skills/plan/SKILL.md +305 -263
  850. package/plugins/cursor-pbr/skills/profile/SKILL.md +172 -0
  851. package/plugins/cursor-pbr/skills/quick/SKILL.md +106 -20
  852. package/plugins/cursor-pbr/skills/resume/SKILL.md +31 -27
  853. package/plugins/cursor-pbr/skills/review/SKILL.md +212 -167
  854. package/plugins/cursor-pbr/skills/scan/SKILL.md +47 -23
  855. package/plugins/cursor-pbr/skills/setup/SKILL.md +158 -173
  856. package/plugins/cursor-pbr/skills/shared/commit-planning-docs.md +8 -1
  857. package/plugins/cursor-pbr/skills/shared/config-loading.md +1 -2
  858. package/plugins/cursor-pbr/skills/shared/context-budget.md +56 -5
  859. package/plugins/cursor-pbr/skills/shared/context-loader-task.md +9 -3
  860. package/plugins/cursor-pbr/skills/shared/digest-select.md +2 -3
  861. package/plugins/cursor-pbr/skills/shared/domain-probes.md +1 -2
  862. package/plugins/cursor-pbr/skills/shared/error-reporting.md +38 -59
  863. package/plugins/cursor-pbr/skills/shared/gate-prompts.md +4 -3
  864. package/plugins/cursor-pbr/skills/shared/phase-argument-parsing.md +6 -7
  865. package/plugins/cursor-pbr/skills/shared/revision-loop.md +0 -1
  866. package/plugins/cursor-pbr/skills/shared/state-update.md +38 -47
  867. package/plugins/cursor-pbr/skills/shared/universal-anti-patterns.md +34 -9
  868. package/plugins/cursor-pbr/skills/status/SKILL.md +174 -52
  869. package/plugins/cursor-pbr/skills/statusline/SKILL.md +150 -0
  870. package/plugins/cursor-pbr/skills/test/SKILL.md +211 -0
  871. package/plugins/cursor-pbr/skills/todo/SKILL.md +118 -31
  872. package/plugins/cursor-pbr/skills/undo/SKILL.md +215 -0
  873. package/plugins/cursor-pbr/templates/CONTEXT.md.tmpl +1 -2
  874. package/plugins/cursor-pbr/templates/INTEGRATION-REPORT.md.tmpl +18 -3
  875. package/plugins/cursor-pbr/templates/PROJECT.md.tmpl +111 -0
  876. package/plugins/cursor-pbr/templates/REQUIREMENTS.md.tmpl +96 -0
  877. package/plugins/cursor-pbr/templates/ROADMAP.md.tmpl +80 -16
  878. package/plugins/cursor-pbr/templates/SUMMARY-complex.md.tmpl +112 -0
  879. package/plugins/cursor-pbr/templates/SUMMARY-minimal.md.tmpl +48 -0
  880. package/plugins/cursor-pbr/templates/SUMMARY.md.tmpl +0 -1
  881. package/plugins/cursor-pbr/templates/VERIFICATION-DETAIL.md.tmpl +13 -11
  882. package/plugins/cursor-pbr/templates/codebase/ARCHITECTURE.md.tmpl +98 -0
  883. package/plugins/cursor-pbr/templates/codebase/CONCERNS.md.tmpl +93 -0
  884. package/plugins/cursor-pbr/templates/codebase/CONVENTIONS.md.tmpl +104 -0
  885. package/plugins/cursor-pbr/templates/codebase/INTEGRATIONS.md.tmpl +78 -0
  886. package/plugins/cursor-pbr/templates/codebase/STACK.md.tmpl +78 -0
  887. package/plugins/cursor-pbr/templates/codebase/STRUCTURE.md.tmpl +80 -0
  888. package/plugins/cursor-pbr/templates/codebase/TESTING.md.tmpl +107 -0
  889. package/plugins/cursor-pbr/templates/continue-here.md.tmpl +0 -1
  890. package/plugins/cursor-pbr/templates/pr-body.md.tmpl +22 -0
  891. package/plugins/cursor-pbr/templates/project-CONTEXT.md.tmpl +43 -0
  892. package/plugins/cursor-pbr/templates/prompt-partials/phase-project-context.md.tmpl +0 -1
  893. package/plugins/cursor-pbr/templates/research-outputs/ARCHITECTURE.md.tmpl +91 -0
  894. package/plugins/cursor-pbr/templates/research-outputs/FEATURES.md.tmpl +64 -0
  895. package/plugins/cursor-pbr/templates/research-outputs/PITFALLS.md.tmpl +50 -0
  896. package/plugins/cursor-pbr/templates/research-outputs/STACK.md.tmpl +63 -0
  897. package/plugins/cursor-pbr/templates/research-outputs/SUMMARY.md.tmpl +98 -0
  898. package/plugins/pbr/.claude-plugin/plugin.json +7 -2
  899. package/plugins/pbr/UI-CONSISTENCY-GAPS.md +1 -1
  900. package/plugins/pbr/agents/audit.md +247 -0
  901. package/plugins/pbr/agents/codebase-mapper.md +151 -18
  902. package/plugins/pbr/agents/debugger.md +180 -28
  903. package/plugins/pbr/agents/dev-sync.md +206 -0
  904. package/plugins/pbr/agents/executor.md +365 -40
  905. package/plugins/pbr/agents/general.md +70 -5
  906. package/plugins/pbr/agents/integration-checker.md +174 -27
  907. package/plugins/pbr/agents/nyquist-auditor.md +252 -0
  908. package/plugins/pbr/agents/plan-checker.md +153 -43
  909. package/plugins/pbr/agents/planner.md +340 -28
  910. package/plugins/pbr/agents/researcher.md +210 -34
  911. package/plugins/pbr/agents/roadmapper.md +346 -0
  912. package/plugins/pbr/agents/synthesizer.md +193 -26
  913. package/plugins/pbr/agents/verifier.md +402 -23
  914. package/plugins/pbr/commands/add-phase.md +75 -0
  915. package/plugins/pbr/commands/add-todo.md +8 -0
  916. package/plugins/pbr/commands/audit-milestone.md +8 -0
  917. package/plugins/pbr/commands/audit.md +5 -0
  918. package/plugins/pbr/commands/check-todos.md +8 -0
  919. package/plugins/pbr/commands/complete-milestone.md +8 -0
  920. package/plugins/pbr/commands/config.md +2 -2
  921. package/plugins/pbr/commands/continue.md +1 -1
  922. package/plugins/pbr/commands/dashboard.md +5 -0
  923. package/plugins/pbr/commands/debug.md +1 -1
  924. package/plugins/pbr/commands/discuss-phase.md +6 -0
  925. package/plugins/pbr/commands/do.md +5 -0
  926. package/plugins/pbr/commands/execute-phase.md +6 -0
  927. package/plugins/pbr/commands/explore.md +1 -1
  928. package/plugins/pbr/commands/health.md +1 -1
  929. package/plugins/pbr/commands/help.md +1 -1
  930. package/plugins/pbr/commands/import.md +1 -1
  931. package/plugins/pbr/commands/insert-phase.md +65 -0
  932. package/plugins/pbr/commands/join-discord.md +11 -0
  933. package/plugins/pbr/commands/list-phase-assumptions.md +69 -0
  934. package/plugins/pbr/commands/map-codebase.md +6 -0
  935. package/plugins/pbr/commands/new-milestone.md +8 -0
  936. package/plugins/pbr/commands/new-project.md +6 -0
  937. package/plugins/pbr/commands/note.md +1 -1
  938. package/plugins/pbr/commands/pause-work.md +5 -0
  939. package/plugins/pbr/commands/plan-milestone-gaps.md +7 -0
  940. package/plugins/pbr/commands/plan-phase.md +6 -0
  941. package/plugins/pbr/commands/progress.md +6 -0
  942. package/plugins/pbr/commands/quick.md +1 -1
  943. package/plugins/pbr/commands/reapply-patches.md +40 -0
  944. package/plugins/pbr/commands/remove-phase.md +66 -0
  945. package/plugins/pbr/commands/research-phase.md +59 -0
  946. package/plugins/pbr/commands/resume-work.md +5 -0
  947. package/plugins/pbr/commands/set-profile.md +6 -0
  948. package/plugins/pbr/commands/settings.md +5 -0
  949. package/plugins/pbr/commands/setup.md +2 -2
  950. package/plugins/pbr/commands/statusline.md +5 -0
  951. package/plugins/pbr/commands/test.md +5 -0
  952. package/plugins/pbr/commands/undo.md +5 -0
  953. package/plugins/pbr/commands/update.md +37 -0
  954. package/plugins/pbr/commands/verify-work.md +6 -0
  955. package/plugins/pbr/dashboard/package-lock.json +6 -0
  956. package/plugins/pbr/hooks/hooks.json +97 -18
  957. package/plugins/pbr/references/agent-contracts.md +324 -0
  958. package/plugins/pbr/references/agent-teams.md +3 -3
  959. package/plugins/pbr/references/{checkpoints.md → archive/checkpoints.md} +32 -0
  960. package/plugins/pbr/references/archive/context-quality-tiers.md +45 -0
  961. package/plugins/{cursor-pbr/references → pbr/references/archive}/pbr-rules.md +4 -4
  962. package/plugins/pbr/references/archive/verification-patterns.md +277 -0
  963. package/plugins/pbr/references/config-reference.md +179 -9
  964. package/plugins/pbr/references/git-integration.md +80 -22
  965. package/plugins/pbr/references/model-profiles.md +62 -7
  966. package/plugins/pbr/references/model-selection.md +1 -1
  967. package/plugins/pbr/references/pbr-tools-cli.md +400 -0
  968. package/plugins/pbr/references/plan-authoring.md +65 -0
  969. package/plugins/pbr/references/plan-format.md +72 -8
  970. package/plugins/pbr/references/questioning.md +138 -49
  971. package/plugins/pbr/references/reading-verification.md +3 -3
  972. package/plugins/pbr/references/signal-files.md +41 -0
  973. package/plugins/pbr/references/tmux-setup.md +286 -0
  974. package/plugins/pbr/references/ui-formatting.md +67 -79
  975. package/plugins/pbr/scripts/auto-continue.js +113 -6
  976. package/plugins/pbr/scripts/block-skill-self-read.js +77 -0
  977. package/plugins/pbr/scripts/branding-audit.js +231 -0
  978. package/plugins/pbr/scripts/check-agent-state-write.js +63 -0
  979. package/plugins/pbr/scripts/check-config-change.js +188 -0
  980. package/plugins/pbr/scripts/check-cross-plugin-sync.js +93 -0
  981. package/plugins/pbr/scripts/check-dangerous-commands.js +49 -1
  982. package/plugins/pbr/scripts/check-phase-boundary.js +2 -8
  983. package/plugins/pbr/scripts/check-plan-format.js +414 -30
  984. package/plugins/pbr/scripts/check-roadmap-sync.js +178 -9
  985. package/plugins/pbr/scripts/check-skill-workflow.js +109 -18
  986. package/plugins/pbr/scripts/check-state-sync.js +156 -20
  987. package/plugins/pbr/scripts/check-subagent-output.js +581 -14
  988. package/plugins/pbr/scripts/check-summary-gate.js +1 -1
  989. package/plugins/pbr/scripts/config-schema.json +157 -2
  990. package/plugins/pbr/scripts/context-bridge.js +342 -0
  991. package/plugins/pbr/scripts/context-budget-check.js +89 -9
  992. package/plugins/pbr/scripts/enforce-pbr-workflow.js +277 -0
  993. package/plugins/pbr/scripts/event-handler.js +72 -6
  994. package/plugins/pbr/scripts/hook-server-client.js +258 -0
  995. package/plugins/pbr/scripts/hook-server.js +334 -0
  996. package/plugins/pbr/scripts/hooks-schema.json +5 -1
  997. package/plugins/pbr/scripts/instructions-loaded.js +107 -0
  998. package/plugins/pbr/scripts/intercept-plan-mode.js +47 -0
  999. package/plugins/pbr/scripts/lib/alternatives.js +203 -0
  1000. package/plugins/pbr/scripts/lib/build.js +719 -0
  1001. package/plugins/pbr/scripts/lib/circuit-state.js +133 -0
  1002. package/plugins/pbr/scripts/lib/config.js +288 -0
  1003. package/plugins/pbr/scripts/lib/context.js +246 -0
  1004. package/plugins/pbr/scripts/lib/core.js +934 -0
  1005. package/plugins/pbr/scripts/lib/gates/advisories.js +129 -0
  1006. package/plugins/pbr/scripts/lib/gates/build-dependency.js +100 -0
  1007. package/plugins/pbr/scripts/lib/gates/build-executor.js +79 -0
  1008. package/plugins/pbr/scripts/lib/gates/doc-existence.js +46 -0
  1009. package/plugins/pbr/scripts/lib/gates/helpers.js +74 -0
  1010. package/plugins/pbr/scripts/lib/gates/milestone-complete.js +120 -0
  1011. package/plugins/pbr/scripts/lib/gates/plan-executor.js +36 -0
  1012. package/plugins/pbr/scripts/lib/gates/quick-executor.js +76 -0
  1013. package/plugins/pbr/scripts/lib/gates/review-planner.js +61 -0
  1014. package/plugins/pbr/scripts/lib/gates/review-verifier.js +69 -0
  1015. package/plugins/pbr/scripts/lib/history.js +150 -0
  1016. package/plugins/pbr/scripts/lib/init.js +302 -0
  1017. package/plugins/pbr/scripts/lib/learnings.js +312 -0
  1018. package/plugins/pbr/scripts/lib/migrate.js +169 -0
  1019. package/plugins/pbr/scripts/lib/phase.js +935 -0
  1020. package/plugins/pbr/scripts/lib/preview.js +174 -0
  1021. package/plugins/pbr/scripts/lib/reference.js +236 -0
  1022. package/plugins/pbr/scripts/lib/roadmap.js +784 -0
  1023. package/plugins/pbr/scripts/lib/skill-section.js +99 -0
  1024. package/plugins/pbr/scripts/lib/spot-check.js +118 -0
  1025. package/plugins/pbr/scripts/lib/state.js +534 -0
  1026. package/plugins/pbr/scripts/lib/step-verify.js +149 -0
  1027. package/plugins/pbr/scripts/lib/todo.js +300 -0
  1028. package/plugins/pbr/scripts/local-llm/client.js +237 -0
  1029. package/plugins/pbr/scripts/local-llm/health.js +220 -0
  1030. package/plugins/pbr/scripts/local-llm/metrics.js +340 -0
  1031. package/plugins/pbr/scripts/local-llm/operations/classify-artifact.js +76 -0
  1032. package/plugins/pbr/scripts/local-llm/operations/classify-commit.js +137 -0
  1033. package/plugins/pbr/scripts/local-llm/operations/classify-error.js +75 -0
  1034. package/plugins/pbr/scripts/local-llm/operations/classify-file-intent.js +171 -0
  1035. package/plugins/pbr/scripts/local-llm/operations/score-source.js +72 -0
  1036. package/plugins/pbr/scripts/local-llm/operations/summarize-context.js +62 -0
  1037. package/plugins/pbr/scripts/local-llm/operations/triage-test-output.js +72 -0
  1038. package/plugins/pbr/scripts/local-llm/operations/validate-task.js +59 -0
  1039. package/plugins/pbr/scripts/local-llm/router.js +101 -0
  1040. package/plugins/pbr/scripts/local-llm/shadow.js +60 -0
  1041. package/plugins/pbr/scripts/local-llm/threshold-tuner.js +118 -0
  1042. package/plugins/pbr/scripts/log-subagent.js +90 -13
  1043. package/plugins/pbr/scripts/log-tool-failure.js +39 -5
  1044. package/plugins/pbr/scripts/milestone-learnings.js +290 -0
  1045. package/plugins/pbr/scripts/package.json +1 -0
  1046. package/plugins/pbr/scripts/pbr-tools.js +1143 -1232
  1047. package/plugins/pbr/scripts/post-bash-triage.js +151 -0
  1048. package/plugins/pbr/scripts/post-write-dispatch.js +181 -25
  1049. package/plugins/pbr/scripts/post-write-quality.js +3 -3
  1050. package/plugins/pbr/scripts/pre-bash-dispatch.js +56 -2
  1051. package/plugins/pbr/scripts/pre-write-dispatch.js +69 -19
  1052. package/plugins/pbr/scripts/progress-tracker.js +428 -19
  1053. package/plugins/pbr/scripts/run-hook.js +49 -8
  1054. package/plugins/pbr/scripts/session-cleanup.js +99 -5
  1055. package/plugins/pbr/scripts/session-tracker.js +78 -0
  1056. package/plugins/pbr/scripts/status-line.js +179 -27
  1057. package/plugins/pbr/scripts/suggest-compact.js +108 -7
  1058. package/plugins/pbr/scripts/sync-context-to-claude.js +100 -0
  1059. package/plugins/pbr/scripts/task-completed.js +123 -1
  1060. package/plugins/pbr/scripts/test/config.test.js +126 -0
  1061. package/plugins/pbr/scripts/test/cross-platform.test.js +131 -0
  1062. package/plugins/pbr/scripts/test/fixtures/config.json +20 -0
  1063. package/plugins/pbr/scripts/test/fixtures/plan.md +54 -0
  1064. package/plugins/pbr/scripts/test/fixtures/project.md +30 -0
  1065. package/plugins/pbr/scripts/test/fixtures/roadmap.md +55 -0
  1066. package/plugins/pbr/scripts/test/fixtures/state.md +60 -0
  1067. package/plugins/pbr/scripts/test/fixtures/summary.md +35 -0
  1068. package/plugins/pbr/scripts/test/fixtures.test.js +184 -0
  1069. package/plugins/pbr/scripts/test/phase.test.js +142 -0
  1070. package/plugins/pbr/scripts/test/roadmap.test.js +96 -0
  1071. package/plugins/pbr/scripts/test/state.test.js +163 -0
  1072. package/plugins/pbr/scripts/track-context-budget.js +237 -89
  1073. package/plugins/pbr/scripts/validate-commit.js +76 -11
  1074. package/plugins/pbr/scripts/validate-skill-args.js +151 -0
  1075. package/plugins/pbr/scripts/validate-task.js +167 -17
  1076. package/plugins/pbr/scripts/worktree-create.js +144 -0
  1077. package/plugins/pbr/scripts/worktree-remove.js +147 -0
  1078. package/plugins/pbr/skills/audit/SKILL.md +348 -0
  1079. package/plugins/pbr/skills/begin/SKILL.md +412 -118
  1080. package/plugins/pbr/skills/begin/templates/STATE.md.tmpl +1 -2
  1081. package/plugins/pbr/skills/begin/templates/config.json.tmpl +8 -2
  1082. package/plugins/pbr/skills/begin/templates/researcher-prompt.md.tmpl +28 -0
  1083. package/plugins/pbr/skills/begin/templates/roadmap-prompt.md.tmpl +19 -0
  1084. package/plugins/pbr/skills/begin/templates/synthesis-prompt.md.tmpl +33 -5
  1085. package/plugins/pbr/skills/build/SKILL.md +503 -307
  1086. package/plugins/pbr/skills/build/templates/continuation-prompt.md.tmpl +26 -0
  1087. package/plugins/pbr/skills/build/templates/executor-prompt.md.tmpl +70 -0
  1088. package/plugins/pbr/skills/build/templates/inline-verifier-prompt.md.tmpl +33 -0
  1089. package/plugins/pbr/skills/config/SKILL.md +104 -18
  1090. package/plugins/pbr/skills/continue/SKILL.md +92 -22
  1091. package/plugins/pbr/skills/dashboard/SKILL.md +58 -0
  1092. package/plugins/pbr/skills/debug/SKILL.md +57 -33
  1093. package/plugins/pbr/skills/debug/templates/continuation-prompt.md.tmpl +12 -1
  1094. package/plugins/pbr/skills/debug/templates/initial-investigation-prompt.md.tmpl +12 -5
  1095. package/plugins/pbr/skills/discuss/SKILL.md +123 -30
  1096. package/plugins/pbr/skills/discuss/templates/CONTEXT.md.tmpl +1 -1
  1097. package/plugins/pbr/skills/do/SKILL.md +70 -0
  1098. package/plugins/pbr/skills/explore/SKILL.md +92 -24
  1099. package/plugins/pbr/skills/health/SKILL.md +143 -32
  1100. package/plugins/pbr/skills/help/SKILL.md +122 -45
  1101. package/plugins/pbr/skills/import/SKILL.md +341 -29
  1102. package/plugins/pbr/skills/milestone/SKILL.md +187 -252
  1103. package/plugins/pbr/skills/milestone/templates/audit-output.md.tmpl +76 -0
  1104. package/plugins/pbr/skills/milestone/templates/complete-output.md.tmpl +32 -0
  1105. package/plugins/pbr/skills/milestone/templates/edge-cases.md +54 -0
  1106. package/plugins/pbr/skills/milestone/templates/gaps-output.md.tmpl +25 -0
  1107. package/plugins/pbr/skills/milestone/templates/integration-checker-prompt.md.tmpl +25 -0
  1108. package/plugins/pbr/skills/milestone/templates/new-output.md.tmpl +29 -0
  1109. package/plugins/pbr/skills/note/SKILL.md +45 -55
  1110. package/plugins/pbr/skills/pause/SKILL.md +26 -16
  1111. package/plugins/pbr/skills/plan/SKILL.md +264 -258
  1112. package/plugins/pbr/skills/plan/templates/completion-output.md.tmpl +27 -0
  1113. package/plugins/pbr/skills/plan/templates/planner-prompt.md.tmpl +1 -1
  1114. package/plugins/pbr/skills/profile/SKILL.md +173 -0
  1115. package/plugins/pbr/skills/quick/SKILL.md +104 -20
  1116. package/plugins/pbr/skills/resume/SKILL.md +29 -27
  1117. package/plugins/pbr/skills/review/SKILL.md +172 -136
  1118. package/plugins/pbr/skills/scan/SKILL.md +41 -19
  1119. package/plugins/pbr/skills/scan/templates/mapper-prompt.md.tmpl +1 -1
  1120. package/plugins/pbr/skills/setup/SKILL.md +160 -177
  1121. package/plugins/pbr/skills/shared/commit-planning-docs.md +8 -0
  1122. package/plugins/pbr/skills/shared/context-budget.md +67 -2
  1123. package/plugins/pbr/skills/shared/context-loader-task.md +9 -2
  1124. package/plugins/pbr/skills/shared/digest-select.md +2 -2
  1125. package/plugins/pbr/skills/shared/domain-probes.md +1 -1
  1126. package/plugins/pbr/skills/shared/error-reporting.md +38 -58
  1127. package/plugins/pbr/skills/shared/gate-prompts.md +4 -2
  1128. package/plugins/pbr/skills/shared/phase-argument-parsing.md +6 -6
  1129. package/plugins/pbr/skills/shared/state-update.md +36 -44
  1130. package/plugins/pbr/skills/shared/universal-anti-patterns.md +36 -10
  1131. package/plugins/pbr/skills/status/SKILL.md +161 -43
  1132. package/plugins/pbr/skills/statusline/SKILL.md +151 -0
  1133. package/plugins/pbr/skills/test/SKILL.md +212 -0
  1134. package/plugins/pbr/skills/todo/SKILL.md +117 -32
  1135. package/plugins/pbr/skills/undo/SKILL.md +216 -0
  1136. package/plugins/pbr/templates/CONTEXT.md.tmpl +1 -1
  1137. package/plugins/pbr/templates/INTEGRATION-REPORT.md.tmpl +18 -2
  1138. package/plugins/pbr/templates/PROJECT.md.tmpl +111 -0
  1139. package/plugins/pbr/templates/REQUIREMENTS.md.tmpl +96 -0
  1140. package/plugins/pbr/templates/ROADMAP.md.tmpl +80 -15
  1141. package/plugins/pbr/templates/SUMMARY-complex.md.tmpl +112 -0
  1142. package/plugins/pbr/templates/SUMMARY-minimal.md.tmpl +48 -0
  1143. package/plugins/pbr/templates/VERIFICATION-DETAIL.md.tmpl +13 -10
  1144. package/plugins/pbr/templates/pr-body.md.tmpl +22 -0
  1145. package/plugins/pbr/templates/project-CONTEXT.md.tmpl +43 -0
  1146. package/plugins/pbr/templates/research-outputs/ARCHITECTURE.md.tmpl +91 -0
  1147. package/plugins/pbr/templates/research-outputs/FEATURES.md.tmpl +64 -0
  1148. package/plugins/pbr/templates/research-outputs/PITFALLS.md.tmpl +50 -0
  1149. package/plugins/pbr/templates/research-outputs/STACK.md.tmpl +63 -0
  1150. package/plugins/pbr/templates/research-outputs/SUMMARY.md.tmpl +98 -0
  1151. package/scripts/build-hooks.js +61 -0
  1152. package/scripts/generate-derivatives.js +581 -0
  1153. package/scripts/run-tests.cjs +29 -0
  1154. package/dashboard/bin/cli.js +0 -25
  1155. package/dashboard/public/css/layout.css +0 -406
  1156. package/dashboard/public/css/status-colors.css +0 -98
  1157. package/dashboard/public/js/htmx-title.js +0 -5
  1158. package/dashboard/public/js/sidebar-toggle.js +0 -20
  1159. package/dashboard/src/app.js +0 -78
  1160. package/dashboard/src/middleware/errorHandler.js +0 -52
  1161. package/dashboard/src/middleware/notFoundHandler.js +0 -9
  1162. package/dashboard/src/repositories/planning.repository.js +0 -128
  1163. package/dashboard/src/routes/events.routes.js +0 -40
  1164. package/dashboard/src/routes/index.routes.js +0 -31
  1165. package/dashboard/src/routes/pages.routes.js +0 -252
  1166. package/dashboard/src/server.js +0 -42
  1167. package/dashboard/src/services/dashboard.service.js +0 -286
  1168. package/dashboard/src/services/phase.service.js +0 -226
  1169. package/dashboard/src/services/project.service.js +0 -57
  1170. package/dashboard/src/services/roadmap.service.js +0 -171
  1171. package/dashboard/src/services/sse.service.js +0 -58
  1172. package/dashboard/src/services/todo.service.js +0 -254
  1173. package/dashboard/src/services/watcher.service.js +0 -48
  1174. package/dashboard/src/views/coming-soon.ejs +0 -11
  1175. package/dashboard/src/views/error.ejs +0 -13
  1176. package/dashboard/src/views/index.ejs +0 -5
  1177. package/dashboard/src/views/layout.ejs +0 -1
  1178. package/dashboard/src/views/partials/dashboard-content.ejs +0 -77
  1179. package/dashboard/src/views/partials/footer.ejs +0 -3
  1180. package/dashboard/src/views/partials/head.ejs +0 -21
  1181. package/dashboard/src/views/partials/header.ejs +0 -12
  1182. package/dashboard/src/views/partials/layout-bottom.ejs +0 -15
  1183. package/dashboard/src/views/partials/layout-top.ejs +0 -8
  1184. package/dashboard/src/views/partials/phase-content.ejs +0 -189
  1185. package/dashboard/src/views/partials/phase-doc-content.ejs +0 -38
  1186. package/dashboard/src/views/partials/phases-content.ejs +0 -117
  1187. package/dashboard/src/views/partials/roadmap-content.ejs +0 -142
  1188. package/dashboard/src/views/partials/sidebar.ejs +0 -38
  1189. package/dashboard/src/views/partials/todo-create-content.ejs +0 -53
  1190. package/dashboard/src/views/partials/todo-detail-content.ejs +0 -38
  1191. package/dashboard/src/views/partials/todos-content.ejs +0 -53
  1192. package/dashboard/src/views/phase-detail.ejs +0 -5
  1193. package/dashboard/src/views/phase-doc.ejs +0 -5
  1194. package/dashboard/src/views/phases.ejs +0 -5
  1195. package/dashboard/src/views/roadmap.ejs +0 -5
  1196. package/dashboard/src/views/todo-create.ejs +0 -5
  1197. package/dashboard/src/views/todo-detail.ejs +0 -5
  1198. package/dashboard/src/views/todos.ejs +0 -5
  1199. package/plugins/cursor-pbr/references/agent-anti-patterns.md +0 -25
  1200. package/plugins/cursor-pbr/references/agent-interactions.md +0 -135
  1201. package/plugins/cursor-pbr/references/checkpoints.md +0 -158
  1202. package/plugins/cursor-pbr/references/planning-config.md +0 -214
  1203. package/plugins/cursor-pbr/references/subagent-coordination.md +0 -120
  1204. package/plugins/cursor-pbr/references/verification-patterns.md +0 -199
  1205. package/plugins/cursor-pbr/skills/begin/templates/researcher-prompt.md.tmpl +0 -20
  1206. package/plugins/cursor-pbr/skills/begin/templates/roadmap-prompt.md.tmpl +0 -31
  1207. package/plugins/cursor-pbr/skills/begin/templates/synthesis-prompt.md.tmpl +0 -17
  1208. package/plugins/cursor-pbr/skills/debug/templates/continuation-prompt.md.tmpl +0 -17
  1209. package/plugins/cursor-pbr/skills/debug/templates/initial-investigation-prompt.md.tmpl +0 -28
  1210. package/plugins/cursor-pbr/skills/shared/progress-display.md +0 -54
  1211. package/plugins/cursor-pbr/skills/shared/state-loading.md +0 -63
  1212. package/plugins/cursor-pbr/templates/RESEARCH-SUMMARY.md.tmpl +0 -98
  1213. package/plugins/pbr/commands/begin.md +0 -5
  1214. package/plugins/pbr/commands/build.md +0 -5
  1215. package/plugins/pbr/commands/discuss.md +0 -5
  1216. package/plugins/pbr/commands/milestone.md +0 -5
  1217. package/plugins/pbr/commands/pause.md +0 -5
  1218. package/plugins/pbr/commands/plan.md +0 -5
  1219. package/plugins/pbr/commands/resume.md +0 -5
  1220. package/plugins/pbr/commands/review.md +0 -5
  1221. package/plugins/pbr/commands/scan.md +0 -5
  1222. package/plugins/pbr/commands/status.md +0 -5
  1223. package/plugins/pbr/commands/todo.md +0 -5
  1224. package/plugins/pbr/references/agent-interactions.md +0 -134
  1225. package/plugins/pbr/references/pbr-rules.md +0 -193
  1226. package/plugins/pbr/references/planning-config.md +0 -213
  1227. package/plugins/pbr/references/subagent-coordination.md +0 -119
  1228. package/plugins/pbr/references/verification-patterns.md +0 -198
  1229. package/plugins/pbr/skills/shared/progress-display.md +0 -53
  1230. package/plugins/pbr/skills/shared/state-loading.md +0 -62
  1231. package/plugins/pbr/templates/RESEARCH-SUMMARY.md.tmpl +0 -97
  1232. package/plugins/pbr/templates/research/ARCHITECTURE.md.tmpl +0 -124
  1233. package/plugins/pbr/templates/research/STACK.md.tmpl +0 -71
  1234. package/plugins/pbr/templates/research/SUMMARY.md.tmpl +0 -112
  1235. package/plugins/pbr/templates/research-outputs/phase-research.md.tmpl +0 -81
  1236. package/plugins/pbr/templates/research-outputs/project-research.md.tmpl +0 -99
  1237. package/plugins/pbr/templates/research-outputs/synthesis.md.tmpl +0 -36
  1238. /package/plugins/pbr/references/{agent-anti-patterns.md → archive/agent-anti-patterns.md} +0 -0
@@ -0,0 +1,98 @@
1
+ <!-- Source: agents/codebase-mapper.md | Purpose: Output format for ARCHITECTURE.md codebase analysis -->
2
+ # Architecture
3
+
4
+ > Analyzed: {date}
5
+ > Pattern: {MVC / Layered / Hexagonal / Microservices / Monolith / etc.}
6
+
7
+ ## Pattern Overview
8
+
9
+ {2-3 paragraphs describing the overall architectural pattern with evidence from the codebase}
10
+
11
+ **Evidence**: {file paths, import patterns, directory structure that support this classification}
12
+
13
+ ## Layers
14
+
15
+ | Layer | Purpose | Directory | Key Files |
16
+ |-------|---------|-----------|-----------|
17
+ | {Presentation} | {UI rendering} | {src/components/} | {App.tsx, Layout.tsx} |
18
+ | {API/Routes} | {HTTP handling} | {src/routes/ or src/app/api/} | {users.ts, auth.ts} |
19
+ | {Business Logic} | {Core domain} | {src/services/} | {UserService.ts} |
20
+ | {Data Access} | {Database interaction} | {src/repositories/ or src/db/} | {UserRepo.ts} |
21
+ | {Infrastructure} | {External services} | {src/lib/ or src/integrations/} | {email.ts, storage.ts} |
22
+
23
+ ### Layer Rules
24
+
25
+ {How layers communicate — what imports what? What are the dependency rules?}
26
+
27
+ ```
28
+ Presentation → API → Business → Data Access → Database
29
+
30
+ Infrastructure
31
+ ```
32
+
33
+ ## Data Flow
34
+
35
+ ### Request Lifecycle
36
+
37
+ {How a typical request flows through the system}
38
+
39
+ ```
40
+ 1. Client sends request
41
+ 2. → {Router/Framework} routes to handler
42
+ 3. → {Middleware} runs (auth, validation, logging)
43
+ 4. → {Controller/Handler} processes request
44
+ 5. → {Service} executes business logic
45
+ 6. → {Repository/Model} queries database
46
+ 7. → Response returns through the stack
47
+ ```
48
+
49
+ ### State Management
50
+
51
+ | Context | Approach | Implementation | Files |
52
+ |---------|----------|---------------|-------|
53
+ | Client state | {Redux / Zustand / Context / etc.} | {how it's structured} | {store files} |
54
+ | Server state | {React Query / SWR / etc.} | {how it's used} | {hook files} |
55
+ | Session state | {JWT / cookies / etc.} | {how it's managed} | {auth files} |
56
+
57
+ ## Key Abstractions
58
+
59
+ | Abstraction | Purpose | Implementation | Used By |
60
+ |-------------|---------|---------------|---------|
61
+ | {Repository} | {Database access} | {Abstract class + implementations} | {Services} |
62
+ | {Middleware} | {Cross-cutting concerns} | {Function signature} | {Routes} |
63
+ | {DTO/Schema} | {Data validation} | {Zod schemas / class-validator} | {Routes, Services} |
64
+
65
+ ## Entry Points
66
+
67
+ | Type | File | Config | Notes |
68
+ |------|------|--------|-------|
69
+ | Web app | {src/app/page.tsx} | {port 3000} | {Next.js App Router} |
70
+ | API server | {src/server.ts} | {port 8080} | {Express server} |
71
+ | CLI | {src/cli.ts} | - | {Commander.js} |
72
+ | Workers | {src/workers/} | {queue config} | {Bull/BullMQ} |
73
+ | Cron | {src/cron/} | {schedule} | {node-cron} |
74
+
75
+ ## Error Handling Strategy
76
+
77
+ | Layer | Pattern | Implementation |
78
+ |-------|---------|---------------|
79
+ | API | {Error middleware + HTTP status codes} | {src/middleware/error.ts} |
80
+ | Service | {Custom error classes} | {src/errors/} |
81
+ | Client | {Error boundaries + toast notifications} | {src/components/ErrorBoundary.tsx} |
82
+
83
+ ### Error Flow
84
+
85
+ ```
86
+ Service throws AppError → Controller catches → Error middleware formats response → Client displays
87
+ ```
88
+
89
+ ## Security Architecture
90
+
91
+ | Aspect | Implementation | Files |
92
+ |--------|---------------|-------|
93
+ | Authentication | {how auth works} | {files} |
94
+ | Authorization | {RBAC / ABAC / etc.} | {files} |
95
+ | Input validation | {where and how} | {files} |
96
+ | CORS | {configuration} | {files} |
97
+ | Rate limiting | {if present} | {files} |
98
+ | CSRF protection | {if present} | {files} |
@@ -0,0 +1,93 @@
1
+ <!-- Source: agents/codebase-mapper.md | Purpose: Output format for CONCERNS.md codebase analysis -->
2
+ # Concerns & Technical Debt
3
+
4
+ > Analyzed: {date}
5
+ > Severity summary: {n critical, n high, n medium, n low}
6
+
7
+ ## Technical Debt
8
+
9
+ | # | Area | Issue | Severity | Files | Evidence |
10
+ |---|------|-------|----------|-------|----------|
11
+ | 1 | {area} | {what's wrong} | critical/high/medium/low | {file paths} | {what you saw} |
12
+ | 2 | {area} | {what's wrong} | {severity} | {file paths} | {what you saw} |
13
+
14
+ ### Debt Details
15
+
16
+ #### TD-1: {Issue Title}
17
+
18
+ **Severity**: {critical / high / medium / low}
19
+ **Files**: {list of affected files}
20
+ **Description**: {detailed description of the issue}
21
+ **Evidence**: {specific code examples, line numbers}
22
+ **Impact**: {what problems this causes or could cause}
23
+ **Recommendation**: {specific action to fix}
24
+
25
+ ## Known Bugs
26
+
27
+ | # | Description | Severity | Location | Reproduction |
28
+ |---|-------------|----------|----------|--------------|
29
+ | 1 | {bug description} | {severity} | {file:line} | {how to trigger} |
30
+
31
+ ## Security Considerations
32
+
33
+ | # | Issue | Severity | Location | Recommendation |
34
+ |---|-------|----------|----------|----------------|
35
+ | 1 | {Missing input validation on API} | high | {src/routes/users.ts} | {Add zod schema validation} |
36
+ | 2 | {Hardcoded secret in source} | critical | {src/config.ts:42} | {Move to environment variable} |
37
+ | 3 | {SQL injection risk} | critical | {src/db/queries.ts:15} | {Use parameterized queries} |
38
+ | 4 | {No rate limiting} | medium | {src/server.ts} | {Add express-rate-limit} |
39
+ | 5 | {No CSRF protection} | medium | {src/routes/} | {Add csrf tokens} |
40
+
41
+ ## Performance Risks
42
+
43
+ | # | Issue | Location | Impact | Recommendation |
44
+ |---|-------|----------|--------|----------------|
45
+ | 1 | {N+1 query in user list} | {src/routes/users.ts:30} | {Slow page load} | {Use eager loading} |
46
+ | 2 | {No pagination on large queries} | {src/routes/posts.ts:15} | {Memory exhaustion} | {Add cursor pagination} |
47
+ | 3 | {Synchronous file operations} | {src/utils/file.ts} | {Blocks event loop} | {Use async fs methods} |
48
+
49
+ ## Fragile Areas
50
+
51
+ | # | Area | Why Fragile | Impact of Breaking | Files |
52
+ |---|------|-------------|-------------------|-------|
53
+ | 1 | {Auth middleware} | {Tightly coupled to 5 services} | {All protected routes fail} | {files} |
54
+ | 2 | {Data migration} | {No rollback mechanism} | {Data loss on failure} | {files} |
55
+
56
+ ## Dependency Risks
57
+
58
+ | Package | Version | Issue | Recommendation |
59
+ |---------|---------|-------|----------------|
60
+ | {package} | {version} | {Deprecated / EOL / Known vulnerability} | {Update to X / Replace with Y} |
61
+
62
+ ## Scaling Limitations
63
+
64
+ | # | Limitation | When It Breaks | Current State | Fix Approach |
65
+ |---|-----------|---------------|---------------|-------------|
66
+ | 1 | {Single database instance} | {>1000 concurrent users} | {adequate for current load} | {Read replicas} |
67
+ | 2 | {In-memory session store} | {Multiple server instances} | {single instance} | {Redis session store} |
68
+
69
+ ## Missing Infrastructure
70
+
71
+ | Category | Status | Impact | Priority |
72
+ |----------|--------|--------|----------|
73
+ | Error monitoring | {absent/partial/present} | {bugs go unnoticed} | {high} |
74
+ | Logging | {absent/partial/present} | {hard to debug production} | {high} |
75
+ | CI/CD | {absent/partial/present} | {manual deployments} | {medium} |
76
+ | Automated tests | {absent/partial/present} | {regressions not caught} | {high} |
77
+ | Documentation | {absent/partial/present} | {onboarding difficulty} | {low} |
78
+ | Backup/Recovery | {absent/partial/present} | {data loss risk} | {critical} |
79
+ | Health checks | {absent/partial/present} | {outages not detected} | {medium} |
80
+
81
+ ## Recommendations (Prioritized)
82
+
83
+ ### Critical (Fix Immediately)
84
+ 1. {Recommendation with specific action}
85
+
86
+ ### High (Fix Soon)
87
+ 1. {Recommendation with specific action}
88
+
89
+ ### Medium (Plan to Fix)
90
+ 1. {Recommendation with specific action}
91
+
92
+ ### Low (When Convenient)
93
+ 1. {Recommendation with specific action}
@@ -0,0 +1,104 @@
1
+ <!-- Source: agents/codebase-mapper.md | Purpose: Output format for CONVENTIONS.md codebase analysis -->
2
+ # Code Conventions
3
+
4
+ > Analyzed: {date}
5
+ > Based on: {n} files inspected
6
+
7
+ ## Naming Conventions
8
+
9
+ | Entity | Convention | Example |
10
+ |--------|-----------|---------|
11
+ | Files (components) | {PascalCase.tsx} | `UserProfile.tsx` |
12
+ | Files (utilities) | {camelCase.ts} | `formatDate.ts` |
13
+ | Functions | {camelCase} | `getUserById` |
14
+ | Classes | {PascalCase} | `UserService` |
15
+ | Interfaces | {PascalCase, no I prefix} | `UserProfile` |
16
+ | Types | {PascalCase} | `CreateUserInput` |
17
+ | Constants | {SCREAMING_SNAKE_CASE or camelCase} | `MAX_RETRIES` or `maxRetries` |
18
+ | Enum members | {PascalCase} | `UserRole.Admin` |
19
+ | Environment variables | {SCREAMING_SNAKE_CASE} | `DATABASE_URL` |
20
+ | CSS classes | {kebab-case or camelCase modules} | `user-profile` |
21
+ | Database tables | {snake_case} | `user_profiles` |
22
+ | API endpoints | {kebab-case} | `/api/user-profiles` |
23
+
24
+ ## Code Style
25
+
26
+ | Aspect | Setting | Config File |
27
+ |--------|---------|-------------|
28
+ | Indentation | {2 spaces / 4 spaces / tabs} | {.editorconfig / .prettierrc} |
29
+ | Quotes | {single / double} | {.prettierrc} |
30
+ | Semicolons | {yes / no} | {.prettierrc} |
31
+ | Trailing commas | {all / es5 / none} | {.prettierrc} |
32
+ | Line width | {80 / 100 / 120} | {.prettierrc} |
33
+ | Line endings | {LF / CRLF} | {.editorconfig} |
34
+
35
+ ## Import Organization
36
+
37
+ {Observed import order pattern from the codebase}
38
+
39
+ ```{language}
40
+ // 1. Node.js built-in modules
41
+ import path from 'path';
42
+
43
+ // 2. External packages
44
+ import React from 'react';
45
+ import { z } from 'zod';
46
+
47
+ // 3. Internal aliases
48
+ import { Button } from '@/components/ui';
49
+ import { useAuth } from '@/hooks/useAuth';
50
+
51
+ // 4. Relative imports
52
+ import { UserCard } from './UserCard';
53
+ import type { User } from './types';
54
+
55
+ // 5. Style imports
56
+ import styles from './UserProfile.module.css';
57
+ ```
58
+
59
+ ## Function Patterns
60
+
61
+ ### Async Functions
62
+
63
+ ```{language}
64
+ // Pattern used in this codebase: {evidence file:line}
65
+ {actual code pattern from codebase}
66
+ ```
67
+
68
+ ### Error Handling
69
+
70
+ ```{language}
71
+ // Pattern used in this codebase: {evidence file:line}
72
+ {actual code pattern from codebase}
73
+ ```
74
+
75
+ ### API Route Handlers
76
+
77
+ ```{language}
78
+ // Pattern used in this codebase: {evidence file:line}
79
+ {actual code pattern from codebase}
80
+ ```
81
+
82
+ ### React Components
83
+
84
+ ```{language}
85
+ // Pattern used in this codebase: {evidence file:line}
86
+ {actual code pattern from codebase}
87
+ ```
88
+
89
+ ## Comment Conventions
90
+
91
+ | When | Style | Example |
92
+ |------|-------|---------|
93
+ | {Complex logic} | {inline comment} | `// Calculate tax with progressive rates` |
94
+ | {Public API} | {JSDoc} | `/** @param user - The user to validate */` |
95
+ | {Temporary} | {TODO with ticket} | `// TODO(#123): refactor after migration` |
96
+ | {Warning} | {IMPORTANT prefix} | `// IMPORTANT: this must run before auth` |
97
+
98
+ ## Git Conventions
99
+
100
+ | Aspect | Convention | Example |
101
+ |--------|-----------|---------|
102
+ | Branch naming | {pattern} | `feature/add-user-auth` |
103
+ | Commit format | {conventional commits / custom} | `feat(auth): add login flow` |
104
+ | PR titles | {pattern} | `[Feature] Add user authentication` |
@@ -0,0 +1,78 @@
1
+ <!-- Source: agents/codebase-mapper.md | Purpose: Output format for INTEGRATIONS.md codebase analysis -->
2
+ # External Integrations
3
+
4
+ > Analyzed: {date}
5
+ > Total integrations: {n}
6
+
7
+ ## APIs
8
+
9
+ | Service | Type | Auth Method | Config Var | Used In | Documentation |
10
+ |---------|------|-------------|------------|---------|---------------|
11
+ | {Discord API} | REST | {OAuth2} | DISCORD_TOKEN | {src/integrations/discord.ts} | {URL} |
12
+ | {Stripe} | REST | {API Key} | STRIPE_SECRET_KEY | {src/payments/} | {URL} |
13
+
14
+ ### API Client Patterns
15
+
16
+ {How API calls are made in this codebase — fetch wrapper? axios instance? SDK?}
17
+
18
+ ```{language}
19
+ // Example from codebase: {file:line}
20
+ {actual code pattern}
21
+ ```
22
+
23
+ ## Databases
24
+
25
+ | Database | Type | ORM/Driver | Config | Schema Location | Migrations |
26
+ |----------|------|-----------|--------|-----------------|------------|
27
+ | {PostgreSQL} | {Relational} | {Prisma} | DATABASE_URL | {prisma/schema.prisma} | {prisma/migrations/} |
28
+ | {Redis} | {Key-value} | {ioredis} | REDIS_URL | - | - |
29
+
30
+ ### Database Patterns
31
+
32
+ {How database access is structured — repository pattern? direct queries? ORM models?}
33
+
34
+ ## Authentication & Authorization
35
+
36
+ | Aspect | Implementation | Config | Files |
37
+ |--------|---------------|--------|-------|
38
+ | Method | {JWT / Session / OAuth} | {env vars} | {files} |
39
+ | Provider | {self / Auth0 / Clerk / etc.} | {env vars} | {files} |
40
+ | Storage | {cookie / localStorage / header} | - | {files} |
41
+ | Roles | {admin, user, etc.} | {where defined} | {files} |
42
+
43
+ ## Email/Notifications
44
+
45
+ | Service | Purpose | Config | Used In |
46
+ |---------|---------|--------|---------|
47
+ | {SendGrid} | {Transactional email} | SENDGRID_KEY | {src/email/} |
48
+
49
+ ## File Storage
50
+
51
+ | Service | Purpose | Config | Used In |
52
+ |---------|---------|--------|---------|
53
+ | {S3} | {User uploads} | AWS_* vars | {src/storage/} |
54
+
55
+ ## Monitoring & Logging
56
+
57
+ | Tool | Purpose | Config | Used In |
58
+ |------|---------|--------|---------|
59
+ | {Sentry} | {Error tracking} | SENTRY_DSN | {src/lib/sentry.ts} |
60
+ | {Winston} | {Logging} | - | {src/lib/logger.ts} |
61
+
62
+ ## CI/CD
63
+
64
+ | Platform | Config | Stages | Deployment |
65
+ |----------|--------|--------|------------|
66
+ | {GitHub Actions} | {.github/workflows/} | {lint, test, build, deploy} | {Vercel / AWS / etc.} |
67
+
68
+ ### Pipeline Details
69
+
70
+ {Description of the CI/CD pipeline flow}
71
+
72
+ ## Infrastructure
73
+
74
+ | Component | Provider | Config | Notes |
75
+ |-----------|----------|--------|-------|
76
+ | {Hosting} | {Vercel} | {vercel.json} | {auto-deploy from main} |
77
+ | {DNS} | {Cloudflare} | - | {if relevant} |
78
+ | {CDN} | {included with host} | - | - |
@@ -0,0 +1,78 @@
1
+ <!-- Source: agents/codebase-mapper.md | Purpose: Output format for STACK.md codebase analysis -->
2
+ # Technology Stack
3
+
4
+ > Analyzed: {date}
5
+ > Project: {project name from package.json or directory}
6
+
7
+ ## Languages & Runtime
8
+
9
+ | Language | Version | Config | Notes |
10
+ |----------|---------|--------|-------|
11
+ | TypeScript | {version from tsconfig target or dep} | `tsconfig.json` | {strict mode? path aliases?} |
12
+ | Node.js | {version from engines or .nvmrc} | `.nvmrc` / `package.json engines` | {LTS?} |
13
+
14
+ ## Frameworks
15
+
16
+ | Framework | Version | Role | Entry Point | Config |
17
+ |-----------|---------|------|-------------|--------|
18
+ | {Next.js} | {14.x} | {Web framework} | {src/app/} | {next.config.js} |
19
+ | {Express} | {4.x} | {API server} | {src/server.ts} | - |
20
+
21
+ ## Key Dependencies
22
+
23
+ ### Production Dependencies
24
+
25
+ | Package | Version | Purpose | Used In |
26
+ |---------|---------|---------|---------|
27
+ | {prisma} | {5.x} | {ORM / database} | {src/db/} |
28
+ | {zod} | {3.x} | {Validation} | {src/validators/} |
29
+
30
+ ### Development Dependencies
31
+
32
+ | Package | Version | Purpose | Config |
33
+ |---------|---------|---------|--------|
34
+ | {jest} | {29.x} | {Testing} | {jest.config.ts} |
35
+ | {eslint} | {8.x} | {Linting} | {.eslintrc.js} |
36
+
37
+ ## Build & Tooling
38
+
39
+ | Tool | Config File | Purpose | Commands |
40
+ |------|-------------|---------|----------|
41
+ | {TypeScript} | `tsconfig.json` | {Compilation} | `npx tsc --noEmit` |
42
+ | {ESLint} | `.eslintrc.js` | {Linting} | `npm run lint` |
43
+ | {Prettier} | `.prettierrc` | {Formatting} | `npm run format` |
44
+ | {Jest} | `jest.config.ts` | {Testing} | `npm test` |
45
+
46
+ ## Package Manager
47
+
48
+ - **Manager**: {npm / yarn / pnpm / bun}
49
+ - **Lock file**: {package-lock.json / yarn.lock / pnpm-lock.yaml}
50
+ - **Workspaces**: {yes/no, if yes: list workspace paths}
51
+
52
+ ## Environment Configuration
53
+
54
+ | Variable | Required | Default | Purpose | Where Used |
55
+ |----------|----------|---------|---------|------------|
56
+ | DATABASE_URL | YES | - | Database connection | {src/db/} |
57
+ | {VAR_NAME} | {YES/NO} | {value} | {purpose} | {files} |
58
+
59
+ **Template**: {`.env.example` exists? Y/N}
60
+
61
+ ## Platform Requirements
62
+
63
+ | Requirement | Value | Source |
64
+ |------------|-------|--------|
65
+ | Node version | {>=18} | {package.json engines} |
66
+ | OS | {any / linux only / etc.} | {evidence} |
67
+ | Memory | {if specified} | {evidence} |
68
+ | External services | {list databases, caches, etc.} | {docker-compose, docs} |
69
+
70
+ ## Scripts
71
+
72
+ | Script | Command | Purpose |
73
+ |--------|---------|---------|
74
+ | `dev` | {command} | {Start dev server} |
75
+ | `build` | {command} | {Build for production} |
76
+ | `test` | {command} | {Run tests} |
77
+ | `lint` | {command} | {Run linter} |
78
+ | {others} | {command} | {purpose} |
@@ -0,0 +1,80 @@
1
+ <!-- Source: agents/codebase-mapper.md | Purpose: Output format for STRUCTURE.md codebase analysis -->
2
+ # Project Structure
3
+
4
+ > Analyzed: {date}
5
+
6
+ ## Directory Layout
7
+
8
+ ```
9
+ {project_root}/
10
+ ├── src/ # Source code
11
+ │ ├── app/ # {Purpose: Next.js App Router pages}
12
+ │ │ ├── api/ # {API route handlers}
13
+ │ │ ├── (auth)/ # {Auth-related pages}
14
+ │ │ └── layout.tsx # {Root layout}
15
+ │ ├── components/ # {Shared UI components}
16
+ │ │ ├── ui/ # {Primitive UI components}
17
+ │ │ └── features/ # {Feature-specific components}
18
+ │ ├── lib/ # {Shared utilities and configurations}
19
+ │ ├── services/ # {Business logic}
20
+ │ ├── models/ # {Data models / types}
21
+ │ ├── hooks/ # {Custom React hooks}
22
+ │ └── styles/ # {Global styles}
23
+ ├── prisma/ # {Database schema and migrations}
24
+ ├── public/ # {Static assets}
25
+ ├── tests/ # {Test files}
26
+ ├── docs/ # {Documentation}
27
+ └── scripts/ # {Build/deploy scripts}
28
+ ```
29
+
30
+ ## File Naming Conventions
31
+
32
+ | Type | Pattern | Example |
33
+ |------|---------|---------|
34
+ | React components | {PascalCase.tsx} | `UserProfile.tsx` |
35
+ | Hooks | {camelCase.ts, use* prefix} | `useAuth.ts` |
36
+ | Utilities | {camelCase.ts} | `formatDate.ts` |
37
+ | Types | {PascalCase.ts or types.ts} | `User.ts`, `types.ts` |
38
+ | Tests | {*.test.ts or *.spec.ts} | `UserProfile.test.tsx` |
39
+ | API routes | {route.ts in directory} | `app/api/users/route.ts` |
40
+ | Config | {lowercase with dots} | `jest.config.ts` |
41
+ | Constants | {UPPER_CASE or camelCase} | `constants.ts` |
42
+
43
+ ## Module Boundaries
44
+
45
+ {How the code is organized into modules/features and what the boundaries are}
46
+
47
+ | Module | Directory | Responsibility | Dependencies |
48
+ |--------|-----------|---------------|-------------|
49
+ | {Auth} | {src/auth/} | {Authentication & session} | {Database, Config} |
50
+ | {Users} | {src/users/} | {User CRUD} | {Auth, Database} |
51
+
52
+ ## Import Patterns
53
+
54
+ {How imports are organized in this codebase}
55
+
56
+ ```{language}
57
+ // Standard import order observed in this project:
58
+ // {example from actual codebase}
59
+ ```
60
+
61
+ ### Path Aliases
62
+
63
+ | Alias | Maps To | Config |
64
+ |-------|---------|--------|
65
+ | `@/` | `src/` | `tsconfig.json paths` |
66
+ | `@components/` | `src/components/` | `tsconfig.json paths` |
67
+
68
+ ## Where to Add Code
69
+
70
+ | Type of Code | Location | Convention | Example |
71
+ |-------------|----------|------------|---------|
72
+ | New API route | `src/app/api/{resource}/route.ts` | {pattern} | {example} |
73
+ | New component | `src/components/{feature}/` | {pattern} | {example} |
74
+ | New service | `src/services/` | {pattern} | {example} |
75
+ | New model | `src/models/` | {pattern} | {example} |
76
+ | New test | `{co-located or tests/}` | {pattern} | {example} |
77
+ | New utility | `src/lib/` or `src/utils/` | {pattern} | {example} |
78
+ | New hook | `src/hooks/` | {pattern} | {example} |
79
+ | New migration | `prisma/migrations/` | `npx prisma migrate dev` | - |
80
+ | New env var | `.env` + `.env.example` | {pattern} | {example} |
@@ -0,0 +1,107 @@
1
+ <!-- Source: agents/codebase-mapper.md | Purpose: Output format for TESTING.md codebase analysis -->
2
+ # Testing Infrastructure
3
+
4
+ > Analyzed: {date}
5
+ > Test files found: {n}
6
+ > Coverage: {percentage if configured}
7
+
8
+ ## Framework
9
+
10
+ | Aspect | Value | Config |
11
+ |--------|-------|--------|
12
+ | Test runner | {Jest / Vitest / pytest / etc.} | {config file path} |
13
+ | Assertion library | {built-in / chai / etc.} | - |
14
+ | Mocking | {jest.mock / vitest.mock / unittest.mock} | - |
15
+ | Coverage tool | {c8 / istanbul / coverage.py} | {config} |
16
+
17
+ ## Running Tests
18
+
19
+ ```bash
20
+ # All tests
21
+ {npm test}
22
+
23
+ # Specific file
24
+ {npm test -- path/to/file}
25
+
26
+ # Watch mode
27
+ {npm run test:watch}
28
+
29
+ # Coverage
30
+ {npm run test:coverage}
31
+
32
+ # Specific pattern
33
+ {npm test -- --grep "pattern"}
34
+ ```
35
+
36
+ ## Test Organization
37
+
38
+ | Aspect | Pattern | Example |
39
+ |--------|---------|---------|
40
+ | Location | {co-located / separate directory} | `src/auth/auth.test.ts` or `tests/auth.test.ts` |
41
+ | File naming | {.test.ts / .spec.ts / test_.py} | `UserService.test.ts` |
42
+ | Describe blocks | {module/function/feature} | `describe('UserService')` |
43
+ | Test naming | {should X / it X / test_X} | `it('should return user by id')` |
44
+
45
+ ## Test Structure Pattern
46
+
47
+ ```{language}
48
+ // Pattern used in this codebase: {evidence file:line}
49
+ {actual test structure from codebase}
50
+ ```
51
+
52
+ ## Mocking Patterns
53
+
54
+ ### External Services
55
+
56
+ ```{language}
57
+ // How external services are mocked: {evidence file:line}
58
+ {actual mock pattern from codebase}
59
+ ```
60
+
61
+ ### Database
62
+
63
+ ```{language}
64
+ // How database is mocked/seeded: {evidence file:line}
65
+ {actual pattern from codebase}
66
+ ```
67
+
68
+ ### API Calls
69
+
70
+ ```{language}
71
+ // How API calls are mocked: {evidence file:line}
72
+ {actual pattern from codebase}
73
+ ```
74
+
75
+ ## Fixtures & Test Data
76
+
77
+ | Type | Location | Pattern |
78
+ |------|----------|---------|
79
+ | {Factories} | {tests/factories/} | {createUser(), createPost()} |
80
+ | {Fixtures} | {tests/fixtures/} | {JSON files} |
81
+ | {Seeds} | {prisma/seed.ts} | {Prisma seed script} |
82
+
83
+ ## Coverage Configuration
84
+
85
+ | Setting | Value |
86
+ |---------|-------|
87
+ | Threshold | {if configured: line %, branch %, function %} |
88
+ | Include | {file patterns} |
89
+ | Exclude | {file patterns} |
90
+ | Reporter | {text / html / lcov} |
91
+
92
+ ## E2E Testing
93
+
94
+ | Aspect | Value | Config |
95
+ |--------|-------|--------|
96
+ | Framework | {Playwright / Cypress / none} | {config file} |
97
+ | Location | {e2e/ or tests/e2e/} | - |
98
+ | Base URL | {config} | - |
99
+
100
+ ## Testing Gaps
101
+
102
+ | Area | Has Tests | Notes |
103
+ |------|-----------|-------|
104
+ | {Unit tests} | {YES/NO/PARTIAL} | {coverage details} |
105
+ | {Integration tests} | {YES/NO/PARTIAL} | {coverage details} |
106
+ | {E2E tests} | {YES/NO/PARTIAL} | {coverage details} |
107
+ | {API tests} | {YES/NO/PARTIAL} | {coverage details} |
@@ -1,4 +1,3 @@
1
- <!-- canonical: ../../pbr/templates/continue-here.md.tmpl -->
2
1
  <!-- Source: skills/pause/SKILL.md | Purpose: Handoff file for session pause/resume, placed in the active phase directory -->
3
2
 
4
3
  # Template: Continue Here Handoff File
@@ -0,0 +1,22 @@
1
+ ## Phase <%= phase_number %>: <%= phase_name %>
2
+
3
+ **Goal**: <%= phase_goal %>
4
+
5
+ ### Key Files Changed
6
+ <% key_files.forEach(f => { %>
7
+ - `<%= f %>`
8
+ <% }) %>
9
+
10
+ ### Verification
11
+ - Status: <%= verification_status %>
12
+ - Must-haves: <%= must_haves_passed %>/<%= must_haves_total %> passed
13
+
14
+ <% if (closes_issues && closes_issues.length > 0) { %>
15
+ ### Issues
16
+ <% closes_issues.forEach(n => { %>
17
+ Closes #<%= n %>
18
+ <% }) %>
19
+ <% } %>
20
+
21
+ ---
22
+ *Generated by [Plan-Build-Run](https://github.com/SienkLogic/plan-build-run)*