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,198 @@
1
+ {
2
+ "$schema": "../../schemas/skill-contract.schema.json",
3
+ "id": "scene-readiness",
4
+ "version": "1.0.0",
5
+ "category": "quality-validators",
6
+ "role": "holistic-scene-readiness-aggregator",
7
+ "purpose": "Apply multi-category readiness gates with pass/warn/fail and evidence-bound verdicts.",
8
+ "capabilityTier": "L0",
9
+ "triggers": [
10
+ "quality-check this scene",
11
+ "is this ready",
12
+ "evaluate pass warn fail"
13
+ ],
14
+ "exclusions": [
15
+ {
16
+ "condition": "as a replacement for evidence collection",
17
+ "delegateTo": "product-hero-scene-planner",
18
+ "reason": "Delegates out-of-scope requests to product-hero-scene-planner"
19
+ },
20
+ {
21
+ "condition": "to fabricate confidence in missing artifacts",
22
+ "delegateTo": "lighting-material-plan",
23
+ "reason": "Delegates out-of-scope requests to lighting-material-plan"
24
+ }
25
+ ],
26
+ "inputs": {
27
+ "required": [
28
+ {
29
+ "name": "scene_plan_and_specialist_verdicts",
30
+ "type": "object",
31
+ "description": "Scene specification plus specialist rows from material, lighting, composition, and polycount checkers"
32
+ },
33
+ {
34
+ "name": "acceptance_criteria_table",
35
+ "type": "object",
36
+ "description": "Measurable Pass/Warn/Fail thresholds for the target deliverable"
37
+ }
38
+ ],
39
+ "optional": [
40
+ {
41
+ "name": "preview_or_inspection_notes",
42
+ "type": "object",
43
+ "description": "Optional read-only scene inspection summary or viewport preview notes"
44
+ }
45
+ ]
46
+ },
47
+ "outputs": {
48
+ "primary": [
49
+ "holistic_scene_quality_verdict",
50
+ "aggregated_pass_warn_fail_table",
51
+ "blocking_defect_remediation_route"
52
+ ],
53
+ "truthStatePolicy": {
54
+ "runtimeDefault": "Not Run",
55
+ "artifactDefault": "Not Produced",
56
+ "mutationRule": "downgrade_only"
57
+ }
58
+ },
59
+ "handoffs": [
60
+ {
61
+ "target": "composition-quality-checker",
62
+ "type": "upstream_reference",
63
+ "label": "Focused domain validation (if gaps found) (composition-quality-checker)",
64
+ "when": {
65
+ "all": [
66
+ {
67
+ "field": "quality.domain",
68
+ "operator": "equals",
69
+ "value": "composition"
70
+ },
71
+ {
72
+ "field": "quality.verdict",
73
+ "operator": "equals",
74
+ "value": "not_run"
75
+ }
76
+ ]
77
+ }
78
+ },
79
+ {
80
+ "target": "lighting-quality-checker",
81
+ "type": "upstream_reference",
82
+ "label": "Focused domain validation (if gaps found) (lighting-quality-checker)",
83
+ "when": {
84
+ "all": [
85
+ {
86
+ "field": "quality.domain",
87
+ "operator": "equals",
88
+ "value": "lighting"
89
+ },
90
+ {
91
+ "field": "quality.verdict",
92
+ "operator": "equals",
93
+ "value": "not_run"
94
+ }
95
+ ]
96
+ }
97
+ },
98
+ {
99
+ "target": "material-quality-checker",
100
+ "type": "upstream_reference",
101
+ "label": "Focused domain validation (if gaps found) (material-quality-checker)",
102
+ "when": {
103
+ "all": [
104
+ {
105
+ "field": "quality.domain",
106
+ "operator": "equals",
107
+ "value": "material"
108
+ },
109
+ {
110
+ "field": "quality.verdict",
111
+ "operator": "equals",
112
+ "value": "not_run"
113
+ }
114
+ ]
115
+ }
116
+ },
117
+ {
118
+ "target": "polycount-budget-checker",
119
+ "type": "upstream_reference",
120
+ "label": "Focused domain validation (if gaps found) (polycount-budget-checker)",
121
+ "when": {
122
+ "all": [
123
+ {
124
+ "field": "quality.domain",
125
+ "operator": "equals",
126
+ "value": "polycount"
127
+ },
128
+ {
129
+ "field": "budget.verdict",
130
+ "operator": "equals",
131
+ "value": "Not Run"
132
+ }
133
+ ]
134
+ }
135
+ },
136
+ {
137
+ "target": "render-export-evidence",
138
+ "type": "progression",
139
+ "label": "Evidence classification",
140
+ "when": {
141
+ "all": [
142
+ {
143
+ "field": "stage.current",
144
+ "operator": "equals",
145
+ "value": "post_execution_audit"
146
+ }
147
+ ]
148
+ }
149
+ },
150
+ {
151
+ "target": "pre-handoff-verification",
152
+ "type": "progression",
153
+ "label": "Handoff gate",
154
+ "when": {
155
+ "all": [
156
+ {
157
+ "field": "stage.current",
158
+ "operator": "equals",
159
+ "value": "final_verification"
160
+ }
161
+ ]
162
+ }
163
+ },
164
+ {
165
+ "target": "glb-web-handoff",
166
+ "type": "conditional",
167
+ "label": "Web delivery (when applicable)",
168
+ "when": {
169
+ "all": [
170
+ {
171
+ "field": "artifact.type",
172
+ "operator": "equals",
173
+ "value": "glb"
174
+ },
175
+ {
176
+ "field": "handoff.consumerStack",
177
+ "operator": "equals",
178
+ "value": "web_glb"
179
+ }
180
+ ]
181
+ }
182
+ },
183
+ {
184
+ "target": "plain-language-response",
185
+ "type": "progression",
186
+ "label": "Final communication",
187
+ "when": {
188
+ "all": [
189
+ {
190
+ "field": "stage.current",
191
+ "operator": "equals",
192
+ "value": "final_communication"
193
+ }
194
+ ]
195
+ }
196
+ }
197
+ ]
198
+ }
@@ -0,0 +1,24 @@
1
+ # Blocker Catalog
2
+
3
+ ## Purpose
4
+ Classify common blockers encountered during `scene-readiness` checks so every `Not Ready` or `Not Run` verdict pairs an exact root cause with one actionable fix instead of a vague failure message.
5
+
6
+ ## When to use
7
+ - Whenever `scene-readiness` halts handoff due to incomplete planning inputs, missing runtime verification, broken scene checks, or failed budget gates.
8
+
9
+ ## Blocker Taxonomy
10
+
11
+ | Blocker Class | Typical Evidence / Symptoms | Impact on Handoff | Next Remediation Skill / Action |
12
+ |---|---|---|---|
13
+ | **Missing Planning Sections** | Scene plan lacks camera lens, floor height (`Z = 0`), lighting key/fill ratio, or material roughness/albedo bounds | Downstream Blender build or render would guess dimensions/mood | `product-hero-scene-planner` / `camera-composition` / `lighting-material-plan` |
14
+ | **Runtime Not Run / Disconnected** | Planning docs exist, but no MCP/CLI execution occurred or Blender Lab MCP server refused connection | No preview image or `.glb` exists (`Artifact status: Not Produced`) | `runtime-readiness` (or `runtime-attempt-report` if an execution failed) |
15
+ | **Unresolved Geometry / UV Failure** | Non-manifold edges, inverted normals, missing `Z = 0` grounding, or `texel density` spread `> 1.3x` / unapplied scale (`scale != 1`) | Broken shading in Cycles/EEVEE and distorted textures in web `.glb` | `polycount-budget-checker` / `blender-troubleshooting` |
16
+ | **Web Budget or Validator Failure** | `.glb` exceeds `mobile-glb-budget` (`> 50k` tris / `> 10 MB`), drops procedural Blender nodes, or throws `gltf-validator` errors | Fails browser load time or breaks Three.js / R3F rendering | `glb-web-handoff` / `web-material-simplification.md` |
17
+ | **Simulation / Bake Cache Unbaked** | Cloth, hair, fluid, or procedural shader nodes left unbaked (`bake` not set to `ALL` or procedural maps not baked to textures) | Final render or glTF export collapses back to frame 1 / blank white material | `scene-readiness` bake gate -> bake before export |
18
+ | **Unlicensed External Asset** | Commercial project uses mesh/HDRI/texture without confirmed `CC0`/`CC-BY` or commercial license | Legal release risk | `asset-license-checker` |
19
+
20
+ ## Rule
21
+ - Never emit `"Blocked"` without naming **(1) Blocker Class**, **(2) Observed Impact**, and **(3) Exact Next Step**.
22
+
23
+ ## Related skill
24
+ [../SKILL.md](../SKILL.md)
@@ -0,0 +1,22 @@
1
+ # Not Run Handling
2
+
3
+ ## Purpose
4
+ Prevent false `Ready` or `Verified` handoff claims whenever Blender execution did not run (`Runtime status: Not Run`), while still giving honest feedback on planning completeness.
5
+
6
+ ## When to use
7
+ - In text-only / planning-only reviews, dry-run validations, or when runtime setup is blocked before scene execution.
8
+
9
+ ## Mandatory Rules When Runtime Did Not Execute
10
+ 1. **Separate Plan Quality from Runtime Proof**: You may grade *planning completeness* (`Scene plan complete`, `Camera & budget targets defined`), **never** *visual render quality* or *exported binary integrity*.
11
+ 2. **Enforce Canonical Truth Labels**:
12
+ - Always record **`Runtime status: Not Run`** (or `Failed` / `Attempted` if a real attempt occurred).
13
+ - Always record **`Artifact status: Not Produced`** (NEVER write `Artifact status: Not Run` — `Not Produced` is the canonical artifact state when no file was generated on disk).
14
+ 3. **Never Pre-Approve Visual Aesthetics**: Do not say `"lighting looks photoreal"` or `"GLB loads fast in Three.js"` before a real preview image or `.glb` file exists and is inspected.
15
+ 4. **Provide the Single Next Unlock Action**: Name which path (`Path 1`, `Path 2`, or `CLI fallback`) or doc (`docs/evals/official-runtime-manual-eval-packet.md`) unlocks execution next.
16
+
17
+ ## Good vs. Bad Output Snippets
18
+ - **Good**: `"Planning readiness: Strong (scene, camera, and tier-2 web material specs are complete). Runtime status: Not Run — Blender did not execute in this pass. Artifact status: Not Produced (no render PNG or .glb exists on disk). Next: connect Path 1 Lab MCP or run CLI fallback, then validate with pre-handoff-verification."`
19
+ - **Bad**: `"Scene ready for web deployment!"` or `"Artifact status: Not Run — export ready"` (violates truth-state discipline and misleads non-Blender users).
20
+
21
+ ## Related skill
22
+ [../SKILL.md](../SKILL.md)
@@ -0,0 +1,23 @@
1
+ # Quality Rubric
2
+
3
+ ## Purpose
4
+ Provide category rubric guidance for scene quality checks.
5
+
6
+ ## When to use
7
+ During scene-readiness scoring.
8
+
9
+ ## Patterns
10
+ - evaluate by category before verdict
11
+ - tie each score to evidence/caveat state
12
+ - **Reference-Image-Match loop** (when target reference images exist): check silhouette and real-world bounding proportions (`dimensions`) at blockout *before* adding detail; compare at least two camera angles rather than one flattering shot
13
+ - **Quantitative scene introspection**: pair visual inspection with evaluated object counts, world-space bounding boxes, z-fight / floating tolerance checks, and `Z = 0` grounding checks
14
+ - **Simulation / bake cache gate**: distinguish replay preview caches from baked `ALL` caches (cloth, fluid, smoke); a modifier without a verified disk bake is never complete for simulation handoff
15
+
16
+ ## Good example
17
+ Each category has pass/warn/fail with rationale, reference-silhouette checks when references exist, and explicit separation between planning readiness (`Conditionally Ready`) and runtime/artifact truth states.
18
+
19
+ ## Bad example
20
+ Single summary verdict without category detail, or approving a multi-angle hero asset from a single front screenshot alone.
21
+
22
+ ## Related skill
23
+ ../SKILL.md
@@ -0,0 +1,22 @@
1
+ # Verdict Language
2
+
3
+ ## Purpose
4
+ Standardize final readiness verdict labels across `scene-readiness` and `pre-handoff-verification` so stakeholders immediately understand whether an asset is truly deliverable on disk, only planned on paper, or blocked.
5
+
6
+ ## When to use
7
+ - At the opening and closing verdict lines of every `scene-readiness` check.
8
+
9
+ ## Four Canonical Readiness Verdicts
10
+
11
+ | Verdict Label | Exact Meaning | Allowed Companion Truth States | Example Wording |
12
+ |---|---|---|---|
13
+ | `Ready` | Both planning **AND** real exported/rendered artifacts exist on disk and passed all P0 visual, geometry, and `gltf-validator` checks | `Runtime status: Verified`, `Artifact status: Verified` | `"Ready: exports/hero-shoe.glb (2.8 MB, 31k tris, gltf-validator 0 errors) and hero render PNG verified on disk."` |
14
+ | `Conditionally Ready` | Artifacts exist (`Produced`) with minor non-blocking `Warn` polish items, **OR** planning docs are complete (`Ready (planning-only)`) awaiting runtime execution | `Produced` (with explicit caveats) OR `Not Run / Not Produced` (explicitly scoped as plan-only) | `"Conditionally Ready (planning-only): scene, camera, and material plans pass review, but Runtime status is Not Run and Artifact status is Not Produced until Blender executes."` |
15
+ | `Not Ready` | Real defects found (clipped frame, missing `Z = 0` grounding, budget overflow, unbaked procedural shaders, or `gltf-validator` errors) | `Runtime status: Failed` or `Verified` with failing `Artifact status: Failed` | `"Not Ready: exports/hero.glb failed mobile budget (148k tris vs 50k cap) and dropped procedural sole texture. Next: bake maps and decimate before re-export."` |
16
+ | `Not Run` | Execution/evaluation check itself could not start due to missing runtime setup or missing inputs (`Runtime status: Not Run`, `Artifact status: Not Produced`) | `Runtime status: Not Run`, `Artifact status: Not Produced` | `"Not Run: Blender Lab MCP bridge not configured yet; no render or .glb evaluation could be performed."` |
17
+
18
+ ## Hard Prohibition
19
+ - Never output `Ready` when `Runtime status` is `Not Run` or `Artifact status` is `Not Produced`. Without files on disk, the highest truthful verdict is **`Conditionally Ready (planning-only)`** or **`Not Run`**.
20
+
21
+ ## Related skill
22
+ [../SKILL.md](../SKILL.md)
@@ -0,0 +1,33 @@
1
+ # EVAL — scope-guard
2
+
3
+ ## Text-only eval prompt
4
+ Mid-recipe (single hero render in progress), user says "can you also do 4 color variants?". Apply scope-guard.
5
+
6
+ ## Expected behavior
7
+ - addition named explicitly
8
+ - 3 options (decline / add-now / defer) presented
9
+ - recommendation given (typically defer for substantive addition)
10
+ - decision required before continuing
11
+ - stop condition / gate update note if added
12
+
13
+ ## Pass / Warn / Fail criteria
14
+ - Pass: addition named + 3 options + recommendation + decision required + update path documented
15
+ - Warn: options partial (only 2) or rationale partial
16
+ - Fail: silent absorption, no defer option, no decision required
17
+
18
+ ## Common failure modes
19
+ - "Sure, I'll do both"
20
+ - skipping the defer option
21
+ - not updating stop condition
22
+
23
+ ## Sample passing response outline
24
+ - Addition named
25
+ - Original scope reminder
26
+ - 3 options
27
+ - Recommendation
28
+ - "Decision needed" line
29
+
30
+ ## Sample failing response outline
31
+ - "Yes I'll add that"
32
+ - No options offered
33
+ - No agreement evidence
@@ -0,0 +1,222 @@
1
+ ---
2
+ name: scope-guard
3
+ description: Detect mid-recipe scope creep and push back constructively before the recipe drifts; require explicit user agreement before scope expansion.
4
+ ---
5
+
6
+ # scope-guard
7
+
8
+ ## Purpose
9
+ Catch mid-flight scope creep ("can you also do X?") and force an explicit recorded decision: (a) decline the expansion, (b) add now with explicit user agreement (updating the stop condition and stage gates), or (c) defer to a follow-up recipe. Prevents silent absorption that breaks gates and stop conditions. Trivial in-gate items may be absorbed only when existing gate criteria explicitly cover them — never by feel.
10
+
11
+ ## Quick start
12
+ - when scope drift is detected, name it
13
+ - offer 3 options: decline / explicit-add-now (with agreement) / defer to follow-up recipe
14
+ - record the decision before proceeding
15
+
16
+ ## When to use
17
+ - mid-recipe, when user adds new requests beyond the brief
18
+ - when "while we're at it" appears
19
+ - when stages start exceeding their gates "just a bit"
20
+
21
+ ## When not to use
22
+ <!-- blendops:generated:start exclusions -->
23
+ - early planning before scope is pinned → use `../done-criteria/SKILL.md` (use intent-to-3d-brief-writer and done-criteria)
24
+ - pure brainstorming with no active recipe → use `../blender-brainstorming/SKILL.md` (use blender-brainstorming)
25
+ - when the addition is already explicitly covered by existing gate criteria in stage-gates / acceptance-criteria-builder (verified against w → use `../acceptance-criteria-builder/SKILL.md` (verified against written criteria, never judged by feel)
26
+ <!-- blendops:generated:end exclusions -->
27
+
28
+ ## Trigger phrases
29
+ <!-- blendops:generated:start triggers -->
30
+ - "can you also"
31
+ - "while you're at it"
32
+ - "actually let's also"
33
+ - "one more thing"
34
+ <!-- blendops:generated:end triggers -->
35
+
36
+ ## Prerequisites / readiness
37
+ - recipe has an active brief (`intent-to-3d-brief-writer`), pinned stop condition (`done-criteria`), and stage gates (`stage-gates` / `acceptance-criteria-builder`)
38
+ - user accepts that mid-flight scope changes require an explicit, recorded decision
39
+
40
+ ## Input schema
41
+
42
+ ### Required inputs
43
+
44
+ | Input | Why it is required |
45
+ |---|---|
46
+ | Current scope (brief + stop condition) | Anchors the boundary pinned before execution |
47
+ | Current stage gates & acceptance criteria | Judges whether an addition is truly within an existing gate or exceeds it |
48
+ | Proposed addition | Subject of the scope decision |
49
+
50
+ ### Optional inputs
51
+
52
+ | Input | Use |
53
+ |---|---|
54
+ | Time / budget remaining | Affects feasibility of in-recipe addition |
55
+
56
+ ### Assumptions to confirm
57
+ - The user agrees scope creep must be named, classified, and recorded — never silently absorbed.
58
+ - "Trivial within current gate" is judged strictly by written gate criteria (`stage-gates` / `acceptance-criteria-builder`), never by feel.
59
+
60
+ ## Output schema
61
+
62
+ ### Primary output
63
+ A scope decision record: named addition (one sentence), classification (in-gate trivial by criteria / substantive / major), recommended action (decline / add-now-with-agreement / defer), rationale, and recorded evidence of user agreement before proceeding.
64
+
65
+ ### Secondary output
66
+ - updated stop condition (`done-criteria`), stage gates (`stage-gates`), and measurable acceptance rows (`acceptance-criteria-builder`) if added now
67
+ - explicit follow-up recipe note (`blender-recipe-decomposer`) if deferred
68
+
69
+ ### Evidence / caveat output
70
+
71
+ ```txt
72
+ Runtime status: Not Run | Attempted | Produced | Verified | Failed
73
+ Artifact status: Not Produced | Produced | Verified | Failed
74
+ Evidence used: <links, paths, logs, or "none">
75
+ Limitations: <known gaps>
76
+ ```
77
+
78
+ ## Required laws
79
+ - `../../laws/evidence-before-done.md`
80
+ - `../../laws/non-blender-user-language.md`
81
+ - `../../laws/no-arbitrary-python-interface.md`
82
+ - `../../laws/official-runtime-only.md`
83
+
84
+ ## Official runtime boundary
85
+
86
+ Process / discipline skill — does not run Blender or execute Python. Decisions govern scope boundaries, stop conditions, and stage gates. A scope decision never upgrades runtime (`Not Run | Attempted | Produced | Verified | Failed`) or artifact (`Not Run | Not Produced | Produced | Verified | Failed`, default `Not Produced`) truth states; truth-state changes are downgrade-only (for example, when added scope invalidates a previously satisfied gate).
87
+
88
+ ## Operating procedure
89
+ 1. Detect and name the mid-flight scope addition (trigger phrase or new requirement beyond the brief).
90
+ 2. Compare the addition against the current brief, pinned stop condition (`done-criteria`), and written stage gate criteria (`stage-gates` / `acceptance-criteria-builder`).
91
+ 3. Classify (never by feel — verify against written gate criteria; thresholds per `references/scope-addition-classification.md`):
92
+ - **Trivial within existing gate**: ONLY if written gate criteria already encompass it → name it, record that it fits the existing gate criteria, and proceed without silent drift.
93
+ - **Substantive addition**: exceeds current gate criteria or stop condition → present the 3 options (decline / add-now-with-agreement / defer) and require explicit user agreement.
94
+ - **Major addition or brief contradiction**: alters recipe architecture or invalidates earlier stages → strongly recommend deferring to a follow-up recipe via `blender-recipe-decomposer`.
95
+ 4. Record the user's explicit decision before proceeding.
96
+ 5. If added now: update the stop condition (`done-criteria`), stage gates (`stage-gates`), and measurable criteria (`acceptance-criteria-builder`); downgrade any invalidated runtime/artifact truth states (never upgrade).
97
+ 6. If deferred: record an explicit follow-up recipe note for `blender-recipe-decomposer` before final `pre-handoff-verification`.
98
+
99
+ ## Decision tree
100
+
101
+ ```txt
102
+ Addition extends scope by < 5%?
103
+ → Likely trivial; mention briefly
104
+ Addition extends scope 5-25%?
105
+ → Propose 3 options; require agreement
106
+ Addition extends scope > 25%?
107
+ → Recommend defer to follow-up recipe; require strong override
108
+ Addition contradicts brief?
109
+ → Force pause; brief needs revision before continuation
110
+ ```
111
+
112
+ ## Playbooks
113
+
114
+ ### Playbook A: "Can you also add color variants?"
115
+ Original recipe: single hero render. Addition is substantive (multi-render). Recommend defer to follow-up `product-grid-scene-planner` recipe.
116
+
117
+ ### Playbook B: "Slight different lighting?"
118
+ Original recipe: hero render with locked lighting. Addition is medium. Propose: decline, add-with-extra-render, or defer.
119
+
120
+ ### Playbook C: "Just bump the resolution"
121
+ Original recipe: 1920×1080. Addition: 4K. Likely small effort but doubles render time. Propose: decline, add-with-extended-time-budget, or defer.
122
+
123
+ ## Mode handling
124
+
125
+ ### Text-only mode
126
+ Scope decisions govern the plan, stop condition, and gate definitions; runtime status remains `Not Run` and artifact status remains `Not Produced` (default).
127
+
128
+ ### Runtime-ready mode
129
+ Scope decisions affect the render queue, asset queue, and stage gates. Adding scope never upgrades truth states; if an addition invalidates prior outputs, downgrade affected runtime/artifact states accordingly.
130
+
131
+ ### Blocked runtime mode
132
+ Scope decisions still apply to the planning and gate layer; runtime truth states remain unchanged or downgraded.
133
+
134
+ ## Validation checklist
135
+ - [ ] Addition named explicitly in one sentence and classified against written gate criteria (not by feel)
136
+ - [ ] Action recommendation (decline / add-now-with-agreement / defer) stated explicitly
137
+ - [ ] Explicit user agreement recorded before proceeding
138
+ - [ ] Stop condition (`done-criteria`), stage gates (`stage-gates`), and acceptance rows (`acceptance-criteria-builder`) updated if added now
139
+ - [ ] Follow-up recipe note documented for `blender-recipe-decomposer` if deferred
140
+ - [ ] Truth states kept downgrade-only (no runtime or artifact truth state upgraded by the scope decision)
141
+
142
+ ## Pass / Warn / Fail rubric
143
+
144
+ | Verdict | Criteria |
145
+ |---|---|
146
+ | Pass | Addition named, options offered, decision recorded, stop condition / gates updated. |
147
+ | Warn | Decision made but rationale partial. |
148
+ | Fail | Silent absorption into recipe; no agreement; no updated stop condition; "while we're at it" drift unchecked. |
149
+
150
+ ## Failure handling
151
+ - User refuses to decide → require pause; do not continue with ambiguous scope.
152
+ - User wants "just both" → that is silent absorption; force explicit agreement.
153
+ - Recurring scope creep → flag pattern; suggest scope retro before next recipe.
154
+
155
+ ## Troubleshooting
156
+
157
+ | Problem | Response |
158
+ |---|---|
159
+ | User pushes back on the boundary | Explain the cost: gates broken, stop condition moved, time multiplies. |
160
+ | Scope creep already absorbed silently | Stop; reset scope explicitly; document the slip. |
161
+ | Multiple additions in same conversation | Process each one separately; do not bundle. |
162
+
163
+ ## Best practices
164
+ - Name the addition explicitly; do not gloss.
165
+ - Always offer the defer option (it is usually the best one).
166
+ - Treat agreement as evidence; record it.
167
+ - Pair with `stage-gates` for gate updates.
168
+
169
+ ## Good examples
170
+ - "Addition: render 4K version. Original brief: 1920×1080. This is substantive; doubles render time. Options: (1) Decline — keep 1920×1080. (2) Add now — extend recipe time, new gate '4K render exists'. (3) Defer — follow-up recipe for high-res. Recommended: defer."
171
+
172
+ ## Bad examples
173
+ - "Sure, I'll do that too." — silent absorption.
174
+
175
+ ## User-facing response template
176
+
177
+ ```txt
178
+ Detected scope addition: <addition in one sentence>
179
+ Classification: <in-gate by written criteria | substantive | major>
180
+
181
+ Original brief: <one line>
182
+ Original stop condition: <one line>
183
+
184
+ Options:
185
+ 1. Decline — proceed with original scope and gates.
186
+ 2. Add now — require explicit agreement to updated stop condition (<updated stop condition>) and updated stage gates (<updated gates / acceptance criteria>). Cost: <time / gate / budget impact>.
187
+ 3. Defer — keep current scope unchanged; record as a follow-up recipe note for blender-recipe-decomposer: <follow-up recipe note>.
188
+
189
+ Recommended: <option>
190
+ Decision needed before proceeding.
191
+ Runtime status: Not Run | Attempted | Produced | Verified | Failed
192
+ Artifact status: Not Produced | Produced | Verified | Failed (default: Not Produced)
193
+ Limitations: <gaps; scope decisions never upgrade truth states>
194
+ ```
195
+
196
+ ## Anti-patterns
197
+ - Silently absorbing an addition ("Sure, I'll do that too") or judging it "trivial" by feel instead of written gate criteria.
198
+ - Adding scope without updating both the stop condition (`done-criteria`) and stage gates (`stage-gates` / `acceptance-criteria-builder`).
199
+ - Treating "while we're at it" as part of the original scope.
200
+ - Omitting the defer option or failing to record a follow-up recipe note (`blender-recipe-decomposer`).
201
+ - Upgrading runtime or artifact truth states on the basis of a scope agreement.
202
+
203
+ ## Cross-skill handoff
204
+ <!-- blendops:generated:start handoffs -->
205
+ - [upstream_reference] Original brief → `../intent-to-3d-brief-writer/SKILL.md`
206
+ - [upstream_reference] Stop condition pinned beforehand / updated on expansion → `../done-criteria/SKILL.md`
207
+ - [upstream_reference] Per-stage gates enforced / updated on expansion → `../stage-gates/SKILL.md`
208
+ - [boundary_delegation] Measurable acceptance rows for added scope → `../acceptance-criteria-builder/SKILL.md`
209
+ - [boundary_delegation] Deferred scope split into follow-up recipes → `../blender-recipe-decomposer/SKILL.md`
210
+ - [progression] Delivery gate after scope and gates settle → `../pre-handoff-verification/SKILL.md`
211
+ <!-- blendops:generated:end handoffs -->
212
+
213
+ ## Non-goals
214
+ - Run Blender.
215
+ - Author the recipe.
216
+ - Decide for the user (the user picks among options).
217
+
218
+ ## References
219
+ - `references/scope-addition-classification.md`
220
+ - `references/options-language-template.md`
221
+ - `references/recurring-creep-patterns.md`
222
+ - `../../docs/skill-system.md`