blendops 0.0.0-stage → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (484) hide show
  1. package/CHANGELOG.md +62 -0
  2. package/LICENSE +21 -0
  3. package/README.md +189 -2
  4. package/bin/blendops.mjs +4 -0
  5. package/bundles/claude-desktop-manual/BLENDOPS_SINGLE_FILE.md +78 -0
  6. package/bundles/claude-desktop-manual/IMPORT_STEPS.md +43 -0
  7. package/bundles/claude-desktop-manual/INSTALL_REPORT_TEMPLATE.md +13 -0
  8. package/bundles/claude-desktop-manual/README.md +70 -0
  9. package/bundles/claude-desktop-manual/SKILL.md +62 -0
  10. package/bundles/claude-desktop-manual/manifest.json +278 -0
  11. package/bundles/claude-desktop-manual/references/evidence-rules.md +13 -0
  12. package/bundles/claude-desktop-manual/references/install-boundary.md +13 -0
  13. package/bundles/claude-desktop-manual/references/laws/evidence-before-done.md +14 -0
  14. package/bundles/claude-desktop-manual/references/laws/no-arbitrary-python-interface.md +12 -0
  15. package/bundles/claude-desktop-manual/references/laws/non-blender-user-language.md +13 -0
  16. package/bundles/claude-desktop-manual/references/laws/official-runtime-only.md +20 -0
  17. package/bundles/claude-desktop-manual/references/packs/product-hero-v0.md +30 -0
  18. package/bundles/claude-desktop-manual/references/runtime-stacks.md +13 -0
  19. package/bundles/claude-desktop-manual/references/skill-map.md +36 -0
  20. package/bundles/claude-desktop-manual/references/skills/acceptance-criteria-builder.md +69 -0
  21. package/bundles/claude-desktop-manual/references/skills/asset-discovery.md +73 -0
  22. package/bundles/claude-desktop-manual/references/skills/asset-fallback-strategy.md +66 -0
  23. package/bundles/claude-desktop-manual/references/skills/asset-library-plan.md +69 -0
  24. package/bundles/claude-desktop-manual/references/skills/asset-license-checker.md +69 -0
  25. package/bundles/claude-desktop-manual/references/skills/asset-style-check.md +69 -0
  26. package/bundles/claude-desktop-manual/references/skills/blender-brainstorming.md +62 -0
  27. package/bundles/claude-desktop-manual/references/skills/blender-recipe-decomposer.md +66 -0
  28. package/bundles/claude-desktop-manual/references/skills/blender-troubleshooting.md +78 -0
  29. package/bundles/claude-desktop-manual/references/skills/blendops-help.md +82 -0
  30. package/bundles/claude-desktop-manual/references/skills/bridge-conflicts.md +68 -0
  31. package/bundles/claude-desktop-manual/references/skills/camera-composition.md +65 -0
  32. package/bundles/claude-desktop-manual/references/skills/character-portrait.md +68 -0
  33. package/bundles/claude-desktop-manual/references/skills/cli-appendix-job-outline.md +62 -0
  34. package/bundles/claude-desktop-manual/references/skills/color-management-decision.md +68 -0
  35. package/bundles/claude-desktop-manual/references/skills/composition-quality-checker.md +71 -0
  36. package/bundles/claude-desktop-manual/references/skills/cycles-vs-eevee-decision.md +65 -0
  37. package/bundles/claude-desktop-manual/references/skills/done-criteria.md +70 -0
  38. package/bundles/claude-desktop-manual/references/skills/environment-shot.md +65 -0
  39. package/bundles/claude-desktop-manual/references/skills/glb-animation-handoff.md +69 -0
  40. package/bundles/claude-desktop-manual/references/skills/glb-web-handoff.md +68 -0
  41. package/bundles/claude-desktop-manual/references/skills/intent-to-3d-brief-writer.md +68 -0
  42. package/bundles/claude-desktop-manual/references/skills/interior-scene.md +73 -0
  43. package/bundles/claude-desktop-manual/references/skills/lighting-material-plan.md +65 -0
  44. package/bundles/claude-desktop-manual/references/skills/lighting-quality-checker.md +70 -0
  45. package/bundles/claude-desktop-manual/references/skills/material-quality-checker.md +71 -0
  46. package/bundles/claude-desktop-manual/references/skills/mobile-glb-budget.md +73 -0
  47. package/bundles/claude-desktop-manual/references/skills/output-format-decision.md +63 -0
  48. package/bundles/claude-desktop-manual/references/skills/pack-prerequisite-checker.md +74 -0
  49. package/bundles/claude-desktop-manual/references/skills/path-one-host-outline.md +66 -0
  50. package/bundles/claude-desktop-manual/references/skills/plain-language-response.md +70 -0
  51. package/bundles/claude-desktop-manual/references/skills/polycount-budget-checker.md +71 -0
  52. package/bundles/claude-desktop-manual/references/skills/pre-handoff-verification.md +76 -0
  53. package/bundles/claude-desktop-manual/references/skills/preview-report.md +62 -0
  54. package/bundles/claude-desktop-manual/references/skills/product-grid-scene-planner.md +72 -0
  55. package/bundles/claude-desktop-manual/references/skills/product-hero-scene-planner.md +68 -0
  56. package/bundles/claude-desktop-manual/references/skills/r3f-component-plan.md +66 -0
  57. package/bundles/claude-desktop-manual/references/skills/recipe-fit-assessor.md +75 -0
  58. package/bundles/claude-desktop-manual/references/skills/render-export-evidence.md +70 -0
  59. package/bundles/claude-desktop-manual/references/skills/resolution-aspect-decision.md +65 -0
  60. package/bundles/claude-desktop-manual/references/skills/runtime-attempt-report.md +67 -0
  61. package/bundles/claude-desktop-manual/references/skills/runtime-path-picker.md +67 -0
  62. package/bundles/claude-desktop-manual/references/skills/runtime-readiness.md +63 -0
  63. package/bundles/claude-desktop-manual/references/skills/runtime-setup.md +63 -0
  64. package/bundles/claude-desktop-manual/references/skills/scene-readiness.md +65 -0
  65. package/bundles/claude-desktop-manual/references/skills/scope-guard.md +62 -0
  66. package/bundles/claude-desktop-manual/references/skills/stage-gates.md +91 -0
  67. package/bundles/claude-desktop-manual/references/skills/workflow-stage-router.md +67 -0
  68. package/bundles/generic-project-local/BLENDOPS.md +71 -0
  69. package/bundles/generic-project-local/INSTALL_REPORT_TEMPLATE.md +52 -0
  70. package/bundles/generic-project-local/README.md +72 -0
  71. package/bundles/generic-project-local/ROLLBACK.md +66 -0
  72. package/bundles/generic-project-local/manifest.json +66 -0
  73. package/bundles/skill-package/README.md +54 -0
  74. package/bundles/skill-package/blendops/LICENSE.txt +21 -0
  75. package/bundles/skill-package/blendops/SKILL.md +50 -0
  76. package/bundles/skill-package/blendops/agents/README.md +61 -0
  77. package/bundles/skill-package/blendops/agents/openai.yaml +4 -0
  78. package/bundles/skill-package/blendops/references/evidence-rules.md +17 -0
  79. package/bundles/skill-package/blendops/references/install-boundary.md +13 -0
  80. package/bundles/skill-package/blendops/references/law-evidence-before-done.md +12 -0
  81. package/bundles/skill-package/blendops/references/law-no-arbitrary-python-interface.md +7 -0
  82. package/bundles/skill-package/blendops/references/law-non-blender-user-language.md +8 -0
  83. package/bundles/skill-package/blendops/references/law-official-runtime-only.md +9 -0
  84. package/bundles/skill-package/blendops/references/pack-product-hero-v0.md +21 -0
  85. package/bundles/skill-package/blendops/references/runtime-stacks.md +13 -0
  86. package/bundles/skill-package/blendops/references/skill-acceptance-criteria-builder.md +51 -0
  87. package/bundles/skill-package/blendops/references/skill-asset-discovery.md +54 -0
  88. package/bundles/skill-package/blendops/references/skill-asset-fallback-strategy.md +48 -0
  89. package/bundles/skill-package/blendops/references/skill-asset-library-plan.md +51 -0
  90. package/bundles/skill-package/blendops/references/skill-asset-license-checker.md +51 -0
  91. package/bundles/skill-package/blendops/references/skill-asset-style-check.md +52 -0
  92. package/bundles/skill-package/blendops/references/skill-blender-brainstorming.md +43 -0
  93. package/bundles/skill-package/blendops/references/skill-blender-recipe-decomposer.md +48 -0
  94. package/bundles/skill-package/blendops/references/skill-blender-troubleshooting.md +59 -0
  95. package/bundles/skill-package/blendops/references/skill-blendops-help.md +62 -0
  96. package/bundles/skill-package/blendops/references/skill-bridge-conflicts.md +48 -0
  97. package/bundles/skill-package/blendops/references/skill-camera-composition.md +48 -0
  98. package/bundles/skill-package/blendops/references/skill-character-portrait.md +50 -0
  99. package/bundles/skill-package/blendops/references/skill-cli-appendix-job-outline.md +44 -0
  100. package/bundles/skill-package/blendops/references/skill-color-management-decision.md +50 -0
  101. package/bundles/skill-package/blendops/references/skill-composition-quality-checker.md +53 -0
  102. package/bundles/skill-package/blendops/references/skill-cycles-vs-eevee-decision.md +47 -0
  103. package/bundles/skill-package/blendops/references/skill-done-criteria.md +53 -0
  104. package/bundles/skill-package/blendops/references/skill-environment-shot.md +47 -0
  105. package/bundles/skill-package/blendops/references/skill-glb-animation-handoff.md +51 -0
  106. package/bundles/skill-package/blendops/references/skill-glb-web-handoff.md +51 -0
  107. package/bundles/skill-package/blendops/references/skill-intent-to-3d-brief-writer.md +50 -0
  108. package/bundles/skill-package/blendops/references/skill-interior-scene.md +54 -0
  109. package/bundles/skill-package/blendops/references/skill-lighting-material-plan.md +48 -0
  110. package/bundles/skill-package/blendops/references/skill-lighting-quality-checker.md +52 -0
  111. package/bundles/skill-package/blendops/references/skill-map.md +32 -0
  112. package/bundles/skill-package/blendops/references/skill-material-quality-checker.md +53 -0
  113. package/bundles/skill-package/blendops/references/skill-mobile-glb-budget.md +55 -0
  114. package/bundles/skill-package/blendops/references/skill-output-format-decision.md +46 -0
  115. package/bundles/skill-package/blendops/references/skill-pack-prerequisite-checker.md +56 -0
  116. package/bundles/skill-package/blendops/references/skill-path-one-host-outline.md +48 -0
  117. package/bundles/skill-package/blendops/references/skill-plain-language-response.md +53 -0
  118. package/bundles/skill-package/blendops/references/skill-polycount-budget-checker.md +53 -0
  119. package/bundles/skill-package/blendops/references/skill-pre-handoff-verification.md +57 -0
  120. package/bundles/skill-package/blendops/references/skill-preview-report.md +45 -0
  121. package/bundles/skill-package/blendops/references/skill-product-grid-scene-planner.md +54 -0
  122. package/bundles/skill-package/blendops/references/skill-product-hero-scene-planner.md +51 -0
  123. package/bundles/skill-package/blendops/references/skill-r3f-component-plan.md +48 -0
  124. package/bundles/skill-package/blendops/references/skill-recipe-fit-assessor.md +57 -0
  125. package/bundles/skill-package/blendops/references/skill-render-export-evidence.md +51 -0
  126. package/bundles/skill-package/blendops/references/skill-resolution-aspect-decision.md +48 -0
  127. package/bundles/skill-package/blendops/references/skill-runtime-attempt-report.md +49 -0
  128. package/bundles/skill-package/blendops/references/skill-runtime-path-picker.md +49 -0
  129. package/bundles/skill-package/blendops/references/skill-runtime-readiness.md +45 -0
  130. package/bundles/skill-package/blendops/references/skill-runtime-setup.md +45 -0
  131. package/bundles/skill-package/blendops/references/skill-scene-readiness.md +48 -0
  132. package/bundles/skill-package/blendops/references/skill-scope-guard.md +44 -0
  133. package/bundles/skill-package/blendops/references/skill-stage-gates.md +73 -0
  134. package/bundles/skill-package/blendops/references/skill-workflow-stage-router.md +49 -0
  135. package/docs/examples/glb-web-handoff/README.md +174 -0
  136. package/docs/examples/glb-web-handoff/r3f-glb-viewer.tsx +320 -0
  137. package/docs/examples/glb-web-handoff/threejs-glb-viewer.mjs +709 -0
  138. package/docs/knowledge-and-recipe-catalog.md +236 -0
  139. package/docs/recipes/README.md +27 -0
  140. package/docs/recipes/cyberpunk-shoe-hero.md +97 -0
  141. package/docs/workflows/README.md +14 -0
  142. package/docs/workflows/full-non-blender-user-workflow.md +210 -0
  143. package/docs/workflows/product-hero-workflow.md +92 -0
  144. package/laws/README.md +32 -0
  145. package/laws/evidence-before-done.md +37 -0
  146. package/laws/no-arbitrary-python-interface.md +32 -0
  147. package/laws/non-blender-user-language.md +32 -0
  148. package/laws/official-runtime-only.md +78 -0
  149. package/package.json +99 -4
  150. package/packs/README.md +11 -0
  151. package/packs/product-hero-v0/PACK.md +114 -0
  152. package/registry/catalog-index.json +21344 -0
  153. package/registry/compatibility-matrix.json +533 -0
  154. package/registry/contract-context-fields.json +391 -0
  155. package/registry/knowledge-catalog.json +4648 -0
  156. package/registry/knowledge-sources.json +438 -0
  157. package/registry/recipe-catalog.json +2565 -0
  158. package/registry/runtime-capability-policy.json +525 -0
  159. package/registry/runtime-operations.json +4468 -0
  160. package/registry/skills.json +10231 -0
  161. package/registry/workflow-graph.json +7390 -0
  162. package/schemas/adapter-compatibility-matrix.schema.json +166 -0
  163. package/schemas/contract-context-fields.schema.json +147 -0
  164. package/schemas/execution-plan.schema.json +325 -0
  165. package/schemas/glb-web-handoff-manifest.schema.json +744 -0
  166. package/schemas/knowledge-record.schema.json +460 -0
  167. package/schemas/knowledge-source-registry.schema.json +268 -0
  168. package/schemas/operation-execution-ledger.schema.json +348 -0
  169. package/schemas/recipe-record.schema.json +469 -0
  170. package/schemas/runtime-capability-policy.schema.json +184 -0
  171. package/schemas/runtime-evidence-packet.schema.json +211 -0
  172. package/schemas/runtime-operations.schema.json +535 -0
  173. package/schemas/runtime-qualification-report.schema.json +540 -0
  174. package/schemas/runtime-session.schema.json +350 -0
  175. package/schemas/scene-spec.schema.json +624 -0
  176. package/schemas/skill-contract.schema.json +402 -0
  177. package/schemas/skill-eval.schema.json +509 -0
  178. package/scripts/build-knowledge-catalog.mjs +2376 -0
  179. package/scripts/compile-scene-plan.mjs +1945 -0
  180. package/scripts/export-claude-skills.mjs +634 -0
  181. package/scripts/generate-glb-handoff-report.mjs +2376 -0
  182. package/scripts/inspect-glb.mjs +1627 -0
  183. package/scripts/install-skills.mjs +5369 -0
  184. package/scripts/runtime-orchestrator.mjs +7652 -0
  185. package/scripts/validate-capability-policy.mjs +531 -0
  186. package/scripts/validate-evidence-packet.mjs +256 -0
  187. package/skills/README.md +315 -0
  188. package/skills/_template/SKILL.md +296 -0
  189. package/skills/acceptance-criteria-builder/EVAL.md +25 -0
  190. package/skills/acceptance-criteria-builder/SKILL.md +257 -0
  191. package/skills/acceptance-criteria-builder/contract.json +205 -0
  192. package/skills/acceptance-criteria-builder/references/brief-to-criteria-mapper.md +22 -0
  193. package/skills/acceptance-criteria-builder/references/checklist-patterns.md +22 -0
  194. package/skills/acceptance-criteria-builder/references/evidence-hook-rules.md +19 -0
  195. package/skills/asset-discovery/EVAL.md +81 -0
  196. package/skills/asset-discovery/SKILL.md +252 -0
  197. package/skills/asset-discovery/contract.json +291 -0
  198. package/skills/asset-discovery/references/asset-strategy-decision-tree.md +40 -0
  199. package/skills/asset-discovery/references/budget-reconciliation-patterns.md +54 -0
  200. package/skills/asset-discovery/references/license-confidence-table.md +41 -0
  201. package/skills/asset-fallback-strategy/EVAL.md +34 -0
  202. package/skills/asset-fallback-strategy/SKILL.md +248 -0
  203. package/skills/asset-fallback-strategy/contract.json +190 -0
  204. package/skills/asset-fallback-strategy/references/drop-with-caveat-rules.md +36 -0
  205. package/skills/asset-fallback-strategy/references/fallback-option-types.md +55 -0
  206. package/skills/asset-fallback-strategy/references/scoring-rubric.md +61 -0
  207. package/skills/asset-library-plan/EVAL.md +28 -0
  208. package/skills/asset-library-plan/SKILL.md +263 -0
  209. package/skills/asset-library-plan/contract.json +177 -0
  210. package/skills/asset-library-plan/references/folder-structure-rules.md +63 -0
  211. package/skills/asset-library-plan/references/metadata-schema.md +62 -0
  212. package/skills/asset-library-plan/references/naming-rules.md +51 -0
  213. package/skills/asset-license-checker/EVAL.md +33 -0
  214. package/skills/asset-license-checker/SKILL.md +245 -0
  215. package/skills/asset-license-checker/contract.json +172 -0
  216. package/skills/asset-license-checker/references/attribution-rendering-patterns.md +48 -0
  217. package/skills/asset-license-checker/references/common-license-mapping.md +39 -0
  218. package/skills/asset-license-checker/references/license-source-rules.md +38 -0
  219. package/skills/asset-style-check/EVAL.md +26 -0
  220. package/skills/asset-style-check/SKILL.md +238 -0
  221. package/skills/asset-style-check/contract.json +251 -0
  222. package/skills/asset-style-check/references/drift-classification.md +40 -0
  223. package/skills/asset-style-check/references/intentional-mixed-style.md +39 -0
  224. package/skills/asset-style-check/references/style-axes.md +46 -0
  225. package/skills/blender-brainstorming/EVAL.md +79 -0
  226. package/skills/blender-brainstorming/SKILL.md +228 -0
  227. package/skills/blender-brainstorming/contract.json +115 -0
  228. package/skills/blender-brainstorming/references/alternative-scoping-templates.md +43 -0
  229. package/skills/blender-brainstorming/references/clarification-patterns.md +29 -0
  230. package/skills/blender-brainstorming/references/intent-summary-style-guide.md +25 -0
  231. package/skills/blender-recipe-decomposer/EVAL.md +35 -0
  232. package/skills/blender-recipe-decomposer/SKILL.md +258 -0
  233. package/skills/blender-recipe-decomposer/contract.json +152 -0
  234. package/skills/blender-recipe-decomposer/references/dependency-patterns.md +53 -0
  235. package/skills/blender-recipe-decomposer/references/recipe-grouping-rules.md +58 -0
  236. package/skills/blender-recipe-decomposer/references/recipe-naming-rules.md +44 -0
  237. package/skills/blender-troubleshooting/EVAL.md +78 -0
  238. package/skills/blender-troubleshooting/SKILL.md +263 -0
  239. package/skills/blender-troubleshooting/contract.json +352 -0
  240. package/skills/blender-troubleshooting/references/common-symptom-playbooks.md +51 -0
  241. package/skills/blender-troubleshooting/references/divergence-routing-table.md +23 -0
  242. package/skills/blender-troubleshooting/references/four-phase-template.md +51 -0
  243. package/skills/blendops-help/EVAL.md +67 -0
  244. package/skills/blendops-help/SKILL.md +312 -0
  245. package/skills/blendops-help/contract.json +229 -0
  246. package/skills/blendops-help/references/lifecycle-phases.md +91 -0
  247. package/skills/blendops-help/references/quick-start-prompts.md +65 -0
  248. package/skills/blendops-help/references/routing-decision-tree.md +57 -0
  249. package/skills/bridge-conflicts/EVAL.md +83 -0
  250. package/skills/bridge-conflicts/SKILL.md +246 -0
  251. package/skills/bridge-conflicts/contract.json +145 -0
  252. package/skills/bridge-conflicts/references/bridge-state-matrix-template.md +82 -0
  253. package/skills/bridge-conflicts/references/conflict-playbooks.md +99 -0
  254. package/skills/bridge-conflicts/references/do-not-reminders.md +42 -0
  255. package/skills/camera-composition/EVAL.md +32 -0
  256. package/skills/camera-composition/SKILL.md +196 -0
  257. package/skills/camera-composition/contract.json +180 -0
  258. package/skills/camera-composition/references/camera-presets.md +30 -0
  259. package/skills/camera-composition/references/camera-rubric.md +24 -0
  260. package/skills/camera-composition/references/hero-composition-patterns.md +24 -0
  261. package/skills/camera-composition/references/web-layout-negative-space.md +25 -0
  262. package/skills/character-portrait/EVAL.md +42 -0
  263. package/skills/character-portrait/SKILL.md +245 -0
  264. package/skills/character-portrait/contract.json +205 -0
  265. package/skills/character-portrait/references/portrait-framing-rules.md +39 -0
  266. package/skills/character-portrait/references/portrait-lighting-patterns.md +50 -0
  267. package/skills/character-portrait/references/style-consistency-rules.md +41 -0
  268. package/skills/cli-appendix-job-outline/EVAL.md +26 -0
  269. package/skills/cli-appendix-job-outline/SKILL.md +252 -0
  270. package/skills/cli-appendix-job-outline/contract.json +147 -0
  271. package/skills/cli-appendix-job-outline/references/flag-order-reminders.md +16 -0
  272. package/skills/cli-appendix-job-outline/references/job-type-matrix.md +13 -0
  273. package/skills/cli-appendix-job-outline/references/stateless-limitations.md +12 -0
  274. package/skills/color-management-decision/EVAL.md +28 -0
  275. package/skills/color-management-decision/SKILL.md +254 -0
  276. package/skills/color-management-decision/contract.json +162 -0
  277. package/skills/color-management-decision/references/look-comparison.md +44 -0
  278. package/skills/color-management-decision/references/per-channel-rules.md +49 -0
  279. package/skills/color-management-decision/references/pipeline-mapping.md +47 -0
  280. package/skills/composition-quality-checker/EVAL.md +38 -0
  281. package/skills/composition-quality-checker/SKILL.md +260 -0
  282. package/skills/composition-quality-checker/contract.json +221 -0
  283. package/skills/composition-quality-checker/references/aspect-ratio-rules.md +37 -0
  284. package/skills/composition-quality-checker/references/composition-rules.md +58 -0
  285. package/skills/composition-quality-checker/references/headroom-leadroom-rules.md +46 -0
  286. package/skills/cycles-vs-eevee-decision/EVAL.md +26 -0
  287. package/skills/cycles-vs-eevee-decision/SKILL.md +249 -0
  288. package/skills/cycles-vs-eevee-decision/contract.json +142 -0
  289. package/skills/cycles-vs-eevee-decision/references/engine-feature-matrix.md +39 -0
  290. package/skills/cycles-vs-eevee-decision/references/gpu-device-rules.md +51 -0
  291. package/skills/cycles-vs-eevee-decision/references/samples-by-quality.md +53 -0
  292. package/skills/done-criteria/EVAL.md +33 -0
  293. package/skills/done-criteria/SKILL.md +225 -0
  294. package/skills/done-criteria/contract.json +199 -0
  295. package/skills/done-criteria/references/done-vs-perfect.md +56 -0
  296. package/skills/done-criteria/references/out-of-scope-patterns.md +50 -0
  297. package/skills/done-criteria/references/stop-condition-templates.md +39 -0
  298. package/skills/environment-shot/EVAL.md +44 -0
  299. package/skills/environment-shot/SKILL.md +237 -0
  300. package/skills/environment-shot/contract.json +162 -0
  301. package/skills/environment-shot/references/depth-layering-rules.md +49 -0
  302. package/skills/environment-shot/references/time-and-weather-rules.md +35 -0
  303. package/skills/environment-shot/references/wide-shot-camera-rules.md +51 -0
  304. package/skills/glb-animation-handoff/EVAL.md +39 -0
  305. package/skills/glb-animation-handoff/SKILL.md +271 -0
  306. package/skills/glb-animation-handoff/contract.json +247 -0
  307. package/skills/glb-animation-handoff/references/animation-types.md +36 -0
  308. package/skills/glb-animation-handoff/references/transition-rules.md +55 -0
  309. package/skills/glb-animation-handoff/references/web-stack-caveats.md +40 -0
  310. package/skills/glb-web-handoff/EVAL.md +33 -0
  311. package/skills/glb-web-handoff/SKILL.md +212 -0
  312. package/skills/glb-web-handoff/contract.json +171 -0
  313. package/skills/glb-web-handoff/references/artifact-status-language.md +26 -0
  314. package/skills/glb-web-handoff/references/glb-handoff-checklist.md +30 -0
  315. package/skills/glb-web-handoff/references/performance-caveats.md +26 -0
  316. package/skills/glb-web-handoff/references/threejs-r3f-handoff.md +28 -0
  317. package/skills/intent-to-3d-brief-writer/EVAL.md +82 -0
  318. package/skills/intent-to-3d-brief-writer/SKILL.md +238 -0
  319. package/skills/intent-to-3d-brief-writer/contract.json +195 -0
  320. package/skills/intent-to-3d-brief-writer/references/acceptance-criteria-patterns.md +46 -0
  321. package/skills/intent-to-3d-brief-writer/references/eight-slot-template.md +123 -0
  322. package/skills/intent-to-3d-brief-writer/references/mixed-audience-handling.md +39 -0
  323. package/skills/interior-scene/EVAL.md +44 -0
  324. package/skills/interior-scene/SKILL.md +261 -0
  325. package/skills/interior-scene/contract.json +277 -0
  326. package/skills/interior-scene/references/furniture-layout-rules.md +51 -0
  327. package/skills/interior-scene/references/interior-architecture-rules.md +47 -0
  328. package/skills/interior-scene/references/interior-camera-rules.md +47 -0
  329. package/skills/lighting-material-plan/EVAL.md +32 -0
  330. package/skills/lighting-material-plan/SKILL.md +194 -0
  331. package/skills/lighting-material-plan/contract.json +213 -0
  332. package/skills/lighting-material-plan/references/cyberpunk-lookdev.md +22 -0
  333. package/skills/lighting-material-plan/references/lighting-patterns.md +30 -0
  334. package/skills/lighting-material-plan/references/material-portability.md +25 -0
  335. package/skills/lighting-material-plan/references/reflective-floor-pattern.md +22 -0
  336. package/skills/lighting-material-plan/references/web-material-simplification.md +23 -0
  337. package/skills/lighting-quality-checker/EVAL.md +41 -0
  338. package/skills/lighting-quality-checker/SKILL.md +247 -0
  339. package/skills/lighting-quality-checker/contract.json +187 -0
  340. package/skills/lighting-quality-checker/references/hdri-balance-rules.md +48 -0
  341. package/skills/lighting-quality-checker/references/intensity-ranges.md +73 -0
  342. package/skills/lighting-quality-checker/references/shadow-softness-rules.md +38 -0
  343. package/skills/material-quality-checker/EVAL.md +40 -0
  344. package/skills/material-quality-checker/SKILL.md +261 -0
  345. package/skills/material-quality-checker/contract.json +244 -0
  346. package/skills/material-quality-checker/references/consumer-stack-rules.md +62 -0
  347. package/skills/material-quality-checker/references/pbr-sanity-rules.md +78 -0
  348. package/skills/material-quality-checker/references/texture-budget-rules.md +48 -0
  349. package/skills/mobile-glb-budget/EVAL.md +40 -0
  350. package/skills/mobile-glb-budget/SKILL.md +264 -0
  351. package/skills/mobile-glb-budget/contract.json +309 -0
  352. package/skills/mobile-glb-budget/references/budget-tiers.md +30 -0
  353. package/skills/mobile-glb-budget/references/degradation-plan.md +34 -0
  354. package/skills/mobile-glb-budget/references/violation-rules.md +43 -0
  355. package/skills/output-format-decision/EVAL.md +27 -0
  356. package/skills/output-format-decision/SKILL.md +222 -0
  357. package/skills/output-format-decision/contract.json +179 -0
  358. package/skills/output-format-decision/references/bit-depth-rules.md +56 -0
  359. package/skills/output-format-decision/references/compression-tradeoffs.md +62 -0
  360. package/skills/output-format-decision/references/format-decision-matrix.md +34 -0
  361. package/skills/pack-prerequisite-checker/EVAL.md +26 -0
  362. package/skills/pack-prerequisite-checker/SKILL.md +272 -0
  363. package/skills/pack-prerequisite-checker/contract.json +214 -0
  364. package/skills/pack-prerequisite-checker/references/blocked-start-playbook.md +21 -0
  365. package/skills/pack-prerequisite-checker/references/pack-readiness-template.md +38 -0
  366. package/skills/pack-prerequisite-checker/references/prerequisite-matrix.md +20 -0
  367. package/skills/path-one-host-outline/EVAL.md +26 -0
  368. package/skills/path-one-host-outline/SKILL.md +251 -0
  369. package/skills/path-one-host-outline/contract.json +167 -0
  370. package/skills/path-one-host-outline/references/connector-vs-manual-matrix.md +21 -0
  371. package/skills/path-one-host-outline/references/host-checklist-template.md +35 -0
  372. package/skills/path-one-host-outline/references/lab-addon-reminders.md +12 -0
  373. package/skills/plain-language-response/EVAL.md +33 -0
  374. package/skills/plain-language-response/SKILL.md +194 -0
  375. package/skills/plain-language-response/contract.json +242 -0
  376. package/skills/plain-language-response/references/caveat-language.md +25 -0
  377. package/skills/plain-language-response/references/plain-language-patterns.md +30 -0
  378. package/skills/plain-language-response/references/stakeholder-friendly-examples.md +30 -0
  379. package/skills/plain-language-response/references/status-summary-templates.md +50 -0
  380. package/skills/polycount-budget-checker/EVAL.md +40 -0
  381. package/skills/polycount-budget-checker/SKILL.md +251 -0
  382. package/skills/polycount-budget-checker/contract.json +196 -0
  383. package/skills/polycount-budget-checker/references/instance-counting-rules.md +39 -0
  384. package/skills/polycount-budget-checker/references/per-mesh-rules.md +43 -0
  385. package/skills/polycount-budget-checker/references/topology-hints.md +56 -0
  386. package/skills/pre-handoff-verification/EVAL.md +84 -0
  387. package/skills/pre-handoff-verification/SKILL.md +252 -0
  388. package/skills/pre-handoff-verification/contract.json +295 -0
  389. package/skills/pre-handoff-verification/references/downgrade-rules.md +39 -0
  390. package/skills/pre-handoff-verification/references/seven-point-checklist.md +46 -0
  391. package/skills/pre-handoff-verification/references/text-only-mode-handling.md +36 -0
  392. package/skills/preview-report/EVAL.md +39 -0
  393. package/skills/preview-report/SKILL.md +254 -0
  394. package/skills/preview-report/contract.json +141 -0
  395. package/skills/preview-report/references/handoff-recipients.md +41 -0
  396. package/skills/preview-report/references/report-schema.md +60 -0
  397. package/skills/preview-report/references/truth-label-rules.md +36 -0
  398. package/skills/product-grid-scene-planner/EVAL.md +42 -0
  399. package/skills/product-grid-scene-planner/SKILL.md +246 -0
  400. package/skills/product-grid-scene-planner/contract.json +257 -0
  401. package/skills/product-grid-scene-planner/references/grid-consistency-rules.md +53 -0
  402. package/skills/product-grid-scene-planner/references/grid-layout-rules.md +42 -0
  403. package/skills/product-grid-scene-planner/references/grid-output-naming-rules.md +52 -0
  404. package/skills/product-hero-scene-planner/EVAL.md +33 -0
  405. package/skills/product-hero-scene-planner/SKILL.md +227 -0
  406. package/skills/product-hero-scene-planner/contract.json +228 -0
  407. package/skills/product-hero-scene-planner/references/clarification-patterns.md +24 -0
  408. package/skills/product-hero-scene-planner/references/cyberpunk-shoe-example.md +28 -0
  409. package/skills/product-hero-scene-planner/references/product-hero-playbooks.md +22 -0
  410. package/skills/product-hero-scene-planner/references/scene-plan-schema.md +35 -0
  411. package/skills/r3f-component-plan/EVAL.md +43 -0
  412. package/skills/r3f-component-plan/SKILL.md +290 -0
  413. package/skills/r3f-component-plan/contract.json +171 -0
  414. package/skills/r3f-component-plan/references/component-shape-patterns.md +54 -0
  415. package/skills/r3f-component-plan/references/suspense-placement-rules.md +50 -0
  416. package/skills/r3f-component-plan/references/usegltf-caching-rules.md +53 -0
  417. package/skills/recipe-fit-assessor/EVAL.md +28 -0
  418. package/skills/recipe-fit-assessor/SKILL.md +266 -0
  419. package/skills/recipe-fit-assessor/contract.json +220 -0
  420. package/skills/recipe-fit-assessor/references/recipe-catalog.md +30 -0
  421. package/skills/recipe-fit-assessor/references/scope-gap-rules.md +27 -0
  422. package/skills/recipe-fit-assessor/references/workflow-recommendation-template.md +34 -0
  423. package/skills/render-export-evidence/EVAL.md +86 -0
  424. package/skills/render-export-evidence/SKILL.md +339 -0
  425. package/skills/render-export-evidence/contract.json +206 -0
  426. package/skills/render-export-evidence/references/attempted-vs-failed-rubric.md +75 -0
  427. package/skills/render-export-evidence/references/evidence-record-templates.md +143 -0
  428. package/skills/render-export-evidence/references/truth-label-decision-tree.md +57 -0
  429. package/skills/resolution-aspect-decision/EVAL.md +26 -0
  430. package/skills/resolution-aspect-decision/SKILL.md +246 -0
  431. package/skills/resolution-aspect-decision/contract.json +160 -0
  432. package/skills/resolution-aspect-decision/references/aspect-defaults.md +41 -0
  433. package/skills/resolution-aspect-decision/references/print-vs-screen-rules.md +58 -0
  434. package/skills/resolution-aspect-decision/references/resolution-defaults.md +64 -0
  435. package/skills/runtime-attempt-report/EVAL.md +26 -0
  436. package/skills/runtime-attempt-report/SKILL.md +268 -0
  437. package/skills/runtime-attempt-report/contract.json +176 -0
  438. package/skills/runtime-attempt-report/references/attempt-record-template.md +49 -0
  439. package/skills/runtime-attempt-report/references/triage-next-steps.md +15 -0
  440. package/skills/runtime-attempt-report/references/truth-label-blocks.md +27 -0
  441. package/skills/runtime-path-picker/EVAL.md +26 -0
  442. package/skills/runtime-path-picker/SKILL.md +268 -0
  443. package/skills/runtime-path-picker/contract.json +191 -0
  444. package/skills/runtime-path-picker/references/anti-patterns.md +14 -0
  445. package/skills/runtime-path-picker/references/decision-tree.md +29 -0
  446. package/skills/runtime-path-picker/references/path-constraints-table.md +18 -0
  447. package/skills/runtime-readiness/EVAL.md +33 -0
  448. package/skills/runtime-readiness/SKILL.md +218 -0
  449. package/skills/runtime-readiness/contract.json +190 -0
  450. package/skills/runtime-readiness/references/blocker-report-template.md +28 -0
  451. package/skills/runtime-readiness/references/evidence-examples.md +23 -0
  452. package/skills/runtime-readiness/references/readiness-matrix.md +46 -0
  453. package/skills/runtime-setup/EVAL.md +33 -0
  454. package/skills/runtime-setup/SKILL.md +209 -0
  455. package/skills/runtime-setup/contract.json +171 -0
  456. package/skills/runtime-setup/references/runtime-option-decision-tree.md +28 -0
  457. package/skills/runtime-setup/references/setup-summary-template.md +33 -0
  458. package/skills/runtime-setup/references/source-confidence-labels.md +23 -0
  459. package/skills/scene-readiness/EVAL.md +33 -0
  460. package/skills/scene-readiness/SKILL.md +195 -0
  461. package/skills/scene-readiness/contract.json +198 -0
  462. package/skills/scene-readiness/references/blocker-catalog.md +24 -0
  463. package/skills/scene-readiness/references/not-run-handling.md +22 -0
  464. package/skills/scene-readiness/references/quality-rubric.md +23 -0
  465. package/skills/scene-readiness/references/verdict-language.md +22 -0
  466. package/skills/scope-guard/EVAL.md +33 -0
  467. package/skills/scope-guard/SKILL.md +222 -0
  468. package/skills/scope-guard/contract.json +171 -0
  469. package/skills/scope-guard/references/options-language-template.md +51 -0
  470. package/skills/scope-guard/references/recurring-creep-patterns.md +55 -0
  471. package/skills/scope-guard/references/scope-addition-classification.md +55 -0
  472. package/skills/stage-gates/EVAL.md +40 -0
  473. package/skills/stage-gates/SKILL.md +257 -0
  474. package/skills/stage-gates/contract.json +490 -0
  475. package/skills/stage-gates/references/failed-gate-handling.md +42 -0
  476. package/skills/stage-gates/references/gate-template.md +46 -0
  477. package/skills/stage-gates/references/stage-decomposition-patterns.md +55 -0
  478. package/skills/workflow-stage-router/EVAL.md +25 -0
  479. package/skills/workflow-stage-router/SKILL.md +259 -0
  480. package/skills/workflow-stage-router/contract.json +150 -0
  481. package/skills/workflow-stage-router/references/milestone-model.md +20 -0
  482. package/skills/workflow-stage-router/references/routing-decision-tree.md +32 -0
  483. package/skills/workflow-stage-router/references/stage-handoff-template.md +37 -0
  484. package/skills.sh.json +102 -0
@@ -0,0 +1,227 @@
1
+ ---
2
+ name: product-hero-scene-planner
3
+ description: Build a complete product-hero scene plan (dimensions, Z=0 anchor, 6-face silhouette guard, lighting, camera, quality gates) from plain user intent.
4
+ ---
5
+
6
+ # product-hero-scene-planner
7
+
8
+ ## Purpose
9
+ Turn user intent or an upstream brief into a complete, plain-language product-hero scene plan (subject, composition, camera, lighting, material, environment, plus render, export, and web-handoff intent) before any runtime phase.
10
+
11
+ Canonical role: high-level `scene-planning` for single product-hero workflows in BlendOps. Keep role boundaries strict:
12
+ - `intent-to-3d-brief-writer` writes the upstream brief.
13
+ - THIS skill (`product-hero-scene-planner`) produces the complete product-hero scene plan and assumptions register.
14
+ - `camera-composition` deep-dives framing and lens setup.
15
+ - `lighting-material-plan` deep-dives lookdev and shader/light rigs.
16
+ - `acceptance-criteria-builder` writes measurable acceptance rows.
17
+ - `done-criteria` pins the done condition.
18
+ - `scene-readiness` reviews scene readiness later.
19
+
20
+ ## Quick start
21
+ - confirm this skill fits your goal
22
+ - provide required inputs first
23
+ - keep runtime claims evidence-bound
24
+ - follow suggested next-skill handoff
25
+
26
+ ## When to use
27
+ - single product-hero scene planning from user intent or an `intent-to-3d-brief-writer` brief
28
+ - pre-runtime structural planning across subject, camera, composition, lighting, material, environment, and delivery intent
29
+ - translating non-Blender product presentation goals into an assumption-tracked scene plan
30
+
31
+ ## When not to use
32
+ <!-- blendops:generated:start exclusions -->
33
+ - to execute Blender commands, write Python, or claim generated artifacts → use `../intent-to-3d-brief-writer/SKILL.md` (Delegates out-of-scope requests to intent-to-3d-brief-writer)
34
+ - to skip unresolved critical ambiguity or hide missing inputs → use `../camera-composition/SKILL.md` (Delegates out-of-scope requests to camera-composition)
35
+ - when raw user intent still needs initial brief normalization → use `../intent-to-3d-brief-writer/SKILL.md` (use intent-to-3d-brief-writer first)
36
+ - when planning a multi-item catalog or grid layout → use `../product-grid-scene-planner/SKILL.md` (use product-grid-scene-planner)
37
+ - when deep-diving camera/framing mechanics → use `../camera-composition/SKILL.md` (use lighting-material-plan)
38
+ - when writing measurable pass/fail acceptance tables → use `../acceptance-criteria-builder/SKILL.md` (use scene-readiness)
39
+ <!-- blendops:generated:end exclusions -->
40
+
41
+ ## Trigger phrases
42
+ <!-- blendops:generated:start triggers -->
43
+ - "plan a product hero scene"
44
+ - "turn this into a Blender plan"
45
+ - "prepare cyberpunk shoe scene plan"
46
+ <!-- blendops:generated:end triggers -->
47
+
48
+ ## Prerequisites / readiness
49
+ - output destination clarified (web, app, game, or still/video render)
50
+ - upstream brief from `intent-to-3d-brief-writer` provided or user intent clear enough to extract constraints
51
+ - runtime readiness optionally checked via `runtime-readiness` (does not alter this skill's truth states: Runtime stays `Not Run`, Artifacts stay `Not Produced`)
52
+ - if a live scene already exists, read-only inspection data (`get_objects_summary`) provided so real dimensions replace assumptions
53
+
54
+ ## Input schema
55
+
56
+ ### Required inputs
57
+ - user prompt or upstream brief (from `intent-to-3d-brief-writer`)
58
+ - output destination (web/app/game/render)
59
+
60
+ ### Optional inputs
61
+ - style/mood references
62
+ - product constraints and plausible real-world object dimensions
63
+ - read-only live-scene summary (`get_objects_summary`) if an existing scene is being planned against
64
+ - performance constraints (e.g., target polycount or mobile web limits)
65
+
66
+ ### Assumptions to confirm
67
+ - source model availability and scale plausibility (if `get_objects_summary` is unavailable)
68
+ - quality priority (realtime web vs marketing render)
69
+ - acceptable caveat level for deferred sections
70
+
71
+ ## Output schema
72
+
73
+ ### Primary output
74
+ - complete product-hero scene plan covering:
75
+ 1. Subject plan (primary product, context props, plausible real-world dimensions or `get_objects_summary` measurements)
76
+ 2. Composition plan (focal hierarchy, framing intent, negative space)
77
+ 3. Camera plan (angle, lens intent, depth-of-field strategy)
78
+ 4. Lighting plan (key/fill/rim roles, mood intent)
79
+ 5. Material plan (surface finish intent, portability caveats)
80
+ 6. Environment plan (backdrop, support surface, reflections/context)
81
+ 7. Render & export intent (format, resolution/aspect intent, engine direction)
82
+ 8. Web-handoff intent (GLB/realtime readiness notes, or explicit deferral if render-only)
83
+
84
+ ### Secondary output
85
+ - assumptions register (explicitly listing every unconfirmed input or dimensional assumption)
86
+ - targeted clarification questions (when critical inputs are missing or conflicting)
87
+
88
+ ### Evidence / caveat output
89
+ - explicit deferral log (every omitted or partial plan section must be marked deferred with a concrete caveat)
90
+ - fixed truth-state declaration: `Runtime: Not Run`, `Artifacts: Not Produced` (downgrade-only, never upgrade)
91
+
92
+ ## Required laws
93
+ - ../../laws/official-runtime-only.md
94
+ - ../../laws/evidence-before-done.md
95
+ - ../../laws/non-blender-user-language.md
96
+ - ../../laws/no-arbitrary-python-interface.md
97
+
98
+ ## Official runtime boundary
99
+ Planning-only skill: no Blender execution, no Python scripts, and no artifact generation.
100
+ - Runtime truth state must remain `Not Run` (from canonical states `Not Run | Attempted | Produced | Verified | Failed`).
101
+ - Artifact truth state must remain `Not Produced` (downgrade-only, never upgrade).
102
+ - When a live scene exists, consume read-only inspection results (`get_objects_summary`) rather than assuming object dimensions, without executing scene mutations.
103
+
104
+ ## Operating procedure
105
+ 1. Restate user intent and desired outcome in plain, non-Blender language (or ingest the brief from `intent-to-3d-brief-writer`).
106
+ 2. Identify target audience and output destination profile (web, app, game, or render).
107
+ 3. Extract hard constraints (brand, style, real-world sizing, delivery platform).
108
+ 4. Generate targeted clarification questions if critical data is missing.
109
+ 5. Build subject plan: define primary hero object, support props, and plausible real-world dimensions (use read-only `get_objects_summary` measurements instead of assumptions whenever a live scene exists).
110
+ 6. Build high-level composition plan (focal hierarchy, framing, negative space) ready for deep-dive in `camera-composition`.
111
+ 7. Build high-level camera plan (angle, focal length intent, depth strategy) ready for deep-dive in `camera-composition`.
112
+ 8. Build high-level lighting plan (key/fill/rim roles and mood intent) ready for deep-dive in `lighting-material-plan`.
113
+ 9. Build high-level material plan (surface finish intent and export portability caveats) ready for deep-dive in `lighting-material-plan`.
114
+ 10. Build environment plan (backdrop, ground plane, ambient context).
115
+ 11. Define render/export intent and web-handoff intent (ensure every section in steps 5–11 is either present or explicitly deferred with a documented caveat).
116
+ 12. Populate the assumptions register, lock truth states (`Runtime: Not Run`, `Artifacts: Not Produced`), and specify next-skill handoffs (`acceptance-criteria-builder` for measurable acceptance rows, `done-criteria` for done conditions, and `scene-readiness` for post-build review).
117
+
118
+ ## Decision tree
119
+ - If output destination is unknown → pause and ask for destination first, or provide explicitly caveated options.
120
+ - If a live scene exists → use read-only `get_objects_summary` data for object scale/counts instead of guessing; otherwise record plausible real-world dimensions in the assumptions register.
121
+ - If any plan section cannot be completed → mark that section explicitly deferred with a caveat (never silently omit).
122
+ - If constraints conflict (e.g., cinematic glass refractions vs strict mobile web budget) → present Option A / Option B trade-offs and route to `acceptance-criteria-builder`.
123
+ - Regardless of whether downstream runtime is ready, unknown, or blocked → keep planning-only mode with `Runtime: Not Run` and `Artifacts: Not Produced`.
124
+
125
+ ## Playbooks
126
+ - Playbook A: Text-only planning path (no live scene; relies on plausible real-world sizing assumptions + full assumptions register; `Runtime: Not Run`, `Artifacts: Not Produced`).
127
+ - Playbook B: Live-scene-informed planning path (consumes read-only `get_objects_summary` to ground object dimensions; prepares handoffs to deep-dive planners; `Runtime: Not Run`, `Artifacts: Not Produced`).
128
+ - Playbook C: Blocked-downstream path (delivers complete scene plan, assumptions register, and blocker caveats while keeping `Runtime: Not Run` and `Artifacts: Not Produced`).
129
+
130
+ ## Mode handling
131
+
132
+ ### Text-only mode
133
+ - deliver complete scene plan and assumptions register using plausible real-world dimensions
134
+ - truth states stay `Runtime: Not Run` and `Artifacts: Not Produced`
135
+
136
+ ### Runtime-ready mode
137
+ - prefer read-only `get_objects_summary` facts over dimensional assumptions if a live scene exists
138
+ - include structured handoff steps for downstream planners and checkers
139
+ - truth states stay `Runtime: Not Run` and `Artifacts: Not Produced` (no upgrade in this skill)
140
+
141
+ ### Blocked runtime mode
142
+ - deliver complete scene plan, assumptions register, and blocker-aware next actions
143
+ - truth states stay `Runtime: Not Run` and `Artifacts: Not Produced`
144
+
145
+ ## Validation checklist
146
+ - [ ] intent and output destination restated in plain language
147
+ - [ ] subject plan includes plausible real-world dimensions (or `get_objects_summary` data when a live scene exists)
148
+ - [ ] composition, camera, lighting, material, and environment plans are all present (or explicitly deferred with a caveat)
149
+ - [ ] render/export intent and web-handoff intent are present (or explicitly deferred with a caveat)
150
+ - [ ] assumptions register is complete and explicit
151
+ - [ ] clarification questions included for any unresolved critical inputs
152
+ - [ ] truth states explicitly set to `Runtime: Not Run` and `Artifacts: Not Produced` (no overclaims or upgrades)
153
+ - [ ] no Python code or Blender execution commands included
154
+ - [ ] role boundaries respected with explicit handoffs to `camera-composition`, `lighting-material-plan`, `acceptance-criteria-builder`, `done-criteria`, and `scene-readiness`
155
+
156
+ ## Pass / Warn / Fail rubric
157
+
158
+ | Category | Pass | Warn | Fail |
159
+ |---|---|---|---|
160
+ | Intent & sizing grounding | Intent clear; dimensions grounded via `get_objects_summary` or plausible real-world sizing | Minor non-critical ambiguity; sizing assumed with caveat | Core intent unclear or implausible/untracked object scale |
161
+ | Plan completeness | All 8 plan sections present or explicitly deferred with a caveat | Deferral caveats present but brief | Any plan section silently omitted or left vague without deferral caveat |
162
+ | Assumption transparency | Complete assumptions register + clear deferral caveats | Minor assumptions listed inline instead of register | Hidden assumptions or silent guesses |
163
+ | Evidence & role boundary | `Runtime: Not Run`, `Artifacts: Not Produced`; clean handoffs; no Python | Slightly verbose handoff boundary | Runtime/artifact state upgraded, Python included, or blurs into deep-dive/acceptance/checker roles |
164
+
165
+ ## Failure handling
166
+ - Missing critical inputs: block and ask targeted questions.
167
+ - Conflicting constraints: provide prioritized options with caveats.
168
+ - Unknown runtime readiness: continue in text-only planning mode.
169
+
170
+ ## Troubleshooting
171
+ - Prompt too broad or unstructured: hand off upstream to `intent-to-3d-brief-writer` before finalizing the scene plan.
172
+ - Web + cinematic conflict: flag trade-off in assumptions register and route to `cycles-vs-eevee-decision` or `mobile-glb-budget`.
173
+ - No source model available: log intake risk in assumptions register and route to `asset-discovery` or `asset-fallback-strategy`.
174
+
175
+ ## Best practices
176
+ - preserve non-Blender user language and explain visual trade-offs plainly
177
+ - keep real-world object dimensions plausible; when a live scene exists, always use read-only inspection (`get_objects_summary`) rather than assumptions
178
+ - ensure every plan section is either complete or explicitly deferred with a caveat
179
+ - keep high-level scene planning modular so downstream planners and acceptance builders can consume it cleanly
180
+
181
+ ## Good examples
182
+ “Complete product-hero plan covering subject (plausible 28 cm shoe length assumed; no live scene `get_objects_summary` available), composition, camera, lighting, material, environment, and render/export/web-handoff intent, with an explicit assumptions register and truth states locked at `Runtime: Not Run` and `Artifacts: Not Produced`.”
183
+
184
+ ## Bad examples
185
+ “Hero scene done.” (no structure, no caveats)
186
+
187
+ ## User-facing response template
188
+ - **What you asked for:** (plain-language goal and destination)
189
+ - **Proposed product-hero scene plan:** (subject & sizing, composition, camera, lighting, material, environment, render/export intent, web-handoff intent)
190
+ - **Deferred sections & caveats:** (any section deferred and why, or "None")
191
+ - **Assumptions register:** (explicit list of unverified inputs and sizing assumptions)
192
+ - **Current status:** `Runtime: Not Run` | `Artifacts: Not Produced`
193
+ - **Next action / handoff:** (recommended next skill from catalog)
194
+
195
+ ## Anti-patterns
196
+ - skipping required laws or runtime boundary statements
197
+ - claiming runtime/artifact success without evidence
198
+ - claiming runtime execution or upgrading truth states beyond `Runtime: Not Run` and `Artifacts: Not Produced`
199
+ - assigning `Not Run` to artifacts instead of runtime (confusing runtime and artifact truth states)
200
+ - silently omitting any plan section instead of marking it explicitly deferred with a caveat
201
+ - guessing object scale when a live scene exists and read-only `get_objects_summary` can be inspected
202
+ - blurring roles by writing deep camera/light rigs, measurable acceptance tables, or stop conditions instead of handing off
203
+ - including Python code or Blender CLI/MCP execution commands in the plan
204
+ - producing Blender-jargon-heavy output without plain-language explanation
205
+
206
+ ## Cross-skill handoff
207
+ <!-- blendops:generated:start handoffs -->
208
+ - [upstream_reference] Upstream input (if raw prompt needs structuring) → `../intent-to-3d-brief-writer/SKILL.md`
209
+ - [progression] Next (deep-dive framing & camera) → `../camera-composition/SKILL.md`
210
+ - [progression] Next (deep-dive lookdev & lighting) → `../lighting-material-plan/SKILL.md`
211
+ - [fallback] Then (measurable pass/fail rows) → `../acceptance-criteria-builder/SKILL.md`
212
+ - [upstream_reference] Then (pin done condition) → `../done-criteria/SKILL.md`
213
+ - [progression] Later (post-build readiness review) → `../scene-readiness/SKILL.md`
214
+ - [conditional] Delivery handoff (when web/render output is targeted) (glb-web-handoff) → `../glb-web-handoff/SKILL.md`
215
+ - [conditional] Delivery handoff (when web/render output is targeted) (render-export-evidence) → `../render-export-evidence/SKILL.md`
216
+ <!-- blendops:generated:end handoffs -->
217
+
218
+ ## Non-goals
219
+ - executing Blender commands, MCP mutations, or CLI jobs
220
+ - writing Python scripts
221
+ - claiming `Attempted`, `Produced`, or `Verified` runtime/artifact states
222
+ - replacing `intent-to-3d-brief-writer` (upstream brief), `camera-composition` (deep framing), `lighting-material-plan` (deep lookdev), `acceptance-criteria-builder` (measurable acceptance rows), `done-criteria` (done conditions), or `scene-readiness` (readiness review)
223
+
224
+ ## References
225
+ - https://www.blender.org/lab/mcp-server/
226
+ - https://claude.com/resources/tutorials/using-the-blender-connector-in-claude
227
+ - https://docs.blender.org/manual/en/latest/advanced/command_line/index.html
@@ -0,0 +1,228 @@
1
+ {
2
+ "$schema": "../../schemas/skill-contract.schema.json",
3
+ "id": "product-hero-scene-planner",
4
+ "version": "1.0.0",
5
+ "category": "scene-planners",
6
+ "role": "single-product-hero-scene-architect",
7
+ "purpose": "Generate a complete product-hero scene plan from non-Blender-user intent with explicit assumptions and gates.",
8
+ "capabilityTier": "L0",
9
+ "triggers": [
10
+ "plan a product hero scene",
11
+ "turn this into a Blender plan",
12
+ "prepare cyberpunk shoe scene plan"
13
+ ],
14
+ "exclusions": [
15
+ {
16
+ "condition": "to execute Blender commands, write Python, or claim generated artifacts",
17
+ "delegateTo": "intent-to-3d-brief-writer",
18
+ "reason": "Delegates out-of-scope requests to intent-to-3d-brief-writer"
19
+ },
20
+ {
21
+ "condition": "to skip unresolved critical ambiguity or hide missing inputs",
22
+ "delegateTo": "camera-composition",
23
+ "reason": "Delegates out-of-scope requests to camera-composition"
24
+ },
25
+ {
26
+ "condition": "when raw user intent still needs initial brief normalization",
27
+ "delegateTo": "intent-to-3d-brief-writer",
28
+ "reason": "use intent-to-3d-brief-writer first"
29
+ },
30
+ {
31
+ "condition": "when planning a multi-item catalog or grid layout",
32
+ "delegateTo": "product-grid-scene-planner",
33
+ "reason": "use product-grid-scene-planner"
34
+ },
35
+ {
36
+ "condition": "when deep-diving camera/framing mechanics",
37
+ "delegateTo": "camera-composition",
38
+ "reason": "use lighting-material-plan"
39
+ },
40
+ {
41
+ "condition": "when writing measurable pass/fail acceptance tables",
42
+ "delegateTo": "acceptance-criteria-builder",
43
+ "reason": "use scene-readiness"
44
+ }
45
+ ],
46
+ "inputs": {
47
+ "required": [
48
+ {
49
+ "name": "locked_3d_brief",
50
+ "type": "object",
51
+ "description": "Locked 8-slot 3D brief defining the hero product, hero feature callout, mood, and output channel"
52
+ },
53
+ {
54
+ "name": "sourced_product_asset_status",
55
+ "type": "object",
56
+ "description": "Hero product model posture and material readiness from asset-discovery"
57
+ }
58
+ ],
59
+ "optional": [
60
+ {
61
+ "name": "pack_context",
62
+ "type": "string",
63
+ "description": "Optional pack reference such as packs/product-hero-v0/PACK.md"
64
+ }
65
+ ]
66
+ },
67
+ "outputs": {
68
+ "primary": [
69
+ "hero_product_staging_and_pedestal_plan",
70
+ "camera_and_lookdev_handoff_inputs",
71
+ "scene_quality_validation_hooks"
72
+ ],
73
+ "truthStatePolicy": {
74
+ "runtimeDefault": "Not Run",
75
+ "artifactDefault": "Not Produced",
76
+ "mutationRule": "downgrade_only"
77
+ }
78
+ },
79
+ "handoffs": [
80
+ {
81
+ "target": "intent-to-3d-brief-writer",
82
+ "type": "upstream_reference",
83
+ "label": "Upstream input (if raw prompt needs structuring)",
84
+ "when": {
85
+ "all": [
86
+ {
87
+ "field": "goal.clarity",
88
+ "operator": "equals",
89
+ "value": "clear"
90
+ },
91
+ {
92
+ "field": "brief.locked",
93
+ "operator": "equals",
94
+ "value": false
95
+ }
96
+ ]
97
+ }
98
+ },
99
+ {
100
+ "target": "camera-composition",
101
+ "type": "progression",
102
+ "label": "Next (deep-dive framing & camera)",
103
+ "when": {
104
+ "all": [
105
+ {
106
+ "field": "brief.locked",
107
+ "operator": "equals",
108
+ "value": true
109
+ },
110
+ {
111
+ "field": "stage.current",
112
+ "operator": "equals",
113
+ "value": "camera_planning"
114
+ }
115
+ ]
116
+ }
117
+ },
118
+ {
119
+ "target": "lighting-material-plan",
120
+ "type": "progression",
121
+ "label": "Next (deep-dive lookdev & lighting)",
122
+ "when": {
123
+ "all": [
124
+ {
125
+ "field": "brief.locked",
126
+ "operator": "equals",
127
+ "value": true
128
+ },
129
+ {
130
+ "field": "stage.current",
131
+ "operator": "equals",
132
+ "value": "lookdev_planning"
133
+ }
134
+ ]
135
+ }
136
+ },
137
+ {
138
+ "target": "acceptance-criteria-builder",
139
+ "type": "fallback",
140
+ "label": "Then (measurable pass/fail rows)",
141
+ "when": {
142
+ "all": [
143
+ {
144
+ "field": "brief.locked",
145
+ "operator": "equals",
146
+ "value": true
147
+ },
148
+ {
149
+ "field": "stage.current",
150
+ "operator": "equals",
151
+ "value": "acceptance_criteria"
152
+ }
153
+ ]
154
+ }
155
+ },
156
+ {
157
+ "target": "done-criteria",
158
+ "type": "upstream_reference",
159
+ "label": "Then (pin done condition)",
160
+ "when": {
161
+ "all": [
162
+ {
163
+ "field": "brief.locked",
164
+ "operator": "equals",
165
+ "value": true
166
+ },
167
+ {
168
+ "field": "stage.current",
169
+ "operator": "equals",
170
+ "value": "stop_condition"
171
+ }
172
+ ]
173
+ }
174
+ },
175
+ {
176
+ "target": "scene-readiness",
177
+ "type": "progression",
178
+ "label": "Later (post-build readiness review)",
179
+ "when": {
180
+ "all": [
181
+ {
182
+ "field": "quality.domain",
183
+ "operator": "equals",
184
+ "value": "holistic"
185
+ },
186
+ {
187
+ "field": "stage.current",
188
+ "operator": "equals",
189
+ "value": "quality_validation"
190
+ }
191
+ ]
192
+ }
193
+ },
194
+ {
195
+ "target": "glb-web-handoff",
196
+ "type": "conditional",
197
+ "label": "Delivery handoff (when web/render output is targeted) (glb-web-handoff)",
198
+ "when": {
199
+ "all": [
200
+ {
201
+ "field": "artifact.type",
202
+ "operator": "equals",
203
+ "value": "glb"
204
+ },
205
+ {
206
+ "field": "handoff.consumerStack",
207
+ "operator": "equals",
208
+ "value": "web_glb"
209
+ }
210
+ ]
211
+ }
212
+ },
213
+ {
214
+ "target": "render-export-evidence",
215
+ "type": "conditional",
216
+ "label": "Delivery handoff (when web/render output is targeted) (render-export-evidence)",
217
+ "when": {
218
+ "all": [
219
+ {
220
+ "field": "stage.current",
221
+ "operator": "equals",
222
+ "value": "post_execution_audit"
223
+ }
224
+ ]
225
+ }
226
+ }
227
+ ]
228
+ }
@@ -0,0 +1,24 @@
1
+ # Clarification Patterns
2
+
3
+ ## Purpose
4
+ Ask high-leverage clarification questions only when missing details would materially change camera geometry, material complexity, polycount budget, or lighting mood in `product-hero-scene-planner`.
5
+
6
+ ## When to use
7
+ - When the user's request omits delivery destination, hero silhouette cues, or real-time vs. offline fidelity priority. Never interrogate the user with 10 questions when sensible defaults work.
8
+
9
+ ## Five High-Value Clarification Axes
10
+
11
+ | Axis | Ask Only When Ambiguous | Default Safe Assumption (if user says "surprise me") |
12
+ |---|---|---|
13
+ | **1. Output Destination** | Is this a static hero image (`.png`), rotating video (`.mp4`), or interactive web 3D file (`.glb`)? | Static studio hero still (`16:9` `1920x1080`) + optional `.glb` web note (forces Tier 2 bake plan) |
14
+ | **2. Fidelity vs. Speed Priority** | Photoreal Cycles raytraced hero shot OR `<= 5 MB` 60 fps web/mobile asset? | Balanced `Khronos PBR Neutral` real-time-compatible materials so both Cycles & `.glb` stay viable |
15
+ | **3. Subject Reference Availability** | Do you have an existing `.blend`/`.glb`/logo/photo reference, or build procedurally from scratch? | Simple geometric/sculpted hero form (`<= 40k` tris) with placeholder surface cues marked clearly |
16
+ | **4. Layout & Copy Zone** | Will website headlines or buttons sit on the left/right side of the frame? | Center-balanced 3/4 hero (`55%` frame fill) with `12%` safe margins all around |
17
+ | **5. Performance / Platform Limits** | Any strict size cap (`<= 2 MB` mobile AR) or engine constraint (React Three Fiber, Shopify, Unreal)? | Standard web target (`<= 50k` tris, `<= 2048 px` textures, `<= 10 MB` `.glb`) |
18
+
19
+ ## Good vs. Bad Question Batch
20
+ - **Good (compact, 2-3 choices max)**: `"Before I draft the shoe scene plan: (1) Are you embedding an interactive 3D file (.glb) on a website or just need a static hero image? (2) Should we keep the left 40% dark/empty for landing-page text?"`
21
+ - **Bad**: Asking `"What F-stop, focal length, Cycles max bounces, roughness IOR, and clamp indirect threshold do you want?"` to a non-Blender founder.
22
+
23
+ ## Related skill
24
+ [../SKILL.md](../SKILL.md)
@@ -0,0 +1,28 @@
1
+ # Cyberpunk Shoe Example
2
+
3
+ ## Purpose
4
+ Provide a concrete, end-to-end reference plan matching the canonical `docs/recipes/cyberpunk-shoe-hero.md` golden path so `product-hero-scene-planner` outputs maintain consistent depth and truth discipline.
5
+
6
+ ## When to use
7
+ - As a structural and quality benchmark whenever planning stylized/futuristic product heroes, dark reflective studio scenes, or hybrid still + web `.glb` briefs.
8
+
9
+ ## Canonical Benchmark Scene Plan (Text-Only Planning Example)
10
+ - **Hero Subject & Footprint**: Sculpted futuristic sneaker (`~0.30 m` length x `0.11 m` width x `0.14 m` height), hovering at `Z = +0.06 m` (`12 deg` toe-down dynamic pitch, `35 deg` yaw) above a dark studio floor plane at `Z = 0.00 m`.
11
+ - **Camera Composition**: `65 mm` telephoto lens (`f/5.6`), `16:9` (`1920x1080`) split framing — hero shifted slightly right (`shift_x: -0.06`) leaving left `40%` clean dark atmospheric gradient for headline typography; hero occupies `~52%` of frame height.
12
+ - **Three-Layer Lighting**:
13
+ 1. **Cool Key (`Area`, 5600K)**: Soft overhead-front 45 deg key illuminating vamp mesh & stitching.
14
+ 2. **Cyan Rim (`Area`, 7500K-8000K / `#00E5FF` tint)**: Rear-left grazing rim separating sole silhouette from deep navy backdrop (`#0A0E17`).
15
+ 3. **Magenta Accent (`Area` / Emissive Strip, `#FF2A85`)**: Opposite lower-right rim catching heel counter + glossy floor bounce.
16
+ - **Materials & Web Handoff Caveats**: Matte tech-mesh upper (`Roughness 0.72`), satin TPU heel clip (`Roughness 0.28`), emissive sole groove (`Emission Strength 2.5`), dark satin acrylic floor (`Roughness 0.18`, subtle fade radial falloff). For `.glb` web export, procedural weave bump bakes to a `1024 px` normal map (`Tier 2` budget `<= 45k` tris).
17
+ - **View Transform**: `AgX` (`Medium High Contrast`) for hero still PNG; note `Khronos PBR Neutral` parity check if brand colors require exact hex reproduction in Three.js.
18
+
19
+ ## Truth Label Discipline (Required at Footer)
20
+ ```txt
21
+ Mode: Planning-only (text spec)
22
+ Runtime status: Not Run
23
+ Artifact status: Not Produced (no .blend, PNG render, or .glb file created in this planning step)
24
+ Next step: Validate pack prerequisites (`pack-prerequisite-checker`) or select Path 1 / Path 2 / CLI to execute.
25
+ ```
26
+
27
+ ## Related skill
28
+ [../SKILL.md](../SKILL.md)
@@ -0,0 +1,22 @@
1
+ # Product Hero Playbooks
2
+
3
+ ## Purpose
4
+ Offer distinct, campaign-ready visual playbooks so `product-hero-scene-planner` adapts staging, lighting ratio, floor behavior, and camera focal presets to the user's brand instead of forcing a dark neon aesthetic onto every product.
5
+
6
+ ## When to use
7
+ - Immediately after `intent-to-3d-brief-writer` when choosing the visual direction for a product hero shot.
8
+
9
+ ## Four Campaign Playbooks
10
+
11
+ | Playbook | Stage & Floor | Lighting Ratio & Color Mood | Camera Preset | Target Audience Fit |
12
+ |---|---|---|---|---|
13
+ | **1. Dark Cyberpunk / Tech Hero** | Matte-satin dark acrylic (`#0A0E17`, `Roughness 0.16-0.25`) with subtle contact reflection | Dramatic `5:1` ratio; neutral soft top key + cyan (`#00E5FF`) / magenta (`#FF2A85`) rim accents; `AgX Medium High Contrast` | `60-75 mm`, dynamic 3/4 yaw (`35-45 deg`), optional `5 deg` hero hover | Footwear, gaming peripherals, audio gear, futuristic hardware |
14
+ | **2. Clean Studio / Apple-Style Minimal** | Seamless cyclorama infinity sweep (`#F3F4F6`, subtle soft shadow catcher, `Roughness 0.85`) | Soft `2:1` broad wraparound area cards + crisp specular edge strip (`5500K-6000K`); `Khronos PBR Neutral` | `70-85 mm`, clean 3/4 or orthographic-feel front elevation, zero roll | Consumer electronics, minimalist skincare, industrial hardware |
15
+ | **3. Minimal E-Commerce Catalog Card** | Pure clean neutral plinth or transparent shadow-catcher floor (`Z = 0` strict grounding) | Even `1.5:1` commercial illumination preserving exact label/stitching legibility; zero color cast | `85 mm` locked studio preset, `1:1` or `4:5` tight `60%` fill | Multi-SKU storefront thumbnails, Shopify/Amazon 3D viewers (`<= 3 MB` `.glb`) |
16
+ | **4. Warm Editorial / Craft Detail** | Natural travertine, oak, or brushed slate pedestal with soft physical rim gradient | Directional `3:1` golden window key (`3500K-4200K`) + soft warm bounce card (`f/4` shallow accents) | `85-105 mm`, low-angle hero or tactile 3/4 close-up | Watches, fragrance glass, ceramics, artisan goods |
17
+
18
+ ## Selection Rule
19
+ - Match playbook strictly to **user audience + deliverable format**; never inject neon rims into a minimalist skincare or e-commerce catalog brief unless explicitly requested.
20
+
21
+ ## Related skill
22
+ [../SKILL.md](../SKILL.md)
@@ -0,0 +1,35 @@
1
+ # Scene Plan Schema
2
+
3
+ ## Purpose
4
+ Define required structure for product hero planning output.
5
+
6
+ ## When to use
7
+ For product-hero-scene-planner outputs.
8
+
9
+ ## Required sections
10
+ - intent summary
11
+ - subject model
12
+ - composition plan
13
+ - camera plan
14
+ - lighting plan
15
+ - material plan
16
+ - environment plan
17
+ - render/export intent
18
+ - web handoff intent
19
+
20
+ ## Six-face & paired-component completeness guard (Floor, Not Ceiling)
21
+
22
+ When planning physical products or props, ensure the `subject model` section accounts for all 6 spatial faces and symmetrical pairs so rear/underside geometry is never omitted:
23
+
24
+ - **Six faces**: Front (`-Y` camera-facing), Back (`+Y` controls/ports/labels), Top (`+Z`), Bottom (`-Z` feet/pads at `Z = 0`), Left (`-X`), Right (`+X`)
25
+ - **Paired components & mounts**: Verify matching pairs (wheels/brackets, front lens + rear viewfinder, handles + hinge mounts) and structural contact tolerances (no floating rods or clip-throughs)
26
+ - **Reference-Image-Match calibration**: Record real-world metric bounds (`width × depth × height` in meters) and silhouette reference anchors when references are supplied
27
+
28
+ ## Good example
29
+ All sections present with assumptions, 6-face/paired-component checks, real-world dimensions, and caveats.
30
+
31
+ ## Bad example
32
+ Only composition and front camera, missing backside/underside completeness or handoff/validation.
33
+
34
+ ## Related skill
35
+ ../SKILL.md
@@ -0,0 +1,43 @@
1
+ # EVAL — r3f-component-plan
2
+
3
+ ## Text-only eval prompt
4
+ Use r3f-component-plan to produce the React Three Fiber component spec for a hero-card GLB delivery (single instance, idle + hover animations, no variants).
5
+
6
+ ## Expected behavior
7
+ - props table (src, scale, animationName, onLoaded, …)
8
+ - ref interface (playAction)
9
+ - Suspense placement at component boundary
10
+ - useGLTF caching policy stated
11
+ - animation hook contract (idle auto-play + hover trigger)
12
+ - cleanup contract on unmount
13
+ - error / fallback contract
14
+ - minimal usage example
15
+ - no component code generated (spec only)
16
+ - R3F version targeted
17
+
18
+ ## Pass / Warn / Fail criteria
19
+ - Pass: complete spec covering every decision point, no code generation, no runtime claim
20
+ - Warn: spec missing one decision (e.g. Suspense placement or caching policy)
21
+ - Fail: generates working component code instead of spec, or claims runtime perf, or omits ref / fallback
22
+
23
+ ## Common failure modes
24
+ - emitting component code (out of scope)
25
+ - omitting Suspense placement
26
+ - promising performance
27
+ - not specifying R3F version
28
+
29
+ ## Evidence expectations
30
+ - explicit decision per row of the spec template
31
+ - usage example uses minimal pseudocode-style snippet, not full implementation
32
+ - no measurement claim
33
+
34
+ ## Sample passing response outline
35
+ - Component name + R3F version
36
+ - Props / ref / Suspense / cache / animation / cleanup / fallback rows filled
37
+ - Minimal usage example
38
+ - Handoff to glb-web-handoff named
39
+
40
+ ## Sample failing response outline
41
+ - Generates a 100-line component file
42
+ - Promises 60fps without measurement
43
+ - Skips ref interface entirely