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,212 @@
1
+ ---
2
+ name: glb-web-handoff
3
+ description: Prepare truthful GLB web handoff docs for Three.js, R3F, Godot, UE5, and Unity with Meshopt/KTX2 budgets, tone parity, and status caveats.
4
+ ---
5
+
6
+ # glb-web-handoff
7
+
8
+ ## Purpose
9
+ Define reliable handoff language and checks for GLB/web scenarios without overclaiming.
10
+
11
+ ## Quick start
12
+ - confirm this skill fits your goal
13
+ - provide required inputs first
14
+ - keep runtime claims evidence-bound
15
+ - follow suggested next-skill handoff
16
+
17
+ ## When to use
18
+ - when writing the GLB/web handoff summary after upstream validation from `scene-readiness` and evidence classification from `render-export-evidence`
19
+ - when summarizing per-artifact export statuses and web compatibility assumptions/caveats (transform/scale/origin, material/texture portability, loader/extensions, stack, performance)
20
+ - when preparing truthful next checks before passing final wording to `plain-language-response`
21
+
22
+ ## When not to use
23
+ <!-- blendops:generated:start exclusions -->
24
+ - to claim GLB or export success without concrete evidence → use `../scene-readiness/SKILL.md` (Delegates out-of-scope requests to scene-readiness)
25
+ - to replace runtime export verification → use `../render-export-evidence/SKILL.md` (Delegates out-of-scope requests to render-export-evidence)
26
+ - to validate upstream scene readiness → use `../scene-readiness/SKILL.md` (use scene-readiness)
27
+ - to classify raw render/export artifact evidence → use `../render-export-evidence/SKILL.md` (use render-export-evidence)
28
+ - to define mobile or file-size performance budgets → use `../mobile-glb-budget/SKILL.md` (use mobile-glb-budget)
29
+ - to define animation playback or rig contracts → use `../glb-animation-handoff/SKILL.md` (use glb-animation-handoff)
30
+ - to write the final user-facing response wording → use `../plain-language-response/SKILL.md` (use plain-language-response)
31
+ <!-- blendops:generated:end exclusions -->
32
+
33
+ ## Trigger phrases
34
+ <!-- blendops:generated:start triggers -->
35
+ - "prepare web handoff"
36
+ - "is GLB ready"
37
+ - "summarize export status"
38
+ <!-- blendops:generated:end triggers -->
39
+
40
+ ## Prerequisites / readiness
41
+ - upstream readiness output from `scene-readiness` available (or marked unverified)
42
+ - classified artifact evidence state from `render-export-evidence` known
43
+ - runtime mode known (within the 2-path + CLI appendix runtime model)
44
+
45
+ ## Input schema
46
+
47
+ ### Required inputs
48
+ - per-artifact status evidence from `render-export-evidence` (with provenance to the current run for any pre-existing files)
49
+ - upstream readiness summary from `scene-readiness`
50
+ - handoff target context and known compatibility assumptions
51
+
52
+ ### Optional inputs
53
+ - size/performance budget outputs from `mobile-glb-budget`
54
+ - animation handoff notes from `glb-animation-handoff`
55
+ - expected downstream web stack details
56
+
57
+ ### Assumptions to confirm
58
+ - transform/scale/origin assumptions
59
+ - material/texture portability assumptions
60
+ - loader/extensions assumptions
61
+ - target web stack assumptions
62
+ - performance assumptions and caveats
63
+ - truth states are downgrade-only (never upgrade):
64
+ - Runtime: `Not Run | Attempted | Produced | Verified | Failed`
65
+ - Artifacts: `Not Run | Not Produced | Produced | Verified | Failed` (default `Not Produced`)
66
+
67
+ ## Output schema
68
+
69
+ ### Primary output
70
+ - truthful GLB/web handoff summary with explicit Runtime status and per-artifact statuses
71
+
72
+ ### Secondary output
73
+ - compatibility assumptions and caveats covering transform/scale/origin, material/texture portability, loader/extensions, stack, and performance
74
+
75
+ ### Evidence / caveat output
76
+ - explicit Runtime status (`Not Run | Attempted | Produced | Verified | Failed`) and per-artifact status (`Not Run | Not Produced | Produced | Verified | Failed`, default `Not Produced`), downgrade-only
77
+ - provenance confirmation tying any `Produced` or `Verified` artifact to the current run
78
+ - unresolved risk notes, next checks, and cross-skill handoffs
79
+
80
+ ## Required laws
81
+ - ../../laws/evidence-before-done.md
82
+ - ../../laws/official-runtime-only.md
83
+ - ../../laws/non-blender-user-language.md
84
+ - ../../laws/no-arbitrary-python-interface.md
85
+
86
+ ## Official runtime boundary
87
+ Never claim GLB or export success without concrete evidence tied to the current run, and never replace runtime export verification. Keep runtime vocabulary strictly within the 2-path (Path 1 Official Blender Lab MCP 5.1+, Path 2 community `mcp-for-blender`) + CLI appendix model. This skill never runs Blender or Python and never upgrades Runtime or Artifact truth states (downgrade-only).
88
+
89
+ ## Operating procedure
90
+ 1. Enumerate expected handoff artifacts (GLB, preview renders, reports) and check current-run provenance for any pre-existing files.
91
+ 2. Inspect the GLB 2.0 binary container with `scripts/inspect-glb.mjs` (`blendops glb-inspect`) and generate/validate the structured handoff manifest (`schemas/glb-web-handoff-manifest.schema.json`) via `scripts/generate-glb-handoff-report.mjs` (`blendops glb-handoff`) across all four validation tiers (Tier 1 Container Structural, Tier 2 Khronos glTF 2.0 Specification, Tier 3 Visual Quality, Tier 4 Live Blender Runtime).
92
+ 3. Record Runtime status (`Not Run | Attempted | Produced | Verified | Failed`) and mark each artifact status (`Not Produced | Produced | Verified | Failed`, default `Not Produced`) using `render-export-evidence` without upgrading any state.
93
+ 4. Document transform/scale/origin assumptions and caveats (`+Y up, +Z forward, -X right`, `1 unit = 1 meter`, non-identity or negative root scale checks).
94
+ 5. Document material/texture portability assumptions and caveats (embedded `bufferView` vs external URI textures, KTX2/WebP transcoders, alpha modes).
95
+ 6. Document loader/extensions and target web stack compatibility assumptions (`DRACOLoader`, `MeshoptDecoder`, `KTX2Loader`, Three.js / React Three Fiber integration modules in `docs/examples/glb-web-handoff/README.md`) without inventing unsupported guarantees.
96
+ 7. Document performance caveats and uncertainty (incorporating `mobile-glb-budget` if size budgets apply, and `glb-animation-handoff` if animation contracts apply).
97
+ 8. Verify compliance with evidence boundaries and upstream `scene-readiness` findings, then hand off to `plain-language-response` for final user-facing wording.
98
+
99
+ ## Decision tree
100
+ - If concrete current-run GLB evidence is classified by `render-export-evidence` -> report `Produced` or `Verified` (matching evidence, never upgraded) + full compatibility caveats.
101
+ - If a GLB file exists on disk but lacks provenance to the current run -> do not claim `Produced` or `Verified`; downgrade to `Not Produced` with a provenance caveat.
102
+ - If runtime was not executed -> mark Runtime `Not Run` and artifacts `Not Run` or default `Not Produced`.
103
+ - If runtime was `Attempted` or `Failed` and no valid GLB was exported -> mark artifact `Not Produced` or `Failed` with failure notes and next checks.
104
+ - If size budgets or animation contracts are needed -> route to `mobile-glb-budget` or `glb-animation-handoff` respectively.
105
+ - Once handoff summary is complete -> hand off to `plain-language-response` for final user-facing wording.
106
+
107
+ ## Playbooks
108
+ - Playbook A: text-only planning path
109
+ - Playbook B: runtime-ready path with evidence gating
110
+ - Playbook C: blocked runtime path with caveat-first reporting
111
+
112
+ ## Mode handling
113
+
114
+ ### Text-only mode
115
+ - document handoff expectations, compatibility assumptions, and caveats only
116
+ - mark Runtime `Not Run` and artifacts `Not Run` or `Not Produced` (default `Not Produced`)
117
+
118
+ ### Runtime-ready mode
119
+ - report evidence-linked Runtime status (`Not Run | Attempted | Produced | Verified | Failed`) and per-artifact statuses (`Not Run | Not Produced | Produced | Verified | Failed`, default `Not Produced`) with current-run provenance and downgrade-only enforcement
120
+
121
+ ### Blocked runtime mode
122
+ - make zero production or verification claims; keep artifacts at `Not Produced`, `Not Run`, or `Failed`
123
+ - provide blocker-driven next checks and compatibility caveats
124
+
125
+ ## Validation checklist
126
+ - [ ] Runtime status (`Not Run | Attempted | Produced | Verified | Failed`) explicit
127
+ - [ ] GLB and preview per-artifact statuses (`Not Produced | Produced | Verified | Failed`, default `Not Produced`) explicit
128
+ - [ ] current-run provenance verified for any pre-existing files (synthetic test fixtures remain `Not Produced`)
129
+ - [ ] truth states strictly downgrade-only (never upgraded)
130
+ - [ ] 4-tier validation summary explicit (Container Structural, glTF 2.0 Specification, Visual Quality, Live Runtime)
131
+ - [ ] transform/scale/origin assumptions documented
132
+ - [ ] material/texture portability caveats documented
133
+ - [ ] loader/extensions assumptions documented (`DRACOLoader`, `MeshoptDecoder`, `KTX2Loader`)
134
+ - [ ] target stack assumptions documented (`threejs`, `react-three-fiber`, `model-viewer`, `babylonjs`)
135
+ - [ ] performance caveats documented
136
+ - [ ] no unsupported readiness guarantees or role blur with evidence/quality/budget/animation/response skills
137
+ - [ ] actionable next checks and handoff to `plain-language-response` included
138
+
139
+ ## Pass / Warn / Fail rubric
140
+
141
+ | Category | Pass | Warn | Fail |
142
+ |---|---|---|---|
143
+ | Artifact truth | Status matches evidence | Partial evidence | Claims without evidence |
144
+ | Compatibility clarity | Assumptions/caveats complete | Some gaps | Missing assumptions |
145
+ | Web handoff usability | Clear next actions | Partial actionability | Confusing or incomplete |
146
+ | Evidence boundary | No overclaims | Minor ambiguity | Contradictory claims |
147
+
148
+ ## Failure handling
149
+ - Missing evidence: mark Runtime `Not Run` (or `Attempted`) and artifacts `Not Produced` (default) or `Not Run`, then route to `render-export-evidence` / list missing checks.
150
+ - Failed export evidence: mark Runtime/artifact `Failed` or `Not Produced` (downgrade-only), record failure reason, and list next checks.
151
+ - Pre-existing file without current-run provenance: refuse `Produced`/`Verified` status, keep at `Not Produced`, and require a fresh verified export run.
152
+ - Unknown compatibility in any of the 5 categories: mark `Warn` with an explicit caveat rather than assuming support.
153
+
154
+ ## Troubleshooting
155
+ - Existing files found: verify provenance before claiming produced.
156
+ - Missing scale/origin assumptions: add as blocker.
157
+ - Missing stack assumptions: mark handoff as conditional.
158
+
159
+ ## Best practices
160
+ - Always pair every per-artifact status with its matching compatibility caveats.
161
+ - Enforce downgrade-only truth states and verify current-run provenance before accepting any file as `Produced` or `Verified`.
162
+ - Keep handoff notes in plain language and hand off final user-facing phrasing to `plain-language-response`.
163
+
164
+ ## Good examples
165
+ "Runtime status: `Not Run`. Artifact statuses: GLB `Not Produced` (default), Preview `Not Produced`. Compatibility assumptions & caveats: transform/scale/origin (1 unit = 1m, Z-up to Y-up conversion unverified), material/texture portability (procedural nodes must be baked before GLB export), loader/extensions (unverified compression/extension support), stack (target web viewer unspecified), performance (draw-call and file-size budget unverified; route to `mobile-glb-budget` if constrained). Next checks: run export via configured runtime path, classify evidence with `render-export-evidence`, and pass summary to `plain-language-response`."
166
+
167
+ ## Bad examples
168
+ “GLB is ready for production.” (no artifact proof)
169
+
170
+ ## User-facing response template
171
+ - Runtime status (`Not Run | Attempted | Produced | Verified | Failed`)
172
+ - Per-artifact statuses (`Not Run | Not Produced | Produced | Verified | Failed`, default `Not Produced`) with current-run provenance notes
173
+ - Compatibility assumptions and caveats:
174
+ - Transform / scale / origin
175
+ - Material / texture portability
176
+ - Loader / extensions
177
+ - Target stack
178
+ - Performance
179
+ - Unverified risks and next checks
180
+ - Cross-skill handoff (to `plain-language-response` for final user-facing wording)
181
+
182
+ ## Anti-patterns
183
+ - skipping required laws or runtime boundary statements
184
+ - claiming runtime/artifact success without evidence
185
+ - using non-official runtime setup paths
186
+ - producing jargon-heavy final output without explanation
187
+
188
+ ## Cross-skill handoff
189
+ <!-- blendops:generated:start handoffs -->
190
+ - [upstream_reference] Upstream scene readiness validation → `../scene-readiness/SKILL.md`
191
+ - [upstream_reference] Upstream artifact evidence classification → `../render-export-evidence/SKILL.md`
192
+ - [upstream_reference] Mobile and file-size budget constraints → `../mobile-glb-budget/SKILL.md`
193
+ - [upstream_reference] Animation playback and rig handoff contracts → `../glb-animation-handoff/SKILL.md`
194
+ - [progression] Final user-facing response wording → `../plain-language-response/SKILL.md`
195
+ <!-- blendops:generated:end handoffs -->
196
+
197
+ ## Non-goals
198
+ - Generating Python scripts or executing Blender exports
199
+ - Replacing runtime export verification
200
+ - Upgrading Runtime or Artifact truth states or accepting pre-existing files without current-run provenance
201
+ - Classifying raw render/export evidence (`render-export-evidence`) or validating upstream scene quality (`scene-readiness`)
202
+ - Defining size budgets (`mobile-glb-budget`), animation contracts (`glb-animation-handoff`), or final user-facing wording (`plain-language-response`)
203
+ - Making unsupported web stack or loader compatibility guarantees
204
+
205
+ ## References
206
+ - https://www.blender.org/lab/mcp-server/
207
+ - https://claude.com/resources/tutorials/using-the-blender-connector-in-claude
208
+ - https://docs.blender.org/manual/en/latest/advanced/command_line/index.html
209
+ - [`../../schemas/glb-web-handoff-manifest.schema.json`](../../schemas/glb-web-handoff-manifest.schema.json)
210
+ - [`../../scripts/inspect-glb.mjs`](../../scripts/inspect-glb.mjs)
211
+ - [`../../scripts/generate-glb-handoff-report.mjs`](../../scripts/generate-glb-handoff-report.mjs)
212
+ - [`../../docs/examples/glb-web-handoff/README.md`](../../docs/examples/glb-web-handoff/README.md)
@@ -0,0 +1,171 @@
1
+ {
2
+ "$schema": "../../schemas/skill-contract.schema.json",
3
+ "id": "glb-web-handoff",
4
+ "version": "1.0.0",
5
+ "category": "evidence-and-handoff",
6
+ "role": "web-glb-delivery-packager",
7
+ "purpose": "Prepare truthful GLB/web handoff output with explicit artifact status, assumptions, and caveats.",
8
+ "capabilityTier": "L0",
9
+ "triggers": [
10
+ "prepare web handoff",
11
+ "is GLB ready",
12
+ "summarize export status"
13
+ ],
14
+ "exclusions": [
15
+ {
16
+ "condition": "to claim GLB or export success without concrete evidence",
17
+ "delegateTo": "scene-readiness",
18
+ "reason": "Delegates out-of-scope requests to scene-readiness"
19
+ },
20
+ {
21
+ "condition": "to replace runtime export verification",
22
+ "delegateTo": "render-export-evidence",
23
+ "reason": "Delegates out-of-scope requests to render-export-evidence"
24
+ },
25
+ {
26
+ "condition": "to validate upstream scene readiness",
27
+ "delegateTo": "scene-readiness",
28
+ "reason": "use scene-readiness"
29
+ },
30
+ {
31
+ "condition": "to classify raw render/export artifact evidence",
32
+ "delegateTo": "render-export-evidence",
33
+ "reason": "use render-export-evidence"
34
+ },
35
+ {
36
+ "condition": "to define mobile or file-size performance budgets",
37
+ "delegateTo": "mobile-glb-budget",
38
+ "reason": "use mobile-glb-budget"
39
+ },
40
+ {
41
+ "condition": "to define animation playback or rig contracts",
42
+ "delegateTo": "glb-animation-handoff",
43
+ "reason": "use glb-animation-handoff"
44
+ },
45
+ {
46
+ "condition": "to write the final user-facing response wording",
47
+ "delegateTo": "plain-language-response",
48
+ "reason": "use plain-language-response"
49
+ }
50
+ ],
51
+ "inputs": {
52
+ "required": [
53
+ {
54
+ "name": "verified_or_planned_glb_artifact",
55
+ "type": "object",
56
+ "description": "GLB artifact evidence record (from render-export-evidence) or planned export specification"
57
+ },
58
+ {
59
+ "name": "target_web_viewer_stack",
60
+ "type": "string",
61
+ "description": "Target web runtime (Three.js, React Three Fiber, <model-viewer>, Babylon.js)"
62
+ }
63
+ ],
64
+ "optional": [
65
+ {
66
+ "name": "animation_and_budget_contracts",
67
+ "type": "object",
68
+ "description": "Optional linked contracts from glb-animation-handoff and mobile-glb-budget"
69
+ }
70
+ ]
71
+ },
72
+ "outputs": {
73
+ "primary": [
74
+ "web_glb_delivery_handoff_packet",
75
+ "scale_orientation_and_compression_manifest",
76
+ "viewer_integration_caveats"
77
+ ],
78
+ "truthStatePolicy": {
79
+ "runtimeDefault": "Not Run",
80
+ "artifactDefault": "Not Produced",
81
+ "mutationRule": "downgrade_only"
82
+ }
83
+ },
84
+ "handoffs": [
85
+ {
86
+ "target": "scene-readiness",
87
+ "type": "upstream_reference",
88
+ "label": "Upstream scene readiness validation",
89
+ "when": {
90
+ "all": [
91
+ {
92
+ "field": "quality.domain",
93
+ "operator": "equals",
94
+ "value": "holistic"
95
+ },
96
+ {
97
+ "field": "stage.current",
98
+ "operator": "equals",
99
+ "value": "quality_validation"
100
+ }
101
+ ]
102
+ }
103
+ },
104
+ {
105
+ "target": "render-export-evidence",
106
+ "type": "upstream_reference",
107
+ "label": "Upstream artifact evidence classification",
108
+ "when": {
109
+ "all": [
110
+ {
111
+ "field": "stage.current",
112
+ "operator": "equals",
113
+ "value": "post_execution_audit"
114
+ }
115
+ ]
116
+ }
117
+ },
118
+ {
119
+ "target": "mobile-glb-budget",
120
+ "type": "upstream_reference",
121
+ "label": "Mobile and file-size budget constraints",
122
+ "when": {
123
+ "all": [
124
+ {
125
+ "field": "artifact.type",
126
+ "operator": "equals",
127
+ "value": "glb"
128
+ },
129
+ {
130
+ "field": "budget.pinned",
131
+ "operator": "equals",
132
+ "value": false
133
+ }
134
+ ]
135
+ }
136
+ },
137
+ {
138
+ "target": "glb-animation-handoff",
139
+ "type": "upstream_reference",
140
+ "label": "Animation playback and rig handoff contracts",
141
+ "when": {
142
+ "all": [
143
+ {
144
+ "field": "artifact.hasAnimation",
145
+ "operator": "equals",
146
+ "value": true
147
+ },
148
+ {
149
+ "field": "stage.current",
150
+ "operator": "equals",
151
+ "value": "animation_handoff"
152
+ }
153
+ ]
154
+ }
155
+ },
156
+ {
157
+ "target": "plain-language-response",
158
+ "type": "progression",
159
+ "label": "Final user-facing response wording",
160
+ "when": {
161
+ "all": [
162
+ {
163
+ "field": "stage.current",
164
+ "operator": "equals",
165
+ "value": "final_communication"
166
+ }
167
+ ]
168
+ }
169
+ }
170
+ ]
171
+ }
@@ -0,0 +1,26 @@
1
+ # Artifact Status Language
2
+
3
+ ## Purpose
4
+ Standardize every artifact truth claim during GLB export, validation, and web handoff so non-Blender stakeholders never mistake a planned file or config for a verified export on disk.
5
+
6
+ ## When to use
7
+ - At the end of `glb-web-handoff`, `mobile-glb-budget`, `r3f-component-plan`, `preview-report`, and `pre-handoff-verification`.
8
+
9
+ ## Canonical Artifact Truth Matrix
10
+
11
+ | Status Label | Allowed When | Required Companion Evidence |
12
+ |---|---|---|
13
+ | `Artifact status: Not Produced` | Planning-only pass, dry-run compile, blocked runtime, or export step did not write a file on disk | State what blocked output (`Runtime status: Not Run` or `Blocked`) and the exact next export command/path |
14
+ | `Artifact status: Produced` | Export file exists at a concrete disk path with verified byte size `> 0`, but viewer/validator checks have not completed | Exact path + file size (e.g., `exports/hero-shoe.glb`, `2.84 MB`); explicitly state `Validation: Not Run` or `Pending` |
15
+ | `Artifact status: Verified` | File exists on disk **AND** automated inspection (`blendops glb-inspect`, `gltf-validator`) + render/viewer smoke pass with `0` errors | Path, byte size, triangle/material/texture counts, `gltf-validator` error count (`0`), and verified viewer check |
16
+ | `Artifact status: Failed` | Export attempted but wrote `0` bytes, threw Blender glTF exporter error, or failed `gltf-validator` / budget gate | Exact error message + failing metric (e.g. `142k tris exceeds 50k mobile budget`) + concrete fix step |
17
+
18
+ > **Hard Rule**: Never assign `Not Run` to `Artifact status`. `Not Run` applies to **Runtime / Validation status** (`Runtime status: Not Run`), while files on disk default to **`Artifact status: Not Produced`**.
19
+
20
+ ## Good vs. Bad Examples
21
+ - **Good**: `"Runtime status: Not Run. Artifact status: Not Produced — no .glb file was written in this planning pass. Planned target: exports/cyberpunk-shoe.glb (<= 5 MB, KTX2/Meshopt optional). Next: execute Path 1/CLI export and run blendops glb-inspect."`
22
+ - **Good**: `"Runtime status: Verified (CLI Blender 5.2.3). Artifact status: Verified — exports/hero.glb (2.41 MB, 31,420 tris, 3 materials, gltf-validator: 0 errors, Three.js Canvas render confirmed)."`
23
+ - **Bad**: `"GLB done and web-ready!"` (missing path, file size, validator result, or fabricated on a planning pass).
24
+
25
+ ## Related skill
26
+ [../SKILL.md](../SKILL.md)
@@ -0,0 +1,30 @@
1
+ # GLB Handoff Checklist
2
+
3
+ ## Purpose
4
+ Define minimum checks before GLB/web handoff claims, pairing `scripts/inspect-glb.mjs` and `scripts/generate-glb-handoff-report.mjs` with `schemas/glb-web-handoff-manifest.schema.json`.
5
+
6
+ ## When to use
7
+ In the GLB web handoff reporting stage (`blendops glb-inspect` / `blendops glb-handoff` / `blendops glb-validate-manifest`).
8
+
9
+ ## Checklist
10
+ - Runtime status (`Not Run | Attempted | Produced | Verified | Failed`) explicit
11
+ - GLB and preview status (`Not Produced | Produced | Verified | Failed`, default `Not Produced`) explicit
12
+ - 4-tier validation summary explicit (Container Structural, glTF 2.0 Specification, Visual Quality, Live Runtime)
13
+ - Transform, scale (`1 unit = 1m`, `+Y up`), and origin placement assumptions explicit
14
+ - Material, texture storage (`bufferView` vs external URI), and compression decoder (`DRACOLoader`, `MeshoptDecoder`, `KTX2Loader`) caveats explicit
15
+ - Next verification actions explicit
16
+
17
+ - Web compression & budget hints explicit: prefer `EXT_meshopt_compression` + WebP (`q85`) or KTX2/Basis (`--texture-compress ktx2`), or `Draco` when decoding speed allows; target `<= 2–5 MB` per hero GLB (`<= 10–20 MB` scene, `<= 50–100` draw calls on mobile web)
18
+ - Tone-mapping parity documented: match Blender `Khronos PBR Neutral` with Three.js `NeutralToneMapping` + `SRGBColorSpace`
19
+ - Non-web engine hints (if multi-target delivery requested alongside GLB): Godot import suffixes (`-col`, `-colonly`, `-convcolonly`, `-loop`); Unreal FBX/Interchange (`UCX_` collisions, DirectX `-Y` normal, ORM packing); Unity FBX (`Humanoid` root at world origin facing `-Y`)
20
+
21
+ ## Good example
22
+ Includes `Runtime status: Not Run` and `Artifact status: Not Produced` (or current-run evidence-backed status) alongside the 4-tier validation summary and decoder setup notes.
23
+
24
+ ## Bad example
25
+ Claims handoff complete or marks `Artifact status: Not Run` / `Verified` without artifact evidence.
26
+
27
+ ## Related skill
28
+ - [`../SKILL.md`](../SKILL.md)
29
+ - [`../../../schemas/glb-web-handoff-manifest.schema.json`](../../../schemas/glb-web-handoff-manifest.schema.json)
30
+ - [`../../../docs/examples/glb-web-handoff/README.md`](../../../docs/examples/glb-web-handoff/README.md)
@@ -0,0 +1,26 @@
1
+ # Performance Caveats & Honest Budget Framing
2
+
3
+ ## Purpose
4
+ Capture realistic web/mobile 3D performance risks and VRAM constraints without guessing or claiming unmeasured FPS targets.
5
+
6
+ ## When to use
7
+ Whenever preparing GLB web handoff caveats, reviewing mobile budgets, or auditing scene complexity gaps.
8
+
9
+ ## Quantified Caveat Categories
10
+
11
+ | Risk Category | Concrete Metric to Flag | Real User Impact | Corrective Action |
12
+ |---|---|---|---|
13
+ | **Payload Transfer Size** | Raw uncompressed `.glb > 5 MB` (hero) or `> 15 MB` (scene) | Slow initial FCP/LCP on cellular (`4G` takes `4–12s+`) | Apply `EXT_meshopt_compression` / WebP / KTX2 (`mobile-glb-budget`) |
14
+ | **GPU Texture VRAM (`Uncompressed`)** | Uncompressed RGBA GPU footprint = `width × height × 4 bytes × 1.33 mipmaps` (e.g. one `4096²` PNG = `~89 MB` VRAM!) | Mobile Safari / Chrome Android WebGL context loss & crash | Cap mobile hero textures at `1024²` or `2048²` **packed KTX2 (UASTC/ETC1S)** |
15
+ | **Draw Calls & Material Slots** | `> 25–40` distinct materials or unmerged static small parts | CPU JS/WebGL frame stall even at moderate triangle counts | Merge static parts per material (`≤ 8–16` draw calls for hero) |
16
+ | **Transparent Overdraw** | Stacked alpha-blended meshes or full-screen `Transmission` passes | Multiplies WebGL fragment shader cost on mobile GPUs | Use `OPAQUE` or `MASK` cutout where possible; avoid nested transmission |
17
+ | **Runtime Coverage Gap** | Verified only via `gltf-validator` / container header (`Not Run` in browser) | Actual frame time, lighting mood, and shader compile lag remain unknown | Explicitly label `Live browser performance: Not Run` and list target device test next |
18
+
19
+ ## Good example
20
+ "GLB container inspected (`2.4 MB`, `18.2k` triangles, `4` materials). Uncompressed `2048²` PNG maps require further KTX2 testing on iOS Safari; browser FPS probe: `Not Run`."
21
+
22
+ ## Bad example
23
+ "Runs smoothly at 60 FPS everywhere." (Unmeasured claim with zero device/VRAM evidence.)
24
+
25
+ ## Related skill
26
+ - [SKILL.md](../SKILL.md)
@@ -0,0 +1,28 @@
1
+ # Three.js / R3F Handoff Notes
2
+
3
+ ## Purpose
4
+ Provide concrete integration conventions and verification boundaries for Three.js (`r155+`) and React Three Fiber (`@react-three/fiber` + `@react-three/drei`) web delivery planning.
5
+
6
+ ## When to use
7
+ Whenever a user requests GLB web handoff notes, `<Canvas>` setup defaults, or viewer integration references for Three.js or React Three Fiber.
8
+
9
+ ## Integration & Color-Parity Contract
10
+ 1. **Coordinate, Scale & Origin**: Document explicit glTF convention (`+Y up, +Z forward, -X right`), metric scale (`1 unit = 1 meter`), and pivot origin (base center `y = 0` after Blender `+Z → +Y` export transform).
11
+ 2. **Color-Management Parity**: Match Blender `Khronos PBR Neutral` / `AgX` expectations explicitly using `gl={{ toneMapping: THREE.NeutralToneMapping, toneMappingExposure: 1.0, outputColorSpace: THREE.SRGBColorSpace }}` (`ACESFilmicToneMapping` shifts vivid saturated hues unless intended).
12
+ 3. **Canonical Viewer Modules**: Reference [`../../../docs/examples/glb-web-handoff/README.md`](../../../docs/examples/glb-web-handoff/README.md) (`threejs-glb-viewer.mjs` and `r3f-glb-viewer.tsx`) rather than inventing ad-hoc snippet patterns.
13
+ 4. **Decoder Pairing Rules**:
14
+ - `EXT_meshopt_compression` → wire `GLTFLoader.setMeshoptDecoder(MeshoptDecoder)` (preferred fast web decompression).
15
+ - `KHR_draco_mesh_compression` → wire `DRACOLoader` with pinned CDN or local `/draco/` WASM path.
16
+ - `KHR_texture_basisu` → wire `KTX2Loader.detectSupport(renderer)` with `/basis/` transcoder path.
17
+ 5. **Lifecycle & Disposal Guard**: Preload via `useGLTF.preload(url)` (`drei`) or dispose geometries/materials/textures on unmount so SPA route changes never leak GPU buffers.
18
+ 6. **Caveat-First Truthfulness**: Client-side parsing in Three.js or R3F checks **container structure only (`Tier 1/2`)** — it does **not** verify visual fidelity (`Tier 3`) or live Blender runtime (`Tier 4`).
19
+
20
+ ## Good example
21
+ Lists scale/origin/toneMapping/decoder assumptions, references `blendops glb-handoff`, and states next verification checks cleanly (`Artifact status: Not Produced` until `.glb` exists).
22
+
23
+ ## Bad example
24
+ Claims guaranteed web look-dev parity without matching tone mapping, decoder setup, or visual browser inspection.
25
+
26
+ ## Related skill
27
+ - [`../SKILL.md`](../SKILL.md)
28
+ - [`../../../docs/examples/glb-web-handoff/README.md`](../../../docs/examples/glb-web-handoff/README.md)
@@ -0,0 +1,82 @@
1
+ # EVAL — intent-to-3d-brief-writer
2
+
3
+ Status: 1.0.0 text-only baseline
4
+ Scope: produces 8-slot structured brief; no runtime; no artifacts.
5
+
6
+ ## Text-only eval prompt
7
+
8
+ Use intent-to-3d-brief-writer to convert a confirmed intent into the 8-slot brief. Echo the brief to the user. Hand off to the relevant planner.
9
+
10
+ ## Expected behavior
11
+
12
+ - fills all 8 slots (subject, mood, deliverables, constraints, evidence, acceptance, audience, owner)
13
+ - batches any missing-slot questions in one turn
14
+ - echoes the brief to the user for confirmation
15
+ - lists decisions explicitly deferred to planners
16
+ - runtime status remains `Not Run`; artifact status `Not Produced`
17
+ - hands off to the relevant planner after confirmation
18
+
19
+ ## Eval cases
20
+
21
+ | Case | Input | Expected output | Required evidence |
22
+ |---|---|---|---|
23
+ | Fully specified intent | Confirmed intent paragraph covers all 8 slots | Brief written, echoed, handed off | 8-slot markdown, deferred-decisions list |
24
+ | Half-specified intent | 5 of 8 slots present | Batch 3 missing-slot questions; write brief; echo | 8-slot markdown with `Unknown` filled where needed, questions answered |
25
+ | 4+ slots missing | Intent is too vague | Route back to `blender-brainstorming` | explicit re-route message, no brief written yet |
26
+ | Conflicting deliverable + constraint | "GLB for web AND 50MB poly budget" | Flag conflict in slot 4; ask user to resolve | conflict flag, resolution prompt |
27
+ | Mixed audience | Audience: marketing team + tech artist | Two sections (technical + plain-language); user-facing always plain-language | both sections present |
28
+ | User edits brief | After echo, user changes mood | Update brief, re-echo, await second confirmation | versioned brief, second confirmation |
29
+ | Iteration loop request | User wants text-only plan first, runtime later | Brief deliverables = text-only plan; evidence expectations = `Not Run` | brief explicitly text-only |
30
+
31
+ ## Expected evidence/status fields
32
+
33
+ | Field | Required content |
34
+ |---|---|
35
+ | Subject | Plain language; no Blender jargon |
36
+ | Mood / style | Tone, references, brand notes if any |
37
+ | Deliverables | Exhaustive list (image / GLB / preview / response / combinations) |
38
+ | Constraints | Performance, scope, time, brand |
39
+ | Evidence expectations | Truth labels acceptable + required evidence fields |
40
+ | Acceptance criteria | Observable, not subjective |
41
+ | Audience | Named (e.g. "marketing team — non-Blender") |
42
+ | Owner | Named (operator / agent / human) |
43
+ | Decisions deferred | Explicit list with target skill |
44
+ | Runtime status | `Not Run` |
45
+ | Artifact status | `Not Produced` |
46
+
47
+ ## Pass / Warn / Fail criteria
48
+
49
+ - Pass: all 8 slots filled or marked `Unknown` explicitly, plain language, acceptance criteria observable, brief echoed and confirmed by user
50
+ - Warn: 1-2 slots `Unknown` without follow-up, OR partly subjective acceptance criteria, OR brief written but not echoed
51
+ - Fail: 3+ slots missing without acknowledgment, OR jargon-heavy, OR claimed runtime / artifact production, OR brief invented slots not confirmed
52
+
53
+ ## Common failure modes
54
+
55
+ - writing the brief without echoing to user
56
+ - inventing mood / constraint values
57
+ - using Blender jargon ("subsurf scattering", "BSDF", "topology") in the brief
58
+ - letting planners re-negotiate after handoff
59
+ - skipping owner slot (breaks accountability later)
60
+
61
+ ## Evidence expectations
62
+
63
+ - 8-slot markdown brief visible
64
+ - echo + confirm cycle visible
65
+ - deferred-decisions list explicit
66
+ - handoff target named with reason
67
+
68
+ ## Sample passing response outline
69
+
70
+ - TL;DR: <one line>
71
+ - Brief (8 slots in markdown)
72
+ - Decisions deferred: <list with target skill>
73
+ - Confirm or edit prompt
74
+ - After confirmation, handoff: `product-hero-scene-planner`
75
+
76
+ ## Sample failing response outline
77
+
78
+ - Brief written without echo
79
+ - Subject slot has jargon
80
+ - 4 slots missing, no acknowledgment
81
+ - Skipped owner slot
82
+ - Claimed "runtime ready" when status is Not Run