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,270 +0,0 @@
1
- {
2
- "$schema": "http://json-schema.org/draft-07/schema#",
3
- "title": "Dev-Pipeline Refactor List",
4
- "description": "Schema for .prizmkit/plans/refactor-list.json — standardized input for the Refactor Pipeline",
5
- "type": "object",
6
- "required": [
7
- "$schema",
8
- "project_name",
9
- "refactors"
10
- ],
11
- "properties": {
12
- "$schema": {
13
- "type": "string",
14
- "const": "dev-pipeline-refactor-list-v1"
15
- },
16
- "project_name": {
17
- "type": "string",
18
- "minLength": 1
19
- },
20
- "project_description": {
21
- "type": "string"
22
- },
23
- "created_at": {
24
- "type": "string",
25
- "format": "date-time"
26
- },
27
- "created_by": {
28
- "type": "string"
29
- },
30
- "refactors": {
31
- "type": "array",
32
- "minItems": 1,
33
- "items": {
34
- "type": "object",
35
- "required": [
36
- "id",
37
- "title",
38
- "description",
39
- "scope",
40
- "type",
41
- "priority",
42
- "complexity",
43
- "behavior_preservation",
44
- "acceptance_criteria",
45
- "dependencies",
46
- "status"
47
- ],
48
- "properties": {
49
- "id": {
50
- "type": "string",
51
- "pattern": "^R-\\d{3}$",
52
- "description": "Refactor ID, format R-001, R-002..."
53
- },
54
- "title": {
55
- "type": "string",
56
- "minLength": 1,
57
- "description": "Refactor title — brief description of the change"
58
- },
59
- "description": {
60
- "type": "string",
61
- "minLength": 1,
62
- "description": "Detailed description: what is being refactored and why"
63
- },
64
- "scope": {
65
- "type": "object",
66
- "description": "Files and modules affected by this refactor",
67
- "properties": {
68
- "files": {
69
- "type": "array",
70
- "items": {
71
- "type": "string"
72
- },
73
- "description": "File paths affected by this refactor"
74
- },
75
- "modules": {
76
- "type": "array",
77
- "items": {
78
- "type": "string"
79
- },
80
- "description": "Module names affected by this refactor"
81
- }
82
- }
83
- },
84
- "type": {
85
- "type": "string",
86
- "enum": [
87
- "extract",
88
- "rename",
89
- "restructure",
90
- "simplify",
91
- "decouple",
92
- "migrate"
93
- ],
94
- "description": "extract=extract-function/module; rename=rename-symbols; restructure=move/reorganize; simplify=reduce-complexity; decouple=remove-dependencies; migrate=tech-migration"
95
- },
96
- "priority": {
97
- "type": "string",
98
- "enum": [
99
- "critical",
100
- "high",
101
- "medium",
102
- "low"
103
- ],
104
- "description": "Refactor priority. Pipeline processes critical before high before medium before low; within same level, array order determines sequence."
105
- },
106
- "complexity": {
107
- "type": "string",
108
- "enum": [
109
- "low",
110
- "medium",
111
- "high"
112
- ],
113
- "description": "Estimated complexity of the refactor"
114
- },
115
- "behavior_preservation": {
116
- "type": "object",
117
- "required": [
118
- "strategy"
119
- ],
120
- "description": "Strategy for ensuring no behavior changes",
121
- "properties": {
122
- "strategy": {
123
- "type": "string",
124
- "enum": [
125
- "test-gate",
126
- "snapshot",
127
- "manual"
128
- ],
129
- "description": "test-gate=existing-tests-must-pass; snapshot=before/after-snapshot-comparison; manual=human-verification"
130
- },
131
- "existing_tests": {
132
- "type": "boolean",
133
- "description": "Whether existing tests cover the refactored code"
134
- },
135
- "new_tests_needed": {
136
- "type": "array",
137
- "items": {
138
- "type": "string"
139
- },
140
- "description": "New tests that should be written before refactoring"
141
- }
142
- }
143
- },
144
- "acceptance_criteria": {
145
- "type": "array",
146
- "minItems": 1,
147
- "items": {
148
- "type": "string"
149
- },
150
- "description": "Conditions that must be met for the refactor to be considered complete"
151
- },
152
- "dependencies": {
153
- "type": "array",
154
- "items": {
155
- "type": "string",
156
- "pattern": "^R-\\d{3}$"
157
- },
158
- "description": "IDs of refactors that must be completed before this one"
159
- },
160
- "status": {
161
- "type": "string",
162
- "enum": [
163
- "pending",
164
- "in_progress",
165
- "completed",
166
- "failed",
167
- "skipped",
168
- "auto_skipped"
169
- ],
170
- "description": "Refactor status. Subset of feature status enum."
171
- },
172
- "model": {
173
- "type": "string",
174
- "description": "AI model ID for this refactor. Overrides $MODEL env var."
175
- },
176
- "estimated_lines": {
177
- "type": "integer",
178
- "description": "Estimated number of lines affected by this refactor"
179
- },
180
- "completion_notes": {
181
- "type": "array",
182
- "items": {
183
- "type": "string"
184
- },
185
- "description": "AI-generated summary of key changes from this refactor session. Used to provide rich dependency context to downstream refactors. Each item is a concise statement about what was refactored (e.g. modules extracted, files restructured, interfaces changed)."
186
- },
187
- "user_context": {
188
- "type": "array",
189
- "items": { "type": "string" },
190
- "description": "User-provided supplementary materials, preserved verbatim. Each entry is either inline content/rules (stored as-is) or a file reference (e.g. 'src/auth/login.ts:42-78', 'src/utils/ — focus on validation logic')."
191
- },
192
- "critic": {
193
- "type": "boolean",
194
- "description": "Enable adversarial plan challenge before implementation. Default: true for critical/high priority refactors, false for others.",
195
- "default": false
196
- },
197
- "critic_count": {
198
- "type": "integer",
199
- "description": "Number of parallel critic agents. 1 = single critic, 3 = multi-critic voting. Default: 3 for critical, 1 for high, omit for others.",
200
- "enum": [
201
- 1,
202
- 3
203
- ]
204
- },
205
- "browser_interaction": {
206
- "type": "object",
207
- "description": "Browser verification config for refactors affecting UI behavior. Supports playwright-cli and opencli. AI auto-detects dev server command, URL, and port from project config at runtime.",
208
- "properties": {
209
- "tool": {
210
- "type": "string",
211
- "enum": ["playwright-cli", "opencli", "auto"],
212
- "default": "auto",
213
- "description": "Browser tool to use. 'auto' (default) = AI chooses at runtime. 'playwright-cli' = local dev server verification in isolated browser. 'opencli' = reuses Chrome logged-in session, ideal for verifying refactors involving third-party integrations or OAuth flows."
214
- },
215
- "verify_steps": {
216
- "type": "array",
217
- "description": "Verification goals describing WHAT to verify after refactoring (e.g., 'Navigation still works', 'Form submission succeeds', 'UI renders identically'). AI decides concrete browser tool actions at runtime. If omitted, AI explores the app and verifies no visual or behavioral regressions.",
218
- "items": {
219
- "type": "string"
220
- }
221
- }
222
- }
223
- }
224
- }
225
- }
226
- },
227
- "global_context": {
228
- "type": "object",
229
- "description": "Global context for all refactors in this batch",
230
- "properties": {
231
- "tech_stack": {
232
- "type": "string"
233
- },
234
- "language": {
235
- "type": "string"
236
- },
237
- "runtime": {
238
- "type": "string"
239
- },
240
- "frontend_framework": {
241
- "type": "string"
242
- },
243
- "frontend_styling": {
244
- "type": "string"
245
- },
246
- "backend_framework": {
247
- "type": "string"
248
- },
249
- "database": {
250
- "type": "string"
251
- },
252
- "orm": {
253
- "type": "string"
254
- },
255
- "testing_strategy": {
256
- "type": "string"
257
- },
258
- "bundler": {
259
- "type": "string"
260
- },
261
- "project_type": {
262
- "type": "string"
263
- },
264
- "ci_pipeline": {
265
- "type": "string"
266
- }
267
- }
268
- }
269
- }
270
- }
@@ -1,7 +0,0 @@
1
- ## Verification Gates Compatibility Note
2
-
3
- This section file is retained for compatibility with older bootstrap templates.
4
-
5
- Current section assembly renders Verification Gates only inside `task-contract.md` so the feature scope and acceptance requirements have a single source of truth.
6
-
7
- Do not add this section separately unless you intentionally want to duplicate the gates outside the Task Contract.
@@ -1,91 +0,0 @@
1
- ## Workflow Checkpoint System
2
-
3
- A checkpoint file tracks your progress through this workflow:
4
-
5
- **Path**: `{{CHECKPOINT_PATH}}`
6
-
7
- ### Rules
8
-
9
- 1. **Before each skill**: Read `workflow-checkpoint.json`, verify the previous step has `status: "completed"` or `status: "skipped"`. If it is still `"pending"` or `"in_progress"`, you MUST complete it first before moving on.
10
-
11
- 2. **Starting a skill**: Use the update script to set the current step to `status: "in_progress"`.
12
-
13
- 3. **After each skill completes**: Use the update script to set the current step to `status: "completed"`.
14
-
15
- 4. **On failure**: Use the update script to set the step to `status: "failed"` and continue to the next step if possible, or halt and write failure-log.md.
16
-
17
- 5. **On session exit**: The checkpoint file reflects your actual progress. Do NOT manually set future steps to "completed".
18
-
19
- ### Checkpoint Update Pattern
20
-
21
- **IMPORTANT: NEVER hand-write or edit `workflow-checkpoint.json` directly. Always use the update script.**
22
-
23
- Define this helper once in the active PowerShell session before running PrizmKit Python scripts:
24
-
25
- ```powershell
26
- function Invoke-PrizmPython {
27
- param([Parameter(ValueFromRemainingArguments = $true)][string[]]$Arguments)
28
- $python = Get-Command python -ErrorAction SilentlyContinue
29
- if ($python) {
30
- & $python.Source -c 'import sys; raise SystemExit(0 if sys.version_info[0] == 3 else 1)' *> $null
31
- if ($LASTEXITCODE -eq 0) {
32
- & $python.Source @Arguments
33
- return
34
- }
35
- }
36
- $py = Get-Command py -ErrorAction SilentlyContinue
37
- if ($py) {
38
- & $py.Source -3 -c 'import sys; raise SystemExit(0 if sys.version_info[0] == 3 else 1)' *> $null
39
- if ($LASTEXITCODE -eq 0) {
40
- & $py.Source -3 @Arguments
41
- return
42
- }
43
- }
44
- throw "Python 3 is required. Install Python and ensure python or py is in PATH."
45
- }
46
- ```
47
-
48
- After completing each skill, run:
49
-
50
- ```powershell
51
- Invoke-PrizmPython {{PIPELINE_DIR}}\scripts\update-checkpoint.py `
52
- --checkpoint-path {{CHECKPOINT_PATH}} `
53
- --step <SKILL_NAME> `
54
- --status completed
55
- ```
56
-
57
- For example, after completing `prizmkit-implement`:
58
- ```powershell
59
- Invoke-PrizmPython {{PIPELINE_DIR}}\scripts\update-checkpoint.py `
60
- --checkpoint-path {{CHECKPOINT_PATH}} `
61
- --step prizmkit-implement `
62
- --status completed
63
- ```
64
-
65
- Before starting the next skill:
66
- ```powershell
67
- Invoke-PrizmPython {{PIPELINE_DIR}}\scripts\update-checkpoint.py `
68
- --checkpoint-path {{CHECKPOINT_PATH}} `
69
- --step <NEXT_SKILL_NAME> `
70
- --status in_progress
71
- ```
72
-
73
- On failure:
74
- ```powershell
75
- Invoke-PrizmPython {{PIPELINE_DIR}}\scripts\update-checkpoint.py `
76
- --checkpoint-path {{CHECKPOINT_PATH}} `
77
- --step <SKILL_NAME> `
78
- --status failed `
79
- --note "brief failure reason"
80
- ```
81
-
82
- The script outputs JSON: `{"ok": true, ...}` on success, `{"ok": false, "error": "..."}` on failure.
83
-
84
- ### Resume Behavior
85
-
86
- **Checkpoint is the primary source of truth for resume.** On retry sessions:
87
-
88
- 1. Read `workflow-checkpoint.json` — steps already `"completed"` or `"skipped"` are skipped
89
- 2. Start from the first `"pending"` or `"in_progress"` step
90
- 3. If `failure-log.md` exists, read it for diagnostic context (the previous session failure reason, what approach to try differently) — but do NOT use it to determine the step to resume from
91
- 4. If `workflow-checkpoint.json` is missing or corrupted, fall back to `failure-log.md` + the resume phase as the legacy mechanism
@@ -1,34 +0,0 @@
1
- ## Context Budget Rules (CRITICAL — read before any phase)
2
-
3
- You are running in **headless non-interactive mode** with a FINITE context window. Exceeding it will crash the session and lose all work. Follow these rules strictly:
4
-
5
- 0. **NON-INTERACTIVE MODE** — There is NO human on the other end. NEVER ask for user confirmation, NEVER wait for user input, NEVER use interactive prompts (e.g. "Would you like me to…"). If a skill has an interactive step (e.g. offer remediation, ask for approval), skip it and proceed autonomously. Make decisions based on the data available and move forward.
6
-
7
- 1. **context-snapshot.md is your single source of truth** — After it is built, ALWAYS read context-snapshot.md instead of re-reading individual source files
8
- 2. **Never re-read your own writes** — After you create/modify a file, do NOT read it back to verify. Trust your write was correct.
9
- 3. **Stay focused** — Do NOT explore code unrelated to this feature. No curiosity-driven reads.
10
- 4. **One task at a time** — Complete and test one task before starting the next.
11
- 5. **Minimize tool output** — Never load full command output into context. First capture to a temp file (`& { <command> } 2>&1 | Tee-Object (Join-Path $env:TEMP "out.txt") | Select-Object -Last 20`), then scan the first/last lines to identify relevant fields, and use targeted filtering (`Select-String`, regex matching, PowerShell object filtering) to extract only the information needed for the current task. Only read the filtered result — never the raw full output.
12
- 6. **No intermediate commits** — Do NOT run `git add`/`git commit` during implementation phases. All changes are committed once at the end via `/prizmkit-committer`.
13
- 7. **Capture test output once** — When running test suites, always use `& { {{TEST_CMD}} } 2>&1 | Tee-Object (Join-Path $env:TEMP "test-out.txt") | Select-Object -Last 20`. Then Select-String `(Join-Path $env:TEMP "test-out.txt")` for details. Never re-run the suite just to apply a different filter.
14
- 8. **Scaffold / generated file awareness (CRITICAL)** — When you run a scaffolding tool or package manager init command (`npm init`, `npx create-*`, `vite create`, `cargo init`, `go mod init`, `rails new`, `django-admin startproject`, `npx shadcn-ui init`, etc.), the output files are **generated boilerplate**. You MUST:
15
- - Identify and mentally tag all files created by the tool as "scaffold files"
16
- - Record the list of scaffold-generated files in context-snapshot.md under a `### Scaffold Files (do not re-read)` section
17
- - **NEVER re-read scaffold files** after initial creation. Their content is standard boilerplate — you already know what they contain from the tool that generated them
18
- - If you need to modify a scaffold file, make the edit directly without reading it first (you know the standard template content)
19
- - This applies equally to `node_modules/`, `package-lock.json`, generated config files (`tsconfig.json`, `vite.config.ts`, `tailwind.config.js`, `.eslintrc`, etc.) produced by init commands
20
- - When passing context to subagents, explicitly tell them Get-Command files are scaffold-generated so they skip reading them too
21
- 9. **Package version verification (HARD CONSTRAINT — BLOCKING)** — Before writing ANY dependency version in `package.json`, `requirements.txt`, `Cargo.toml`, `go.mod`, `Gemfile`, `pyproject.toml`, or any other dependency manifest:
22
- - You MUST verify the real version exists by querying the package registry first:
23
- - npm/Node.js: `npm view <package> dist-tags.latest 2>$null`
24
- - Python/pip: `pip index versions <package> 2>$null | Select-Object -First 1`
25
- - Go: `go list -m -versions <module>@latest 2>$null`
26
- - Rust: `cargo search <crate> --limit 1 2>$null`
27
- - **NEVER guess or hallucinate version numbers**. If you cannot verify a version, use `"latest"` or `"*"` as a placeholder, or omit the version constraint entirely and let the package manager resolve it
28
- - If the registry query fails (network issue, package not found), you MUST either:
29
- (a) Use a known-safe version you have high confidence in, OR
30
- (b) Skip that dependency and document it as a manual step, OR
31
- (c) Use no version constraint (e.g., `"express": "*"`)
32
- - **This is a BLOCKING gate**: do NOT run `npm install` / `pip install` / `cargo build` / `go mod tidy` until ALL versions in the manifest have been verified or use open constraints
33
- - Batch version lookups: query multiple packages in parallel to save time (e.g., run multiple `npm view` commands concurrently)
34
- 10. **Build artifact hygiene** — After any build/compile command (`go build`, `npm run build`, `tsc`, etc.), ensure the output binary, build directory, generated bundle, or cache directory is ignored by git before the commit phase. Never commit compiled binaries, build output, or generated artifacts.
@@ -1,10 +0,0 @@
1
- ## Critical Paths
2
-
3
- | Resource | Path |
4
- |----------|------|
5
- | Feature Artifacts Dir | `.prizmkit/specs/{{FEATURE_SLUG}}/` |
6
- | Context Snapshot | `.prizmkit/specs/{{FEATURE_SLUG}}/context-snapshot.md` |
7
- | Dev Agent Def | {{DEV_SUBAGENT_PATH}} |
8
- | Reviewer Agent Def | {{REVIEWER_SUBAGENT_PATH}} |
9
- | Critic Agent Def (if enabled) | {{CRITIC_SUBAGENT_PATH}} |
10
- | Project Root | {{PROJECT_ROOT}} |
@@ -1,12 +0,0 @@
1
- ## Critical Paths
2
-
3
- | Resource | Path |
4
- |----------|------|
5
- | Feature Artifacts Dir | `.prizmkit/specs/{{FEATURE_SLUG}}/` |
6
- | Context Snapshot | `.prizmkit/specs/{{FEATURE_SLUG}}/context-snapshot.md` |
7
- | Team Config | `{{TEAM_CONFIG_PATH}}` |
8
- | Dev Agent Def | {{DEV_SUBAGENT_PATH}} |
9
- | Reviewer Agent Def | {{REVIEWER_SUBAGENT_PATH}} |
10
- | Critic Agent Def | {{CRITIC_SUBAGENT_PATH}} |
11
- | Project Root | {{PROJECT_ROOT}} |
12
- | Feature List Path | {{FEATURE_LIST_PATH}} |
@@ -1,7 +0,0 @@
1
- ## Critical Paths
2
-
3
- | Resource | Path |
4
- |----------|------|
5
- | Feature Artifacts Dir | `.prizmkit/specs/{{FEATURE_SLUG}}/` |
6
- | Context Snapshot | `.prizmkit/specs/{{FEATURE_SLUG}}/context-snapshot.md` |
7
- | Project Root | {{PROJECT_ROOT}} |
@@ -1,8 +0,0 @@
1
- ## PrizmKit Directory Convention
2
-
3
- ```
4
- .prizmkit/specs/{{FEATURE_SLUG}}/context-snapshot.md ← orchestrator writes Sections 1-4; Dev appends Implementation Log; Reviewer appends Review Notes
5
- .prizmkit/specs/{{FEATURE_SLUG}}/plan.md ← includes Tasks section
6
- ```
7
-
8
- **`context-snapshot.md`** is the shared knowledge base. Orchestrator writes Sections 1-4; Dev appends Implementation Log; Reviewer appends Review Notes. Append-only after initial creation.
@@ -1,9 +0,0 @@
1
- ## PrizmKit Directory Convention
2
-
3
- ```
4
- .prizmkit/specs/{{FEATURE_SLUG}}/context-snapshot.md ← orchestrator writes Sections 1-4; Dev appends Implementation Log; Reviewer appends Review Notes
5
- .prizmkit/specs/{{FEATURE_SLUG}}/spec.md
6
- .prizmkit/specs/{{FEATURE_SLUG}}/plan.md ← includes Tasks section
7
- ```
8
-
9
- **`context-snapshot.md`** is the shared knowledge base. Orchestrator writes Sections 1-4; Dev appends Implementation Log; Reviewer appends Review Notes. This eliminates redundant I/O across all agents.
@@ -1,6 +0,0 @@
1
- ## PrizmKit Directory Convention
2
-
3
- ```
4
- .prizmkit/specs/{{FEATURE_SLUG}}/context-snapshot.md
5
- .prizmkit/specs/{{FEATURE_SLUG}}/plan.md ← includes Tasks section
6
- ```
@@ -1,21 +0,0 @@
1
- ## Failure Capture Protocol
2
-
3
- If you encounter an unrecoverable error, context overflow, or are about to exit without completing all phases:
4
-
5
- 1. Write `.prizmkit/specs/{{FEATURE_SLUG}}/failure-log.md` BEFORE exiting:
6
- ```
7
- FAILURE_TYPE: timeout | test_failure | review_rejected | context_overflow | unknown
8
- PHASE: <Get-Command phase failed>
9
- ROOT_CAUSE: <1-2 sentence explanation>
10
- ATTEMPTED: <approaches already tried>
11
- SUGGESTION: <what the next session should try differently>
12
- DISCOVERED_TRAPS:
13
- - [CRITICAL|HIGH|LOW] <gotcha discovered during this failed session> | FIX: <approach>
14
- ```
15
-
16
- 2. This file is intentionally lightweight — write it BEFORE context runs out.
17
-
18
- **Lifecycle**: failure-log.md is a temporary cross-session artifact. Do NOT commit it to git. After a successful session (all phases complete + commit done), delete it:
19
- ```powershell
20
- Remove-Item -Force -ErrorAction SilentlyContinue .prizmkit/specs/{{FEATURE_SLUG}}/failure-log.md
21
- ```
@@ -1,21 +0,0 @@
1
- <feature-context>
2
- ## Source Semantics
3
-
4
- Use this material according to the following priority:
5
-
6
- 1. **Task Contract** — defines current scope and Verification Gates.
7
- 2. **Completed Dependencies** — existing interfaces; do not re-implement.
8
- 3. **App Global Context** — stack, runtime, testing conventions.
9
-
10
- ### Completed Dependencies
11
-
12
- {{COMPLETED_DEPENDENCIES}}
13
-
14
- ### App Global Context
15
-
16
- {{GLOBAL_CONTEXT}}
17
-
18
- ### Project Conventions
19
-
20
- > Read {{PLATFORM_CONVENTIONS}} for project-level coding standards and architecture decisions.
21
- </feature-context>
@@ -1,78 +0,0 @@
1
- ## Session Log Budget Monitoring (PROACTIVE)
2
-
3
- Your session log grows with every tool call and subagent spawn.
4
- To prevent context exhaustion, **spawn a background monitoring subagent at session start**.
5
-
6
- ### How to Set Up the Monitor
7
-
8
- 1. **AS THE VERY FIRST ACTION** (before Phase 0), spawn a monitoring subagent
9
- with `run_in_background: true` and this task:
10
-
11
- ```
12
- Run this command and keep it running:
13
- $psHost = if (Get-Command pwsh -ErrorAction SilentlyContinue) { 'pwsh' } else { 'powershell.exe' }
14
- & $psHost -NoProfile -File {{LOG_MONITOR_SCRIPT}} {{SESSION_LOG_PATH}} {{MAX_LOG_SIZE}} {{LOG_MONITOR_POLL_INTERVAL}} {{LOG_MONITOR_STATUS_FILE}} {{LOG_MONITOR_BASELINE_FILE}}
15
- ```
16
-
17
- The subagent MUST use `run_in_background: true`. It writes a JSON status
18
- file every {{LOG_MONITOR_POLL_INTERVAL}} seconds.
19
-
20
- 2. **BEFORE EACH MAJOR PHASE** (Phase 0, 1, 2, ...), read the status:
21
-
22
- ```powershell
23
- if (Test-Path {{LOG_MONITOR_STATUS_FILE}}) { Get-Content {{LOG_MONITOR_STATUS_FILE}} } else { '{"status":"OK"}' }
24
- ```
25
-
26
- The status file contains structured diagnostics:
27
-
28
- ```json
29
- {
30
- "status": "OK | COMPACT_NEEDED",
31
- "total_bytes": <current session.log size>,
32
- "baseline_bytes": <size after last /compact>,
33
- "effective_bytes": <total - baseline, incremental growth>,
34
- "threshold_bytes": <{{MAX_LOG_SIZE}}>,
35
- "overage_bytes": <effective - threshold, 0 when OK>,
36
- "usage_pct": <effective / threshold * 100>
37
- }
38
- ```
39
-
40
- Extract fields for decision-making:
41
- ```powershell
42
- $data = Get-Content {{LOG_MONITOR_STATUS_FILE}} | ConvertFrom-Json
43
- $status = $data.status
44
- $effective = $data.effective_bytes
45
- $overage = $data.overage_bytes
46
- $usage = $data.usage_pct
47
- ```
48
-
49
- 3. **On COMPACT_NEEDED** (effective_bytes > {{MAX_LOG_SIZE}} bytes, {{MAX_LOG_SIZE_HUMAN}}):
50
- - Check `overage_bytes` to decide urgency:
51
- - **Minor overage** (< 512KB): complete the current sub-step, update durable workflow checkpoint artifacts, write baseline, `/compact`
52
- - **Major overage** (>= 512KB): update durable workflow checkpoint artifacts, write baseline, `/compact` — do NOT start new work
53
- - Write baseline before `/compact`:
54
- ```powershell
55
- (Get-Item {{SESSION_LOG_PATH}}).Length | Out-File -NoNewline {{LOG_MONITOR_BASELINE_FILE}}
56
- ```
57
- - Execute `/compact`
58
- - Continue the workflow after `/compact`; re-read this status file before the next major phase
59
-
60
- ### How the Baseline Prevents Infinite Compaction Loops
61
-
62
- - Before the first `/compact`: baseline = 0, effective = full log size → triggers when log exceeds threshold
63
- - After `/compact`: baseline = current log size, effective ≈ 0 → status resets to OK
64
- - The monitor only triggers again when **new** log growth since the last compact exceeds the threshold
65
- - Each `/compact` resets the baseline, breaking the infinite loop
66
-
67
- ### Log Growth Reduction Tips
68
-
69
- - **Re-read context-snapshot.md instead of source files** — already in context
70
- - **Filter command output** — pipe to `Select-Object -Last 20` or `Select-String`, never full output
71
- - **Limit subagent prompts** — shorter, focused prompts = shorter transcripts
72
- - **Checkpoint often** — update durable workflow checkpoint artifacts before `/compact`
73
-
74
- ### What Survives
75
-
76
- - All git commits are permanent
77
- - The workflow checkpoint is preserved and auto-resumed
78
- - `/compact` compresses context without losing progress