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,246 @@
1
+ ---
2
+ name: product-grid-scene-planner
3
+ description: Plan a multi-product grid scene (e-commerce, catalog, comparison) before any modeling or render attempt; consistent lighting, camera, and grid spacing.
4
+ ---
5
+
6
+ # product-grid-scene-planner
7
+
8
+ ## Purpose
9
+ Translate a multi-product grid intent (e-commerce / catalog / comparison) into a structured scene plan. Distinct from `product-hero-scene-planner` (single product, hero) and `interior-scene` (room scene).
10
+
11
+ ## Quick start
12
+ - pin product list (count + per-product type and relative real-world size)
13
+ - normalize product scale across cells (or split incompatible scales into separate grids)
14
+ - pin grid layout (rows × cols + spacing)
15
+ - pin per-cell consistency level (strict / loose for camera angle, lighting, background)
16
+ - pin shared material / lighting / background palette
17
+ - record assumptions register and hand off to asset discovery, format decision, and quality checkers
18
+
19
+ ## When to use
20
+ - intent is multi-product display (4+ products in same scene)
21
+ - e-commerce catalog grid
22
+ - product comparison view
23
+ - showroom-style grid
24
+
25
+ ## When not to use
26
+ <!-- blendops:generated:start exclusions -->
27
+ - single product hero → use `../product-hero-scene-planner/SKILL.md` (use product-hero-scene-planner)
28
+ - character portrait → use `../character-portrait/SKILL.md` (use character-portrait)
29
+ - outdoor environment scene → use `../environment-shot/SKILL.md` (use environment-shot)
30
+ - interior room scene → use `../interior-scene/SKILL.md` (use interior-scene)
31
+ <!-- blendops:generated:end exclusions -->
32
+
33
+ ## Trigger phrases
34
+ <!-- blendops:generated:start triggers -->
35
+ - "grid of products"
36
+ - "lineup of"
37
+ - "catalog showing N items"
38
+ - "comparison render"
39
+ <!-- blendops:generated:end triggers -->
40
+
41
+ ## Prerequisites / readiness
42
+ - product list known (count + per-product description)
43
+ - consistency expectations known (identical lighting? identical camera? identical scale?)
44
+
45
+ ## Input schema
46
+
47
+ ### Required inputs
48
+
49
+ | Input | Why it is required |
50
+ |---|---|
51
+ | Product list + relative sizes | Determines grid size, asset scope, and scale normalization |
52
+ | Grid layout (rows × cols + spacing) | Drives overall and per-cell composition |
53
+ | Aspect ratio | Governs framing and cell proportions |
54
+ | Consistency level (strict / loose) | Determines per-cell camera, lighting, and background rules |
55
+
56
+ ### Optional inputs
57
+
58
+ | Input | Use |
59
+ |---|---|
60
+ | Brand palette | Shared material + background consistency |
61
+ | Per-product variants (color / SKU) | Adds variant rows and informs `output-format-decision` |
62
+ | Reference catalog images | Calibrates visual style and spacing |
63
+
64
+ ### Assumptions to confirm
65
+ - Scale normalization method is agreed (true relative scale vs. visual bounding-box normalization).
66
+ - Lighting is shared across cells (not separate per-cell lighting setups).
67
+ - Camera angle is consistent (same angle, distance, and lens feel) across cells unless variation is explicitly requested.
68
+
69
+ ## Output schema
70
+
71
+ ### Primary output
72
+ A structured product-grid plan: Product list, Scale normalization rule (normalized or split), Grid layout (rows × cols + spacing), Consistency level (strict / loose), Per-cell composition and camera rules, Shared lighting plan, Shared background and palette, Aspect + framing, and Assumptions register.
73
+
74
+ ### Secondary output
75
+ - per-product asset rows flagged for `asset-discovery`
76
+ - variant / SKU file output notes routed to `output-format-decision`
77
+ - downstream validation and sign-off handoff list
78
+
79
+ ### Evidence / caveat output
80
+
81
+ ```txt
82
+ Runtime status: Not Run | Attempted | Produced | Verified | Failed
83
+ Artifact status: Not Produced | Produced | Verified | Failed
84
+ Evidence used: <links, paths, logs, or "none">
85
+ Limitations: <known gaps>
86
+ ```
87
+
88
+ ## Required laws
89
+ - `../../laws/evidence-before-done.md`
90
+ - `../../laws/non-blender-user-language.md`
91
+ - `../../laws/no-arbitrary-python-interface.md`
92
+ - `../../laws/official-runtime-only.md`
93
+
94
+ ## Official runtime boundary
95
+
96
+ Planning-only skill — does not run Blender, model, source assets, or render. Runtime status must remain `Not Run` and Artifact status must remain `Not Produced` (truth states are downgrade-only, never upgrade). Hand off asset needs to `asset-discovery`, file output rules to `output-format-decision`, and validation to quality checkers.
97
+
98
+ ## Operating procedure
99
+ 1. Read product list from user or `intent-to-3d-brief-writer`; pin count, per-product description, and relative sizes.
100
+ 2. Normalize scale across differently-sized products (or split incompatible items into separate grid plans).
101
+ 3. Pin grid layout (rows × cols + spacing) per `references/grid-layout-rules.md`.
102
+ 4. Decide consistency level (strict / loose).
103
+ 5. Plan shared palette, shared lighting (one setup applied uniformly), and shared background.
104
+ 6. Plan per-cell camera + framing (including caption/label space).
105
+ 7. Define per-product asset rows and document the assumptions register.
106
+ 8. Hand off to `asset-discovery`, `output-format-decision` (if variant/SKU file outputs apply), `composition-quality-checker`, `lighting-quality-checker`, `material-quality-checker`, `scene-readiness`, `acceptance-criteria-builder`, and `done-criteria`.
107
+
108
+ ## Decision tree
109
+
110
+ ```txt
111
+ Products at very different scales (lipstick + sofa) in same grid?
112
+ → Fail if unaddressed; normalize to a clear visual bounding box or split into separate scenes
113
+ Different lighting per cell requested?
114
+ → Warn; usually erodes catalog uniformity
115
+ 20+ products in single render?
116
+ → Warn; recommend splitting into multiple grid plans
117
+ Brand palette or intent unclear?
118
+ → Hand off to intent-to-3d-brief-writer
119
+ Variant / SKU file output formats needed?
120
+ → Hand off file output rules to output-format-decision
121
+ ```
122
+
123
+ ## Playbooks
124
+
125
+ ### Playbook A: 2×2 e-commerce hero grid (16:9)
126
+ 4 products, identical 35mm lens, identical 3-point lighting, neutral seamless background, products centered in cells, equal spacing.
127
+
128
+ ### Playbook B: 3×3 catalog page (1:1)
129
+ 9 products, square cells, identical lighting, brand-color background, consistent product orientation, lower-third caption space per cell.
130
+
131
+ ### Playbook C: 1×4 comparison strip (2.39:1)
132
+ 4 product variants of same SKU, side-by-side, identical lighting + camera, label space below each.
133
+
134
+ ## Mode handling
135
+
136
+ ### Text-only mode
137
+
138
+ Emit the complete grid plan and assumptions register. Runtime stays `Not Run`; Artifacts stay `Not Produced`.
139
+
140
+ ### Runtime-ready mode
141
+
142
+ Emit the complete grid plan, assumptions register, and downstream handoff targets. Do not execute Blender; Runtime stays `Not Run` and Artifacts stay `Not Produced`.
143
+
144
+ ### Blocked runtime mode
145
+
146
+ Emit the complete grid plan and assumptions register; flag unconfirmed inputs under Limitations. Runtime stays `Not Run` and Artifacts stay `Not Produced`.
147
+
148
+ ## Validation checklist
149
+ - [ ] Product list complete with count and relative sizes
150
+ - [ ] Scale normalized across products (or explicitly split into separate grids)
151
+ - [ ] Grid layout (rows × cols + spacing) explicit
152
+ - [ ] Consistency level (strict / loose) stated
153
+ - [ ] Shared palette, lighting plan, and background present
154
+ - [ ] Per-cell camera and framing consistent (or variation explicit)
155
+ - [ ] Assumptions register included
156
+ - [ ] Asset rows flagged for `asset-discovery`
157
+ - [ ] Validation and sign-off handoffs named
158
+
159
+ ## Pass / Warn / Fail rubric
160
+
161
+ | Verdict | Criteria |
162
+ | --- | --- |
163
+ | Pass | All sections complete + scale normalized (or split) + consistency level stated + shared lighting/palette + assumptions register + asset list + truth states locked to `Not Run` / `Not Produced`. |
164
+ | Warn | Minor cell variance (e.g., per-cell angle or lighting tweak) without clear justification, or 20+ items crammed into one grid. |
165
+ | Fail | Mixed-scale products without normalization or split, missing shared lighting/camera consistency, missing consistency level, missing assumptions register, or upgraded truth states. |
166
+
167
+ ## Failure handling
168
+ - Mixed product scales → require normalized visual scale or split into separate grid plans.
169
+ - 20+ products → suggest splitting into multiple grid plans.
170
+ - Missing brand palette or unclear intent → hand off to `intent-to-3d-brief-writer`.
171
+
172
+ ## Troubleshooting
173
+
174
+ | Problem | Response |
175
+ | --- | --- |
176
+ | Products appear mismatched in size across cells | Specify bounding-box scale normalization and identical per-cell camera distance in the plan. |
177
+ | One cell stands out visually | Enforce strict consistency level for shared lighting and shared background palette. |
178
+ | Caption space cramped | Increase planned grid spacing or reduce product count per grid. |
179
+ | Background distracts from products | Plan a neutral solid or subtle gradient background that contrasts cleanly with the shared palette. |
180
+
181
+ ## Best practices
182
+ - Lock one camera angle and one shared lighting plan; apply identically across all cells.
183
+ - Normalize product scale (or split grids) before finalizing rows and columns.
184
+ - Reserve consistent caption or label space per cell for catalog layout.
185
+ - Keep the shared background tone consistent so material differences across SKUs remain accurate.
186
+
187
+ ## Good examples
188
+ - "Products: 4 sneaker variants (identical real-world scale, normalized to equal cell bounding boxes). Grid: 2×2, even spacing. Shared lighting: soft studio three-point setup, even illumination. Shared palette/background: neutral light-gray seamless backdrop. Per-cell camera: standard eye-level framing, identical distance and orientation. Caption space lower 15% reserved. Assumptions register: identical footwear dimensions; no props; single still catalog output. Runtime status: Not Run. Artifact status: Not Produced."
189
+
190
+ ## Bad examples
191
+ - "Show 4 products in a grid." — no lighting, layout, scale.
192
+
193
+ ## User-facing response template
194
+
195
+ ```txt
196
+ Product list: <count + per-product list>
197
+ Scale normalization: <normalized bounding box / true relative scale / split into separate grids>
198
+ Grid layout: <rows × cols> | spacing <value> | aspect <ratio>
199
+ Consistency: <strict / loose>
200
+ Shared palette: <colors + surface tones>
201
+ Shared lighting: <plain-language lighting plan>
202
+ Shared background: <type + tone>
203
+ Per-cell camera: <angle> | <distance> | <framing>
204
+ Caption / label space: <location + proportion>
205
+ Mood + style: <line>
206
+ Assumptions register: <explicit assumptions to confirm>
207
+
208
+ Assets to discover: <per-product rows for asset-discovery>
209
+ Runtime status: Not Run
210
+ Artifact status: Not Produced
211
+ Evidence used: <links, paths, logs, or "none">
212
+ Limitations: <known gaps>
213
+ Next: asset-discovery | output-format-decision | composition-quality-checker | lighting-quality-checker | material-quality-checker | scene-readiness | acceptance-criteria-builder | done-criteria
214
+ ```
215
+
216
+ ## Anti-patterns
217
+ - Per-cell separate lighting setups (breaks uniformity).
218
+ - Mixed-scale products without normalization.
219
+ - Background clashing with products.
220
+ - Skipping caption space when downstream layout needs it.
221
+
222
+ ## Cross-skill handoff
223
+ <!-- blendops:generated:start handoffs -->
224
+ - [upstream_reference] Upstream brief → `../intent-to-3d-brief-writer/SKILL.md`
225
+ - [upstream_reference] Single hero product alternative → `../product-hero-scene-planner/SKILL.md`
226
+ - [upstream_reference] Asset discovery → `../asset-discovery/SKILL.md`
227
+ - [progression] Variant / SKU file output format → `../output-format-decision/SKILL.md`
228
+ - [progression] Composition validation → `../composition-quality-checker/SKILL.md`
229
+ - [progression] Lighting validation → `../lighting-quality-checker/SKILL.md`
230
+ - [progression] Material validation → `../material-quality-checker/SKILL.md`
231
+ - [progression] Overall scene quality validation → `../scene-readiness/SKILL.md`
232
+ - [upstream_reference] Catalog sign-off & stop conditions (acceptance-criteria-builder) → `../acceptance-criteria-builder/SKILL.md`
233
+ - [upstream_reference] Catalog sign-off & stop conditions (done-criteria) → `../done-criteria/SKILL.md`
234
+ <!-- blendops:generated:end handoffs -->
235
+
236
+ ## Non-goals
237
+ - Model the products.
238
+ - Source the products.
239
+ - Render.
240
+ - Run Blender.
241
+
242
+ ## References
243
+ - `references/grid-layout-rules.md`
244
+ - `references/grid-consistency-rules.md`
245
+ - `references/grid-output-naming-rules.md`
246
+ - `../../docs/skill-system.md`
@@ -0,0 +1,257 @@
1
+ {
2
+ "$schema": "../../schemas/skill-contract.schema.json",
3
+ "id": "product-grid-scene-planner",
4
+ "version": "1.0.0",
5
+ "category": "scene-planners",
6
+ "role": "multi-product-catalog-grid-architect",
7
+ "purpose": "Plan a multi-product grid scene (e-commerce, catalog, comparison) before any modeling or render attempt; consistent lighting, camera, and grid spacing.",
8
+ "capabilityTier": "L0",
9
+ "triggers": [
10
+ "grid of products",
11
+ "lineup of",
12
+ "catalog showing N items",
13
+ "comparison render"
14
+ ],
15
+ "exclusions": [
16
+ {
17
+ "condition": "single product hero",
18
+ "delegateTo": "product-hero-scene-planner",
19
+ "reason": "use product-hero-scene-planner"
20
+ },
21
+ {
22
+ "condition": "character portrait",
23
+ "delegateTo": "character-portrait",
24
+ "reason": "use character-portrait"
25
+ },
26
+ {
27
+ "condition": "outdoor environment scene",
28
+ "delegateTo": "environment-shot",
29
+ "reason": "use environment-shot"
30
+ },
31
+ {
32
+ "condition": "interior room scene",
33
+ "delegateTo": "interior-scene",
34
+ "reason": "use interior-scene"
35
+ }
36
+ ],
37
+ "inputs": {
38
+ "required": [
39
+ {
40
+ "name": "locked_3d_brief",
41
+ "type": "object",
42
+ "description": "Locked 3D brief specifying product lineup count, grid rows/columns, and comparison goal"
43
+ },
44
+ {
45
+ "name": "product_variant_inventory",
46
+ "type": "array",
47
+ "description": "List of product SKUs or variants with real-world dimensions for relative scale normalization"
48
+ }
49
+ ],
50
+ "optional": [
51
+ {
52
+ "name": "catalog_aspect_and_margin_rules",
53
+ "type": "object",
54
+ "description": "Optional e-commerce card aspect ratio and uniform padding requirements"
55
+ }
56
+ ]
57
+ },
58
+ "outputs": {
59
+ "primary": [
60
+ "multi_product_grid_layout_matrix",
61
+ "scale_normalization_and_spacing_spec",
62
+ "uniform_catalog_camera_and_lighting_hooks"
63
+ ],
64
+ "truthStatePolicy": {
65
+ "runtimeDefault": "Not Run",
66
+ "artifactDefault": "Not Produced",
67
+ "mutationRule": "downgrade_only"
68
+ }
69
+ },
70
+ "handoffs": [
71
+ {
72
+ "target": "intent-to-3d-brief-writer",
73
+ "type": "upstream_reference",
74
+ "label": "Upstream brief",
75
+ "when": {
76
+ "all": [
77
+ {
78
+ "field": "goal.clarity",
79
+ "operator": "equals",
80
+ "value": "clear"
81
+ },
82
+ {
83
+ "field": "brief.locked",
84
+ "operator": "equals",
85
+ "value": false
86
+ }
87
+ ]
88
+ }
89
+ },
90
+ {
91
+ "target": "product-hero-scene-planner",
92
+ "type": "upstream_reference",
93
+ "label": "Single hero product alternative",
94
+ "when": {
95
+ "all": [
96
+ {
97
+ "field": "brief.locked",
98
+ "operator": "equals",
99
+ "value": true
100
+ },
101
+ {
102
+ "field": "recipe.domain",
103
+ "operator": "equals",
104
+ "value": "product_hero"
105
+ }
106
+ ]
107
+ }
108
+ },
109
+ {
110
+ "target": "asset-discovery",
111
+ "type": "upstream_reference",
112
+ "label": "Asset discovery",
113
+ "when": {
114
+ "all": [
115
+ {
116
+ "field": "brief.locked",
117
+ "operator": "equals",
118
+ "value": true
119
+ },
120
+ {
121
+ "field": "assets.discoveryComplete",
122
+ "operator": "equals",
123
+ "value": false
124
+ }
125
+ ]
126
+ }
127
+ },
128
+ {
129
+ "target": "output-format-decision",
130
+ "type": "progression",
131
+ "label": "Variant / SKU file output format",
132
+ "when": {
133
+ "all": [
134
+ {
135
+ "field": "decision.formatLocked",
136
+ "operator": "equals",
137
+ "value": false
138
+ }
139
+ ]
140
+ }
141
+ },
142
+ {
143
+ "target": "composition-quality-checker",
144
+ "type": "progression",
145
+ "label": "Composition validation",
146
+ "when": {
147
+ "all": [
148
+ {
149
+ "field": "quality.domain",
150
+ "operator": "equals",
151
+ "value": "composition"
152
+ },
153
+ {
154
+ "field": "quality.verdict",
155
+ "operator": "equals",
156
+ "value": "not_run"
157
+ }
158
+ ]
159
+ }
160
+ },
161
+ {
162
+ "target": "lighting-quality-checker",
163
+ "type": "progression",
164
+ "label": "Lighting validation",
165
+ "when": {
166
+ "all": [
167
+ {
168
+ "field": "quality.domain",
169
+ "operator": "equals",
170
+ "value": "lighting"
171
+ },
172
+ {
173
+ "field": "quality.verdict",
174
+ "operator": "equals",
175
+ "value": "not_run"
176
+ }
177
+ ]
178
+ }
179
+ },
180
+ {
181
+ "target": "material-quality-checker",
182
+ "type": "progression",
183
+ "label": "Material validation",
184
+ "when": {
185
+ "all": [
186
+ {
187
+ "field": "quality.domain",
188
+ "operator": "equals",
189
+ "value": "material"
190
+ },
191
+ {
192
+ "field": "quality.verdict",
193
+ "operator": "equals",
194
+ "value": "not_run"
195
+ }
196
+ ]
197
+ }
198
+ },
199
+ {
200
+ "target": "scene-readiness",
201
+ "type": "progression",
202
+ "label": "Overall scene quality validation",
203
+ "when": {
204
+ "all": [
205
+ {
206
+ "field": "quality.domain",
207
+ "operator": "equals",
208
+ "value": "holistic"
209
+ },
210
+ {
211
+ "field": "stage.current",
212
+ "operator": "equals",
213
+ "value": "quality_validation"
214
+ }
215
+ ]
216
+ }
217
+ },
218
+ {
219
+ "target": "acceptance-criteria-builder",
220
+ "type": "upstream_reference",
221
+ "label": "Catalog sign-off & stop conditions (acceptance-criteria-builder)",
222
+ "when": {
223
+ "all": [
224
+ {
225
+ "field": "brief.locked",
226
+ "operator": "equals",
227
+ "value": true
228
+ },
229
+ {
230
+ "field": "stage.current",
231
+ "operator": "equals",
232
+ "value": "acceptance_criteria"
233
+ }
234
+ ]
235
+ }
236
+ },
237
+ {
238
+ "target": "done-criteria",
239
+ "type": "upstream_reference",
240
+ "label": "Catalog sign-off & stop conditions (done-criteria)",
241
+ "when": {
242
+ "all": [
243
+ {
244
+ "field": "brief.locked",
245
+ "operator": "equals",
246
+ "value": true
247
+ },
248
+ {
249
+ "field": "stage.current",
250
+ "operator": "equals",
251
+ "value": "stop_condition"
252
+ }
253
+ ]
254
+ }
255
+ }
256
+ ]
257
+ }
@@ -0,0 +1,53 @@
1
+ # Grid consistency rules
2
+
3
+ ## What to keep identical across cells
4
+
5
+ - Camera focal length
6
+ - Camera distance to product
7
+ - Camera angle (yaw / pitch / roll)
8
+ - Lighting rig (key + fill + rim positions and strengths)
9
+ - Background color / material
10
+ - Material color space + render settings
11
+ - Render engine + samples
12
+
13
+ ## What can vary across cells
14
+
15
+ - Product (the obvious one)
16
+ - Per-product material color / variant (if intentional)
17
+ - Minor scale variation if products are inherently different sizes (handle by camera distance, not by cell variation)
18
+
19
+ ## What must NOT vary
20
+
21
+ - Light direction relative to camera
22
+ - Background tone
23
+ - Color management settings
24
+ - Render samples / quality
25
+
26
+ ## Strict vs loose consistency
27
+
28
+ | Mode | Use case |
29
+ |---|---|
30
+ | Strict | E-commerce / catalog (everything identical) |
31
+ | Loose | Editorial spread (minor variation OK; flag explicitly) |
32
+
33
+ ## How to verify
34
+
35
+ After render, inspect each cell at full resolution side-by-side. Differences in:
36
+ - product color → likely material variant or color management mismatch.
37
+ - shadow direction → lighting drift.
38
+ - background tone → background drift.
39
+ - product silhouette → camera drift.
40
+
41
+ Each of these indicates a consistency failure.
42
+
43
+ ## Single-render vs separate-renders
44
+
45
+ | Approach | Pros | Cons |
46
+ |---|---|---|
47
+ | Single render of whole grid | Guaranteed consistency | High memory if many products |
48
+ | Separate render per product, composited | Lower memory; per-product re-render easy | Risk of inconsistency between renders |
49
+
50
+ Recommend single render unless memory forces split.
51
+
52
+ ## Related skill
53
+ `../SKILL.md`
@@ -0,0 +1,42 @@
1
+ # Grid layout rules
2
+
3
+ ## Standard layouts
4
+
5
+ | Layout | Use case |
6
+ |---|---|
7
+ | 1×N (strip) | Comparison / variant lineup |
8
+ | 2×N (rows of 2) | E-commerce hero |
9
+ | 3×N (rows of 3) | Catalog page |
10
+ | 4×N (rows of 4) | Dense catalog |
11
+ | Square (N×N) | Social / editorial |
12
+
13
+ ## Aspect-friendly layouts
14
+
15
+ | Aspect | Recommended grids |
16
+ |---|---|
17
+ | 16:9 | 1×4, 2×3, 2×4 |
18
+ | 1:1 | 2×2, 3×3, 4×4 |
19
+ | 9:16 | 4×1, 6×1, 3×2 |
20
+ | 2.39:1 | 1×4, 1×5, 1×6 |
21
+
22
+ ## Spacing
23
+
24
+ - 0.3–0.5m between products at world scale (for medium products).
25
+ - Equal spacing both axes; do not vary horizontal vs vertical without intent.
26
+ - Avoid spacing < 0.1m → products read as overlapping.
27
+
28
+ ## Cell size consistency
29
+
30
+ - Each cell must have the same world-space dimensions.
31
+ - Each product centered in its cell.
32
+ - Different product silhouettes must still fit; size cell to largest product silhouette.
33
+
34
+ ## Common failures
35
+
36
+ - Variable spacing → reads as misaligned.
37
+ - Cells different sizes → reads as catalog error.
38
+ - Products not centered in cells → grid feels broken.
39
+ - Too many products in one render (> 9) → consider multi-page.
40
+
41
+ ## Related skill
42
+ `../SKILL.md`
@@ -0,0 +1,52 @@
1
+ # Grid output naming + export rules
2
+
3
+ ## File naming convention
4
+
5
+ For multi-product grids, use a consistent name pattern:
6
+
7
+ ```
8
+ <product-line>-grid-<NxN>-<aspect>-<YYYY-MM-DD>.png
9
+ ```
10
+
11
+ Examples:
12
+ - `sneakers-grid-2x2-16-9-2026-05-09.png`
13
+ - `mugs-catalog-3x3-1-1-2026-05-09.png`
14
+
15
+ ## Per-cell exports (optional)
16
+
17
+ If downstream layout requires per-cell separate images:
18
+
19
+ ```
20
+ <product-line>-cell-<row>-<col>-<sku>-<YYYY-MM-DD>.png
21
+ ```
22
+
23
+ Example:
24
+ - `sneakers-cell-1-1-sku-001-2026-05-09.png`
25
+
26
+ ## Caption / label rendering
27
+
28
+ Captions are typically added in downstream layout (Figma / Sketch / CSS), not baked into the render. Reserve consistent space per cell for captions:
29
+
30
+ | Aspect | Caption space |
31
+ |---|---|
32
+ | 16:9 | Lower 15% of cell |
33
+ | 1:1 | Lower 20% of cell |
34
+ | 9:16 | Lower 25% of cell |
35
+
36
+ ## Resolution per render
37
+
38
+ Render at the consumer's required resolution × 1.5 (for downscale-quality margin):
39
+ - 16:9 web hero → 2880×1620 (renders to 1920×1080)
40
+ - Square social → 2160×2160 (renders to 1440×1440)
41
+
42
+ Always document the rendered resolution and target resolution in the export evidence.
43
+
44
+ ## glTF / GLB grid handoff (rare)
45
+
46
+ Multi-product grids rarely export as a single GLB; usually they are 2D renders. If a grid GLB is requested:
47
+ - Each product as a separate glTF node.
48
+ - Shared parent node for the grid arrangement.
49
+ - Document scale + grid arrangement in handoff.
50
+
51
+ ## Related skill
52
+ `../SKILL.md`
@@ -0,0 +1,33 @@
1
+ # EVAL — product-hero-scene-planner
2
+
3
+ ## Text-only eval prompt
4
+ Use product-hero-scene-planner to create a full cyberpunk shoe hero scene plan without runtime execution.
5
+
6
+ ## Expected behavior
7
+ - complete scene plan schema
8
+ - clarification questions when needed
9
+ - assumptions and caveats explicit
10
+
11
+ ## Pass / Warn / Fail criteria
12
+ - Pass: all plan sections + no runtime overclaims
13
+ - Warn: minor section gaps with caveats
14
+ - Fail: major sections missing or artifact claims without evidence
15
+
16
+ ## Common failure modes
17
+ - shallow 3-step plan
18
+ - no assumptions policy
19
+
20
+ ## Evidence expectations
21
+ - plan sections listed
22
+ - unresolved assumptions listed
23
+ - runtime status marked Not Run in text-only mode
24
+
25
+ ## Sample passing response outline
26
+ - Scope and mode stated clearly
27
+ - Evidence expectations listed
28
+ - Pass/warn/fail reasoning tied to checks
29
+
30
+ ## Sample failing response outline
31
+ - Overclaims runtime/artifact success
32
+ - Missing caveats or blocker details
33
+ - No clear next action