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,205 @@
1
+ {
2
+ "$schema": "../../schemas/skill-contract.schema.json",
3
+ "id": "acceptance-criteria-builder",
4
+ "version": "1.0.0",
5
+ "category": "process-discipline",
6
+ "role": "measurable-acceptance-table-builder",
7
+ "purpose": "Turn a locked 3D brief plus chosen recipe into a measurable acceptance checklist with evidence hooks.",
8
+ "capabilityTier": "L0",
9
+ "triggers": [
10
+ "acceptance criteria",
11
+ "measurable checklist rows",
12
+ "evidence hooks for brief",
13
+ "sign-off checklist table"
14
+ ],
15
+ "exclusions": [
16
+ {
17
+ "condition": "pure exploration without a locked deliverable",
18
+ "delegateTo": "blender-brainstorming",
19
+ "reason": "use blender-brainstorming"
20
+ },
21
+ {
22
+ "condition": "writing or locking the brief itself",
23
+ "delegateTo": "intent-to-3d-brief-writer",
24
+ "reason": "use intent-to-3d-brief-writer"
25
+ },
26
+ {
27
+ "condition": "pinning the stop or done condition",
28
+ "delegateTo": "done-criteria",
29
+ "reason": "use done-criteria"
30
+ },
31
+ {
32
+ "condition": "enforcing per-stage workflow gates",
33
+ "delegateTo": "stage-gates",
34
+ "reason": "use stage-gates"
35
+ },
36
+ {
37
+ "condition": "guarding or deciding scope boundaries",
38
+ "delegateTo": "scope-guard",
39
+ "reason": "use scope-guard"
40
+ },
41
+ {
42
+ "condition": "legal or license-permission language",
43
+ "delegateTo": "asset-license-checker",
44
+ "reason": "use asset-license-checker"
45
+ },
46
+ {
47
+ "condition": "classifying artifact evidence",
48
+ "delegateTo": "pre-handoff-verification",
49
+ "reason": "use pre-handoff-verification"
50
+ }
51
+ ],
52
+ "inputs": {
53
+ "required": [
54
+ {
55
+ "name": "locked_3d_brief",
56
+ "type": "object",
57
+ "description": "Locked 8-slot 3D brief specifying subject, destination, deliverables, and constraints"
58
+ },
59
+ {
60
+ "name": "target_deliverable_channels",
61
+ "type": "array",
62
+ "description": "Target delivery surfaces (hero still, catalog grid, turntable, or web GLB)"
63
+ }
64
+ ],
65
+ "optional": [
66
+ {
67
+ "name": "performance_budget_pins",
68
+ "type": "object",
69
+ "description": "Optional triangle, texture, and file-size ceilings from mobile-glb-budget"
70
+ }
71
+ ]
72
+ },
73
+ "outputs": {
74
+ "primary": [
75
+ "measurable_acceptance_criteria_table",
76
+ "pass_warn_fail_thresholds",
77
+ "evidence_hook_mappings"
78
+ ],
79
+ "truthStatePolicy": {
80
+ "runtimeDefault": "Not Run",
81
+ "artifactDefault": "Not Produced",
82
+ "mutationRule": "downgrade_only"
83
+ }
84
+ },
85
+ "handoffs": [
86
+ {
87
+ "target": "intent-to-3d-brief-writer",
88
+ "type": "upstream_reference",
89
+ "label": "Brief source",
90
+ "when": {
91
+ "all": [
92
+ {
93
+ "field": "goal.clarity",
94
+ "operator": "equals",
95
+ "value": "clear"
96
+ },
97
+ {
98
+ "field": "brief.locked",
99
+ "operator": "equals",
100
+ "value": false
101
+ }
102
+ ]
103
+ }
104
+ },
105
+ {
106
+ "target": "done-criteria",
107
+ "type": "progression",
108
+ "label": "Done / stop condition",
109
+ "when": {
110
+ "all": [
111
+ {
112
+ "field": "brief.locked",
113
+ "operator": "equals",
114
+ "value": true
115
+ },
116
+ {
117
+ "field": "stage.current",
118
+ "operator": "equals",
119
+ "value": "stop_condition"
120
+ }
121
+ ]
122
+ }
123
+ },
124
+ {
125
+ "target": "stage-gates",
126
+ "type": "progression",
127
+ "label": "Per-stage gate enforcement",
128
+ "when": {
129
+ "all": [
130
+ {
131
+ "field": "brief.locked",
132
+ "operator": "equals",
133
+ "value": true
134
+ },
135
+ {
136
+ "field": "stage.current",
137
+ "operator": "equals",
138
+ "value": "stage_gates"
139
+ }
140
+ ]
141
+ }
142
+ },
143
+ {
144
+ "target": "scope-guard",
145
+ "type": "progression",
146
+ "label": "Scope boundary enforcement",
147
+ "when": {
148
+ "all": [
149
+ {
150
+ "field": "scope.driftDetected",
151
+ "operator": "equals",
152
+ "value": true
153
+ }
154
+ ]
155
+ }
156
+ },
157
+ {
158
+ "target": "asset-license-checker",
159
+ "type": "progression",
160
+ "label": "License permissions",
161
+ "when": {
162
+ "all": [
163
+ {
164
+ "field": "assets.externalUsed",
165
+ "operator": "equals",
166
+ "value": true
167
+ },
168
+ {
169
+ "field": "assets.licenseCleared",
170
+ "operator": "equals",
171
+ "value": false
172
+ }
173
+ ]
174
+ }
175
+ },
176
+ {
177
+ "target": "render-export-evidence",
178
+ "type": "progression",
179
+ "label": "Artifact evidence classification",
180
+ "when": {
181
+ "all": [
182
+ {
183
+ "field": "stage.current",
184
+ "operator": "equals",
185
+ "value": "post_execution_audit"
186
+ }
187
+ ]
188
+ }
189
+ },
190
+ {
191
+ "target": "pre-handoff-verification",
192
+ "type": "progression",
193
+ "label": "Handoff gate verification",
194
+ "when": {
195
+ "all": [
196
+ {
197
+ "field": "stage.current",
198
+ "operator": "equals",
199
+ "value": "final_verification"
200
+ }
201
+ ]
202
+ }
203
+ }
204
+ ]
205
+ }
@@ -0,0 +1,22 @@
1
+ # Brief -> Criteria Mapper
2
+
3
+ Translate each populated slot from the 8-slot `intent-to-3d-brief-writer` output into 1-3 measurable acceptance criteria tagged with priority (`P0` release blocker, `P1` strong quality bar, `P2` polish) and an explicit verification hook. Keep criteria compact at first pass so checklists remain auditable.
4
+
5
+ | Brief Slot | Measurable Acceptance Themes | Default Verification Hook | Priority |
6
+ |---|---|---|---|
7
+ | Subject & Hero Focus | Crisp silhouette at target camera angle; hero scale grounded on `Z = 0` or intended plinth; zero intersecting parts | Viewport/render visual inspection + bounding-box dimensions (`object.dimensions`) | P0 |
8
+ | Mood & Lighting | Key-to-fill contrast ratio matches mood words (e.g. crisp `4:1` dramatic vs soft `2:1` studio); no clipped highlights (`> 0.98`) on product body | Render histogram / Exposure + View Transform check (`AgX` or `Khronos PBR Neutral`) | P0 |
9
+ | Camera & Composition | Hero fills `45%-70%` of frame; focal length (`50-85 mm`) avoids distortion; negative space reserves requested UI/copy zone | Camera focal length + `composition-quality-checker` safe-frame check | P0 |
10
+ | Materials & Lookdev | Physically plausible PBR (`Albedo` within `[0.04, 0.85]`, metallic `0/1` separation, linear `Non-Color` normal/roughness maps) | Shader inspection + UV texel density spread `<= 1.3x` | P1 |
11
+ | Outputs & Format | Exact target format (`.glb`, `.png`, `.mp4`), pixel dimensions (`1920x1080`, `2048x2048`), and embedded/external color profile (`sRGB`) | Output file inspection (`gltf-validator` / image metadata) | P0 |
12
+ | Performance & Budget | Mobile/web caps (`<= 50k` tris, `<= 10 MB` GLB or compressed `<= 2 MB`, `<= 15` draw calls) when web delivery is requested | `blendops glb-inspect` triangle/material/texture budget report | P0 (if web) |
13
+ | Constraints & Exclusions | Explicit scope bans respected (no unapproved background clutter, no copyrighted logos, `Not Produced` labeled honestly if runtime skipped) | `scope-guard` + `pre-handoff-verification` 7-point check | P0 |
14
+
15
+ ## Mapping Procedure
16
+ 1. Read only slots actually populated in the approved brief; do not invent unrequested web or animation gates for a static still-only brief.
17
+ 2. Emit **1 to 3 concrete pass/fail criteria per slot**; collapse overlapping checks rather than duplicating rules across slots.
18
+ 3. Attach one explicit **Evidence Hook** (`viewport grab`, `gltf-validator JSON`, `blendops glb-inspect`, or `Not Run — planned gate`) to every criterion.
19
+ 4. Sort the final acceptance table strictly `P0` -> `P1` -> `P2` so downstream `done-criteria` and `stage-gates` know what blocks handoff.
20
+
21
+ ## Anti-Pattern to Avoid
22
+ - Copying generic boilerplate ("looks realistic", "high quality") without measurable thresholds or naming which artifact proves pass/fail.
@@ -0,0 +1,22 @@
1
+ # Acceptance Checklist Patterns
2
+
3
+ Reusable pass/fail checklist clauses indexed by review area. Select only the categories triggered by the brief and tag platform-specific items `P0` only when required by the delivery target.
4
+
5
+ ## 1. Visual Readability & Hero Silhouette
6
+ - **Hero Frame Share (`P0`)**: Primary product/subject occupies `45%-70%` of viewport area without clipped edges or accidental crop at safe margins (`5%-10%` inset).
7
+ - **Silhouette Separation (`P0`)**: Subject separates cleanly from backdrop across at least 75% of perimeter via value contrast or rim light (`>= 2:1` luminance step).
8
+ - **Grounding & Contact (`P1`)**: Resting objects sit flush on `Z = 0` with real contact shadow (`ambient occlusion` or area bounce); floating/levitating hero designs explicitly align along an intended hero shadow axis.
9
+
10
+ ## 2. Lighting, Color & Material Truth
11
+ - **View Transform Lock (`P0`)**: Scene uses `AgX` (photoreal/editorial Blender renders) or `Khronos PBR Neutral` (true-to-brand GLB/e-commerce matching), never legacy uncalibrated sRGB clips.
12
+ - **No Unintended Clipping (`P1`)**: Specular highlights remain controllable; primary product albedo stays inside physically plausible linear bounds (`[0.04, 0.85]`).
13
+ - **Color Texture Space (`P1`)**: Color/BaseColor maps sampled as `sRGB`; Roughness, Metallic, AO, and Normal maps strictly set to `Non-Color`.
14
+
15
+ ## 3. Technical Delivery & Web/Real-Time Budgets
16
+ - **Resolution & Aspect (`P0`)**: Render/export dimensions match `resolution-aspect-decision` output (`16:9` hero banner, `1:1` e-commerce card, `9:16` vertical social) without unintended pixel stretching.
17
+ - **Format & Compression (`P0`)**: Output matches `output-format-decision`; Web GLB exports pass `gltf-validator` with `0` errors and stay under `mobile-glb-budget` (`<= 50k` tris, `<= 2048px` textures, KTX2/Meshopt/Draco parity noted if used).
18
+ - **Animation & Rigging (`P0` only if animated)**: `glb-animation-handoff` confirms non-destructive baked NLA tracks, clean root scale (`1, 1, 1`), and verified frame-rate (`24`/`30`/`60 fps`).
19
+
20
+ ## 4. Process & Truth Discipline
21
+ - **Stop Conditions (`P0`)**: `done-criteria` limits (max refinement iterations, time cap) are embedded as pass/fail checks.
22
+ - **Truth Labeling (`P0`)**: Unexecuted checks record `Runtime status: Not Run` and `Artifact status: Not Produced` — never mark visual or binary checks `Verified` from planning text alone.
@@ -0,0 +1,19 @@
1
+ # Evidence Hook Rules — Acceptance Criteria
2
+
3
+ Every **P0 (blocking release/delivery)** acceptance criterion MUST bind to an explicit observable check rather than subjective confidence.
4
+
5
+ ## Required Structure Per P0 Criterion
6
+ 1. **Artifact / Signal Type** — Exact deliverable (`render.png`, `hero.glb`, `stderr`, `inspect-glb JSON`, screenshot).
7
+ 2. **Minimum Truth State Target** — `Produced` (file exists on disk, non-zero size, valid format) vs `Verified` (observed visual/schema pass recorded under `docs/evals/` or ledger).
8
+ 3. **Validator Owner** — Exact BlendOps checker (`render-export-evidence`, `pre-handoff-verification`, `polycount-budget-checker`, `blendops glb-inspect`) or named human reviewer sign-off.
9
+ 4. **Fail-Closed Condition** — What concrete mismatch forces status back to `Failed` / `Not Produced`.
10
+
11
+ ## Anti-Rationalization Rules (Forbidden Hooks)
12
+ - "Looks clean in code" or "Script ran without syntax errors" → **INVALID**. Headless Blender frequently exits `0` while producing black/blank renders or ungrounded geometry.
13
+ - "Assumed `Verified` because brief matched" → **INVALID**. Matching intent before execution hits `Runtime status: Not Run`, never `Verified`.
14
+ - Subjective aesthetic claim without side-by-side reference or human sign-off → Keep `Produced (Visual QA Pending)`.
15
+
16
+ Align exact status strings with `render-export-evidence` and `laws/evidence-before-done.md`.
17
+
18
+ ## Related skill
19
+ - [SKILL.md](../SKILL.md)
@@ -0,0 +1,81 @@
1
+ # EVAL — asset-discovery
2
+
3
+ Status: 1.0.0 text-only baseline
4
+ Scope: per-asset strategy plan; no fetch / install / generate / runtime.
5
+
6
+ ## Text-only eval prompt
7
+
8
+ Use asset-discovery to produce a per-asset plan from an 8-slot brief. Choose strategy + source + license + confidence + risk per asset. Do not fetch / install / generate. Do not run Blender.
9
+
10
+ ## Expected behavior
11
+
12
+ - enumerates every asset class implied by the brief
13
+ - assigns one strategy per class (procedural / library / generative / photogrammetry)
14
+ - records source candidate + license + confidence label + risk per choice
15
+ - sums poly / GLB budget and compares to constraint slot
16
+ - flags generative strategy with Path 2 caveat
17
+ - never fetches, downloads, generates, or installs anything
18
+
19
+ ## Eval cases
20
+
21
+ | Case | Input | Expected output | Required evidence |
22
+ |---|---|---|---|
23
+ | Cyberpunk shoe web hero brief | Subject = floating cyberpunk shoe; constraint = ≤10MB GLB; mood = neon glossy floor | Hero shoe = generative-via-Path-2 OR user-supplied; floor + props = procedural; HDRI = library (Poly Haven CC0); accent neon = procedural emission. Budget 8MB est. Pass. Generative caveat flagged. | full asset table, budget sum, generative caveat |
24
+ | Brand product render | Subject = brand sneaker; constraint = brand-restricted asset library only | Subject = brand library only; environment = procedural; license = brand-restricted; license risk callout | brand-only enforcement, license risk |
25
+ | Iteration sketch | Deliverable = text-only plan loop, runtime later | Everything procedural; library only for HDRI; license low-risk; budget N/A | procedural-first, low risk |
26
+ | Generative without Path 2 readiness | User wants Hyper3D shoe but Path 2 not configured | Mark generative blocked; route to readiness checker; offer library/procedural alternatives | blocked flag, route, alternatives |
27
+ | User skips license slot | User says "doesn't matter" | Mark `TBD`, ask before planner consumes | TBD entries, user follow-up |
28
+ | Conflicting constraints | Brand asset + ≤2MB GLB | Surface conflict; ask user to relax one constraint | conflict callout |
29
+ | Missing brief | No 8-slot brief provided | Route back to `intent-to-3d-brief-writer` | re-route message |
30
+
31
+ ## Expected evidence/status fields
32
+
33
+ | Field | Required content |
34
+ |---|---|
35
+ | Asset class | Subject / props / environment / materials / HDRI / particles |
36
+ | Strategy | Procedural / library / generative / photogrammetry |
37
+ | Source candidate | Named (Poly Haven, Sketchfab, brand library, Hyper3D, user-supplied, …) |
38
+ | License | CC0 / commercial-OK / brand-restricted / TBD |
39
+ | Confidence | `verified-read` / `linked-only` / `unknown` |
40
+ | Risk notes | Poly budget / filesize / license / generative caveats |
41
+ | Budget summary | Poly / GLB-size estimate vs. constraint |
42
+ | Generative caveat | Path 2 flag + caveat link if used |
43
+ | Runtime status | `Not Run` |
44
+ | Artifact status | `Not Produced` |
45
+
46
+ ## Pass / Warn / Fail criteria
47
+
48
+ - Pass: every asset class has strategy + source + license + confidence + risk; budget summed and compared; generative strategy flagged correctly; no fetch / install
49
+ - Warn: 1-2 fields `TBD` with follow-up; budget summed without comparison; generative strategy missing caveat link
50
+ - Fail: missing strategy, license, or confidence on any asset; budget not summed; generative chosen with no caveat; claimed asset was fetched / installed / generated
51
+
52
+ ## Common failure modes
53
+
54
+ - "just use any free model from the internet" (no source, no license, no confidence)
55
+ - skipping license entries entirely
56
+ - choosing generative without Path 2 caveat or readiness check
57
+ - silently fetching or generating assets from this skill (not allowed)
58
+ - letting downstream planner change strategy without explicit feedback
59
+
60
+ ## Evidence expectations
61
+
62
+ - markdown asset table visible
63
+ - budget summary visible
64
+ - license risk callouts visible
65
+ - generative caveat link present if applicable
66
+ - explicit `Not Run` / `Not Produced`
67
+
68
+ ## Sample passing response outline
69
+
70
+ - Brief recap (one line)
71
+ - Asset table with 6+ rows
72
+ - Budget summary: estimate vs. constraint
73
+ - License risks: 0-2 callouts
74
+ - Generative caveats: 0-1
75
+ - Handoff: scene planner
76
+
77
+ ## Sample failing response outline
78
+
79
+ - "Use whatever free models you can find" (no table, no license)
80
+ - Skipped budget summary
81
+ - Claimed Hyper3D would generate the shoe without checking Path 2 readiness
@@ -0,0 +1,252 @@
1
+ ---
2
+ name: asset-discovery
3
+ description: Plan the asset acquisition strategy (procedural, library, generative, photogrammetry) for a Blender scene without installing or executing. Use after the brief, before scene planning.
4
+ ---
5
+
6
+ # asset-discovery
7
+
8
+ ## Purpose
9
+
10
+ Decide where the assets in a scene will come from before the scene planner commits to a layout. Asset acquisition decisions affect poly budget, web GLB size, licensing, and time-to-handoff. This skill produces a per-asset plan with explicit confidence labels and licensing notes — without installing tools, running Blender, or fetching anything.
11
+
12
+ This skill is BlendOps-specific (no direct analog in Anthropic Superpowers or BMad), driven by a real Blender domain need.
13
+
14
+ ## Quick start
15
+
16
+ - read the 8-slot brief from `intent-to-3d-brief-writer`
17
+ - enumerate every asset class needed (subjects, props, environment, materials, HDRIs)
18
+ - pick a strategy per asset class (procedural / library / generative / photogrammetry)
19
+ - record license + confidence label per choice
20
+ - hand off to scene planner
21
+
22
+ ## When to use
23
+
24
+ - after the 3D brief is locked, before any scene plan
25
+ - when scene assets aren't trivially given (e.g. user says "shoe" but doesn't supply a shoe model)
26
+ - when poly budget / GLB size / brand-licensing constraints exist
27
+ - when planner needs to know upfront whether assets are procedural or external
28
+
29
+ ## When not to use
30
+ <!-- blendops:generated:start exclusions -->
31
+ - the user supplied all assets in the brief (skip; route directly to planner) → use `../intent-to-3d-brief-writer/SKILL.md` (skip; route directly to planner)
32
+ - runtime is already executing and assets are already in the scene → use `../product-hero-scene-planner/SKILL.md` (route to evidence skill)
33
+ - the request is iteration on an existing scene (assets are already chosen) → use `../render-export-evidence/SKILL.md` (assets are already chosen)
34
+ <!-- blendops:generated:end exclusions -->
35
+
36
+ ## Trigger phrases
37
+ <!-- blendops:generated:start triggers -->
38
+ - "what assets do we need"
39
+ - "where do the models come from"
40
+ - "asset plan before scene planning"
41
+ - "do we generate or import"
42
+ - "surface asset license risks before planning"
43
+ <!-- blendops:generated:end triggers -->
44
+
45
+ ## Prerequisites / readiness
46
+
47
+ - 8-slot brief from `intent-to-3d-brief-writer` (or equivalent)
48
+ - list of constraint slots (performance, brand, time)
49
+ - no Blender runtime required
50
+ - works in text-only mode
51
+
52
+ ## Input schema
53
+
54
+ ### Required inputs
55
+
56
+ - 8-slot brief from `intent-to-3d-brief-writer` (subject, mood, deliverables, constraints, evidence, acceptance, audience, owner)
57
+ - list of asset classes implied by the brief (e.g., hero subject, lighting, floor, environment backdrop)
58
+
59
+ ### Optional inputs
60
+
61
+ - known asset libraries the user has access to (approved brand library, internal library, user-supplied files)
62
+ - license preferences (public domain only, commercial allowed, brand-restricted)
63
+ - prior similar scenes to match asset choices
64
+
65
+ ### Assumptions to confirm
66
+
67
+ - the operator can defer fetching or generation to a later runtime step
68
+ - license restrictions matter for the deliverable (risks surfaced here; verdicts handled by `asset-license-checker`)
69
+ - truth states start at Runtime `Not Run` and Artifact `Not Produced` for plan-only work (downgrade-only, never upgrade)
70
+
71
+ ## Output schema
72
+
73
+ ### Primary output
74
+
75
+ - per-asset-class plan with strategy + source candidate + license + confidence + risk notes
76
+
77
+ | Asset class | Strategy | Source candidate | License | Confidence | Risk notes |
78
+ |---|---|---|---|---|---|
79
+ | Hero shoe model | generative | Path 2 community `mcp-for-blender` (formerly `ahujasid/blender-mcp`) Hyper3D / Hunyuan3D integration | TBD | linked-only | poly budget; Path 2 caveat; needs `asset-license-checker` verdict |
80
+ | Floor + props | procedural | built-in procedural setup | N/A | verified-read | poly budget |
81
+ | Lighting fixtures | procedural | built-in area light setup | N/A | verified-read | none |
82
+ | Environment backdrop | library | approved environment library | commercial-OK / TBD | verified-read | filesize; style check via `asset-style-check` |
83
+
84
+ ### Secondary output
85
+
86
+ - budget reconciliation summary compared against `mobile-glb-budget` and `polycount-budget-checker`
87
+ - explicit list of assets the operator must obtain before any runtime step
88
+ - license risk callouts for `asset-license-checker` to adjudicate
89
+
90
+ ### Evidence / caveat output
91
+
92
+ - Runtime status: `Not Run`
93
+ - Artifact status: `Not Produced`
94
+ - Truth states are downgrade-only, never upgrade
95
+ - No asset is downloaded, generated, fetched, or installed by this skill
96
+
97
+ ## Required laws
98
+
99
+ - ../../laws/official-runtime-only.md
100
+ - ../../laws/evidence-before-done.md
101
+ - ../../laws/non-blender-user-language.md
102
+ - ../../laws/no-arbitrary-python-interface.md
103
+
104
+ ## Official runtime boundary
105
+
106
+ This skill does not download, generate, fetch, or install any asset. It does not run Blender, configure any MCP path, or touch the network. It produces a plain-language plan in markdown.
107
+
108
+ If the chosen strategy is `generative`, it is Path 2-only (community `mcp-for-blender`, formerly `ahujasid/blender-mcp`, Hyper3D / Hunyuan3D integrations) with per-path caveats (see `docs/unofficial-runtime-bridges.md`). Actual generation happens in a runtime step, never here.
109
+
110
+ ## Operating procedure
111
+
112
+ 1. Read the 8-slot brief from `intent-to-3d-brief-writer`.
113
+ 2. Enumerate every asset class implied (subjects, props, environment, materials, lighting backdrops, effects).
114
+ 3. For each asset class, pick one acquisition strategy:
115
+ - **procedural** — created inside Blender via built-in procedural rules; no external asset file.
116
+ - **library** — existing approved library or user-supplied asset.
117
+ - **generative** — Hyper3D / Hunyuan3D (Path 2-only via community `mcp-for-blender`, formerly `ahujasid/blender-mcp`, with per-path caveats); actual generation happens in a runtime step, never here.
118
+ - **photogrammetry** — user-supplied scan; cleanup required before scene assembly.
119
+ 4. For each pick: record source candidate, license, confidence label (`verified-read` / `linked-only` / `unknown`), and risk notes.
120
+ 5. Reconcile per-class polycount and file-size estimates against `mobile-glb-budget` (and `polycount-budget-checker`). Flag any overage risk explicitly.
121
+ 6. List every asset that must be obtained before runtime; surface license risks for `asset-license-checker` (do not issue license verdicts here) and flag multi-source combinations for `asset-style-check`.
122
+ 7. Hand off the asset plan + brief to the target scene planner (`product-hero-scene-planner`, `character-portrait`, `environment-shot`, `interior-scene`, or `product-grid-scene-planner`).
123
+
124
+ ## Decision tree
125
+
126
+ - subject is brand-specific (e.g., exact branded product) -> strategy must be `library` (user-supplied / brand library); never `generative` without explicit brand authorization
127
+ - mood is highly specific -> backdrop = `library`, color and surface treatments = `procedural`
128
+ - tight web or mobile budget constraint -> reconcile against `mobile-glb-budget`; favor `procedural` over heavy external imports
129
+ - iteration-loop deliverable -> favor `procedural` (fast and reproducible to adjust)
130
+ - one-shot marketing render -> `library` or `generative` (Path 2-only with caveats) is acceptable once license risk is cleared by `asset-license-checker`
131
+
132
+ ## Playbooks
133
+
134
+ - Playbook A: "Cyberpunk shoe web hero" — shoe = generative or user-supplied; floor + props = procedural; HDRI = library; budget = web-tight
135
+ - Playbook B: "Brand product render" — subject = brand library only; environment = procedural; license = brand-restricted
136
+ - Playbook C: "Iteration sketch" — everything procedural; library only for HDRI
137
+
138
+ ## Mode handling
139
+
140
+ ### Text-only mode
141
+
142
+ - plan only, no fetch / generate / install
143
+ - Runtime status: `Not Run`
144
+ - Artifact status: `Not Produced`
145
+ - Truth states are downgrade-only, never upgrade
146
+
147
+ ### Runtime-ready mode
148
+
149
+ - plan stays text-only; downstream runtime steps consume the plan
150
+ - if `generative` strategy is chosen, route to `runtime-readiness` first to confirm Path 2 (`mcp-for-blender`, formerly `ahujasid/blender-mcp`, Hyper3D / Hunyuan3D integrations) readiness and caveats
151
+
152
+ ### Blocked runtime mode
153
+
154
+ - plan is still produced with Runtime `Not Run` and Artifact `Not Produced`
155
+ - mark `generative` options blocked; favor `procedural` or `library` via `asset-fallback-strategy`
156
+
157
+ ## Validation checklist
158
+
159
+ - [ ] every implied asset class enumerated
160
+ - [ ] canonical strategy chosen per asset class (`procedural` / `library` / `generative` / `photogrammetry`)
161
+ - [ ] source candidate named per choice
162
+ - [ ] license recorded per choice with risks surfaced for `asset-license-checker` (no final license verdicts claimed here)
163
+ - [ ] confidence label (`verified-read` / `linked-only` / `unknown`) assigned per choice
164
+ - [ ] budget reconciled against `mobile-glb-budget` and brief constraints
165
+ - [ ] obtain-before-runtime asset list included
166
+ - [ ] generative strategy flagged as Path 2-only (`mcp-for-blender`, formerly `ahujasid/blender-mcp`, Hyper3D / Hunyuan3D) with per-path caveats
167
+ - [ ] no asset downloaded, fetched, installed, or generated by this skill
168
+ - [ ] truth states set to Runtime `Not Run` and Artifact `Not Produced` (downgrade-only, never upgrade)
169
+
170
+ ## Pass / Warn / Fail rubric
171
+
172
+ | Category | Pass | Warn | Fail |
173
+ |---|---|---|---|
174
+ | Asset coverage | All implied assets listed | 1-2 missing with note | 3+ missing |
175
+ | License records | Every asset has license entry | Some `TBD` with follow-up | Missing license entries |
176
+ | Confidence labels | Every choice labeled | Partial labels | No labels |
177
+ | Budget reconciliation | Summed and compared | Summed without comparison | Not summed |
178
+ | Runtime claim | None | None | Asset claimed to be fetched / generated by this skill |
179
+
180
+ ## Failure handling
181
+
182
+ - license unknown: mark `TBD`, surface the risk note, and route to `asset-license-checker` before the scene planner commits
183
+ - generative strategy requested but Path 2 readiness unknown or unavailable: route to `runtime-readiness` (and `asset-fallback-strategy` if blocked)
184
+ - conflicting constraints (e.g., high-detail scan vs. tight mobile budget): surface conflict against `mobile-glb-budget` and route back to `intent-to-3d-brief-writer` if constraints must be relaxed
185
+
186
+ ## Troubleshooting
187
+
188
+ - if the asset list is too long, group by class and propose tiered approach (essentials vs. nice-to-have)
189
+ - if the user has no preference, default to procedural-first per BlendOps `evidence-before-done` (procedural is reproducible)
190
+
191
+ ## Best practices
192
+
193
+ - procedural-first when license / budget pressure is high
194
+ - library-second when matching mood matters
195
+ - generative as a last resort, always with explicit caveats
196
+ - never fetch from this skill
197
+
198
+ ## Good examples
199
+
200
+ - "Cyberpunk shoe brief. Asset plan: hero shoe = `generative` via Path 2 `mcp-for-blender` (formerly `ahujasid/blender-mcp`) Hyper3D/Hunyuan3D integration (license = `TBD`, risk surfaced for `asset-license-checker`; confidence = `linked-only`); floor + props = `procedural` (license = N/A; confidence = `verified-read`); environment lighting = `library` (approved studio backdrop; license = commercial-OK; confidence = `verified-read`). Budget reconciliation: estimated footprint checked against `mobile-glb-budget`. Obtain-before-runtime list: hero shoe mesh and environment backdrop. Runtime: `Not Run`, Artifact: `Not Produced`."
201
+
202
+ ## Bad examples
203
+
204
+ - "Just use any free shoe model from the internet, we'll figure out license later." (no source named, no license, no confidence label, license risk ignored)
205
+
206
+ ## User-facing response template
207
+
208
+ - Brief recap (one line)
209
+ - Asset table (markdown)
210
+ - Budget summary
211
+ - License risks called out
212
+ - Generative caveats if applicable
213
+ - Handoff: scene planner with this asset plan + brief
214
+
215
+ ## Anti-patterns
216
+
217
+ - downloading, fetching, generating, or installing any asset from this skill
218
+ - issuing final license verdicts instead of surfacing license risk for `asset-license-checker`
219
+ - skipping style consistency handoffs (`asset-style-check`) when mixing procedural, library, and generative sources
220
+ - claiming generative strategy works in Path 1 or without checking Path 2 caveats via `runtime-readiness`
221
+ - referring to the community bridge as bare `blender-mcp` instead of `mcp-for-blender` (formerly `ahujasid/blender-mcp`)
222
+ - upgrading truth states above Runtime `Not Run` or Artifact `Not Produced`
223
+
224
+ ## Cross-skill handoff
225
+ <!-- blendops:generated:start handoffs -->
226
+ - [upstream_reference] **Before this skill** → `../intent-to-3d-brief-writer/SKILL.md`
227
+ - [alternative] **Scene planners (primary handoff with brief + asset plan)** (character-portrait) → `../character-portrait/SKILL.md`
228
+ - [alternative] **Scene planners (primary handoff with brief + asset plan)** (environment-shot) → `../environment-shot/SKILL.md`
229
+ - [alternative] **Scene planners (primary handoff with brief + asset plan)** (interior-scene) → `../interior-scene/SKILL.md`
230
+ - [alternative] **Scene planners (primary handoff with brief + asset plan)** (product-grid-scene-planner) → `../product-grid-scene-planner/SKILL.md`
231
+ - [alternative] **Scene planners (primary handoff with brief + asset plan)** (product-hero-scene-planner) → `../product-hero-scene-planner/SKILL.md`
232
+ - [progression] **License verdicts** → `../asset-license-checker/SKILL.md`
233
+ - [progression] **Style re-checks** → `../asset-style-check/SKILL.md`
234
+ - [progression] **Budget reconciliation** (mobile-glb-budget) → `../mobile-glb-budget/SKILL.md`
235
+ - [progression] **Budget reconciliation** (polycount-budget-checker) → `../polycount-budget-checker/SKILL.md`
236
+ - [upstream_reference] **Generative readiness** → `../runtime-readiness/SKILL.md`
237
+ - [fallback] **Fallback / constraint updates** (asset-fallback-strategy) → `../asset-fallback-strategy/SKILL.md`
238
+ <!-- blendops:generated:end handoffs -->
239
+
240
+ ## Non-goals
241
+
242
+ - fetching / downloading / installing assets
243
+ - running Blender or generative tools
244
+ - making the scene plan
245
+ - license adjudication beyond surfacing risk
246
+
247
+ ## References
248
+
249
+ - BlendOps law: ../../laws/official-runtime-only.md
250
+ - BlendOps law: ../../laws/evidence-before-done.md
251
+ - BlendOps doc on Path 2 generative integrations: ../../docs/unofficial-runtime-bridges.md
252
+ - Skill system: ../../docs/skill-system.md