prizmkit 1.1.99 → 1.1.101

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 (321) 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 +345 -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 +147 -0
  26. package/bundled/dev-pipeline/prizmkit_runtime/runners.py +422 -0
  27. package/bundled/dev-pipeline/prizmkit_runtime/sessions.py +552 -0
  28. package/bundled/dev-pipeline/prizmkit_runtime/status.py +71 -0
  29. package/bundled/dev-pipeline/scripts/check-session-status.py +74 -1
  30. package/bundled/dev-pipeline/scripts/continuation.py +374 -0
  31. package/bundled/dev-pipeline/scripts/generate-bootstrap-prompt.py +64 -52
  32. package/bundled/dev-pipeline/scripts/generate-bugfix-prompt.py +35 -25
  33. package/bundled/dev-pipeline/scripts/generate-recovery-prompt.py +2 -2
  34. package/bundled/dev-pipeline/scripts/generate-refactor-prompt.py +15 -20
  35. package/bundled/dev-pipeline/scripts/parse-stream-progress.py +185 -16
  36. package/bundled/dev-pipeline/scripts/update-bug-status.py +214 -6
  37. package/bundled/dev-pipeline/scripts/update-feature-status.py +237 -6
  38. package/bundled/dev-pipeline/scripts/update-refactor-status.py +214 -6
  39. package/bundled/dev-pipeline/templates/agent-prompts/dev-implement.md +8 -2
  40. package/bundled/dev-pipeline/templates/bootstrap-prompt.md +4 -0
  41. package/bundled/dev-pipeline/templates/bootstrap-tier1.md +14 -5
  42. package/bundled/dev-pipeline/templates/bootstrap-tier2.md +16 -6
  43. package/bundled/dev-pipeline/templates/bootstrap-tier3.md +16 -6
  44. package/bundled/dev-pipeline/templates/bugfix-bootstrap-prompt.md +1 -1
  45. package/bundled/dev-pipeline/templates/refactor-bootstrap-prompt.md +3 -3
  46. package/bundled/dev-pipeline/templates/sections/context-budget-rules.md +2 -0
  47. package/bundled/dev-pipeline/templates/sections/log-size-awareness.md +13 -69
  48. package/bundled/dev-pipeline/templates/sections/phase-context-snapshot-agent-suffix.md +15 -7
  49. package/bundled/dev-pipeline/templates/sections/phase-implement-agent.md +42 -29
  50. package/bundled/dev-pipeline/templates/sections/phase-implement-full.md +41 -39
  51. package/bundled/dev-pipeline/templates/sections/test-failure-recovery-agent.md +4 -0
  52. package/bundled/dev-pipeline/templates/sections/test-failure-recovery-lite.md +4 -0
  53. package/bundled/dev-pipeline/templates/session-status-schema.json +1 -1
  54. package/bundled/dev-pipeline/tests/conftest.py +1 -0
  55. package/bundled/dev-pipeline/tests/test_auto_skip.py +932 -0
  56. package/bundled/dev-pipeline/tests/test_generate_bootstrap_prompt.py +207 -0
  57. package/bundled/dev-pipeline/tests/test_generate_bugfix_prompt.py +100 -0
  58. package/bundled/dev-pipeline/tests/test_generate_refactor_prompt.py +43 -0
  59. package/bundled/dev-pipeline/tests/test_python_runner_parity.py +1138 -0
  60. package/bundled/dev-pipeline/tests/test_unified_cli.py +1045 -0
  61. package/bundled/skills/_metadata.json +1 -1
  62. package/bundled/skills/bugfix-pipeline-launcher/SKILL.md +29 -34
  63. package/bundled/skills/bugfix-pipeline-launcher/references/configuration.md +6 -5
  64. package/bundled/skills/feature-pipeline-launcher/SKILL.md +29 -35
  65. package/bundled/skills/feature-pipeline-launcher/references/configuration.md +7 -6
  66. package/bundled/skills/feature-workflow/SKILL.md +3 -6
  67. package/bundled/skills/recovery-workflow/SKILL.md +23 -32
  68. package/bundled/skills/refactor-pipeline-launcher/SKILL.md +29 -35
  69. package/bundled/skills/refactor-pipeline-launcher/references/configuration.md +7 -6
  70. package/bundled/skills/refactor-workflow/SKILL.md +3 -6
  71. package/bundled/templates/hooks/commit-intent.json +2 -2
  72. package/bundled/templates/hooks/diff-prizm-docs.py +226 -0
  73. package/bundled/templates/hooks/prizm-pre-commit.py +45 -0
  74. package/bundled/templates/hooks/validate-prizm-docs.py +240 -0
  75. package/package.json +1 -1
  76. package/src/config.js +33 -12
  77. package/src/index.js +3 -6
  78. package/src/manifest.js +3 -2
  79. package/src/metadata.js +7 -18
  80. package/src/prompts.js +0 -12
  81. package/src/runtimes.js +18 -11
  82. package/src/scaffold.js +133 -116
  83. package/src/upgrade.js +1 -1
  84. package/bundled/dev-pipeline/launch-bugfix-daemon.sh +0 -500
  85. package/bundled/dev-pipeline/launch-feature-daemon.sh +0 -657
  86. package/bundled/dev-pipeline/launch-refactor-daemon.sh +0 -502
  87. package/bundled/dev-pipeline/lib/branch.sh +0 -326
  88. package/bundled/dev-pipeline/lib/common.sh +0 -1257
  89. package/bundled/dev-pipeline/lib/heartbeat.sh +0 -469
  90. package/bundled/dev-pipeline/reset-bug.sh +0 -395
  91. package/bundled/dev-pipeline/reset-feature.sh +0 -406
  92. package/bundled/dev-pipeline/reset-refactor.sh +0 -393
  93. package/bundled/dev-pipeline/run-bugfix.sh +0 -1315
  94. package/bundled/dev-pipeline/run-feature.sh +0 -1602
  95. package/bundled/dev-pipeline/run-recovery.sh +0 -648
  96. package/bundled/dev-pipeline/run-refactor.sh +0 -1348
  97. package/bundled/dev-pipeline/scripts/monitor-log.sh +0 -104
  98. package/bundled/dev-pipeline/tests/test-path-resolution.sh +0 -100
  99. package/bundled/dev-pipeline-windows/.env.example +0 -36
  100. package/bundled/dev-pipeline-windows/README.md +0 -30
  101. package/bundled/dev-pipeline-windows/SCHEMA_ANALYSIS.md +0 -533
  102. package/bundled/dev-pipeline-windows/assets/feature-list-example.json +0 -146
  103. package/bundled/dev-pipeline-windows/assets/prizm-dev-team-integration.md +0 -137
  104. package/bundled/dev-pipeline-windows/launch-bugfix-daemon.ps1 +0 -9
  105. package/bundled/dev-pipeline-windows/launch-feature-daemon.ps1 +0 -9
  106. package/bundled/dev-pipeline-windows/launch-refactor-daemon.ps1 +0 -9
  107. package/bundled/dev-pipeline-windows/lib/branch.ps1 +0 -235
  108. package/bundled/dev-pipeline-windows/lib/common.ps1 +0 -829
  109. package/bundled/dev-pipeline-windows/lib/daemon.ps1 +0 -140
  110. package/bundled/dev-pipeline-windows/lib/pipeline.ps1 +0 -967
  111. package/bundled/dev-pipeline-windows/lib/reset.ps1 +0 -87
  112. package/bundled/dev-pipeline-windows/reset-bug.ps1 +0 -9
  113. package/bundled/dev-pipeline-windows/reset-feature.ps1 +0 -9
  114. package/bundled/dev-pipeline-windows/reset-refactor.ps1 +0 -9
  115. package/bundled/dev-pipeline-windows/run-bugfix.ps1 +0 -9
  116. package/bundled/dev-pipeline-windows/run-feature.ps1 +0 -9
  117. package/bundled/dev-pipeline-windows/run-recovery.ps1 +0 -179
  118. package/bundled/dev-pipeline-windows/run-refactor.ps1 +0 -9
  119. package/bundled/dev-pipeline-windows/scripts/check-session-status.py +0 -228
  120. package/bundled/dev-pipeline-windows/scripts/detect-stuck.py +0 -530
  121. package/bundled/dev-pipeline-windows/scripts/generate-bootstrap-prompt.py +0 -2282
  122. package/bundled/dev-pipeline-windows/scripts/generate-bugfix-prompt.py +0 -767
  123. package/bundled/dev-pipeline-windows/scripts/generate-recovery-prompt.py +0 -805
  124. package/bundled/dev-pipeline-windows/scripts/generate-refactor-prompt.py +0 -845
  125. package/bundled/dev-pipeline-windows/scripts/init-bugfix-pipeline.py +0 -316
  126. package/bundled/dev-pipeline-windows/scripts/init-dev-team.py +0 -134
  127. package/bundled/dev-pipeline-windows/scripts/init-pipeline.py +0 -382
  128. package/bundled/dev-pipeline-windows/scripts/init-refactor-pipeline.py +0 -399
  129. package/bundled/dev-pipeline-windows/scripts/monitor-log.ps1 +0 -102
  130. package/bundled/dev-pipeline-windows/scripts/parse-stream-progress.py +0 -1232
  131. package/bundled/dev-pipeline-windows/scripts/patch-completion-notes.py +0 -191
  132. package/bundled/dev-pipeline-windows/scripts/prizmkit-test-gate.py +0 -446
  133. package/bundled/dev-pipeline-windows/scripts/update-bug-status.py +0 -913
  134. package/bundled/dev-pipeline-windows/scripts/update-checkpoint.py +0 -173
  135. package/bundled/dev-pipeline-windows/scripts/update-feature-status.py +0 -1558
  136. package/bundled/dev-pipeline-windows/scripts/update-refactor-status.py +0 -1119
  137. package/bundled/dev-pipeline-windows/scripts/utils.py +0 -542
  138. package/bundled/dev-pipeline-windows/templates/agent-prompts/critic-plan-challenge.md +0 -7
  139. package/bundled/dev-pipeline-windows/templates/agent-prompts/dev-fix.md +0 -7
  140. package/bundled/dev-pipeline-windows/templates/agent-prompts/dev-implement.md +0 -65
  141. package/bundled/dev-pipeline-windows/templates/agent-prompts/dev-resume.md +0 -5
  142. package/bundled/dev-pipeline-windows/templates/agent-prompts/reviewer-review.md +0 -7
  143. package/bundled/dev-pipeline-windows/templates/bootstrap-prompt.md +0 -73
  144. package/bundled/dev-pipeline-windows/templates/bootstrap-tier1.md +0 -589
  145. package/bundled/dev-pipeline-windows/templates/bootstrap-tier2.md +0 -710
  146. package/bundled/dev-pipeline-windows/templates/bootstrap-tier3.md +0 -791
  147. package/bundled/dev-pipeline-windows/templates/bug-fix-list-schema.json +0 -263
  148. package/bundled/dev-pipeline-windows/templates/bugfix-bootstrap-prompt.md +0 -326
  149. package/bundled/dev-pipeline-windows/templates/feature-list-schema.json +0 -237
  150. package/bundled/dev-pipeline-windows/templates/refactor-bootstrap-prompt.md +0 -340
  151. package/bundled/dev-pipeline-windows/templates/refactor-list-schema.json +0 -270
  152. package/bundled/dev-pipeline-windows/templates/sections/ac-verification-checklist.md +0 -7
  153. package/bundled/dev-pipeline-windows/templates/sections/checkpoint-system.md +0 -91
  154. package/bundled/dev-pipeline-windows/templates/sections/context-budget-rules.md +0 -34
  155. package/bundled/dev-pipeline-windows/templates/sections/critical-paths-agent.md +0 -10
  156. package/bundled/dev-pipeline-windows/templates/sections/critical-paths-full.md +0 -12
  157. package/bundled/dev-pipeline-windows/templates/sections/critical-paths-lite.md +0 -7
  158. package/bundled/dev-pipeline-windows/templates/sections/directory-convention-agent.md +0 -8
  159. package/bundled/dev-pipeline-windows/templates/sections/directory-convention-full.md +0 -9
  160. package/bundled/dev-pipeline-windows/templates/sections/directory-convention-lite.md +0 -6
  161. package/bundled/dev-pipeline-windows/templates/sections/failure-capture.md +0 -21
  162. package/bundled/dev-pipeline-windows/templates/sections/feature-context.md +0 -21
  163. package/bundled/dev-pipeline-windows/templates/sections/log-size-awareness.md +0 -78
  164. package/bundled/dev-pipeline-windows/templates/sections/phase-browser-verification-auto.md +0 -283
  165. package/bundled/dev-pipeline-windows/templates/sections/phase-browser-verification-opencli.md +0 -112
  166. package/bundled/dev-pipeline-windows/templates/sections/phase-browser-verification.md +0 -168
  167. package/bundled/dev-pipeline-windows/templates/sections/phase-commit-full.md +0 -82
  168. package/bundled/dev-pipeline-windows/templates/sections/phase-commit.md +0 -75
  169. package/bundled/dev-pipeline-windows/templates/sections/phase-context-snapshot-agent-suffix.md +0 -23
  170. package/bundled/dev-pipeline-windows/templates/sections/phase-context-snapshot-base.md +0 -14
  171. package/bundled/dev-pipeline-windows/templates/sections/phase-context-snapshot-lite-suffix.md +0 -19
  172. package/bundled/dev-pipeline-windows/templates/sections/phase-critic-plan-full.md +0 -63
  173. package/bundled/dev-pipeline-windows/templates/sections/phase-critic-plan.md +0 -42
  174. package/bundled/dev-pipeline-windows/templates/sections/phase-implement-agent.md +0 -44
  175. package/bundled/dev-pipeline-windows/templates/sections/phase-implement-full.md +0 -59
  176. package/bundled/dev-pipeline-windows/templates/sections/phase-implement-lite.md +0 -39
  177. package/bundled/dev-pipeline-windows/templates/sections/phase-plan-agent.md +0 -27
  178. package/bundled/dev-pipeline-windows/templates/sections/phase-plan-lite.md +0 -27
  179. package/bundled/dev-pipeline-windows/templates/sections/phase-prizmkit-test.md +0 -39
  180. package/bundled/dev-pipeline-windows/templates/sections/phase-review-agent.md +0 -35
  181. package/bundled/dev-pipeline-windows/templates/sections/phase-review-full.md +0 -35
  182. package/bundled/dev-pipeline-windows/templates/sections/phase-specify-plan-full.md +0 -73
  183. package/bundled/dev-pipeline-windows/templates/sections/phase0-init.md +0 -13
  184. package/bundled/dev-pipeline-windows/templates/sections/phase0-test-baseline.md +0 -21
  185. package/bundled/dev-pipeline-windows/templates/sections/session-context.md +0 -5
  186. package/bundled/dev-pipeline-windows/templates/sections/subagent-timeout-recovery.md +0 -6
  187. package/bundled/dev-pipeline-windows/templates/sections/task-contract.md +0 -34
  188. package/bundled/dev-pipeline-windows/templates/sections/test-failure-recovery-agent.md +0 -48
  189. package/bundled/dev-pipeline-windows/templates/sections/test-failure-recovery-lite.md +0 -48
  190. package/bundled/dev-pipeline-windows/templates/session-status-schema.json +0 -83
  191. package/bundled/skills-windows/app-planner/SKILL.md +0 -296
  192. package/bundled/skills-windows/app-planner/assets/app-design-guide.md +0 -101
  193. package/bundled/skills-windows/app-planner/references/architecture-decisions.md +0 -52
  194. package/bundled/skills-windows/app-planner/references/brainstorm-guide.md +0 -101
  195. package/bundled/skills-windows/app-planner/references/frontend-design-guide.md +0 -71
  196. package/bundled/skills-windows/app-planner/references/infrastructure-convention-discovery.md +0 -108
  197. package/bundled/skills-windows/app-planner/references/project-brief-guide.md +0 -82
  198. package/bundled/skills-windows/app-planner/references/project-conventions-discovery.md +0 -59
  199. package/bundled/skills-windows/app-planner/references/project-state-detection.md +0 -90
  200. package/bundled/skills-windows/app-planner/references/red-team-checklist.md +0 -40
  201. package/bundled/skills-windows/app-planner/references/rules/backend/derivation-rules.md +0 -619
  202. package/bundled/skills-windows/app-planner/references/rules/backend/fixed-rules.md +0 -285
  203. package/bundled/skills-windows/app-planner/references/rules/backend/question-bank.md +0 -249
  204. package/bundled/skills-windows/app-planner/references/rules/backend/question-manifest.json +0 -46
  205. package/bundled/skills-windows/app-planner/references/rules/backend/template.md +0 -173
  206. package/bundled/skills-windows/app-planner/references/rules/database/derivation-rules.md +0 -382
  207. package/bundled/skills-windows/app-planner/references/rules/database/fixed-rules.md +0 -211
  208. package/bundled/skills-windows/app-planner/references/rules/database/question-bank.md +0 -184
  209. package/bundled/skills-windows/app-planner/references/rules/database/question-manifest.json +0 -39
  210. package/bundled/skills-windows/app-planner/references/rules/database/template.md +0 -158
  211. package/bundled/skills-windows/app-planner/references/rules/frontend/derivation-rules.md +0 -820
  212. package/bundled/skills-windows/app-planner/references/rules/frontend/fixed-rules.md +0 -188
  213. package/bundled/skills-windows/app-planner/references/rules/frontend/question-bank.md +0 -319
  214. package/bundled/skills-windows/app-planner/references/rules/frontend/question-manifest.json +0 -51
  215. package/bundled/skills-windows/app-planner/references/rules/frontend/template.md +0 -339
  216. package/bundled/skills-windows/app-planner/references/rules/mobile/derivation-rules.md +0 -649
  217. package/bundled/skills-windows/app-planner/references/rules/mobile/fixed-rules.md +0 -290
  218. package/bundled/skills-windows/app-planner/references/rules/mobile/question-bank.md +0 -232
  219. package/bundled/skills-windows/app-planner/references/rules/mobile/question-manifest.json +0 -47
  220. package/bundled/skills-windows/app-planner/references/rules/mobile/template.md +0 -175
  221. package/bundled/skills-windows/app-planner/references/rules-configuration.md +0 -46
  222. package/bundled/skills-windows/bug-fix-workflow/SKILL.md +0 -379
  223. package/bundled/skills-windows/bug-fix-workflow/references/bug-diagnosis.md +0 -41
  224. package/bundled/skills-windows/bug-planner/SKILL.md +0 -402
  225. package/bundled/skills-windows/bug-planner/assets/bug-confirmation-template.md +0 -43
  226. package/bundled/skills-windows/bug-planner/references/critic-and-verification.md +0 -44
  227. package/bundled/skills-windows/bug-planner/references/error-recovery.md +0 -73
  228. package/bundled/skills-windows/bug-planner/references/input-formats.md +0 -53
  229. package/bundled/skills-windows/bug-planner/references/schema-validation.md +0 -25
  230. package/bundled/skills-windows/bug-planner/references/severity-rules.md +0 -16
  231. package/bundled/skills-windows/bug-planner/scripts/validate-bug-list.py +0 -322
  232. package/bundled/skills-windows/bugfix-pipeline-launcher/SKILL.md +0 -304
  233. package/bundled/skills-windows/bugfix-pipeline-launcher/references/configuration.md +0 -84
  234. package/bundled/skills-windows/feature-pipeline-launcher/SKILL.md +0 -381
  235. package/bundled/skills-windows/feature-pipeline-launcher/references/configuration.md +0 -67
  236. package/bundled/skills-windows/feature-pipeline-launcher/scripts/preflight-check.py +0 -462
  237. package/bundled/skills-windows/feature-planner/SKILL.md +0 -397
  238. package/bundled/skills-windows/feature-planner/assets/evaluation-guide.md +0 -64
  239. package/bundled/skills-windows/feature-planner/assets/planning-guide.md +0 -214
  240. package/bundled/skills-windows/feature-planner/references/browser-interaction.md +0 -59
  241. package/bundled/skills-windows/feature-planner/references/completeness-review.md +0 -57
  242. package/bundled/skills-windows/feature-planner/references/decomposition-patterns.md +0 -75
  243. package/bundled/skills-windows/feature-planner/references/error-recovery.md +0 -90
  244. package/bundled/skills-windows/feature-planner/references/incremental-feature-planning.md +0 -112
  245. package/bundled/skills-windows/feature-planner/references/new-project-planning.md +0 -85
  246. package/bundled/skills-windows/feature-planner/scripts/validate-and-generate.py +0 -1020
  247. package/bundled/skills-windows/feature-workflow/SKILL.md +0 -374
  248. package/bundled/skills-windows/feature-workflow/references/brainstorm-guide.md +0 -137
  249. package/bundled/skills-windows/prizm-kit/SKILL.md +0 -93
  250. package/bundled/skills-windows/prizmkit-code-review/SKILL.md +0 -161
  251. package/bundled/skills-windows/prizmkit-code-review/references/dev-agent-prompt.md +0 -30
  252. package/bundled/skills-windows/prizmkit-code-review/references/review-report-template.md +0 -31
  253. package/bundled/skills-windows/prizmkit-code-review/references/reviewer-agent-prompt.md +0 -66
  254. package/bundled/skills-windows/prizmkit-code-review/scripts/check_loop.py +0 -186
  255. package/bundled/skills-windows/prizmkit-committer/SKILL.md +0 -89
  256. package/bundled/skills-windows/prizmkit-deploy/SKILL.md +0 -444
  257. package/bundled/skills-windows/prizmkit-deploy/references/ci-cd-workflows.md +0 -115
  258. package/bundled/skills-windows/prizmkit-deploy/references/cloud-platform-deploy.md +0 -93
  259. package/bundled/skills-windows/prizmkit-deploy/references/data-safety-examples.md +0 -120
  260. package/bundled/skills-windows/prizmkit-deploy/references/database-setup.md +0 -46
  261. package/bundled/skills-windows/prizmkit-deploy/references/deploy-config-schema.md +0 -148
  262. package/bundled/skills-windows/prizmkit-deploy/references/deploy-history-schema.md +0 -62
  263. package/bundled/skills-windows/prizmkit-deploy/references/deployment-modes.md +0 -50
  264. package/bundled/skills-windows/prizmkit-deploy/references/direct-upload.md +0 -26
  265. package/bundled/skills-windows/prizmkit-deploy/references/dns-setup.md +0 -42
  266. package/bundled/skills-windows/prizmkit-deploy/references/docker-deploy.md +0 -31
  267. package/bundled/skills-windows/prizmkit-deploy/references/firewall-setup.md +0 -37
  268. package/bundled/skills-windows/prizmkit-deploy/references/live-validation-notes.md +0 -21
  269. package/bundled/skills-windows/prizmkit-deploy/references/nginx-blue-green.md +0 -59
  270. package/bundled/skills-windows/prizmkit-deploy/references/ssh-bootstrap-flow.md +0 -49
  271. package/bundled/skills-windows/prizmkit-deploy/references/ssh-execution-flow.md +0 -41
  272. package/bundled/skills-windows/prizmkit-deploy/references/ssh-takeover.md +0 -20
  273. package/bundled/skills-windows/prizmkit-deploy/references/ssl-setup.md +0 -56
  274. package/bundled/skills-windows/prizmkit-implement/SKILL.md +0 -71
  275. package/bundled/skills-windows/prizmkit-init/SKILL.md +0 -356
  276. package/bundled/skills-windows/prizmkit-init/assets/project-brief-template.md +0 -82
  277. package/bundled/skills-windows/prizmkit-init/references/config-schema.md +0 -70
  278. package/bundled/skills-windows/prizmkit-init/references/rules/layer-detection.md +0 -41
  279. package/bundled/skills-windows/prizmkit-init/references/tech-stack-catalog.md +0 -13
  280. package/bundled/skills-windows/prizmkit-init/references/update-supplement.md +0 -9
  281. package/bundled/skills-windows/prizmkit-plan/SKILL.md +0 -102
  282. package/bundled/skills-windows/prizmkit-plan/assets/plan-template.md +0 -115
  283. package/bundled/skills-windows/prizmkit-plan/assets/spec-template.md +0 -73
  284. package/bundled/skills-windows/prizmkit-plan/references/clarify-guide.md +0 -67
  285. package/bundled/skills-windows/prizmkit-plan/references/examples.md +0 -85
  286. package/bundled/skills-windows/prizmkit-plan/references/verification-checklist.md +0 -60
  287. package/bundled/skills-windows/prizmkit-prizm-docs/SKILL.md +0 -129
  288. package/bundled/skills-windows/prizmkit-prizm-docs/assets/prizm-docs-format.md +0 -613
  289. package/bundled/skills-windows/prizmkit-prizm-docs/references/op-init.md +0 -45
  290. package/bundled/skills-windows/prizmkit-prizm-docs/references/op-rebuild.md +0 -15
  291. package/bundled/skills-windows/prizmkit-prizm-docs/references/op-status.md +0 -14
  292. package/bundled/skills-windows/prizmkit-prizm-docs/references/op-update.md +0 -19
  293. package/bundled/skills-windows/prizmkit-prizm-docs/references/op-validate.md +0 -17
  294. package/bundled/skills-windows/prizmkit-retrospective/SKILL.md +0 -87
  295. package/bundled/skills-windows/prizmkit-retrospective/references/knowledge-injection-steps.md +0 -50
  296. package/bundled/skills-windows/prizmkit-retrospective/references/structural-sync-steps.md +0 -43
  297. package/bundled/skills-windows/prizmkit-test/SKILL.md +0 -227
  298. package/bundled/skills-windows/prizmkit-test/references/boundary-coverage-protocol.md +0 -220
  299. package/bundled/skills-windows/prizmkit-test/references/examples.md +0 -143
  300. package/bundled/skills-windows/prizmkit-test/references/service-boundary-test-catalog.md +0 -225
  301. package/bundled/skills-windows/prizmkit-test/references/test-generation-steps.md +0 -109
  302. package/bundled/skills-windows/prizmkit-test/references/test-report-template.md +0 -111
  303. package/bundled/skills-windows/prizmkit-test/scripts/validate_boundary_report.py +0 -347
  304. package/bundled/skills-windows/recovery-workflow/SKILL.md +0 -355
  305. package/bundled/skills-windows/recovery-workflow/evals/evals.json +0 -46
  306. package/bundled/skills-windows/recovery-workflow/references/detection.md +0 -58
  307. package/bundled/skills-windows/recovery-workflow/scripts/detect-recovery-state.py +0 -544
  308. package/bundled/skills-windows/refactor-pipeline-launcher/SKILL.md +0 -346
  309. package/bundled/skills-windows/refactor-pipeline-launcher/references/configuration.md +0 -72
  310. package/bundled/skills-windows/refactor-planner/SKILL.md +0 -398
  311. package/bundled/skills-windows/refactor-planner/assets/planning-guide.md +0 -292
  312. package/bundled/skills-windows/refactor-planner/references/behavior-preservation.md +0 -301
  313. package/bundled/skills-windows/refactor-planner/references/fast-path.md +0 -59
  314. package/bundled/skills-windows/refactor-planner/references/planning-phases.md +0 -135
  315. package/bundled/skills-windows/refactor-planner/references/refactor-scoping-guide.md +0 -221
  316. package/bundled/skills-windows/refactor-planner/scripts/validate-and-generate-refactor.py +0 -858
  317. package/bundled/skills-windows/refactor-workflow/SKILL.md +0 -343
  318. package/bundled/skills-windows/refactor-workflow/references/brainstorm-guide.md +0 -116
  319. package/bundled/templates/hooks/diff-prizm-docs.sh +0 -158
  320. package/bundled/templates/hooks/prizm-pre-commit.sh +0 -108
  321. package/bundled/templates/hooks/validate-prizm-docs.sh +0 -139
@@ -1,533 +0,0 @@
1
- # Dev-Pipeline Schema Analysis Report
2
-
3
- ## Executive Summary
4
-
5
- This report analyzes three JSON schemas used by the PrizmKit Dev-Pipeline:
6
- 1. **Feature List Schema** (`feature-list-schema.json`) - for feature tracking
7
- 2. **Bug Fix List Schema** (`bug-fix-list-schema.json`) - for bug fix tracking
8
- 3. **Refactor List Schema** (`refactor-list-schema.json`) - for refactor tracking
9
-
10
- ## 1. ROOT-LEVEL PROPERTIES
11
-
12
- ### Common Root Properties (All 3 Schemas)
13
-
14
- | Property | Type | Required | Enum Values | Notes |
15
- |----------|------|----------|-------------|-------|
16
- | `$schema` | string | YES | Feature: `"dev-pipeline-feature-list-v1"` | Each schema has unique constant value |
17
- | | | | Bug: `"dev-pipeline-bug-fix-list-v1"` | |
18
- | | | | Refactor: `"dev-pipeline-refactor-list-v1"` | |
19
- | `project_name` | string | YES | N/A | minLength: 1 |
20
- | `project_description` | string | NO | N/A | Optional in all |
21
- | `created_at` | string | NO | N/A | ISO format (date-time) |
22
- | `created_by` | string | NO | N/A | Optional in all |
23
- | `global_context` | object | NO | N/A | See section 3 |
24
-
25
- ### Schema-Specific Root Properties
26
-
27
- | Property | Schema | Type | Required |
28
- |----------|--------|------|----------|
29
- | `source_spec` | Feature Only | string | NO |
30
- | `features` | Feature | array | YES |
31
- | `bugs` | Bug Fix | array | YES |
32
- | `refactors` | Refactor | array | YES |
33
-
34
- **Items Constraints:**
35
- - Feature: `minItems: 1`
36
- - Bug Fix: `minItems: 1`
37
- - Refactor: `minItems: 1`
38
-
39
- ---
40
-
41
- ## 2. ITEM-LEVEL PROPERTIES (Key Differences)
42
-
43
- ### Feature Item
44
-
45
- **Required fields:**
46
- ```
47
- id, title, description, priority, dependencies, acceptance_criteria, status
48
- ```
49
-
50
- **Optional fields:**
51
- ```
52
- estimated_complexity, session_granularity, sub_features, model, critic,
53
- critic_count, completion_notes, browser_interaction
54
- ```
55
-
56
- | Property | Type | Enum/Pattern | Notes |
57
- |----------|------|--------------|-------|
58
- | `id` | string | Pattern: `^F-\d{3}(-[A-Z])?$` | F-001, F-001-A, etc. |
59
- | `title` | string | N/A | minLength: 1 |
60
- | `description` | string | N/A | minLength: 1 |
61
- | `priority` | string | `critical, high, medium, low` | ✓ REQUIRED |
62
- | `dependencies` | array | Pattern: `^F-\d{3}(-[A-Z])?$` | Array of feature IDs |
63
- | `acceptance_criteria` | array | N/A | minItems: 1, array of strings |
64
- | `status` | string | `pending, in_progress, completed, failed, skipped, split, auto_skipped` | ✓ REQUIRED |
65
- | `estimated_complexity` | string | `low, medium, high` | Optional |
66
- | `session_granularity` | string | `feature, sub_feature, auto` | Default: `"feature"` |
67
- | `sub_features` | array | N/A | Objects with id, title, description |
68
- | `model` | string | N/A | AI model override |
69
- | `critic` | boolean | N/A | Default: `false` |
70
- | `critic_count` | integer | `1, 3` | Enum: single or multi-critic |
71
- | `completion_notes` | array | N/A | Array of strings, AI-generated summaries |
72
- | `browser_interaction` | object | N/A | Config for UI verification (requires playwright) |
73
-
74
- ### Bug Fix Item
75
-
76
- **Required fields:**
77
- ```
78
- id, title, description, severity, error_source, verification_type,
79
- acceptance_criteria, status
80
- ```
81
-
82
- **Optional fields:**
83
- ```
84
- priority, affected_feature, affected_modules, environment, critic,
85
- critic_count, model
86
- ```
87
-
88
- | Property | Type | Enum/Pattern | Notes |
89
- |----------|------|--------------|-------|
90
- | `id` | string | Pattern: `^B-\d{3}$` | B-001, B-002, etc. |
91
- | `title` | string | N/A | minLength: 1 - brief symptom description |
92
- | `description` | string | N/A | minLength: 1 - detailed: expected vs actual |
93
- | `severity` | string | `critical, high, medium, low` | ✓ REQUIRED; maps to priority |
94
- | `priority` | string | `high, medium, low` | Optional; derived from severity; NOT critical |
95
- | `error_source` | object | type enum: `stack_trace, user_report, failed_test, log_pattern, monitoring_alert` | ✓ REQUIRED |
96
- | `verification_type` | string | `automated, manual, hybrid` | ✓ REQUIRED |
97
- | `acceptance_criteria` | array | N/A | minItems: 1 |
98
- | `status` | string | `pending, triaging, reproducing, fixing, verifying, completed, failed, needs_info, skipped` | ✓ REQUIRED; more states than Feature |
99
- | `affected_feature` | string | Pattern: `^F-\d{3}(-[A-Z])?$` | Optional; link to original feature |
100
- | `affected_modules` | array | N/A | Optional; module names |
101
- | `environment` | object | N/A | Optional; os, runtime, browser, version |
102
- | `critic` | boolean | N/A | Default: `false` (true for high severity) |
103
- | `critic_count` | integer | `1, 3` | Optional; only if critic=true |
104
- | `model` | string | N/A | AI model override |
105
-
106
- ### Refactor Item
107
-
108
- **Required fields:**
109
- ```
110
- id, title, description, scope, type, priority, complexity,
111
- behavior_preservation, acceptance_criteria, dependencies, status
112
- ```
113
-
114
- **Optional fields:**
115
- ```
116
- model, estimated_lines, completion_notes, critic, critic_count
117
- ```
118
-
119
- | Property | Type | Enum/Pattern | Notes |
120
- |----------|------|--------------|-------|
121
- | `id` | string | Pattern: `^R-\d{3}$` | R-001, R-002, etc. |
122
- | `title` | string | N/A | minLength: 1 |
123
- | `description` | string | N/A | minLength: 1 |
124
- | `scope` | object | N/A | Files and modules affected |
125
- | `type` | string | `extract, rename, restructure, simplify, decouple, migrate` | ✓ REQUIRED; specific refactor type |
126
- | `priority` | string | `critical, high, medium, low` | ✓ REQUIRED |
127
- | `complexity` | string | `low, medium, high` | ✓ REQUIRED |
128
- | `behavior_preservation` | object | strategy: `test-gate, snapshot, manual` | ✓ REQUIRED object |
129
- | `acceptance_criteria` | array | N/A | minItems: 1 |
130
- | `dependencies` | array | Pattern: `^R-\d{3}$` | ✓ REQUIRED; array of refactor IDs only |
131
- | `status` | string | `pending, in_progress, completed, failed, skipped` | ✓ REQUIRED; simpler than Bug |
132
- | `model` | string | N/A | AI model override |
133
- | `estimated_lines` | integer | N/A | Optional |
134
- | `completion_notes` | array | N/A | AI-generated summaries |
135
- | `critic` | boolean | N/A | Default: `false` (true for critical/high) |
136
- | `critic_count` | integer | `1, 3` | Default: 3 for critical, 1 for high |
137
-
138
- ---
139
-
140
- ## 3. GLOBAL_CONTEXT OBJECT (Shared Structure)
141
-
142
- **Location:** Root-level, optional in all 3 schemas
143
-
144
- **Properties (all optional):**
145
- ```
146
- tech_stack, language, runtime, frontend_framework, frontend_styling,
147
- backend_framework, database, orm, testing_strategy, bundler, project_type
148
- ```
149
-
150
- **Bug Fix & Refactor Only (NOT in Feature):**
151
- ```
152
- design_system, ci_pipeline
153
- ```
154
-
155
- ### Field Details
156
-
157
- | Property | Type | Present In |
158
- |----------|------|-----------|
159
- | `tech_stack` | string | All 3 |
160
- | `language` | string | All 3 |
161
- | `runtime` | string | All 3 |
162
- | `frontend_framework` | string | All 3 |
163
- | `frontend_styling` | string | All 3 |
164
- | `backend_framework` | string | All 3 |
165
- | `database` | string | All 3 |
166
- | `orm` | string | All 3 |
167
- | `testing_strategy` | string | All 3 |
168
- | `bundler` | string | All 3 |
169
- | `project_type` | string | All 3 |
170
- | `design_system` | string | Bug Fix + Refactor ONLY ❌ Feature |
171
- | `ci_pipeline` | string | Bug Fix + Refactor ONLY ❌ Feature |
172
-
173
- ---
174
-
175
- ## 4. KEY INCONSISTENCIES & SCHEMA DIFFERENCES
176
-
177
- ### 4.1 ID Pattern Inconsistencies
178
-
179
- | Schema | ID Pattern | Example |
180
- |--------|-----------|---------|
181
- | Feature | `^F-\d{3}(-[A-Z])?$` | F-001, F-001-A ✓ Allows sub-feature suffixes |
182
- | Bug Fix | `^B-\d{3}$` | B-001 ✗ NO suffixes allowed |
183
- | Refactor | `^R-\d{3}$` | R-001 ✗ NO suffixes allowed |
184
-
185
- **Finding:** Only Features support sub-IDs with `-[A-Z]` suffix. This is intentional (features can split into sub_features).
186
-
187
- ### 4.2 Priority vs Severity (Bug Fix Only)
188
-
189
- **Feature & Refactor:** Direct `priority` enum
190
- ```
191
- "priority": ["critical", "high", "medium", "low"]
192
- ```
193
-
194
- **Bug Fix:** Has BOTH `severity` and `priority`
195
- ```
196
- "severity": ["critical", "high", "medium", "low"] ← ✓ REQUIRED
197
- "priority": ["high", "medium", "low"] ← ✗ NO "critical" option
198
- ```
199
-
200
- **Issue:** Bug Fix severity has "critical" but priority doesn't. Pipeline docs state:
201
- > "Both critical and high severity map to high priority"
202
-
203
- **Impact:** When deserializing a bug with severity="critical", pipeline must map to priority="high" (not preserved).
204
-
205
- ### 4.3 Status Enums - Feature vs Bug vs Refactor
206
-
207
- **Feature Status (7 values):**
208
- ```
209
- pending, in_progress, completed, failed, skipped, split, auto_skipped
210
- ```
211
-
212
- **Bug Fix Status (9 values):**
213
- ```
214
- pending, triaging, reproducing, fixing, verifying, completed, failed, needs_info, skipped
215
- ```
216
- *Includes intermediate workflow states: triaging, reproducing, fixing, verifying, needs_info*
217
- *NO "split" or "auto_skipped"*
218
-
219
- **Refactor Status (5 values):**
220
- ```
221
- pending, in_progress, completed, failed, skipped
222
- ```
223
- *Simplest; no workflow states*
224
-
225
- ### 4.4 Dependencies Pattern
226
-
227
- | Schema | Dependencies | Pattern |
228
- |--------|--------------|---------|
229
- | Feature | `dependencies` (required) | `^F-\d{3}(-[A-Z])?$` - can reference sub-features |
230
- | Bug Fix | N/A | No `dependencies` field ❌ |
231
- | Refactor | `dependencies` (required) | `^R-\d{3}$` - ONLY refactor IDs, no sub-IDs |
232
-
233
- **Issue:** Bug Fix schema lacks dependency tracking. Bugs cannot declare prerequisites. Feature dependencies support sub-features; Refactor dependencies do not.
234
-
235
- ### 4.5 Acceptance Criteria vs Task Lists
236
-
237
- | Schema | AC Field | Type | Notes |
238
- |--------|----------|------|-------|
239
- | Feature | `acceptance_criteria` | array of strings | minItems: 1, manually written |
240
- | Bug Fix | `acceptance_criteria` | array of strings | minItems: 1, fix verification criteria |
241
- | Refactor | `acceptance_criteria` | array of strings | minItems: 1, completion criteria |
242
-
243
- **Finding:** All use same field name & structure. AC format is schema-agnostic.
244
-
245
- ### 4.6 Critic Configuration Differences
246
-
247
- | Schema | Critic Default | Critic Count Default | Notes |
248
- |--------|-----------------|----------------------|-------|
249
- | Feature | `false` | 1 | Per-feature override possible |
250
- | Bug Fix | `false` for most; `true` for "high severity"` | 1 for high severity; omit for others | Special logic: high severity → critic=true |
251
- | Refactor | `false` (explicit); `true` for "critical/high"` | 3 for critical; 1 for high; omit for others | Special defaults: critical→3 critics, high→1 |
252
-
253
- **Finding:** Refactor has the strictest critic defaults (auto-enable for critical/high). Bug Fix has conditional enable (high severity only). Feature has manual opt-in.
254
-
255
- ### 4.7 Schema-Specific Features
256
-
257
- #### Feature Only
258
- - `sub_features` (nested array of objects)
259
- - `session_granularity` (feature, sub_feature, auto)
260
- - `browser_interaction` (UI verification config)
261
- - `source_spec` (root-level, source spec reference)
262
-
263
- #### Bug Fix Only
264
- - `severity` (critical, high, medium, low)
265
- - `error_source` (object: type + metadata - stack_trace, user_report, etc.)
266
- - `affected_feature` (F-ID reference)
267
- - `affected_modules` (array of module names)
268
- - `environment` (os, runtime, browser, version)
269
-
270
- #### Refactor Only
271
- - `type` (extract, rename, restructure, simplify, decouple, migrate)
272
- - `behavior_preservation` (strategy: test-gate, snapshot, manual)
273
- - `estimated_lines` (integer, lines of code affected)
274
-
275
- #### All Three
276
- - `id`, `title`, `description`
277
- - `priority` (with caveats for Bug Fix)
278
- - `acceptance_criteria`
279
- - `status`
280
- - `model` (AI model override)
281
- - `critic`, `critic_count`
282
- - `completion_notes`
283
-
284
- ### 4.8 Global Context Discrepancies
285
-
286
- **Feature's global_context is MISSING:**
287
- - `design_system` ❌ (present in Bug Fix & Refactor)
288
- - `ci_pipeline` ❌ (present in Bug Fix & Refactor)
289
-
290
- **Why?** Legacy inconsistency. Feature schema predates Bug Fix / Refactor and wasn't updated.
291
-
292
- **Risk:** If a codebase tries to unify global_context across all three, it must handle optional fields conditionally.
293
-
294
- ---
295
-
296
- ## 5. TEMPLATE DIRECTORY STRUCTURE
297
-
298
- ### Critical Paths Files
299
-
300
- **Three variants exist for each concept:**
301
-
302
- | Concept | Files | Scope |
303
- |---------|-------|-------|
304
- | Critical Paths | `critical-paths-full.md`, `critical-paths-lite.md`, `critical-paths-agent.md` | Different detail levels |
305
- | Directory Convention | `directory-convention-full.md`, `directory-convention-lite.md`, `directory-convention-agent.md` | Lite vs Full vs Agent mode |
306
- | Phase Context Snapshot | `phase-context-snapshot-base.md`, `phase-context-snapshot-lite-suffix.md`, `phase-context-snapshot-agent-suffix.md` | Suffix variants for modes |
307
- | Phase Implementation | `phase-implement-lite.md`, `phase-implement-full.md`, `phase-implement-agent.md` | Three execution modes |
308
- | Phase Review | `phase-review-full.md`, `phase-review-agent.md` | Full & Agent variants |
309
- | Phase Plan | `phase-plan-lite.md`, `phase-plan-agent.md` | Lite & Agent variants |
310
- | Phase Critic | `phase-critic-plan.md`, `phase-critic-plan-full.md` | Plan review (single and multi) |
311
- | Phase Commit | `phase-commit.md`, `phase-commit-full.md` | Standard & Full variants |
312
-
313
- ### Singleton Sections
314
-
315
- | File | Purpose |
316
- |------|---------|
317
- | `failure-capture.md` | Failure logging protocol |
318
- | `session-context.md` | Session metadata template |
319
- | `subagent-timeout-recovery.md` | Recovery on agent timeout |
320
- | `test-failure-recovery.md` | Test failure handling |
321
- | `checkpoint-system.md` | Workflow checkpoint tracking |
322
- | `phase0-init.md` | Project bootstrap |
323
- | `phase0-test-baseline.md` | Baseline test detection |
324
- | `resume-header.md` | Resume from phase template |
325
- | `failure-log-check.md` | Failure log diagnostics |
326
- | `context-budget-rules.md` | Context window guardrails |
327
- | `phase-browser-verification.md` | Playwright UI verification |
328
- | `phase-deploy-verification.md` | [DEPRECATED] Local deployment check (template removed) |
329
- | `ac-verification-checklist.md` | Acceptance criteria verification |
330
- | `feature-context.md` | Feature brief context |
331
- | `phase-specify-plan-full.md` | Full spec + plan workflow |
332
-
333
- ### Total Section Files: 36 markdown templates
334
-
335
- ---
336
-
337
- ## 6. ENVIRONMENT CONFIGURATION (.env.example)
338
-
339
- **Key Environment Variables:**
340
-
341
- | Variable | Type | Default | Scope |
342
- |----------|------|---------|-------|
343
- | `AI_CLI` | string | auto-detect | codex, claude, or cbc |
344
- | `MODEL` | string | (unset) | AI model override (per-task overrides this) |
345
- | `MAX_RETRIES` | integer | (not specified) | Retry attempts per task |
346
- | `VERBOSE` | integer | (not specified) | 1=on, 0=off |
347
- | `HEARTBEAT_INTERVAL` | integer | 30 | Poll interval for session progress/stale checks |
348
- | `STALE_KILL_THRESHOLD` | integer | 900 | Auto-kill after N seconds without parent log progress; 0 disables |
349
- | `STALE_KILL_GRACE_SECONDS` | integer | 10 | Grace period after stale-kill before force-stopping |
350
- | `CODEX_WAIT_STALE_KILL_THRESHOLD` | integer | 3600 | Longer no-log stale window while Codex waits on subagents |
351
- | `CODEX_SUBAGENT_TIMEOUT_SECONDS` | integer | 3300 | Codex subagent max runtime |
352
- | `STOP_ON_FAILURE` | boolean | 0 | Stop after a task exhausts retries |
353
- | `ENABLE_DEPLOY` | boolean | 0 | Start deploy session after all tasks complete |
354
- | `DEV_BRANCH` | string | auto-generated | Optional custom dev branch name |
355
- | `AUTO_PUSH` | boolean | 0 | Push original branch after successful merge |
356
- | `ENABLE_CRITIC` | boolean | false | Adversarial review enable |
357
- | `PIPELINE_MODE` | string | auto-detect | lite/standard/full override |
358
-
359
- **Priority:** Command-line env vars > .env file > defaults
360
-
361
- ---
362
-
363
- ## 7. BOOTSTRAP PROMPT FILES
364
-
365
- Located in `/dev-pipeline/templates/`:
366
-
367
- | File | Purpose | Size |
368
- |------|---------|------|
369
- | `bootstrap-prompt.md` | Standard bootstrap | ~1.8 KB |
370
- | `bootstrap-tier1.md` | Lite/minimal workflow | ~18 KB |
371
- | `bootstrap-tier2.md` | Standard workflow | ~25 KB |
372
- | `bootstrap-tier3.md` | Full workflow | ~31 KB |
373
- | `bugfix-bootstrap-prompt.md` | Bug fix workflow | ~14 KB |
374
- | `refactor-bootstrap-prompt.md` | Refactor workflow | ~11 KB |
375
-
376
- **Finding:** Tier-based bootstraps suggest complexity-driven workflow selection. Bug fix & refactor have dedicated bootstraps.
377
-
378
- ---
379
-
380
- ## 8. DETAILED INCONSISTENCY MATRIX
381
-
382
- ### Table: Cross-Schema Field Presence
383
-
384
- | Field | Feature | Bug Fix | Refactor | Issue |
385
- |-------|---------|---------|----------|-------|
386
- | `id` | F-001(-A) | B-001 | R-001 | Different patterns, Feature allows suffixes |
387
- | `title` | ✓ | ✓ | ✓ | Consistent |
388
- | `description` | ✓ | ✓ | ✓ | Consistent |
389
- | `priority` | ✓ req | partial | ✓ req | Bug Fix lacks "critical" in priority enum |
390
- | `severity` | ❌ | ✓ req | ❌ | Bug Fix only, no feature severity |
391
- | `dependencies` | ✓ req (F-IDs) | ❌ | ✓ req (R-IDs) | Bug Fix lacks deps, Feature allows sub-IDs |
392
- | `acceptance_criteria` | ✓ req | ✓ req | ✓ req | Consistent |
393
- | `status` | 7 values | 9 values | 5 values | Inconsistent enum sizes |
394
- | `error_source` | ❌ | ✓ req | ❌ | Bug Fix only |
395
- | `verification_type` | ❌ | ✓ req | ❌ | Bug Fix only |
396
- | `scope` | ❌ | ❌ | ✓ req | Refactor only |
397
- | `type` | ❌ | ❌ | ✓ req | Refactor only (refactor type) |
398
- | `complexity` | optional | ❌ | ✓ req | Feature optional; Refactor required |
399
- | `behavior_preservation` | ❌ | ❌ | ✓ req | Refactor only |
400
- | `model` | ✓ opt | ✓ opt | ✓ opt | Consistent |
401
- | `critic` | ✓ opt (default false) | ✓ opt (conditional) | ✓ opt (conditional) | Different defaults |
402
- | `critic_count` | ✓ opt (1,3) | ✓ opt (1,3) | ✓ opt (1,3) | Enum consistent; defaults differ |
403
- | `completion_notes` | ✓ opt | ❌ | ✓ opt | Bug Fix lacks completion notes |
404
- | `affected_feature` | N/A | ✓ opt (F-ID) | N/A | Bug Fix only |
405
- | `affected_modules` | N/A | ✓ opt | ❌ | Bug/Feature only (Refactor has scope.modules) |
406
- | `environment` | N/A | ✓ opt | N/A | Bug Fix only |
407
- | `sub_features` | ✓ opt | ❌ | ❌ | Feature only |
408
- | `session_granularity` | ✓ opt | ❌ | ❌ | Feature only |
409
- | `browser_interaction` | ✓ opt | ❌ | ❌ | Feature only |
410
- | `estimated_lines` | N/A | ❌ | ✓ opt | Refactor only |
411
- | `design_system` | ❌ | ✓ opt (global) | ✓ opt (global) | Missing from Feature global_context |
412
- | `ci_pipeline` | ❌ | ✓ opt (global) | ✓ opt (global) | Missing from Feature global_context |
413
-
414
- ---
415
-
416
- ## 9. CRITICAL FINDINGS & RECOMMENDATIONS
417
-
418
- ### ⚠️ HIGH PRIORITY ISSUES
419
-
420
- 1. **Bug Fix Schema Missing Dependencies**
421
- - Bugs cannot declare prerequisite bugs or feature links
422
- - **Recommendation:** Add `dependencies` field (array of B-IDs) to enable bug fix ordering
423
- - **Impact:** May lead to out-of-order bug fixes if dependencies exist
424
-
425
- 2. **Global Context Inconsistency**
426
- - Feature missing `design_system` and `ci_pipeline`
427
- - **Recommendation:** Add these fields to Feature global_context for consistency
428
- - **Impact:** Feature pipelines cannot track design system or CI info
429
-
430
- 3. **Priority vs Severity Mismatch (Bug Fix)**
431
- - Bug Fix `severity` has "critical", but `priority` does NOT
432
- - **Recommendation:** Either add "critical" to priority enum OR document explicit mapping rules
433
- - **Impact:** Pipeline code must hardcode severity→priority mapping; unclear in schema
434
-
435
- 4. **Status Enum Proliferation**
436
- - 3 different status enums (Feature: 7, Bug: 9, Refactor: 5)
437
- - **Recommendation:** Standardize or document which phases these statuses map to
438
- - **Impact:** Code handling all 3 must have schema-specific status handling
439
-
440
- ### 🔴 MODERATE ISSUES
441
-
442
- 5. **Feature Dependencies Support Sub-IDs, Others Don't**
443
- - Feature dependencies: `^F-\d{3}(-[A-Z])?$` (can reference F-001-A)
444
- - Refactor dependencies: `^R-\d{3}$` (cannot reference sub-refactors)
445
- - **Recommendation:** Explicitly document this difference or make consistent
446
- - **Impact:** Refactors cannot decompose; Features can
447
-
448
- 6. **Critic Count Defaults Inconsistent**
449
- - Feature: default false, critic_count default 1
450
- - Bug Fix: default false (conditional true for high severity), critic_count 1 for high only
451
- - Refactor: default false (conditional true for critical/high), critic_count 3 for critical / 1 for high
452
- - **Recommendation:** Document default resolution rules in schema comments
453
- - **Impact:** Implicit defaults make it hard to reason about critic enablement
454
-
455
- 7. **Bug Fix Lacks Completion Notes**
456
- - Feature & Refactor have `completion_notes` array; Bug Fix does not
457
- - **Recommendation:** Add `completion_notes` to Bug Fix for consistency and downstream context
458
- - **Impact:** Bug fixes cannot propagate context to dependent features
459
-
460
- 8. **Complexity Field Inconsistency**
461
- - Feature: optional `estimated_complexity` (low, medium, high)
462
- - Bug Fix: NO complexity field
463
- - Refactor: required `complexity` (low, medium, high)
464
- - **Recommendation:** Make Bug Fix complexity optional to match Feature; or require in all 3
465
- - **Impact:** Can't estimate bug fix effort from schema
466
-
467
- ### 🟡 MINOR ISSUES
468
-
469
- 9. **Source Spec Field (Feature Only)**
470
- - Feature root has optional `source_spec` string; others don't
471
- - **Recommendation:** Document purpose or generalize to all schemas
472
- - **Impact:** Feature-specific metadata not portable
473
-
474
- 10. **Session Granularity (Feature Only)**
475
- - Feature only field; no equivalent in Bug Fix or Refactor
476
- - **Recommendation:** Document as intentional Feature-specific feature
477
- - **Impact:** Execution granularity concept not generalized
478
-
479
- ---
480
-
481
- ## 10. EXACT ENUM VALUES SUMMARY
482
-
483
- ### ID Patterns
484
- - **Feature**: `^F-\d{3}(-[A-Z])?$` → F-001, F-001-A, F-123-Z
485
- - **Bug Fix**: `^B-\d{3}$` → B-001, B-123
486
- - **Refactor**: `^R-\d{3}$` → R-001, R-123
487
-
488
- ### Priority/Severity Enums
489
- - **Feature Priority**: `[critical, high, medium, low]` (4 values)
490
- - **Bug Severity**: `[critical, high, medium, low]` (4 values)
491
- - **Bug Priority**: `[high, medium, low]` (3 values) ⚠️ NO CRITICAL
492
- - **Refactor Priority**: `[critical, high, medium, low]` (4 values)
493
-
494
- ### Status Enums
495
- - **Feature**: `[pending, in_progress, completed, failed, skipped, split, auto_skipped]` (7 values)
496
- - **Bug Fix**: `[pending, triaging, reproducing, fixing, verifying, completed, failed, needs_info, skipped]` (9 values)
497
- - **Refactor**: `[pending, in_progress, completed, failed, skipped]` (5 values)
498
-
499
- ### Complexity/Estimated Complexity Enums
500
- - **Feature estimated_complexity** (optional): `[low, medium, high]`
501
- - **Refactor complexity** (required): `[low, medium, high]`
502
- - **Bug Fix**: NO FIELD
503
-
504
- ### Feature-Specific Enums
505
- - **session_granularity**: `[feature, sub_feature, auto]` (default: "feature")
506
- - **browser_interaction required fields**: `url` (string); optional: `setup_command`, `verify_steps` (array), `screenshot` (boolean, default true)
507
-
508
- ### Bug-Specific Enums
509
- - **error_source.type**: `[stack_trace, user_report, failed_test, log_pattern, monitoring_alert]`
510
- - **verification_type**: `[automated, manual, hybrid]`
511
-
512
- ### Refactor-Specific Enums
513
- - **type**: `[extract, rename, restructure, simplify, decouple, migrate]` (6 values)
514
- - **behavior_preservation.strategy**: `[test-gate, snapshot, manual]`
515
-
516
- ### Critic Count Enum (All 3)
517
- - **critic_count**: `[1, 3]` (single critic or multi-critic voting)
518
-
519
- ---
520
-
521
- ## APPENDIX: TEMPLATE FILE COUNTS
522
-
523
- **By Category:**
524
- - Mode Variants (Full/Lite/Agent/Base): 18 files
525
- - Singleton Phases & Workflows: 18 files
526
- - **Total**: 36 markdown template sections
527
-
528
- **Mode Distribution:**
529
- - Full/Standard: 9 files
530
- - Lite: 5 files
531
- - Agent: 6 files
532
- - Base/Shared: 7 files
533
- - Singleton: 3 files
@@ -1,146 +0,0 @@
1
- {
2
- "$schema": "dev-pipeline-feature-list-v1",
3
- "project_name": "TaskFlow",
4
- "project_description": "A modern task management application with team collaboration, real-time updates, and analytics dashboard",
5
- "created_at": "2026-03-04T10:00:00Z",
6
- "created_by": "feature-planner",
7
- "features": [
8
- {
9
- "id": "F-001",
10
- "title": "Project Infrastructure Setup",
11
- "description": "Initialize the monorepo structure with Next.js frontend, Express backend, and PostgreSQL database. Set up ESLint, Prettier, TypeScript configs, and CI/CD basics.",
12
- "priority": "high",
13
- "estimated_complexity": "medium",
14
- "dependencies": [],
15
- "acceptance_criteria": [
16
- "Next.js app runs on port 3000",
17
- "Express API runs on port 4000",
18
- "PostgreSQL connection verified",
19
- "TypeScript compiles without errors",
20
- "ESLint and Prettier configs applied"
21
- ],
22
- "status": "pending",
23
- "session_granularity": "feature",
24
- "sub_features": []
25
- },
26
- {
27
- "id": "F-002",
28
- "title": "User Authentication",
29
- "description": "Implement email/password registration and login with JWT tokens. Include password reset via email, session management, and protected routes.",
30
- "priority": "high",
31
- "estimated_complexity": "medium",
32
- "dependencies": [
33
- "F-001"
34
- ],
35
- "acceptance_criteria": [
36
- "Users can register with email and password",
37
- "Users can login and receive JWT token",
38
- "Password reset flow works via email",
39
- "Protected API routes reject unauthenticated requests",
40
- "Session persists across page refreshes"
41
- ],
42
- "status": "pending",
43
- "session_granularity": "feature",
44
- "sub_features": []
45
- },
46
- {
47
- "id": "F-003",
48
- "title": "Task CRUD Operations",
49
- "description": "Core task management: create, read, update, delete tasks. Tasks have title, description, status (todo/in-progress/done), priority, due date, and assignee.",
50
- "priority": "high",
51
- "estimated_complexity": "medium",
52
- "dependencies": [
53
- "F-002"
54
- ],
55
- "acceptance_criteria": [
56
- "Create task with all required fields",
57
- "List tasks with pagination and filtering",
58
- "Update task status, title, description",
59
- "Delete task with confirmation",
60
- "Task validation enforced on both client and server"
61
- ],
62
- "status": "pending",
63
- "session_granularity": "feature",
64
- "sub_features": []
65
- },
66
- {
67
- "id": "F-004",
68
- "title": "Project & Team Management",
69
- "description": "Organize tasks into projects. Support team creation, member invitation, and role-based permissions (owner, admin, member, viewer).",
70
- "priority": "medium",
71
- "estimated_complexity": "high",
72
- "dependencies": [
73
- "F-003"
74
- ],
75
- "acceptance_criteria": [
76
- "Create and manage projects",
77
- "Invite team members via email",
78
- "Role-based access control enforced",
79
- "Project-level task filtering",
80
- "Team member list with role display"
81
- ],
82
- "status": "pending",
83
- "session_granularity": "auto",
84
- "sub_features": [
85
- {
86
- "id": "F-004-A",
87
- "title": "Project CRUD & Organization",
88
- "description": "Create, read, update, delete projects. Associate tasks with projects."
89
- },
90
- {
91
- "id": "F-004-B",
92
- "title": "Team & Permissions",
93
- "description": "Team creation, member invitation, role-based access control."
94
- }
95
- ]
96
- },
97
- {
98
- "id": "F-005",
99
- "title": "Real-time Updates",
100
- "description": "Add WebSocket-based real-time notifications for task changes, comments, and team activity. Show live updates without page refresh.",
101
- "priority": "medium",
102
- "estimated_complexity": "high",
103
- "dependencies": [
104
- "F-003"
105
- ],
106
- "acceptance_criteria": [
107
- "Task status changes appear in real-time for team members",
108
- "New comments trigger live notifications",
109
- "Connection status indicator shown in UI",
110
- "Graceful fallback when WebSocket disconnects",
111
- "No duplicate notifications"
112
- ],
113
- "status": "pending",
114
- "session_granularity": "feature",
115
- "sub_features": []
116
- },
117
- {
118
- "id": "F-006",
119
- "title": "Analytics Dashboard",
120
- "description": "Dashboard showing task completion rates, team productivity metrics, overdue task tracking, and project progress visualization.",
121
- "priority": "low",
122
- "estimated_complexity": "medium",
123
- "dependencies": [
124
- "F-004",
125
- "F-005"
126
- ],
127
- "acceptance_criteria": [
128
- "Task completion rate chart (daily/weekly/monthly)",
129
- "Team productivity leaderboard",
130
- "Overdue task alerts and summary",
131
- "Project progress bars",
132
- "Date range filtering for all charts"
133
- ],
134
- "status": "pending",
135
- "session_granularity": "feature",
136
- "sub_features": []
137
- }
138
- ],
139
- "global_context": {
140
- "tech_stack": "Next.js 14 + Express.js + PostgreSQL + Prisma ORM",
141
- "design_system": "shadcn/ui + Tailwind CSS",
142
- "testing_strategy": "Jest (unit) + Playwright (e2e)",
143
- "deployment": "Docker + Vercel (frontend) + Railway (backend)",
144
- "language": "TypeScript"
145
- }
146
- }