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,236 @@
1
+ # BlendOps Knowledge & Recipe Catalog
2
+
3
+ > Generated deterministically from `registry/knowledge-sources.json`, `registry/knowledge-catalog.json`, and `registry/recipe-catalog.json` via `npm run catalog:build`. Do not edit by hand.
4
+
5
+ ## Overview & Retrieval CLI
6
+
7
+ BlendOps separates **atomic agent workflow skills** (`skills/*/SKILL.md`) from **reusable 3D/Blender domain knowledge** (`knowledge.*`) and **multi-stage construction recipes** (`recipe.*`).
8
+
9
+ - **Deterministic Local Search (English & Vietnamese)**: `npx blendops catalog-search "<query>" [--type knowledge|recipe] [--domain <domain>]`
10
+ - **Deterministic Record Resolution**: `npx blendops catalog-resolve <knowledge.id | recipe.id | source.id | skill-id>`
11
+ - **Catalog Schema & Cross-Reference Validation**: `npx blendops catalog-validate`
12
+ - **SceneSpec Validation & Plan Compilation**: `npx blendops scene-spec-validate <spec.json>` / `npx blendops plan-compile <spec.json>`
13
+
14
+ | Metric | Count | Canonical Source |
15
+ | :--- | ---: | :--- |
16
+ | Knowledge Domains | 11 | `registry/knowledge-sources.json` |
17
+ | Canonical Knowledge Records (`knowledge.*`) | 30 | `registry/knowledge-catalog.json` |
18
+ | Canonical Recipes (`recipe.*`) | 10 | `registry/recipe-catalog.json` |
19
+ | Authoritative Sources (`source.*`) | 20 | `registry/knowledge-sources.json` |
20
+ | Latest Stable Blender LTS Baseline | `5.2.3 LTS` | `registry/knowledge-sources.json` |
21
+
22
+ ---
23
+
24
+ ## 1. Canonical Recipes (`recipe.*`)
25
+
26
+ | Recipe ID | Title | Primary Domain | Stages | Required Skills | Linked Knowledge | Min Blender | Doc-Checked LTS | Evidence Status |
27
+ | :--- | :--- | :--- | ---: | ---: | ---: | :--- | :--- | :--- |
28
+ | `recipe.product-hero-scene` | Product Hero Scene & Web-Ready Presentation | `lighting-camera-and-rendering` | 4 | 18 | 10 | `3.6 LTS` | `5.2.3 LTS` | `version-checked` |
29
+ | `recipe.stylized-environment-scene` | Stylized Environment & Establishing Shot Assembly | `environment-and-architecture` | 4 | 15 | 9 | `3.6 LTS` | `5.2.3 LTS` | `version-checked` |
30
+ | `recipe.hard-surface-prop` | Non-Destructive Hard-Surface Prop Modeling & Shading Hygiene | `hard-surface-and-organic` | 4 | 10 | 10 | `3.6 LTS` | `5.2.3 LTS` | `version-checked` |
31
+ | `recipe.procedural-geometry-nodes-asset` | Procedural Geometry Nodes Asset & Scatter Pipeline | `geometry-nodes-and-procedural` | 4 | 11 | 6 | `3.6 LTS` | `5.2.3 LTS` | `version-checked` |
32
+ | `recipe.uv-and-pbr-material-preparation` | UV Unwrapping, Texel Density & Energy-Conserving PBR Material Preparation | `uv-texturing-and-baking` | 4 | 9 | 9 | `3.6 LTS` | `5.2.3 LTS` | `version-checked` |
33
+ | `recipe.presentation-lighting-and-camera` | Studio Lighting, Physical Camera & Color-Managed Render Setup | `lighting-camera-and-rendering` | 4 | 14 | 5 | `3.6 LTS` | `5.2.3 LTS` | `version-checked` |
34
+ | `recipe.rigged-and-animated-asset` | Skeletal Rigging, Skin Weight Normalization & NLA Action Baking for Export | `rigging-and-animation` | 4 | 9 | 8 | `3.6 LTS` | `5.2.3 LTS` | `version-checked` |
35
+ | `recipe.scene-quality-inspection-and-correction` | Multi-Gate Scene Quality Inspection, Root-Cause Triage & Correction Plan | `lighting-camera-and-rendering` | 4 | 11 | 10 | `3.6 LTS` | `5.2.3 LTS` | `version-checked` |
36
+ | `recipe.blender-to-glb-handoff` | Verified Blender-to-GLB Export, Binary Inspection & Web Viewer Handoff | `interchange-gltf-and-web` | 4 | 9 | 7 | `3.6 LTS` | `5.2.3 LTS` | `version-checked` |
37
+ | `recipe.web-ready-asset-optimization` | Mobile/Web GLB Performance Budgeting, Compression & LOD Pipeline | `optimization-lod-and-performance` | 4 | 10 | 8 | `3.6 LTS` | `5.2.3 LTS` | `version-checked` |
38
+
39
+ ### Recipe Details & Scenario Linkages
40
+
41
+ #### `recipe.product-hero-scene` — Product Hero Scene & Web-Ready Presentation
42
+
43
+ - **Intent**: Transform a product brief into a verified single-subject hero scene with three-point/accent lighting, physically plausible materials, controlled reflections, and an optional web-ready GLB handoff package.
44
+ - **Domain**: `lighting-camera-and-rendering`
45
+ - **Required Skills**: `intent-to-3d-brief-writer`, `done-criteria`, `asset-discovery`, `asset-license-checker`, `product-hero-scene-planner`, `camera-composition`, `resolution-aspect-decision`, `lighting-material-plan`, `color-management-decision`, `cycles-vs-eevee-decision`, `lighting-quality-checker`, `material-quality-checker`, `composition-quality-checker`, `scene-readiness`, `render-export-evidence`, `pre-handoff-verification`, `glb-web-handoff`, `plain-language-response`
46
+ - **Knowledge Records**: `knowledge.mesh-manifold-normals-and-scale-hygiene`, `knowledge.triangle-draw-call-and-vram-budgets`, `knowledge.physically-based-camera-lens-and-dof`, `knowledge.modular-architectural-grid-and-metric-scale`, `knowledge.three-point-and-hdri-studio-lighting`, `knowledge.principled-bsdf-v2-energy-conserving-pbr`, `knowledge.agx-filmic-color-management-and-cycles-eevee`, `knowledge.shader-node-gltf-export-portability`, `knowledge.glb-binary-chunk-alignment-and-khronos-validation`, `knowledge.threejs-r3f-tone-mapping-and-environment-parity`
47
+ - **Stages**: `stage-brief-and-scope` (Stage 1) → `stage-scene-and-camera-plan` (Stage 2) → `stage-lighting-and-materials` (Stage 3) → `stage-quality-and-handoff` (Stage 4)
48
+ - **Scenario Reference Doc**: `docs/recipes/cyberpunk-shoe-hero.md`
49
+
50
+ #### `recipe.stylized-environment-scene` — Stylized Environment & Establishing Shot Assembly
51
+
52
+ - **Intent**: Plan and assemble a readable environment or diorama establishing shot with metric scale cues, three-plane depth staging, instanced foliage/props, and time-of-day atmospheric lighting.
53
+ - **Domain**: `environment-and-architecture`
54
+ - **Required Skills**: `intent-to-3d-brief-writer`, `asset-discovery`, `asset-license-checker`, `asset-style-check`, `environment-shot`, `camera-composition`, `resolution-aspect-decision`, `lighting-material-plan`, `polycount-budget-checker`, `cycles-vs-eevee-decision`, `composition-quality-checker`, `lighting-quality-checker`, `scene-readiness`, `pre-handoff-verification`, `plain-language-response`
55
+ - **Knowledge Records**: `knowledge.modular-architectural-grid-and-metric-scale`, `knowledge.mesh-manifold-normals-and-scale-hygiene`, `knowledge.environment-depth-layering-and-atmospheric-perspective`, `knowledge.physically-based-camera-lens-and-dof`, `knowledge.procedural-instancing-and-realize-instances-budget`, `knowledge.procedural-scatter-poisson-disk-and-slope-masking`, `knowledge.volumetrics-fog-and-principled-volume-tradeoffs`, `knowledge.agx-filmic-color-management-and-cycles-eevee`, `knowledge.triangle-draw-call-and-vram-budgets`
56
+ - **Stages**: `stage-environment-brief-and-assets` (Stage 1) → `stage-depth-layering-and-camera` (Stage 2) → `stage-procedural-scatter-and-atmosphere` (Stage 3) → `stage-environment-validation-and-handoff` (Stage 4)
57
+
58
+ #### `recipe.hard-surface-prop` — Non-Destructive Hard-Surface Prop Modeling & Shading Hygiene
59
+
60
+ - **Intent**: Design and validate a mechanical or manufactured hard-surface prop with consistent millimeter bevel widths, clean boolean shading via weighted normals or quad holding loops, and export-ready mesh hygiene.
61
+ - **Domain**: `hard-surface-and-organic`
62
+ - **Required Skills**: `intent-to-3d-brief-writer`, `done-criteria`, `scope-guard`, `stage-gates`, `polycount-budget-checker`, `lighting-material-plan`, `material-quality-checker`, `scene-readiness`, `pre-handoff-verification`, `plain-language-response`
63
+ - **Knowledge Records**: `knowledge.mesh-manifold-normals-and-scale-hygiene`, `knowledge.cad-creases-and-panel-gap-detailing`, `knowledge.non-destructive-hard-surface-modifier-stack`, `knowledge.boolean-bevel-shading-cleanup`, `knowledge.quad-dominant-subdivision-topology`, `knowledge.uv-seam-placement-and-texel-density`, `knowledge.high-to-low-normal-and-ao-baking`, `knowledge.principled-bsdf-v2-energy-conserving-pbr`, `knowledge.triangle-draw-call-and-vram-budgets`, `knowledge.gltf-2-coordinate-system-and-transform-conventions`
64
+ - **Stages**: `stage-prop-scale-and-blockout` (Stage 1) → `stage-modifier-stack-and-topology` (Stage 2) → `stage-uv-and-surface-materials` (Stage 3) → `stage-prop-validation-and-handoff` (Stage 4)
65
+
66
+ #### `recipe.procedural-geometry-nodes-asset` — Procedural Geometry Nodes Asset & Scatter Pipeline
67
+
68
+ - **Intent**: Build a deterministic, parameter-exposed Geometry Nodes asset or scatter system with explicit attribute domain propagation, instance memory discipline, and clear realization rules for rendering vs. glTF export.
69
+ - **Domain**: `geometry-nodes-and-procedural`
70
+ - **Required Skills**: `intent-to-3d-brief-writer`, `done-criteria`, `stage-gates`, `polycount-budget-checker`, `asset-style-check`, `lighting-material-plan`, `material-quality-checker`, `scene-readiness`, `glb-web-handoff`, `pre-handoff-verification`, `plain-language-response`
71
+ - **Knowledge Records**: `knowledge.geometry-nodes-fields-and-anonymous-attributes`, `knowledge.mesh-manifold-normals-and-scale-hygiene`, `knowledge.procedural-scatter-poisson-disk-and-slope-masking`, `knowledge.procedural-instancing-and-realize-instances-budget`, `knowledge.shader-node-gltf-export-portability`, `knowledge.glb-binary-chunk-alignment-and-khronos-validation`
72
+ - **Stages**: `stage-gn-interface-and-inputs` (Stage 1) → `stage-gn-distribution-and-instancing` (Stage 2) → `stage-gn-attributes-and-shading` (Stage 3) → `stage-gn-realization-and-export` (Stage 4)
73
+
74
+ #### `recipe.uv-and-pbr-material-preparation` — UV Unwrapping, Texel Density & Energy-Conserving PBR Material Preparation
75
+
76
+ - **Intent**: Prepare clean, non-overlapping 0-1 UV layouts (or UDIM tiles for offline renders), bake high-to-low or procedural maps without seam artifacts, and wire physically accurate PBR materials.
77
+ - **Domain**: `uv-texturing-and-baking`
78
+ - **Required Skills**: `stage-gates`, `material-quality-checker`, `cycles-vs-eevee-decision`, `output-format-decision`, `lighting-material-plan`, `mobile-glb-budget`, `scene-readiness`, `pre-handoff-verification`, `plain-language-response`
79
+ - **Knowledge Records**: `knowledge.uv-seam-placement-and-texel-density`, `knowledge.udim-vs-single-atlas-uv-packing`, `knowledge.mesh-manifold-normals-and-scale-hygiene`, `knowledge.high-to-low-normal-and-ao-baking`, `knowledge.normal-roughness-and-orm-channel-packing`, `knowledge.principled-bsdf-v2-energy-conserving-pbr`, `knowledge.shader-node-gltf-export-portability`, `knowledge.texture-resolution-ktx2-and-draco-meshopt-compression`, `knowledge.triangle-draw-call-and-vram-budgets`
80
+ - **Stages**: `stage-uv-seams-and-unwrap` (Stage 1) → `stage-mikktspace-baking` (Stage 2) → `stage-principled-bsdf-wiring` (Stage 3) → `stage-material-validation-and-handoff` (Stage 4)
81
+
82
+ #### `recipe.presentation-lighting-and-camera` — Studio Lighting, Physical Camera & Color-Managed Render Setup
83
+
84
+ - **Intent**: Configure a production-ready camera, lighting rig, color management pipeline, and render engine (Cycles or EEVEE) with verified contrast ratios, shadow softness, and output format settings.
85
+ - **Domain**: `lighting-camera-and-rendering`
86
+ - **Required Skills**: `camera-composition`, `resolution-aspect-decision`, `character-portrait`, `interior-scene`, `lighting-material-plan`, `lighting-quality-checker`, `color-management-decision`, `cycles-vs-eevee-decision`, `output-format-decision`, `composition-quality-checker`, `scene-readiness`, `render-export-evidence`, `pre-handoff-verification`, `plain-language-response`
87
+ - **Knowledge Records**: `knowledge.physically-based-camera-lens-and-dof`, `knowledge.modular-architectural-grid-and-metric-scale`, `knowledge.three-point-and-hdri-studio-lighting`, `knowledge.principled-bsdf-v2-energy-conserving-pbr`, `knowledge.agx-filmic-color-management-and-cycles-eevee`
88
+ - **Stages**: `stage-camera-optics-and-framing` (Stage 1) → `stage-three-point-and-hdri-lighting` (Stage 2) → `stage-color-and-render-engine` (Stage 3) → `stage-render-quality-and-handoff` (Stage 4)
89
+
90
+ #### `recipe.rigged-and-animated-asset` — Skeletal Rigging, Skin Weight Normalization & NLA Action Baking for Export
91
+
92
+ - **Intent**: Rig, skin, animate, and bake skeletal or shape-key animations so that IK/constraint rigs convert cleanly into self-contained FK deform keyframes and export to GLB without deformation breakage.
93
+ - **Domain**: `rigging-and-animation`
94
+ - **Required Skills**: `intent-to-3d-brief-writer`, `stage-gates`, `polycount-budget-checker`, `mobile-glb-budget`, `glb-animation-handoff`, `r3f-component-plan`, `glb-web-handoff`, `pre-handoff-verification`, `plain-language-response`
95
+ - **Knowledge Records**: `knowledge.armature-joint-hierarchy-and-linear-blend-skinning`, `knowledge.mesh-manifold-normals-and-scale-hygiene`, `knowledge.organic-sculpt-to-retopology-workflow`, `knowledge.nla-action-baking-and-morph-target-export`, `knowledge.rigid-body-cloth-and-simulation-cache-baking`, `knowledge.gltf-2-coordinate-system-and-transform-conventions`, `knowledge.glb-binary-chunk-alignment-and-khronos-validation`, `knowledge.threejs-r3f-tone-mapping-and-environment-parity`
96
+ - **Stages**: `stage-armature-and-transform-hygiene` (Stage 1) → `stage-skin-weights-and-morphs` (Stage 2) → `stage-nla-action-baking` (Stage 3) → `stage-animation-validation-and-handoff` (Stage 4)
97
+
98
+ #### `recipe.scene-quality-inspection-and-correction` — Multi-Gate Scene Quality Inspection, Root-Cause Triage & Correction Plan
99
+
100
+ - **Intent**: Systematically evaluate a 3D scene or plan against domain quality rubrics, classify blockers vs. warnings, run 4-phase root-cause troubleshooting on defects, and issue an evidence-backed Pass/Warn/Fail readiness verdict.
101
+ - **Domain**: `lighting-camera-and-rendering`
102
+ - **Required Skills**: `blender-troubleshooting`, `polycount-budget-checker`, `material-quality-checker`, `lighting-quality-checker`, `color-management-decision`, `composition-quality-checker`, `scene-readiness`, `stage-gates`, `render-export-evidence`, `pre-handoff-verification`, `plain-language-response`
103
+ - **Knowledge Records**: `knowledge.mesh-manifold-normals-and-scale-hygiene`, `knowledge.boolean-bevel-shading-cleanup`, `knowledge.triangle-draw-call-and-vram-budgets`, `knowledge.principled-bsdf-v2-energy-conserving-pbr`, `knowledge.normal-roughness-and-orm-channel-packing`, `knowledge.three-point-and-hdri-studio-lighting`, `knowledge.agx-filmic-color-management-and-cycles-eevee`, `knowledge.physically-based-camera-lens-and-dof`, `knowledge.environment-depth-layering-and-atmospheric-perspective`, `knowledge.glb-binary-chunk-alignment-and-khronos-validation`
104
+ - **Stages**: `stage-symptom-triage-and-geometry-audit` (Stage 1) → `stage-material-and-lighting-audit` (Stage 2) → `stage-composition-and-holistic-readiness` (Stage 3) → `stage-correction-verification-and-response` (Stage 4)
105
+
106
+ #### `recipe.blender-to-glb-handoff` — Verified Blender-to-GLB Export, Binary Inspection & Web Viewer Handoff
107
+
108
+ - **Intent**: Ensure a Blender asset exports cleanly to a spec-compliant GLB 2.0 binary container, run deterministic structural inspection (`blendops glb-inspect` / `glb-handoff`), and provide complete Three.js or React Three Fiber integration guidance.
109
+ - **Domain**: `interchange-gltf-and-web`
110
+ - **Required Skills**: `material-quality-checker`, `polycount-budget-checker`, `glb-animation-handoff`, `render-export-evidence`, `preview-report`, `r3f-component-plan`, `glb-web-handoff`, `pre-handoff-verification`, `plain-language-response`
111
+ - **Knowledge Records**: `knowledge.gltf-2-coordinate-system-and-transform-conventions`, `knowledge.shader-node-gltf-export-portability`, `knowledge.normal-roughness-and-orm-channel-packing`, `knowledge.glb-binary-chunk-alignment-and-khronos-validation`, `knowledge.texture-resolution-ktx2-and-draco-meshopt-compression`, `knowledge.threejs-r3f-tone-mapping-and-environment-parity`, `knowledge.agx-filmic-color-management-and-cycles-eevee`
112
+ - **Stages**: `stage-pre-export-gltf-audit` (Stage 1) → `stage-glb-container-inspection` (Stage 2) → `stage-web-viewer-component-plan` (Stage 3) → `stage-handoff-verification-and-summary` (Stage 4)
113
+
114
+ #### `recipe.web-ready-asset-optimization` — Mobile/Web GLB Performance Budgeting, Compression & LOD Pipeline
115
+
116
+ - **Intent**: Pin device-tier performance budgets upfront, audit geometry/texture/draw-call bottlenecks, design a progressive degradation and LOD plan, and select optimal texture (KTX2 ETC1S/UASTC) and mesh (Draco vs. Meshopt) compression.
117
+ - **Domain**: `optimization-lod-and-performance`
118
+ - **Required Skills**: `mobile-glb-budget`, `done-criteria`, `polycount-budget-checker`, `asset-fallback-strategy`, `material-quality-checker`, `output-format-decision`, `glb-web-handoff`, `r3f-component-plan`, `pre-handoff-verification`, `plain-language-response`
119
+ - **Knowledge Records**: `knowledge.triangle-draw-call-and-vram-budgets`, `knowledge.lod-hierarchy-and-decimation-strategy`, `knowledge.procedural-instancing-and-realize-instances-budget`, `knowledge.normal-roughness-and-orm-channel-packing`, `knowledge.texture-resolution-ktx2-and-draco-meshopt-compression`, `knowledge.udim-vs-single-atlas-uv-packing`, `knowledge.glb-binary-chunk-alignment-and-khronos-validation`, `knowledge.threejs-r3f-tone-mapping-and-environment-parity`
120
+ - **Stages**: `stage-pin-device-budget` (Stage 1) → `stage-geometry-and-lod-optimization` (Stage 2) → `stage-texture-and-mesh-compression` (Stage 3) → `stage-optimization-verification-and-handoff` (Stage 4)
121
+
122
+ ---
123
+
124
+ ## 2. Canonical Knowledge Records by Domain (`knowledge.*`)
125
+
126
+ ### Domain: `modeling-and-topology` (3 records)
127
+
128
+ | Knowledge ID | Title | Kind | Min Blender | Doc-Checked LTS | Evidence Status | Linked Skills | Linked Recipes |
129
+ | :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
130
+ | `knowledge.quad-dominant-subdivision-topology` | Quad-Dominant Subdivision Topology, Pole Routing & Edge-Flow Discipline | `topology-rule` | `3.0+` | `5.2.3 LTS` | `version-checked` | `polycount-budget-checker`, `scene-readiness`, `product-hero-scene-planner`, `character-portrait` | `recipe.product-hero-scene`, `recipe.hard-surface-prop` |
131
+ | `knowledge.mesh-manifold-normals-and-scale-hygiene` | Mesh Manifold Integrity, Outward Normals & Applied Scale Hygiene | `topology-rule` | `3.0+` | `5.2.3 LTS` | `version-checked` | `blender-troubleshooting`, `polycount-budget-checker`, `scene-readiness`, `pre-handoff-verification` | `recipe.product-hero-scene`, `recipe.hard-surface-prop`, `recipe.uv-and-pbr-material-preparation`, `recipe.scene-quality-inspection-and-correction` |
132
+ | `knowledge.boolean-bevel-shading-cleanup` | Boolean Cutout Shading Cleanup, Custom Split Normals & Smooth by Angle | `topology-rule` | `3.6 LTS` | `5.2.3 LTS` | `version-checked` | `blender-troubleshooting`, `polycount-budget-checker`, `scene-readiness` | `recipe.hard-surface-prop`, `recipe.scene-quality-inspection-and-correction` |
133
+
134
+ ### Domain: `hard-surface-and-organic` (3 records)
135
+
136
+ | Knowledge ID | Title | Kind | Min Blender | Doc-Checked LTS | Evidence Status | Linked Skills | Linked Recipes |
137
+ | :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
138
+ | `knowledge.non-destructive-hard-surface-modifier-stack` | Non-Destructive Hard-Surface Modifier Stack Ordering & Evaluation Rules | `modeling-workflow` | `3.6 LTS` | `5.2.3 LTS` | `version-checked` | `product-hero-scene-planner`, `polycount-budget-checker`, `blender-troubleshooting` | `recipe.hard-surface-prop`, `recipe.product-hero-scene` |
139
+ | `knowledge.organic-sculpt-to-retopology-workflow` | Organic High-Poly Sculpting to Clean Quad Retopology & Detail Transfer | `modeling-workflow` | `3.6 LTS` | `5.2.3 LTS` | `version-checked` | `character-portrait`, `polycount-budget-checker`, `mobile-glb-budget` | `recipe.rigged-and-animated-asset`, `recipe.uv-and-pbr-material-preparation` |
140
+ | `knowledge.cad-creases-and-panel-gap-detailing` | Physical Bevel Minimums, Panel Seam Gaps & Industrial Readability | `modeling-workflow` | `3.0+` | `5.2.3 LTS` | `version-checked` | `product-hero-scene-planner`, `lighting-material-plan`, `polycount-budget-checker` | `recipe.product-hero-scene`, `recipe.hard-surface-prop` |
141
+
142
+ ### Domain: `geometry-nodes-and-procedural` (3 records)
143
+
144
+ | Knowledge ID | Title | Kind | Min Blender | Doc-Checked LTS | Evidence Status | Linked Skills | Linked Recipes |
145
+ | :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
146
+ | `knowledge.geometry-nodes-fields-and-anonymous-attributes` | Geometry Nodes Fields Evaluation, Attribute Domains & UV/Shader Persistence | `procedural-system` | `3.6 LTS` | `5.2.3 LTS` | `version-checked` | `polycount-budget-checker`, `lighting-material-plan`, `material-quality-checker`, `glb-web-handoff` | `recipe.procedural-geometry-nodes-asset`, `recipe.stylized-environment-scene` |
147
+ | `knowledge.procedural-instancing-and-realize-instances-budget` | Procedural Collection Instancing vs. Realize Instances Memory & Export Tradeoffs | `procedural-system` | `3.6 LTS` | `5.2.3 LTS` | `version-checked` | `polycount-budget-checker`, `mobile-glb-budget`, `r3f-component-plan`, `glb-web-handoff` | `recipe.procedural-geometry-nodes-asset`, `recipe.stylized-environment-scene`, `recipe.web-ready-asset-optimization` |
148
+ | `knowledge.procedural-scatter-poisson-disk-and-slope-masking` | Poisson Disk Point Distribution, Slope/Altitude Masking & Orientation Alignment | `procedural-system` | `3.6 LTS` | `5.2.3 LTS` | `version-checked` | `environment-shot`, `polycount-budget-checker`, `product-hero-scene-planner` | `recipe.procedural-geometry-nodes-asset`, `recipe.stylized-environment-scene` |
149
+
150
+ ### Domain: `uv-texturing-and-baking` (3 records)
151
+
152
+ | Knowledge ID | Title | Kind | Min Blender | Doc-Checked LTS | Evidence Status | Linked Skills | Linked Recipes |
153
+ | :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
154
+ | `knowledge.uv-seam-placement-and-texel-density` | UV Seam Placement, Hard-Edge Splits, Texel Density & Mipmap Padding | `uv-baking-rule` | `3.6 LTS` | `5.2.3 LTS` | `version-checked` | `material-quality-checker`, `lighting-material-plan`, `mobile-glb-budget` | `recipe.uv-and-pbr-material-preparation`, `recipe.hard-surface-prop`, `recipe.product-hero-scene` |
155
+ | `knowledge.udim-vs-single-atlas-uv-packing` | Single 0-1 UV Atlas Packing vs. Multi-Tile UDIM Workflows for Offline & glTF | `uv-baking-rule` | `3.6 LTS` | `5.2.3 LTS` | `version-checked` | `material-quality-checker`, `mobile-glb-budget`, `lighting-material-plan`, `glb-web-handoff` | `recipe.uv-and-pbr-material-preparation`, `recipe.web-ready-asset-optimization` |
156
+ | `knowledge.high-to-low-normal-and-ao-baking` | Tangent-Space MikkTSpace Normal & Ambient Occlusion Baking Protocol | `uv-baking-rule` | `3.6 LTS` | `5.2.3 LTS` | `version-checked` | `material-quality-checker`, `lighting-material-plan`, `cycles-vs-eevee-decision` | `recipe.uv-and-pbr-material-preparation`, `recipe.hard-surface-prop`, `recipe.product-hero-scene` |
157
+
158
+ ### Domain: `materials-shaders-and-pbr` (3 records)
159
+
160
+ | Knowledge ID | Title | Kind | Min Blender | Doc-Checked LTS | Evidence Status | Linked Skills | Linked Recipes |
161
+ | :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
162
+ | `knowledge.principled-bsdf-v2-energy-conserving-pbr` | Principled BSDF v2 Energy Conservation, Dielectric vs. Conductor Albedo & Blender 4.0+ Socket Changes | `material-shader-profile` | `3.6 LTS` | `5.2.3 LTS` | `version-checked` | `lighting-material-plan`, `material-quality-checker`, `product-hero-scene-planner` | `recipe.product-hero-scene`, `recipe.uv-and-pbr-material-preparation`, `recipe.presentation-lighting-and-camera`, `recipe.scene-quality-inspection-and-correction` |
163
+ | `knowledge.normal-roughness-and-orm-channel-packing` | ORM Channel Packing (Occlusion/Roughness/Metallic) & Linear Non-Color Space Discipline | `material-shader-profile` | `3.6 LTS` | `5.2.3 LTS` | `version-checked` | `material-quality-checker`, `lighting-material-plan`, `glb-web-handoff`, `mobile-glb-budget` | `recipe.uv-and-pbr-material-preparation`, `recipe.product-hero-scene`, `recipe.blender-to-glb-handoff`, `recipe.web-ready-asset-optimization` |
164
+ | `knowledge.shader-node-gltf-export-portability` | Blender Shader Graph to Khronos glTF 2.0 Export Portability & Extension Matrix | `material-shader-profile` | `3.6 LTS` | `5.2.3 LTS` | `version-checked` | `lighting-material-plan`, `material-quality-checker`, `glb-web-handoff`, `r3f-component-plan` | `recipe.product-hero-scene`, `recipe.uv-and-pbr-material-preparation`, `recipe.blender-to-glb-handoff`, `recipe.procedural-geometry-nodes-asset` |
165
+
166
+ ### Domain: `lighting-camera-and-rendering` (3 records)
167
+
168
+ | Knowledge ID | Title | Kind | Min Blender | Doc-Checked LTS | Evidence Status | Linked Skills | Linked Recipes |
169
+ | :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
170
+ | `knowledge.three-point-and-hdri-studio-lighting` | Three-Point Studio Lighting Ratios, Area Light Angular Size & HDRI Balance | `lighting-camera-rule` | `3.6 LTS` | `5.2.3 LTS` | `version-checked` | `lighting-material-plan`, `lighting-quality-checker`, `product-hero-scene-planner`, `character-portrait` | `recipe.product-hero-scene`, `recipe.presentation-lighting-and-camera`, `recipe.scene-quality-inspection-and-correction` |
171
+ | `knowledge.physically-based-camera-lens-and-dof` | Physical Camera Sensor Size, Focal Length Compression, Tilt-Shift & Depth of Field | `lighting-camera-rule` | `3.0+` | `5.2.3 LTS` | `version-checked` | `camera-composition`, `composition-quality-checker`, `product-hero-scene-planner`, `character-portrait`, `interior-scene`, `environment-shot` | `recipe.product-hero-scene`, `recipe.presentation-lighting-and-camera`, `recipe.stylized-environment-scene` |
172
+ | `knowledge.agx-filmic-color-management-and-cycles-eevee` | AgX vs. Filmic Color Management, EEVEE Next (4.2+) vs. Cycles & Output Bit Depth | `render-engine-profile` | `3.6 LTS` | `5.2.3 LTS` | `version-checked` | `color-management-decision`, `cycles-vs-eevee-decision`, `output-format-decision`, `lighting-quality-checker` | `recipe.product-hero-scene`, `recipe.presentation-lighting-and-camera`, `recipe.stylized-environment-scene`, `recipe.scene-quality-inspection-and-correction`, `recipe.blender-to-glb-handoff` |
173
+
174
+ ### Domain: `rigging-and-animation` (2 records)
175
+
176
+ | Knowledge ID | Title | Kind | Min Blender | Doc-Checked LTS | Evidence Status | Linked Skills | Linked Recipes |
177
+ | :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
178
+ | `knowledge.armature-joint-hierarchy-and-linear-blend-skinning` | Armature Joint Hierarchy, Transform Alignment & 4-Bone Linear Blend Skinning | `rigging-animation-rule` | `3.6 LTS` | `5.2.3 LTS` | `version-checked` | `glb-animation-handoff`, `polycount-budget-checker`, `mobile-glb-budget`, `r3f-component-plan` | `recipe.rigged-and-animated-asset`, `recipe.blender-to-glb-handoff` |
179
+ | `knowledge.nla-action-baking-and-morph-target-export` | NLA Action Baking, Constraint Sampling, and Shape Key (Morph Target) Export Rules | `rigging-animation-rule` | `3.6 LTS` | `5.2.3 LTS` | `version-checked` | `glb-animation-handoff`, `r3f-component-plan`, `glb-web-handoff`, `mobile-glb-budget` | `recipe.rigged-and-animated-asset`, `recipe.blender-to-glb-handoff` |
180
+
181
+ ### Domain: `simulation-and-vfx` (2 records)
182
+
183
+ | Knowledge ID | Title | Kind | Min Blender | Doc-Checked LTS | Evidence Status | Linked Skills | Linked Recipes |
184
+ | :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
185
+ | `knowledge.rigid-body-cloth-and-simulation-cache-baking` | Rigid Body, Cloth, and Physics Simulation Cache Baking vs. Real-Time Tradeoffs | `simulation-vfx-profile` | `3.0+` | `5.2.3 LTS` | `source-reviewed` | `glb-animation-handoff`, `scene-readiness`, `glb-web-handoff` | `recipe.rigged-and-animated-asset`, `recipe.blender-to-glb-handoff` |
186
+ | `knowledge.volumetrics-fog-and-principled-volume-tradeoffs` | Volumetric Lighting, Principled Volume, and Real-Time Depth Fog Tradeoffs | `simulation-vfx-profile` | `3.0+` | `5.2.3 LTS` | `version-checked` | `lighting-material-plan`, `environment-shot`, `cycles-vs-eevee-decision`, `r3f-component-plan` | `recipe.stylized-environment-scene`, `recipe.product-hero-scene`, `recipe.presentation-lighting-and-camera` |
187
+
188
+ ### Domain: `environment-and-architecture` (2 records)
189
+
190
+ | Knowledge ID | Title | Kind | Min Blender | Doc-Checked LTS | Evidence Status | Linked Skills | Linked Recipes |
191
+ | :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
192
+ | `knowledge.modular-architectural-grid-and-metric-scale` | Modular Architectural Grid Snapping, Pivot Placement, and Real-World Metric Scale | `scene-assembly-pattern` | `3.0+` | `5.2.3 LTS` | `version-checked` | `scene-readiness`, `interior-scene`, `environment-shot`, `product-hero-scene-planner` | `recipe.stylized-environment-scene`, `recipe.product-hero-scene`, `recipe.scene-quality-inspection-and-correction` |
193
+ | `knowledge.environment-depth-layering-and-atmospheric-perspective` | Foreground / Midground / Background Depth Layering and Cyclorama Staging | `scene-assembly-pattern` | `3.0+` | `5.2.3 LTS` | `source-reviewed` | `product-hero-scene-planner`, `environment-shot`, `camera-composition`, `composition-quality-checker` | `recipe.product-hero-scene`, `recipe.stylized-environment-scene`, `recipe.presentation-lighting-and-camera` |
194
+
195
+ ### Domain: `optimization-lod-and-performance` (3 records)
196
+
197
+ | Knowledge ID | Title | Kind | Min Blender | Doc-Checked LTS | Evidence Status | Linked Skills | Linked Recipes |
198
+ | :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
199
+ | `knowledge.triangle-draw-call-and-vram-budgets` | Triangle, Draw Call, Texture VRAM, and File Size Budgets by Target Tier | `performance-budget-rule` | `3.0+` | `5.2.3 LTS` | `source-reviewed` | `polycount-budget-checker`, `mobile-glb-budget`, `material-quality-checker`, `acceptance-criteria-builder` | `recipe.web-ready-asset-optimization`, `recipe.blender-to-glb-handoff`, `recipe.scene-quality-inspection-and-correction` |
200
+ | `knowledge.lod-hierarchy-and-decimation-strategy` | Level of Detail (LOD0–LOD3) Hierarchy, Planar Dissolve, and UV-Safe Decimation | `performance-budget-rule` | `3.0+` | `5.2.3 LTS` | `source-reviewed` | `polycount-budget-checker`, `mobile-glb-budget`, `r3f-component-plan`, `scene-readiness` | `recipe.web-ready-asset-optimization`, `recipe.hard-surface-prop` |
201
+ | `knowledge.texture-resolution-ktx2-and-draco-meshopt-compression` | KTX2 / Basis Universal Texture Compression vs. Draco and Meshopt Geometry Compression | `performance-budget-rule` | `3.0+` | `5.2.3 LTS` | `version-checked` | `mobile-glb-budget`, `glb-web-handoff`, `r3f-component-plan`, `output-format-decision` | `recipe.web-ready-asset-optimization`, `recipe.blender-to-glb-handoff` |
202
+
203
+ ### Domain: `interchange-gltf-and-web` (3 records)
204
+
205
+ | Knowledge ID | Title | Kind | Min Blender | Doc-Checked LTS | Evidence Status | Linked Skills | Linked Recipes |
206
+ | :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
207
+ | `knowledge.gltf-2-coordinate-system-and-transform-conventions` | glTF 2.0 Right-Handed +Y Up Coordinate System and Blender Transform Conversion | `interchange-export-rule` | `3.0+` | `5.2.3 LTS` | `source-reviewed` | `scene-readiness`, `glb-web-handoff`, `r3f-component-plan`, `pre-handoff-verification` | `recipe.blender-to-glb-handoff`, `recipe.scene-quality-inspection-and-correction`, `recipe.product-hero-scene` |
208
+ | `knowledge.glb-binary-chunk-alignment-and-khronos-validation` | GLB Binary Container Structure, Export Flags, and Khronos Validator Compliance | `interchange-export-rule` | `3.0+` | `5.2.3 LTS` | `version-checked` | `glb-web-handoff`, `render-export-evidence`, `pre-handoff-verification`, `output-format-decision` | `recipe.blender-to-glb-handoff`, `recipe.web-ready-asset-optimization`, `recipe.product-hero-scene` |
209
+ | `knowledge.threejs-r3f-tone-mapping-and-environment-parity` | Three.js and React Three Fiber Tone Mapping, Color Management, and IBL Parity with Blender | `interchange-export-rule` | `3.0+` | `5.2.3 LTS` | `version-checked` | `r3f-component-plan`, `glb-web-handoff`, `color-management-decision`, `pre-handoff-verification` | `recipe.blender-to-glb-handoff`, `recipe.product-hero-scene`, `recipe.web-ready-asset-optimization` |
210
+
211
+ ---
212
+
213
+ ## 3. Authoritative Source Registry (`source.*`)
214
+
215
+ | Source ID | Title | Authority | Publisher | Locator / Section | Verified Date | License / Usage |
216
+ | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
217
+ | `source.blender-manual-modeling` | Blender Reference Manual — Modeling, Meshes, Normals, and Modifiers | `official-product-manual` | Blender Documentation Team (docs.blender.org) | Modeling -> Meshes (Structure, Primitives, Editing, Normals) & Modifiers (Generate/Modify/Normals) | `2026-11-04` | CC-BY-SA 4.0 (referenced for factual behavior; no prose copied) |
218
+ | `source.blender-manual-geometry-nodes` | Blender Reference Manual — Geometry Nodes, Fields, Attributes, and Instances | `official-product-manual` | Blender Documentation Team (docs.blender.org) | Modeling -> Geometry Nodes -> Fields, Attributes, Point Distribution, and Instances | `2026-11-04` | CC-BY-SA 4.0 (referenced for node evaluation semantics) |
219
+ | `source.blender-manual-uv-baking` | Blender Reference Manual — UV Unwrapping, Texture Space, and Cycles Render Baking | `official-product-manual` | Blender Documentation Team (docs.blender.org) | Modeling -> Meshes -> UVs & Render -> Cycles -> Render Baking | `2026-11-04` | CC-BY-SA 4.0 (referenced for UV and baking parameters) |
220
+ | `source.blender-manual-shading-color` | Blender Reference Manual — Shader Nodes, Principled BSDF, and Color Management (AgX / Filmic) | `official-product-manual` | Blender Documentation Team (docs.blender.org) | Render -> Shader Nodes -> Shader -> Principled BSDF & Render -> Color Management | `2026-11-04` | CC-BY-SA 4.0 (referenced for Principled BSDF v2 and AgX color transforms) |
221
+ | `source.blender-manual-lighting-rendering` | Blender Reference Manual — Cycles, EEVEE Next, Lighting, and Cameras | `official-product-manual` | Blender Documentation Team (docs.blender.org) | Render -> Cycles, EEVEE, Light Objects, and Camera Properties | `2026-11-04` | CC-BY-SA 4.0 (referenced for Cycles and EEVEE Next rendering differences) |
222
+ | `source.blender-manual-rigging-animation` | Blender Reference Manual — Armatures, Skinning, Constraints, and NLA Action Baking | `official-product-manual` | Blender Documentation Team (docs.blender.org) | Animation & Rigging -> Armatures, Skinning, Constraints, Actions, and Nonlinear Animation | `2026-11-04` | CC-BY-SA 4.0 (referenced for armature and NLA baking workflows) |
223
+ | `source.blender-manual-physics` | Blender Reference Manual — Physics, Rigid Body, Cloth, and Point Cache Baking | `official-product-manual` | Blender Documentation Team (docs.blender.org) | Physics -> Rigid Body, Cloth, and Baking Physics Simulations | `2026-11-04` | CC-BY-SA 4.0 (referenced for physics caching and collision shapes) |
224
+ | `source.blender-manual-gltf-io` | Blender Reference Manual — glTF 2.0 Import/Export Add-on Specification | `official-product-manual` | Blender Documentation Team & Khronos glTF-Blender-IO Maintainers | Add-ons -> Import-Export -> glTF 2.0 (Material Node Graph Mapping & Transform Options) | `2026-11-04` | CC-BY-SA 4.0 (referenced for glTF socket mapping and exporter options) |
225
+ | `source.khronos-gltf-2-spec` | Khronos glTF 2.0.1 Specification & GLB Binary Container Format | `official-specification` | Khronos 3D Formats Working Group (ISO/IEC 12113:2022) | Sections 3.3 (Coordinate System), 3.7 (Meshes/Skins), 4.4 (GLB Binary Format), Appendix B (Metallic-Roughness Material Model) | `2026-11-04` | CC-BY 4.0 / Khronos Specification License |
226
+ | `source.khronos-gltf-asset-auditor` | Khronos glTF Asset Auditor & 3D Commerce Asset Creation Guidelines | `official-production-pipeline` | The Khronos Group | Real-Time E-Commerce Asset Creation & Audit Rules (Triangle Count, Draw Calls, Texture Atlas, Metric Scale) | `2026-11-04` | Apache-2.0 (referenced for real-time asset budgets and validation metrics) |
227
+ | `source.khronos-ktx2-draco-meshopt` | Khronos KHR_texture_basisu, KHR_draco_mesh_compression, and EXT_meshopt_compression | `official-specification` | Khronos 3D Formats Working Group | extensions/2.0/Khronos/KHR_texture_basisu, KHR_draco_mesh_compression & Vendor/EXT_meshopt_compression | `2026-11-04` | Apache-2.0 / Khronos License |
228
+ | `source.blender-studio-pipeline` | Blender Studio Pipeline & Asset Creation Conventions | `official-production-pipeline` | Blender Studio (studio.blender.org) | Pipeline & Tools -> Asset Creation, Naming Conventions, Collection Organization, and Staging | `2026-11-04` | CC-BY 4.0 (referenced for asset naming, collection organization, and staging conventions) |
229
+ | `source.pixar-opensubdiv-topology` | Pixar OpenSubdiv Catmull-Clark Subdivision Surface Specification | `official-specification` | Pixar Animation Studios (graphics.pixar.com) | Subdivision Surfaces -> Catmull-Clark Scheme, Extraordinary Vertices, and Semi-Sharp Creases | `2026-11-04` | Modified Apache-2.0 (referenced for Catmull-Clark valence and crease rules) |
230
+ | `source.mikktspace-tangent-standard` | MikkTSpace — Tangent Space Standard for Normal Mapping (Morten S. Mikkelsen) | `peer-reviewed-research` | Morten S. Mikkelsen (Simulation Rig / Blender Developer Wiki Archive) | Tangent Space Normal Maps -> MikkTSpace Order-Independent Tangent Generation & Triangulation Rules | `2026-11-04` | Public specification (normative in Blender and glTF 2.0) |
231
+ | `source.threejs-color-and-gltf` | Three.js Documentation — Color Management, GLTFLoader, and PBR Lighting | `official-product-manual` | Three.js Project (threejs.org) | Manual -> Color Management, GLTFLoader, WebGLRenderer.toneMapping, and PMREMGenerator | `2026-11-04` | MIT License |
232
+ | `source.blender-lab-mcp-and-runtime` | Blender Lab MCP Server & Command Line Interface Documentation | `official-product-manual` | Blender Foundation (blender.org/lab) | Blender Lab MCP Add-on Manifest (blender_version_min = 5.1.0) & CLI Background Execution | `2026-11-04` | Blender Foundation official documentation |
233
+ | `source.agentskills-specification` | Agent Skills Specification & Anthropic Claude Skills Best Practices | `official-specification` | Anthropic & AgentSkills.io | SKILL.md Frontmatter Specification (name <= 64 chars, description <= 200 chars) & Progressive Disclosure | `2026-11-04` | Public specification |
234
+ | `source.3dviz-pro-max-architecture` | 3dviz-pro-max — Evidence-Aware 3D Knowledge & Recipe Catalog Architecture Reference | `reference-implementation` | viettranx (GitHub) | Knowledge Catalog, Recipe Decomposition, and Evidence-Aware Verification Architecture | `2026-11-04` | MIT License (architectural pattern reference only; no catalog records copied) |
235
+ | `source.blender-release-notes` | Blender Developer Release Notes (Blender 3.6 LTS, 4.0, 4.1, 4.2 LTS, 4.5.15 LTS, 5.1, 5.2.3 LTS) | `official-product-manual` | Blender Developer Documentation (developer.blender.org) | Release Notes -> 3.6 LTS, 4.0, 4.1, 4.2 LTS, 4.5 LTS, 5.1, and 5.2 LTS | `2026-11-04` | CC-BY-SA 4.0 (referenced for version-specific API, node, and modifier transitions) |
236
+ | `source.google-filament-pbr` | Physically Based Rendering in Filament (Romain Guy & Mathias Agopian) | `peer-reviewed-research` | Google Filament Authors | Sections 4 (Material System / Dielectric F0 / Energy Conservation) & 5 (Photometric Lighting & Camera Exposure EV100) | `2026-11-04` | Apache-2.0 (referenced for microfacet BRDF, dielectric F0, and photometric lighting math) |
@@ -0,0 +1,27 @@
1
+ # Recipes
2
+
3
+ BlendOps organizes recipes across two linked surfaces so there is never a duplicate source of truth:
4
+
5
+ 1. **Canonical Machine-Readable Recipe Registry (`registry/recipe-catalog.json`)**:
6
+ - Defines 10 reusable, multi-stage `recipe.<slug>` blueprints validated by `schemas/recipe-record.schema.json`, indexed in `registry/catalog-index.json`, and rendered in [`../knowledge-and-recipe-catalog.md`](../knowledge-and-recipe-catalog.md).
7
+ - Used by `recipe-fit-assessor`, `blender-recipe-decomposer`, `workflow-stage-router`, and `bin/blendops.mjs catalog-search --type recipe`.
8
+ 2. **Human-Readable Scenario Recipes (`docs/recipes/*.md`)**:
9
+ - Concrete, styled walkthroughs that instantiate a canonical recipe for a specific user prompt (linked via `documentation_path` on the canonical recipe record).
10
+
11
+ ## Canonical Machine-Readable Recipes (`registry/recipe-catalog.json`)
12
+
13
+ - `recipe.product-hero-scene` — Studio Product Hero Still & Web GLB Blueprint (scenario instance: [cyberpunk-shoe-hero](./cyberpunk-shoe-hero.md); pack: [`../../packs/product-hero-v0/PACK.md`](../../packs/product-hero-v0/PACK.md))
14
+ - `recipe.stylized-environment-scene` — Stylized / Architectural Environment Vista Blueprint
15
+ - `recipe.hard-surface-prop` — Non-Destructive Hard-Surface Prop Modeling Blueprint
16
+ - `recipe.procedural-geometry-nodes-asset` — Parametric Geometry Nodes Asset & Scatter Blueprint
17
+ - `recipe.uv-and-pbr-material-preparation` — UV Unwrapping, Packing & Cycles PBR Baking Blueprint
18
+ - `recipe.presentation-lighting-and-camera` — Studio Lighting, Physical Camera & Color Management Blueprint
19
+ - `recipe.rigged-and-animated-asset` — Skeletal Armature Rigging, Weight Painting & NLA Baking Blueprint
20
+ - `recipe.scene-quality-inspection-and-correction` — 7-Point Scene Quality Audit & Remediation Blueprint
21
+ - `recipe.blender-to-glb-handoff` — Blender to glTF 2.0 / GLB Export & Web Viewer Handoff Blueprint
22
+ - `recipe.web-ready-asset-optimization` — Web/Mobile LOD, KTX2 Texture & Draco/Meshopt Optimization Blueprint
23
+
24
+ ## Scenario recipe index (`docs/recipes/`)
25
+
26
+ - [cyberpunk-shoe-hero](./cyberpunk-shoe-hero.md) — Golden-path scenario instance of `recipe.product-hero-scene`
27
+
@@ -0,0 +1,97 @@
1
+ # Recipe: cyberpunk-shoe-hero
2
+
3
+ Status: 1.0.0
4
+
5
+ > [!NOTE]
6
+ > This recipe is the **step-by-step template** for an AI agent to execute the cyberpunk-shoe-hero scenario. The matching **product/workflow specification** (the "what and why") lives at [`../golden-path-cyberpunk-shoe.md`](../golden-path-cyberpunk-shoe.md). The historical text-only runtime eval lives at [`../evals/cyberpunk-shoe-hero-v0-runtime-eval.md`](../evals/cyberpunk-shoe-hero-v0-runtime-eval.md). The pack that bundles the skills used here is [`packs/product-hero-v0/PACK.md`](../../packs/product-hero-v0/PACK.md).
7
+
8
+ ## User prompt
9
+
10
+ “Create a cyberpunk shoe web hero with a floating shoe, neon lights, glossy dark floor, cinematic camera, export GLB, and give web usage guidance.”
11
+
12
+ ## Assumptions
13
+
14
+ - User is non-Blender-technical.
15
+ - Runtime setup follows official runtime options only.
16
+ - Output needs both visual quality and web handoff clarity.
17
+
18
+ ## Clarification questions
19
+
20
+ 1. Is this optimized for realtime web, marketing visuals, or both?
21
+ 2. Do you already have a source shoe model/reference?
22
+ 3. Any required brand colors or forbidden motifs?
23
+ 4. Preferred camera framing (square/wide/custom)?
24
+ 5. Any performance constraints for web delivery?
25
+
26
+ ## Scene intent
27
+
28
+ - Hero focus: floating shoe as central subject
29
+ - Mood: cyberpunk neon ambiance
30
+ - Surface context: glossy dark floor for reflection cues
31
+ - Output intent: web-ready GLB with explanation
32
+
33
+ ## Composition plan
34
+
35
+ - subject hierarchy: shoe > support elements > background
36
+ - framing: cinematic 3/4 emphasis
37
+ - negative space reserved for hero text overlays (if needed)
38
+
39
+ ## Lighting plan
40
+
41
+ - key light for silhouette readability
42
+ - neon accent/rim lighting for cyberpunk mood
43
+ - controlled reflections on glossy floor
44
+
45
+ ## Material plan
46
+
47
+ - stylized-but-readable product material definition
48
+ - reflective floor tuned for contrast, not clutter
49
+ - portability awareness for export/handoff
50
+
51
+ ## Camera plan
52
+
53
+ - hero camera angle fixed before final quality gate
54
+ - lens/framing chosen for product emphasis
55
+
56
+ ## Official runtime assumptions
57
+
58
+ - Official Blender MCP Server: https://www.blender.org/lab/mcp-server/
59
+ - Official Claude Blender Connector: https://claude.com/resources/tutorials/using-the-blender-connector-in-claude
60
+ - Official Blender CLI docs: https://docs.blender.org/manual/en/latest/advanced/command_line/index.html
61
+
62
+ Source confidence note:
63
+ - keep `verified-read` vs `linked-only` explicit at runtime setup step.
64
+
65
+ ## Validation checklist
66
+
67
+ - [ ] subject clarity
68
+ - [ ] composition coherence
69
+ - [ ] scale plausibility
70
+ - [ ] camera/framing intent
71
+ - [ ] lighting readability
72
+ - [ ] material consistency
73
+ - [ ] render/preview readiness
74
+ - [ ] export readiness
75
+ - [ ] web handoff caveat transparency
76
+
77
+ ## Artifact handoff checklist
78
+
79
+ - [ ] GLB artifact status documented
80
+ - [ ] preview artifact status documented
81
+ - [ ] assumptions/caveats documented
82
+ - [ ] next-step runtime checks documented
83
+
84
+ ## Non-Blender-user final response template
85
+
86
+ - **What you asked for:** concise restatement
87
+ - **What is ready now:** pass/warn/fail summary
88
+ - **What needs follow-up:** unresolved checks and impact
89
+ - **What to do next:** prioritized actions in plain language
90
+
91
+ ## Failure/caveat examples
92
+
93
+ Example A (partial):
94
+ - “Scene intent and quality checks are mostly ready, but web runtime compatibility is not fully verified yet. Status: Conditionally Ready.”
95
+
96
+ Example B (not ready):
97
+ - “Official runtime setup evidence is incomplete, so export-readiness cannot be confirmed. Status: Not Ready.”
@@ -0,0 +1,14 @@
1
+ # Workflows
2
+
3
+ Workflows compose laws + skills into multi-step product processes.
4
+
5
+ A workflow:
6
+ - orchestrates multiple skills
7
+ - enforces all applicable laws
8
+ - remains runtime-light
9
+ - does not own runtime execution
10
+
11
+ ## Workflow index
12
+
13
+ - [**full-non-blender-user-workflow**](./full-non-blender-user-workflow.md) — canonical full-lifecycle workflow chaining the original-16 baseline skills (Stages 1–7: Intent → Asset planning → Runtime readiness → Scene planning → Quality gate → Evidence + verification → Handoff); interleave the remaining 32 expansion skills via `workflow-stage-router`. Use when scope is broad.
14
+ - [product-hero-workflow](./product-hero-workflow.md) — narrower product-hero-specific subset. Use when the request is specifically a product hero scene.
@@ -0,0 +1,210 @@
1
+ # Workflow: full-non-blender-user-workflow
2
+
3
+ Status: 1.0.0
4
+
5
+ > [!NOTE]
6
+ > This is the **canonical full-lifecycle workflow** that chains the **original 16** BlendOps core skills for a complete non-Blender-user run. The repo now ships **48** composable skills (see [`skills/README.md`](../../skills/README.md)); use [`workflow-stage-router`](../../skills/workflow-stage-router/SKILL.md) when you need to interleave expansion skills. `product-hero-workflow.md` is the narrower product-hero-specific subset.
7
+
8
+ ## Trigger
9
+
10
+ Use this workflow when a non-Blender user requests **any 3D scene + handoff** and the scope is broad enough to span intent exploration → planning → runtime execution → evidence → handoff.
11
+
12
+ If the user already has a confirmed brief, jump in at Stage 2. If runtime is not in scope (text-only iteration), stop after Stage 5.
13
+
14
+ ## Inputs
15
+
16
+ - natural-language user prompt (any specificity)
17
+ - target deliverable hint (image / GLB / web hero / iteration / docs)
18
+ - target audience (non-Blender-technical / mixed / technical-OK)
19
+ - optional brand / mood / reference notes
20
+ - optional performance / time / scope constraints
21
+
22
+ ## Laws applied
23
+
24
+ - [`../../laws/official-runtime-only.md`](../../laws/official-runtime-only.md)
25
+ - [`../../laws/no-arbitrary-python-interface.md`](../../laws/no-arbitrary-python-interface.md)
26
+ - [`../../laws/evidence-before-done.md`](../../laws/evidence-before-done.md)
27
+ - [`../../laws/non-blender-user-language.md`](../../laws/non-blender-user-language.md)
28
+
29
+ ## Skills composed (baseline 16, canonical order)
30
+
31
+ ```txt
32
+ Stage 1 — Intent
33
+ blender-brainstorming (Socratic, when intent is vague)
34
+ intent-to-3d-brief-writer (8-slot structured brief)
35
+
36
+ Stage 2 — Asset planning
37
+ asset-discovery (per-asset strategy + license + budget)
38
+
39
+ Stage 3 — Runtime readiness
40
+ runtime-setup (path + host prerequisites)
41
+ runtime-readiness (matrix + verdict)
42
+ bridge-conflicts (only if readiness signals are inconsistent)
43
+
44
+ Stage 4 — Scene planning
45
+ product-hero-scene-planner (subject + scene structure)
46
+ camera-composition (framing + camera)
47
+ lighting-material-plan (mood + lookdev + portability)
48
+
49
+ Stage 5 — Quality gate
50
+ scene-readiness (Pass / Warn / Fail readiness verdict)
51
+ blender-troubleshooting (only if output diverges from intent)
52
+
53
+ Stage 6 — Evidence + verification
54
+ render-export-evidence (classify each artifact's truth label)
55
+ pre-handoff-verification (7-point gate before any "ready" claim)
56
+
57
+ Stage 7 — Handoff + final response
58
+ glb-web-handoff (web/GLB framing if in scope)
59
+ plain-language-response (plain-language final response)
60
+
61
+ Routing utility (always available)
62
+ blendops-help (load when next safe action is unclear)
63
+ ```
64
+
65
+ ## Stages
66
+
67
+ > [!NOTE]
68
+ > These are workflow stages (per-run pipeline steps). Project roadmap and release checks live in [`TODO.md`](../../TODO.md).
69
+
70
+ ### Stage 1 — Intent
71
+
72
+ Goal: confirmed user intent + 8-slot structured brief.
73
+
74
+ - If user request is vague: load `blender-brainstorming` first. Ask 3-5 batched clarifying questions, propose 2-3 alternative scopings, end with one-paragraph confirmed intent summary.
75
+ - Once intent is confirmed: load `intent-to-3d-brief-writer`. Fill the 8 slots (Subject, Mood, Deliverables, Constraints, Evidence expectations, Acceptance criteria, Audience, Owner). Echo to user. Confirm before proceeding.
76
+
77
+ Exit gate: brief locked. Runtime status `Not Run`. Artifact status `Not Produced`.
78
+
79
+ ### Stage 2 — Asset planning
80
+
81
+ Goal: per-asset acquisition strategy with license + confidence + budget reconciliation.
82
+
83
+ - Load `asset-discovery`. Walk the 5-step decision tree (brand-restricted? specific? tight budget? iteration? mood-specific?).
84
+ - Per asset class, record strategy (procedural / library / generative / photogrammetry) + source candidate + license + confidence label + risk.
85
+ - Sum poly / GLB-size budget vs Slot 4 of the brief. Surface conflicts.
86
+ - If generative is chosen: flag with Path 2 caveat; route through Stage 3 readiness check before runtime.
87
+
88
+ Exit gate: asset plan reconciled with brief. Runtime status unchanged.
89
+
90
+ ### Stage 3 — Runtime readiness
91
+
92
+ Goal: ONE selected runtime path that's actually ready, OR explicit "stay text-only" decision.
93
+
94
+ - Load `runtime-setup` to choose Path 1 host (a or b), Path 2, or CLI fallback per client + Blender version + brief preferences.
95
+ - Load `runtime-readiness` to build the readiness matrix (Blender version, MCP host product, Blender-side add-on, MCP server source, output path readiness, single-bridge constraint).
96
+ - If readiness signals are inconsistent (e.g. tool surface doesn't match labeled path, two MCP clients targeting same Blender, port `9876` collision): load `bridge-conflicts`. Build the bridge state matrix. Propose the cheapest resolution. Operator executes. Re-run readiness checker.
97
+
98
+ Exit gate: readiness verdict `Ready` or `Partially Ready` (with documented caveats), OR explicit "stay text-only — runtime out of scope for this run".
99
+
100
+ ### Stage 4 — Scene planning
101
+
102
+ Goal: structured scene plan ready for runtime mutation.
103
+
104
+ - Load `product-hero-scene-planner` (subject, scene scope, hero placement, support elements).
105
+ - Load `camera-composition` (framing, focal length, negative space, hero centering).
106
+ - Load `lighting-material-plan` (mood lookdev, light placement, material portability per deliverable target).
107
+
108
+ Exit gate: plans reviewable in plain language; no jargon leak. Runtime status still `Not Run`.
109
+
110
+ ### Stage 5 — Quality gate
111
+
112
+ Goal: Pass / Warn / Fail readiness verdict before any runtime mutation.
113
+
114
+ - Load `scene-readiness`. Score the plan against the rubric.
115
+ - If verdict is Pass: proceed to Stage 6.
116
+ - If verdict is Warn: record explicit caveats; user decides whether to proceed.
117
+ - If verdict is Fail: route back to the relevant Stage 4 planner.
118
+ - If post-runtime output diverges from intent (loop-back from Stage 6): load `blender-troubleshooting` for 4-phase root-cause; then route the proposed fix to the correct upstream stage.
119
+
120
+ Exit gate: explicit Pass or Warn-with-caveats. Runtime status still `Not Run`.
121
+
122
+ ### Stage 6 — Evidence + verification
123
+
124
+ Goal: honest evidence record per artifact + 7-point pre-handoff gate before "ready" claim.
125
+
126
+ - Load `render-export-evidence`. For each artifact item (preview / render / GLB / blend), walk the truth-label decision tree (`Not Run` → `Attempted` → `Produced` → `Verified` / `Failed`). Save evidence file under `docs/evals/path-X-...md` using the templates in `skills/render-export-evidence/references/evidence-record-templates.md`.
127
+ - Load `pre-handoff-verification`. Run all 7 checks (claim named, path attribution, artifact paths exist, validation notes, tool names, no-mutation guarantee for read-only smoke, plain language). Confirm or downgrade the claim. Never upgrade.
128
+
129
+ Exit gate: evidence file exists + 7-point gate verdict (Pass / Warn / Fail) recorded. Truth label finalized.
130
+
131
+ ### Stage 7 — Handoff + final response
132
+
133
+ Goal: plain-language response to non-Blender stakeholders.
134
+
135
+ - If GLB / web is in scope: load `glb-web-handoff`. Add R3F / Three.js snippets, performance caveats, artifact-status language per the bundled references.
136
+ - Always: load `plain-language-response`. Produce final user-facing response. Cite truth labels (`Not Run` / `Verified` etc.) explicitly. No Blender jargon without inline explanation.
137
+
138
+ Exit gate: response confirmed plain-language by check 7 of `pre-handoff-verification` (which already ran in Stage 6).
139
+
140
+ ## Outputs
141
+
142
+ | Output | Source stage |
143
+ |---|---|
144
+ | confirmed intent paragraph | Stage 1 |
145
+ | 8-slot 3D brief | Stage 1 |
146
+ | per-asset acquisition plan | Stage 2 |
147
+ | runtime readiness matrix | Stage 3 |
148
+ | (optional) bridge state matrix + resolution | Stage 3 |
149
+ | structured scene plan | Stage 4 |
150
+ | composition + lighting + material plans | Stage 4 |
151
+ | quality gate verdict | Stage 5 |
152
+ | (optional) 4-phase troubleshooting record | Stage 5 |
153
+ | per-artifact evidence file under `docs/evals/path-X-...md` | Stage 6 |
154
+ | 7-point pre-handoff verification verdict | Stage 6 |
155
+ | (if GLB / web) handoff caveats + snippets | Stage 7 |
156
+ | plain-language final response | Stage 7 |
157
+
158
+ ## Validation gates
159
+
160
+ - Gate A: brief echoed and confirmed (Stage 1)
161
+ - Gate B: asset budget reconciled (Stage 2)
162
+ - Gate C: runtime path selected and ready, OR explicit text-only decision (Stage 3)
163
+ - Gate D: scene + composition + lighting plans reviewable (Stage 4)
164
+ - Gate E: quality gate Pass or Warn-with-caveats (Stage 5)
165
+ - Gate F: evidence file + pre-handoff verification verdict recorded (Stage 6)
166
+ - Gate G: final response passes plain-language check 7 (Stage 7)
167
+
168
+ ## Failure modes
169
+
170
+ - intent ambiguity unresolved → loop back to Stage 1
171
+ - license unknown / TBD on a hero asset → loop back to Stage 2 + brief slot 4
172
+ - runtime path unavailable / blocked → either choose different path in Stage 3 or stay text-only
173
+ - quality gate Fail → loop back to relevant Stage 4 planner
174
+ - runtime output diverges from intent → load `blender-troubleshooting`; route fix upstream per `divergence-routing-table.md`
175
+ - pre-handoff verification Fail (3+ checks) → route to `blender-troubleshooting`; do not let the deliverable through
176
+
177
+ ## Runtime evidence expectations
178
+
179
+ Every run that reaches Stage 6 must capture:
180
+
181
+ - selected path + host option (Path 1 host a, Path 1 host b, Path 2, CLI fallback, or text-only)
182
+ - `blender --version` verbatim
183
+ - Blender-side add-on identity (Lab MCP add-on version OR `mcp-for-blender` `addon.py` commit)
184
+ - MCP server source (`.mcpb` filename / source commit / `uvx mcp-for-blender` version)
185
+ - MCP host product + version
186
+ - exact tool names called + responses
187
+ - single-bridge constraint check
188
+ - no-mutation guarantee (for read-only smoke claims)
189
+
190
+ ## Final response format
191
+
192
+ 1. What you asked for (one-paragraph restatement)
193
+ 2. What is ready now (per-artifact truth label)
194
+ 3. What is not fully verified yet (per-artifact downgrades + reasons)
195
+ 4. Recommended next action (next-skill or operator action named)
196
+
197
+ ## Relationship to other workflows
198
+
199
+ - [`product-hero-workflow.md`](./product-hero-workflow.md) is a narrower product-hero-specific subset. Use it when the request is specifically a product hero scene; use this full workflow when the request is broader.
200
+ - Recipes under `docs/recipes/` are scenario-specific instantiations of this workflow.
201
+
202
+ ## Skipping stages
203
+
204
+ | Scenario | Skip |
205
+ |---|---|
206
+ | User provides a complete structured brief | Stage 1 brainstorming (jump to brief writer) |
207
+ | User supplies all assets | Stage 2 |
208
+ | Runtime not in scope | Stage 3, 6 (mutation/render/export); stop after Stage 5 |
209
+ | Iteration on existing scene | Stages 1, 2 (jump to relevant planner or troubleshooting) |
210
+ | Read-only smoke run only | Stop after Stage 3 with smoke evidence record |