blendops 0.0.0-stage → 1.1.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 (485) hide show
  1. package/CHANGELOG.md +74 -0
  2. package/LICENSE +21 -0
  3. package/README.md +208 -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 +73 -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/README.md +276 -0
  136. package/docs/examples/glb-web-handoff/README.md +174 -0
  137. package/docs/examples/glb-web-handoff/r3f-glb-viewer.tsx +320 -0
  138. package/docs/examples/glb-web-handoff/threejs-glb-viewer.mjs +709 -0
  139. package/docs/knowledge-and-recipe-catalog.md +236 -0
  140. package/docs/recipes/README.md +27 -0
  141. package/docs/recipes/cyberpunk-shoe-hero.md +97 -0
  142. package/docs/workflows/README.md +14 -0
  143. package/docs/workflows/full-non-blender-user-workflow.md +210 -0
  144. package/docs/workflows/product-hero-workflow.md +92 -0
  145. package/laws/README.md +32 -0
  146. package/laws/evidence-before-done.md +37 -0
  147. package/laws/no-arbitrary-python-interface.md +32 -0
  148. package/laws/non-blender-user-language.md +32 -0
  149. package/laws/official-runtime-only.md +78 -0
  150. package/package.json +103 -4
  151. package/packs/README.md +11 -0
  152. package/packs/product-hero-v0/PACK.md +114 -0
  153. package/registry/catalog-index.json +21344 -0
  154. package/registry/compatibility-matrix.json +533 -0
  155. package/registry/contract-context-fields.json +391 -0
  156. package/registry/knowledge-catalog.json +4648 -0
  157. package/registry/knowledge-sources.json +438 -0
  158. package/registry/recipe-catalog.json +2565 -0
  159. package/registry/runtime-capability-policy.json +525 -0
  160. package/registry/runtime-operations.json +4468 -0
  161. package/registry/skills.json +10231 -0
  162. package/registry/workflow-graph.json +7390 -0
  163. package/schemas/adapter-compatibility-matrix.schema.json +166 -0
  164. package/schemas/contract-context-fields.schema.json +147 -0
  165. package/schemas/execution-plan.schema.json +325 -0
  166. package/schemas/glb-web-handoff-manifest.schema.json +744 -0
  167. package/schemas/knowledge-record.schema.json +460 -0
  168. package/schemas/knowledge-source-registry.schema.json +268 -0
  169. package/schemas/operation-execution-ledger.schema.json +348 -0
  170. package/schemas/recipe-record.schema.json +469 -0
  171. package/schemas/runtime-capability-policy.schema.json +184 -0
  172. package/schemas/runtime-evidence-packet.schema.json +211 -0
  173. package/schemas/runtime-operations.schema.json +535 -0
  174. package/schemas/runtime-qualification-report.schema.json +540 -0
  175. package/schemas/runtime-session.schema.json +350 -0
  176. package/schemas/scene-spec.schema.json +624 -0
  177. package/schemas/skill-contract.schema.json +402 -0
  178. package/schemas/skill-eval.schema.json +509 -0
  179. package/scripts/build-knowledge-catalog.mjs +2376 -0
  180. package/scripts/compile-scene-plan.mjs +1945 -0
  181. package/scripts/export-claude-skills.mjs +634 -0
  182. package/scripts/generate-glb-handoff-report.mjs +2376 -0
  183. package/scripts/inspect-glb.mjs +1627 -0
  184. package/scripts/install-skills.mjs +5443 -0
  185. package/scripts/runtime-orchestrator.mjs +7713 -0
  186. package/scripts/validate-capability-policy.mjs +531 -0
  187. package/scripts/validate-evidence-packet.mjs +256 -0
  188. package/skills/README.md +315 -0
  189. package/skills/_template/SKILL.md +296 -0
  190. package/skills/acceptance-criteria-builder/EVAL.md +25 -0
  191. package/skills/acceptance-criteria-builder/SKILL.md +257 -0
  192. package/skills/acceptance-criteria-builder/contract.json +205 -0
  193. package/skills/acceptance-criteria-builder/references/brief-to-criteria-mapper.md +22 -0
  194. package/skills/acceptance-criteria-builder/references/checklist-patterns.md +22 -0
  195. package/skills/acceptance-criteria-builder/references/evidence-hook-rules.md +19 -0
  196. package/skills/asset-discovery/EVAL.md +81 -0
  197. package/skills/asset-discovery/SKILL.md +252 -0
  198. package/skills/asset-discovery/contract.json +291 -0
  199. package/skills/asset-discovery/references/asset-strategy-decision-tree.md +40 -0
  200. package/skills/asset-discovery/references/budget-reconciliation-patterns.md +54 -0
  201. package/skills/asset-discovery/references/license-confidence-table.md +41 -0
  202. package/skills/asset-fallback-strategy/EVAL.md +34 -0
  203. package/skills/asset-fallback-strategy/SKILL.md +248 -0
  204. package/skills/asset-fallback-strategy/contract.json +190 -0
  205. package/skills/asset-fallback-strategy/references/drop-with-caveat-rules.md +36 -0
  206. package/skills/asset-fallback-strategy/references/fallback-option-types.md +55 -0
  207. package/skills/asset-fallback-strategy/references/scoring-rubric.md +61 -0
  208. package/skills/asset-library-plan/EVAL.md +28 -0
  209. package/skills/asset-library-plan/SKILL.md +263 -0
  210. package/skills/asset-library-plan/contract.json +177 -0
  211. package/skills/asset-library-plan/references/folder-structure-rules.md +63 -0
  212. package/skills/asset-library-plan/references/metadata-schema.md +62 -0
  213. package/skills/asset-library-plan/references/naming-rules.md +51 -0
  214. package/skills/asset-license-checker/EVAL.md +33 -0
  215. package/skills/asset-license-checker/SKILL.md +245 -0
  216. package/skills/asset-license-checker/contract.json +172 -0
  217. package/skills/asset-license-checker/references/attribution-rendering-patterns.md +48 -0
  218. package/skills/asset-license-checker/references/common-license-mapping.md +39 -0
  219. package/skills/asset-license-checker/references/license-source-rules.md +38 -0
  220. package/skills/asset-style-check/EVAL.md +26 -0
  221. package/skills/asset-style-check/SKILL.md +238 -0
  222. package/skills/asset-style-check/contract.json +251 -0
  223. package/skills/asset-style-check/references/drift-classification.md +40 -0
  224. package/skills/asset-style-check/references/intentional-mixed-style.md +39 -0
  225. package/skills/asset-style-check/references/style-axes.md +46 -0
  226. package/skills/blender-brainstorming/EVAL.md +79 -0
  227. package/skills/blender-brainstorming/SKILL.md +228 -0
  228. package/skills/blender-brainstorming/contract.json +115 -0
  229. package/skills/blender-brainstorming/references/alternative-scoping-templates.md +43 -0
  230. package/skills/blender-brainstorming/references/clarification-patterns.md +29 -0
  231. package/skills/blender-brainstorming/references/intent-summary-style-guide.md +25 -0
  232. package/skills/blender-recipe-decomposer/EVAL.md +35 -0
  233. package/skills/blender-recipe-decomposer/SKILL.md +258 -0
  234. package/skills/blender-recipe-decomposer/contract.json +152 -0
  235. package/skills/blender-recipe-decomposer/references/dependency-patterns.md +53 -0
  236. package/skills/blender-recipe-decomposer/references/recipe-grouping-rules.md +58 -0
  237. package/skills/blender-recipe-decomposer/references/recipe-naming-rules.md +44 -0
  238. package/skills/blender-troubleshooting/EVAL.md +78 -0
  239. package/skills/blender-troubleshooting/SKILL.md +263 -0
  240. package/skills/blender-troubleshooting/contract.json +352 -0
  241. package/skills/blender-troubleshooting/references/common-symptom-playbooks.md +51 -0
  242. package/skills/blender-troubleshooting/references/divergence-routing-table.md +23 -0
  243. package/skills/blender-troubleshooting/references/four-phase-template.md +51 -0
  244. package/skills/blendops-help/EVAL.md +67 -0
  245. package/skills/blendops-help/SKILL.md +312 -0
  246. package/skills/blendops-help/contract.json +229 -0
  247. package/skills/blendops-help/references/lifecycle-phases.md +91 -0
  248. package/skills/blendops-help/references/quick-start-prompts.md +65 -0
  249. package/skills/blendops-help/references/routing-decision-tree.md +57 -0
  250. package/skills/bridge-conflicts/EVAL.md +83 -0
  251. package/skills/bridge-conflicts/SKILL.md +246 -0
  252. package/skills/bridge-conflicts/contract.json +145 -0
  253. package/skills/bridge-conflicts/references/bridge-state-matrix-template.md +82 -0
  254. package/skills/bridge-conflicts/references/conflict-playbooks.md +99 -0
  255. package/skills/bridge-conflicts/references/do-not-reminders.md +42 -0
  256. package/skills/camera-composition/EVAL.md +32 -0
  257. package/skills/camera-composition/SKILL.md +196 -0
  258. package/skills/camera-composition/contract.json +180 -0
  259. package/skills/camera-composition/references/camera-presets.md +30 -0
  260. package/skills/camera-composition/references/camera-rubric.md +24 -0
  261. package/skills/camera-composition/references/hero-composition-patterns.md +24 -0
  262. package/skills/camera-composition/references/web-layout-negative-space.md +25 -0
  263. package/skills/character-portrait/EVAL.md +42 -0
  264. package/skills/character-portrait/SKILL.md +245 -0
  265. package/skills/character-portrait/contract.json +205 -0
  266. package/skills/character-portrait/references/portrait-framing-rules.md +39 -0
  267. package/skills/character-portrait/references/portrait-lighting-patterns.md +50 -0
  268. package/skills/character-portrait/references/style-consistency-rules.md +41 -0
  269. package/skills/cli-appendix-job-outline/EVAL.md +26 -0
  270. package/skills/cli-appendix-job-outline/SKILL.md +252 -0
  271. package/skills/cli-appendix-job-outline/contract.json +147 -0
  272. package/skills/cli-appendix-job-outline/references/flag-order-reminders.md +16 -0
  273. package/skills/cli-appendix-job-outline/references/job-type-matrix.md +13 -0
  274. package/skills/cli-appendix-job-outline/references/stateless-limitations.md +12 -0
  275. package/skills/color-management-decision/EVAL.md +28 -0
  276. package/skills/color-management-decision/SKILL.md +254 -0
  277. package/skills/color-management-decision/contract.json +162 -0
  278. package/skills/color-management-decision/references/look-comparison.md +44 -0
  279. package/skills/color-management-decision/references/per-channel-rules.md +49 -0
  280. package/skills/color-management-decision/references/pipeline-mapping.md +47 -0
  281. package/skills/composition-quality-checker/EVAL.md +38 -0
  282. package/skills/composition-quality-checker/SKILL.md +260 -0
  283. package/skills/composition-quality-checker/contract.json +221 -0
  284. package/skills/composition-quality-checker/references/aspect-ratio-rules.md +37 -0
  285. package/skills/composition-quality-checker/references/composition-rules.md +58 -0
  286. package/skills/composition-quality-checker/references/headroom-leadroom-rules.md +46 -0
  287. package/skills/cycles-vs-eevee-decision/EVAL.md +26 -0
  288. package/skills/cycles-vs-eevee-decision/SKILL.md +249 -0
  289. package/skills/cycles-vs-eevee-decision/contract.json +142 -0
  290. package/skills/cycles-vs-eevee-decision/references/engine-feature-matrix.md +39 -0
  291. package/skills/cycles-vs-eevee-decision/references/gpu-device-rules.md +51 -0
  292. package/skills/cycles-vs-eevee-decision/references/samples-by-quality.md +53 -0
  293. package/skills/done-criteria/EVAL.md +33 -0
  294. package/skills/done-criteria/SKILL.md +225 -0
  295. package/skills/done-criteria/contract.json +199 -0
  296. package/skills/done-criteria/references/done-vs-perfect.md +56 -0
  297. package/skills/done-criteria/references/out-of-scope-patterns.md +50 -0
  298. package/skills/done-criteria/references/stop-condition-templates.md +39 -0
  299. package/skills/environment-shot/EVAL.md +44 -0
  300. package/skills/environment-shot/SKILL.md +237 -0
  301. package/skills/environment-shot/contract.json +162 -0
  302. package/skills/environment-shot/references/depth-layering-rules.md +49 -0
  303. package/skills/environment-shot/references/time-and-weather-rules.md +35 -0
  304. package/skills/environment-shot/references/wide-shot-camera-rules.md +51 -0
  305. package/skills/glb-animation-handoff/EVAL.md +39 -0
  306. package/skills/glb-animation-handoff/SKILL.md +271 -0
  307. package/skills/glb-animation-handoff/contract.json +247 -0
  308. package/skills/glb-animation-handoff/references/animation-types.md +36 -0
  309. package/skills/glb-animation-handoff/references/transition-rules.md +55 -0
  310. package/skills/glb-animation-handoff/references/web-stack-caveats.md +40 -0
  311. package/skills/glb-web-handoff/EVAL.md +33 -0
  312. package/skills/glb-web-handoff/SKILL.md +212 -0
  313. package/skills/glb-web-handoff/contract.json +171 -0
  314. package/skills/glb-web-handoff/references/artifact-status-language.md +26 -0
  315. package/skills/glb-web-handoff/references/glb-handoff-checklist.md +30 -0
  316. package/skills/glb-web-handoff/references/performance-caveats.md +26 -0
  317. package/skills/glb-web-handoff/references/threejs-r3f-handoff.md +28 -0
  318. package/skills/intent-to-3d-brief-writer/EVAL.md +82 -0
  319. package/skills/intent-to-3d-brief-writer/SKILL.md +238 -0
  320. package/skills/intent-to-3d-brief-writer/contract.json +195 -0
  321. package/skills/intent-to-3d-brief-writer/references/acceptance-criteria-patterns.md +46 -0
  322. package/skills/intent-to-3d-brief-writer/references/eight-slot-template.md +123 -0
  323. package/skills/intent-to-3d-brief-writer/references/mixed-audience-handling.md +39 -0
  324. package/skills/interior-scene/EVAL.md +44 -0
  325. package/skills/interior-scene/SKILL.md +261 -0
  326. package/skills/interior-scene/contract.json +277 -0
  327. package/skills/interior-scene/references/furniture-layout-rules.md +51 -0
  328. package/skills/interior-scene/references/interior-architecture-rules.md +47 -0
  329. package/skills/interior-scene/references/interior-camera-rules.md +47 -0
  330. package/skills/lighting-material-plan/EVAL.md +32 -0
  331. package/skills/lighting-material-plan/SKILL.md +194 -0
  332. package/skills/lighting-material-plan/contract.json +213 -0
  333. package/skills/lighting-material-plan/references/cyberpunk-lookdev.md +22 -0
  334. package/skills/lighting-material-plan/references/lighting-patterns.md +30 -0
  335. package/skills/lighting-material-plan/references/material-portability.md +25 -0
  336. package/skills/lighting-material-plan/references/reflective-floor-pattern.md +22 -0
  337. package/skills/lighting-material-plan/references/web-material-simplification.md +23 -0
  338. package/skills/lighting-quality-checker/EVAL.md +41 -0
  339. package/skills/lighting-quality-checker/SKILL.md +247 -0
  340. package/skills/lighting-quality-checker/contract.json +187 -0
  341. package/skills/lighting-quality-checker/references/hdri-balance-rules.md +48 -0
  342. package/skills/lighting-quality-checker/references/intensity-ranges.md +73 -0
  343. package/skills/lighting-quality-checker/references/shadow-softness-rules.md +38 -0
  344. package/skills/material-quality-checker/EVAL.md +40 -0
  345. package/skills/material-quality-checker/SKILL.md +261 -0
  346. package/skills/material-quality-checker/contract.json +244 -0
  347. package/skills/material-quality-checker/references/consumer-stack-rules.md +62 -0
  348. package/skills/material-quality-checker/references/pbr-sanity-rules.md +78 -0
  349. package/skills/material-quality-checker/references/texture-budget-rules.md +48 -0
  350. package/skills/mobile-glb-budget/EVAL.md +40 -0
  351. package/skills/mobile-glb-budget/SKILL.md +264 -0
  352. package/skills/mobile-glb-budget/contract.json +309 -0
  353. package/skills/mobile-glb-budget/references/budget-tiers.md +30 -0
  354. package/skills/mobile-glb-budget/references/degradation-plan.md +34 -0
  355. package/skills/mobile-glb-budget/references/violation-rules.md +43 -0
  356. package/skills/output-format-decision/EVAL.md +27 -0
  357. package/skills/output-format-decision/SKILL.md +222 -0
  358. package/skills/output-format-decision/contract.json +179 -0
  359. package/skills/output-format-decision/references/bit-depth-rules.md +56 -0
  360. package/skills/output-format-decision/references/compression-tradeoffs.md +62 -0
  361. package/skills/output-format-decision/references/format-decision-matrix.md +34 -0
  362. package/skills/pack-prerequisite-checker/EVAL.md +26 -0
  363. package/skills/pack-prerequisite-checker/SKILL.md +272 -0
  364. package/skills/pack-prerequisite-checker/contract.json +214 -0
  365. package/skills/pack-prerequisite-checker/references/blocked-start-playbook.md +21 -0
  366. package/skills/pack-prerequisite-checker/references/pack-readiness-template.md +38 -0
  367. package/skills/pack-prerequisite-checker/references/prerequisite-matrix.md +20 -0
  368. package/skills/path-one-host-outline/EVAL.md +26 -0
  369. package/skills/path-one-host-outline/SKILL.md +251 -0
  370. package/skills/path-one-host-outline/contract.json +167 -0
  371. package/skills/path-one-host-outline/references/connector-vs-manual-matrix.md +21 -0
  372. package/skills/path-one-host-outline/references/host-checklist-template.md +35 -0
  373. package/skills/path-one-host-outline/references/lab-addon-reminders.md +12 -0
  374. package/skills/plain-language-response/EVAL.md +33 -0
  375. package/skills/plain-language-response/SKILL.md +194 -0
  376. package/skills/plain-language-response/contract.json +242 -0
  377. package/skills/plain-language-response/references/caveat-language.md +25 -0
  378. package/skills/plain-language-response/references/plain-language-patterns.md +30 -0
  379. package/skills/plain-language-response/references/stakeholder-friendly-examples.md +30 -0
  380. package/skills/plain-language-response/references/status-summary-templates.md +50 -0
  381. package/skills/polycount-budget-checker/EVAL.md +40 -0
  382. package/skills/polycount-budget-checker/SKILL.md +251 -0
  383. package/skills/polycount-budget-checker/contract.json +196 -0
  384. package/skills/polycount-budget-checker/references/instance-counting-rules.md +39 -0
  385. package/skills/polycount-budget-checker/references/per-mesh-rules.md +43 -0
  386. package/skills/polycount-budget-checker/references/topology-hints.md +56 -0
  387. package/skills/pre-handoff-verification/EVAL.md +84 -0
  388. package/skills/pre-handoff-verification/SKILL.md +252 -0
  389. package/skills/pre-handoff-verification/contract.json +295 -0
  390. package/skills/pre-handoff-verification/references/downgrade-rules.md +39 -0
  391. package/skills/pre-handoff-verification/references/seven-point-checklist.md +46 -0
  392. package/skills/pre-handoff-verification/references/text-only-mode-handling.md +36 -0
  393. package/skills/preview-report/EVAL.md +39 -0
  394. package/skills/preview-report/SKILL.md +254 -0
  395. package/skills/preview-report/contract.json +141 -0
  396. package/skills/preview-report/references/handoff-recipients.md +41 -0
  397. package/skills/preview-report/references/report-schema.md +60 -0
  398. package/skills/preview-report/references/truth-label-rules.md +36 -0
  399. package/skills/product-grid-scene-planner/EVAL.md +42 -0
  400. package/skills/product-grid-scene-planner/SKILL.md +246 -0
  401. package/skills/product-grid-scene-planner/contract.json +257 -0
  402. package/skills/product-grid-scene-planner/references/grid-consistency-rules.md +53 -0
  403. package/skills/product-grid-scene-planner/references/grid-layout-rules.md +42 -0
  404. package/skills/product-grid-scene-planner/references/grid-output-naming-rules.md +52 -0
  405. package/skills/product-hero-scene-planner/EVAL.md +33 -0
  406. package/skills/product-hero-scene-planner/SKILL.md +227 -0
  407. package/skills/product-hero-scene-planner/contract.json +228 -0
  408. package/skills/product-hero-scene-planner/references/clarification-patterns.md +24 -0
  409. package/skills/product-hero-scene-planner/references/cyberpunk-shoe-example.md +28 -0
  410. package/skills/product-hero-scene-planner/references/product-hero-playbooks.md +22 -0
  411. package/skills/product-hero-scene-planner/references/scene-plan-schema.md +35 -0
  412. package/skills/r3f-component-plan/EVAL.md +43 -0
  413. package/skills/r3f-component-plan/SKILL.md +290 -0
  414. package/skills/r3f-component-plan/contract.json +171 -0
  415. package/skills/r3f-component-plan/references/component-shape-patterns.md +54 -0
  416. package/skills/r3f-component-plan/references/suspense-placement-rules.md +50 -0
  417. package/skills/r3f-component-plan/references/usegltf-caching-rules.md +53 -0
  418. package/skills/recipe-fit-assessor/EVAL.md +28 -0
  419. package/skills/recipe-fit-assessor/SKILL.md +266 -0
  420. package/skills/recipe-fit-assessor/contract.json +220 -0
  421. package/skills/recipe-fit-assessor/references/recipe-catalog.md +30 -0
  422. package/skills/recipe-fit-assessor/references/scope-gap-rules.md +27 -0
  423. package/skills/recipe-fit-assessor/references/workflow-recommendation-template.md +34 -0
  424. package/skills/render-export-evidence/EVAL.md +86 -0
  425. package/skills/render-export-evidence/SKILL.md +339 -0
  426. package/skills/render-export-evidence/contract.json +206 -0
  427. package/skills/render-export-evidence/references/attempted-vs-failed-rubric.md +75 -0
  428. package/skills/render-export-evidence/references/evidence-record-templates.md +143 -0
  429. package/skills/render-export-evidence/references/truth-label-decision-tree.md +57 -0
  430. package/skills/resolution-aspect-decision/EVAL.md +26 -0
  431. package/skills/resolution-aspect-decision/SKILL.md +246 -0
  432. package/skills/resolution-aspect-decision/contract.json +160 -0
  433. package/skills/resolution-aspect-decision/references/aspect-defaults.md +41 -0
  434. package/skills/resolution-aspect-decision/references/print-vs-screen-rules.md +58 -0
  435. package/skills/resolution-aspect-decision/references/resolution-defaults.md +64 -0
  436. package/skills/runtime-attempt-report/EVAL.md +26 -0
  437. package/skills/runtime-attempt-report/SKILL.md +268 -0
  438. package/skills/runtime-attempt-report/contract.json +176 -0
  439. package/skills/runtime-attempt-report/references/attempt-record-template.md +49 -0
  440. package/skills/runtime-attempt-report/references/triage-next-steps.md +15 -0
  441. package/skills/runtime-attempt-report/references/truth-label-blocks.md +27 -0
  442. package/skills/runtime-path-picker/EVAL.md +26 -0
  443. package/skills/runtime-path-picker/SKILL.md +268 -0
  444. package/skills/runtime-path-picker/contract.json +191 -0
  445. package/skills/runtime-path-picker/references/anti-patterns.md +14 -0
  446. package/skills/runtime-path-picker/references/decision-tree.md +29 -0
  447. package/skills/runtime-path-picker/references/path-constraints-table.md +18 -0
  448. package/skills/runtime-readiness/EVAL.md +33 -0
  449. package/skills/runtime-readiness/SKILL.md +218 -0
  450. package/skills/runtime-readiness/contract.json +190 -0
  451. package/skills/runtime-readiness/references/blocker-report-template.md +28 -0
  452. package/skills/runtime-readiness/references/evidence-examples.md +23 -0
  453. package/skills/runtime-readiness/references/readiness-matrix.md +46 -0
  454. package/skills/runtime-setup/EVAL.md +33 -0
  455. package/skills/runtime-setup/SKILL.md +209 -0
  456. package/skills/runtime-setup/contract.json +171 -0
  457. package/skills/runtime-setup/references/runtime-option-decision-tree.md +28 -0
  458. package/skills/runtime-setup/references/setup-summary-template.md +33 -0
  459. package/skills/runtime-setup/references/source-confidence-labels.md +23 -0
  460. package/skills/scene-readiness/EVAL.md +33 -0
  461. package/skills/scene-readiness/SKILL.md +195 -0
  462. package/skills/scene-readiness/contract.json +198 -0
  463. package/skills/scene-readiness/references/blocker-catalog.md +24 -0
  464. package/skills/scene-readiness/references/not-run-handling.md +22 -0
  465. package/skills/scene-readiness/references/quality-rubric.md +23 -0
  466. package/skills/scene-readiness/references/verdict-language.md +22 -0
  467. package/skills/scope-guard/EVAL.md +33 -0
  468. package/skills/scope-guard/SKILL.md +222 -0
  469. package/skills/scope-guard/contract.json +171 -0
  470. package/skills/scope-guard/references/options-language-template.md +51 -0
  471. package/skills/scope-guard/references/recurring-creep-patterns.md +55 -0
  472. package/skills/scope-guard/references/scope-addition-classification.md +55 -0
  473. package/skills/stage-gates/EVAL.md +40 -0
  474. package/skills/stage-gates/SKILL.md +257 -0
  475. package/skills/stage-gates/contract.json +490 -0
  476. package/skills/stage-gates/references/failed-gate-handling.md +42 -0
  477. package/skills/stage-gates/references/gate-template.md +46 -0
  478. package/skills/stage-gates/references/stage-decomposition-patterns.md +55 -0
  479. package/skills/workflow-stage-router/EVAL.md +25 -0
  480. package/skills/workflow-stage-router/SKILL.md +259 -0
  481. package/skills/workflow-stage-router/contract.json +150 -0
  482. package/skills/workflow-stage-router/references/milestone-model.md +20 -0
  483. package/skills/workflow-stage-router/references/routing-decision-tree.md +32 -0
  484. package/skills/workflow-stage-router/references/stage-handoff-template.md +37 -0
  485. package/skills.sh.json +102 -0
@@ -0,0 +1,490 @@
1
+ {
2
+ "$schema": "../../schemas/skill-contract.schema.json",
3
+ "id": "stage-gates",
4
+ "version": "1.0.0",
5
+ "category": "process-discipline",
6
+ "role": "stage-gate-checklist-enforcer",
7
+ "purpose": "Define explicit per-stage gates and acceptance checklists before any modeling, render, or export work — work only proceeds gate by gate.",
8
+ "capabilityTier": "L0",
9
+ "triggers": [
10
+ "let's do this step by step",
11
+ "what's done before we move on",
12
+ "checklist for this work",
13
+ "I want to make sure each stage is solid"
14
+ ],
15
+ "exclusions": [
16
+ {
17
+ "condition": "single-step requests",
18
+ "delegateTo": "blender-brainstorming",
19
+ "reason": "Delegates out-of-scope requests to blender-brainstorming"
20
+ },
21
+ {
22
+ "condition": "pure exploratory brainstorming",
23
+ "delegateTo": "blender-brainstorming",
24
+ "reason": "use blender-brainstorming"
25
+ },
26
+ {
27
+ "condition": "decomposing a brief into stages",
28
+ "delegateTo": "blender-recipe-decomposer",
29
+ "reason": "use blender-recipe-decomposer"
30
+ },
31
+ {
32
+ "condition": "writing measurable acceptance criteria rows from scratch",
33
+ "delegateTo": "acceptance-criteria-builder",
34
+ "reason": "use acceptance-criteria-builder"
35
+ },
36
+ {
37
+ "condition": "pinning the overall done/stop condition",
38
+ "delegateTo": "done-criteria",
39
+ "reason": "use done-criteria"
40
+ },
41
+ {
42
+ "condition": "guarding against mid-flight scope creep",
43
+ "delegateTo": "scope-guard",
44
+ "reason": "use scope-guard"
45
+ },
46
+ {
47
+ "condition": "selecting which skill runs next across the workflow",
48
+ "delegateTo": "workflow-stage-router",
49
+ "reason": "use workflow-stage-router"
50
+ },
51
+ {
52
+ "condition": "fixing repeated stage failures or broken renders",
53
+ "delegateTo": "blender-troubleshooting",
54
+ "reason": "use blender-troubleshooting"
55
+ },
56
+ {
57
+ "condition": "executing the final 7-point handoff gate",
58
+ "delegateTo": "pre-handoff-verification",
59
+ "reason": "use pre-handoff-verification"
60
+ }
61
+ ],
62
+ "inputs": {
63
+ "required": [
64
+ {
65
+ "name": "active_workflow_stages",
66
+ "type": "array",
67
+ "description": "Ordered stages of the selected BlendOps recipe or custom workflow"
68
+ },
69
+ {
70
+ "name": "locked_acceptance_criteria",
71
+ "type": "object",
72
+ "description": "Measurable acceptance rows from acceptance-criteria-builder"
73
+ }
74
+ ],
75
+ "optional": [
76
+ {
77
+ "name": "current_stage_status",
78
+ "type": "string",
79
+ "description": "Current stage progress and completed gate checks"
80
+ }
81
+ ]
82
+ },
83
+ "outputs": {
84
+ "primary": [
85
+ "stage_gate_checklists",
86
+ "entry_and_exit_preconditions",
87
+ "gate_failure_routing_rules"
88
+ ],
89
+ "truthStatePolicy": {
90
+ "runtimeDefault": "Not Run",
91
+ "artifactDefault": "Not Produced",
92
+ "mutationRule": "downgrade_only"
93
+ }
94
+ },
95
+ "handoffs": [
96
+ {
97
+ "target": "blender-brainstorming",
98
+ "type": "upstream_reference",
99
+ "label": "Brainstorming",
100
+ "when": {
101
+ "all": [
102
+ {
103
+ "field": "goal.clarity",
104
+ "operator": "equals",
105
+ "value": "ambiguous_or_mixed"
106
+ }
107
+ ]
108
+ }
109
+ },
110
+ {
111
+ "target": "intent-to-3d-brief-writer",
112
+ "type": "upstream_reference",
113
+ "label": "Brief authoring",
114
+ "when": {
115
+ "all": [
116
+ {
117
+ "field": "goal.clarity",
118
+ "operator": "equals",
119
+ "value": "clear"
120
+ },
121
+ {
122
+ "field": "brief.locked",
123
+ "operator": "equals",
124
+ "value": false
125
+ }
126
+ ]
127
+ }
128
+ },
129
+ {
130
+ "target": "blender-recipe-decomposer",
131
+ "type": "upstream_reference",
132
+ "label": "Recipe stage decomposition",
133
+ "when": {
134
+ "all": [
135
+ {
136
+ "field": "fit.multiDeliverableDetected",
137
+ "operator": "equals",
138
+ "value": true
139
+ }
140
+ ]
141
+ }
142
+ },
143
+ {
144
+ "target": "acceptance-criteria-builder",
145
+ "type": "upstream_reference",
146
+ "label": "Measurable acceptance rows",
147
+ "when": {
148
+ "all": [
149
+ {
150
+ "field": "brief.locked",
151
+ "operator": "equals",
152
+ "value": true
153
+ },
154
+ {
155
+ "field": "stage.current",
156
+ "operator": "equals",
157
+ "value": "acceptance_criteria"
158
+ }
159
+ ]
160
+ }
161
+ },
162
+ {
163
+ "target": "done-criteria",
164
+ "type": "upstream_reference",
165
+ "label": "Overall done condition",
166
+ "when": {
167
+ "all": [
168
+ {
169
+ "field": "brief.locked",
170
+ "operator": "equals",
171
+ "value": true
172
+ },
173
+ {
174
+ "field": "stage.current",
175
+ "operator": "equals",
176
+ "value": "stop_condition"
177
+ }
178
+ ]
179
+ }
180
+ },
181
+ {
182
+ "target": "scope-guard",
183
+ "type": "progression",
184
+ "label": "Scope creep protection",
185
+ "when": {
186
+ "all": [
187
+ {
188
+ "field": "scope.driftDetected",
189
+ "operator": "equals",
190
+ "value": true
191
+ }
192
+ ]
193
+ }
194
+ },
195
+ {
196
+ "target": "workflow-stage-router",
197
+ "type": "progression",
198
+ "label": "Next-skill routing across stages",
199
+ "when": {
200
+ "all": [
201
+ {
202
+ "field": "preflight.passed",
203
+ "operator": "equals",
204
+ "value": true
205
+ },
206
+ {
207
+ "field": "inventory.exists",
208
+ "operator": "equals",
209
+ "value": true
210
+ }
211
+ ]
212
+ }
213
+ },
214
+ {
215
+ "target": "asset-discovery",
216
+ "type": "progression",
217
+ "label": "Asset discovery",
218
+ "when": {
219
+ "all": [
220
+ {
221
+ "field": "brief.locked",
222
+ "operator": "equals",
223
+ "value": true
224
+ },
225
+ {
226
+ "field": "assets.discoveryComplete",
227
+ "operator": "equals",
228
+ "value": false
229
+ }
230
+ ]
231
+ }
232
+ },
233
+ {
234
+ "target": "camera-composition",
235
+ "type": "progression",
236
+ "label": "Scene planners (camera-composition)",
237
+ "when": {
238
+ "all": [
239
+ {
240
+ "field": "brief.locked",
241
+ "operator": "equals",
242
+ "value": true
243
+ },
244
+ {
245
+ "field": "stage.current",
246
+ "operator": "equals",
247
+ "value": "camera_planning"
248
+ }
249
+ ]
250
+ }
251
+ },
252
+ {
253
+ "target": "lighting-material-plan",
254
+ "type": "progression",
255
+ "label": "Scene planners (lighting-material-plan)",
256
+ "when": {
257
+ "all": [
258
+ {
259
+ "field": "brief.locked",
260
+ "operator": "equals",
261
+ "value": true
262
+ },
263
+ {
264
+ "field": "stage.current",
265
+ "operator": "equals",
266
+ "value": "lookdev_planning"
267
+ }
268
+ ]
269
+ }
270
+ },
271
+ {
272
+ "target": "character-portrait",
273
+ "type": "alternative",
274
+ "label": "Scene planners (character-portrait)",
275
+ "when": {
276
+ "all": [
277
+ {
278
+ "field": "brief.locked",
279
+ "operator": "equals",
280
+ "value": true
281
+ },
282
+ {
283
+ "field": "recipe.domain",
284
+ "operator": "equals",
285
+ "value": "character_portrait"
286
+ }
287
+ ]
288
+ }
289
+ },
290
+ {
291
+ "target": "environment-shot",
292
+ "type": "alternative",
293
+ "label": "Scene planners (environment-shot)",
294
+ "when": {
295
+ "all": [
296
+ {
297
+ "field": "brief.locked",
298
+ "operator": "equals",
299
+ "value": true
300
+ },
301
+ {
302
+ "field": "recipe.domain",
303
+ "operator": "equals",
304
+ "value": "environment_shot"
305
+ }
306
+ ]
307
+ }
308
+ },
309
+ {
310
+ "target": "interior-scene",
311
+ "type": "alternative",
312
+ "label": "Scene planners (interior-scene)",
313
+ "when": {
314
+ "all": [
315
+ {
316
+ "field": "brief.locked",
317
+ "operator": "equals",
318
+ "value": true
319
+ },
320
+ {
321
+ "field": "recipe.domain",
322
+ "operator": "equals",
323
+ "value": "interior_archviz"
324
+ }
325
+ ]
326
+ }
327
+ },
328
+ {
329
+ "target": "product-grid-scene-planner",
330
+ "type": "alternative",
331
+ "label": "Scene planners (product-grid-scene-planner)",
332
+ "when": {
333
+ "all": [
334
+ {
335
+ "field": "brief.locked",
336
+ "operator": "equals",
337
+ "value": true
338
+ },
339
+ {
340
+ "field": "recipe.domain",
341
+ "operator": "equals",
342
+ "value": "product_grid"
343
+ }
344
+ ]
345
+ }
346
+ },
347
+ {
348
+ "target": "product-hero-scene-planner",
349
+ "type": "alternative",
350
+ "label": "Scene planners (product-hero-scene-planner)",
351
+ "when": {
352
+ "all": [
353
+ {
354
+ "field": "brief.locked",
355
+ "operator": "equals",
356
+ "value": true
357
+ },
358
+ {
359
+ "field": "recipe.domain",
360
+ "operator": "equals",
361
+ "value": "product_hero"
362
+ }
363
+ ]
364
+ }
365
+ },
366
+ {
367
+ "target": "scene-readiness",
368
+ "type": "progression",
369
+ "label": "Quality validators (scene-readiness)",
370
+ "when": {
371
+ "all": [
372
+ {
373
+ "field": "quality.domain",
374
+ "operator": "equals",
375
+ "value": "holistic"
376
+ },
377
+ {
378
+ "field": "stage.current",
379
+ "operator": "equals",
380
+ "value": "quality_validation"
381
+ }
382
+ ]
383
+ }
384
+ },
385
+ {
386
+ "target": "composition-quality-checker",
387
+ "type": "progression",
388
+ "label": "Quality validators (composition-quality-checker)",
389
+ "when": {
390
+ "all": [
391
+ {
392
+ "field": "quality.domain",
393
+ "operator": "equals",
394
+ "value": "composition"
395
+ },
396
+ {
397
+ "field": "quality.verdict",
398
+ "operator": "equals",
399
+ "value": "not_run"
400
+ }
401
+ ]
402
+ }
403
+ },
404
+ {
405
+ "target": "lighting-quality-checker",
406
+ "type": "progression",
407
+ "label": "Quality validators (lighting-quality-checker)",
408
+ "when": {
409
+ "all": [
410
+ {
411
+ "field": "quality.domain",
412
+ "operator": "equals",
413
+ "value": "lighting"
414
+ },
415
+ {
416
+ "field": "quality.verdict",
417
+ "operator": "equals",
418
+ "value": "not_run"
419
+ }
420
+ ]
421
+ }
422
+ },
423
+ {
424
+ "target": "material-quality-checker",
425
+ "type": "progression",
426
+ "label": "Quality validators (material-quality-checker)",
427
+ "when": {
428
+ "all": [
429
+ {
430
+ "field": "quality.domain",
431
+ "operator": "equals",
432
+ "value": "material"
433
+ },
434
+ {
435
+ "field": "quality.verdict",
436
+ "operator": "equals",
437
+ "value": "not_run"
438
+ }
439
+ ]
440
+ }
441
+ },
442
+ {
443
+ "target": "polycount-budget-checker",
444
+ "type": "progression",
445
+ "label": "Quality validators (polycount-budget-checker)",
446
+ "when": {
447
+ "all": [
448
+ {
449
+ "field": "quality.domain",
450
+ "operator": "equals",
451
+ "value": "polycount"
452
+ },
453
+ {
454
+ "field": "budget.verdict",
455
+ "operator": "equals",
456
+ "value": "Not Run"
457
+ }
458
+ ]
459
+ }
460
+ },
461
+ {
462
+ "target": "blender-troubleshooting",
463
+ "type": "fallback",
464
+ "label": "Repeated gate failures",
465
+ "when": {
466
+ "all": [
467
+ {
468
+ "field": "runtime.errorDetected",
469
+ "operator": "equals",
470
+ "value": true
471
+ }
472
+ ]
473
+ }
474
+ },
475
+ {
476
+ "target": "pre-handoff-verification",
477
+ "type": "progression",
478
+ "label": "Final 7-point gate",
479
+ "when": {
480
+ "all": [
481
+ {
482
+ "field": "stage.current",
483
+ "operator": "equals",
484
+ "value": "final_verification"
485
+ }
486
+ ]
487
+ }
488
+ }
489
+ ]
490
+ }
@@ -0,0 +1,42 @@
1
+ # Failed-gate handling
2
+
3
+ A failed gate is a feature, not a bug. It catches drift before it compounds.
4
+
5
+ ## Standard response to `Fail`
6
+
7
+ 1. Stop work on subsequent stages.
8
+ 2. Mark all subsequent stages `Blocked`.
9
+ 3. Hand off to `blender-troubleshooting` for root-cause analysis.
10
+ 4. Resolve the failure (re-do current stage or change scope).
11
+ 5. Re-run the gate; only after `Pass` proceed.
12
+
13
+ ## Common failure types
14
+
15
+ | Failure type | Cause | Response |
16
+ |---|---|---|
17
+ | Missing artifact | Render / export did not run or failed | Re-run with verified inputs; capture error |
18
+ | Wrong dimensions / format | Scene config mismatch | Adjust scene render settings; re-run |
19
+ | Below quality threshold (samples, validation) | Speed-vs-quality compromise | Decide: accept lower quality with explicit caveat OR re-run with higher settings |
20
+ | Out-of-budget | Triangle / texture / file size | Hand off to budget skill; degrade per `mobile-glb-budget` rules |
21
+ | Mood / vision mismatch | Brief or plan diverged | Re-confirm brief; replan scene |
22
+ | User changes scope mid-run | Scope creep | Hand off to `scope-guard` |
23
+
24
+ ## What NOT to do
25
+
26
+ - Skip the failed gate and continue.
27
+ - Mark `Pass` "for now" with a TODO to fix later.
28
+ - Ignore minor failures (they compound).
29
+ - Run more stages hoping the failure resolves itself.
30
+
31
+ ## When to abandon a recipe
32
+
33
+ After 3+ failed gates on the same stage, consider:
34
+ - Is the stage criteria too strict?
35
+ - Has the brief drifted?
36
+ - Is the runtime path the wrong choice?
37
+ - Does this recipe need a rewrite?
38
+
39
+ Document the abandonment with the failed gates as evidence; do not pretend the work succeeded.
40
+
41
+ ## Related skill
42
+ `../SKILL.md`
@@ -0,0 +1,46 @@
1
+ # Gate template
2
+
3
+ ## Per-stage gate format
4
+
5
+ Every gate has 4 fields:
6
+
7
+ 1. **Acceptance criteria** (3-5 concrete checks). NOT vague feelings.
8
+ 2. **Evidence required**: file path / measurement / produced artifact.
9
+ 3. **Current state**: `Pending` / `Pass` / `Fail` / `Blocked`.
10
+ 4. **Failed-gate action**: what happens if this gate fails.
11
+
12
+ ## Concrete criteria examples
13
+
14
+ ### Stage: scene plan
15
+ - [ ] Scene plan section count >= 7 (subject, camera, lighting, materials, background, mood, asset list).
16
+ - [ ] Each section has explicit value (no "TBD").
17
+ - [ ] Asset list flagged for discovery.
18
+ - [ ] No runtime claim made.
19
+
20
+ ### Stage: render
21
+ - [ ] `out/render-YYYY-MM-DD.png` exists.
22
+ - [ ] Dimensions match scene aspect (e.g. 1920×1080 for 16:9).
23
+ - [ ] Samples >= 128 (Cycles) or no banding artifacts (Eevee).
24
+ - [ ] Render time logged.
25
+ - [ ] No missing-texture error in render log.
26
+
27
+ ### Stage: export
28
+ - [ ] `out/scene.glb` exists.
29
+ - [ ] File size within budget.
30
+ - [ ] `gltf-validator` passes.
31
+ - [ ] Triangle count within budget.
32
+
33
+ ## Vague criteria to avoid
34
+
35
+ - "Looks good"
36
+ - "Acceptable"
37
+ - "Solid"
38
+ - "On the right track"
39
+ - "We'll know when we see it"
40
+
41
+ ## Why concrete matters
42
+
43
+ A vague gate creates the illusion of progress without verification. Re-reading "looks good" later gives no information about whether the stage actually completed correctly. Concrete criteria allow honest re-evaluation.
44
+
45
+ ## Related skill
46
+ `../SKILL.md`
@@ -0,0 +1,55 @@
1
+ # Stage decomposition patterns
2
+
3
+ ## Standard 7-stage recipe (default for Blender hero work)
4
+
5
+ 1. Brief (intent → 3D brief via `intent-to-3d-brief-writer`)
6
+ 2. Scene plan (via domain scene planner)
7
+ 3. Asset discovery (via `asset-discovery`)
8
+ 4. Scene build (modeling / lookdev — runtime work)
9
+ 5. Render (via `render-export-evidence` capture)
10
+ 6. Export (GLB or PNG export — runtime work)
11
+ 7. Handoff (via `glb-web-handoff` + `plain-language-response`)
12
+
13
+ ## 5-stage recipe (multi-product grid)
14
+
15
+ 1. Brief
16
+ 2. Grid plan (via `product-grid-scene-planner`)
17
+ 3. Consistency setup (camera + lighting locked)
18
+ 4. Render
19
+ 5. Export
20
+
21
+ ## 6-stage recipe (character portrait)
22
+
23
+ 1. Brief
24
+ 2. Portrait plan (via `character-portrait`)
25
+ 3. Asset discovery
26
+ 4. Lookdev (materials + lighting test)
27
+ 5. Render
28
+ 6. Handoff
29
+
30
+ ## 4-stage recipe (text-only planning, no runtime)
31
+
32
+ 1. Brief
33
+ 2. Scene plan
34
+ 3. Quality validation (text-only via checkers)
35
+ 4. Plan handoff
36
+
37
+ ## When to add stages
38
+
39
+ - If two sub-stages have very different acceptance criteria → split.
40
+ - If user wants explicit approval point in the middle → add a review stage.
41
+ - If parallel work happens (e.g., asset discovery + scene plan in parallel) → still gate each separately.
42
+
43
+ ## When to merge stages
44
+
45
+ - If two stages share the same gate criteria → merge.
46
+ - If a stage is too small to gate meaningfully → fold into adjacent.
47
+
48
+ ## Avoid
49
+
50
+ - More than 9 stages (gate fatigue; user disengages).
51
+ - Less than 4 stages for non-trivial work (gates lose value).
52
+ - Stages not aligned to a real handoff (synthetic stages just to add gates).
53
+
54
+ ## Related skill
55
+ `../SKILL.md`
@@ -0,0 +1,25 @@
1
+ # EVAL — workflow-stage-router
2
+
3
+ ## Text-only eval prompt
4
+
5
+ User has locked brief + composition plan text, no renders, no GLB, wants to proceed to lighting. Route next skill.
6
+
7
+ ## Expected behavior
8
+
9
+ - Stage = planning / lookdev boundary
10
+ - Next = `lighting-material-plan` after confirming composition plan consumed
11
+ - Note readiness if runtime mutation next
12
+
13
+ ## Pass / Warn / Fail criteria
14
+
15
+ - Pass: one primary next skill + preconditions
16
+ - Warn: parallel optional validators listed as secondary
17
+ - Fail: jumps to export evidence without render plan
18
+
19
+ ## Sample passing response outline
20
+
21
+ - Stage + next + 3 preconditions
22
+
23
+ ## Sample failing response outline
24
+
25
+ - "Start rendering now" with no engine decision