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,238 @@
1
+ ---
2
+ name: intent-to-3d-brief-writer
3
+ description: Convert a non-Blender-user's natural-language request into a structured 3D brief (subject, mood, deliverables, constraints, evidence expectations). Use as first step before any planner.
4
+ ---
5
+
6
+ # intent-to-3d-brief-writer
7
+
8
+ ## Purpose
9
+
10
+ Translate a confirmed user intent (from `blender-brainstorming` or a clear initial request) into a structured 3D brief that downstream planners and `acceptance-criteria-builder` can consume without re-asking. Inspired by the "Analysis phase" pattern in BMad-Method (PRD / project brief), adapted for 3D scene work and non-Blender users.
11
+
12
+ This skill produces **a brief, not a plan**. The brief has 8 fixed slots: subject, mood, deliverables, constraints, evidence expectations, acceptance criteria, audience, and owner. Planners consume the brief; they do not negotiate with it.
13
+
14
+ ## Quick start
15
+
16
+ - read confirmed intent from prior step (`blender-brainstorming` or original request)
17
+ - fill the 8 brief slots (mark unconfirmed items as `Unknown`, never invent)
18
+ - echo the brief to the user for confirmation
19
+ - hand off to downstream planners (e.g., `product-hero-scene-planner`) and `acceptance-criteria-builder` once confirmed
20
+
21
+ ## When to use
22
+
23
+ - right after `blender-brainstorming` confirms user intent
24
+ - when the user provides a structured request that just needs format normalization
25
+ - before any planner skill (`product-hero-scene-planner`, `camera-composition`, `lighting-material-plan`)
26
+ - before `acceptance-criteria-builder` consumes brief rows to build criteria
27
+ - when multiple planners need to share the same source-of-truth brief
28
+
29
+ ## When not to use
30
+ <!-- blendops:generated:start exclusions -->
31
+ - intent is still ambiguous (run blender-brainstorming first) → use `../blender-brainstorming/SKILL.md` (run blender-brainstorming first)
32
+ - the user is mid-execution and asks for a re-brief → use `../blender-troubleshooting/SKILL.md` (route to blender-troubleshooting instead)
33
+ - the user pushes for immediate execution → use `../runtime-readiness/SKILL.md` (route to runtime-readiness)
34
+ - the request is iteration on existing output ("make it darker") — that's a planner-level edit, not a new brief → use `../blender-brainstorming/SKILL.md` (Delegates out-of-scope requests to blender-brainstorming)
35
+ <!-- blendops:generated:end exclusions -->
36
+
37
+ ## Trigger phrases
38
+ <!-- blendops:generated:start triggers -->
39
+ - "lock the brief"
40
+ - "write the brief from this conversation"
41
+ - "what's the formal scope?"
42
+ - "before planning, write the spec"
43
+ <!-- blendops:generated:end triggers -->
44
+
45
+ ## Prerequisites / readiness
46
+
47
+ - confirmed intent from prior step
48
+ - no Blender runtime required
49
+ - works in text-only mode
50
+
51
+ ## Input schema
52
+
53
+ ### Required inputs
54
+
55
+ - confirmed intent paragraph (from brainstorming or user)
56
+ - target deliverable type (image / GLB / web hero / iteration loop / docs)
57
+ - audience (non-Blender-technical user / mixed / technical-OK)
58
+
59
+ ### Optional inputs
60
+
61
+ - brand / mood / reference notes
62
+ - performance / time / scope constraints
63
+ - prior similar briefs to match style
64
+
65
+ ### Assumptions to confirm
66
+
67
+ - the user accepts a structured brief format
68
+ - the brief slots are exhaustive (subject, mood, deliverables, constraints, evidence, acceptance, audience, owner)
69
+ - runtime status is `Not Run` and may stay so
70
+
71
+ ## Output schema
72
+
73
+ ### Primary output — the 8-slot brief
74
+
75
+ ```md
76
+ # 3D Brief: <short title>
77
+
78
+ 1. Subject. <what the scene is about>
79
+ 2. Mood / style. <visual mood, tone, references>
80
+ 3. Deliverables. <render image / GLB / preview / response>
81
+ 4. Constraints. <performance, scope, time, brand>
82
+ 5. Evidence expectations. <which truth labels acceptable; required evidence fields>
83
+ 6. Acceptance criteria. <how we know the deliverable matches intent>
84
+ 7. Audience. <who reads the final response>
85
+ 8. Owner. <who runs and verifies>
86
+ ```
87
+
88
+ ### Secondary output
89
+
90
+ * list of decisions explicitly deferred to planners
91
+ * explicit unknowns flagged
92
+
93
+ ### Evidence / caveat output
94
+
95
+ * runtime status: `Not Run` (downgrade-only, never upgrade)
96
+ * artifact status: `Not Produced` (downgrade-only, never upgrade)
97
+ * brief is a contract; planners should not silently expand scope
98
+
99
+ ## Required laws
100
+
101
+ - ../../laws/non-blender-user-language.md
102
+ - ../../laws/evidence-before-done.md
103
+ - ../../laws/no-arbitrary-python-interface.md
104
+ - ../../laws/official-runtime-only.md
105
+
106
+ ## Official runtime boundary
107
+
108
+ This skill does not install Blender, run Blender, configure MCP, or claim artifacts. Output is a structured text brief.
109
+
110
+ ## Operating procedure
111
+
112
+ 1. Read confirmed intent (from `blender-brainstorming` or original request).
113
+ 2. Pull each of the 8 slots one at a time. If a slot is missing, ask one targeted question per missing slot in a single batch.
114
+ 3. Write the brief in markdown using the 8-slot template.
115
+ 4. List decisions deferred to planners (e.g. "lighting style left to `lighting-material-plan` per mood").
116
+ 5. Echo the brief to the user. Ask for confirm or edit.
117
+ 6. After confirmation, hand off to the relevant planner (e.g., `product-hero-scene-planner`) and `acceptance-criteria-builder`.
118
+
119
+ ## Decision tree
120
+
121
+ - intent is fully covered by 8 slots → write brief, no questions
122
+ - 1-3 slots missing → batch missing-slot questions, then write
123
+ - 4+ slots missing → route back to `blender-brainstorming` (intent isn't actually confirmed)
124
+ - audience is mixed (technical + non-technical) → write twice (one technical paragraph, one plain-language) — but final user-facing response always plain-language
125
+
126
+ ## Playbooks
127
+
128
+ - Playbook A: "Product hero brief" — subject = product, mood = brand-aligned, deliverable = render + GLB, audience = marketing team
129
+ - Playbook B: "Web hero brief" — deliverable = GLB + preview image, constraint = poly budget for web
130
+ - Playbook C: "Iteration loop brief" — deliverable = text-only plan first, runtime later
131
+ - Playbook D: "Mixed audience brief" — write technical + plain-language sections
132
+
133
+ ## Mode handling
134
+
135
+ ### Text-only mode
136
+
137
+ - text only, no runtime calls
138
+ - runtime status: `Not Run` (downgrade-only, never upgrade)
139
+ - artifact status: `Not Produced` (downgrade-only, never upgrade)
140
+
141
+ ### Runtime-ready mode
142
+
143
+ - still text-only for this skill (brief is always text)
144
+ - runtime status remains `Not Run`
145
+ - execution pushes route to `runtime-readiness`
146
+
147
+ ### Blocked runtime mode
148
+
149
+ - still produces brief
150
+ - adds explicit note that downstream planning may be blocked too
151
+ - runtime status remains `Not Run`
152
+
153
+ ## Validation checklist
154
+
155
+ - [ ] all 8 slots filled or marked `Unknown` explicitly
156
+ - [ ] subject is non-jargon plain language
157
+ - [ ] deliverables list is exhaustive (no implicit "and other things")
158
+ - [ ] evidence expectations name truth labels
159
+ - [ ] acceptance criteria observable, not subjective
160
+ - [ ] audience is named explicitly
161
+ - [ ] owner is named (operator / agent / human)
162
+ - [ ] decisions deferred listed
163
+ - [ ] runtime status remains `Not Run`
164
+ - [ ] no Blender jargon in user-facing brief
165
+
166
+ ## Pass / Warn / Fail rubric
167
+
168
+ | Category | Pass | Warn | Fail |
169
+ |---|---|---|---|
170
+ | Slot coverage | All 8 filled or `Unknown` | 1-2 slots missing without note | 3+ slots missing |
171
+ | Plain language | No jargon | Minor jargon explained | Jargon-heavy |
172
+ | Acceptance criteria | Observable | Partly subjective | Fully subjective |
173
+ | Confirmation | User reviewed and confirmed | Echoed but not confirmed | Not echoed |
174
+
175
+ ## Failure handling
176
+
177
+ - user changes intent mid-brief: pause, mark intent as not-confirmed, route back to `blender-brainstorming`
178
+ - conflicting deliverables (e.g. "GLB and 50MB poly budget"): flag conflict in slot 4, ask user to resolve
179
+ - user wants the brief to skip slots: explicit `Unknown` markers, never invent
180
+
181
+ ## Troubleshooting
182
+
183
+ - if the brief feels too long, write a "TL;DR" line at top but keep all 8 slots
184
+ - if the user pushes for execution, route to `runtime-readiness`; brief stays as locked contract
185
+ - if the user requests mid-execution re-briefing, route to `blender-troubleshooting`
186
+
187
+ ## Best practices
188
+
189
+ - 8 slots, every time, every brief
190
+ - echo the brief to the user before handoff
191
+ - name the owner explicitly; ambiguity here breaks accountability
192
+
193
+ ## Good examples
194
+
195
+ - "Brief: Cyberpunk Shoe Web Hero. Subject: floating cyberpunk sneaker. Mood: neon-lit, glossy dark floor, dramatic. Deliverables: preview image + GLB for web. Constraints: poly budget for mobile web; brand neon palette. Evidence: `Verified` requires render path + GLB path + validation notes. Acceptance: subject framing centered, neon visible, web GLB ≤ 10MB. Audience: marketing team (non-Blender). Owner: <user>. Deferred: exact lighting placement to `lighting-material-plan`; exact camera angle to `camera-composition`."
196
+
197
+ ## Bad examples
198
+
199
+ - "Brief: shoe render. Make it cool. Hand off to planner." (5 slots missing, jargon-leaning, no acceptance criteria, no owner)
200
+
201
+ ## User-facing response template
202
+
203
+ - One-line TL;DR
204
+ - 8-slot structured brief in markdown
205
+ - Decisions deferred to planners
206
+ - Confirmation prompt: "echo back any edits or confirm to proceed"
207
+
208
+ ## Anti-patterns
209
+
210
+ - writing a brief without echoing to user
211
+ - inventing slots that weren't confirmed (especially mood and constraints)
212
+ - letting planners re-negotiate the brief after handoff
213
+ - using Blender jargon
214
+
215
+ ## Cross-skill handoff
216
+ <!-- blendops:generated:start handoffs -->
217
+ - [upstream_reference] Preceding step → `../blender-brainstorming/SKILL.md`
218
+ - [progression] Consuming skills (acceptance-criteria-builder) → `../acceptance-criteria-builder/SKILL.md`
219
+ - [progression] Consuming skills (camera-composition) → `../camera-composition/SKILL.md`
220
+ - [progression] Consuming skills (lighting-material-plan) → `../lighting-material-plan/SKILL.md`
221
+ - [alternative] Consuming skills (product-hero-scene-planner) → `../product-hero-scene-planner/SKILL.md`
222
+ - [conditional] If execution is requested → `../runtime-readiness/SKILL.md`
223
+ - [fallback] If mid-execution re-briefing occurs → `../blender-troubleshooting/SKILL.md`
224
+ <!-- blendops:generated:end handoffs -->
225
+
226
+ ## Non-goals
227
+
228
+ - making the plan (planner's job)
229
+ - running Blender
230
+ - setting up runtime
231
+ - writing the final user response (`plain-language-response`'s job)
232
+
233
+ ## References
234
+
235
+ - Inspired by BMad-Method "Analysis phase" pattern (https://docs.bmad-method.org/reference/commands/)
236
+ - BlendOps law: ../../laws/non-blender-user-language.md
237
+ - BlendOps law: ../../laws/evidence-before-done.md
238
+ - Skill system: ../../docs/skill-system.md
@@ -0,0 +1,195 @@
1
+ {
2
+ "$schema": "../../schemas/skill-contract.schema.json",
3
+ "id": "intent-to-3d-brief-writer",
4
+ "version": "1.0.0",
5
+ "category": "process-discipline",
6
+ "role": "canonical-8-slot-brief-author",
7
+ "purpose": "Convert a non-Blender-user's natural-language request into a structured 3D brief (subject, mood, deliverables, constraints, evidence expectations). Use as first step before any planner.",
8
+ "capabilityTier": "L0",
9
+ "triggers": [
10
+ "lock the brief",
11
+ "write the brief from this conversation",
12
+ "what's the formal scope?",
13
+ "before planning, write the spec"
14
+ ],
15
+ "exclusions": [
16
+ {
17
+ "condition": "intent is still ambiguous (run blender-brainstorming first)",
18
+ "delegateTo": "blender-brainstorming",
19
+ "reason": "run blender-brainstorming first"
20
+ },
21
+ {
22
+ "condition": "the user is mid-execution and asks for a re-brief",
23
+ "delegateTo": "blender-troubleshooting",
24
+ "reason": "route to blender-troubleshooting instead"
25
+ },
26
+ {
27
+ "condition": "the user pushes for immediate execution",
28
+ "delegateTo": "runtime-readiness",
29
+ "reason": "route to runtime-readiness"
30
+ },
31
+ {
32
+ "condition": "the request is iteration on existing output (\"make it darker\") — that's a planner-level edit, not a new brief",
33
+ "delegateTo": "blender-brainstorming",
34
+ "reason": "Delegates out-of-scope requests to blender-brainstorming"
35
+ }
36
+ ],
37
+ "inputs": {
38
+ "required": [
39
+ {
40
+ "name": "raw_user_goal_and_context",
41
+ "type": "string",
42
+ "description": "User request or brainstormed concept to lock into the canonical 8-slot 3D brief"
43
+ },
44
+ {
45
+ "name": "target_deliverable_surface",
46
+ "type": "string",
47
+ "description": "Intended output format (hero still, product grid, portrait, environment, interior, or web GLB)"
48
+ }
49
+ ],
50
+ "optional": [
51
+ {
52
+ "name": "selected_recipe_or_pack",
53
+ "type": "string",
54
+ "description": "Recipe or pack selected via recipe-fit-assessor"
55
+ }
56
+ ]
57
+ },
58
+ "outputs": {
59
+ "primary": [
60
+ "canonical_8_slot_3d_brief",
61
+ "explicit_assumptions_register",
62
+ "scope_exclusions_and_next_skill"
63
+ ],
64
+ "truthStatePolicy": {
65
+ "runtimeDefault": "Not Run",
66
+ "artifactDefault": "Not Produced",
67
+ "mutationRule": "downgrade_only"
68
+ }
69
+ },
70
+ "handoffs": [
71
+ {
72
+ "target": "blender-brainstorming",
73
+ "type": "upstream_reference",
74
+ "label": "Preceding step",
75
+ "when": {
76
+ "all": [
77
+ {
78
+ "field": "goal.clarity",
79
+ "operator": "equals",
80
+ "value": "ambiguous_or_mixed"
81
+ }
82
+ ]
83
+ }
84
+ },
85
+ {
86
+ "target": "acceptance-criteria-builder",
87
+ "type": "progression",
88
+ "label": "Consuming skills (acceptance-criteria-builder)",
89
+ "when": {
90
+ "all": [
91
+ {
92
+ "field": "brief.locked",
93
+ "operator": "equals",
94
+ "value": true
95
+ },
96
+ {
97
+ "field": "stage.current",
98
+ "operator": "equals",
99
+ "value": "acceptance_criteria"
100
+ }
101
+ ]
102
+ }
103
+ },
104
+ {
105
+ "target": "camera-composition",
106
+ "type": "progression",
107
+ "label": "Consuming skills (camera-composition)",
108
+ "when": {
109
+ "all": [
110
+ {
111
+ "field": "brief.locked",
112
+ "operator": "equals",
113
+ "value": true
114
+ },
115
+ {
116
+ "field": "stage.current",
117
+ "operator": "equals",
118
+ "value": "camera_planning"
119
+ }
120
+ ]
121
+ }
122
+ },
123
+ {
124
+ "target": "lighting-material-plan",
125
+ "type": "progression",
126
+ "label": "Consuming skills (lighting-material-plan)",
127
+ "when": {
128
+ "all": [
129
+ {
130
+ "field": "brief.locked",
131
+ "operator": "equals",
132
+ "value": true
133
+ },
134
+ {
135
+ "field": "stage.current",
136
+ "operator": "equals",
137
+ "value": "lookdev_planning"
138
+ }
139
+ ]
140
+ }
141
+ },
142
+ {
143
+ "target": "product-hero-scene-planner",
144
+ "type": "alternative",
145
+ "label": "Consuming skills (product-hero-scene-planner)",
146
+ "when": {
147
+ "all": [
148
+ {
149
+ "field": "brief.locked",
150
+ "operator": "equals",
151
+ "value": true
152
+ },
153
+ {
154
+ "field": "recipe.domain",
155
+ "operator": "equals",
156
+ "value": "product_hero"
157
+ }
158
+ ]
159
+ }
160
+ },
161
+ {
162
+ "target": "runtime-readiness",
163
+ "type": "conditional",
164
+ "label": "If execution is requested",
165
+ "when": {
166
+ "all": [
167
+ {
168
+ "field": "runtime.path",
169
+ "operator": "not_equals",
170
+ "value": "unselected"
171
+ },
172
+ {
173
+ "field": "runtime.verifiedReady",
174
+ "operator": "equals",
175
+ "value": false
176
+ }
177
+ ]
178
+ }
179
+ },
180
+ {
181
+ "target": "blender-troubleshooting",
182
+ "type": "fallback",
183
+ "label": "If mid-execution re-briefing occurs",
184
+ "when": {
185
+ "all": [
186
+ {
187
+ "field": "runtime.errorDetected",
188
+ "operator": "equals",
189
+ "value": true
190
+ }
191
+ ]
192
+ }
193
+ }
194
+ ]
195
+ }
@@ -0,0 +1,46 @@
1
+ # Acceptance Criteria Patterns
2
+
3
+ Slot 6 of the brief must be **observable**, not subjective. This file gives the patterns to use.
4
+
5
+ ## Observable vs. subjective
6
+
7
+ | ❌ Subjective (rejected) | ✅ Observable (accepted) |
8
+ |---|---|
9
+ | "looks good" | "subject visible from primary camera, no occlusion" |
10
+ | "feels cyberpunk" | "neon rim light visible on subject, color from defined palette" |
11
+ | "high quality" | "render at 1920×1080, no NaN pixels, exposure within ±1 stop of reference" |
12
+ | "right mood" | "mood reference image attached, primary camera angle within 15° of reference" |
13
+ | "correct scale" | "GLB unit = meters, hero subject between 0.2m and 0.4m bounding box" |
14
+ | "small enough for web" | "GLB ≤ 10MB on disk after compression" |
15
+ | "loads fast" | "GLB First Contentful Paint ≤ 2.5s on mid-tier mobile (defined as Pixel 6a or equivalent)" |
16
+ | "ready to ship" | (use the 7-point gate in `pre-handoff-verification` instead) |
17
+
18
+ ## Pattern: numeric thresholds
19
+
20
+ Whenever possible, attach a number:
21
+
22
+ - File size: `≤ 10MB`, `≤ 2K poly`
23
+ - Time: `render ≤ 60s on M3 Pro`, `web load ≤ 2.5s`
24
+ - Color: `primary hue within ΔE 5 of reference`
25
+ - Position: `subject center within 5% of frame center`
26
+
27
+ ## Pattern: reference-image comparison
28
+
29
+ When numeric thresholds don't fit:
30
+
31
+ - "Mood reference: `references/cyberpunk-shoe-mood.png`. Render must visually match within human-judged 'same brand mood'."
32
+ - Note: human judgment is acceptable as long as it's a single named reviewer, not a team consensus.
33
+
34
+ ## Pattern: tool-output-based
35
+
36
+ When validation depends on a downstream tool:
37
+
38
+ - "GLB passes `gltf-validator` with 0 errors, ≤ 3 warnings."
39
+ - "Render passes the `scene-readiness` rubric with verdict Pass."
40
+ - "Web import test (operator-defined): asset visible in Three.js viewer, no console errors."
41
+
42
+ ## Anti-patterns
43
+
44
+ - "I'll know it when I see it" — not observable. Rejected.
45
+ - "Marketing team is happy" — too many reviewers, not observable per artifact. Rejected.
46
+ - "Better than the last one" — comparative without baseline reference. Rejected.
@@ -0,0 +1,123 @@
1
+ # 8-Slot Brief Template
2
+
3
+ Use this exact template for every brief. Fill or mark `Unknown` per slot. The brief is a contract; planners do not silently expand or contract scope.
4
+
5
+ ## Template
6
+
7
+ ```md
8
+ # 3D Brief: <short title>
9
+
10
+ > TL;DR (one line): <one-sentence summary>
11
+
12
+ ## 1. Subject
13
+
14
+ <what the scene is about — plain language, no Blender jargon>
15
+ - Reference images / target silhouette: <URL/file paths if provided, or `Unknown`>
16
+ - Approximate real-world scale & orientation: <metric bounds if known; default ground Z = 0, facing -Y>
17
+
18
+ ## 2. Mood / style
19
+
20
+ <tone, references, brand notes>
21
+
22
+ ## 3. Deliverables
23
+
24
+ - <render image / GLB for web / preview / response> (be exhaustive — no implicit "and other things")
25
+
26
+ ## 4. Constraints
27
+
28
+ - <performance budget, time, scope, brand restrictions, license>
29
+
30
+ ## 5. Evidence expectations
31
+
32
+ - Acceptable truth labels: <`Not Run` / `Attempted` / `Produced` / `Verified` / `Failed`>
33
+ - Required evidence fields per claim: <list>
34
+
35
+ ## 6. Acceptance criteria
36
+
37
+ - <observable, not subjective — the planner / operator can prove pass/fail>
38
+
39
+ ## 7. Audience
40
+
41
+ <marketing team / tech artist / non-Blender-technical user / mixed>
42
+
43
+ ## 8. Owner
44
+
45
+ <operator / agent / human reviewer — who runs and verifies>
46
+
47
+ ---
48
+
49
+ ## Decisions deferred
50
+
51
+ | Decision | Deferred to skill |
52
+ |---|---|
53
+ | <e.g. exact lighting placement> | `lighting-material-plan` |
54
+ | <e.g. exact camera focal length> | `camera-composition` |
55
+ | <e.g. material portability for web> | `lighting-material-plan` |
56
+
57
+ ## Unknowns
58
+
59
+ - <list of `Unknown` slots with why they are not yet resolved>
60
+
61
+ ## Confirmation
62
+
63
+ - [ ] User has read this brief and confirmed (echo + edit cycle complete)
64
+ - [ ] Runtime status: `Not Run`
65
+ - [ ] Artifact status: `Not Produced`
66
+ ```
67
+
68
+ ## Filled example (cyberpunk shoe web hero)
69
+
70
+ ```md
71
+ # 3D Brief: Cyberpunk Shoe Web Hero
72
+
73
+ > TL;DR: floating cyberpunk sneaker in neon-noir mood, render + GLB for marketing web embed.
74
+
75
+ ## 1. Subject
76
+ A floating sneaker, hero-centered, with subtle motion implied (no full animation).
77
+
78
+ ## 2. Mood / style
79
+ Cyberpunk neon-noir: glossy dark floor, neon accent rim lighting, mid-saturation.
80
+
81
+ ## 3. Deliverables
82
+ - One render image (1920×1080, PNG)
83
+ - One GLB file for web embed (≤ 10MB target)
84
+ - One non-Blender-user response summarizing status
85
+
86
+ ## 4. Constraints
87
+ - Web GLB must load on mid-tier mobile (poly budget tight)
88
+ - Brand neon palette only (no off-brand pinks)
89
+ - License: brand-restricted shoe model OR generative via Path 2
90
+
91
+ ## 5. Evidence expectations
92
+ - Acceptable labels for render: `Verified`
93
+ - Acceptable labels for GLB: `Produced` minimum, `Verified` if web import test passes
94
+ - Required fields: output path, file existence, validation notes per artifact
95
+
96
+ ## 6. Acceptance criteria
97
+ - Subject framing centered with negative space top-left for headline
98
+ - Neon rim lighting visible from primary camera
99
+ - GLB ≤ 10MB
100
+ - GLB opens in target web viewer without errors
101
+
102
+ ## 7. Audience
103
+ Marketing team — non-Blender-technical. Final response must be plain language.
104
+
105
+ ## 8. Owner
106
+ Operator: <user>. Verification by: `pre-handoff-verification` before release.
107
+
108
+ ## Decisions deferred
109
+ | Decision | Deferred to skill |
110
+ |---|---|
111
+ | Exact lighting placement | `lighting-material-plan` |
112
+ | Exact camera focal length and angle | `camera-composition` |
113
+ | Shoe surface material (procedural vs imported PBR) | `lighting-material-plan` |
114
+ | Asset acquisition strategy | `asset-discovery` |
115
+
116
+ ## Unknowns
117
+ - Final shoe model source (brand library vs generative). Decided after asset discovery planner runs.
118
+
119
+ ## Confirmation
120
+ - [x] User confirmed (2026-05-09)
121
+ - Runtime status: `Not Run`
122
+ - Artifact status: `Not Produced`
123
+ ```
@@ -0,0 +1,39 @@
1
+ # Mixed Audience Handling
2
+
3
+ When slot 7 (Audience) lists more than one reader type (e.g. "marketing team + tech artist"), the brief must serve both without compromising plain language for the non-Blender-technical audience.
4
+
5
+ ## Pattern: dual-section brief
6
+
7
+ Write the brief twice in the same file:
8
+
9
+ ```md
10
+ ## 1. Subject
11
+
12
+ ### Plain-language version (for marketing team)
13
+ A floating cyberpunk sneaker, neon-lit, hero-centered.
14
+
15
+ ### Technical version (for tech artist)
16
+ Hero subject = sneaker mesh, ~8K tris budget, hero-centered camera framing,
17
+ neon rim lighting from emission shader, glossy floor with controlled reflections.
18
+ ```
19
+
20
+ Apply this dual format to slots 1, 2, 6 (the slots most affected by audience).
21
+
22
+ For slots 3, 4, 5, 7, 8 — single version is fine, written for the **strictest reader** (usually the technical one).
23
+
24
+ ## Final user-facing response always plain-language
25
+
26
+ Even with a mixed-audience brief:
27
+
28
+ - The **final user-facing response** generated by `plain-language-response` is **always plain-language only**.
29
+ - The technical version of the brief is for planners + the operator, not for the final user-facing response.
30
+
31
+ ## When to split into two briefs
32
+
33
+ If the workflow truly needs two parallel deliverables (e.g. one render for marketing + one technical scene file for the artist's iteration), write **two briefs**, one per audience, with shared scope notes. Do not collapse them into one ambiguous brief.
34
+
35
+ ## Anti-patterns
36
+
37
+ - Writing the brief in technical-only language because the tech artist is in the audience. Always include the plain-language version when any non-Blender-technical reader is in scope.
38
+ - Letting jargon leak into slot 6 (Acceptance criteria). Acceptance criteria are read by the user during confirmation; they must be plain.
39
+ - Forgetting that the final user response is plain-only, regardless of brief audience structure.
@@ -0,0 +1,44 @@
1
+ # EVAL — interior-scene
2
+
3
+ ## Text-only eval prompt
4
+ Use interior-scene on a brief: "modern minimalist living room, 4x6m, afternoon natural light, 16:9 catalog hero".
5
+
6
+ ## Expected behavior
7
+ - Room type / dims / style pinned
8
+ - Architecture basics (walls / floor / ceiling / windows)
9
+ - Furniture + props list
10
+ - Material palette (3-5 colors)
11
+ - Lighting plan (natural + artificial)
12
+ - Camera (lens + position + eye-line + target)
13
+ - Mood + time of day pinned
14
+ - Asset list flagged
15
+ - Handoff named
16
+
17
+ ## Pass / Warn / Fail criteria
18
+ - Pass: full sections + plausible style consistency + assets flagged
19
+ - Warn: one section ambiguous
20
+ - Fail: style + furniture clash, impossible lens, missing lighting plan
21
+
22
+ ## Common failure modes
23
+ - center-of-room camera (loses depth)
24
+ - mixed eras without intent
25
+ - skipping window light
26
+ - inventing dimensions
27
+
28
+ ## Evidence expectations
29
+ - explicit dims + style + palette
30
+ - lighting plan natural + artificial
31
+ - camera position not center
32
+
33
+ ## Sample passing response outline
34
+ - Room header
35
+ - Architecture / furniture / palette rows
36
+ - Lighting plan
37
+ - Camera row
38
+ - Mood + time row
39
+ - Asset list
40
+ - Next handoff named
41
+
42
+ ## Sample failing response outline
43
+ - "Living room scene"
44
+ - No dims / style / lighting