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,66 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/asset-fallback-strategy/SKILL.md and skills/asset-fallback-strategy/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # asset-fallback-strategy (reference summary)
3
+
4
+ ## Purpose
5
+ Provide a fallback strategy when an asset is unavailable, over-budget, license-blocked, or style-incompatible — without halting the recipe.
6
+
7
+ When `asset-license-checker`, `asset-style-check`, or `mobile-glb-budget` blocks an asset (or an asset is unavailable), this skill plans 2-3 actionable fallback options (replace / re-source / procedural / generative / drop-with-caveat) ordered by speed so the recipe can proceed. Any chosen replacement must re-pass `asset-license-checker` and `asset-style-check` (plus `mobile-glb-budget` when budget applies).
8
+
9
+ ## Metadata & truth boundary
10
+ - **Canonical skill:** `skills/asset-fallback-strategy/SKILL.md`
11
+ - **Contract:** `skills/asset-fallback-strategy/contract.json` (`v1.0.0`)
12
+ - **Category / role:** `asset-and-sourcing` / `blocked-asset-replacement-planner`
13
+ - **Capability tier:** `L0`
14
+ - **Truth-state policy:** Runtime status defaults to `Not Run`; Artifact status defaults to `Not Produced`; mutation rule is `downgrade_only` (never upgrade without verified evidence).
15
+
16
+ ## When to use
17
+ - after a checker fails an asset
18
+ - when an asset cannot be acquired in time
19
+ - when budget excludes the originally-planned asset
20
+ - when license blocks an asset
21
+
22
+ ## Trigger cues
23
+ - "what if we can't get this asset"
24
+ - "fallback for the model"
25
+ - "the license blocks us"
26
+ - "scaled-down asset"
27
+
28
+ ## When not to use
29
+ - when no asset has failed (nothing to fall back to) → delegate to `asset-license-checker` (`references/skills/asset-license-checker.md`; nothing to fall back to)
30
+ - pure exploration (no concrete asset list) → delegate to `asset-discovery` (`references/skills/asset-discovery.md`; no concrete asset list)
31
+ - when the user wants to wait for the original asset → delegate to `product-hero-scene-planner` (`references/skills/product-hero-scene-planner.md`; Delegates out-of-scope requests to product-hero-scene-planner)
32
+
33
+ ## Inputs & output/evidence contract
34
+ ### Required inputs
35
+ - `blocked_asset_entry` (`object`): Asset blocked by missing source, incompatible license, style mismatch, or budget breach
36
+ - `blocking_reason` (`enum`): Primary block reason (license_rejected, source_unavailable, style_mismatch, budget_exceeded)
37
+
38
+ ### Optional inputs
39
+ - `local_library_manifest` (`object`): Optional inventory of cleared local assets from asset-library-plan
40
+
41
+ ### Primary outputs
42
+ - `ranked_fallback_options`
43
+ - `selected_replacement_plan`
44
+ - `revalidation_routing_hooks`
45
+
46
+ ## Quick-start procedure
47
+ 1. read the failed asset + blocking reason
48
+ 2. propose 2-3 fallback options ordered by speed-to-implement (always including `drop-with-caveat`)
49
+ 3. score each option on time, brief-match, and license
50
+ 4. pick one only with explicit user agreement
51
+ 5. update the asset list and route any replacement back through `asset-license-checker` and `asset-style-check` (and `mobile-glb-budget` if budget-constrained)
52
+
53
+ ## Handoff notes
54
+ - **[upstream_reference]** Re-source external asset → `asset-discovery` (`references/skills/asset-discovery.md`) — `when.all: [brief.locked equals true; assets.discoveryComplete equals false]`
55
+ - **[progression]** Internal library lookup → `asset-library-plan` (`references/skills/asset-library-plan.md`) — `when.all: [assets.discoveryComplete equals true; stage.current equals "library_organization"]`
56
+ - **[fallback]** License re-check on replacement → `asset-license-checker` (`references/skills/asset-license-checker.md`) — `when.all: [assets.externalUsed equals true; assets.licenseCleared equals false]`
57
+ - **[fallback]** Style re-check on replacement → `asset-style-check` (`references/skills/asset-style-check.md`) — `when.all: [assets.licenseCleared equals true; stage.current equals "style_check"]`
58
+ - **[progression]** Budget re-check on replacement → `mobile-glb-budget` (`references/skills/mobile-glb-budget.md`) — `when.all: [artifact.type equals "glb"; budget.pinned equals false]`
59
+ - **[fallback]** Scope reduction when no viable fallback exists → `scope-guard` (`references/skills/scope-guard.md`) — `when.all: [scope.driftDetected equals true]`
60
+ - **[fallback]** Recipe split when no viable fallback exists → `blender-recipe-decomposer` (`references/skills/blender-recipe-decomposer.md`) — `when.all: [fit.multiDeliverableDetected equals true]`
61
+
62
+ ## Safety boundaries & non-goals
63
+ - **Runtime boundary:** Process and planning skill only — never acquires, generates, or edits assets itself. Outputs a fallback plan and routes execution or re-verification to dedicated skills.
64
+ - Acquire, generate, or edit assets itself.
65
+ - Run Blender or execute Python.
66
+ - Perform license, style, or performance budget checks itself.
@@ -0,0 +1,69 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/asset-library-plan/SKILL.md and skills/asset-library-plan/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # asset-library-plan (reference summary)
3
+
4
+ ## Purpose
5
+ Plan an internal asset library structure (folders, naming, metadata, license tracking, version control) so future recipes find and reuse assets reliably.
6
+
7
+ Plan a maintainable internal asset library structure (folder tree, naming convention, per-asset metadata schema, license-tracking strategy, version-control rules, migration steps, and review process) so future recipes can: - find existing assets quickly, - avoid re-licensing the same source, - reuse PBR materials and HDRIs, - track versions and revisions, - serve as the internal-library source for `asset-discovery` and `asset-fallback-strategy`.
8
+
9
+ ## Metadata & truth boundary
10
+ - **Canonical skill:** `skills/asset-library-plan/SKILL.md`
11
+ - **Contract:** `skills/asset-library-plan/contract.json` (`v1.0.0`)
12
+ - **Category / role:** `asset-and-sourcing` / `local-asset-library-taxonomy-planner`
13
+ - **Capability tier:** `L0`
14
+ - **Truth-state policy:** Runtime status defaults to `Not Run`; Artifact status defaults to `Not Produced`; mutation rule is `downgrade_only` (never upgrade without verified evidence).
15
+
16
+ ## When to use
17
+ - starting a new BlendOps repo with multiple recipes
18
+ - existing library is disorganized; recipes can't find assets
19
+ - before scaling to 50+ assets
20
+
21
+ ## Trigger cues
22
+ - "organize the assets"
23
+ - "asset library structure"
24
+ - "where should assets go"
25
+ - "name our assets"
26
+
27
+ ## When not to use
28
+ - single-recipe repo with < 5 assets → delegate to `asset-discovery` (`references/skills/asset-discovery.md`; Delegates out-of-scope requests to asset-discovery)
29
+ - pure planning before any asset categories or storage constraints are known → delegate to `asset-license-checker` (`references/skills/asset-license-checker.md`; Delegates out-of-scope requests to asset-license-checker)
30
+ - sourcing or acquiring external assets → delegate to `asset-discovery` (`references/skills/asset-discovery.md`; use asset-discovery)
31
+ - verifying asset licenses → delegate to `asset-license-checker` (`references/skills/asset-license-checker.md`; use asset-license-checker)
32
+ - checking visual style consistency across assets → delegate to `asset-style-check` (`references/skills/asset-style-check.md`; use asset-style-check)
33
+ - planning fallback substitutions when an asset is missing or fails → delegate to `asset-fallback-strategy` (`references/skills/asset-fallback-strategy.md`; use asset-fallback-strategy)
34
+ - enforcing file size or polygon/asset count performance budgets → delegate to `mobile-glb-budget` (`references/skills/mobile-glb-budget.md`; use mobile-glb-budget)
35
+
36
+ ## Inputs & output/evidence contract
37
+ ### Required inputs
38
+ - `raw_asset_inventory` (`array`): List of 3D models, PBR material sets, HDRIs, and license sidecar files to organize
39
+ - `project_storage_scope` (`string`): Whether the library is project-local or shared across multiple BlendOps packs
40
+
41
+ ### Optional inputs
42
+ - `naming_prefix_convention` (`string`): Optional studio or project naming prefix for datablocks and folders
43
+
44
+ ### Primary outputs
45
+ - `directory_taxonomy_plan`
46
+ - `datablock_naming_rules`
47
+ - `quarantine_and_license_sidecar_policy`
48
+
49
+ ## Quick-start procedure
50
+ 1. pin folder structure (kebab-case, by category)
51
+ 2. pin naming convention (asset name + version + license slug)
52
+ 3. pin metadata schema (license, source, date, version, hash)
53
+ 4. pin version control rules (LFS for large binaries, plain text for metadata)
54
+ 5. emit a library-init plan
55
+
56
+ ## Handoff notes
57
+ - **[upstream_reference]** External asset sourcing into this library → `asset-discovery` (`references/skills/asset-discovery.md`) — `when.all: [brief.locked equals true; assets.discoveryComplete equals false]`
58
+ - **[upstream_reference]** License verification (license file next to asset; unlicensed old assets to Quarantine) → `asset-license-checker` (`references/skills/asset-license-checker.md`) — `when.all: [assets.externalUsed equals true; assets.licenseCleared equals false]`
59
+ - **[upstream_reference]** Visual style consistency checks → `asset-style-check` (`references/skills/asset-style-check.md`) — `when.all: [assets.licenseCleared equals true; stage.current equals "style_check"]`
60
+ - **[fallback]** Consuming this library as fastest fallback source → `asset-fallback-strategy` (`references/skills/asset-fallback-strategy.md`) — `when.all: [assets.fallbackNeeded equals true]`
61
+ - **[progression]** File size and asset/polygon count pressure → `mobile-glb-budget` (`references/skills/mobile-glb-budget.md`) — `when.all: [artifact.type equals "glb"; budget.pinned equals false]`
62
+
63
+ ## Safety boundaries & non-goals
64
+ - **Runtime boundary:** Planning skill — never moves files, never configures git/LFS/DAM, never runs Blender, and never produces library files. Outputs a structure spec, migration steps, and review process only.
65
+ - Move, rename, or delete files.
66
+ - Configure git, Git LFS, Perforce, or DAM tools.
67
+ - Run Blender or execute Python.
68
+ - Buy or source external assets (use `asset-discovery`).
69
+ - Verify licenses, style consistency, or performance budgets (use `asset-license-checker`, `asset-style-check`, `mobile-glb-budget`).
@@ -0,0 +1,69 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/asset-license-checker/SKILL.md and skills/asset-license-checker/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # asset-license-checker (reference summary)
3
+
4
+ ## Purpose
5
+ Verify license compliance for downloaded 3D assets, textures, HDRIs, fonts before scene build or export.
6
+
7
+ Catch license risk before assets go into a scene that will be rendered, exported, or shipped. This is a planning / validation skill — does not modify assets, does not consult lawyers.
8
+
9
+ ## Metadata & truth boundary
10
+ - **Canonical skill:** `skills/asset-license-checker/SKILL.md`
11
+ - **Contract:** `skills/asset-license-checker/contract.json` (`v1.0.0`)
12
+ - **Category / role:** `asset-and-sourcing` / `asset-license-and-provenance-gate`
13
+ - **Capability tier:** `L0`
14
+ - **Truth-state policy:** Runtime status defaults to `Not Run`; Artifact status defaults to `Not Produced`; mutation rule is `downgrade_only` (never upgrade without verified evidence).
15
+
16
+ ## When to use
17
+ - Immediately after `asset-discovery` produces a candidate asset list.
18
+ - Before handing off to `asset-style-check`, `asset-library-plan`, or scene planners (`product-hero-scene-planner`, `character-portrait`, `environment-shot`, `interior-scene`, `product-grid-scene-planner`).
19
+ - Before `pre-handoff-verification`, `render-export-evidence`, `glb-web-handoff`, or `glb-animation-handoff`.
20
+ - Whenever a previously sourced asset's license or attribution requirement is unclear.
21
+
22
+ ## Trigger cues
23
+ - "is this license OK"
24
+ - "can I use this commercially"
25
+ - "what's the license"
26
+ - "license check"
27
+
28
+ ## When not to use
29
+ - Sourcing or searching for candidate assets → delegate to `asset-discovery` (`references/skills/asset-discovery.md`; Delegates out-of-scope requests to asset-discovery)
30
+ - Checking visual consistency, scale, or aesthetic fit across assets → delegate to `asset-style-check` (`references/skills/asset-style-check.md`; Delegates out-of-scope requests to asset-style-check)
31
+ - Replacing or working around rejected/blocked assets → delegate to `asset-fallback-strategy` (`references/skills/asset-fallback-strategy.md`; Delegates out-of-scope requests to asset-fallback-strategy)
32
+ - Structuring folders, naming conventions, or catalog storage → delegate to `asset-library-plan` (`references/skills/asset-library-plan.md`; Delegates out-of-scope requests to asset-library-plan)
33
+ - First-party assets authored entirely in-house with no external dependencies. → delegate to `asset-discovery` (`references/skills/asset-discovery.md`; Delegates out-of-scope requests to asset-discovery)
34
+ - Legal advice or binding legal interpretation (this skill flags risk only; escalate ambiguity to legal). → delegate to `asset-style-check` (`references/skills/asset-style-check.md`; Delegates out-of-scope requests to asset-style-check)
35
+
36
+ ## Inputs & output/evidence contract
37
+ ### Required inputs
38
+ - `candidate_assets` (`array`): Candidate external 3D models, textures, and HDRIs with source URLs and license labels
39
+ - `intended_distribution_use` (`string`): Target distribution context (commercial product marketing, web redistribution, internal preview)
40
+
41
+ ### Optional inputs
42
+ - `attribution_delivery_surface` (`string`): Where attribution credits can be displayed if CC-BY-4.0 assets are used
43
+
44
+ ### Primary outputs
45
+ - `per_asset_license_verdict_table`
46
+ - `attribution_obligations_list`
47
+ - `quarantined_or_blocked_assets`
48
+
49
+ ## Quick-start procedure
50
+ 1. Receive the sourced external asset list from `asset-discovery` (models, textures, HDRIs, fonts, sounds, brushes).
51
+ 2. Record source URL, documented license name, and stated permissions per asset.
52
+ 3. Flag risk per asset (`Pass` / `Warn` / `Fail`) and specify required attribution lines and attribution plan.
53
+ 4. Gate progression: hand off to `asset-style-check`, `asset-library-plan`, or `workflow-stage-router` only if all rows are `Pass` or explicitly accepted `Warn`; route any `Fail` rows to `asset-fallback-strategy`.
54
+
55
+ ## Handoff notes
56
+ - **[upstream_reference]** Upstream asset sourcing → `asset-discovery` (`references/skills/asset-discovery.md`) — `when.all: [brief.locked equals true; assets.discoveryComplete equals false]`
57
+ - **[progression]** Visual style validation → `asset-style-check` (`references/skills/asset-style-check.md`) — `when.all: [assets.licenseCleared equals true; stage.current equals "style_check"]`
58
+ - **[fallback]** Rejected/blocked asset handling → `asset-fallback-strategy` (`references/skills/asset-fallback-strategy.md`) — `when.all: [assets.fallbackNeeded equals true]`
59
+ - **[progression]** Asset library organization → `asset-library-plan` (`references/skills/asset-library-plan.md`) — `when.all: [assets.discoveryComplete equals true; stage.current equals "library_organization"]`
60
+ - **[progression]** Stage routing & scene planning gate → `workflow-stage-router` (`references/skills/workflow-stage-router.md`) — `when.all: [preflight.passed equals true; inventory.exists equals true]`
61
+
62
+ ## Safety boundaries & non-goals
63
+ - **Runtime boundary:** Validation skill — does not modify assets, does not run Blender. Verdicts are based on documented license terms, not legal interpretation. **Not legal advice**: when in doubt, recommend the user consult their legal team.
64
+ - Give legal advice or interpret complex contracts (escalate ambiguity to legal).
65
+ - Source or discover candidate assets (`asset-discovery`).
66
+ - Check visual style or aesthetic consistency (`asset-style-check`).
67
+ - Plan fallbacks or replacements for failed assets (`asset-fallback-strategy`).
68
+ - Organize asset libraries or folder structures (`asset-library-plan`).
69
+ - Modify asset files, write Python, or run Blender.
@@ -0,0 +1,69 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/asset-style-check/SKILL.md and skills/asset-style-check/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # asset-style-check (reference summary)
3
+
4
+ ## Purpose
5
+ Verify chosen assets share visual style (realism, detail, color treatment) before scene build; flag style drift between assets early.
6
+
7
+ Catch style mismatches between assets before they end up in the same scene where the inconsistency reads as compositing error.
8
+
9
+ ## Metadata & truth boundary
10
+ - **Canonical skill:** `skills/asset-style-check/SKILL.md`
11
+ - **Contract:** `skills/asset-style-check/contract.json` (`v1.0.0`)
12
+ - **Category / role:** `asset-and-sourcing` / `cross-asset-visual-coherence-validator`
13
+ - **Capability tier:** `L0`
14
+ - **Truth-state policy:** Runtime status defaults to `Not Run`; Artifact status defaults to `Not Produced`; mutation rule is `downgrade_only` (never upgrade without verified evidence).
15
+
16
+ ## When to use
17
+ - after `asset-license-checker` clears the assets
18
+ - before scene build
19
+ - when a scene preview shows visible style mismatch
20
+ - when assets come from multiple sources
21
+
22
+ ## Trigger cues
23
+ - "do these assets fit together"
24
+ - "style check the assets"
25
+ - "scene feels like a collage"
26
+
27
+ ## When not to use
28
+ - single isolated asset where no multi-asset or scene-brief consistency check is requested → delegate to `asset-discovery` (`references/skills/asset-discovery.md`; Delegates out-of-scope requests to asset-discovery)
29
+ - pure planning before candidate assets are picked → delegate to `asset-discovery` (`references/skills/asset-discovery.md`; use asset-discovery)
30
+ - intentionally mixed-style art direction, ONLY when the locked brief explicitly specifies mixed styles → delegate to `asset-license-checker` (`references/skills/asset-license-checker.md`; Delegates out-of-scope requests to asset-license-checker)
31
+ - checking asset licenses (asset-license-checker), polygon/performance budgets (polycount-budget-checker), topology, or planning materials/lighting (blender-light → delegate to `asset-license-checker` (`references/skills/asset-license-checker.md`; lighting-material-plan)
32
+
33
+ ## Inputs & output/evidence contract
34
+ ### Required inputs
35
+ - `candidate_asset_list` (`array`): Sourced 3D models, materials, and props to evaluate for visual coherence
36
+ - `brief_style_direction` (`string`): Pinned visual style, proportion language, texel density, and surface wear target from brief
37
+
38
+ ### Optional inputs
39
+ - `hero_anchor_asset` (`string`): Primary hero asset used as the visual benchmark for secondary props
40
+
41
+ ### Primary outputs
42
+ - `style_coherence_matrix`
43
+ - `mismatched_asset_flags`
44
+ - `remediation_or_fallback_recommendations`
45
+
46
+ ## Quick-start procedure
47
+ 1. list every asset planned for the scene
48
+ 2. evaluate each on style axes (realism / detail / color / surface)
49
+ 3. flag drift between assets
50
+ 4. recommend remediation (drop / restyle / replace)
51
+
52
+ ## Handoff notes
53
+ - **[upstream_reference]** Upstream discovery → `asset-discovery` (`references/skills/asset-discovery.md`) — `when.all: [brief.locked equals true; assets.discoveryComplete equals false]`
54
+ - **[upstream_reference]** Upstream license gate → `asset-license-checker` (`references/skills/asset-license-checker.md`) — `when.all: [assets.externalUsed equals true; assets.licenseCleared equals false]`
55
+ - **[upstream_reference]** Upstream brief lock → `intent-to-3d-brief-writer` (`references/skills/intent-to-3d-brief-writer.md`) — `when.all: [goal.clarity equals "clear"; brief.locked equals false]`
56
+ - **[boundary_delegation]** Scope enforcement → `scope-guard` (`references/skills/scope-guard.md`) — `when.all: [scope.driftDetected equals true]`
57
+ - **[fallback]** Rejected asset fallback → `asset-fallback-strategy` (`references/skills/asset-fallback-strategy.md`) — `when.all: [assets.fallbackNeeded equals true]`
58
+ - **[progression]** Approved asset organization → `asset-library-plan` (`references/skills/asset-library-plan.md`) — `when.all: [assets.discoveryComplete equals true; stage.current equals "library_organization"]`
59
+ - **[progression]** Broad scene review → `scene-readiness` (`references/skills/scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
60
+ - **[progression]** Material & lookdev boundary (lighting-material-plan) → `lighting-material-plan` (`references/skills/lighting-material-plan.md`) — `when.all: [brief.locked equals true; stage.current equals "lookdev_planning"]`
61
+ - **[progression]** Material & lookdev boundary (material-quality-checker) → `material-quality-checker` (`references/skills/material-quality-checker.md`) — `when.all: [quality.domain equals "material"; quality.verdict equals "not_run"]`
62
+ - **[progression]** Budget & topology boundary → `polycount-budget-checker` (`references/skills/polycount-budget-checker.md`) — `when.all: [quality.domain equals "polycount"; budget.verdict equals "Not Run"]`
63
+
64
+ ## Safety boundaries & non-goals
65
+ - **Runtime boundary:** Validation-only skill — never modifies or re-styles assets, and never executes Blender or Python. Per-asset verdicts (`Pass | Warn | Fail`) and drift classifications (`None | Minor | Major`) are derived solely from documented asset previews and the locked style brief, and are tracked separately from runtime/artifact truth states (which default to `Not Produced` for artifacts and are downgrade-only).
66
+ - Never modify or re-style assets.
67
+ - Never check asset licenses (belongs to `asset-license-checker`).
68
+ - Never check polycount budgets or mesh topology (belongs to `polycount-budget-checker`).
69
+ - Never execute Blender or Python code.
@@ -0,0 +1,62 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/blender-brainstorming/SKILL.md and skills/blender-brainstorming/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # blender-brainstorming (reference summary)
3
+
4
+ ## Purpose
5
+ Socratic exploration of a non-Blender-user's 3D intent before scene planning. Use when the request is vague, has multiple plausible interpretations, or needs creative scoping.
6
+
7
+ Run a structured Socratic brainstorming pass on a vague non-Blender-user 3D request before any scene planner, runtime readiness, or evidence skill is invoked. Surface the user's actual intent, missing constraints, and decision points so downstream skills do not waste effort on the wrong direction.
8
+
9
+ ## Metadata & truth boundary
10
+ - **Canonical skill:** `skills/blender-brainstorming/SKILL.md`
11
+ - **Contract:** `skills/blender-brainstorming/contract.json` (`v1.0.0`)
12
+ - **Category / role:** `process-discipline` / `pre-brief-ideation-and-clarification`
13
+ - **Capability tier:** `L0`
14
+ - **Truth-state policy:** Runtime status defaults to `Not Run`; Artifact status defaults to `Not Produced`; mutation rule is `downgrade_only` (never upgrade without verified evidence).
15
+
16
+ ## When to use
17
+ - the user request is short, ambiguous, or missing critical context (subject, mood, deliverable, evidence expectations)
18
+ - multiple plausible interpretations exist (e.g. "make me a cool product render" — what product, what mood, web or print, GLB or render?)
19
+ - the user is non-Blender-technical and may not realize what BlendOps must know to plan well
20
+ - before any planner skill (`product-hero-scene-planner`, `camera-composition`, …)
21
+
22
+ ## Trigger cues
23
+ - "I want a 3D render of..." (vague)"
24
+ - "Make me something cool with..."
25
+ - "Help me plan a Blender scene" (no constraints given)"
26
+ - "I'm not sure what I want exactly..."
27
+ - "Brainstorm with me about..."
28
+
29
+ ## When not to use
30
+ - the user already provided a structured brief (route directly to intent-to-3d-brief-writer to lock the brief before any planner runs) → delegate to `intent-to-3d-brief-writer` (`references/skills/intent-to-3d-brief-writer.md`; route directly to intent-to-3d-brief-writer to lock the brief before any planner runs)
31
+ - the user explicitly asked to skip clarification (record explicit assumptions and route to intent-to-3d-brief-writer) → delegate to `intent-to-3d-brief-writer` (`references/skills/intent-to-3d-brief-writer.md`; record explicit assumptions and route to intent-to-3d-brief-writer)
32
+ - the user pushes for immediate execution rather than exploration → delegate to `runtime-readiness` (`references/skills/runtime-readiness.md`; route to runtime-readiness)
33
+
34
+ ## Inputs & output/evidence contract
35
+ ### Required inputs
36
+ - `initial_user_idea` (`string`): Vague, exploratory, or open-ended 3D concept from the user
37
+
38
+ ### Optional inputs
39
+ - `brand_or_mood_references` (`array`): Optional mood keywords, reference products, or target audience notes
40
+
41
+ ### Primary outputs
42
+ - `divergent_concept_options`
43
+ - `clarifying_questions_shortlist`
44
+ - `recommended_direction_for_brief`
45
+
46
+ ## Quick-start procedure
47
+ 1. ask 3-5 minimum clarifying questions
48
+ 2. propose 2-3 alternative scopings
49
+ 3. end with a one-paragraph intent summary the user can confirm
50
+ 4. hand off to `intent-to-3d-brief-writer` once intent is confirmed
51
+
52
+ ## Handoff notes
53
+ - **[progression]** Lock the confirmed brief downstream → `intent-to-3d-brief-writer` (`references/skills/intent-to-3d-brief-writer.md`) — `when.all: [goal.clarity equals "clear"; brief.locked equals false]`
54
+ - **[progression]** User pushes for execution mid-brainstorm → `runtime-readiness` (`references/skills/runtime-readiness.md`) — `when.all: [runtime.path not_equals "unselected"; runtime.verifiedReady equals false]`
55
+ - **[progression]** Explain blocked runtime status to user → `plain-language-response` (`references/skills/plain-language-response.md`) — `when.all: [stage.current equals "final_communication"]`
56
+
57
+ ## Safety boundaries & non-goals
58
+ - **Runtime boundary:** This skill does not install Blender, run Blender, or configure any MCP path. It is text-only conversation.
59
+ - runtime setup
60
+ - artifact production
61
+ - deciding the final scene plan (that's the planner's job)
62
+ - one-shot interpretation of vague requests
@@ -0,0 +1,66 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/blender-recipe-decomposer/SKILL.md and skills/blender-recipe-decomposer/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # blender-recipe-decomposer (reference summary)
3
+
4
+ ## Purpose
5
+ Break over-scoped Blender intent into 2-5 cohesive recipes with brief seeds, stop conditions, order, dependencies, shared assets, and handoffs.
6
+
7
+ When user intent is too big for one recipe (multiple deliverables, mixed modes, conflicting briefs), split it into smaller recipes that each fit the BlendOps recipe shape (brief → plan → assets → runtime → handoff).
8
+
9
+ ## Metadata & truth boundary
10
+ - **Canonical skill:** `skills/blender-recipe-decomposer/SKILL.md`
11
+ - **Contract:** `skills/blender-recipe-decomposer/contract.json` (`v1.0.0`)
12
+ - **Category / role:** `process-discipline` / `multi-deliverable-recipe-splitter`
13
+ - **Capability tier:** `L0`
14
+ - **Truth-state policy:** Runtime status defaults to `Not Run`; Artifact status defaults to `Not Produced`; mutation rule is `downgrade_only` (never upgrade without verified evidence).
15
+
16
+ ## When to use
17
+ - intent has multiple distinct deliverables (e.g., hero render + animation + GLB + variant grid)
18
+ - intent crosses multiple scene types (portrait + environment in one ask)
19
+ - previous attempts collapsed under their own scope
20
+ - before any planner runs
21
+
22
+ ## Trigger cues
23
+ - "I want all of these"
24
+ - "this is a lot"
25
+ - "we'll need several outputs"
26
+ - "across these scenes"
27
+
28
+ ## When not to use
29
+ - single deliverable that is already right-sized (hand off directly to intent-to-3d-brief-writer) → delegate to `intent-to-3d-brief-writer` (`references/skills/intent-to-3d-brief-writer.md`; hand off directly to intent-to-3d-brief-writer)
30
+ - pure exploration or open ideation → delegate to `blender-brainstorming` (`references/skills/blender-brainstorming.md`; use blender-brainstorming instead)
31
+ - after recipes are already split or running → delegate to `scope-guard` (`references/skills/scope-guard.md`; use scope-guard for added scope or done-criteria to evaluate completion)
32
+
33
+ ## Inputs & output/evidence contract
34
+ ### Required inputs
35
+ - `multi_deliverable_request` (`string`): User request spanning multiple scenes, deliverables, or incompatible output channels
36
+ - `candidate_recipes` (`array`): Candidate BlendOps recipes or packs identified by recipe-fit-assessor
37
+
38
+ ### Optional inputs
39
+ - `delivery_priority_order` (`array`): Optional user preference on which deliverable to ship first
40
+
41
+ ### Primary outputs
42
+ - `ordered_sub_workflow_tracks`
43
+ - `shared_asset_and_brief_dependencies`
44
+ - `first_track_next_skill`
45
+
46
+ ## Quick-start procedure
47
+ 1. enumerate distinct deliverables in the user intent
48
+ 2. group them into 2-5 cohesive recipes and plan shared assets early
49
+ 3. give each recipe a name, one-line brief seed, one-line stop condition seed, explicit out-of-scope boundary, and handoff target
50
+ 4. pin recipe start order (linear or parallel-OK) and dependencies
51
+
52
+ ## Handoff notes
53
+ - **[progression]** Full brief authoring for each split recipe → `intent-to-3d-brief-writer` (`references/skills/intent-to-3d-brief-writer.md`) — `when.all: [goal.clarity equals "clear"; brief.locked equals false]`
54
+ - **[progression]** Pinning formal done conditions per recipe → `done-criteria` (`references/skills/done-criteria.md`) — `when.all: [brief.locked equals true; stage.current equals "stop_condition"]`
55
+ - **[progression]** Workflow stage gates per recipe → `stage-gates` (`references/skills/stage-gates.md`) — `when.all: [brief.locked equals true; stage.current equals "stage_gates"]`
56
+ - **[progression]** Handling scope added after splitting → `scope-guard` (`references/skills/scope-guard.md`) — `when.all: [scope.driftDetected equals true]`
57
+ - **[upstream_reference]** Pre-decomposition ideation when deliverables are unclear → `blender-brainstorming` (`references/skills/blender-brainstorming.md`) — `when.all: [goal.clarity equals "ambiguous_or_mixed"]`
58
+
59
+ ## Safety boundaries & non-goals
60
+ - **Runtime boundary:** Process / discipline skill — does not run Blender. Splits intent into recipe specs only.
61
+ - Run Blender, write Python, or render/export any artifacts.
62
+ - Author full 3D briefs (belongs to `intent-to-3d-brief-writer`).
63
+ - Pin formal acceptance/stop gates (belongs to `done-criteria`).
64
+ - Run per-recipe checklist stage gates (belongs to `stage-gates`).
65
+ - Enforce scope creep after recipes are already split (belongs to `scope-guard`).
66
+ - Make or upgrade runtime or artifact truth claims.
@@ -0,0 +1,78 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/blender-troubleshooting/SKILL.md and skills/blender-troubleshooting/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # blender-troubleshooting (reference summary)
3
+
4
+ ## Purpose
5
+ Structured 4-phase root-cause analysis when Blender output looks wrong. Use when render, export, scene, or handoff doesn't match intent and you need disciplined debug, not guesses.
6
+
7
+ Run a structured 4-phase root-cause analysis when a Blender output (render, export, GLB, preview, or final response) does not match the confirmed intent. Surface the actual cause before proposing any fix. Inspired by the `/systematic-debugging` skill in Anthropic Superpowers, adapted for Blender / non-Blender-user domain.
8
+
9
+ ## Metadata & truth boundary
10
+ - **Canonical skill:** `skills/blender-troubleshooting/SKILL.md`
11
+ - **Contract:** `skills/blender-troubleshooting/contract.json` (`v1.0.0`)
12
+ - **Category / role:** `runtime-and-execution` / `scene-and-runtime-failure-diagnostician`
13
+ - **Capability tier:** `L0`
14
+ - **Truth-state policy:** Runtime status defaults to `Not Run`; Artifact status defaults to `Not Produced`; mutation rule is `downgrade_only` (never upgrade without verified evidence).
15
+
16
+ ## When to use
17
+ - a render came out black, blown out, missing assets, or just "wrong"
18
+ - a GLB export is empty, mis-scaled, or fails validation
19
+ - the non-Blender-user response sounds wrong (jargon-heavy, contradicted by evidence)
20
+ - the runtime smoke test passed but the recipe failed
21
+ - intent was clear but result diverges in a specific, reproducible way
22
+
23
+ ## Trigger cues
24
+ - "the render looks wrong"
25
+ - "the GLB doesn't open / looks empty / is wrong scale"
26
+ - "the output doesn't match what I asked for"
27
+ - "why did it produce X instead of Y?"
28
+ - "debug this Blender output"
29
+
30
+ ## When not to use
31
+ - the user has not yet stated a clear expected outcome (run intent-to-3d-brief-writer first) → delegate to `intent-to-3d-brief-writer` (`references/skills/intent-to-3d-brief-writer.md`; run intent-to-3d-brief-writer first)
32
+ - runtime has never been attempted (run runtime-readiness first) → delegate to `runtime-readiness` (`references/skills/runtime-readiness.md`; run runtime-readiness first)
33
+ - the request is creative iteration ("can we make it more dramatic"), not debugging → delegate to `blender-brainstorming` (`references/skills/blender-brainstorming.md`; Delegates out-of-scope requests to blender-brainstorming)
34
+ - the user wants a one-shot fix without diagnostic discipline → delegate to `intent-to-3d-brief-writer` (`references/skills/intent-to-3d-brief-writer.md`; Delegates out-of-scope requests to intent-to-3d-brief-writer)
35
+
36
+ ## Inputs & output/evidence contract
37
+ ### Required inputs
38
+ - `observed_symptom_or_error` (`string`): Observed render defect, broken GLB export, scale mismatch, or MCP execution failure
39
+ - `active_workflow_context` (`object`): Current scene plan, runtime path, and recent actions preceding the failure
40
+
41
+ ### Optional inputs
42
+ - `runtime_attempt_notes` (`string`): Optional error output or attempt timeline from runtime-attempt-report
43
+
44
+ ### Primary outputs
45
+ - `root_cause_classification`
46
+ - `minimal_remediation_plan`
47
+ - `reverification_target_skill`
48
+
49
+ ## Quick-start procedure
50
+ 1. collect the symptom statement, expected outcome, and observed outcome
51
+ 2. run the 4 phases: reproduce → narrow → identify root cause → propose fix
52
+ 3. gate every conclusion on observable evidence
53
+ 4. hand off the fix proposal to the relevant planner / readiness / evidence skill
54
+
55
+ ## Handoff notes
56
+ - **[upstream_reference]** If divergence at intent (blender-brainstorming) → `blender-brainstorming` (`references/skills/blender-brainstorming.md`) — `when.all: [goal.clarity equals "ambiguous_or_mixed"]`
57
+ - **[upstream_reference]** If divergence at intent (intent-to-3d-brief-writer) → `intent-to-3d-brief-writer` (`references/skills/intent-to-3d-brief-writer.md`) — `when.all: [goal.clarity equals "clear"; brief.locked equals false]`
58
+ - **[conditional]** If divergence at planning (camera-composition) → `camera-composition` (`references/skills/camera-composition.md`) — `when.all: [brief.locked equals true; stage.current equals "camera_planning"]`
59
+ - **[conditional]** If divergence at planning (lighting-material-plan) → `lighting-material-plan` (`references/skills/lighting-material-plan.md`) — `when.all: [brief.locked equals true; stage.current equals "lookdev_planning"]`
60
+ - **[alternative]** If divergence at planning (character-portrait) → `character-portrait` (`references/skills/character-portrait.md`) — `when.all: [brief.locked equals true; recipe.domain equals "character_portrait"]`
61
+ - **[alternative]** If divergence at planning (environment-shot) → `environment-shot` (`references/skills/environment-shot.md`) — `when.all: [brief.locked equals true; recipe.domain equals "environment_shot"]`
62
+ - **[alternative]** If divergence at planning (interior-scene) → `interior-scene` (`references/skills/interior-scene.md`) — `when.all: [brief.locked equals true; recipe.domain equals "interior_archviz"]`
63
+ - **[alternative]** If divergence at planning (product-grid-scene-planner) → `product-grid-scene-planner` (`references/skills/product-grid-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.domain equals "product_grid"]`
64
+ - **[alternative]** If divergence at planning (product-hero-scene-planner) → `product-hero-scene-planner` (`references/skills/product-hero-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.domain equals "product_hero"]`
65
+ - **[upstream_reference]** If divergence at execution (runtime-readiness) → `runtime-readiness` (`references/skills/runtime-readiness.md`) — `when.all: [runtime.path not_equals "unselected"; runtime.verifiedReady equals false]`
66
+ - **[fallback]** If divergence at execution (bridge-conflicts) → `bridge-conflicts` (`references/skills/bridge-conflicts.md`) — `when.all: [runtime.conflictDetected equals true]`
67
+ - **[upstream_reference]** If divergence at execution (runtime-path-picker) → `runtime-path-picker` (`references/skills/runtime-path-picker.md`) — `when.all: [runtime.path equals "unselected"]`
68
+ - **[conditional]** If divergence at output (glb-animation-handoff) → `glb-animation-handoff` (`references/skills/glb-animation-handoff.md`) — `when.all: [artifact.hasAnimation equals true; stage.current equals "animation_handoff"]`
69
+ - **[conditional]** If divergence at output (glb-web-handoff) → `glb-web-handoff` (`references/skills/glb-web-handoff.md`) — `when.all: [artifact.type equals "glb"; handoff.consumerStack equals "web_glb"]`
70
+ - **[conditional]** If divergence at output (render-export-evidence) → `render-export-evidence` (`references/skills/render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
71
+ - **[conditional]** If divergence at response → `plain-language-response` (`references/skills/plain-language-response.md`) — `when.all: [stage.current equals "final_communication"]`
72
+
73
+ ## Safety boundaries & non-goals
74
+ - **Runtime boundary:** This skill does not install Blender, run Blender, mutate scenes, render, export, or claim artifacts. It guides diagnosis. Any actual re-run goes through the relevant runtime skill (`runtime-readiness`, `render-export-evidence`).
75
+ - running Blender
76
+ - writing fix code
77
+ - guessing without evidence
78
+ - replacing the runtime evidence skill
@@ -0,0 +1,82 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/blendops-help/SKILL.md and skills/blendops-help/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # blendops-help (reference summary)
3
+
4
+ ## Purpose
5
+ Route users to the right BlendOps skill, document, or next safe action without overclaiming runtime, artifact, or package readiness.
6
+
7
+ Help an agent or user decide the single safest next action in BlendOps when the goal is unclear, current status is unknown, or an entry point into skills, docs, runtime readiness, packaging, or release review is needed.
8
+
9
+ ## Metadata & truth boundary
10
+ - **Canonical skill:** `skills/blendops-help/SKILL.md`
11
+ - **Contract:** `skills/blendops-help/contract.json` (`v1.0.0`)
12
+ - **Category / role:** `routing-and-governance` / `ambiguous-intent-entry-router`
13
+ - **Capability tier:** `L0`
14
+ - **Routing precedence:** group `entry-and-stage-routing`, rank `1` | activationGate: `goalClarity="ambiguous_or_mixed"`, `recipeSelected=false`, `preflightPassed=false`, `hasStageOrArtifactInventory=false`
15
+ - **Truth-state policy:** Runtime status defaults to `Not Run`; Artifact status defaults to `Not Produced`; mutation rule is `downgrade_only` (never upgrade without verified evidence).
16
+
17
+ ## When to use
18
+ - the user asks “what should I do next?” and the goal or current state is unclear
19
+ - the user is unsure how to enter the BlendOps skill catalog or documentation
20
+ - runtime, artifact, packaging, or release status is unknown and needs initial triage
21
+ - no workflow artifacts exist yet and the user needs a safe starting skill or doc
22
+ - an agent needs a concise entry-point recommendation before starting work
23
+
24
+ ## Trigger cues
25
+ - "What should I do next?"
26
+ - "Which BlendOps skill should I use?"
27
+ - "Is this ready?"
28
+ - "Can I run the runtime eval?"
29
+ - "How do I package/install BlendOps?"
30
+ - "What is blocked?"
31
+
32
+ ## When not to use
33
+ - The goal is clear, preflight is passed, and stage or artifact inventory already exists → delegate to `workflow-stage-router` (`references/skills/workflow-stage-router.md`; Selects the single immediate next skill from a locked precedence order and exits to pre-handoff-verification on any failed gate)
34
+ - The goal is clear and the user wants to select the right recipe or pack → delegate to `recipe-fit-assessor` (`references/skills/recipe-fit-assessor.md`; Scores candidate recipes/packs and detects multi-deliverable scope)
35
+ - A recipe or pack is already selected and needs preflight readiness verification → delegate to `pack-prerequisite-checker` (`references/skills/pack-prerequisite-checker.md`; Evaluates the preflight matrix across brief completeness, runtime posture, and asset readiness)
36
+ - The user explicitly asks to turn an idea into a structured 3D brief → delegate to `intent-to-3d-brief-writer` (`references/skills/intent-to-3d-brief-writer.md`; Locks the canonical 8-slot 3D brief before scene planning)
37
+ - The user asks to plan a product-hero scene directly → delegate to `product-hero-scene-planner` (`references/skills/product-hero-scene-planner.md`; Handles domain-specific scene planning once brief and recipe are known)
38
+ - The user asks for render or export artifact verification → delegate to `render-export-evidence` (`references/skills/render-export-evidence.md`; Classifies artifact truth states from on-disk paths and validation notes)
39
+ - The user asks for Blender MCP runtime preflight verification → delegate to `runtime-readiness` (`references/skills/runtime-readiness.md`; Verifies Path 1 or Path 2 runtime readiness without claiming execution)
40
+
41
+ ## Inputs & output/evidence contract
42
+ ### Required inputs
43
+ - `user_request` (`string`): Ambiguous, mixed, or entry-level user question about BlendOps capabilities or next action
44
+
45
+ ### Optional inputs
46
+ - `current_status_context` (`object`): Optional context about known files, docs, or blockers
47
+
48
+ ### Primary outputs
49
+ - `recommended_next_action`
50
+ - `target_skill_or_doc`
51
+ - `why_this_is_safe`
52
+
53
+ ## Quick-start procedure
54
+ 1. Ask for the current goal and status if missing.
55
+ 2. If the goal is already clear and artifacts exist, hand off immediately to `workflow-stage-router`.
56
+ 3. Otherwise, identify whether the entry need is brief/planning setup, runtime readiness, evidence verification, install/package docs, or release review.
57
+ 4. Route to the single smallest safe skill or doc.
58
+ 5. Preserve release, runtime, and artifact truth (downgrade-only, never upgrade).
59
+
60
+ ## Handoff notes
61
+ - **[progression]** Recipe or pack selection when goal becomes clear → `recipe-fit-assessor` (`references/skills/recipe-fit-assessor.md`) — `when.all: [goal.clarity equals "clear"; recipe.selected equals false]`
62
+ - **[conditional]** Pack preflight readiness check when recipe is already chosen → `pack-prerequisite-checker` (`references/skills/pack-prerequisite-checker.md`) — `when.all: [recipe.selected equals true; preflight.passed equals false]`
63
+ - **[conditional]** In-flight workflow routing (clear goal + existing artifacts) → `workflow-stage-router` (`references/skills/workflow-stage-router.md`) — `when.all: [goal.clarity equals "clear"; preflight.passed equals true; inventory.exists equals true]`
64
+ - **[progression]** Initial 3D brief creation → `intent-to-3d-brief-writer` (`references/skills/intent-to-3d-brief-writer.md`) — `when.all: [brief.locked equals false]`
65
+ - **[conditional]** Runtime path selection → `runtime-path-picker` (`references/skills/runtime-path-picker.md`) — `when.all: [request.topic equals "runtime_selection"]`
66
+ - **[conditional]** Official runtime setup → `runtime-setup` (`references/skills/runtime-setup.md`) — `when.all: [request.topic equals "runtime_setup"]`
67
+ - **[conditional]** Runtime readiness preflight → `runtime-readiness` (`references/skills/runtime-readiness.md`) — `when.all: [request.topic equals "runtime_readiness"]`
68
+ - **[fallback]** MCP bridge port/session conflict → `bridge-conflicts` (`references/skills/bridge-conflicts.md`) — `when.all: [runtime.conflictDetected equals true]`
69
+ - **[alternative]** Scene planning → `product-hero-scene-planner` (`references/skills/product-hero-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.id equals "product-hero-v0"]`
70
+ - **[conditional]** Render/export evidence → `render-export-evidence` (`references/skills/render-export-evidence.md`) — `when.all: [request.topic equals "artifact_evidence"]`
71
+ - **[fallback]** Failed workflow gate / pre-handoff check → `pre-handoff-verification` (`references/skills/pre-handoff-verification.md`) — `when.all: [gate.status equals "failed"]`
72
+ - **[conditional]** GLB handoff → `glb-web-handoff` (`references/skills/glb-web-handoff.md`) — `when.all: [request.topic equals "glb_handoff"]`
73
+ - **[progression]** Final response → `plain-language-response` (`references/skills/plain-language-response.md`) — `when.all: [stage.current equals "final_communication"]`
74
+
75
+ ## Safety boundaries & non-goals
76
+ - **Runtime boundary:** Before runtime work, point to `docs/runtime-stack-strategy.md`, `runtime-path-picker`, and `runtime-readiness`.
77
+ - Replace or duplicate `workflow-stage-router` precedence logic once the goal is clear and artifacts exist.
78
+ - Install Blender or runtimes.
79
+ - Run Blender or execute Python.
80
+ - Create or mutate scene data.
81
+ - Render/export artifacts.
82
+ - Publish packages or marketplace listings.