prizmkit 1.1.100 → 1.1.102

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 (317) hide show
  1. package/bin/create-prizmkit.js +4 -4
  2. package/bundled/VERSION.json +3 -3
  3. package/bundled/dev-pipeline/.env.example +3 -3
  4. package/bundled/dev-pipeline/README.md +110 -90
  5. package/bundled/dev-pipeline/assets/prizm-dev-team-integration.md +1 -1
  6. package/bundled/dev-pipeline/cli.py +27 -0
  7. package/bundled/dev-pipeline/prizmkit_runtime/__init__.py +13 -0
  8. package/bundled/dev-pipeline/prizmkit_runtime/__main__.py +9 -0
  9. package/bundled/dev-pipeline/prizmkit_runtime/cli.py +193 -0
  10. package/bundled/dev-pipeline/prizmkit_runtime/commands.py +313 -0
  11. package/bundled/dev-pipeline/prizmkit_runtime/compat.py +32 -0
  12. package/bundled/dev-pipeline/prizmkit_runtime/config.py +410 -0
  13. package/bundled/dev-pipeline/prizmkit_runtime/daemon.py +478 -0
  14. package/bundled/dev-pipeline/prizmkit_runtime/gitops.py +734 -0
  15. package/bundled/dev-pipeline/prizmkit_runtime/heartbeat.py +256 -0
  16. package/bundled/dev-pipeline/prizmkit_runtime/interoperability.py +109 -0
  17. package/bundled/dev-pipeline/prizmkit_runtime/paths.py +110 -0
  18. package/bundled/dev-pipeline/prizmkit_runtime/processes.py +373 -0
  19. package/bundled/dev-pipeline/prizmkit_runtime/reset.py +389 -0
  20. package/bundled/dev-pipeline/prizmkit_runtime/runner_bookkeeping.py +51 -0
  21. package/bundled/dev-pipeline/prizmkit_runtime/runner_classification.py +179 -0
  22. package/bundled/dev-pipeline/prizmkit_runtime/runner_models.py +355 -0
  23. package/bundled/dev-pipeline/prizmkit_runtime/runner_prompts.py +118 -0
  24. package/bundled/dev-pipeline/prizmkit_runtime/runner_recovery.py +187 -0
  25. package/bundled/dev-pipeline/prizmkit_runtime/runner_status.py +153 -0
  26. package/bundled/dev-pipeline/prizmkit_runtime/runners.py +425 -0
  27. package/bundled/dev-pipeline/prizmkit_runtime/sessions.py +560 -0
  28. package/bundled/dev-pipeline/prizmkit_runtime/status.py +71 -0
  29. package/bundled/dev-pipeline/scripts/generate-bootstrap-prompt.py +51 -36
  30. package/bundled/dev-pipeline/scripts/generate-bugfix-prompt.py +20 -5
  31. package/bundled/dev-pipeline/scripts/generate-recovery-prompt.py +2 -2
  32. package/bundled/dev-pipeline/scripts/parse-stream-progress.py +39 -0
  33. package/bundled/dev-pipeline/templates/agent-prompts/dev-implement.md +8 -2
  34. package/bundled/dev-pipeline/templates/agent-prompts/reviewer-review.md +1 -1
  35. package/bundled/dev-pipeline/templates/bootstrap-prompt.md +6 -2
  36. package/bundled/dev-pipeline/templates/bootstrap-tier1.md +14 -6
  37. package/bundled/dev-pipeline/templates/bootstrap-tier2.md +14 -4
  38. package/bundled/dev-pipeline/templates/bootstrap-tier3.md +14 -4
  39. package/bundled/dev-pipeline/templates/sections/context-budget-rules.md +2 -0
  40. package/bundled/dev-pipeline/templates/sections/log-size-awareness.md +9 -30
  41. package/bundled/dev-pipeline/templates/sections/phase-context-snapshot-agent-suffix.md +15 -7
  42. package/bundled/dev-pipeline/templates/sections/phase-implement-agent.md +42 -29
  43. package/bundled/dev-pipeline/templates/sections/phase-implement-full.md +41 -39
  44. package/bundled/dev-pipeline/templates/sections/phase-implement-lite.md +8 -17
  45. package/bundled/dev-pipeline/templates/sections/phase-prizmkit-test.md +2 -2
  46. package/bundled/dev-pipeline/templates/sections/phase-review-agent.md +1 -3
  47. package/bundled/dev-pipeline/templates/sections/phase-review-full.md +1 -3
  48. package/bundled/dev-pipeline/templates/sections/phase0-test-baseline.md +3 -8
  49. package/bundled/dev-pipeline/templates/sections/test-failure-recovery-agent.md +6 -2
  50. package/bundled/dev-pipeline/templates/sections/test-failure-recovery-lite.md +5 -1
  51. package/bundled/dev-pipeline/tests/test_auto_skip.py +436 -14
  52. package/bundled/dev-pipeline/tests/test_generate_bootstrap_prompt.py +115 -7
  53. package/bundled/dev-pipeline/tests/test_generate_bugfix_prompt.py +40 -0
  54. package/bundled/dev-pipeline/tests/test_python_runner_parity.py +1226 -0
  55. package/bundled/dev-pipeline/tests/test_unified_cli.py +1045 -0
  56. package/bundled/skills/_metadata.json +1 -1
  57. package/bundled/skills/bugfix-pipeline-launcher/SKILL.md +29 -34
  58. package/bundled/skills/bugfix-pipeline-launcher/references/configuration.md +6 -5
  59. package/bundled/skills/feature-pipeline-launcher/SKILL.md +29 -35
  60. package/bundled/skills/feature-pipeline-launcher/references/configuration.md +7 -6
  61. package/bundled/skills/feature-workflow/SKILL.md +3 -6
  62. package/bundled/skills/recovery-workflow/SKILL.md +23 -32
  63. package/bundled/skills/refactor-pipeline-launcher/SKILL.md +29 -35
  64. package/bundled/skills/refactor-pipeline-launcher/references/configuration.md +7 -6
  65. package/bundled/skills/refactor-workflow/SKILL.md +3 -6
  66. package/bundled/templates/hooks/commit-intent.json +2 -2
  67. package/bundled/templates/hooks/diff-prizm-docs.py +226 -0
  68. package/bundled/templates/hooks/prizm-pre-commit.py +45 -0
  69. package/bundled/templates/hooks/validate-prizm-docs.py +240 -0
  70. package/package.json +1 -1
  71. package/src/config.js +42 -19
  72. package/src/external-skills.js +14 -14
  73. package/src/index.js +3 -6
  74. package/src/manifest.js +11 -5
  75. package/src/metadata.js +7 -18
  76. package/src/platforms.js +25 -0
  77. package/src/prompts.js +0 -12
  78. package/src/runtimes.js +18 -11
  79. package/src/scaffold.js +144 -122
  80. package/src/upgrade.js +12 -3
  81. package/bundled/dev-pipeline/launch-bugfix-daemon.sh +0 -500
  82. package/bundled/dev-pipeline/launch-feature-daemon.sh +0 -657
  83. package/bundled/dev-pipeline/launch-refactor-daemon.sh +0 -502
  84. package/bundled/dev-pipeline/lib/branch.sh +0 -326
  85. package/bundled/dev-pipeline/lib/common.sh +0 -1476
  86. package/bundled/dev-pipeline/lib/heartbeat.sh +0 -469
  87. package/bundled/dev-pipeline/reset-bug.sh +0 -425
  88. package/bundled/dev-pipeline/reset-feature.sh +0 -436
  89. package/bundled/dev-pipeline/reset-refactor.sh +0 -423
  90. package/bundled/dev-pipeline/run-bugfix.sh +0 -1430
  91. package/bundled/dev-pipeline/run-feature.sh +0 -1718
  92. package/bundled/dev-pipeline/run-recovery.sh +0 -648
  93. package/bundled/dev-pipeline/run-refactor.sh +0 -1463
  94. package/bundled/dev-pipeline/tests/test-path-resolution.sh +0 -100
  95. package/bundled/dev-pipeline-windows/.env.example +0 -36
  96. package/bundled/dev-pipeline-windows/README.md +0 -30
  97. package/bundled/dev-pipeline-windows/SCHEMA_ANALYSIS.md +0 -533
  98. package/bundled/dev-pipeline-windows/assets/feature-list-example.json +0 -146
  99. package/bundled/dev-pipeline-windows/assets/prizm-dev-team-integration.md +0 -137
  100. package/bundled/dev-pipeline-windows/launch-bugfix-daemon.ps1 +0 -9
  101. package/bundled/dev-pipeline-windows/launch-feature-daemon.ps1 +0 -9
  102. package/bundled/dev-pipeline-windows/launch-refactor-daemon.ps1 +0 -9
  103. package/bundled/dev-pipeline-windows/lib/branch.ps1 +0 -235
  104. package/bundled/dev-pipeline-windows/lib/common.ps1 +0 -991
  105. package/bundled/dev-pipeline-windows/lib/daemon.ps1 +0 -140
  106. package/bundled/dev-pipeline-windows/lib/pipeline.ps1 +0 -1051
  107. package/bundled/dev-pipeline-windows/lib/reset.ps1 +0 -121
  108. package/bundled/dev-pipeline-windows/reset-bug.ps1 +0 -10
  109. package/bundled/dev-pipeline-windows/reset-feature.ps1 +0 -10
  110. package/bundled/dev-pipeline-windows/reset-refactor.ps1 +0 -10
  111. package/bundled/dev-pipeline-windows/run-bugfix.ps1 +0 -9
  112. package/bundled/dev-pipeline-windows/run-feature.ps1 +0 -9
  113. package/bundled/dev-pipeline-windows/run-recovery.ps1 +0 -179
  114. package/bundled/dev-pipeline-windows/run-refactor.ps1 +0 -9
  115. package/bundled/dev-pipeline-windows/scripts/check-session-status.py +0 -301
  116. package/bundled/dev-pipeline-windows/scripts/continuation.py +0 -374
  117. package/bundled/dev-pipeline-windows/scripts/detect-stuck.py +0 -530
  118. package/bundled/dev-pipeline-windows/scripts/generate-bootstrap-prompt.py +0 -2279
  119. package/bundled/dev-pipeline-windows/scripts/generate-bugfix-prompt.py +0 -763
  120. package/bundled/dev-pipeline-windows/scripts/generate-recovery-prompt.py +0 -805
  121. package/bundled/dev-pipeline-windows/scripts/generate-refactor-prompt.py +0 -841
  122. package/bundled/dev-pipeline-windows/scripts/init-bugfix-pipeline.py +0 -316
  123. package/bundled/dev-pipeline-windows/scripts/init-dev-team.py +0 -134
  124. package/bundled/dev-pipeline-windows/scripts/init-pipeline.py +0 -382
  125. package/bundled/dev-pipeline-windows/scripts/init-refactor-pipeline.py +0 -399
  126. package/bundled/dev-pipeline-windows/scripts/parse-stream-progress.py +0 -1362
  127. package/bundled/dev-pipeline-windows/scripts/patch-completion-notes.py +0 -191
  128. package/bundled/dev-pipeline-windows/scripts/prizmkit-test-gate.py +0 -446
  129. package/bundled/dev-pipeline-windows/scripts/update-bug-status.py +0 -1121
  130. package/bundled/dev-pipeline-windows/scripts/update-checkpoint.py +0 -173
  131. package/bundled/dev-pipeline-windows/scripts/update-feature-status.py +0 -1789
  132. package/bundled/dev-pipeline-windows/scripts/update-refactor-status.py +0 -1327
  133. package/bundled/dev-pipeline-windows/scripts/utils.py +0 -542
  134. package/bundled/dev-pipeline-windows/templates/agent-prompts/critic-plan-challenge.md +0 -7
  135. package/bundled/dev-pipeline-windows/templates/agent-prompts/dev-fix.md +0 -7
  136. package/bundled/dev-pipeline-windows/templates/agent-prompts/dev-implement.md +0 -65
  137. package/bundled/dev-pipeline-windows/templates/agent-prompts/dev-resume.md +0 -5
  138. package/bundled/dev-pipeline-windows/templates/agent-prompts/reviewer-review.md +0 -7
  139. package/bundled/dev-pipeline-windows/templates/bootstrap-prompt.md +0 -73
  140. package/bundled/dev-pipeline-windows/templates/bootstrap-tier1.md +0 -589
  141. package/bundled/dev-pipeline-windows/templates/bootstrap-tier2.md +0 -710
  142. package/bundled/dev-pipeline-windows/templates/bootstrap-tier3.md +0 -791
  143. package/bundled/dev-pipeline-windows/templates/bug-fix-list-schema.json +0 -263
  144. package/bundled/dev-pipeline-windows/templates/bugfix-bootstrap-prompt.md +0 -326
  145. package/bundled/dev-pipeline-windows/templates/feature-list-schema.json +0 -237
  146. package/bundled/dev-pipeline-windows/templates/refactor-bootstrap-prompt.md +0 -340
  147. package/bundled/dev-pipeline-windows/templates/refactor-list-schema.json +0 -270
  148. package/bundled/dev-pipeline-windows/templates/sections/ac-verification-checklist.md +0 -7
  149. package/bundled/dev-pipeline-windows/templates/sections/checkpoint-system.md +0 -91
  150. package/bundled/dev-pipeline-windows/templates/sections/context-budget-rules.md +0 -34
  151. package/bundled/dev-pipeline-windows/templates/sections/critical-paths-agent.md +0 -10
  152. package/bundled/dev-pipeline-windows/templates/sections/critical-paths-full.md +0 -12
  153. package/bundled/dev-pipeline-windows/templates/sections/critical-paths-lite.md +0 -7
  154. package/bundled/dev-pipeline-windows/templates/sections/directory-convention-agent.md +0 -8
  155. package/bundled/dev-pipeline-windows/templates/sections/directory-convention-full.md +0 -9
  156. package/bundled/dev-pipeline-windows/templates/sections/directory-convention-lite.md +0 -6
  157. package/bundled/dev-pipeline-windows/templates/sections/failure-capture.md +0 -21
  158. package/bundled/dev-pipeline-windows/templates/sections/feature-context.md +0 -21
  159. package/bundled/dev-pipeline-windows/templates/sections/log-size-awareness.md +0 -41
  160. package/bundled/dev-pipeline-windows/templates/sections/phase-browser-verification-auto.md +0 -283
  161. package/bundled/dev-pipeline-windows/templates/sections/phase-browser-verification-opencli.md +0 -112
  162. package/bundled/dev-pipeline-windows/templates/sections/phase-browser-verification.md +0 -168
  163. package/bundled/dev-pipeline-windows/templates/sections/phase-commit-full.md +0 -82
  164. package/bundled/dev-pipeline-windows/templates/sections/phase-commit.md +0 -75
  165. package/bundled/dev-pipeline-windows/templates/sections/phase-context-snapshot-agent-suffix.md +0 -23
  166. package/bundled/dev-pipeline-windows/templates/sections/phase-context-snapshot-base.md +0 -14
  167. package/bundled/dev-pipeline-windows/templates/sections/phase-context-snapshot-lite-suffix.md +0 -19
  168. package/bundled/dev-pipeline-windows/templates/sections/phase-critic-plan-full.md +0 -63
  169. package/bundled/dev-pipeline-windows/templates/sections/phase-critic-plan.md +0 -42
  170. package/bundled/dev-pipeline-windows/templates/sections/phase-implement-agent.md +0 -44
  171. package/bundled/dev-pipeline-windows/templates/sections/phase-implement-full.md +0 -59
  172. package/bundled/dev-pipeline-windows/templates/sections/phase-implement-lite.md +0 -39
  173. package/bundled/dev-pipeline-windows/templates/sections/phase-plan-agent.md +0 -27
  174. package/bundled/dev-pipeline-windows/templates/sections/phase-plan-lite.md +0 -27
  175. package/bundled/dev-pipeline-windows/templates/sections/phase-prizmkit-test.md +0 -39
  176. package/bundled/dev-pipeline-windows/templates/sections/phase-review-agent.md +0 -35
  177. package/bundled/dev-pipeline-windows/templates/sections/phase-review-full.md +0 -35
  178. package/bundled/dev-pipeline-windows/templates/sections/phase-specify-plan-full.md +0 -73
  179. package/bundled/dev-pipeline-windows/templates/sections/phase0-init.md +0 -13
  180. package/bundled/dev-pipeline-windows/templates/sections/phase0-test-baseline.md +0 -21
  181. package/bundled/dev-pipeline-windows/templates/sections/session-context.md +0 -5
  182. package/bundled/dev-pipeline-windows/templates/sections/subagent-timeout-recovery.md +0 -6
  183. package/bundled/dev-pipeline-windows/templates/sections/task-contract.md +0 -34
  184. package/bundled/dev-pipeline-windows/templates/sections/test-failure-recovery-agent.md +0 -48
  185. package/bundled/dev-pipeline-windows/templates/sections/test-failure-recovery-lite.md +0 -48
  186. package/bundled/dev-pipeline-windows/templates/session-status-schema.json +0 -83
  187. package/bundled/skills-windows/app-planner/SKILL.md +0 -296
  188. package/bundled/skills-windows/app-planner/assets/app-design-guide.md +0 -101
  189. package/bundled/skills-windows/app-planner/references/architecture-decisions.md +0 -52
  190. package/bundled/skills-windows/app-planner/references/brainstorm-guide.md +0 -101
  191. package/bundled/skills-windows/app-planner/references/frontend-design-guide.md +0 -71
  192. package/bundled/skills-windows/app-planner/references/infrastructure-convention-discovery.md +0 -108
  193. package/bundled/skills-windows/app-planner/references/project-brief-guide.md +0 -82
  194. package/bundled/skills-windows/app-planner/references/project-conventions-discovery.md +0 -59
  195. package/bundled/skills-windows/app-planner/references/project-state-detection.md +0 -90
  196. package/bundled/skills-windows/app-planner/references/red-team-checklist.md +0 -40
  197. package/bundled/skills-windows/app-planner/references/rules/backend/derivation-rules.md +0 -619
  198. package/bundled/skills-windows/app-planner/references/rules/backend/fixed-rules.md +0 -285
  199. package/bundled/skills-windows/app-planner/references/rules/backend/question-bank.md +0 -249
  200. package/bundled/skills-windows/app-planner/references/rules/backend/question-manifest.json +0 -46
  201. package/bundled/skills-windows/app-planner/references/rules/backend/template.md +0 -173
  202. package/bundled/skills-windows/app-planner/references/rules/database/derivation-rules.md +0 -382
  203. package/bundled/skills-windows/app-planner/references/rules/database/fixed-rules.md +0 -211
  204. package/bundled/skills-windows/app-planner/references/rules/database/question-bank.md +0 -184
  205. package/bundled/skills-windows/app-planner/references/rules/database/question-manifest.json +0 -39
  206. package/bundled/skills-windows/app-planner/references/rules/database/template.md +0 -158
  207. package/bundled/skills-windows/app-planner/references/rules/frontend/derivation-rules.md +0 -820
  208. package/bundled/skills-windows/app-planner/references/rules/frontend/fixed-rules.md +0 -188
  209. package/bundled/skills-windows/app-planner/references/rules/frontend/question-bank.md +0 -319
  210. package/bundled/skills-windows/app-planner/references/rules/frontend/question-manifest.json +0 -51
  211. package/bundled/skills-windows/app-planner/references/rules/frontend/template.md +0 -339
  212. package/bundled/skills-windows/app-planner/references/rules/mobile/derivation-rules.md +0 -649
  213. package/bundled/skills-windows/app-planner/references/rules/mobile/fixed-rules.md +0 -290
  214. package/bundled/skills-windows/app-planner/references/rules/mobile/question-bank.md +0 -232
  215. package/bundled/skills-windows/app-planner/references/rules/mobile/question-manifest.json +0 -47
  216. package/bundled/skills-windows/app-planner/references/rules/mobile/template.md +0 -175
  217. package/bundled/skills-windows/app-planner/references/rules-configuration.md +0 -46
  218. package/bundled/skills-windows/bug-fix-workflow/SKILL.md +0 -379
  219. package/bundled/skills-windows/bug-fix-workflow/references/bug-diagnosis.md +0 -41
  220. package/bundled/skills-windows/bug-planner/SKILL.md +0 -402
  221. package/bundled/skills-windows/bug-planner/assets/bug-confirmation-template.md +0 -43
  222. package/bundled/skills-windows/bug-planner/references/critic-and-verification.md +0 -44
  223. package/bundled/skills-windows/bug-planner/references/error-recovery.md +0 -73
  224. package/bundled/skills-windows/bug-planner/references/input-formats.md +0 -53
  225. package/bundled/skills-windows/bug-planner/references/schema-validation.md +0 -25
  226. package/bundled/skills-windows/bug-planner/references/severity-rules.md +0 -16
  227. package/bundled/skills-windows/bug-planner/scripts/validate-bug-list.py +0 -322
  228. package/bundled/skills-windows/bugfix-pipeline-launcher/SKILL.md +0 -304
  229. package/bundled/skills-windows/bugfix-pipeline-launcher/references/configuration.md +0 -84
  230. package/bundled/skills-windows/feature-pipeline-launcher/SKILL.md +0 -381
  231. package/bundled/skills-windows/feature-pipeline-launcher/references/configuration.md +0 -67
  232. package/bundled/skills-windows/feature-pipeline-launcher/scripts/preflight-check.py +0 -462
  233. package/bundled/skills-windows/feature-planner/SKILL.md +0 -397
  234. package/bundled/skills-windows/feature-planner/assets/evaluation-guide.md +0 -64
  235. package/bundled/skills-windows/feature-planner/assets/planning-guide.md +0 -214
  236. package/bundled/skills-windows/feature-planner/references/browser-interaction.md +0 -59
  237. package/bundled/skills-windows/feature-planner/references/completeness-review.md +0 -57
  238. package/bundled/skills-windows/feature-planner/references/decomposition-patterns.md +0 -75
  239. package/bundled/skills-windows/feature-planner/references/error-recovery.md +0 -90
  240. package/bundled/skills-windows/feature-planner/references/incremental-feature-planning.md +0 -112
  241. package/bundled/skills-windows/feature-planner/references/new-project-planning.md +0 -85
  242. package/bundled/skills-windows/feature-planner/scripts/validate-and-generate.py +0 -1020
  243. package/bundled/skills-windows/feature-workflow/SKILL.md +0 -374
  244. package/bundled/skills-windows/feature-workflow/references/brainstorm-guide.md +0 -137
  245. package/bundled/skills-windows/prizm-kit/SKILL.md +0 -93
  246. package/bundled/skills-windows/prizmkit-code-review/SKILL.md +0 -161
  247. package/bundled/skills-windows/prizmkit-code-review/references/dev-agent-prompt.md +0 -30
  248. package/bundled/skills-windows/prizmkit-code-review/references/review-report-template.md +0 -31
  249. package/bundled/skills-windows/prizmkit-code-review/references/reviewer-agent-prompt.md +0 -66
  250. package/bundled/skills-windows/prizmkit-code-review/scripts/check_loop.py +0 -186
  251. package/bundled/skills-windows/prizmkit-committer/SKILL.md +0 -89
  252. package/bundled/skills-windows/prizmkit-deploy/SKILL.md +0 -444
  253. package/bundled/skills-windows/prizmkit-deploy/references/ci-cd-workflows.md +0 -115
  254. package/bundled/skills-windows/prizmkit-deploy/references/cloud-platform-deploy.md +0 -93
  255. package/bundled/skills-windows/prizmkit-deploy/references/data-safety-examples.md +0 -120
  256. package/bundled/skills-windows/prizmkit-deploy/references/database-setup.md +0 -46
  257. package/bundled/skills-windows/prizmkit-deploy/references/deploy-config-schema.md +0 -148
  258. package/bundled/skills-windows/prizmkit-deploy/references/deploy-history-schema.md +0 -62
  259. package/bundled/skills-windows/prizmkit-deploy/references/deployment-modes.md +0 -50
  260. package/bundled/skills-windows/prizmkit-deploy/references/direct-upload.md +0 -26
  261. package/bundled/skills-windows/prizmkit-deploy/references/dns-setup.md +0 -42
  262. package/bundled/skills-windows/prizmkit-deploy/references/docker-deploy.md +0 -31
  263. package/bundled/skills-windows/prizmkit-deploy/references/firewall-setup.md +0 -37
  264. package/bundled/skills-windows/prizmkit-deploy/references/live-validation-notes.md +0 -21
  265. package/bundled/skills-windows/prizmkit-deploy/references/nginx-blue-green.md +0 -59
  266. package/bundled/skills-windows/prizmkit-deploy/references/ssh-bootstrap-flow.md +0 -49
  267. package/bundled/skills-windows/prizmkit-deploy/references/ssh-execution-flow.md +0 -41
  268. package/bundled/skills-windows/prizmkit-deploy/references/ssh-takeover.md +0 -20
  269. package/bundled/skills-windows/prizmkit-deploy/references/ssl-setup.md +0 -56
  270. package/bundled/skills-windows/prizmkit-implement/SKILL.md +0 -71
  271. package/bundled/skills-windows/prizmkit-init/SKILL.md +0 -356
  272. package/bundled/skills-windows/prizmkit-init/assets/project-brief-template.md +0 -82
  273. package/bundled/skills-windows/prizmkit-init/references/config-schema.md +0 -70
  274. package/bundled/skills-windows/prizmkit-init/references/rules/layer-detection.md +0 -41
  275. package/bundled/skills-windows/prizmkit-init/references/tech-stack-catalog.md +0 -13
  276. package/bundled/skills-windows/prizmkit-init/references/update-supplement.md +0 -9
  277. package/bundled/skills-windows/prizmkit-plan/SKILL.md +0 -102
  278. package/bundled/skills-windows/prizmkit-plan/assets/plan-template.md +0 -115
  279. package/bundled/skills-windows/prizmkit-plan/assets/spec-template.md +0 -73
  280. package/bundled/skills-windows/prizmkit-plan/references/clarify-guide.md +0 -67
  281. package/bundled/skills-windows/prizmkit-plan/references/examples.md +0 -85
  282. package/bundled/skills-windows/prizmkit-plan/references/verification-checklist.md +0 -60
  283. package/bundled/skills-windows/prizmkit-prizm-docs/SKILL.md +0 -129
  284. package/bundled/skills-windows/prizmkit-prizm-docs/assets/prizm-docs-format.md +0 -613
  285. package/bundled/skills-windows/prizmkit-prizm-docs/references/op-init.md +0 -45
  286. package/bundled/skills-windows/prizmkit-prizm-docs/references/op-rebuild.md +0 -15
  287. package/bundled/skills-windows/prizmkit-prizm-docs/references/op-status.md +0 -14
  288. package/bundled/skills-windows/prizmkit-prizm-docs/references/op-update.md +0 -19
  289. package/bundled/skills-windows/prizmkit-prizm-docs/references/op-validate.md +0 -17
  290. package/bundled/skills-windows/prizmkit-retrospective/SKILL.md +0 -87
  291. package/bundled/skills-windows/prizmkit-retrospective/references/knowledge-injection-steps.md +0 -50
  292. package/bundled/skills-windows/prizmkit-retrospective/references/structural-sync-steps.md +0 -43
  293. package/bundled/skills-windows/prizmkit-test/SKILL.md +0 -227
  294. package/bundled/skills-windows/prizmkit-test/references/boundary-coverage-protocol.md +0 -220
  295. package/bundled/skills-windows/prizmkit-test/references/examples.md +0 -143
  296. package/bundled/skills-windows/prizmkit-test/references/service-boundary-test-catalog.md +0 -225
  297. package/bundled/skills-windows/prizmkit-test/references/test-generation-steps.md +0 -109
  298. package/bundled/skills-windows/prizmkit-test/references/test-report-template.md +0 -111
  299. package/bundled/skills-windows/prizmkit-test/scripts/validate_boundary_report.py +0 -347
  300. package/bundled/skills-windows/recovery-workflow/SKILL.md +0 -355
  301. package/bundled/skills-windows/recovery-workflow/evals/evals.json +0 -46
  302. package/bundled/skills-windows/recovery-workflow/references/detection.md +0 -58
  303. package/bundled/skills-windows/recovery-workflow/scripts/detect-recovery-state.py +0 -544
  304. package/bundled/skills-windows/refactor-pipeline-launcher/SKILL.md +0 -346
  305. package/bundled/skills-windows/refactor-pipeline-launcher/references/configuration.md +0 -72
  306. package/bundled/skills-windows/refactor-planner/SKILL.md +0 -398
  307. package/bundled/skills-windows/refactor-planner/assets/planning-guide.md +0 -292
  308. package/bundled/skills-windows/refactor-planner/references/behavior-preservation.md +0 -301
  309. package/bundled/skills-windows/refactor-planner/references/fast-path.md +0 -59
  310. package/bundled/skills-windows/refactor-planner/references/planning-phases.md +0 -135
  311. package/bundled/skills-windows/refactor-planner/references/refactor-scoping-guide.md +0 -221
  312. package/bundled/skills-windows/refactor-planner/scripts/validate-and-generate-refactor.py +0 -858
  313. package/bundled/skills-windows/refactor-workflow/SKILL.md +0 -343
  314. package/bundled/skills-windows/refactor-workflow/references/brainstorm-guide.md +0 -116
  315. package/bundled/templates/hooks/diff-prizm-docs.sh +0 -158
  316. package/bundled/templates/hooks/prizm-pre-commit.sh +0 -108
  317. package/bundled/templates/hooks/validate-prizm-docs.sh +0 -139
@@ -1,402 +0,0 @@
1
- ---
2
- name: "bug-planner"
3
- description: "Interactive bug planning that produces .prizmkit/plans/bug-fix-list.json for the Bug Fix Pipeline. Supports multiple input formats: error logs, stack traces, user reports, failed tests, monitoring alerts. Use this skill whenever the user has bugs to report, errors to parse, or test failures to organize. Trigger on: 'plan bug fixes', 'report bugs', 'I have some bugs', 'these tests are failing', 'here is an error log', 'parse these errors', 'generate bug list'."
4
- ---
5
-
6
- # Bug Planner
7
-
8
- Interactive skill that collects bug information from various input formats and generates a standardized `.prizmkit/plans/bug-fix-list.json` for the Bug Fix Pipeline.
9
-
10
- ## Invocation Commitment (Hard Rule)
11
-
12
- When the user invokes `/bug-planner`, you MUST execute the bug-planner workflow. You must NEVER:
13
- - Decide on the user's behalf that the task "doesn't need bug-planner"
14
- - Skip bug-planner to jump directly to implementation or any other skill
15
- - Bypass the interactive phases because you judge the task to be "simple"
16
-
17
- If you believe the task is better suited for a different workflow, you MUST:
18
- 1. Explain why you think a different path is more appropriate
19
- 2. Ask the user explicitly whether they want to switch or continue with bug-planner
20
- 3. Only switch if the user confirms
21
-
22
- The user chose this skill intentionally. Respect that choice.
23
-
24
- ## Scope Boundary (Hard Rule)
25
-
26
- This skill is PLANNING ONLY. You must NEVER:
27
- - Create, modify, or delete source code files (*.js, *.ts, *.py, *.go, *.html, *.css, etc.)
28
- - Run build/install/test commands
29
- - Execute any bug fix action
30
- - Execute any implementation action beyond writing `.prizmkit/plans/bug-fix-list.json`
31
-
32
- Your ONLY writable outputs are:
33
- 1. `.prizmkit/plans/bug-fix-list.json`
34
- 2. Draft backups in `.prizmkit/plans/` (e.g., `bug-fix-list.draft.json`)
35
-
36
- After planning is complete, you MUST:
37
- 1. Present the summary and recommended next step (invoking `bugfix-pipeline-launcher`)
38
- 2. Ask the user explicitly whether they want to proceed to execution
39
- 3. If the user wants to adjust → continue refining the bug list
40
- 4. NEVER auto-execute the pipeline, launcher, or any fix step
41
-
42
- ## User-Provided Content Priority (Hard Rule)
43
-
44
- When the user provides detailed specifications, rules, or implementation requirements:
45
-
46
- 1. **Verbatim preservation**: The user's exact wording MUST be preserved in `description` and `acceptance_criteria` fields. Do NOT paraphrase, summarize, abstract, or simplify.
47
- 2. **No autonomous simplification**: A 200-word user specification must NOT become a 30-word description. Match the detail level of the user's input.
48
- 3. **Clarify, don't assume**: If any user-provided rule is ambiguous or potentially conflicts with another, ASK the user to clarify. No limit on clarification rounds. Do NOT proceed with unresolved ambiguities.
49
- 4. **Populate `user_context`**: ALL user-provided materials (supplementary content, rules, file path references) MUST be written into the `user_context` array of each bug in the generated `.prizmkit/plans/bug-fix-list.json`. Format:
50
- - Supplementary content or rules → store as-is (verbatim text)
51
- - File references → store as path string, e.g. `src/auth/login.ts:42-78` or `src/utils/validate.ts — focus on validateEmail function`
52
-
53
- ## When to Use
54
-
55
- The `description` frontmatter declares the trigger phrases for this skill. Beyond those:
56
-
57
- **Do NOT use when:**
58
- - User wants to start fixing bugs now → use `bugfix-pipeline-launcher`
59
- - User wants to fix a single bug interactively → use `bug-fix-workflow`
60
- - User wants to plan features → use `feature-planner`
61
-
62
- ## Intent Routing
63
-
64
- This skill handles multiple operations. Determine the user's intent and dispatch to the matching operation section below — each operation's authoritative trigger phrases live in its own **Operation:** section.
65
-
66
- | User Intent | Operation Section |
67
- |---|---|
68
- | Plan bugs interactively | **Operation: Interactive Planning** |
69
- | Parse error logs into bugs | **Operation: From Log** |
70
- | Parse test failures into bugs | **Operation: From Tests** |
71
- | Validate existing bug list | **Operation: Validate** |
72
- | Summarize bug list | **Operation: Summary** |
73
-
74
- ## PowerShell Python Helper
75
-
76
- Define this helper once in the active PowerShell session before running PrizmKit validation scripts:
77
-
78
- ```powershell
79
- function Invoke-PrizmPython {
80
- param([Parameter(ValueFromRemainingArguments = $true)][string[]]$Arguments)
81
- $python = Get-Command python -ErrorAction SilentlyContinue
82
- if ($python) {
83
- & $python.Source -c 'import sys; raise SystemExit(0 if sys.version_info[0] == 3 else 1)' *> $null
84
- if ($LASTEXITCODE -eq 0) {
85
- & $python.Source @Arguments
86
- return
87
- }
88
- }
89
- $py = Get-Command py -ErrorAction SilentlyContinue
90
- if ($py) {
91
- & $py.Source -3 -c 'import sys; raise SystemExit(0 if sys.version_info[0] == 3 else 1)' *> $null
92
- if ($LASTEXITCODE -eq 0) {
93
- & $py.Source -3 @Arguments
94
- return
95
- }
96
- }
97
- throw "Python 3 is required. Install Python and ensure python or py is in PATH."
98
- }
99
- ```
100
-
101
- ## Scenario Routing
102
-
103
- Classify user intent first:
104
-
105
- ### Route A: New Bug List (No Existing Plan)
106
-
107
- Use when no `.prizmkit/plans/bug-fix-list.json` exists.
108
-
109
- Actions:
110
- 1. Run full Interactive Planning (Phase 1-5)
111
- 2. Generate initial `.prizmkit/plans/bug-fix-list.json`
112
-
113
- ### Route B: Append to Existing Bug List
114
-
115
- Use when `.prizmkit/plans/bug-fix-list.json` already exists and user wants to add more bugs.
116
-
117
- Actions:
118
- 1. Read existing `.prizmkit/plans/bug-fix-list.json` first (if missing, ask whether to start new plan)
119
- 2. Continue with next sequential `B-NNN` IDs
120
- 3. Preserve existing entries, append new bugs
121
- 4. Re-run validation on the merged list
122
-
123
- ---
124
-
125
- ## Operation: Interactive Planning
126
-
127
- Triggers: "plan bug fixes", "report bugs".
128
-
129
- Launch the interactive bug planning process through 5 phases.
130
-
131
- ### Phase 1: Project Context
132
-
133
- Gather project metadata from the project's own configuration and documentation — bug-planner is independent of feature-planner, so it reads project-level sources directly rather than depending on feature-list.json.
134
-
135
- 1. **Identify project**: Read project name and description from these sources (first match wins):
136
- - `.prizmkit/config.json` (`project_name`, `description` fields)
137
- - `.prizmkit/prizm-docs/root.prizm` (project overview section)
138
- - `CLAUDE.md` or `CODEBUDDY.md` (project instructions)
139
- - `package.json` / `pyproject.toml` / `Cargo.toml` (name + description fields)
140
- - If none found, ask the user
141
- 2. **Identify tech stack**: Read from these sources (first match wins):
142
- - `.prizmkit/config.json` `tech_stack` (preferred — contains language, frameworks, DB, etc.)
143
- - `.prizmkit/prizm-docs/root.prizm` (architecture section)
144
- - Auto-detect from project files (`package.json`, `requirements.txt`, `go.mod`, etc.)
145
- - If none found, ask the user
146
- 3. **Identify testing framework**: Read from `.prizmkit/config.json` `tech_stack.testing`, or auto-detect from package.json/requirements.txt/etc., or ask user
147
- 4. **Clarify context** — if the project context, affected systems, or bug scope is unclear, ask questions one at a time (cite the unclear point, give a recommended answer with rationale) until you fully understand the environment. No limit on rounds or number of questions.
148
- 5. **Collect reference materials** — **Upfront Material Detection (Hard Rule)**: If the user has already provided materials (file paths, URLs, rules, specifications, code snippets) in the same message that invoked this skill: (a) Acknowledge what was received: "I received the following materials: [list]"; (b) Read/fetch all provided materials immediately; (c) You MUST still ask: "Are there any additional materials you'd like to provide?"; (d) NEVER skip this collection step just because the user already provided some materials.
149
-
150
- If the user has NOT provided any materials upfront, explicitly ask whether they have any supplementary materials for you to review before proceeding to bug collection:
151
- > "Do you have any reference materials I should review to better understand these bugs? This can include:
152
- > - **Code paths** — files or directories where the bugs likely originate
153
- > - **Documents** — related design docs, API specs, or architecture docs for the affected area
154
- > - **Error screenshots** — UI screenshots, console output images, or monitoring dashboards
155
- > - **Web links** — related issue tracker links, Stack Overflow threads, or documentation pages
156
- > - **Log files** — error log paths or monitoring tool URLs
157
- >
158
- > If none, we'll proceed with bug collection."
159
-
160
- If the user provides materials, read/fetch them all before proceeding to Phase 2. For web links, use web fetch to retrieve and analyze the content. For images, read and analyze them visually. This context significantly improves bug diagnosis accuracy and description quality.
161
-
162
- Output: `project_name`, `project_description`, `global_context` fields populated.
163
-
164
- **Gate → CP-BP-1**: Tech stack and project info confirmed before proceeding.
165
-
166
- ### Phase 2: Bug Collection
167
-
168
- Accept bug information in ANY of these formats (auto-detect):
169
-
170
- #### Severity & Input Format References
171
-
172
- When classifying severity, read `${SKILL_DIR}/references/severity-rules.md` for the auto-classification table (critical/high/medium/low indicators and special cases).
173
-
174
- When parsing user input, auto-detect the format and read `${SKILL_DIR}/references/input-formats.md` for extraction patterns. Supported formats: stack traces, user reports, failed tests, log patterns, monitoring alerts.
175
-
176
- **For each bug collected**, interactively confirm or fill in:
177
- - Title (auto-suggest from error message, user can edit)
178
- - Description (auto-generate expected vs actual, user can edit)
179
- - Severity (auto-suggest based on error type, user can override)
180
- - Environment (ask or auto-detect from logs)
181
- - Verification type (suggest `automated` by default, ask user)
182
- - Acceptance criteria (auto-suggest based on description, user can edit)
183
- - Model override (optional; if specified, overrides $MODEL env var for this bug fix)
184
-
185
- **Per-bug clarification** — if the bug's root cause, reproduction steps, expected behavior, or scope is unclear from the provided information, ask focused questions one at a time (cite the unclear point, give a recommended answer with rationale) until the bug is fully understood. Do not finalize a bug entry with ambiguous details. No limit on the number of questions per bug.
186
-
187
- **Per-bug confirmation (mandatory)** — after extracting and clarifying each bug, present a structured summary using the template in `${SKILL_DIR}/assets/bug-confirmation-template.md`, then ask the three confirmation questions defined there.
188
-
189
- The acceptance criteria are critical — they directly determine how the bugfix pipeline judges success or failure. Vague criteria like "login works" lead to shallow fixes; prefer specific, verifiable conditions like "POST /api/login with valid credentials returns 200 and a JWT token in the response body."
190
-
191
- Only finalize the bug entry after user confirms all three points.
192
-
193
- **Multiple bugs per session**: After each bug, ask "Any more bugs to add? (yes/no)"
194
-
195
- **Gate → CP-BP-2**: All bugs extracted and confirmed by user.
196
-
197
- ### Phase 3: Prioritization & Review
198
-
199
- 1. **Auto-assign priorities**: Based on severity, adjustable by user
200
-
201
- **Severity → Priority Mapping**:
202
- - `critical` severity → `high` priority (treated with highest urgency)
203
- - `high` severity → `high` priority
204
- - `medium` severity → `medium` priority
205
- - `low` severity → `low` priority
206
-
207
- Note: Severity has 4 levels (critical, high, medium, low) but Priority has 3 levels (high, medium, low). Both critical and high severity bugs map to high priority.
208
- 2. **Display summary table**:
209
- ```
210
- ID | Title | Severity | Priority | Verification
211
- B-001 | Login null reference crash | critical | high | automated
212
- B-002 | CSV export Chinese encoding | medium | medium | hybrid
213
- B-003 | Slow dashboard loading | low | low | manual
214
- ```
215
- 3. **Ask for adjustments**: "Want to reorder priorities, change severity, or remove any bugs?"
216
- 4. **Detect potential duplicates**: If two bugs have similar error messages or affected modules, warn user
217
-
218
- **Gate → CP-BP-3**: Severity/priority assigned, duplicates resolved.
219
-
220
- ### Phase 4: Pre-Generation Completeness Review
221
-
222
- Before generating `.prizmkit/plans/bug-fix-list.json`, perform a holistic scan across all collected bugs. The bugfix pipeline runs autonomously — any ambiguity left here becomes a wrong assumption later.
223
-
224
- **Step 1 — Description adequacy scan (Headless Execution Readiness)**: The bugfix pipeline runs each bug through an autonomous AI session with NO human interaction. Every description must be unambiguous enough for headless execution. For each bug, check:
225
- - Description clearly states **expected** vs **actual** behavior (not just "X doesn't work")
226
- - Reproduction path is specific enough for the pipeline AI to locate the relevant code
227
- - If the bug involves user interaction, the trigger action is described (not just the symptom)
228
- - **Code location hints**: Where in the codebase should the AI look? (file paths, module names, function names)
229
- - **Verification method**: How should the AI verify the fix? (run specific test, check specific behavior)
230
- - Bad: "Login is broken" — too vague, AI will search the entire codebase
231
- - Good: "Login form at /login returns 500 when password field is empty. Expected: validation error 400. Root cause likely in src/api/auth.ts POST /api/auth/login handler — missing null check on password field."
232
-
233
- **Step 2 — Acceptance criteria specificity check**: For each bug, verify each acceptance criterion passes the "pipeline autonomy test" — could an AI session, without asking a human, determine whether this criterion is met? Flag criteria that are subjective ("works correctly"), lack measurable conditions ("performs better"), or don't specify the verification method.
234
-
235
- **Step 3 — Cross-bug analysis**: Check for:
236
- - **Root cause overlap**: Multiple bugs in the same module may share a root cause — flag for user to confirm whether they should be merged or kept separate
237
- - **Missing dependencies**: If fixing B-002 requires B-001 to be fixed first, flag the dependency
238
- - **Scope gaps**: If bugs describe symptoms but the underlying cause likely affects more areas, suggest additional bugs
239
-
240
- **Step 4 — Present review table**: Display the completeness assessment using the template in `${SKILL_DIR}/assets/bug-confirmation-template.md` (§Completeness Review Template).
241
-
242
- For any items that need attention, ask targeted questions to fill gaps. Iterate until the user confirms all bugs are adequately described. Present the prompt:
243
-
244
- > "Above is the completeness review. Items needing more detail — address them now, or proceed and refine later?"
245
-
246
- Only proceed to Phase 5 after user confirms.
247
-
248
- **Gate → CP-BP-4**: All bugs pass headless execution readiness check.
249
-
250
- ### Phase 5: Generate & Validate
251
-
252
- 1. **Write draft JSON**: Write a draft `.prizmkit/plans/bug-fix-list.draft.json` with all collected bug data. Conform to `.prizmkit/dev-pipeline/templates/bug-fix-list-schema.json`.
253
- 2. **Generate and validate**: Run the generate script to validate and produce the final file:
254
- ```powershell
255
- Invoke-PrizmPython ${SKILL_DIR}/scripts/validate-bug-list.py generate --input .prizmkit/plans/bug-fix-list.draft.json --output .prizmkit/plans/bug-fix-list.json
256
- ```
257
- The script fills in defaults (`$schema`, `created_at`, `created_by`), validates all fields, and writes the final file only if validation passes.
258
- 3. **If validation fails**: Fix the draft and retry (max 3 attempts). If the script is unavailable, use the checklist in `${SKILL_DIR}/references/schema-validation.md`.
259
- 4. **Output**: File path, summary, and next steps
260
-
261
- **Gate → CP-BP-5**: `bug-fix-list.json` passes validation script with zero errors.
262
-
263
- #### Success Output
264
-
265
- ```
266
- .prizmkit/plans/bug-fix-list.json generated with 3 bugs (1 critical, 1 medium, 1 low)
267
-
268
- Next steps:
269
- - Review: Get-Content .prizmkit/plans/bug-fix-list.json
270
- - Start fixing: say "start fixing" to launch the bugfix pipeline via bugfix-pipeline-launcher
271
- ```
272
-
273
- ### Checkpoints (Mandatory Gates)
274
-
275
- Checkpoints catch cascading errors early — skipping one means the next phase builds on unvalidated assumptions.
276
-
277
- | Checkpoint | Artifact/State | Criteria | Phase |
278
- |-----------|----------------|----------|-------|
279
- | **CP-BP-1** | Project Context | Tech stack and project info confirmed | 1 |
280
- | **CP-BP-2** | Bugs Collected | All bugs extracted and confirmed by user | 2 |
281
- | **CP-BP-3** | Priorities Set | Severity/priority assigned, duplicates resolved | 3 |
282
- | **CP-BP-4** | Completeness Passed | All bugs pass headless execution readiness check | 4 |
283
- | **CP-BP-5** | File Generated | `bug-fix-list.json` passes validation script | 5 |
284
-
285
- **Resume Detection**: If existing `.prizmkit/plans/bug-fix-list.json` or draft found, read `${SKILL_DIR}/references/error-recovery.md` §Resume Support for checkpoint-based resumption.
286
-
287
- ---
288
-
289
- ## Operation: From Log
290
-
291
- Triggers: "parse this error log", "here's a stack trace", "parse these errors".
292
-
293
- Batch-parse error logs to generate bug entries without interactive prompts:
294
-
295
- 1. Accept log file path or piped content
296
- 2. Parse all unique errors (deduplicate by error message pattern)
297
- 3. Auto-generate bug entries with:
298
- - Title: first line of error message
299
- - Description: full error context
300
- - Severity: use `${SKILL_DIR}/references/severity-rules.md`
301
- - error_source: populated from log content
302
- - verification_type: default to `automated`
303
- - acceptance_criteria: auto-generate "Error no longer occurs in [scenario]"
304
- 4. Write draft to `.prizmkit/plans/bug-fix-list.draft.json` for user review
305
- 5. Ask: "Review and confirm? You can edit individual entries."
306
- 6. After user confirms, call the generate script:
307
- ```powershell
308
- Invoke-PrizmPython ${SKILL_DIR}/scripts/validate-bug-list.py generate --input .prizmkit/plans/bug-fix-list.draft.json --output .prizmkit/plans/bug-fix-list.json
309
- ```
310
-
311
- ## Operation: From Tests
312
-
313
- Triggers: "these tests are failing", "parse test output".
314
-
315
- Batch-parse failed test output:
316
-
317
- 1. Accept test runner output (Jest, pytest, Go test, etc.)
318
- 2. Parse each failed test case as a separate bug entry
319
- 3. Auto-populate `failed_test_path`, `error_message`
320
- 4. Set verification_type to `automated` (test already exists)
321
- 5. Write draft to `.prizmkit/plans/bug-fix-list.draft.json`
322
- 6. After user confirms, call the generate script:
323
- ```powershell
324
- Invoke-PrizmPython ${SKILL_DIR}/scripts/validate-bug-list.py generate --input .prizmkit/plans/bug-fix-list.draft.json --output .prizmkit/plans/bug-fix-list.json
325
- ```
326
-
327
- ## Operation: Validate
328
-
329
- Triggers: "validate bug list", "check .prizmkit/plans/bug-fix-list.json".
330
-
331
- Validate existing `.prizmkit/plans/bug-fix-list.json`:
332
-
333
- 1. Check JSON syntax
334
- 2. Validate against `.prizmkit/dev-pipeline/templates/bug-fix-list-schema.json`
335
- 3. Check for:
336
- - Duplicate IDs
337
- - Missing required fields
338
- - Invalid status values
339
- - Invalid priority values (must be 'high', 'medium', or 'low')
340
- 4. Output: validation result with specific errors/warnings
341
-
342
- ## Operation: Summary
343
-
344
- Triggers: "bug summary", "show bug list", "list bugs".
345
-
346
- Print human-readable summary:
347
-
348
- ```
349
- Bug Fix List Summary: my-web-app
350
-
351
- Total: 3 bugs
352
- By Severity: critical=1, high=0, medium=1, low=1
353
- By Status: pending=3
354
-
355
- Bug List (by priority):
356
- 1. [B-001] Login null reference crash (CRITICAL) — automated
357
- 2. [B-002] CSV export Chinese encoding (MEDIUM) — hybrid
358
- 3. [B-003] Slow dashboard loading (LOW) — manual
359
- ```
360
-
361
- ---
362
-
363
- ## Adversarial Critic & Browser Verification
364
-
365
- When configuring critic settings or browser verification for bugs, read `${SKILL_DIR}/references/critic-and-verification.md` for default behavior tables and verification type guidance.
366
-
367
- Key points:
368
- - Critic is enabled by default for critical/high severity, disabled for medium/low
369
- - Users can override critic settings per-bug during Phase 2 or Phase 3
370
- - Browser verification is feature-pipeline only — bug fixes use `verification_type` field (automated/manual/hybrid)
371
-
372
- ---
373
-
374
- ## Next-Step Execution Policy
375
-
376
- Recommend invoking `bugfix-pipeline-launcher` to configure and launch the pipeline. Do NOT recommend running shell scripts directly — that is the launcher's responsibility.
377
-
378
- After `.prizmkit/plans/bug-fix-list.json` is generated, present:
379
- 1. Summary of generated bugs (count, severity breakdown)
380
- 2. Recommend: "Say 'start fixing' to launch the bugfix pipeline via `bugfix-pipeline-launcher`"
381
- 3. Alternative: fix a single bug interactively via `bug-fix-workflow`
382
-
383
- ## Error Handling
384
-
385
- If validation fails or a session is interrupted, read `${SKILL_DIR}/references/error-recovery.md` for the full error type table, retry logic, and checkpoint-based resume support.
386
-
387
- Common errors handled inline:
388
-
389
- | Error | Action |
390
- |-------|--------|
391
- | Cannot parse error log format | Ask user to specify format or provide raw text |
392
- | Ambiguous severity classification | Present options, ask user to choose |
393
- | Duplicate bug detected | Warn user, suggest merging or keeping separate |
394
- | No bugs provided | Prompt with examples of supported input formats |
395
- | Invalid feature reference | Warn and ask user to correct or remove reference |
396
- | Schema validation failure | Show specific errors, offer to fix interactively |
397
-
398
- ## Output
399
-
400
- - `.prizmkit/plans/bug-fix-list.json` conforming to `.prizmkit/dev-pipeline/templates/bug-fix-list-schema.json`
401
- - Validation report (if validation run)
402
- - Summary report (if summary run)
@@ -1,43 +0,0 @@
1
- # Bug Confirmation Templates
2
-
3
- ## Per-Bug Confirmation Template
4
-
5
- Present this after extracting and clarifying each bug:
6
-
7
- ```
8
- ┌─ Bug Confirmation: B-NNN ─────────────────────────────
9
- │ Title: <auto-suggested title>
10
- │ Description: <expected vs actual behavior>
11
- │ Severity: <auto-classified> | Verification: <type>
12
-
13
- │ Reproduction: <steps if available, or "not provided">
14
- │ Affected: <module/feature or "unknown">
15
-
16
- │ Acceptance Criteria (fix verified when):
17
- │ 1. <criterion — specific enough for automated pipeline to verify>
18
- │ 2. <criterion>
19
-
20
- │ Open Questions:
21
- │ - <any unclear points, or "None">
22
- └────────────────────────────────────────────────────────
23
- ```
24
-
25
- Then ask three confirmation questions:
26
- 1. "Is the description accurate? Any corrections?"
27
- 2. "Need to add more details? (reproduction steps, environment, related code locations, etc.)"
28
- 3. "Are the acceptance criteria specific enough that the pipeline can autonomously verify the fix?"
29
-
30
- Only finalize the bug entry after user confirms all three points.
31
-
32
- ## Completeness Review Template
33
-
34
- Display during Phase 4 pre-generation review:
35
-
36
- ```
37
- ┌─ Completeness Review ─────────────────────────────────────────────────
38
- │ Bug │ Description │ Criteria │ Reproducible │ Notes
39
- │ B-001 │ ✓ Clear │ ✓ Specific │ ✓ Yes │ —
40
- │ B-002 │ ⚠ Vague │ ⚠ Subjective│ ✓ Yes │ "encoding works" → needs specific test case
41
- │ B-003 │ ✓ Clear │ ⚠ No metric│ ⚠ No steps │ needs perf threshold + reproduction steps
42
- └────────────────────────────────────────────────────────────────────────
43
- ```
@@ -1,44 +0,0 @@
1
- # Adversarial Critic Review & Browser Verification
2
-
3
- ## Adversarial Critic Review (Testing Defaults)
4
-
5
- All bug fixes support optional critic review for additional quality assurance. The critic mechanism is disabled by default but can be enabled per-bug based on severity and complexity.
6
-
7
- ### Default Critic Behavior
8
-
9
- | Severity | `critic` | `critic_count` | Rationale |
10
- |----------|----------|----------------|-----------|
11
- | critical | `true` | `1` | Single critic review for critical bugs |
12
- | high | `true` | `1` | Single critic review for high-severity bugs |
13
- | medium | `false` | (omitted) | Skip critic for medium-severity bugs |
14
- | low | `false` | (omitted) | Skip critic for low-severity bugs |
15
-
16
- - `critic: true` — Enable adversarial review after fix implementation
17
- - `critic_count: 1` — Single critic agent reviews the fix
18
- - Critic verifies: fix addresses root cause, no regressions introduced, acceptance criteria met
19
-
20
- **User Override**: During Phase 2 or Phase 3, users can opt to enable/disable critic on a per-bug basis.
21
-
22
- ## Browser Verification
23
-
24
- **Browser verification is a feature-pipeline capability only.** Bug fixes use the `verification_type` field instead:
25
-
26
- - `verification_type: automated` — Use unit/integration tests to verify the fix
27
- - `verification_type: manual` — Describe manual testing steps in acceptance criteria (including any browser verification steps)
28
- - `verification_type: hybrid` — Combine automated tests with manual browser verification steps
29
-
30
- For UI-related bugs that require visual verification (e.g., "Button doesn't show error message"), describe the verification steps in acceptance criteria.
31
-
32
- ### Example
33
-
34
- ```
35
- Bug Title: Login error message not displaying
36
- Verification Type: manual
37
- Acceptance Criteria:
38
- 1. Navigate to /login with invalid credentials
39
- 2. Verify error message "Invalid email or password" appears below the email field
40
- 3. Verify error message is red (#FF0000)
41
- 4. Verify form fields are still enabled and can be re-submitted
42
- ```
43
-
44
- The bugfix pipeline AI will use these criteria during manual verification.
@@ -1,73 +0,0 @@
1
- # Error Recovery & Resume Support
2
-
3
- Reference document for bug-planner error handling and session recovery. Load this when validation fails, a session is interrupted, or existing artifacts are detected.
4
-
5
- ## Validation Failure Handling
6
-
7
- ### Warnings Only
8
-
9
- If `validate-bug-list.py` returns warnings but no errors:
10
- 1. Present warnings to user
11
- 2. Ask: "Proceed with these warnings, or fix them first?"
12
- 3. If user approves → write file and continue
13
- 4. If user wants fixes → address each warning, re-validate
14
-
15
- ### Errors Found
16
-
17
- If validation returns errors:
18
- 1. Group errors by type (missing fields, invalid values, duplicate IDs, broken references)
19
- 2. Auto-fix where possible:
20
- - Missing `status` → set to `pending`
21
- - Duplicate IDs → re-number with next sequential B-NNN
22
- - Invalid `priority` → re-derive from severity using the mapping table
23
- 3. Present fixes to user for confirmation
24
- 4. Re-validate after fixes
25
- 5. Maximum 3 total validation attempts — if still failing after 3 rounds, present the raw errors and ask user for guidance
26
-
27
- ### JSON Parse Failure
28
-
29
- If the generated JSON is malformed:
30
- 1. Do not write the file
31
- 2. Regenerate from the collected bug data (Phase 2-3 state)
32
- 3. Re-validate before writing
33
-
34
- ## Resume Support
35
-
36
- ### Checkpoint-Based Resumption
37
-
38
- When bug-planner detects existing artifacts, determine the last completed checkpoint and offer to resume:
39
-
40
- | Existing Artifact | Last Checkpoint | Resume From |
41
- |---|---|---|
42
- | `.prizmkit/plans/bug-fix-list.json` (valid) | CP-BP-5 | Offer: "Valid bug list exists. Append new bugs (Route B) or regenerate?" |
43
- | `.prizmkit/plans/bug-fix-list.json` (invalid) | CP-BP-4 | Re-run Phase 5 validation and fix |
44
- | `.prizmkit/plans/bug-fix-list.draft.json` | CP-BP-2 or CP-BP-3 | Load draft, determine phase from content completeness, resume |
45
- | `.prizmkit/config.json` with tech_stack | CP-BP-1 (partial) | Skip project context questions, start at Phase 2 |
46
- | No artifacts | — | Start from Phase 1 |
47
-
48
- ### Resume Detection Flow
49
-
50
- 1. Check for `.prizmkit/plans/bug-fix-list.json`
51
- - If exists and valid → offer Route B (append) or full regeneration
52
- - If exists but invalid → offer to fix and re-validate (resume from CP-BP-4)
53
- 2. Check for `.prizmkit/plans/bug-fix-list.draft.json`
54
- - If exists → load draft, count bugs with/without confirmation, resume from appropriate phase
55
- 3. Check for `.prizmkit/config.json`
56
- - If exists with tech_stack → skip Phase 1 context gathering
57
- 4. If no artifacts → start fresh (Route A)
58
-
59
- ### Session Interruption Recovery
60
-
61
- If a bug-planner session is interrupted mid-planning:
62
-
63
- 1. On next invocation, run the Resume Detection Flow above
64
- 2. If a draft exists, present: "Found a draft with N bugs from a previous session. Resume from where you left off, or start fresh?"
65
- 3. If user resumes → load draft state, skip completed phases
66
- 4. If user starts fresh → archive draft as `bug-fix-list.draft.TIMESTAMP.json`, begin Phase 1
67
-
68
- ## Draft Management
69
-
70
- - Save drafts to `.prizmkit/plans/bug-fix-list.draft.json` after each completed phase (CP-BP-1 through CP-BP-4)
71
- - Drafts use the same schema as the final file but may have incomplete fields
72
- - Delete draft after successful generation of the final `bug-fix-list.json`
73
- - Keep at most 1 draft — overwrite on each phase completion
@@ -1,53 +0,0 @@
1
- # Bug Input Format Detection & Extraction
2
-
3
- Auto-detect the user's input format and extract structured bug information accordingly.
4
-
5
- ## Format A: Stack Trace / Error Log
6
-
7
- ```
8
- TypeError: Cannot read property 'token' of null
9
- at AuthService.handleLogin (src/services/auth.ts:42)
10
- at LoginPage.onSubmit (src/pages/login.tsx:28)
11
- ```
12
-
13
- Extract: `error_source.type="stack_trace"`, `error_message`, `stack_trace`, `affected_modules`
14
-
15
- ## Format B: Natural Language User Report
16
-
17
- ```
18
- When I click the login button with correct credentials, the page turns white.
19
- Expected: redirect to home page.
20
- Actual: white screen with no error message visible.
21
- ```
22
-
23
- Extract: `error_source.type="user_report"`, `reproduction_steps`, `description` (expected vs actual)
24
-
25
- ## Format C: Failed Test Output
26
-
27
- ```
28
- FAIL src/services/__tests__/auth.test.ts
29
- ● AuthService > handleLogin > should return token on success
30
- Expected: "abc123"
31
- Received: null
32
- ```
33
-
34
- Extract: `error_source.type="failed_test"`, `failed_test_path`, `error_message`
35
-
36
- ## Format D: Log Pattern
37
-
38
- ```
39
- [2026-03-07 10:23:45] ERROR [auth-service] Connection timeout after 30000ms
40
- [2026-03-07 10:23:45] ERROR [auth-service] Failed to authenticate user: ETIMEDOUT
41
- [2026-03-07 10:23:46] ERROR [auth-service] Connection timeout after 30000ms
42
- ```
43
-
44
- Extract: `error_source.type="log_pattern"`, `log_snippet`, `affected_modules`
45
-
46
- ## Format E: Monitoring Alert
47
-
48
- ```
49
- ALERT: CPU usage > 95% for auth-service pod (5min avg)
50
- ALERT: Error rate spike: 500 errors/min on /api/login endpoint
51
- ```
52
-
53
- Extract: `error_source.type="monitoring_alert"`, `error_message`, `affected_modules`
@@ -1,25 +0,0 @@
1
- # Schema Validation Checklist
2
-
3
- Use this checklist for manual validation when `validate-bug-list.py` is not available. The script is the source of truth — this checklist mirrors its logic.
4
-
5
- ## Required Top-Level Fields
6
-
7
- - [ ] `$schema`: must be `"dev-pipeline-bug-fix-list-v1"`
8
- - [ ] `project_name`: non-empty string
9
- - [ ] `bugs`: non-empty array
10
-
11
- ## Per-Bug Required Fields
12
-
13
- - [ ] `id`: matches pattern `B-NNN` (e.g., `B-001`)
14
- - [ ] `title`: non-empty string
15
- - [ ] `description`: non-empty string
16
- - [ ] `severity`: one of `critical`, `high`, `medium`, `low`
17
- - [ ] `error_source.type`: one of `stack_trace`, `user_report`, `failed_test`, `log_pattern`, `monitoring_alert`
18
- - [ ] `verification_type`: one of `automated`, `manual`, `hybrid`
19
- - [ ] `acceptance_criteria`: non-empty array of strings
20
- - [ ] `status`: must be `pending` for new bugs
21
-
22
- ## Consistency Checks
23
-
24
- - [ ] No duplicate bug IDs
25
- - [ ] If `priority` is set, must be one of `high`, `medium`, `low`
@@ -1,16 +0,0 @@
1
- # Severity Auto-Classification Rules
2
-
3
- When extracting bugs, apply these rules to auto-suggest severity:
4
-
5
- | Severity | Indicators | Examples |
6
- |----------|------------|----------|
7
- | **critical** | System crash, data loss, security breach, OOM, unrecoverable error | `Segmentation fault`, `OutOfMemoryError`, `SQL injection vulnerability`, `Database corrupted` |
8
- | **high** | Core feature broken, authentication failure, data integrity issue, timeout | `Auth token invalid`, `Payment failed`, `Connection timeout`, `500 Internal Server Error` |
9
- | **medium** | Feature partially broken, workaround exists, incorrect output | `CSV encoding issue`, `Pagination not working`, `Wrong date format`, `Missing validation` |
10
- | **low** | Cosmetic issue, minor inconvenience, edge case | `UI misalignment`, `Typo in error message`, `Slow loading (non-critical page)`, `Non-breaking warning` |
11
-
12
- ## Special Cases
13
-
14
- - Failed test → medium (unless test covers critical path, then high)
15
- - User report with "cannot use app" → high
16
- - User report with "annoying but works" → low