blendops 0.0.0-stage → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (484) hide show
  1. package/CHANGELOG.md +62 -0
  2. package/LICENSE +21 -0
  3. package/README.md +189 -2
  4. package/bin/blendops.mjs +4 -0
  5. package/bundles/claude-desktop-manual/BLENDOPS_SINGLE_FILE.md +78 -0
  6. package/bundles/claude-desktop-manual/IMPORT_STEPS.md +43 -0
  7. package/bundles/claude-desktop-manual/INSTALL_REPORT_TEMPLATE.md +13 -0
  8. package/bundles/claude-desktop-manual/README.md +70 -0
  9. package/bundles/claude-desktop-manual/SKILL.md +62 -0
  10. package/bundles/claude-desktop-manual/manifest.json +278 -0
  11. package/bundles/claude-desktop-manual/references/evidence-rules.md +13 -0
  12. package/bundles/claude-desktop-manual/references/install-boundary.md +13 -0
  13. package/bundles/claude-desktop-manual/references/laws/evidence-before-done.md +14 -0
  14. package/bundles/claude-desktop-manual/references/laws/no-arbitrary-python-interface.md +12 -0
  15. package/bundles/claude-desktop-manual/references/laws/non-blender-user-language.md +13 -0
  16. package/bundles/claude-desktop-manual/references/laws/official-runtime-only.md +20 -0
  17. package/bundles/claude-desktop-manual/references/packs/product-hero-v0.md +30 -0
  18. package/bundles/claude-desktop-manual/references/runtime-stacks.md +13 -0
  19. package/bundles/claude-desktop-manual/references/skill-map.md +36 -0
  20. package/bundles/claude-desktop-manual/references/skills/acceptance-criteria-builder.md +69 -0
  21. package/bundles/claude-desktop-manual/references/skills/asset-discovery.md +73 -0
  22. package/bundles/claude-desktop-manual/references/skills/asset-fallback-strategy.md +66 -0
  23. package/bundles/claude-desktop-manual/references/skills/asset-library-plan.md +69 -0
  24. package/bundles/claude-desktop-manual/references/skills/asset-license-checker.md +69 -0
  25. package/bundles/claude-desktop-manual/references/skills/asset-style-check.md +69 -0
  26. package/bundles/claude-desktop-manual/references/skills/blender-brainstorming.md +62 -0
  27. package/bundles/claude-desktop-manual/references/skills/blender-recipe-decomposer.md +66 -0
  28. package/bundles/claude-desktop-manual/references/skills/blender-troubleshooting.md +78 -0
  29. package/bundles/claude-desktop-manual/references/skills/blendops-help.md +82 -0
  30. package/bundles/claude-desktop-manual/references/skills/bridge-conflicts.md +68 -0
  31. package/bundles/claude-desktop-manual/references/skills/camera-composition.md +65 -0
  32. package/bundles/claude-desktop-manual/references/skills/character-portrait.md +68 -0
  33. package/bundles/claude-desktop-manual/references/skills/cli-appendix-job-outline.md +62 -0
  34. package/bundles/claude-desktop-manual/references/skills/color-management-decision.md +68 -0
  35. package/bundles/claude-desktop-manual/references/skills/composition-quality-checker.md +71 -0
  36. package/bundles/claude-desktop-manual/references/skills/cycles-vs-eevee-decision.md +65 -0
  37. package/bundles/claude-desktop-manual/references/skills/done-criteria.md +70 -0
  38. package/bundles/claude-desktop-manual/references/skills/environment-shot.md +65 -0
  39. package/bundles/claude-desktop-manual/references/skills/glb-animation-handoff.md +69 -0
  40. package/bundles/claude-desktop-manual/references/skills/glb-web-handoff.md +68 -0
  41. package/bundles/claude-desktop-manual/references/skills/intent-to-3d-brief-writer.md +68 -0
  42. package/bundles/claude-desktop-manual/references/skills/interior-scene.md +73 -0
  43. package/bundles/claude-desktop-manual/references/skills/lighting-material-plan.md +65 -0
  44. package/bundles/claude-desktop-manual/references/skills/lighting-quality-checker.md +70 -0
  45. package/bundles/claude-desktop-manual/references/skills/material-quality-checker.md +71 -0
  46. package/bundles/claude-desktop-manual/references/skills/mobile-glb-budget.md +73 -0
  47. package/bundles/claude-desktop-manual/references/skills/output-format-decision.md +63 -0
  48. package/bundles/claude-desktop-manual/references/skills/pack-prerequisite-checker.md +74 -0
  49. package/bundles/claude-desktop-manual/references/skills/path-one-host-outline.md +66 -0
  50. package/bundles/claude-desktop-manual/references/skills/plain-language-response.md +70 -0
  51. package/bundles/claude-desktop-manual/references/skills/polycount-budget-checker.md +71 -0
  52. package/bundles/claude-desktop-manual/references/skills/pre-handoff-verification.md +76 -0
  53. package/bundles/claude-desktop-manual/references/skills/preview-report.md +62 -0
  54. package/bundles/claude-desktop-manual/references/skills/product-grid-scene-planner.md +72 -0
  55. package/bundles/claude-desktop-manual/references/skills/product-hero-scene-planner.md +68 -0
  56. package/bundles/claude-desktop-manual/references/skills/r3f-component-plan.md +66 -0
  57. package/bundles/claude-desktop-manual/references/skills/recipe-fit-assessor.md +75 -0
  58. package/bundles/claude-desktop-manual/references/skills/render-export-evidence.md +70 -0
  59. package/bundles/claude-desktop-manual/references/skills/resolution-aspect-decision.md +65 -0
  60. package/bundles/claude-desktop-manual/references/skills/runtime-attempt-report.md +67 -0
  61. package/bundles/claude-desktop-manual/references/skills/runtime-path-picker.md +67 -0
  62. package/bundles/claude-desktop-manual/references/skills/runtime-readiness.md +63 -0
  63. package/bundles/claude-desktop-manual/references/skills/runtime-setup.md +63 -0
  64. package/bundles/claude-desktop-manual/references/skills/scene-readiness.md +65 -0
  65. package/bundles/claude-desktop-manual/references/skills/scope-guard.md +62 -0
  66. package/bundles/claude-desktop-manual/references/skills/stage-gates.md +91 -0
  67. package/bundles/claude-desktop-manual/references/skills/workflow-stage-router.md +67 -0
  68. package/bundles/generic-project-local/BLENDOPS.md +71 -0
  69. package/bundles/generic-project-local/INSTALL_REPORT_TEMPLATE.md +52 -0
  70. package/bundles/generic-project-local/README.md +72 -0
  71. package/bundles/generic-project-local/ROLLBACK.md +66 -0
  72. package/bundles/generic-project-local/manifest.json +66 -0
  73. package/bundles/skill-package/README.md +54 -0
  74. package/bundles/skill-package/blendops/LICENSE.txt +21 -0
  75. package/bundles/skill-package/blendops/SKILL.md +50 -0
  76. package/bundles/skill-package/blendops/agents/README.md +61 -0
  77. package/bundles/skill-package/blendops/agents/openai.yaml +4 -0
  78. package/bundles/skill-package/blendops/references/evidence-rules.md +17 -0
  79. package/bundles/skill-package/blendops/references/install-boundary.md +13 -0
  80. package/bundles/skill-package/blendops/references/law-evidence-before-done.md +12 -0
  81. package/bundles/skill-package/blendops/references/law-no-arbitrary-python-interface.md +7 -0
  82. package/bundles/skill-package/blendops/references/law-non-blender-user-language.md +8 -0
  83. package/bundles/skill-package/blendops/references/law-official-runtime-only.md +9 -0
  84. package/bundles/skill-package/blendops/references/pack-product-hero-v0.md +21 -0
  85. package/bundles/skill-package/blendops/references/runtime-stacks.md +13 -0
  86. package/bundles/skill-package/blendops/references/skill-acceptance-criteria-builder.md +51 -0
  87. package/bundles/skill-package/blendops/references/skill-asset-discovery.md +54 -0
  88. package/bundles/skill-package/blendops/references/skill-asset-fallback-strategy.md +48 -0
  89. package/bundles/skill-package/blendops/references/skill-asset-library-plan.md +51 -0
  90. package/bundles/skill-package/blendops/references/skill-asset-license-checker.md +51 -0
  91. package/bundles/skill-package/blendops/references/skill-asset-style-check.md +52 -0
  92. package/bundles/skill-package/blendops/references/skill-blender-brainstorming.md +43 -0
  93. package/bundles/skill-package/blendops/references/skill-blender-recipe-decomposer.md +48 -0
  94. package/bundles/skill-package/blendops/references/skill-blender-troubleshooting.md +59 -0
  95. package/bundles/skill-package/blendops/references/skill-blendops-help.md +62 -0
  96. package/bundles/skill-package/blendops/references/skill-bridge-conflicts.md +48 -0
  97. package/bundles/skill-package/blendops/references/skill-camera-composition.md +48 -0
  98. package/bundles/skill-package/blendops/references/skill-character-portrait.md +50 -0
  99. package/bundles/skill-package/blendops/references/skill-cli-appendix-job-outline.md +44 -0
  100. package/bundles/skill-package/blendops/references/skill-color-management-decision.md +50 -0
  101. package/bundles/skill-package/blendops/references/skill-composition-quality-checker.md +53 -0
  102. package/bundles/skill-package/blendops/references/skill-cycles-vs-eevee-decision.md +47 -0
  103. package/bundles/skill-package/blendops/references/skill-done-criteria.md +53 -0
  104. package/bundles/skill-package/blendops/references/skill-environment-shot.md +47 -0
  105. package/bundles/skill-package/blendops/references/skill-glb-animation-handoff.md +51 -0
  106. package/bundles/skill-package/blendops/references/skill-glb-web-handoff.md +51 -0
  107. package/bundles/skill-package/blendops/references/skill-intent-to-3d-brief-writer.md +50 -0
  108. package/bundles/skill-package/blendops/references/skill-interior-scene.md +54 -0
  109. package/bundles/skill-package/blendops/references/skill-lighting-material-plan.md +48 -0
  110. package/bundles/skill-package/blendops/references/skill-lighting-quality-checker.md +52 -0
  111. package/bundles/skill-package/blendops/references/skill-map.md +32 -0
  112. package/bundles/skill-package/blendops/references/skill-material-quality-checker.md +53 -0
  113. package/bundles/skill-package/blendops/references/skill-mobile-glb-budget.md +55 -0
  114. package/bundles/skill-package/blendops/references/skill-output-format-decision.md +46 -0
  115. package/bundles/skill-package/blendops/references/skill-pack-prerequisite-checker.md +56 -0
  116. package/bundles/skill-package/blendops/references/skill-path-one-host-outline.md +48 -0
  117. package/bundles/skill-package/blendops/references/skill-plain-language-response.md +53 -0
  118. package/bundles/skill-package/blendops/references/skill-polycount-budget-checker.md +53 -0
  119. package/bundles/skill-package/blendops/references/skill-pre-handoff-verification.md +57 -0
  120. package/bundles/skill-package/blendops/references/skill-preview-report.md +45 -0
  121. package/bundles/skill-package/blendops/references/skill-product-grid-scene-planner.md +54 -0
  122. package/bundles/skill-package/blendops/references/skill-product-hero-scene-planner.md +51 -0
  123. package/bundles/skill-package/blendops/references/skill-r3f-component-plan.md +48 -0
  124. package/bundles/skill-package/blendops/references/skill-recipe-fit-assessor.md +57 -0
  125. package/bundles/skill-package/blendops/references/skill-render-export-evidence.md +51 -0
  126. package/bundles/skill-package/blendops/references/skill-resolution-aspect-decision.md +48 -0
  127. package/bundles/skill-package/blendops/references/skill-runtime-attempt-report.md +49 -0
  128. package/bundles/skill-package/blendops/references/skill-runtime-path-picker.md +49 -0
  129. package/bundles/skill-package/blendops/references/skill-runtime-readiness.md +45 -0
  130. package/bundles/skill-package/blendops/references/skill-runtime-setup.md +45 -0
  131. package/bundles/skill-package/blendops/references/skill-scene-readiness.md +48 -0
  132. package/bundles/skill-package/blendops/references/skill-scope-guard.md +44 -0
  133. package/bundles/skill-package/blendops/references/skill-stage-gates.md +73 -0
  134. package/bundles/skill-package/blendops/references/skill-workflow-stage-router.md +49 -0
  135. package/docs/examples/glb-web-handoff/README.md +174 -0
  136. package/docs/examples/glb-web-handoff/r3f-glb-viewer.tsx +320 -0
  137. package/docs/examples/glb-web-handoff/threejs-glb-viewer.mjs +709 -0
  138. package/docs/knowledge-and-recipe-catalog.md +236 -0
  139. package/docs/recipes/README.md +27 -0
  140. package/docs/recipes/cyberpunk-shoe-hero.md +97 -0
  141. package/docs/workflows/README.md +14 -0
  142. package/docs/workflows/full-non-blender-user-workflow.md +210 -0
  143. package/docs/workflows/product-hero-workflow.md +92 -0
  144. package/laws/README.md +32 -0
  145. package/laws/evidence-before-done.md +37 -0
  146. package/laws/no-arbitrary-python-interface.md +32 -0
  147. package/laws/non-blender-user-language.md +32 -0
  148. package/laws/official-runtime-only.md +78 -0
  149. package/package.json +99 -4
  150. package/packs/README.md +11 -0
  151. package/packs/product-hero-v0/PACK.md +114 -0
  152. package/registry/catalog-index.json +21344 -0
  153. package/registry/compatibility-matrix.json +533 -0
  154. package/registry/contract-context-fields.json +391 -0
  155. package/registry/knowledge-catalog.json +4648 -0
  156. package/registry/knowledge-sources.json +438 -0
  157. package/registry/recipe-catalog.json +2565 -0
  158. package/registry/runtime-capability-policy.json +525 -0
  159. package/registry/runtime-operations.json +4468 -0
  160. package/registry/skills.json +10231 -0
  161. package/registry/workflow-graph.json +7390 -0
  162. package/schemas/adapter-compatibility-matrix.schema.json +166 -0
  163. package/schemas/contract-context-fields.schema.json +147 -0
  164. package/schemas/execution-plan.schema.json +325 -0
  165. package/schemas/glb-web-handoff-manifest.schema.json +744 -0
  166. package/schemas/knowledge-record.schema.json +460 -0
  167. package/schemas/knowledge-source-registry.schema.json +268 -0
  168. package/schemas/operation-execution-ledger.schema.json +348 -0
  169. package/schemas/recipe-record.schema.json +469 -0
  170. package/schemas/runtime-capability-policy.schema.json +184 -0
  171. package/schemas/runtime-evidence-packet.schema.json +211 -0
  172. package/schemas/runtime-operations.schema.json +535 -0
  173. package/schemas/runtime-qualification-report.schema.json +540 -0
  174. package/schemas/runtime-session.schema.json +350 -0
  175. package/schemas/scene-spec.schema.json +624 -0
  176. package/schemas/skill-contract.schema.json +402 -0
  177. package/schemas/skill-eval.schema.json +509 -0
  178. package/scripts/build-knowledge-catalog.mjs +2376 -0
  179. package/scripts/compile-scene-plan.mjs +1945 -0
  180. package/scripts/export-claude-skills.mjs +634 -0
  181. package/scripts/generate-glb-handoff-report.mjs +2376 -0
  182. package/scripts/inspect-glb.mjs +1627 -0
  183. package/scripts/install-skills.mjs +5369 -0
  184. package/scripts/runtime-orchestrator.mjs +7652 -0
  185. package/scripts/validate-capability-policy.mjs +531 -0
  186. package/scripts/validate-evidence-packet.mjs +256 -0
  187. package/skills/README.md +315 -0
  188. package/skills/_template/SKILL.md +296 -0
  189. package/skills/acceptance-criteria-builder/EVAL.md +25 -0
  190. package/skills/acceptance-criteria-builder/SKILL.md +257 -0
  191. package/skills/acceptance-criteria-builder/contract.json +205 -0
  192. package/skills/acceptance-criteria-builder/references/brief-to-criteria-mapper.md +22 -0
  193. package/skills/acceptance-criteria-builder/references/checklist-patterns.md +22 -0
  194. package/skills/acceptance-criteria-builder/references/evidence-hook-rules.md +19 -0
  195. package/skills/asset-discovery/EVAL.md +81 -0
  196. package/skills/asset-discovery/SKILL.md +252 -0
  197. package/skills/asset-discovery/contract.json +291 -0
  198. package/skills/asset-discovery/references/asset-strategy-decision-tree.md +40 -0
  199. package/skills/asset-discovery/references/budget-reconciliation-patterns.md +54 -0
  200. package/skills/asset-discovery/references/license-confidence-table.md +41 -0
  201. package/skills/asset-fallback-strategy/EVAL.md +34 -0
  202. package/skills/asset-fallback-strategy/SKILL.md +248 -0
  203. package/skills/asset-fallback-strategy/contract.json +190 -0
  204. package/skills/asset-fallback-strategy/references/drop-with-caveat-rules.md +36 -0
  205. package/skills/asset-fallback-strategy/references/fallback-option-types.md +55 -0
  206. package/skills/asset-fallback-strategy/references/scoring-rubric.md +61 -0
  207. package/skills/asset-library-plan/EVAL.md +28 -0
  208. package/skills/asset-library-plan/SKILL.md +263 -0
  209. package/skills/asset-library-plan/contract.json +177 -0
  210. package/skills/asset-library-plan/references/folder-structure-rules.md +63 -0
  211. package/skills/asset-library-plan/references/metadata-schema.md +62 -0
  212. package/skills/asset-library-plan/references/naming-rules.md +51 -0
  213. package/skills/asset-license-checker/EVAL.md +33 -0
  214. package/skills/asset-license-checker/SKILL.md +245 -0
  215. package/skills/asset-license-checker/contract.json +172 -0
  216. package/skills/asset-license-checker/references/attribution-rendering-patterns.md +48 -0
  217. package/skills/asset-license-checker/references/common-license-mapping.md +39 -0
  218. package/skills/asset-license-checker/references/license-source-rules.md +38 -0
  219. package/skills/asset-style-check/EVAL.md +26 -0
  220. package/skills/asset-style-check/SKILL.md +238 -0
  221. package/skills/asset-style-check/contract.json +251 -0
  222. package/skills/asset-style-check/references/drift-classification.md +40 -0
  223. package/skills/asset-style-check/references/intentional-mixed-style.md +39 -0
  224. package/skills/asset-style-check/references/style-axes.md +46 -0
  225. package/skills/blender-brainstorming/EVAL.md +79 -0
  226. package/skills/blender-brainstorming/SKILL.md +228 -0
  227. package/skills/blender-brainstorming/contract.json +115 -0
  228. package/skills/blender-brainstorming/references/alternative-scoping-templates.md +43 -0
  229. package/skills/blender-brainstorming/references/clarification-patterns.md +29 -0
  230. package/skills/blender-brainstorming/references/intent-summary-style-guide.md +25 -0
  231. package/skills/blender-recipe-decomposer/EVAL.md +35 -0
  232. package/skills/blender-recipe-decomposer/SKILL.md +258 -0
  233. package/skills/blender-recipe-decomposer/contract.json +152 -0
  234. package/skills/blender-recipe-decomposer/references/dependency-patterns.md +53 -0
  235. package/skills/blender-recipe-decomposer/references/recipe-grouping-rules.md +58 -0
  236. package/skills/blender-recipe-decomposer/references/recipe-naming-rules.md +44 -0
  237. package/skills/blender-troubleshooting/EVAL.md +78 -0
  238. package/skills/blender-troubleshooting/SKILL.md +263 -0
  239. package/skills/blender-troubleshooting/contract.json +352 -0
  240. package/skills/blender-troubleshooting/references/common-symptom-playbooks.md +51 -0
  241. package/skills/blender-troubleshooting/references/divergence-routing-table.md +23 -0
  242. package/skills/blender-troubleshooting/references/four-phase-template.md +51 -0
  243. package/skills/blendops-help/EVAL.md +67 -0
  244. package/skills/blendops-help/SKILL.md +312 -0
  245. package/skills/blendops-help/contract.json +229 -0
  246. package/skills/blendops-help/references/lifecycle-phases.md +91 -0
  247. package/skills/blendops-help/references/quick-start-prompts.md +65 -0
  248. package/skills/blendops-help/references/routing-decision-tree.md +57 -0
  249. package/skills/bridge-conflicts/EVAL.md +83 -0
  250. package/skills/bridge-conflicts/SKILL.md +246 -0
  251. package/skills/bridge-conflicts/contract.json +145 -0
  252. package/skills/bridge-conflicts/references/bridge-state-matrix-template.md +82 -0
  253. package/skills/bridge-conflicts/references/conflict-playbooks.md +99 -0
  254. package/skills/bridge-conflicts/references/do-not-reminders.md +42 -0
  255. package/skills/camera-composition/EVAL.md +32 -0
  256. package/skills/camera-composition/SKILL.md +196 -0
  257. package/skills/camera-composition/contract.json +180 -0
  258. package/skills/camera-composition/references/camera-presets.md +30 -0
  259. package/skills/camera-composition/references/camera-rubric.md +24 -0
  260. package/skills/camera-composition/references/hero-composition-patterns.md +24 -0
  261. package/skills/camera-composition/references/web-layout-negative-space.md +25 -0
  262. package/skills/character-portrait/EVAL.md +42 -0
  263. package/skills/character-portrait/SKILL.md +245 -0
  264. package/skills/character-portrait/contract.json +205 -0
  265. package/skills/character-portrait/references/portrait-framing-rules.md +39 -0
  266. package/skills/character-portrait/references/portrait-lighting-patterns.md +50 -0
  267. package/skills/character-portrait/references/style-consistency-rules.md +41 -0
  268. package/skills/cli-appendix-job-outline/EVAL.md +26 -0
  269. package/skills/cli-appendix-job-outline/SKILL.md +252 -0
  270. package/skills/cli-appendix-job-outline/contract.json +147 -0
  271. package/skills/cli-appendix-job-outline/references/flag-order-reminders.md +16 -0
  272. package/skills/cli-appendix-job-outline/references/job-type-matrix.md +13 -0
  273. package/skills/cli-appendix-job-outline/references/stateless-limitations.md +12 -0
  274. package/skills/color-management-decision/EVAL.md +28 -0
  275. package/skills/color-management-decision/SKILL.md +254 -0
  276. package/skills/color-management-decision/contract.json +162 -0
  277. package/skills/color-management-decision/references/look-comparison.md +44 -0
  278. package/skills/color-management-decision/references/per-channel-rules.md +49 -0
  279. package/skills/color-management-decision/references/pipeline-mapping.md +47 -0
  280. package/skills/composition-quality-checker/EVAL.md +38 -0
  281. package/skills/composition-quality-checker/SKILL.md +260 -0
  282. package/skills/composition-quality-checker/contract.json +221 -0
  283. package/skills/composition-quality-checker/references/aspect-ratio-rules.md +37 -0
  284. package/skills/composition-quality-checker/references/composition-rules.md +58 -0
  285. package/skills/composition-quality-checker/references/headroom-leadroom-rules.md +46 -0
  286. package/skills/cycles-vs-eevee-decision/EVAL.md +26 -0
  287. package/skills/cycles-vs-eevee-decision/SKILL.md +249 -0
  288. package/skills/cycles-vs-eevee-decision/contract.json +142 -0
  289. package/skills/cycles-vs-eevee-decision/references/engine-feature-matrix.md +39 -0
  290. package/skills/cycles-vs-eevee-decision/references/gpu-device-rules.md +51 -0
  291. package/skills/cycles-vs-eevee-decision/references/samples-by-quality.md +53 -0
  292. package/skills/done-criteria/EVAL.md +33 -0
  293. package/skills/done-criteria/SKILL.md +225 -0
  294. package/skills/done-criteria/contract.json +199 -0
  295. package/skills/done-criteria/references/done-vs-perfect.md +56 -0
  296. package/skills/done-criteria/references/out-of-scope-patterns.md +50 -0
  297. package/skills/done-criteria/references/stop-condition-templates.md +39 -0
  298. package/skills/environment-shot/EVAL.md +44 -0
  299. package/skills/environment-shot/SKILL.md +237 -0
  300. package/skills/environment-shot/contract.json +162 -0
  301. package/skills/environment-shot/references/depth-layering-rules.md +49 -0
  302. package/skills/environment-shot/references/time-and-weather-rules.md +35 -0
  303. package/skills/environment-shot/references/wide-shot-camera-rules.md +51 -0
  304. package/skills/glb-animation-handoff/EVAL.md +39 -0
  305. package/skills/glb-animation-handoff/SKILL.md +271 -0
  306. package/skills/glb-animation-handoff/contract.json +247 -0
  307. package/skills/glb-animation-handoff/references/animation-types.md +36 -0
  308. package/skills/glb-animation-handoff/references/transition-rules.md +55 -0
  309. package/skills/glb-animation-handoff/references/web-stack-caveats.md +40 -0
  310. package/skills/glb-web-handoff/EVAL.md +33 -0
  311. package/skills/glb-web-handoff/SKILL.md +212 -0
  312. package/skills/glb-web-handoff/contract.json +171 -0
  313. package/skills/glb-web-handoff/references/artifact-status-language.md +26 -0
  314. package/skills/glb-web-handoff/references/glb-handoff-checklist.md +30 -0
  315. package/skills/glb-web-handoff/references/performance-caveats.md +26 -0
  316. package/skills/glb-web-handoff/references/threejs-r3f-handoff.md +28 -0
  317. package/skills/intent-to-3d-brief-writer/EVAL.md +82 -0
  318. package/skills/intent-to-3d-brief-writer/SKILL.md +238 -0
  319. package/skills/intent-to-3d-brief-writer/contract.json +195 -0
  320. package/skills/intent-to-3d-brief-writer/references/acceptance-criteria-patterns.md +46 -0
  321. package/skills/intent-to-3d-brief-writer/references/eight-slot-template.md +123 -0
  322. package/skills/intent-to-3d-brief-writer/references/mixed-audience-handling.md +39 -0
  323. package/skills/interior-scene/EVAL.md +44 -0
  324. package/skills/interior-scene/SKILL.md +261 -0
  325. package/skills/interior-scene/contract.json +277 -0
  326. package/skills/interior-scene/references/furniture-layout-rules.md +51 -0
  327. package/skills/interior-scene/references/interior-architecture-rules.md +47 -0
  328. package/skills/interior-scene/references/interior-camera-rules.md +47 -0
  329. package/skills/lighting-material-plan/EVAL.md +32 -0
  330. package/skills/lighting-material-plan/SKILL.md +194 -0
  331. package/skills/lighting-material-plan/contract.json +213 -0
  332. package/skills/lighting-material-plan/references/cyberpunk-lookdev.md +22 -0
  333. package/skills/lighting-material-plan/references/lighting-patterns.md +30 -0
  334. package/skills/lighting-material-plan/references/material-portability.md +25 -0
  335. package/skills/lighting-material-plan/references/reflective-floor-pattern.md +22 -0
  336. package/skills/lighting-material-plan/references/web-material-simplification.md +23 -0
  337. package/skills/lighting-quality-checker/EVAL.md +41 -0
  338. package/skills/lighting-quality-checker/SKILL.md +247 -0
  339. package/skills/lighting-quality-checker/contract.json +187 -0
  340. package/skills/lighting-quality-checker/references/hdri-balance-rules.md +48 -0
  341. package/skills/lighting-quality-checker/references/intensity-ranges.md +73 -0
  342. package/skills/lighting-quality-checker/references/shadow-softness-rules.md +38 -0
  343. package/skills/material-quality-checker/EVAL.md +40 -0
  344. package/skills/material-quality-checker/SKILL.md +261 -0
  345. package/skills/material-quality-checker/contract.json +244 -0
  346. package/skills/material-quality-checker/references/consumer-stack-rules.md +62 -0
  347. package/skills/material-quality-checker/references/pbr-sanity-rules.md +78 -0
  348. package/skills/material-quality-checker/references/texture-budget-rules.md +48 -0
  349. package/skills/mobile-glb-budget/EVAL.md +40 -0
  350. package/skills/mobile-glb-budget/SKILL.md +264 -0
  351. package/skills/mobile-glb-budget/contract.json +309 -0
  352. package/skills/mobile-glb-budget/references/budget-tiers.md +30 -0
  353. package/skills/mobile-glb-budget/references/degradation-plan.md +34 -0
  354. package/skills/mobile-glb-budget/references/violation-rules.md +43 -0
  355. package/skills/output-format-decision/EVAL.md +27 -0
  356. package/skills/output-format-decision/SKILL.md +222 -0
  357. package/skills/output-format-decision/contract.json +179 -0
  358. package/skills/output-format-decision/references/bit-depth-rules.md +56 -0
  359. package/skills/output-format-decision/references/compression-tradeoffs.md +62 -0
  360. package/skills/output-format-decision/references/format-decision-matrix.md +34 -0
  361. package/skills/pack-prerequisite-checker/EVAL.md +26 -0
  362. package/skills/pack-prerequisite-checker/SKILL.md +272 -0
  363. package/skills/pack-prerequisite-checker/contract.json +214 -0
  364. package/skills/pack-prerequisite-checker/references/blocked-start-playbook.md +21 -0
  365. package/skills/pack-prerequisite-checker/references/pack-readiness-template.md +38 -0
  366. package/skills/pack-prerequisite-checker/references/prerequisite-matrix.md +20 -0
  367. package/skills/path-one-host-outline/EVAL.md +26 -0
  368. package/skills/path-one-host-outline/SKILL.md +251 -0
  369. package/skills/path-one-host-outline/contract.json +167 -0
  370. package/skills/path-one-host-outline/references/connector-vs-manual-matrix.md +21 -0
  371. package/skills/path-one-host-outline/references/host-checklist-template.md +35 -0
  372. package/skills/path-one-host-outline/references/lab-addon-reminders.md +12 -0
  373. package/skills/plain-language-response/EVAL.md +33 -0
  374. package/skills/plain-language-response/SKILL.md +194 -0
  375. package/skills/plain-language-response/contract.json +242 -0
  376. package/skills/plain-language-response/references/caveat-language.md +25 -0
  377. package/skills/plain-language-response/references/plain-language-patterns.md +30 -0
  378. package/skills/plain-language-response/references/stakeholder-friendly-examples.md +30 -0
  379. package/skills/plain-language-response/references/status-summary-templates.md +50 -0
  380. package/skills/polycount-budget-checker/EVAL.md +40 -0
  381. package/skills/polycount-budget-checker/SKILL.md +251 -0
  382. package/skills/polycount-budget-checker/contract.json +196 -0
  383. package/skills/polycount-budget-checker/references/instance-counting-rules.md +39 -0
  384. package/skills/polycount-budget-checker/references/per-mesh-rules.md +43 -0
  385. package/skills/polycount-budget-checker/references/topology-hints.md +56 -0
  386. package/skills/pre-handoff-verification/EVAL.md +84 -0
  387. package/skills/pre-handoff-verification/SKILL.md +252 -0
  388. package/skills/pre-handoff-verification/contract.json +295 -0
  389. package/skills/pre-handoff-verification/references/downgrade-rules.md +39 -0
  390. package/skills/pre-handoff-verification/references/seven-point-checklist.md +46 -0
  391. package/skills/pre-handoff-verification/references/text-only-mode-handling.md +36 -0
  392. package/skills/preview-report/EVAL.md +39 -0
  393. package/skills/preview-report/SKILL.md +254 -0
  394. package/skills/preview-report/contract.json +141 -0
  395. package/skills/preview-report/references/handoff-recipients.md +41 -0
  396. package/skills/preview-report/references/report-schema.md +60 -0
  397. package/skills/preview-report/references/truth-label-rules.md +36 -0
  398. package/skills/product-grid-scene-planner/EVAL.md +42 -0
  399. package/skills/product-grid-scene-planner/SKILL.md +246 -0
  400. package/skills/product-grid-scene-planner/contract.json +257 -0
  401. package/skills/product-grid-scene-planner/references/grid-consistency-rules.md +53 -0
  402. package/skills/product-grid-scene-planner/references/grid-layout-rules.md +42 -0
  403. package/skills/product-grid-scene-planner/references/grid-output-naming-rules.md +52 -0
  404. package/skills/product-hero-scene-planner/EVAL.md +33 -0
  405. package/skills/product-hero-scene-planner/SKILL.md +227 -0
  406. package/skills/product-hero-scene-planner/contract.json +228 -0
  407. package/skills/product-hero-scene-planner/references/clarification-patterns.md +24 -0
  408. package/skills/product-hero-scene-planner/references/cyberpunk-shoe-example.md +28 -0
  409. package/skills/product-hero-scene-planner/references/product-hero-playbooks.md +22 -0
  410. package/skills/product-hero-scene-planner/references/scene-plan-schema.md +35 -0
  411. package/skills/r3f-component-plan/EVAL.md +43 -0
  412. package/skills/r3f-component-plan/SKILL.md +290 -0
  413. package/skills/r3f-component-plan/contract.json +171 -0
  414. package/skills/r3f-component-plan/references/component-shape-patterns.md +54 -0
  415. package/skills/r3f-component-plan/references/suspense-placement-rules.md +50 -0
  416. package/skills/r3f-component-plan/references/usegltf-caching-rules.md +53 -0
  417. package/skills/recipe-fit-assessor/EVAL.md +28 -0
  418. package/skills/recipe-fit-assessor/SKILL.md +266 -0
  419. package/skills/recipe-fit-assessor/contract.json +220 -0
  420. package/skills/recipe-fit-assessor/references/recipe-catalog.md +30 -0
  421. package/skills/recipe-fit-assessor/references/scope-gap-rules.md +27 -0
  422. package/skills/recipe-fit-assessor/references/workflow-recommendation-template.md +34 -0
  423. package/skills/render-export-evidence/EVAL.md +86 -0
  424. package/skills/render-export-evidence/SKILL.md +339 -0
  425. package/skills/render-export-evidence/contract.json +206 -0
  426. package/skills/render-export-evidence/references/attempted-vs-failed-rubric.md +75 -0
  427. package/skills/render-export-evidence/references/evidence-record-templates.md +143 -0
  428. package/skills/render-export-evidence/references/truth-label-decision-tree.md +57 -0
  429. package/skills/resolution-aspect-decision/EVAL.md +26 -0
  430. package/skills/resolution-aspect-decision/SKILL.md +246 -0
  431. package/skills/resolution-aspect-decision/contract.json +160 -0
  432. package/skills/resolution-aspect-decision/references/aspect-defaults.md +41 -0
  433. package/skills/resolution-aspect-decision/references/print-vs-screen-rules.md +58 -0
  434. package/skills/resolution-aspect-decision/references/resolution-defaults.md +64 -0
  435. package/skills/runtime-attempt-report/EVAL.md +26 -0
  436. package/skills/runtime-attempt-report/SKILL.md +268 -0
  437. package/skills/runtime-attempt-report/contract.json +176 -0
  438. package/skills/runtime-attempt-report/references/attempt-record-template.md +49 -0
  439. package/skills/runtime-attempt-report/references/triage-next-steps.md +15 -0
  440. package/skills/runtime-attempt-report/references/truth-label-blocks.md +27 -0
  441. package/skills/runtime-path-picker/EVAL.md +26 -0
  442. package/skills/runtime-path-picker/SKILL.md +268 -0
  443. package/skills/runtime-path-picker/contract.json +191 -0
  444. package/skills/runtime-path-picker/references/anti-patterns.md +14 -0
  445. package/skills/runtime-path-picker/references/decision-tree.md +29 -0
  446. package/skills/runtime-path-picker/references/path-constraints-table.md +18 -0
  447. package/skills/runtime-readiness/EVAL.md +33 -0
  448. package/skills/runtime-readiness/SKILL.md +218 -0
  449. package/skills/runtime-readiness/contract.json +190 -0
  450. package/skills/runtime-readiness/references/blocker-report-template.md +28 -0
  451. package/skills/runtime-readiness/references/evidence-examples.md +23 -0
  452. package/skills/runtime-readiness/references/readiness-matrix.md +46 -0
  453. package/skills/runtime-setup/EVAL.md +33 -0
  454. package/skills/runtime-setup/SKILL.md +209 -0
  455. package/skills/runtime-setup/contract.json +171 -0
  456. package/skills/runtime-setup/references/runtime-option-decision-tree.md +28 -0
  457. package/skills/runtime-setup/references/setup-summary-template.md +33 -0
  458. package/skills/runtime-setup/references/source-confidence-labels.md +23 -0
  459. package/skills/scene-readiness/EVAL.md +33 -0
  460. package/skills/scene-readiness/SKILL.md +195 -0
  461. package/skills/scene-readiness/contract.json +198 -0
  462. package/skills/scene-readiness/references/blocker-catalog.md +24 -0
  463. package/skills/scene-readiness/references/not-run-handling.md +22 -0
  464. package/skills/scene-readiness/references/quality-rubric.md +23 -0
  465. package/skills/scene-readiness/references/verdict-language.md +22 -0
  466. package/skills/scope-guard/EVAL.md +33 -0
  467. package/skills/scope-guard/SKILL.md +222 -0
  468. package/skills/scope-guard/contract.json +171 -0
  469. package/skills/scope-guard/references/options-language-template.md +51 -0
  470. package/skills/scope-guard/references/recurring-creep-patterns.md +55 -0
  471. package/skills/scope-guard/references/scope-addition-classification.md +55 -0
  472. package/skills/stage-gates/EVAL.md +40 -0
  473. package/skills/stage-gates/SKILL.md +257 -0
  474. package/skills/stage-gates/contract.json +490 -0
  475. package/skills/stage-gates/references/failed-gate-handling.md +42 -0
  476. package/skills/stage-gates/references/gate-template.md +46 -0
  477. package/skills/stage-gates/references/stage-decomposition-patterns.md +55 -0
  478. package/skills/workflow-stage-router/EVAL.md +25 -0
  479. package/skills/workflow-stage-router/SKILL.md +259 -0
  480. package/skills/workflow-stage-router/contract.json +150 -0
  481. package/skills/workflow-stage-router/references/milestone-model.md +20 -0
  482. package/skills/workflow-stage-router/references/routing-decision-tree.md +32 -0
  483. package/skills/workflow-stage-router/references/stage-handoff-template.md +37 -0
  484. package/skills.sh.json +102 -0
@@ -0,0 +1,248 @@
1
+ ---
2
+ name: asset-fallback-strategy
3
+ description: Provide a fallback strategy when an asset is unavailable, over-budget, license-blocked, or style-incompatible — without halting the recipe.
4
+ ---
5
+
6
+ # asset-fallback-strategy
7
+
8
+ ## Purpose
9
+ 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).
10
+
11
+ ## Quick start
12
+ - read the failed asset + blocking reason
13
+ - propose 2-3 fallback options ordered by speed-to-implement (always including `drop-with-caveat`)
14
+ - score each option on time, brief-match, and license
15
+ - pick one only with explicit user agreement
16
+ - update the asset list and route any replacement back through `asset-license-checker` and `asset-style-check` (and `mobile-glb-budget` if budget-constrained)
17
+
18
+ ## When to use
19
+ - after a checker fails an asset
20
+ - when an asset cannot be acquired in time
21
+ - when budget excludes the originally-planned asset
22
+ - when license blocks an asset
23
+
24
+ ## When not to use
25
+ <!-- blendops:generated:start exclusions -->
26
+ - when no asset has failed (nothing to fall back to) → use `../asset-license-checker/SKILL.md` (nothing to fall back to)
27
+ - pure exploration (no concrete asset list) → use `../asset-discovery/SKILL.md` (no concrete asset list)
28
+ - when the user wants to wait for the original asset → use `../product-hero-scene-planner/SKILL.md` (Delegates out-of-scope requests to product-hero-scene-planner)
29
+ <!-- blendops:generated:end exclusions -->
30
+
31
+ ## Trigger phrases
32
+ <!-- blendops:generated:start triggers -->
33
+ - "what if we can't get this asset"
34
+ - "fallback for the model"
35
+ - "the license blocks us"
36
+ - "scaled-down asset"
37
+ <!-- blendops:generated:end triggers -->
38
+
39
+ ## Prerequisites / readiness
40
+ - failed asset + reason known
41
+ - recipe brief known (informs alternative selection)
42
+
43
+ ## Input schema
44
+
45
+ ### Required inputs
46
+
47
+ | Input | Why it is required |
48
+ |---|---|
49
+ | Failed asset + reason | Drives fallback search |
50
+ | Recipe brief | Alternative must satisfy brief |
51
+ | Time / budget remaining | Affects feasibility of options |
52
+
53
+ ### Optional inputs
54
+
55
+ | Input | Use |
56
+ |---|---|
57
+ | Existing internal asset library | Source of fast fallbacks |
58
+ | Generative tool access (procedural / AI) | Adds option types |
59
+
60
+ ### Assumptions to confirm
61
+ - The user accepts that a fallback is needed (vs waiting).
62
+ - "Drop with caveat" is a valid option even if not preferred.
63
+
64
+ ## Output schema
65
+
66
+ ### Primary output
67
+ A fallback option table: option (`replace` / `re-source` / `procedural` / `generative` / `drop-with-caveat`), source / method, time-to-implement, brief-match, license, and recommendation.
68
+
69
+ ### Secondary output
70
+ - updated asset list reflecting the user-approved fallback
71
+ - mandatory re-check routing for replacements (`asset-license-checker`, `asset-style-check`, and `mobile-glb-budget`)
72
+ - caveat lines if `drop-with-caveat` is chosen
73
+ - evidence label
74
+
75
+ ### Evidence / caveat output
76
+
77
+ ```txt
78
+ Runtime status: Not Run | Attempted | Produced | Verified | Failed
79
+ Artifact status: Not Produced | Produced | Verified | Failed (default: Not Produced)
80
+ Rule: downgrade-only, never upgrade
81
+ Evidence used: <links, paths, logs, or "none">
82
+ Limitations: <known gaps>
83
+ ```
84
+
85
+ ## Required laws
86
+ - `../../laws/evidence-before-done.md`
87
+ - `../../laws/non-blender-user-language.md`
88
+ - `../../laws/no-arbitrary-python-interface.md`
89
+ - `../../laws/official-runtime-only.md`
90
+
91
+ ## Official runtime boundary
92
+
93
+ 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.
94
+
95
+ ## Operating procedure
96
+
97
+ 1. Read failed asset + blocking reason.
98
+ 2. Read brief style + budget context.
99
+ 3. Propose 2-3 fallback options ordered by speed-to-implement (see `references/fallback-option-types.md`), always including `drop-with-caveat`.
100
+ 4. Score each option on time, brief-match, and license.
101
+ 5. Recommend one option and pause for explicit user agreement.
102
+ 6. Once agreed, update the asset list and route the replacement back into the check chain (`asset-license-checker`, `asset-style-check`, and `mobile-glb-budget`), or escalate to `scope-guard` / `blender-recipe-decomposer` if no viable fallback exists.
103
+
104
+ ## Decision tree
105
+
106
+ ```txt
107
+ Failed by license?
108
+ → (1) Replace from internal library (`asset-library-plan`)
109
+ → (2) Re-source compliant alternative (`asset-discovery`)
110
+ → (3) Drop with caveat
111
+ Failed by budget (size/poly)?
112
+ → (1) Replace with lighter stand-in from internal library (`asset-library-plan`)
113
+ → (2) Plan procedural / generative alternative
114
+ → (3) Drop with caveat
115
+ Failed by style?
116
+ → (1) Re-source style-aligned alternative (`asset-discovery`)
117
+ → (2) Plan procedural / generative alternative matching brief
118
+ → (3) Drop with caveat
119
+ Failed by unavailability?
120
+ → (1) Replace from internal library (`asset-library-plan`)
121
+ → (2) Plan procedural / generative alternative
122
+ → (3) Drop with caveat
123
+ ```
124
+
125
+ ## Playbooks
126
+
127
+ ### Playbook A: Hero shoe model unavailable
128
+
129
+ Options (ordered by speed): (1) Replace with stand-in mesh from internal library via `asset-library-plan` (fastest, lower brief-match). (2) Plan a procedural or generative alternative (medium speed, medium brief-match). (3) Drop with caveat: omit the hero shoe and adjust deliverables (fastest fallback exit, requires caveat note). Any replacement must re-pass `asset-license-checker` and `asset-style-check`.
130
+
131
+ ### Playbook B: HDRI blocked by license
132
+
133
+ Options (ordered by speed): (1) Drop with caveat: omit HDRI and rely on planned scene lighting (caveat: ambient reflection changes). (2) Re-source a license-clear HDRI via `asset-discovery` (fast, high brief-match). (3) Plan a procedural sky alternative (medium speed, medium brief-match). Any replacement must re-pass `asset-license-checker` and `asset-style-check`.
134
+
135
+ ### Playbook C: Texture over-budget
136
+
137
+ Options (ordered by speed): (1) Drop with caveat: omit high-cost texture variation and use a simpler material plan (caveat: reduced surface detail). (2) Replace with a lighter asset from the internal library via `asset-library-plan` (fast, medium brief-match). (3) Re-source a budget-compliant texture via `asset-discovery` (medium speed, high brief-match). Any replacement must re-pass `asset-license-checker`, `asset-style-check`, and `mobile-glb-budget`.
138
+
139
+ ## Mode handling
140
+
141
+ ### Text-only mode
142
+
143
+ Output the fallback strategy table and wait for user agreement.
144
+
145
+ ### Runtime-ready mode
146
+
147
+ After user agreement on a fallback, hand off to `asset-discovery` (re-source) or `asset-library-plan` (internal library), then require re-verification through `asset-license-checker`, `asset-style-check`, and `mobile-glb-budget`.
148
+
149
+ ### Blocked runtime mode
150
+
151
+ Strategy is recorded as a forward-plan; no immediate handoff execution.
152
+
153
+ ## Validation checklist
154
+
155
+ * [ ] Failed asset + blocking reason explicitly stated
156
+ * [ ] 2-3 options ordered by speed, scored on time, brief-match, and license
157
+ * [ ] `drop-with-caveat` option included
158
+ * [ ] Recommendation explicit and user agreement required before proceeding
159
+ * [ ] Updated asset list reflected after agreement
160
+ * [ ] Picked replacement routed back to `asset-license-checker` and `asset-style-check` (plus `mobile-glb-budget` when applicable)
161
+ * [ ] Caveat lines documented if `drop-with-caveat` is chosen
162
+
163
+ ## Pass / Warn / Fail rubric
164
+
165
+ | Verdict | Criteria |
166
+ | --- | --- |
167
+ | Pass | 2-3 speed-ordered options (including `drop-with-caveat`) scored on time/brief-match/license + explicit recommendation + user agreement + updated list + re-check routing to `asset-license-checker` and `asset-style-check`. |
168
+ | Warn | Options and `drop-with-caveat` present, but recommendation or re-check routing note is soft. |
169
+ | Fail | Missing `drop-with-caveat`; silent substitution without user agreement; skips replacement re-checks; or attempts to acquire, generate, or edit assets directly. |
170
+
171
+ ## Failure handling
172
+
173
+ * No viable fallback exists → hand off to `scope-guard` for scope reduction or `blender-recipe-decomposer` to split the recipe.
174
+ * Picked replacement fails `asset-license-checker`, `asset-style-check`, or `mobile-glb-budget` → repeat the fallback planning cycle or escalate to scope reduction.
175
+ * User refuses all options → document refusal and flag as recipe-blocker.
176
+
177
+ ## Troubleshooting
178
+
179
+ | Problem | Response |
180
+ | --- | --- |
181
+ | Fallback doesn't match brief | Propose scope reduction via `scope-guard` or select another fallback; do not silently lower quality. |
182
+ | Procedural option requires unavailable capability | Cross out procedural option; rely on `replace`, `re-source`, or `drop-with-caveat`. |
183
+ | Replacement or generative candidate has unclear license or style fit | Route through `asset-license-checker` and `asset-style-check` before accepting into the recipe. |
184
+
185
+ ## Best practices
186
+ - Always offer at least 2 options.
187
+ - Always show a "drop with caveat" option (even if last choice).
188
+ - Time-to-implement is decisive; brief match is necessary; license confidence is non-negotiable.
189
+ - Keep this skill narrow.
190
+
191
+ ## Good examples
192
+
193
+ * "Failed: `hero-shoe-mesh.glb` (blocked by `asset-license-checker`). Options (ordered by speed): (1) Drop with caveat — omit hero shoe mesh and note missing centerpiece (time: immediate, brief-match: low, license: clear). (2) Replace from internal library via `asset-library-plan` — generic shoe stand-in (time: fast, brief-match: medium, license: pre-cleared). (3) Re-source compliant commercial mesh via `asset-discovery` (time: slower, brief-match: high, license: requires verification). Recommended: (3) for brief fidelity. User agreement required; once picked, replacement must re-pass `asset-license-checker` and `asset-style-check`."
194
+
195
+ ## Bad examples
196
+ - "We'll figure it out." — no options listed.
197
+
198
+ ## User-facing response template
199
+
200
+ ```txt
201
+ Failed asset: <name>
202
+ Reason: <license / budget / style / unavailable>
203
+
204
+ | Option | Type (replace / re-source / procedural / generative / drop-with-caveat) | Source / method | Time | Brief-match | License | Recommendation |
205
+ |---|---|---|---|---|---|---|
206
+
207
+ Recommendation: <option>
208
+ Decision needed: User agreement required before continuing.
209
+ Caveat lines (if drop-with-caveat): <list>
210
+ Updated asset list: <link or note>
211
+ Next re-checks (if replacement picked): asset-license-checker, asset-style-check, mobile-glb-budget (if budget applies)
212
+ Escalation (if no viable fallback): scope-guard or blender-recipe-decomposer
213
+ Runtime status: Not Run | Attempted | Produced | Verified | Failed
214
+ Artifact status: Not Produced | Produced | Verified | Failed (default: Not Produced; downgrade-only)
215
+ Evidence used: <links, paths, logs, or "none">
216
+ Limitations: <known gaps>
217
+ ```
218
+
219
+ ## Anti-patterns
220
+
221
+ * Dropping an asset without an explicit caveat ("just drop it").
222
+ * Omitting `drop-with-caveat` from the proposed option set.
223
+ * Silently substituting an asset without user agreement.
224
+ * Inventing fallback sources or acquiring, generating, or editing assets directly.
225
+ * Skipping `asset-license-checker`, `asset-style-check`, or `mobile-glb-budget` on the chosen replacement.
226
+
227
+ ## Cross-skill handoff
228
+ <!-- blendops:generated:start handoffs -->
229
+ - [upstream_reference] Re-source external asset → `../asset-discovery/SKILL.md`
230
+ - [progression] Internal library lookup → `../asset-library-plan/SKILL.md`
231
+ - [fallback] License re-check on replacement → `../asset-license-checker/SKILL.md`
232
+ - [fallback] Style re-check on replacement → `../asset-style-check/SKILL.md`
233
+ - [progression] Budget re-check on replacement → `../mobile-glb-budget/SKILL.md`
234
+ - [fallback] Scope reduction when no viable fallback exists → `../scope-guard/SKILL.md`
235
+ - [fallback] Recipe split when no viable fallback exists → `../blender-recipe-decomposer/SKILL.md`
236
+ <!-- blendops:generated:end handoffs -->
237
+
238
+ ## Non-goals
239
+
240
+ * Acquire, generate, or edit assets itself.
241
+ * Run Blender or execute Python.
242
+ * Perform license, style, or performance budget checks itself.
243
+
244
+ ## References
245
+ - `references/fallback-option-types.md`
246
+ - `references/scoring-rubric.md`
247
+ - `references/drop-with-caveat-rules.md`
248
+ - `../../docs/skill-system.md`
@@ -0,0 +1,190 @@
1
+ {
2
+ "$schema": "../../schemas/skill-contract.schema.json",
3
+ "id": "asset-fallback-strategy",
4
+ "version": "1.0.0",
5
+ "category": "asset-and-sourcing",
6
+ "role": "blocked-asset-replacement-planner",
7
+ "purpose": "Provide a fallback strategy when an asset is unavailable, over-budget, license-blocked, or style-incompatible — without halting the recipe.",
8
+ "capabilityTier": "L0",
9
+ "triggers": [
10
+ "what if we can't get this asset",
11
+ "fallback for the model",
12
+ "the license blocks us",
13
+ "scaled-down asset"
14
+ ],
15
+ "exclusions": [
16
+ {
17
+ "condition": "when no asset has failed (nothing to fall back to)",
18
+ "delegateTo": "asset-license-checker",
19
+ "reason": "nothing to fall back to"
20
+ },
21
+ {
22
+ "condition": "pure exploration (no concrete asset list)",
23
+ "delegateTo": "asset-discovery",
24
+ "reason": "no concrete asset list"
25
+ },
26
+ {
27
+ "condition": "when the user wants to wait for the original asset",
28
+ "delegateTo": "product-hero-scene-planner",
29
+ "reason": "Delegates out-of-scope requests to product-hero-scene-planner"
30
+ }
31
+ ],
32
+ "inputs": {
33
+ "required": [
34
+ {
35
+ "name": "blocked_asset_entry",
36
+ "type": "object",
37
+ "description": "Asset blocked by missing source, incompatible license, style mismatch, or budget breach"
38
+ },
39
+ {
40
+ "name": "blocking_reason",
41
+ "type": "enum",
42
+ "description": "Primary block reason (license_rejected, source_unavailable, style_mismatch, budget_exceeded)"
43
+ }
44
+ ],
45
+ "optional": [
46
+ {
47
+ "name": "local_library_manifest",
48
+ "type": "object",
49
+ "description": "Optional inventory of cleared local assets from asset-library-plan"
50
+ }
51
+ ]
52
+ },
53
+ "outputs": {
54
+ "primary": [
55
+ "ranked_fallback_options",
56
+ "selected_replacement_plan",
57
+ "revalidation_routing_hooks"
58
+ ],
59
+ "truthStatePolicy": {
60
+ "runtimeDefault": "Not Run",
61
+ "artifactDefault": "Not Produced",
62
+ "mutationRule": "downgrade_only"
63
+ }
64
+ },
65
+ "handoffs": [
66
+ {
67
+ "target": "asset-discovery",
68
+ "type": "upstream_reference",
69
+ "label": "Re-source external asset",
70
+ "when": {
71
+ "all": [
72
+ {
73
+ "field": "brief.locked",
74
+ "operator": "equals",
75
+ "value": true
76
+ },
77
+ {
78
+ "field": "assets.discoveryComplete",
79
+ "operator": "equals",
80
+ "value": false
81
+ }
82
+ ]
83
+ }
84
+ },
85
+ {
86
+ "target": "asset-library-plan",
87
+ "type": "progression",
88
+ "label": "Internal library lookup",
89
+ "when": {
90
+ "all": [
91
+ {
92
+ "field": "assets.discoveryComplete",
93
+ "operator": "equals",
94
+ "value": true
95
+ },
96
+ {
97
+ "field": "stage.current",
98
+ "operator": "equals",
99
+ "value": "library_organization"
100
+ }
101
+ ]
102
+ }
103
+ },
104
+ {
105
+ "target": "asset-license-checker",
106
+ "type": "fallback",
107
+ "label": "License re-check on replacement",
108
+ "when": {
109
+ "all": [
110
+ {
111
+ "field": "assets.externalUsed",
112
+ "operator": "equals",
113
+ "value": true
114
+ },
115
+ {
116
+ "field": "assets.licenseCleared",
117
+ "operator": "equals",
118
+ "value": false
119
+ }
120
+ ]
121
+ }
122
+ },
123
+ {
124
+ "target": "asset-style-check",
125
+ "type": "fallback",
126
+ "label": "Style re-check on replacement",
127
+ "when": {
128
+ "all": [
129
+ {
130
+ "field": "assets.licenseCleared",
131
+ "operator": "equals",
132
+ "value": true
133
+ },
134
+ {
135
+ "field": "stage.current",
136
+ "operator": "equals",
137
+ "value": "style_check"
138
+ }
139
+ ]
140
+ }
141
+ },
142
+ {
143
+ "target": "mobile-glb-budget",
144
+ "type": "progression",
145
+ "label": "Budget re-check on replacement",
146
+ "when": {
147
+ "all": [
148
+ {
149
+ "field": "artifact.type",
150
+ "operator": "equals",
151
+ "value": "glb"
152
+ },
153
+ {
154
+ "field": "budget.pinned",
155
+ "operator": "equals",
156
+ "value": false
157
+ }
158
+ ]
159
+ }
160
+ },
161
+ {
162
+ "target": "scope-guard",
163
+ "type": "fallback",
164
+ "label": "Scope reduction when no viable fallback exists",
165
+ "when": {
166
+ "all": [
167
+ {
168
+ "field": "scope.driftDetected",
169
+ "operator": "equals",
170
+ "value": true
171
+ }
172
+ ]
173
+ }
174
+ },
175
+ {
176
+ "target": "blender-recipe-decomposer",
177
+ "type": "fallback",
178
+ "label": "Recipe split when no viable fallback exists",
179
+ "when": {
180
+ "all": [
181
+ {
182
+ "field": "fit.multiDeliverableDetected",
183
+ "operator": "equals",
184
+ "value": true
185
+ }
186
+ ]
187
+ }
188
+ }
189
+ ]
190
+ }
@@ -0,0 +1,36 @@
1
+ # Drop-with-caveat rules
2
+
3
+ When dropping an asset, document the caveat; do not silently dilute the deliverable.
4
+
5
+ ## What to record
6
+
7
+ - Original asset that was dropped
8
+ - Reason it was dropped
9
+ - Visual / functional change in the deliverable
10
+ - Whether the brief still matches after drop
11
+ - Updated stop condition (if changed)
12
+
13
+ ## Example caveat
14
+
15
+ "Dropped: hero-shoe-mesh.glb (license-blocked, no fallback in time). Visual change: hero render now uses procedural-only abstraction instead of recognizable shoe. Brief match: lower (style match acceptable; shoe-specific recognition lost). User accepted change on <date>. Updated stop condition: 'render shows abstract product silhouette instead of literal shoe'."
16
+
17
+ ## When NOT to drop
18
+
19
+ - The brief explicitly requires the asset (e.g., "render of THE shoe").
20
+ - Dropping breaks the recipe's purpose.
21
+ - Stakeholder expects the original.
22
+
23
+ In these cases, escalate scope reduction (drop the deliverable) or push the deadline.
24
+
25
+ ## When drop is actually fine
26
+
27
+ - The asset is a "nice-to-have" not a "must-have" in the brief.
28
+ - An equivalent alternative is already accepted.
29
+ - The visual change is small.
30
+
31
+ ## Recording in evidence
32
+
33
+ Drop-with-caveat events are part of the evidence trail. Append to `docs/evals/...` if a runtime evidence file is being maintained, or to the recipe handoff.
34
+
35
+ ## Related skill
36
+ `../SKILL.md`
@@ -0,0 +1,55 @@
1
+ # Fallback option types
2
+
3
+ ## Type A: Replace from open-license source
4
+
5
+ Find a CC0 / MIT / similar-permission alternative.
6
+
7
+ **Pros**: cheapest, no legal friction.
8
+ **Cons**: brief match may be approximate.
9
+
10
+ Sources: polyhaven.com, ambientcg.com, free Sketchfab CC0 tag, BlendSwap CC0 tag.
11
+
12
+ ## Type B: Replace from paid licensed source
13
+
14
+ Buy a commercial license that fits the brief.
15
+
16
+ **Pros**: exact brief match; clear license.
17
+ **Cons**: cost; takes time to source.
18
+
19
+ Sources: TurboSquid, CGTrader, Sketchfab Store, brand-specific stock.
20
+
21
+ ## Type C: Procedural / Geometry Nodes / shader-based
22
+
23
+ Build the asset programmatically inside Blender.
24
+
25
+ **Pros**: free, brand-aligned, fully controlled.
26
+ **Cons**: requires modeling skill; takes time.
27
+
28
+ Best for: textures (procedural noise), repeating geometry (Geometry Nodes), simple shapes.
29
+
30
+ ## Type D: Generative (AI / photogrammetry service)
31
+
32
+ Use a service to generate / capture the asset.
33
+
34
+ **Pros**: novel; can match brief precisely.
35
+ **Cons**: license terms vary; quality varies; time varies.
36
+
37
+ Sources: Meshy, Luma AI, Polycam, Photogrammetry pipelines.
38
+
39
+ **Always run the AI-generated output through `asset-license-checker`** to verify the tool's commercial-use terms.
40
+
41
+ ## Type E: Drop with caveat
42
+
43
+ Remove the asset; document the visual change.
44
+
45
+ **Pros**: zero time / cost.
46
+ **Cons**: deliverable changes; brief may be diluted.
47
+
48
+ Use when: deadline-critical, no budget for paid, no time for procedural / generative.
49
+
50
+ ## Combination
51
+
52
+ Sometimes the best fallback combines types (e.g., Type A texture + Type C procedural displacement).
53
+
54
+ ## Related skill
55
+ `../SKILL.md`
@@ -0,0 +1,61 @@
1
+ # Scoring rubric for fallback options
2
+
3
+ Score each option on 4 dimensions; recommend the best total.
4
+
5
+ ## Dimensions
6
+
7
+ ### 1. Time to implement
8
+
9
+ - < 1 hour: 5
10
+ - 1-4 hours: 4
11
+ - 4-8 hours: 3
12
+ - 1-3 days: 2
13
+ - > 3 days: 1
14
+
15
+ ### 2. Brief match
16
+
17
+ - Exact match: 5
18
+ - Very close: 4
19
+ - Close (minor caveat): 3
20
+ - Approximate: 2
21
+ - Loose: 1
22
+
23
+ ### 3. License confidence
24
+
25
+ - CC0 / MIT / fully cleared: 5
26
+ - CC-BY with clear attribution plan: 4
27
+ - Paid commercial with verified terms: 4
28
+ - Procedurally generated by you: 5
29
+ - Generative AI with clear terms: 3
30
+ - Generative AI with unclear terms: 1
31
+ - Unknown: 1
32
+
33
+ ### 4. Quality match (per scene quality bar)
34
+
35
+ - Exceeds bar: 5
36
+ - Meets bar: 4
37
+ - Slightly below bar: 3
38
+ - Notably below: 2
39
+ - Unusable: 1
40
+
41
+ ## Aggregation
42
+
43
+ - Sum the 4 scores; max 20.
44
+ - Recommend highest total.
45
+ - Tie-break: prefer lower time + higher license confidence.
46
+
47
+ ## Examples
48
+
49
+ Option (1) CC0 from polyhaven: time 5, brief 3, license 5, quality 4 → 17.
50
+ Option (2) Paid $99 commercial: time 3, brief 5, license 4, quality 5 → 17.
51
+ Option (3) Procedural Geometry Nodes: time 1, brief 4, license 5, quality 4 → 14.
52
+
53
+ Tied (1) and (2) — pick (2) for brief fidelity if the quality bar matters most.
54
+
55
+ ## When score is low
56
+
57
+ - Highest total < 12 → no good fallback exists.
58
+ - Recommend recipe scope reduction or wait-for-original.
59
+
60
+ ## Related skill
61
+ `../SKILL.md`
@@ -0,0 +1,28 @@
1
+ # EVAL — asset-library-plan
2
+
3
+ ## Text-only eval prompt
4
+ Apply asset-library-plan for a medium repo (~150 assets, mixed models / textures / HDRIs, git + LFS).
5
+
6
+ ## Expected behavior
7
+ - folder tree pinned
8
+ - naming convention with examples
9
+ - metadata schema (fields)
10
+ - VCS rules (LFS threshold)
11
+ - license tracking strategy
12
+ - review process
13
+ - migration steps if relevant
14
+
15
+ ## Pass / Warn / Fail criteria
16
+ - Pass: all sections pinned + naming + license tracking
17
+ - Warn: metadata schema partial
18
+ - Fail: "just dump in a folder", no naming, no license tracking
19
+
20
+ ## Sample passing response outline
21
+ - Library size + VCS header
22
+ - Tree
23
+ - Naming + metadata + VCS + license + review sections
24
+ - Migration steps
25
+
26
+ ## Sample failing response outline
27
+ - "Use a Drive folder"
28
+ - No naming or metadata