blendops 0.0.0-stage → 1.0.0

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 (484) hide show
  1. package/CHANGELOG.md +62 -0
  2. package/LICENSE +21 -0
  3. package/README.md +189 -2
  4. package/bin/blendops.mjs +4 -0
  5. package/bundles/claude-desktop-manual/BLENDOPS_SINGLE_FILE.md +78 -0
  6. package/bundles/claude-desktop-manual/IMPORT_STEPS.md +43 -0
  7. package/bundles/claude-desktop-manual/INSTALL_REPORT_TEMPLATE.md +13 -0
  8. package/bundles/claude-desktop-manual/README.md +70 -0
  9. package/bundles/claude-desktop-manual/SKILL.md +62 -0
  10. package/bundles/claude-desktop-manual/manifest.json +278 -0
  11. package/bundles/claude-desktop-manual/references/evidence-rules.md +13 -0
  12. package/bundles/claude-desktop-manual/references/install-boundary.md +13 -0
  13. package/bundles/claude-desktop-manual/references/laws/evidence-before-done.md +14 -0
  14. package/bundles/claude-desktop-manual/references/laws/no-arbitrary-python-interface.md +12 -0
  15. package/bundles/claude-desktop-manual/references/laws/non-blender-user-language.md +13 -0
  16. package/bundles/claude-desktop-manual/references/laws/official-runtime-only.md +20 -0
  17. package/bundles/claude-desktop-manual/references/packs/product-hero-v0.md +30 -0
  18. package/bundles/claude-desktop-manual/references/runtime-stacks.md +13 -0
  19. package/bundles/claude-desktop-manual/references/skill-map.md +36 -0
  20. package/bundles/claude-desktop-manual/references/skills/acceptance-criteria-builder.md +69 -0
  21. package/bundles/claude-desktop-manual/references/skills/asset-discovery.md +73 -0
  22. package/bundles/claude-desktop-manual/references/skills/asset-fallback-strategy.md +66 -0
  23. package/bundles/claude-desktop-manual/references/skills/asset-library-plan.md +69 -0
  24. package/bundles/claude-desktop-manual/references/skills/asset-license-checker.md +69 -0
  25. package/bundles/claude-desktop-manual/references/skills/asset-style-check.md +69 -0
  26. package/bundles/claude-desktop-manual/references/skills/blender-brainstorming.md +62 -0
  27. package/bundles/claude-desktop-manual/references/skills/blender-recipe-decomposer.md +66 -0
  28. package/bundles/claude-desktop-manual/references/skills/blender-troubleshooting.md +78 -0
  29. package/bundles/claude-desktop-manual/references/skills/blendops-help.md +82 -0
  30. package/bundles/claude-desktop-manual/references/skills/bridge-conflicts.md +68 -0
  31. package/bundles/claude-desktop-manual/references/skills/camera-composition.md +65 -0
  32. package/bundles/claude-desktop-manual/references/skills/character-portrait.md +68 -0
  33. package/bundles/claude-desktop-manual/references/skills/cli-appendix-job-outline.md +62 -0
  34. package/bundles/claude-desktop-manual/references/skills/color-management-decision.md +68 -0
  35. package/bundles/claude-desktop-manual/references/skills/composition-quality-checker.md +71 -0
  36. package/bundles/claude-desktop-manual/references/skills/cycles-vs-eevee-decision.md +65 -0
  37. package/bundles/claude-desktop-manual/references/skills/done-criteria.md +70 -0
  38. package/bundles/claude-desktop-manual/references/skills/environment-shot.md +65 -0
  39. package/bundles/claude-desktop-manual/references/skills/glb-animation-handoff.md +69 -0
  40. package/bundles/claude-desktop-manual/references/skills/glb-web-handoff.md +68 -0
  41. package/bundles/claude-desktop-manual/references/skills/intent-to-3d-brief-writer.md +68 -0
  42. package/bundles/claude-desktop-manual/references/skills/interior-scene.md +73 -0
  43. package/bundles/claude-desktop-manual/references/skills/lighting-material-plan.md +65 -0
  44. package/bundles/claude-desktop-manual/references/skills/lighting-quality-checker.md +70 -0
  45. package/bundles/claude-desktop-manual/references/skills/material-quality-checker.md +71 -0
  46. package/bundles/claude-desktop-manual/references/skills/mobile-glb-budget.md +73 -0
  47. package/bundles/claude-desktop-manual/references/skills/output-format-decision.md +63 -0
  48. package/bundles/claude-desktop-manual/references/skills/pack-prerequisite-checker.md +74 -0
  49. package/bundles/claude-desktop-manual/references/skills/path-one-host-outline.md +66 -0
  50. package/bundles/claude-desktop-manual/references/skills/plain-language-response.md +70 -0
  51. package/bundles/claude-desktop-manual/references/skills/polycount-budget-checker.md +71 -0
  52. package/bundles/claude-desktop-manual/references/skills/pre-handoff-verification.md +76 -0
  53. package/bundles/claude-desktop-manual/references/skills/preview-report.md +62 -0
  54. package/bundles/claude-desktop-manual/references/skills/product-grid-scene-planner.md +72 -0
  55. package/bundles/claude-desktop-manual/references/skills/product-hero-scene-planner.md +68 -0
  56. package/bundles/claude-desktop-manual/references/skills/r3f-component-plan.md +66 -0
  57. package/bundles/claude-desktop-manual/references/skills/recipe-fit-assessor.md +75 -0
  58. package/bundles/claude-desktop-manual/references/skills/render-export-evidence.md +70 -0
  59. package/bundles/claude-desktop-manual/references/skills/resolution-aspect-decision.md +65 -0
  60. package/bundles/claude-desktop-manual/references/skills/runtime-attempt-report.md +67 -0
  61. package/bundles/claude-desktop-manual/references/skills/runtime-path-picker.md +67 -0
  62. package/bundles/claude-desktop-manual/references/skills/runtime-readiness.md +63 -0
  63. package/bundles/claude-desktop-manual/references/skills/runtime-setup.md +63 -0
  64. package/bundles/claude-desktop-manual/references/skills/scene-readiness.md +65 -0
  65. package/bundles/claude-desktop-manual/references/skills/scope-guard.md +62 -0
  66. package/bundles/claude-desktop-manual/references/skills/stage-gates.md +91 -0
  67. package/bundles/claude-desktop-manual/references/skills/workflow-stage-router.md +67 -0
  68. package/bundles/generic-project-local/BLENDOPS.md +71 -0
  69. package/bundles/generic-project-local/INSTALL_REPORT_TEMPLATE.md +52 -0
  70. package/bundles/generic-project-local/README.md +72 -0
  71. package/bundles/generic-project-local/ROLLBACK.md +66 -0
  72. package/bundles/generic-project-local/manifest.json +66 -0
  73. package/bundles/skill-package/README.md +54 -0
  74. package/bundles/skill-package/blendops/LICENSE.txt +21 -0
  75. package/bundles/skill-package/blendops/SKILL.md +50 -0
  76. package/bundles/skill-package/blendops/agents/README.md +61 -0
  77. package/bundles/skill-package/blendops/agents/openai.yaml +4 -0
  78. package/bundles/skill-package/blendops/references/evidence-rules.md +17 -0
  79. package/bundles/skill-package/blendops/references/install-boundary.md +13 -0
  80. package/bundles/skill-package/blendops/references/law-evidence-before-done.md +12 -0
  81. package/bundles/skill-package/blendops/references/law-no-arbitrary-python-interface.md +7 -0
  82. package/bundles/skill-package/blendops/references/law-non-blender-user-language.md +8 -0
  83. package/bundles/skill-package/blendops/references/law-official-runtime-only.md +9 -0
  84. package/bundles/skill-package/blendops/references/pack-product-hero-v0.md +21 -0
  85. package/bundles/skill-package/blendops/references/runtime-stacks.md +13 -0
  86. package/bundles/skill-package/blendops/references/skill-acceptance-criteria-builder.md +51 -0
  87. package/bundles/skill-package/blendops/references/skill-asset-discovery.md +54 -0
  88. package/bundles/skill-package/blendops/references/skill-asset-fallback-strategy.md +48 -0
  89. package/bundles/skill-package/blendops/references/skill-asset-library-plan.md +51 -0
  90. package/bundles/skill-package/blendops/references/skill-asset-license-checker.md +51 -0
  91. package/bundles/skill-package/blendops/references/skill-asset-style-check.md +52 -0
  92. package/bundles/skill-package/blendops/references/skill-blender-brainstorming.md +43 -0
  93. package/bundles/skill-package/blendops/references/skill-blender-recipe-decomposer.md +48 -0
  94. package/bundles/skill-package/blendops/references/skill-blender-troubleshooting.md +59 -0
  95. package/bundles/skill-package/blendops/references/skill-blendops-help.md +62 -0
  96. package/bundles/skill-package/blendops/references/skill-bridge-conflicts.md +48 -0
  97. package/bundles/skill-package/blendops/references/skill-camera-composition.md +48 -0
  98. package/bundles/skill-package/blendops/references/skill-character-portrait.md +50 -0
  99. package/bundles/skill-package/blendops/references/skill-cli-appendix-job-outline.md +44 -0
  100. package/bundles/skill-package/blendops/references/skill-color-management-decision.md +50 -0
  101. package/bundles/skill-package/blendops/references/skill-composition-quality-checker.md +53 -0
  102. package/bundles/skill-package/blendops/references/skill-cycles-vs-eevee-decision.md +47 -0
  103. package/bundles/skill-package/blendops/references/skill-done-criteria.md +53 -0
  104. package/bundles/skill-package/blendops/references/skill-environment-shot.md +47 -0
  105. package/bundles/skill-package/blendops/references/skill-glb-animation-handoff.md +51 -0
  106. package/bundles/skill-package/blendops/references/skill-glb-web-handoff.md +51 -0
  107. package/bundles/skill-package/blendops/references/skill-intent-to-3d-brief-writer.md +50 -0
  108. package/bundles/skill-package/blendops/references/skill-interior-scene.md +54 -0
  109. package/bundles/skill-package/blendops/references/skill-lighting-material-plan.md +48 -0
  110. package/bundles/skill-package/blendops/references/skill-lighting-quality-checker.md +52 -0
  111. package/bundles/skill-package/blendops/references/skill-map.md +32 -0
  112. package/bundles/skill-package/blendops/references/skill-material-quality-checker.md +53 -0
  113. package/bundles/skill-package/blendops/references/skill-mobile-glb-budget.md +55 -0
  114. package/bundles/skill-package/blendops/references/skill-output-format-decision.md +46 -0
  115. package/bundles/skill-package/blendops/references/skill-pack-prerequisite-checker.md +56 -0
  116. package/bundles/skill-package/blendops/references/skill-path-one-host-outline.md +48 -0
  117. package/bundles/skill-package/blendops/references/skill-plain-language-response.md +53 -0
  118. package/bundles/skill-package/blendops/references/skill-polycount-budget-checker.md +53 -0
  119. package/bundles/skill-package/blendops/references/skill-pre-handoff-verification.md +57 -0
  120. package/bundles/skill-package/blendops/references/skill-preview-report.md +45 -0
  121. package/bundles/skill-package/blendops/references/skill-product-grid-scene-planner.md +54 -0
  122. package/bundles/skill-package/blendops/references/skill-product-hero-scene-planner.md +51 -0
  123. package/bundles/skill-package/blendops/references/skill-r3f-component-plan.md +48 -0
  124. package/bundles/skill-package/blendops/references/skill-recipe-fit-assessor.md +57 -0
  125. package/bundles/skill-package/blendops/references/skill-render-export-evidence.md +51 -0
  126. package/bundles/skill-package/blendops/references/skill-resolution-aspect-decision.md +48 -0
  127. package/bundles/skill-package/blendops/references/skill-runtime-attempt-report.md +49 -0
  128. package/bundles/skill-package/blendops/references/skill-runtime-path-picker.md +49 -0
  129. package/bundles/skill-package/blendops/references/skill-runtime-readiness.md +45 -0
  130. package/bundles/skill-package/blendops/references/skill-runtime-setup.md +45 -0
  131. package/bundles/skill-package/blendops/references/skill-scene-readiness.md +48 -0
  132. package/bundles/skill-package/blendops/references/skill-scope-guard.md +44 -0
  133. package/bundles/skill-package/blendops/references/skill-stage-gates.md +73 -0
  134. package/bundles/skill-package/blendops/references/skill-workflow-stage-router.md +49 -0
  135. package/docs/examples/glb-web-handoff/README.md +174 -0
  136. package/docs/examples/glb-web-handoff/r3f-glb-viewer.tsx +320 -0
  137. package/docs/examples/glb-web-handoff/threejs-glb-viewer.mjs +709 -0
  138. package/docs/knowledge-and-recipe-catalog.md +236 -0
  139. package/docs/recipes/README.md +27 -0
  140. package/docs/recipes/cyberpunk-shoe-hero.md +97 -0
  141. package/docs/workflows/README.md +14 -0
  142. package/docs/workflows/full-non-blender-user-workflow.md +210 -0
  143. package/docs/workflows/product-hero-workflow.md +92 -0
  144. package/laws/README.md +32 -0
  145. package/laws/evidence-before-done.md +37 -0
  146. package/laws/no-arbitrary-python-interface.md +32 -0
  147. package/laws/non-blender-user-language.md +32 -0
  148. package/laws/official-runtime-only.md +78 -0
  149. package/package.json +99 -4
  150. package/packs/README.md +11 -0
  151. package/packs/product-hero-v0/PACK.md +114 -0
  152. package/registry/catalog-index.json +21344 -0
  153. package/registry/compatibility-matrix.json +533 -0
  154. package/registry/contract-context-fields.json +391 -0
  155. package/registry/knowledge-catalog.json +4648 -0
  156. package/registry/knowledge-sources.json +438 -0
  157. package/registry/recipe-catalog.json +2565 -0
  158. package/registry/runtime-capability-policy.json +525 -0
  159. package/registry/runtime-operations.json +4468 -0
  160. package/registry/skills.json +10231 -0
  161. package/registry/workflow-graph.json +7390 -0
  162. package/schemas/adapter-compatibility-matrix.schema.json +166 -0
  163. package/schemas/contract-context-fields.schema.json +147 -0
  164. package/schemas/execution-plan.schema.json +325 -0
  165. package/schemas/glb-web-handoff-manifest.schema.json +744 -0
  166. package/schemas/knowledge-record.schema.json +460 -0
  167. package/schemas/knowledge-source-registry.schema.json +268 -0
  168. package/schemas/operation-execution-ledger.schema.json +348 -0
  169. package/schemas/recipe-record.schema.json +469 -0
  170. package/schemas/runtime-capability-policy.schema.json +184 -0
  171. package/schemas/runtime-evidence-packet.schema.json +211 -0
  172. package/schemas/runtime-operations.schema.json +535 -0
  173. package/schemas/runtime-qualification-report.schema.json +540 -0
  174. package/schemas/runtime-session.schema.json +350 -0
  175. package/schemas/scene-spec.schema.json +624 -0
  176. package/schemas/skill-contract.schema.json +402 -0
  177. package/schemas/skill-eval.schema.json +509 -0
  178. package/scripts/build-knowledge-catalog.mjs +2376 -0
  179. package/scripts/compile-scene-plan.mjs +1945 -0
  180. package/scripts/export-claude-skills.mjs +634 -0
  181. package/scripts/generate-glb-handoff-report.mjs +2376 -0
  182. package/scripts/inspect-glb.mjs +1627 -0
  183. package/scripts/install-skills.mjs +5369 -0
  184. package/scripts/runtime-orchestrator.mjs +7652 -0
  185. package/scripts/validate-capability-policy.mjs +531 -0
  186. package/scripts/validate-evidence-packet.mjs +256 -0
  187. package/skills/README.md +315 -0
  188. package/skills/_template/SKILL.md +296 -0
  189. package/skills/acceptance-criteria-builder/EVAL.md +25 -0
  190. package/skills/acceptance-criteria-builder/SKILL.md +257 -0
  191. package/skills/acceptance-criteria-builder/contract.json +205 -0
  192. package/skills/acceptance-criteria-builder/references/brief-to-criteria-mapper.md +22 -0
  193. package/skills/acceptance-criteria-builder/references/checklist-patterns.md +22 -0
  194. package/skills/acceptance-criteria-builder/references/evidence-hook-rules.md +19 -0
  195. package/skills/asset-discovery/EVAL.md +81 -0
  196. package/skills/asset-discovery/SKILL.md +252 -0
  197. package/skills/asset-discovery/contract.json +291 -0
  198. package/skills/asset-discovery/references/asset-strategy-decision-tree.md +40 -0
  199. package/skills/asset-discovery/references/budget-reconciliation-patterns.md +54 -0
  200. package/skills/asset-discovery/references/license-confidence-table.md +41 -0
  201. package/skills/asset-fallback-strategy/EVAL.md +34 -0
  202. package/skills/asset-fallback-strategy/SKILL.md +248 -0
  203. package/skills/asset-fallback-strategy/contract.json +190 -0
  204. package/skills/asset-fallback-strategy/references/drop-with-caveat-rules.md +36 -0
  205. package/skills/asset-fallback-strategy/references/fallback-option-types.md +55 -0
  206. package/skills/asset-fallback-strategy/references/scoring-rubric.md +61 -0
  207. package/skills/asset-library-plan/EVAL.md +28 -0
  208. package/skills/asset-library-plan/SKILL.md +263 -0
  209. package/skills/asset-library-plan/contract.json +177 -0
  210. package/skills/asset-library-plan/references/folder-structure-rules.md +63 -0
  211. package/skills/asset-library-plan/references/metadata-schema.md +62 -0
  212. package/skills/asset-library-plan/references/naming-rules.md +51 -0
  213. package/skills/asset-license-checker/EVAL.md +33 -0
  214. package/skills/asset-license-checker/SKILL.md +245 -0
  215. package/skills/asset-license-checker/contract.json +172 -0
  216. package/skills/asset-license-checker/references/attribution-rendering-patterns.md +48 -0
  217. package/skills/asset-license-checker/references/common-license-mapping.md +39 -0
  218. package/skills/asset-license-checker/references/license-source-rules.md +38 -0
  219. package/skills/asset-style-check/EVAL.md +26 -0
  220. package/skills/asset-style-check/SKILL.md +238 -0
  221. package/skills/asset-style-check/contract.json +251 -0
  222. package/skills/asset-style-check/references/drift-classification.md +40 -0
  223. package/skills/asset-style-check/references/intentional-mixed-style.md +39 -0
  224. package/skills/asset-style-check/references/style-axes.md +46 -0
  225. package/skills/blender-brainstorming/EVAL.md +79 -0
  226. package/skills/blender-brainstorming/SKILL.md +228 -0
  227. package/skills/blender-brainstorming/contract.json +115 -0
  228. package/skills/blender-brainstorming/references/alternative-scoping-templates.md +43 -0
  229. package/skills/blender-brainstorming/references/clarification-patterns.md +29 -0
  230. package/skills/blender-brainstorming/references/intent-summary-style-guide.md +25 -0
  231. package/skills/blender-recipe-decomposer/EVAL.md +35 -0
  232. package/skills/blender-recipe-decomposer/SKILL.md +258 -0
  233. package/skills/blender-recipe-decomposer/contract.json +152 -0
  234. package/skills/blender-recipe-decomposer/references/dependency-patterns.md +53 -0
  235. package/skills/blender-recipe-decomposer/references/recipe-grouping-rules.md +58 -0
  236. package/skills/blender-recipe-decomposer/references/recipe-naming-rules.md +44 -0
  237. package/skills/blender-troubleshooting/EVAL.md +78 -0
  238. package/skills/blender-troubleshooting/SKILL.md +263 -0
  239. package/skills/blender-troubleshooting/contract.json +352 -0
  240. package/skills/blender-troubleshooting/references/common-symptom-playbooks.md +51 -0
  241. package/skills/blender-troubleshooting/references/divergence-routing-table.md +23 -0
  242. package/skills/blender-troubleshooting/references/four-phase-template.md +51 -0
  243. package/skills/blendops-help/EVAL.md +67 -0
  244. package/skills/blendops-help/SKILL.md +312 -0
  245. package/skills/blendops-help/contract.json +229 -0
  246. package/skills/blendops-help/references/lifecycle-phases.md +91 -0
  247. package/skills/blendops-help/references/quick-start-prompts.md +65 -0
  248. package/skills/blendops-help/references/routing-decision-tree.md +57 -0
  249. package/skills/bridge-conflicts/EVAL.md +83 -0
  250. package/skills/bridge-conflicts/SKILL.md +246 -0
  251. package/skills/bridge-conflicts/contract.json +145 -0
  252. package/skills/bridge-conflicts/references/bridge-state-matrix-template.md +82 -0
  253. package/skills/bridge-conflicts/references/conflict-playbooks.md +99 -0
  254. package/skills/bridge-conflicts/references/do-not-reminders.md +42 -0
  255. package/skills/camera-composition/EVAL.md +32 -0
  256. package/skills/camera-composition/SKILL.md +196 -0
  257. package/skills/camera-composition/contract.json +180 -0
  258. package/skills/camera-composition/references/camera-presets.md +30 -0
  259. package/skills/camera-composition/references/camera-rubric.md +24 -0
  260. package/skills/camera-composition/references/hero-composition-patterns.md +24 -0
  261. package/skills/camera-composition/references/web-layout-negative-space.md +25 -0
  262. package/skills/character-portrait/EVAL.md +42 -0
  263. package/skills/character-portrait/SKILL.md +245 -0
  264. package/skills/character-portrait/contract.json +205 -0
  265. package/skills/character-portrait/references/portrait-framing-rules.md +39 -0
  266. package/skills/character-portrait/references/portrait-lighting-patterns.md +50 -0
  267. package/skills/character-portrait/references/style-consistency-rules.md +41 -0
  268. package/skills/cli-appendix-job-outline/EVAL.md +26 -0
  269. package/skills/cli-appendix-job-outline/SKILL.md +252 -0
  270. package/skills/cli-appendix-job-outline/contract.json +147 -0
  271. package/skills/cli-appendix-job-outline/references/flag-order-reminders.md +16 -0
  272. package/skills/cli-appendix-job-outline/references/job-type-matrix.md +13 -0
  273. package/skills/cli-appendix-job-outline/references/stateless-limitations.md +12 -0
  274. package/skills/color-management-decision/EVAL.md +28 -0
  275. package/skills/color-management-decision/SKILL.md +254 -0
  276. package/skills/color-management-decision/contract.json +162 -0
  277. package/skills/color-management-decision/references/look-comparison.md +44 -0
  278. package/skills/color-management-decision/references/per-channel-rules.md +49 -0
  279. package/skills/color-management-decision/references/pipeline-mapping.md +47 -0
  280. package/skills/composition-quality-checker/EVAL.md +38 -0
  281. package/skills/composition-quality-checker/SKILL.md +260 -0
  282. package/skills/composition-quality-checker/contract.json +221 -0
  283. package/skills/composition-quality-checker/references/aspect-ratio-rules.md +37 -0
  284. package/skills/composition-quality-checker/references/composition-rules.md +58 -0
  285. package/skills/composition-quality-checker/references/headroom-leadroom-rules.md +46 -0
  286. package/skills/cycles-vs-eevee-decision/EVAL.md +26 -0
  287. package/skills/cycles-vs-eevee-decision/SKILL.md +249 -0
  288. package/skills/cycles-vs-eevee-decision/contract.json +142 -0
  289. package/skills/cycles-vs-eevee-decision/references/engine-feature-matrix.md +39 -0
  290. package/skills/cycles-vs-eevee-decision/references/gpu-device-rules.md +51 -0
  291. package/skills/cycles-vs-eevee-decision/references/samples-by-quality.md +53 -0
  292. package/skills/done-criteria/EVAL.md +33 -0
  293. package/skills/done-criteria/SKILL.md +225 -0
  294. package/skills/done-criteria/contract.json +199 -0
  295. package/skills/done-criteria/references/done-vs-perfect.md +56 -0
  296. package/skills/done-criteria/references/out-of-scope-patterns.md +50 -0
  297. package/skills/done-criteria/references/stop-condition-templates.md +39 -0
  298. package/skills/environment-shot/EVAL.md +44 -0
  299. package/skills/environment-shot/SKILL.md +237 -0
  300. package/skills/environment-shot/contract.json +162 -0
  301. package/skills/environment-shot/references/depth-layering-rules.md +49 -0
  302. package/skills/environment-shot/references/time-and-weather-rules.md +35 -0
  303. package/skills/environment-shot/references/wide-shot-camera-rules.md +51 -0
  304. package/skills/glb-animation-handoff/EVAL.md +39 -0
  305. package/skills/glb-animation-handoff/SKILL.md +271 -0
  306. package/skills/glb-animation-handoff/contract.json +247 -0
  307. package/skills/glb-animation-handoff/references/animation-types.md +36 -0
  308. package/skills/glb-animation-handoff/references/transition-rules.md +55 -0
  309. package/skills/glb-animation-handoff/references/web-stack-caveats.md +40 -0
  310. package/skills/glb-web-handoff/EVAL.md +33 -0
  311. package/skills/glb-web-handoff/SKILL.md +212 -0
  312. package/skills/glb-web-handoff/contract.json +171 -0
  313. package/skills/glb-web-handoff/references/artifact-status-language.md +26 -0
  314. package/skills/glb-web-handoff/references/glb-handoff-checklist.md +30 -0
  315. package/skills/glb-web-handoff/references/performance-caveats.md +26 -0
  316. package/skills/glb-web-handoff/references/threejs-r3f-handoff.md +28 -0
  317. package/skills/intent-to-3d-brief-writer/EVAL.md +82 -0
  318. package/skills/intent-to-3d-brief-writer/SKILL.md +238 -0
  319. package/skills/intent-to-3d-brief-writer/contract.json +195 -0
  320. package/skills/intent-to-3d-brief-writer/references/acceptance-criteria-patterns.md +46 -0
  321. package/skills/intent-to-3d-brief-writer/references/eight-slot-template.md +123 -0
  322. package/skills/intent-to-3d-brief-writer/references/mixed-audience-handling.md +39 -0
  323. package/skills/interior-scene/EVAL.md +44 -0
  324. package/skills/interior-scene/SKILL.md +261 -0
  325. package/skills/interior-scene/contract.json +277 -0
  326. package/skills/interior-scene/references/furniture-layout-rules.md +51 -0
  327. package/skills/interior-scene/references/interior-architecture-rules.md +47 -0
  328. package/skills/interior-scene/references/interior-camera-rules.md +47 -0
  329. package/skills/lighting-material-plan/EVAL.md +32 -0
  330. package/skills/lighting-material-plan/SKILL.md +194 -0
  331. package/skills/lighting-material-plan/contract.json +213 -0
  332. package/skills/lighting-material-plan/references/cyberpunk-lookdev.md +22 -0
  333. package/skills/lighting-material-plan/references/lighting-patterns.md +30 -0
  334. package/skills/lighting-material-plan/references/material-portability.md +25 -0
  335. package/skills/lighting-material-plan/references/reflective-floor-pattern.md +22 -0
  336. package/skills/lighting-material-plan/references/web-material-simplification.md +23 -0
  337. package/skills/lighting-quality-checker/EVAL.md +41 -0
  338. package/skills/lighting-quality-checker/SKILL.md +247 -0
  339. package/skills/lighting-quality-checker/contract.json +187 -0
  340. package/skills/lighting-quality-checker/references/hdri-balance-rules.md +48 -0
  341. package/skills/lighting-quality-checker/references/intensity-ranges.md +73 -0
  342. package/skills/lighting-quality-checker/references/shadow-softness-rules.md +38 -0
  343. package/skills/material-quality-checker/EVAL.md +40 -0
  344. package/skills/material-quality-checker/SKILL.md +261 -0
  345. package/skills/material-quality-checker/contract.json +244 -0
  346. package/skills/material-quality-checker/references/consumer-stack-rules.md +62 -0
  347. package/skills/material-quality-checker/references/pbr-sanity-rules.md +78 -0
  348. package/skills/material-quality-checker/references/texture-budget-rules.md +48 -0
  349. package/skills/mobile-glb-budget/EVAL.md +40 -0
  350. package/skills/mobile-glb-budget/SKILL.md +264 -0
  351. package/skills/mobile-glb-budget/contract.json +309 -0
  352. package/skills/mobile-glb-budget/references/budget-tiers.md +30 -0
  353. package/skills/mobile-glb-budget/references/degradation-plan.md +34 -0
  354. package/skills/mobile-glb-budget/references/violation-rules.md +43 -0
  355. package/skills/output-format-decision/EVAL.md +27 -0
  356. package/skills/output-format-decision/SKILL.md +222 -0
  357. package/skills/output-format-decision/contract.json +179 -0
  358. package/skills/output-format-decision/references/bit-depth-rules.md +56 -0
  359. package/skills/output-format-decision/references/compression-tradeoffs.md +62 -0
  360. package/skills/output-format-decision/references/format-decision-matrix.md +34 -0
  361. package/skills/pack-prerequisite-checker/EVAL.md +26 -0
  362. package/skills/pack-prerequisite-checker/SKILL.md +272 -0
  363. package/skills/pack-prerequisite-checker/contract.json +214 -0
  364. package/skills/pack-prerequisite-checker/references/blocked-start-playbook.md +21 -0
  365. package/skills/pack-prerequisite-checker/references/pack-readiness-template.md +38 -0
  366. package/skills/pack-prerequisite-checker/references/prerequisite-matrix.md +20 -0
  367. package/skills/path-one-host-outline/EVAL.md +26 -0
  368. package/skills/path-one-host-outline/SKILL.md +251 -0
  369. package/skills/path-one-host-outline/contract.json +167 -0
  370. package/skills/path-one-host-outline/references/connector-vs-manual-matrix.md +21 -0
  371. package/skills/path-one-host-outline/references/host-checklist-template.md +35 -0
  372. package/skills/path-one-host-outline/references/lab-addon-reminders.md +12 -0
  373. package/skills/plain-language-response/EVAL.md +33 -0
  374. package/skills/plain-language-response/SKILL.md +194 -0
  375. package/skills/plain-language-response/contract.json +242 -0
  376. package/skills/plain-language-response/references/caveat-language.md +25 -0
  377. package/skills/plain-language-response/references/plain-language-patterns.md +30 -0
  378. package/skills/plain-language-response/references/stakeholder-friendly-examples.md +30 -0
  379. package/skills/plain-language-response/references/status-summary-templates.md +50 -0
  380. package/skills/polycount-budget-checker/EVAL.md +40 -0
  381. package/skills/polycount-budget-checker/SKILL.md +251 -0
  382. package/skills/polycount-budget-checker/contract.json +196 -0
  383. package/skills/polycount-budget-checker/references/instance-counting-rules.md +39 -0
  384. package/skills/polycount-budget-checker/references/per-mesh-rules.md +43 -0
  385. package/skills/polycount-budget-checker/references/topology-hints.md +56 -0
  386. package/skills/pre-handoff-verification/EVAL.md +84 -0
  387. package/skills/pre-handoff-verification/SKILL.md +252 -0
  388. package/skills/pre-handoff-verification/contract.json +295 -0
  389. package/skills/pre-handoff-verification/references/downgrade-rules.md +39 -0
  390. package/skills/pre-handoff-verification/references/seven-point-checklist.md +46 -0
  391. package/skills/pre-handoff-verification/references/text-only-mode-handling.md +36 -0
  392. package/skills/preview-report/EVAL.md +39 -0
  393. package/skills/preview-report/SKILL.md +254 -0
  394. package/skills/preview-report/contract.json +141 -0
  395. package/skills/preview-report/references/handoff-recipients.md +41 -0
  396. package/skills/preview-report/references/report-schema.md +60 -0
  397. package/skills/preview-report/references/truth-label-rules.md +36 -0
  398. package/skills/product-grid-scene-planner/EVAL.md +42 -0
  399. package/skills/product-grid-scene-planner/SKILL.md +246 -0
  400. package/skills/product-grid-scene-planner/contract.json +257 -0
  401. package/skills/product-grid-scene-planner/references/grid-consistency-rules.md +53 -0
  402. package/skills/product-grid-scene-planner/references/grid-layout-rules.md +42 -0
  403. package/skills/product-grid-scene-planner/references/grid-output-naming-rules.md +52 -0
  404. package/skills/product-hero-scene-planner/EVAL.md +33 -0
  405. package/skills/product-hero-scene-planner/SKILL.md +227 -0
  406. package/skills/product-hero-scene-planner/contract.json +228 -0
  407. package/skills/product-hero-scene-planner/references/clarification-patterns.md +24 -0
  408. package/skills/product-hero-scene-planner/references/cyberpunk-shoe-example.md +28 -0
  409. package/skills/product-hero-scene-planner/references/product-hero-playbooks.md +22 -0
  410. package/skills/product-hero-scene-planner/references/scene-plan-schema.md +35 -0
  411. package/skills/r3f-component-plan/EVAL.md +43 -0
  412. package/skills/r3f-component-plan/SKILL.md +290 -0
  413. package/skills/r3f-component-plan/contract.json +171 -0
  414. package/skills/r3f-component-plan/references/component-shape-patterns.md +54 -0
  415. package/skills/r3f-component-plan/references/suspense-placement-rules.md +50 -0
  416. package/skills/r3f-component-plan/references/usegltf-caching-rules.md +53 -0
  417. package/skills/recipe-fit-assessor/EVAL.md +28 -0
  418. package/skills/recipe-fit-assessor/SKILL.md +266 -0
  419. package/skills/recipe-fit-assessor/contract.json +220 -0
  420. package/skills/recipe-fit-assessor/references/recipe-catalog.md +30 -0
  421. package/skills/recipe-fit-assessor/references/scope-gap-rules.md +27 -0
  422. package/skills/recipe-fit-assessor/references/workflow-recommendation-template.md +34 -0
  423. package/skills/render-export-evidence/EVAL.md +86 -0
  424. package/skills/render-export-evidence/SKILL.md +339 -0
  425. package/skills/render-export-evidence/contract.json +206 -0
  426. package/skills/render-export-evidence/references/attempted-vs-failed-rubric.md +75 -0
  427. package/skills/render-export-evidence/references/evidence-record-templates.md +143 -0
  428. package/skills/render-export-evidence/references/truth-label-decision-tree.md +57 -0
  429. package/skills/resolution-aspect-decision/EVAL.md +26 -0
  430. package/skills/resolution-aspect-decision/SKILL.md +246 -0
  431. package/skills/resolution-aspect-decision/contract.json +160 -0
  432. package/skills/resolution-aspect-decision/references/aspect-defaults.md +41 -0
  433. package/skills/resolution-aspect-decision/references/print-vs-screen-rules.md +58 -0
  434. package/skills/resolution-aspect-decision/references/resolution-defaults.md +64 -0
  435. package/skills/runtime-attempt-report/EVAL.md +26 -0
  436. package/skills/runtime-attempt-report/SKILL.md +268 -0
  437. package/skills/runtime-attempt-report/contract.json +176 -0
  438. package/skills/runtime-attempt-report/references/attempt-record-template.md +49 -0
  439. package/skills/runtime-attempt-report/references/triage-next-steps.md +15 -0
  440. package/skills/runtime-attempt-report/references/truth-label-blocks.md +27 -0
  441. package/skills/runtime-path-picker/EVAL.md +26 -0
  442. package/skills/runtime-path-picker/SKILL.md +268 -0
  443. package/skills/runtime-path-picker/contract.json +191 -0
  444. package/skills/runtime-path-picker/references/anti-patterns.md +14 -0
  445. package/skills/runtime-path-picker/references/decision-tree.md +29 -0
  446. package/skills/runtime-path-picker/references/path-constraints-table.md +18 -0
  447. package/skills/runtime-readiness/EVAL.md +33 -0
  448. package/skills/runtime-readiness/SKILL.md +218 -0
  449. package/skills/runtime-readiness/contract.json +190 -0
  450. package/skills/runtime-readiness/references/blocker-report-template.md +28 -0
  451. package/skills/runtime-readiness/references/evidence-examples.md +23 -0
  452. package/skills/runtime-readiness/references/readiness-matrix.md +46 -0
  453. package/skills/runtime-setup/EVAL.md +33 -0
  454. package/skills/runtime-setup/SKILL.md +209 -0
  455. package/skills/runtime-setup/contract.json +171 -0
  456. package/skills/runtime-setup/references/runtime-option-decision-tree.md +28 -0
  457. package/skills/runtime-setup/references/setup-summary-template.md +33 -0
  458. package/skills/runtime-setup/references/source-confidence-labels.md +23 -0
  459. package/skills/scene-readiness/EVAL.md +33 -0
  460. package/skills/scene-readiness/SKILL.md +195 -0
  461. package/skills/scene-readiness/contract.json +198 -0
  462. package/skills/scene-readiness/references/blocker-catalog.md +24 -0
  463. package/skills/scene-readiness/references/not-run-handling.md +22 -0
  464. package/skills/scene-readiness/references/quality-rubric.md +23 -0
  465. package/skills/scene-readiness/references/verdict-language.md +22 -0
  466. package/skills/scope-guard/EVAL.md +33 -0
  467. package/skills/scope-guard/SKILL.md +222 -0
  468. package/skills/scope-guard/contract.json +171 -0
  469. package/skills/scope-guard/references/options-language-template.md +51 -0
  470. package/skills/scope-guard/references/recurring-creep-patterns.md +55 -0
  471. package/skills/scope-guard/references/scope-addition-classification.md +55 -0
  472. package/skills/stage-gates/EVAL.md +40 -0
  473. package/skills/stage-gates/SKILL.md +257 -0
  474. package/skills/stage-gates/contract.json +490 -0
  475. package/skills/stage-gates/references/failed-gate-handling.md +42 -0
  476. package/skills/stage-gates/references/gate-template.md +46 -0
  477. package/skills/stage-gates/references/stage-decomposition-patterns.md +55 -0
  478. package/skills/workflow-stage-router/EVAL.md +25 -0
  479. package/skills/workflow-stage-router/SKILL.md +259 -0
  480. package/skills/workflow-stage-router/contract.json +150 -0
  481. package/skills/workflow-stage-router/references/milestone-model.md +20 -0
  482. package/skills/workflow-stage-router/references/routing-decision-tree.md +32 -0
  483. package/skills/workflow-stage-router/references/stage-handoff-template.md +37 -0
  484. package/skills.sh.json +102 -0
@@ -0,0 +1,171 @@
1
+ {
2
+ "$schema": "../../schemas/skill-contract.schema.json",
3
+ "id": "scope-guard",
4
+ "version": "1.0.0",
5
+ "category": "process-discipline",
6
+ "role": "scope-creep-and-change-request-guard",
7
+ "purpose": "Detect mid-recipe scope creep and push back constructively before the recipe drifts; require explicit user agreement before scope expansion.",
8
+ "capabilityTier": "L0",
9
+ "triggers": [
10
+ "can you also",
11
+ "while you're at it",
12
+ "actually let's also",
13
+ "one more thing"
14
+ ],
15
+ "exclusions": [
16
+ {
17
+ "condition": "early planning before scope is pinned",
18
+ "delegateTo": "done-criteria",
19
+ "reason": "use intent-to-3d-brief-writer and done-criteria"
20
+ },
21
+ {
22
+ "condition": "pure brainstorming with no active recipe",
23
+ "delegateTo": "blender-brainstorming",
24
+ "reason": "use blender-brainstorming"
25
+ },
26
+ {
27
+ "condition": "when the addition is already explicitly covered by existing gate criteria in stage-gates / acceptance-criteria-builder (verified against w",
28
+ "delegateTo": "acceptance-criteria-builder",
29
+ "reason": "verified against written criteria, never judged by feel"
30
+ }
31
+ ],
32
+ "inputs": {
33
+ "required": [
34
+ {
35
+ "name": "locked_baseline_brief",
36
+ "type": "object",
37
+ "description": "Currently locked 3D brief, acceptance criteria, and stop conditions"
38
+ },
39
+ {
40
+ "name": "proposed_scope_change",
41
+ "type": "string",
42
+ "description": "Mid-workflow user request adding new deliverables, environments, animations, or scope"
43
+ }
44
+ ],
45
+ "optional": [
46
+ {
47
+ "name": "current_workflow_stage",
48
+ "type": "string",
49
+ "description": "Active stage when the scope expansion was requested"
50
+ }
51
+ ]
52
+ },
53
+ "outputs": {
54
+ "primary": [
55
+ "scope_classification_verdict",
56
+ "impact_on_locked_brief_and_budget",
57
+ "defer_split_or_reopen_decision"
58
+ ],
59
+ "truthStatePolicy": {
60
+ "runtimeDefault": "Not Run",
61
+ "artifactDefault": "Not Produced",
62
+ "mutationRule": "downgrade_only"
63
+ }
64
+ },
65
+ "handoffs": [
66
+ {
67
+ "target": "intent-to-3d-brief-writer",
68
+ "type": "upstream_reference",
69
+ "label": "Original brief",
70
+ "when": {
71
+ "all": [
72
+ {
73
+ "field": "goal.clarity",
74
+ "operator": "equals",
75
+ "value": "clear"
76
+ },
77
+ {
78
+ "field": "brief.locked",
79
+ "operator": "equals",
80
+ "value": false
81
+ }
82
+ ]
83
+ }
84
+ },
85
+ {
86
+ "target": "done-criteria",
87
+ "type": "upstream_reference",
88
+ "label": "Stop condition pinned beforehand / updated on expansion",
89
+ "when": {
90
+ "all": [
91
+ {
92
+ "field": "brief.locked",
93
+ "operator": "equals",
94
+ "value": true
95
+ },
96
+ {
97
+ "field": "stage.current",
98
+ "operator": "equals",
99
+ "value": "stop_condition"
100
+ }
101
+ ]
102
+ }
103
+ },
104
+ {
105
+ "target": "stage-gates",
106
+ "type": "upstream_reference",
107
+ "label": "Per-stage gates enforced / updated on expansion",
108
+ "when": {
109
+ "all": [
110
+ {
111
+ "field": "brief.locked",
112
+ "operator": "equals",
113
+ "value": true
114
+ },
115
+ {
116
+ "field": "stage.current",
117
+ "operator": "equals",
118
+ "value": "stage_gates"
119
+ }
120
+ ]
121
+ }
122
+ },
123
+ {
124
+ "target": "acceptance-criteria-builder",
125
+ "type": "boundary_delegation",
126
+ "label": "Measurable acceptance rows for added scope",
127
+ "when": {
128
+ "all": [
129
+ {
130
+ "field": "brief.locked",
131
+ "operator": "equals",
132
+ "value": true
133
+ },
134
+ {
135
+ "field": "stage.current",
136
+ "operator": "equals",
137
+ "value": "acceptance_criteria"
138
+ }
139
+ ]
140
+ }
141
+ },
142
+ {
143
+ "target": "blender-recipe-decomposer",
144
+ "type": "boundary_delegation",
145
+ "label": "Deferred scope split into follow-up recipes",
146
+ "when": {
147
+ "all": [
148
+ {
149
+ "field": "fit.multiDeliverableDetected",
150
+ "operator": "equals",
151
+ "value": true
152
+ }
153
+ ]
154
+ }
155
+ },
156
+ {
157
+ "target": "pre-handoff-verification",
158
+ "type": "progression",
159
+ "label": "Delivery gate after scope and gates settle",
160
+ "when": {
161
+ "all": [
162
+ {
163
+ "field": "stage.current",
164
+ "operator": "equals",
165
+ "value": "final_verification"
166
+ }
167
+ ]
168
+ }
169
+ }
170
+ ]
171
+ }
@@ -0,0 +1,51 @@
1
+ # Options-language template
2
+
3
+ ## The 3 options (always offer all three)
4
+
5
+ ### 1. Decline
6
+
7
+ "Proceed with original scope."
8
+
9
+ When to recommend:
10
+ - Addition contradicts the brief.
11
+ - Time / budget exhausted.
12
+ - The user is in evaluation mode, not commitment mode.
13
+
14
+ ### 2. Add now (with agreement)
15
+
16
+ "Agree to new scope: <updated stop condition>. Cost: <time / gate / budget>."
17
+
18
+ When to recommend:
19
+ - Addition is small or medium AND fits the same recipe semantically.
20
+ - Time budget allows.
21
+ - The addition strengthens the original deliverable rather than diluting it.
22
+
23
+ ### 3. Defer
24
+
25
+ "Track as follow-up recipe (no current scope change)."
26
+
27
+ When to recommend:
28
+ - Addition is large or new modality.
29
+ - Brief already locked.
30
+ - Adding now would multiply gates beyond manageability.
31
+ - Deferral is almost always safer than absorption.
32
+
33
+ ## Phrasing tips
34
+
35
+ - Always show all three options, even if recommending one.
36
+ - State the **cost** of "add now" explicitly (time, gates, budget).
37
+ - State the **followup-recipe-name** for "defer" (helps the user track it).
38
+ - Use neutral language; do not push the user toward your preference.
39
+
40
+ ## Decision evidence
41
+
42
+ When the user picks an option, record it:
43
+ - Picked option (1 / 2 / 3)
44
+ - Time of agreement
45
+ - Updated stop condition (if option 2)
46
+ - Follow-up recipe name (if option 3)
47
+
48
+ This serves as evidence per `evidence-before-done.md` for the scope state.
49
+
50
+ ## Related skill
51
+ `../SKILL.md`
@@ -0,0 +1,55 @@
1
+ # Recurring creep patterns
2
+
3
+ When the same user repeatedly drives scope creep, the pattern itself is the issue. Catch it.
4
+
5
+ ## Common patterns
6
+
7
+ ### Pattern A: "Just one more thing"
8
+ - 3+ small additions in one recipe.
9
+ - Each individually trivial; together they double scope.
10
+ - Response: pause and propose a follow-up recipe to bundle the additions.
11
+
12
+ ### Pattern B: Late-stage feature requests
13
+ - User adds substantive features after the render gate has run.
14
+ - Response: hold the line; defer to follow-up. Re-running gates with new scope is expensive.
15
+
16
+ ### Pattern C: Scope grows under deadline pressure
17
+ - "We're already running this, can we squeeze in X?"
18
+ - Response: explicit cost language; let the user weigh deadline vs scope.
19
+
20
+ ### Pattern D: Brief revision masquerading as addition
21
+ - "Actually let's also flip the brand to Y" mid-recipe.
22
+ - This is a brief revision, not a scope addition. Pause; revise brief; restart relevant stages.
23
+
24
+ ### Pattern E: Polish creep
25
+ - "Looks great, but can we tweak X for the tenth time?"
26
+ - Stop condition has been met. Revisit with `done-criteria`.
27
+
28
+ ## Why catch the pattern
29
+
30
+ A single addition is trivial. A repeated pattern compounds:
31
+ - Gates lose meaning.
32
+ - Stop condition drifts.
33
+ - Time multiplies.
34
+ - Recipe quality degrades.
35
+
36
+ ## Response per pattern
37
+
38
+ | Pattern | Suggested response |
39
+ |---|---|
40
+ | A — "just one more" | Pause; propose follow-up recipe to bundle |
41
+ | B — late-stage requests | Hold gate; defer |
42
+ | C — deadline pressure | Cost-explicit options |
43
+ | D — brief revision | Reset brief; restart relevant stages |
44
+ | E — polish creep | Reaffirm stop condition |
45
+
46
+ ## When to escalate
47
+
48
+ If patterns A-E repeat across multiple recipes, propose a process retro:
49
+ - Are briefs scoped tightly enough?
50
+ - Are stop conditions concrete enough?
51
+ - Is the recipe size right?
52
+ - Is the user actually exploring rather than committing?
53
+
54
+ ## Related skill
55
+ `../SKILL.md`
@@ -0,0 +1,55 @@
1
+ # Scope addition classification
2
+
3
+ ## Classification table
4
+
5
+ | Class | Indicator | Recommendation |
6
+ |---|---|---|
7
+ | Trivial | Within current gate; <5% extra effort | Mention, may absorb |
8
+ | Small | 5-15% extra effort; one new gate or tweak | Offer 3 options; lean accept |
9
+ | Medium | 15-30% extra; new sub-stage; new asset | Offer 3 options; balanced |
10
+ | Large | >30% extra; new modality (animation, multi-render); new render path | Recommend defer |
11
+ | Brief-contradicting | Conflicts with original brief | Pause; revise brief first |
12
+
13
+ ## Effort estimates
14
+
15
+ Time is the cleanest signal. Estimate:
16
+ - Original recipe time
17
+ - Addition's marginal time
18
+ - New total
19
+
20
+ If new total > 1.5× original → Medium or Large.
21
+ If addition adds new render queue items → at least Medium.
22
+ If addition needs new asset sourcing → at least Medium.
23
+
24
+ ## Examples per class
25
+
26
+ ### Trivial
27
+ - Slight color tweak in existing material
28
+ - Adjusted camera distance by 10cm
29
+ - Renamed output file
30
+
31
+ ### Small
32
+ - Add one extra prop in scene
33
+ - Render one extra frame
34
+ - Slightly stricter samples count
35
+
36
+ ### Medium
37
+ - Add second camera angle of same scene
38
+ - Add one variant of a material
39
+ - Add HDRI swap render
40
+
41
+ ### Large
42
+ - Add 4 product variants
43
+ - Add animation
44
+ - Add interior environment to product hero scene
45
+ - Add 4K version
46
+
47
+ ### Brief-contradicting
48
+ - "Make it look more like X" where X is incompatible with the existing mood/style locked in brief
49
+
50
+ ## Why classify
51
+
52
+ The class drives recommendation. Without classification, every addition risks being silently absorbed.
53
+
54
+ ## Related skill
55
+ `../SKILL.md`
@@ -0,0 +1,40 @@
1
+ # EVAL — stage-gates
2
+
3
+ ## Text-only eval prompt
4
+ Use stage-gates on the cyberpunk shoe hero recipe (7 stages).
5
+
6
+ ## Expected behavior
7
+ - 7 stages listed in linear order
8
+ - Per-stage gate with 3-5 concrete acceptance criteria
9
+ - Evidence required per gate explicit
10
+ - Per-stage handoff to domain skill
11
+ - Current state explicit (`Pending` since text-only)
12
+ - "Failed gate stops work" rule stated
13
+ - Final handoff to pre-handoff-verification
14
+
15
+ ## Pass / Warn / Fail criteria
16
+ - Pass: 7 stages + concrete gates + evidence required + handoff per stage + final pre-handoff named
17
+ - Warn: one gate vague, one stage missing evidence row
18
+ - Fail: vague gates throughout, skipped stages, parallel stages without justification
19
+
20
+ ## Common failure modes
21
+ - "Stage looks good" gates
22
+ - Inventing criteria at gate time
23
+ - Marking Pass without evidence
24
+ - Skipping the final pre-handoff handoff
25
+
26
+ ## Evidence expectations
27
+ - per-stage row with concrete checks
28
+ - per-stage handoff named
29
+ - failed-gate action stated
30
+
31
+ ## Sample passing response outline
32
+ - Recipe header
33
+ - 7-row stage table
34
+ - Failed gate action
35
+ - Final handoff to pre-handoff-verification
36
+
37
+ ## Sample failing response outline
38
+ - Vague "checklist" without per-stage rows
39
+ - "Looks good" gates
40
+ - No final handoff
@@ -0,0 +1,257 @@
1
+ ---
2
+ name: stage-gates
3
+ description: Define explicit per-stage gates and acceptance checklists before any modeling, render, or export work — work only proceeds gate by gate.
4
+ ---
5
+
6
+ # stage-gates
7
+
8
+ ## Purpose
9
+ Enforce a checklist-driven discipline where every stage of a Blender recipe (brief → asset → scene → render → export → handoff) has a written acceptance gate. Work does not advance until the previous stage's gate is checked off. Inspired by Anthropic Superpowers `/test-driven-development` analog: gate first, work second.
10
+
11
+ ## Quick start
12
+ - list the stages of the user's recipe
13
+ - write the gate per stage (specific, checkable conditions)
14
+ - run the gate after each stage; do not proceed if it fails
15
+ - record the gate result + evidence per stage
16
+
17
+ ## When to use
18
+ - complex multi-stage recipe (4+ distinct stages) requiring per-stage gate enforcement
19
+ - when work must be locked behind explicit `Pending | Pass | Fail | Blocked` stage gates before advancing
20
+ - when the user wants verifiable proof that each stage passes its checks before starting the next stage
21
+ - before any runtime work begins, to lock concrete checks, required evidence, and failure exits per stage
22
+
23
+ ## When not to use
24
+ <!-- blendops:generated:start exclusions -->
25
+ - single-step requests → use `../blender-brainstorming/SKILL.md` (Delegates out-of-scope requests to blender-brainstorming)
26
+ - pure exploratory brainstorming → use `../blender-brainstorming/SKILL.md` (use blender-brainstorming)
27
+ - decomposing a brief into stages → use `../blender-recipe-decomposer/SKILL.md` (use blender-recipe-decomposer)
28
+ - writing measurable acceptance criteria rows from scratch → use `../acceptance-criteria-builder/SKILL.md` (use acceptance-criteria-builder)
29
+ - pinning the overall done/stop condition → use `../done-criteria/SKILL.md` (use done-criteria)
30
+ - guarding against mid-flight scope creep → use `../scope-guard/SKILL.md` (use scope-guard)
31
+ - selecting which skill runs next across the workflow → use `../workflow-stage-router/SKILL.md` (use workflow-stage-router)
32
+ - fixing repeated stage failures or broken renders → use `../blender-troubleshooting/SKILL.md` (use blender-troubleshooting)
33
+ - executing the final 7-point handoff gate → use `../pre-handoff-verification/SKILL.md` (use pre-handoff-verification)
34
+ <!-- blendops:generated:end exclusions -->
35
+
36
+ ## Trigger phrases
37
+ <!-- blendops:generated:start triggers -->
38
+ - "let's do this step by step"
39
+ - "what's done before we move on"
40
+ - "checklist for this work"
41
+ - "I want to make sure each stage is solid"
42
+ <!-- blendops:generated:end triggers -->
43
+
44
+ ## Prerequisites / readiness
45
+ - recipe stages identified (or willing to identify them)
46
+ - user accepts gate-driven discipline (not all do)
47
+
48
+ ## Input schema
49
+
50
+ ### Required inputs
51
+
52
+ | Input | Why it is required |
53
+ |---|---|
54
+ | Recipe stages | Defines gate count |
55
+ | Acceptance criteria per stage | Drives gate content |
56
+ | Mode (text-only / runtime-ready) | Determines what gates can verify |
57
+
58
+ ### Optional inputs
59
+
60
+ | Input | Use |
61
+ |---|---|
62
+ | Reference images / specs | Drives stage-specific acceptance |
63
+ | Time budget | Allows gate prioritization |
64
+
65
+ ### Assumptions to confirm
66
+ - The user agrees not to skip gates.
67
+ - "Acceptance criteria" are pre-agreed, not invented at gate time.
68
+ - A failing gate stops work until resolved.
69
+
70
+ ## Output schema
71
+
72
+ ### Primary output
73
+ A per-stage gate table written BEFORE stage work begins: stage name, concrete checks (3-5 explicit checks consuming rows from `acceptance-criteria-builder`), evidence required, failure exit, and current gate state (`Pending` | `Pass` | `Fail` | `Blocked`).
74
+
75
+ ### Secondary output
76
+ - the linear order in which gates must be evaluated
77
+ - explicit failure exits per gate (stop work immediately on `Fail`; route repeated failures to `blender-troubleshooting`)
78
+ - delegation to `workflow-stage-router` to pick the next domain skill after a gate reaches `Pass`
79
+
80
+ ### Evidence / caveat output
81
+ Keep gate states (`Pending | Pass | Fail | Blocked`) strictly separate from runtime truth states and artifact states. Truth states are downgrade-only, never upgrade:
82
+
83
+ ```txt
84
+ Runtime status: Not Run | Attempted | Produced | Verified | Failed
85
+ Artifact status: Not Produced | Produced | Verified | Failed
86
+ Evidence used: <links, paths, logs, or "none">
87
+ Limitations: <known gaps>
88
+ ```
89
+
90
+ ## Required laws
91
+ - `../../laws/evidence-before-done.md`
92
+ - `../../laws/non-blender-user-language.md`
93
+ - `../../laws/no-arbitrary-python-interface.md`
94
+ - `../../laws/official-runtime-only.md`
95
+
96
+ ## Official runtime boundary
97
+
98
+ Process / discipline skill — does not run Blender. Gates are written and evaluated against produced artifacts (per `evidence-before-done.md`). Gate verdicts are honest labels, not motivation.
99
+
100
+ ## Operating procedure
101
+ 1. Confirm the linear recipe stages (using output from `blender-recipe-decomposer` if not yet decomposed).
102
+ 2. BEFORE any stage work begins, write the per-stage gate for every stage: concrete checks (consuming measurable rows from `acceptance-criteria-builder`), required evidence, and explicit failure exits (see `references/gate-template.md`).
103
+ 3. Pin the gate sequence in linear order; no parallel stages without explicit justification.
104
+ 4. After each stage's work, evaluate the gate and update its gate state (`Pending` → `Pass` or `Fail`), keeping gate vocabulary separate from runtime truth states (`Not Run | Attempted | Produced | Verified | Failed`) and artifact states (default `Not Produced`).
105
+ 5. If a gate is `Fail`: stop work immediately and execute the gate's failure exit; if a gate fails repeatedly, hand off to `blender-troubleshooting`.
106
+ 6. If a gate is `Pass`: advance to the next stage (using `workflow-stage-router` to pick the next skill if needed).
107
+ 7. Once all per-stage gates are `Pass`, hand off to `pre-handoff-verification` for the final 7-point gate.
108
+
109
+ ## Decision tree
110
+
111
+ ```txt
112
+ User wants to skip a stage?
113
+ → Push back; document as risk if user insists
114
+ A previous gate is `Fail` but later stage was attempted anyway?
115
+ → Stop; mark all subsequent stages `Blocked`
116
+ Two stages claimed `Pass` simultaneously?
117
+ → Suspicious; verify each independently
118
+ Gate criteria are vague ("looks good")?
119
+ → Re-write with concrete checks; do not run an undefined gate
120
+ ```
121
+
122
+ ## Playbooks
123
+
124
+ ### Playbook A: Cyberpunk shoe hero (7 stages)
125
+ Stages: brief → scene plan → asset discovery → scene build → render → export → handoff. One gate per stage.
126
+
127
+ ### Playbook B: Multi-product grid (5 stages)
128
+ Stages: brief → grid plan → consistency setup → render → export. One gate per stage; gate 3 = "all cells render identical at sub-resolution".
129
+
130
+ ### Playbook C: Character portrait (6 stages)
131
+ Stages: brief → portrait plan → asset discovery → lookdev → render → handoff. Gate 4 = "lookdev approved against mood brief".
132
+
133
+ ## Mode handling
134
+
135
+ ### Text-only mode
136
+ Gates evaluate plans and specs only. Pre-runtime planning gates can be evaluated (`Pending | Pass | Fail | Blocked`), while runtime-dependent gates remain `Pending` or `Blocked`. Separately, runtime truth state remains `Not Run` and artifact state defaults to `Not Produced` (never assign `Not Run` as a gate state).
137
+
138
+ ### Runtime-ready mode
139
+ Gates evaluate produced artifacts using `Pending | Pass | Fail | Blocked` against honest runtime truth states (`Not Run | Attempted | Produced | Verified | Failed`) and artifact states (default `Not Produced`) per `evidence-before-done.md`. Truth states are downgrade-only, never upgrade.
140
+
141
+ ### Blocked runtime mode
142
+ Pre-runtime gates can reach `Pass`, while runtime/artifact-dependent gates remain `Blocked`. Runtime truth state stays `Not Run` (or `Failed` if attempted and broken) and artifact state remains `Not Produced`.
143
+
144
+ ## Validation checklist
145
+ - [ ] Stages listed in linear order
146
+ - [ ] Gates written BEFORE stage work begins
147
+ - [ ] Concrete checks (3-5 per gate), required evidence, and failure exits explicit for every gate
148
+ - [ ] Gate states use only `Pending | Pass | Fail | Blocked`
149
+ - [ ] Runtime truth states (`Not Run | Attempted | Produced | Verified | Failed`) and artifact states (default `Not Produced`) are kept separate from gate states and downgrade-only
150
+ - [ ] No vague "looks good" gate
151
+ - [ ] Failing gate stops work immediately
152
+ - [ ] Final handoff to `pre-handoff-verification` present
153
+
154
+ ## Pass / Warn / Fail rubric
155
+
156
+ | Verdict | Criteria |
157
+ |---|---|
158
+ | Pass | All stages have written gates; evidence required is concrete; no skipped or vague gates. |
159
+ | Warn | One gate has soft criteria ("looks acceptable"); one stage missing evidence row. |
160
+ | Fail | Vague gates throughout; gates skipped; later stage `Pass` without earlier gate `Pass`. |
161
+
162
+ ## Failure handling
163
+ - Vague criteria → rewrite with concrete checks.
164
+ - User pushes to skip → document as risk; require explicit acknowledgment.
165
+ - Gate fails repeatedly → hand off to `blender-troubleshooting`.
166
+
167
+ ## Troubleshooting
168
+
169
+ | Problem | Response |
170
+ |---|---|
171
+ | Gate criteria invented at gate time | Reset; write gates (checks, evidence, failure exits) BEFORE stage work begins. |
172
+ | Gate `Pass` without evidence | Mark gate `Pending` or `Fail` and require evidence; downgrade runtime/artifact truth states accordingly (truth states are downgrade-only, never upgrade). |
173
+ | Gate state marked `Not Run` or `Verified` | Fix vocabulary conflation: gates use `Pending | Pass | Fail | Blocked`; runtime truth uses `Not Run | Attempted | Produced | Verified | Failed`; artifacts default to `Not Produced`. |
174
+ | Repeated `Fail` on the same gate | Stop work; hand off to `blender-troubleshooting`. |
175
+
176
+ ## Best practices
177
+ - Write gates BEFORE the stage work begins.
178
+ - Gates contain concrete checks (numbers, paths, file existence) — not feelings.
179
+ - Stop work on first `Fail`; do not "we'll fix it in the next stage".
180
+ - Pair every gate with a fallback action.
181
+
182
+ ## Good examples
183
+ - "Stage 4 (render) gate — written before render work: Checks: `out/render-2026-05-09.png` exists, dimensions 1920×1080, samples >= 128, render time logged. Evidence required: file path + visible image + render log snippet. Failure exit: stop work immediately; if fails twice, hand off to `blender-troubleshooting`. Gate state: `Pending`."
184
+
185
+ ## Bad examples
186
+ - "Stage 4 gate: render looks good." — vague.
187
+
188
+ ## User-facing response template
189
+
190
+ ```txt
191
+ Recipe: <name>
192
+ Stages (linear order, written before work begins):
193
+
194
+ | # | Stage | Concrete checks (3-5) | Evidence required | Failure exit | Gate state |
195
+ |---|---|---|---|---|---|
196
+ | 1 | <stage> | <3-5 concrete checks> | <path / file / measurement> | Stop work; <re-do or hand off to blender-troubleshooting on repeated fail> | Pending / Pass / Fail / Blocked |
197
+ | 2 | … | … | … | … | … |
198
+
199
+ Next skill routing (on Pass): hand off to workflow-stage-router
200
+ Final handoff (after all stage gates Pass): pre-handoff-verification
201
+
202
+ Runtime status: Not Run | Attempted | Produced | Verified | Failed
203
+ Artifact status: Not Produced | Produced | Verified | Failed
204
+ Evidence used: <links, paths, logs, or "none">
205
+ Limitations: <gaps>
206
+ ```
207
+
208
+ ## Anti-patterns
209
+ - Vague gate criteria ("looks good").
210
+ - Skipping gates or advancing after a `Fail` gate.
211
+ - Inventing gate checks or failure exits after stage work has already started.
212
+ - Running parallel stages without explicit justification.
213
+ - Conflating gate states (`Pending | Pass | Fail | Blocked`) with runtime truth states (`Not Run | Attempted | Produced | Verified | Failed`) or artifact states (default `Not Produced`).
214
+ - Upgrading runtime or artifact truth states (truth states are downgrade-only).
215
+ - Blurring boundaries with `acceptance-criteria-builder`, `done-criteria`, `scope-guard`, `workflow-stage-router`, or `pre-handoff-verification`.
216
+
217
+ ## Cross-skill handoff
218
+ <!-- blendops:generated:start handoffs -->
219
+ - [upstream_reference] Brainstorming → `../blender-brainstorming/SKILL.md`
220
+ - [upstream_reference] Brief authoring → `../intent-to-3d-brief-writer/SKILL.md`
221
+ - [upstream_reference] Recipe stage decomposition → `../blender-recipe-decomposer/SKILL.md`
222
+ - [upstream_reference] Measurable acceptance rows → `../acceptance-criteria-builder/SKILL.md`
223
+ - [upstream_reference] Overall done condition → `../done-criteria/SKILL.md`
224
+ - [progression] Scope creep protection → `../scope-guard/SKILL.md`
225
+ - [progression] Next-skill routing across stages → `../workflow-stage-router/SKILL.md`
226
+ - [progression] Asset discovery → `../asset-discovery/SKILL.md`
227
+ - [progression] Scene planners (camera-composition) → `../camera-composition/SKILL.md`
228
+ - [progression] Scene planners (lighting-material-plan) → `../lighting-material-plan/SKILL.md`
229
+ - [alternative] Scene planners (character-portrait) → `../character-portrait/SKILL.md`
230
+ - [alternative] Scene planners (environment-shot) → `../environment-shot/SKILL.md`
231
+ - [alternative] Scene planners (interior-scene) → `../interior-scene/SKILL.md`
232
+ - [alternative] Scene planners (product-grid-scene-planner) → `../product-grid-scene-planner/SKILL.md`
233
+ - [alternative] Scene planners (product-hero-scene-planner) → `../product-hero-scene-planner/SKILL.md`
234
+ - [progression] Quality validators (scene-readiness) → `../scene-readiness/SKILL.md`
235
+ - [progression] Quality validators (composition-quality-checker) → `../composition-quality-checker/SKILL.md`
236
+ - [progression] Quality validators (lighting-quality-checker) → `../lighting-quality-checker/SKILL.md`
237
+ - [progression] Quality validators (material-quality-checker) → `../material-quality-checker/SKILL.md`
238
+ - [progression] Quality validators (polycount-budget-checker) → `../polycount-budget-checker/SKILL.md`
239
+ - [fallback] Repeated gate failures → `../blender-troubleshooting/SKILL.md`
240
+ - [progression] Final 7-point gate → `../pre-handoff-verification/SKILL.md`
241
+ <!-- blendops:generated:end handoffs -->
242
+
243
+ ## Non-goals
244
+ - Run Blender or execute Python.
245
+ - Decompose recipes into stages (`blender-recipe-decomposer`).
246
+ - Write measurable acceptance criteria rows (`acceptance-criteria-builder`).
247
+ - Pin the overall done/stop condition (`done-criteria`).
248
+ - Guard against scope creep (`scope-guard`).
249
+ - Pick next skills across the workflow (`workflow-stage-router`).
250
+ - Diagnose repeated technical failures (`blender-troubleshooting`).
251
+ - Replace the final 7-point handoff gate (`pre-handoff-verification`).
252
+
253
+ ## References
254
+ - `references/gate-template.md`
255
+ - `references/stage-decomposition-patterns.md`
256
+ - `references/failed-gate-handling.md`
257
+ - `../../docs/skill-system.md`