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,258 @@
1
+ ---
2
+ name: blender-recipe-decomposer
3
+ description: Break over-scoped Blender intent into 2-5 cohesive recipes with brief seeds, stop conditions, order, dependencies, shared assets, and handoffs.
4
+ ---
5
+
6
+ # blender-recipe-decomposer
7
+
8
+ ## Purpose
9
+ When user intent is too big for one recipe (multiple deliverables, mixed modes, conflicting briefs), split it into smaller recipes that each fit the BlendOps recipe shape (brief → plan → assets → runtime → handoff).
10
+
11
+ ## Quick start
12
+ - enumerate distinct deliverables in the user intent
13
+ - group them into 2-5 cohesive recipes and plan shared assets early
14
+ - give each recipe a name, one-line brief seed, one-line stop condition seed, explicit out-of-scope boundary, and handoff target
15
+ - pin recipe start order (linear or parallel-OK) and dependencies
16
+
17
+ ## When to use
18
+ - intent has multiple distinct deliverables (e.g., hero render + animation + GLB + variant grid)
19
+ - intent crosses multiple scene types (portrait + environment in one ask)
20
+ - previous attempts collapsed under their own scope
21
+ - before any planner runs
22
+
23
+ ## When not to use
24
+ <!-- blendops:generated:start exclusions -->
25
+ - single deliverable that is already right-sized (hand off directly to intent-to-3d-brief-writer) → use `../intent-to-3d-brief-writer/SKILL.md` (hand off directly to intent-to-3d-brief-writer)
26
+ - pure exploration or open ideation → use `../blender-brainstorming/SKILL.md` (use blender-brainstorming instead)
27
+ - after recipes are already split or running → use `../scope-guard/SKILL.md` (use scope-guard for added scope or done-criteria to evaluate completion)
28
+ <!-- blendops:generated:end exclusions -->
29
+
30
+ ## Trigger phrases
31
+ <!-- blendops:generated:start triggers -->
32
+ - "I want all of these"
33
+ - "this is a lot"
34
+ - "we'll need several outputs"
35
+ - "across these scenes"
36
+ <!-- blendops:generated:end triggers -->
37
+
38
+ ## Prerequisites / readiness
39
+ - intent stated by user (or extractable)
40
+ - user accepts that splitting will yield more reliable output
41
+
42
+ ## Input schema
43
+
44
+ ### Required inputs
45
+
46
+ | Input | Why it is required |
47
+ |---|---|
48
+ | Full user intent | Source for decomposition |
49
+ | Acceptable recipe count target (2-5 typical) | Constrains over-splitting |
50
+
51
+ ### Optional inputs
52
+
53
+ | Input | Use |
54
+ |---|---|
55
+ | Time / budget per recipe | Affects sizing |
56
+ | Deliverable priority | Drives recipe order |
57
+
58
+ ### Assumptions to confirm
59
+ - Splitting is acceptable (not all users want this).
60
+ - Each new recipe will need its own brief.
61
+ - Some shared assets across recipes is OK; design re-use early.
62
+
63
+ ## Output schema
64
+
65
+ ### Primary output
66
+ A recipe table containing: name, brief seed (one line), stop condition (one line), order, dependencies, out-of-scope boundary, and handoff target.
67
+
68
+ ### Secondary output
69
+ - shared assets list (used by 2+ recipes, planned early)
70
+ - recommended start recipe
71
+ - explicit out-of-scope reminder for each recipe
72
+
73
+ ### Evidence / caveat output
74
+ Decomposition is a pre-work scope splitter and creates no runtime or artifact truth claims. Truth states are downgrade-only (never upgrade without evidence); default artifact state is `Not Produced`.
75
+
76
+ Runtime status: Not Run | Attempted | Produced | Verified | Failed (default at decomposition: Not Run)
77
+ Artifact status: Not Produced | Produced | Verified | Failed (default at decomposition: Not Produced)
78
+ Evidence used: <links, paths, logs, or "none">
79
+ Limitations: <known gaps>
80
+
81
+ ## Required laws
82
+ - `../../laws/evidence-before-done.md`
83
+ - `../../laws/non-blender-user-language.md`
84
+ - `../../laws/no-arbitrary-python-interface.md`
85
+ - `../../laws/official-runtime-only.md`
86
+
87
+ ## Official runtime boundary
88
+
89
+ Process / discipline skill — does not run Blender. Splits intent into recipe specs only.
90
+
91
+ ## Operating procedure
92
+ 1. Read full intent and confirm splitting is acceptable.
93
+ 2. Enumerate distinct deliverables.
94
+ 3. Identify shared assets across deliverables so re-use is planned early.
95
+ 4. Group deliverables into 2-5 cohesive recipes (see `references/recipe-grouping-rules.md`); avoid both single mega-recipes and over-splitting (>5 fragments).
96
+ 5. For each recipe, write: name, one-line brief seed, one-line stop condition, start order, dependencies, explicit out-of-scope boundary, and handoff target.
97
+ 6. Recommend the start recipe (typically shared-asset prep or foundational hero scene first).
98
+ 7. Respect downstream role boundaries:
99
+ - Hand each recipe to `intent-to-3d-brief-writer` to author its full brief.
100
+ - Hand each recipe to `done-criteria` to pin its formal done condition.
101
+ - Gate each recipe's execution with `stage-gates`.
102
+ - Route any scope added after splitting to `scope-guard`.
103
+
104
+ ## Decision tree
105
+
106
+ ```txt
107
+ Single deliverable?
108
+ → No decomposition needed; pass directly to `intent-to-3d-brief-writer`
109
+ Pure exploration with no concrete deliverables yet?
110
+ → Route to `blender-brainstorming` first
111
+ 2-5 distinct deliverables?
112
+ → Group + decompose into 2-5 cohesive recipes
113
+ 6+ deliverables?
114
+ → Strongly recommend product backlog approach; do not handle as a single intent or split into >5 fragments
115
+ Conflicting briefs (e.g., realistic + stylized in one ask)?
116
+ → Split by style into separate recipes; do not merge
117
+ Shared assets across deliverables?
118
+ → Plan shared-asset prep early; downstream recipes declare it as a dependency
119
+ Scope added after decomposition is agreed?
120
+ → Route to `scope-guard`
121
+ ```
122
+
123
+ ## Playbooks
124
+
125
+ ### Playbook A: Hero + variants + animation (3 recipes)
126
+ 1. Hero static render (base recipe).
127
+ 2. Color variants grid (consumes hero scene + asset).
128
+ 3. Animation loop on hero (consumes hero scene; new export).
129
+
130
+ ### Playbook B: Portrait + environment + product (3 recipes, parallel-OK)
131
+ 1. Character portrait scene.
132
+ 2. Environment establishing shot.
133
+ 3. Product hero render.
134
+ Each independent; parallel execution acceptable.
135
+
136
+ ### Playbook C: Multi-pack catalog (5 recipes)
137
+ 1. Asset library prep (shared).
138
+ 2. Product 1 hero.
139
+ 3. Product 2 hero.
140
+ 4. Product 3 hero.
141
+ 5. Catalog grid composite.
142
+ Recipes 2-4 can run parallel; recipe 5 depends on 2-4.
143
+
144
+ ## Mode handling
145
+
146
+ ### Text-only mode
147
+ Decompose into recipe specs only. Decomposition creates no truth claims (`Runtime status: Not Run`, `Artifact status: Not Produced`).
148
+
149
+ ### Runtime-ready mode
150
+ Recipe specs may note intended runtime path candidates per recipe (via `runtime-path-picker`), while truth states remain `Runtime status: Not Run` and `Artifact status: Not Produced` until actual execution occurs downstream.
151
+
152
+ ### Blocked runtime mode
153
+ Decomposition proceeds normally as pre-work. Keep `Runtime status: Not Run` and `Artifact status: Not Produced` (or `Failed` if a prior attempt failed — downgrade-only, never invent a `Blocked` truth state).
154
+
155
+ ## Validation checklist
156
+ - [ ] Distinct deliverables enumerated
157
+ - [ ] Recipe count is between 2 and 5 (no mega-recipe, no >5 fragments)
158
+ - [ ] Each recipe has a name, one-line brief seed, and one-line stop condition
159
+ - [ ] Start order and dependencies are explicit for every recipe
160
+ - [ ] Shared assets across recipes are identified and planned early
161
+ - [ ] Recommended start recipe is stated
162
+ - [ ] Explicit out-of-scope boundary is stated per recipe
163
+ - [ ] Per-recipe handoff to `intent-to-3d-brief-writer` (and downstream governance skills) is explicit
164
+ - [ ] Truth states remain `Runtime status: Not Run` and `Artifact status: Not Produced`
165
+
166
+ ## Pass / Warn / Fail rubric
167
+
168
+ | Verdict | Criteria |
169
+ |---|---|
170
+ | Pass | 2-5 cohesive recipes + name + brief + stop + order + handoff. |
171
+ | Warn | Recipes present but stop conditions soft, or order unclear. |
172
+ | Fail | One mega-recipe still; > 5 over-split fragments; missing stop conditions; no order. |
173
+
174
+ ## Failure handling
175
+ - Single mega-recipe → force split into 2-5 cohesive recipes per `references/recipe-grouping-rules.md`.
176
+ - > 5 fragments → consolidate adjacent deliverables into 2-5 cohesive recipes or defer excess to a backlog.
177
+ - Scope added after splitting → hand off to `scope-guard`.
178
+ - User refuses split → document as risk; warn that `stage-gates` gates and `done-criteria` criteria will be fragile.
179
+
180
+ ## Troubleshooting
181
+
182
+ | Problem | Response |
183
+ |---|---|
184
+ | Decomposed recipes have heavy dependencies | Re-group to reduce coupling; consider shared-asset pre-recipe. |
185
+ | Recipes overlap in scope | Re-draw boundaries; eliminate overlap. |
186
+ | Recipe order ambiguous | Pick one (typically asset-first → main render → variants → composite); justify. |
187
+
188
+ ## Best practices
189
+ - Keep recipes 2-5; outside that range usually wrong-sized.
190
+ - Plan shared assets early; reduces rework.
191
+ - Name recipes after the deliverable, not the process.
192
+ - Hand off each recipe to `intent-to-3d-brief-writer` for full brief.
193
+
194
+ ## Good examples
195
+ - "Recipes (3):
196
+ 1. `shoe-hero-render` — Brief seed: Studio hero still of running shoe. Stop condition: Approved 4K PNG hero frame. Order: 1. Dependencies: none. Out of scope: colorway grid, animation. Handoff: `intent-to-3d-brief-writer`.
197
+ 2. `shoe-color-variants-grid` — Brief seed: 4-colorway comparison grid reusing hero studio rig. Stop condition: Approved composite grid PNG. Order: 2 (parallel-OK with 3 after 1). Dependencies: `shoe-hero-render` shared assets. Out of scope: turntable motion. Handoff: `intent-to-3d-brief-writer`.
198
+ 3. `shoe-orbit-animation` — Brief seed: 360-degree web turntable GLB. Stop condition: Exported GLB passing web budget check. Order: 2 (parallel-OK with 2 after 1). Dependencies: `shoe-hero-render` base mesh. Out of scope: static print renders. Handoff: `intent-to-3d-brief-writer`.
199
+ Shared assets planned early: `shoe-base-mesh`, `hero-lighting-rig`. Recommended start: `shoe-hero-render`. Runtime status: `Not Run`. Artifact status: `Not Produced`."
200
+
201
+ ## Bad examples
202
+ - "We'll do the hero render, 6 color variants, turntable animation, and mobile AR export in one recipe." — fails by keeping a single mega-recipe.
203
+ - "I split your request into 9 micro-recipes (one per camera angle and shader tweak) and wrote the full 3D brief for each." — fails by over-splitting (>5 fragments) and blurring roles with `intent-to-3d-brief-writer`.
204
+
205
+ ## User-facing response template
206
+
207
+ ```txt
208
+ User intent (full): <…>
209
+ Deliverables enumerated: <list>
210
+
211
+ Recipes:
212
+ | # | Name | Brief seed | Stop condition | Order | Dependencies | Out of scope | Handoff target |
213
+ |---|---|---|---|---|---|---|---|
214
+ | 1 | <name> | <one line> | <one line> | <order> | <deps> | <boundary> | <skill> |
215
+ | 2 | … | … | … | … | … | … | … |
216
+
217
+ Shared assets (planned early): <list>
218
+ Recommended start: <recipe name>
219
+ Next role handoffs:
220
+ - Full brief per recipe: `intent-to-3d-brief-writer`
221
+ - Done condition per recipe: `done-criteria`
222
+ - Stage gating per recipe: `stage-gates`
223
+ - Post-split scope additions: `scope-guard`
224
+
225
+ Runtime status: Not Run
226
+ Artifact status: Not Produced
227
+ Evidence used: none (decomposition pre-work only)
228
+ Limitations: <gaps>
229
+ ```
230
+
231
+ ## Anti-patterns
232
+ - Single mega-recipe.
233
+ - > 5 fragmented recipes.
234
+ - Recipes without stop conditions.
235
+ - Skipping the dependency analysis.
236
+
237
+ ## Cross-skill handoff
238
+ <!-- blendops:generated:start handoffs -->
239
+ - [progression] Full brief authoring for each split recipe → `../intent-to-3d-brief-writer/SKILL.md`
240
+ - [progression] Pinning formal done conditions per recipe → `../done-criteria/SKILL.md`
241
+ - [progression] Workflow stage gates per recipe → `../stage-gates/SKILL.md`
242
+ - [progression] Handling scope added after splitting → `../scope-guard/SKILL.md`
243
+ - [upstream_reference] Pre-decomposition ideation when deliverables are unclear → `../blender-brainstorming/SKILL.md`
244
+ <!-- blendops:generated:end handoffs -->
245
+
246
+ ## Non-goals
247
+ - Run Blender, write Python, or render/export any artifacts.
248
+ - Author full 3D briefs (belongs to `intent-to-3d-brief-writer`).
249
+ - Pin formal acceptance/stop gates (belongs to `done-criteria`).
250
+ - Run per-recipe checklist stage gates (belongs to `stage-gates`).
251
+ - Enforce scope creep after recipes are already split (belongs to `scope-guard`).
252
+ - Make or upgrade runtime or artifact truth claims.
253
+
254
+ ## References
255
+ - `references/recipe-grouping-rules.md`
256
+ - `references/dependency-patterns.md`
257
+ - `references/recipe-naming-rules.md`
258
+ - `../../docs/skill-system.md`
@@ -0,0 +1,152 @@
1
+ {
2
+ "$schema": "../../schemas/skill-contract.schema.json",
3
+ "id": "blender-recipe-decomposer",
4
+ "version": "1.0.0",
5
+ "category": "process-discipline",
6
+ "role": "multi-deliverable-recipe-splitter",
7
+ "purpose": "Break over-scoped Blender intent into 2-5 cohesive recipes with brief seeds, stop conditions, order, dependencies, shared assets, and handoffs.",
8
+ "capabilityTier": "L0",
9
+ "triggers": [
10
+ "I want all of these",
11
+ "this is a lot",
12
+ "we'll need several outputs",
13
+ "across these scenes"
14
+ ],
15
+ "exclusions": [
16
+ {
17
+ "condition": "single deliverable that is already right-sized (hand off directly to intent-to-3d-brief-writer)",
18
+ "delegateTo": "intent-to-3d-brief-writer",
19
+ "reason": "hand off directly to intent-to-3d-brief-writer"
20
+ },
21
+ {
22
+ "condition": "pure exploration or open ideation",
23
+ "delegateTo": "blender-brainstorming",
24
+ "reason": "use blender-brainstorming instead"
25
+ },
26
+ {
27
+ "condition": "after recipes are already split or running",
28
+ "delegateTo": "scope-guard",
29
+ "reason": "use scope-guard for added scope or done-criteria to evaluate completion"
30
+ }
31
+ ],
32
+ "inputs": {
33
+ "required": [
34
+ {
35
+ "name": "multi_deliverable_request",
36
+ "type": "string",
37
+ "description": "User request spanning multiple scenes, deliverables, or incompatible output channels"
38
+ },
39
+ {
40
+ "name": "candidate_recipes",
41
+ "type": "array",
42
+ "description": "Candidate BlendOps recipes or packs identified by recipe-fit-assessor"
43
+ }
44
+ ],
45
+ "optional": [
46
+ {
47
+ "name": "delivery_priority_order",
48
+ "type": "array",
49
+ "description": "Optional user preference on which deliverable to ship first"
50
+ }
51
+ ]
52
+ },
53
+ "outputs": {
54
+ "primary": [
55
+ "ordered_sub_workflow_tracks",
56
+ "shared_asset_and_brief_dependencies",
57
+ "first_track_next_skill"
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": "progression",
69
+ "label": "Full brief authoring for each split recipe",
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": "progression",
88
+ "label": "Pinning formal done conditions per recipe",
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": "progression",
107
+ "label": "Workflow stage gates per recipe",
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": "scope-guard",
125
+ "type": "progression",
126
+ "label": "Handling scope added after splitting",
127
+ "when": {
128
+ "all": [
129
+ {
130
+ "field": "scope.driftDetected",
131
+ "operator": "equals",
132
+ "value": true
133
+ }
134
+ ]
135
+ }
136
+ },
137
+ {
138
+ "target": "blender-brainstorming",
139
+ "type": "upstream_reference",
140
+ "label": "Pre-decomposition ideation when deliverables are unclear",
141
+ "when": {
142
+ "all": [
143
+ {
144
+ "field": "goal.clarity",
145
+ "operator": "equals",
146
+ "value": "ambiguous_or_mixed"
147
+ }
148
+ ]
149
+ }
150
+ }
151
+ ]
152
+ }
@@ -0,0 +1,53 @@
1
+ # Dependency patterns
2
+
3
+ ## Pattern A: Asset-first
4
+
5
+ Recipe 1 prepares shared assets → Recipes 2..N consume them.
6
+
7
+ Common when:
8
+ - Multiple recipes use the same hero model.
9
+ - Brand library / pack is needed first.
10
+
11
+ ## Pattern B: Hero-first
12
+
13
+ Recipe 1 produces the hero scene → Recipe 2 (variants), Recipe 3 (animation), Recipe 4 (different camera angles) consume the hero scene.
14
+
15
+ Common when:
16
+ - One scene drives many outputs.
17
+
18
+ ## Pattern C: Parallel-OK
19
+
20
+ Recipes 1..N are independent.
21
+
22
+ Common when:
23
+ - Multi-scene catalog (portrait + environment + product all separate).
24
+ - No shared assets or scene state.
25
+
26
+ ## Pattern D: Composite-last
27
+
28
+ Recipes 1..N produce inputs → Recipe N+1 composites them.
29
+
30
+ Common when:
31
+ - Multi-product grid composite of N individual product renders.
32
+ - Multi-shot story compositing.
33
+
34
+ ## Recording dependency
35
+
36
+ Per recipe, record:
37
+ - `Depends on: <list of recipe names>` (or "none")
38
+ - `Provides: <list of shared assets / scenes>` (or "none")
39
+
40
+ ## Order strategies
41
+
42
+ - **Topological**: run dependencies before dependents. Always safe.
43
+ - **Parallel where independent**: faster total time but more bookkeeping.
44
+ - **Hero-first then variants**: simplest mental model.
45
+
46
+ ## Failure modes
47
+
48
+ - Circular dependency → impossible; reject.
49
+ - Recipes share runtime state without explicit dependency → break.
50
+ - Composite recipe started before inputs exist → fails gates.
51
+
52
+ ## Related skill
53
+ `../SKILL.md`
@@ -0,0 +1,58 @@
1
+ # Recipe grouping rules
2
+
3
+ ## Group by deliverable, not by process
4
+
5
+ Each recipe's identity = its deliverable artifact (one render, one GLB, one grid). Not "modeling" / "lighting" / "rendering" — those are stages within a recipe.
6
+
7
+ ## Cohesion criteria
8
+
9
+ A recipe is well-grouped if:
10
+ - Single primary deliverable (one render or one GLB).
11
+ - Single brief (mood / style / output target consistent).
12
+ - Single stop condition.
13
+ - Single runtime path used (Path 1 / Path 2 / CLI per recipe).
14
+
15
+ If any of these have to fork → split into multiple recipes.
16
+
17
+ ## Splitting heuristics
18
+
19
+ | Sign | Split decision |
20
+ |---|---|
21
+ | Multiple distinct primary outputs | Split by output |
22
+ | Mixed style / mood (realistic + stylized) | Split by style |
23
+ | Mixed scene type (portrait + environment) | Split by scene type |
24
+ | Mixed time of day / weather across same scope | Often a "looks" recipe per look |
25
+ | Mixed runtime paths (some Path 1, some CLI) | Split by path |
26
+ | Massive variant count (>9 variants) | Group variants into one grid recipe; do not split per variant |
27
+
28
+ ## Common splits
29
+
30
+ - Hero + animation → 2 recipes (animation often needs different export settings)
31
+ - Hero + variants grid → 2 recipes (variant grid has its own consistency rules)
32
+ - Portrait + product hero → 2 recipes (different scene types)
33
+ - 3 product hero shots from same product → 1 recipe (same scope; variation in framing)
34
+
35
+ ## Common over-splits to avoid
36
+
37
+ - Splitting "shoe hero render" into "shoe modeling" + "shoe lighting" + "shoe rendering" (those are stages within `recipe.product-hero-scene`, not separate recipes)
38
+ - Splitting variants into individual recipes when a grid recipe handles them all
39
+ - Splitting render + GLB if the GLB is just the export step of the render scene
40
+
41
+ ## Canonical recipe targets (`registry/recipe-catalog.json`)
42
+
43
+ When decomposing a multi-deliverable brief into bounded sub-recipes, map each sub-recipe to a canonical `recipe.*` ID from `registry/recipe-catalog.json` when applicable:
44
+
45
+ - `recipe.product-hero-scene` — studio product hero still + optional GLB (`packs/product-hero-v0`, `docs/recipes/cyberpunk-shoe-hero.md`)
46
+ - `recipe.stylized-environment-scene` — exterior/architectural environment shot
47
+ - `recipe.hard-surface-prop` — non-destructive bevel/boolean hard-surface asset
48
+ - `recipe.procedural-geometry-nodes-asset` — parametric Geometry Nodes scatter/generator asset
49
+ - `recipe.uv-and-pbr-material-preparation` — UV unwrapping, packing, and Cycles PBR map baking
50
+ - `recipe.presentation-lighting-and-camera` — physical camera rig, 3-point/HDRI studio lighting, AgX/Filmic look
51
+ - `recipe.rigged-and-animated-asset` — skeletal armature, normalized skin weights, and baked NLA actions
52
+ - `recipe.scene-quality-inspection-and-correction` — 7-point pre-handoff verification and remediation
53
+ - `recipe.blender-to-glb-handoff` — glTF 2.0 / GLB export and web handoff manifest
54
+ - `recipe.web-ready-asset-optimization` — LOD generation, KTX2 texture compression, and Draco/Meshopt compression
55
+
56
+ ## Related skill
57
+ `../SKILL.md`
58
+
@@ -0,0 +1,44 @@
1
+ # Recipe naming rules
2
+
3
+ ## Format
4
+
5
+ Use kebab-case lowercase: `<subject>-<deliverable>` or `<subject>-<context>-<deliverable>`.
6
+
7
+ ## Examples
8
+
9
+ Good:
10
+ - `shoe-hero-render`
11
+ - `shoe-color-variants-grid`
12
+ - `shoe-orbit-animation`
13
+ - `office-establishing-shot`
14
+ - `mascot-portrait-hero`
15
+ - `catalog-2x2-composite`
16
+
17
+ Bad:
18
+ - `render-1` (no subject)
19
+ - `make-the-shoe-look-good` (vague)
20
+ - `shoe-stuff` (vague)
21
+ - `Shoe Hero Render` (not kebab-case)
22
+
23
+ ## Components
24
+
25
+ | Component | Purpose |
26
+ |---|---|
27
+ | Subject | What is in the scene (shoe, character, room) |
28
+ | Context | If multiple of same subject (hero, variants, orbit) |
29
+ | Deliverable | The output type (render / animation / grid / glb) |
30
+
31
+ ## Why naming matters
32
+
33
+ - Recipe names appear in evidence files (`docs/evals/<recipe-name>-...md`).
34
+ - Other skills reference recipes by name (gates, stop conditions, decompositions).
35
+ - Future search / catalog of recipes uses the name as a key.
36
+
37
+ ## Length
38
+
39
+ - 2-4 hyphen-separated words.
40
+ - < 30 characters.
41
+ - Reads as the deliverable, not as a sentence.
42
+
43
+ ## Related skill
44
+ `../SKILL.md`
@@ -0,0 +1,78 @@
1
+ # EVAL — blender-troubleshooting
2
+
3
+ Status: 1.0.0 text-only baseline
4
+ Scope: structured root-cause diagnosis only; no Blender execution; no artifact claims.
5
+
6
+ ## Text-only eval prompt
7
+
8
+ Use blender-troubleshooting on a Blender output that does not match intent. Run the 4 phases (reproduce → narrow → identify → propose). Do not run Blender. Do not invent fixes without evidence.
9
+
10
+ ## Expected behavior
11
+
12
+ - documents expected vs. observed with evidence per phase
13
+ - runs Phase 1 reproducibility check before any conclusion
14
+ - narrows to the smallest reproducing input
15
+ - identifies one root cause + 1-2 rejected alternatives with reasons
16
+ - proposes one fix with explicit pass criteria
17
+ - hands off to the correct downstream skill (planner / readiness / evidence / response)
18
+
19
+ ## Eval cases
20
+
21
+ | Case | Input | Expected output | Required evidence |
22
+ |---|---|---|---|
23
+ | Render is black | Expected: cyberpunk-lit shoe; observed: fully black render file | Phase 1: reproducible 3/3. Phase 2: narrowed to lighting plan missing key light. Phase 3: root cause = lighting plan gap. Phase 4: fix = re-run lighting planner | reproducibility, narrowed input, root cause, fix + pass criteria |
24
+ | GLB is empty | Expected: GLB with hero shoe + floor; observed: 100-byte empty `.glb` | Phase 1: reproducible. Phase 2: narrowed to export plan excluded geometry. Phase 3: root cause = export plan misconfig. Phase 4: fix = re-run GLB handoff | same fields |
25
+ | Final response uses jargon | Expected: plain-language; observed: "BSDF subsurf topology" | Phase 1: reproducible. Phase 2: response writer received raw plan dump. Phase 3: root cause = missing translation step. Phase 4: fix = route through `plain-language-response` | same fields |
26
+ | Symptom intermittent | Render is black 1/5 runs | Phase 1: marked intermittent, ≥2 reproductions before continuing. No fix proposed yet | intermittent flag, no fix, request for more evidence |
27
+ | Evidence missing | Operator says "the output is wrong" but no file path / log | Phase 1 blocked. Cannot proceed. Route to readiness checker for evidence collection | blocked phase 1 explicit, no speculative fix |
28
+ | Two equally plausible causes | Lighting plan AND camera plan both could explain wrong framing | Phase 3: cause ranked by evidence weight, second cause marked "alternative pending more evidence" | ranked list, alternative kept open |
29
+
30
+ ## Expected evidence/status fields
31
+
32
+ | Field | Required content |
33
+ |---|---|
34
+ | Expected outcome | Quoted from intent / brief / planner |
35
+ | Observed outcome | File path / screenshot / log / response text |
36
+ | Phase 1 (reproduce) | Reproducibility count, locked inputs |
37
+ | Phase 2 (narrow) | Minimum reproducing input |
38
+ | Phase 3 (identify) | One root cause + alternatives considered + rejection reasons |
39
+ | Phase 4 (propose) | One fix + explicit pass criteria + handoff skill |
40
+ | Runtime status | Unchanged by this skill |
41
+ | Artifact status | Unchanged by this skill |
42
+
43
+ ## Pass / Warn / Fail criteria
44
+
45
+ - Pass: all 4 phases completed or explicitly marked blocked, root cause is one sentence, alternatives ranked, fix has pass criteria, handoff named
46
+ - Warn: phases completed but reproducibility unclear, or alternatives not ranked, or fix lacks pass criteria
47
+ - Fail: skipped phases, multiple speculative causes claimed simultaneously, fix proposed without root cause, claimed Blender execution from this skill
48
+
49
+ ## Common failure modes
50
+
51
+ - proposing fixes in Phase 1 (before reproduction is locked)
52
+ - listing 5+ possible causes without ranking
53
+ - skipping Phase 2 narrowing
54
+ - claiming "I'll re-render now" — this skill never re-runs
55
+ - using Blender jargon in the operator-facing summary
56
+
57
+ ## Evidence expectations
58
+
59
+ - diagnostic record visible per phase
60
+ - evidence cited for every claim
61
+ - explicit `blocked` markers when evidence missing
62
+ - handoff skill named with one-sentence justification
63
+
64
+ ## Sample passing response outline
65
+
66
+ - Expected: <quote from intent>
67
+ - Observed: <evidence>
68
+ - Phase 1 (reproduce): <count, locked inputs>
69
+ - Phase 2 (narrow): <minimum reproducing input>
70
+ - Phase 3 (identify): root cause = <one sentence>; rejected alternatives = <list with reasons>
71
+ - Phase 4 (propose): fix = <one sentence>; pass criteria = <observable test>; handoff = <skill name>
72
+
73
+ ## Sample failing response outline
74
+
75
+ - Skipped Phase 1, jumped to "probably needs better lighting"
76
+ - Listed 4 possible causes without evidence ranking
77
+ - Proposed fix without pass criteria
78
+ - Claimed "I'll re-render with better settings" (this skill never executes)