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,75 @@
1
+ # `Attempted` vs `Failed` Rubric
2
+
3
+ These two labels are commonly confused. They are not synonyms.
4
+
5
+ ## Definitions
6
+
7
+ | Label | Meaning |
8
+ |---|---|
9
+ | `Attempted` | Runtime action was started; **outcome is unknown or evidence is incomplete**. The action might have succeeded, failed, or been interrupted — we don't have enough evidence to say. |
10
+ | `Failed` | Runtime action was started; **we have evidence it did not meet stated criteria**. The failure is observed, not assumed. |
11
+
12
+ ## Decision rule
13
+
14
+ ```
15
+ Was a runtime action attempted?
16
+ NO → `Not Run`
17
+ YES → Did we OBSERVE evidence of the outcome?
18
+ NO → `Attempted` (unknown outcome)
19
+ YES → Did the observed outcome match the stated criteria?
20
+ YES → `Produced` or `Verified` (depending on validation)
21
+ NO → `Failed`
22
+ ```
23
+
24
+ ## Examples
25
+
26
+ ### Example 1 — `Attempted` (correct)
27
+
28
+ > Operator ran `blender --background --python script.py`. The terminal session was killed before completion. No output file exists. No exit code captured. Stdout truncated.
29
+
30
+ → Outcome unknown. Label = `Attempted`. We don't know if it would have succeeded.
31
+
32
+ ### Example 2 — `Failed` (correct)
33
+
34
+ > Operator ran `blender --background --python script.py`. Exit code = 1. Stderr shows `ImportError: bpy module not found`. No output file.
35
+
36
+ → Outcome observed and confirmed not-success. Label = `Failed`.
37
+
38
+ ### Example 3 — Common mistake
39
+
40
+ > Operator ran a render. The system became unresponsive for 10 minutes. Operator gave up and force-quit. No output file.
41
+
42
+ | ❌ Wrong | ✅ Correct |
43
+ |---|---|
44
+ | `Failed` (because nothing came out) | `Attempted` (force-quit ≠ observed failure; the render might have been close to completing) |
45
+
46
+ The honest label depends on **what the operator actually saw**, not on what the operator assumes.
47
+
48
+ ### Example 4 — `Failed` after partial success
49
+
50
+ > Render completed and `preview.png` exists at 1920×1080. Validation: subject is centered (Pass), mood is wrong (Fail — should be cyberpunk neon, but rendered with default lighting).
51
+
52
+ → Output exists but validation failed. Label = `Failed`. (Not `Produced`, because validation notes were recorded and they fail the acceptance criteria.)
53
+
54
+ ### Example 5 — `Produced` after partial validation
55
+
56
+ > Render completed and `preview.png` exists. Operator did not run the validation checklist yet.
57
+
58
+ → Output exists, no validation. Label = `Produced`. Move to `Verified` only after validation runs and passes.
59
+
60
+ ## Anti-patterns
61
+
62
+ | ❌ Don't | ✅ Do |
63
+ |---|---|
64
+ | Default to `Failed` because output is missing | Use `Attempted` if outcome is unknown; `Failed` only with observed evidence |
65
+ | Use `Failed` interchangeably with `Not Run` | `Not Run` = no attempt happened; `Failed` = attempt happened and observed not-success |
66
+ | Mark `Produced` when validation already failed | If validation notes exist and they fail, label is `Failed`, not `Produced` |
67
+ | Re-run forever to escape `Attempted` | Sometimes evidence is genuinely lost; `Attempted` is a valid honest label |
68
+
69
+ ## Routing
70
+
71
+ If you find yourself stuck choosing between `Attempted` and `Failed`:
72
+
73
+ 1. Check `pre-handoff-verification` 7-point gate first. The gate may downgrade `Failed` to `Attempted` if check 3 (artifact paths exist) fails.
74
+ 2. If the truth genuinely is unknown, prefer `Attempted` — it is the more conservative label and respects `evidence-before-done` law.
75
+ 3. Run `blender-troubleshooting` Phase 1 to determine if the symptom is reproducible. Reproducibility evidence helps choose between the two labels.
@@ -0,0 +1,143 @@
1
+ # Evidence Record Templates
2
+
3
+ Use these templates when filling `docs/evals/path-X-...md`. Copy the relevant template, fill every field, save under `docs/evals/`.
4
+
5
+ ## Template A — Path 1 (Lab MCP) read-only smoke
6
+
7
+ ```md
8
+ # Path 1 Read-Only Smoke Test (<host option a/b>) — YYYY-MM-DD
9
+
10
+ Status: Pass / Available — Path 1 read-only access via <host>
11
+ Date: <YYYY-MM-DD>
12
+ Operator: <name or handle>
13
+
14
+ ## Identity
15
+
16
+ | Field | Value |
17
+ |---|---|
18
+ | Path | Path 1 — Official Blender Lab MCP |
19
+ | Host option | (a) Anthropic Connector OR (b) manual MCP client |
20
+ | MCP host product + version | <e.g. Claude Desktop X.Y.Z> |
21
+ | Blender version (`blender --version`) | <verbatim> |
22
+ | Lab MCP add-on version | <e.g. mcp-1.0.0> |
23
+ | Lab MCP server source | <`.mcpb` filename or commit> |
24
+
25
+ ## Tools called (read-only only)
26
+
27
+ | # | Tool name | Status | Notes |
28
+ |---|---|---|---|
29
+ | 1 | get_blendfile_summary_path_info | ok | |
30
+ | 2 | get_blendfile_summary_datablocks | ok | |
31
+ | 3 | get_objects_summary | ok | |
32
+
33
+ ## No-mutation guarantee
34
+
35
+ - [x] No `execute_blender_code` was called with mutating Python.
36
+ - [x] No render was triggered.
37
+ - [x] No GLB export was triggered.
38
+ - [x] No `.blend` file save.
39
+
40
+ ## Verdict
41
+
42
+ ```txt
43
+ Path 1 read-only access via <host>: Pass / Available
44
+ Path 1 mutation / render / export: Not Run
45
+ Other paths: unchanged
46
+ Full runtime manual eval: Not Run
47
+ Runtime artifacts: Not Produced
48
+ v0.1.0 tag: depends on full eval
49
+ ```
50
+ ```
51
+
52
+ ## Template B — Path 2 (community `mcp-for-blender`) read-only smoke
53
+
54
+ See `docs/evals/path-2-mcp-for-blender-readonly-template.md` (canonical template). Copy it, fill, save.
55
+
56
+ ## Template C — Full runtime eval (mutation / render / export)
57
+
58
+ ```md
59
+ # <Path> Full Runtime Eval — <recipe name> — YYYY-MM-DD
60
+
61
+ Status: Verified / Produced / Failed (per truth-label-decision-tree)
62
+ Date: <YYYY-MM-DD>
63
+ Operator: <name or handle>
64
+
65
+ ## Identity
66
+ (same fields as Template A or B per chosen path)
67
+
68
+ ## Recipe
69
+ - Source recipe: `docs/recipes/<recipe>.md`
70
+ - Brief: `<link to brief or quote>`
71
+
72
+ ## Actions executed
73
+
74
+ | # | Action | Tool / command | Result |
75
+ |---|---|---|---|
76
+ | 1 | <e.g. create scene> | <tool name> | ok / fail |
77
+ | ... | | | |
78
+
79
+ ## Generated artifacts
80
+
81
+ | Artifact | Output path | File exists | File size | Validation notes | Truth label |
82
+ |---|---|---|---|---|---|
83
+ | Render preview | `renders/preview-<date>.png` | yes / no | <bytes> | <subject framing centered, mood visible, …> | Verified |
84
+ | GLB | `exports/<name>-<date>.glb` | yes / no | <bytes> | <gltf-validator pass, web import test pass> | Verified |
85
+
86
+ ## Validation against acceptance criteria
87
+
88
+ For each acceptance criterion in the brief:
89
+
90
+ | # | Criterion | Result | Evidence |
91
+ |---|---|---|---|
92
+ | 1 | <e.g. subject centered with negative space> | Pass | <screenshot + brief reference> |
93
+ | 2 | <e.g. GLB ≤ 10MB> | Pass | <file size> |
94
+
95
+ ## Failure / caveat log
96
+
97
+ - <any errors, warnings, environment notes>
98
+
99
+ ## Pre-handoff verification
100
+
101
+ - [ ] Ran `pre-handoff-verification` 7-point gate
102
+ - [ ] Verdict: Pass / Warn / Fail
103
+ - [ ] Downgrades applied (if any)
104
+
105
+ ## Verdict
106
+
107
+ ```txt
108
+ <Path> full runtime eval for <recipe>: Verified / Produced / Failed
109
+ v0.1.0 tag: <upgrade decision>
110
+ ```
111
+ ```
112
+
113
+ ## Template D — Failed run
114
+
115
+ ```md
116
+ # <Path> Failed Runtime Attempt — <recipe> — YYYY-MM-DD
117
+
118
+ Status: Failed
119
+ Date: <YYYY-MM-DD>
120
+
121
+ ## What was attempted
122
+ <brief description>
123
+
124
+ ## Where it failed (Phase from `blender-troubleshooting`)
125
+ - Phase 1 reproducibility: <count>
126
+ - Phase 2 narrowed input: <minimum reproducing case>
127
+ - Phase 3 root cause: <one-sentence>
128
+ - Phase 4 proposed fix: <one-sentence + handoff skill>
129
+
130
+ ## Truth labels
131
+ - Render: Failed (or Attempted if no output)
132
+ - GLB: Failed
133
+ - Overall: Failed
134
+
135
+ ## Next action
136
+ <route to which skill, with what>
137
+ ```
138
+
139
+ ## Saving conventions
140
+
141
+ - Filename: `path-<N>-[host-]-<recipe>-<YYYY-MM-DD>.md` under `docs/evals/`.
142
+ - Append the new file to the "Evidence and result index" in `docs/evals/README.md`.
143
+ - If the new evidence changes a verdict, update `docs/release-readiness.md`.
@@ -0,0 +1,57 @@
1
+ # Truth Label Decision Tree
2
+
3
+ Walk this tree to assign one of the 5 truth labels to each artifact item. Stop at the first matching condition.
4
+
5
+ ```
6
+ 1. Was a runtime action ATTEMPTED?
7
+ NO → label = `Not Run`. Stop.
8
+ YES → continue to 2.
9
+
10
+ 2. Did the runtime action COMPLETE?
11
+ NO (failed mid-execution / errored out) → label = `Failed`. Stop.
12
+ YES → continue to 3.
13
+
14
+ 3. Does the OUTPUT PATH exist on disk OR is the output VISIBLE in a viewer?
15
+ NO → label = `Attempted`. Stop.
16
+ YES → continue to 4.
17
+
18
+ 4. Are VALIDATION NOTES recorded against acceptance criteria?
19
+ NO → label = `Produced`. Stop.
20
+ YES → continue to 5.
21
+
22
+ 5. Did validation PASS the stated acceptance criteria?
23
+ NO → label = `Failed` (or `Produced` if validation is partial; choose conservatively).
24
+ YES → label = `Verified`. Stop.
25
+ ```
26
+
27
+ ## State transitions
28
+
29
+ Labels can only move in these directions:
30
+
31
+ | From | To | When |
32
+ |---|---|---|
33
+ | `Not Run` | `Attempted` | Runtime action started but evidence incomplete |
34
+ | `Not Run` | `Failed` | Runtime action started and confirmed failed |
35
+ | `Attempted` | `Produced` | Output path or visible output now exists |
36
+ | `Attempted` | `Failed` | Confirmed the action did not produce output |
37
+ | `Produced` | `Verified` | Validation notes recorded and pass acceptance criteria |
38
+ | `Produced` | `Failed` | Validation notes recorded and fail acceptance criteria |
39
+ | `Verified` | (downgrade only) | Per `pre-handoff-verification` rules |
40
+
41
+ ## Forbidden transitions
42
+
43
+ | From | To | Why forbidden |
44
+ |---|---|---|
45
+ | `Not Run` | `Produced` directly | Cannot produce without an attempt |
46
+ | `Not Run` | `Verified` directly | Cannot validate non-existent output |
47
+ | `Attempted` | `Verified` directly | Verification requires output path + validation notes |
48
+ | Any | upgrade by `pre-handoff-verification` | That skill never upgrades; only downgrades or confirms |
49
+
50
+ ## Common confusion
51
+
52
+ | Mistake | Correct label |
53
+ |---|---|
54
+ | "It rendered, so `Verified`" | `Produced` until validation notes exist |
55
+ | "I saw the file, so `Produced`" | Confirm path on disk explicitly; otherwise `Attempted` |
56
+ | "The smoke test passed, so render `Verified`" | Smoke covers read-only access; render is a separate claim |
57
+ | "Most checks passed, so `Verified`" | If any acceptance criterion failed → `Failed` or `Produced`, not `Verified` |
@@ -0,0 +1,26 @@
1
+ # EVAL — resolution-aspect-decision
2
+
3
+ ## Text-only eval prompt
4
+ Apply resolution-aspect-decision for a web hero retina (16:9, 2880×1620, downscale to 1920×1080 + 960×540).
5
+
6
+ ## Expected behavior
7
+ - aspect 16:9
8
+ - resolution 2880×1620
9
+ - downscale margin yes
10
+ - multi-resolution outputs listed
11
+ - caveats
12
+ - handoff to render-export-evidence
13
+
14
+ ## Pass / Warn / Fail criteria
15
+ - Pass: aspect + resolution + DPI + downscale margin + caveats + handoff
16
+ - Warn: borderline resolution
17
+ - Fail: aspect mismatch, upscale plan, "1080p" without aspect
18
+
19
+ ## Sample passing response outline
20
+ - Consumer + aspect + resolution + DPI rows
21
+ - Multi-resolution outputs
22
+ - Caveats
23
+
24
+ ## Sample failing response outline
25
+ - "1080p"
26
+ - No aspect
@@ -0,0 +1,246 @@
1
+ ---
2
+ name: resolution-aspect-decision
3
+ description: Pick the right render resolution + aspect ratio for the consumer use case before render; avoid render-then-crop and aspect mismatch.
4
+ ---
5
+
6
+ # resolution-aspect-decision
7
+
8
+ ## Purpose
9
+ Avoid the most common render planning mistake: rendering at one aspect / resolution and cropping or upscaling to fit. Pick the consumer's required output upfront.
10
+
11
+ ## Quick start
12
+ - Identify the consumer use case and target placement (web hero, social feed, print, app asset).
13
+ - Pick the delivery aspect ratio (`W:H`) upfront so camera framing matches target placement.
14
+ - Pick exact render resolution (`W × H` in pixels) and `DPI / PPI` for print deliverables.
15
+ - Define per-stream resolution records if multiple delivery targets exist.
16
+ - Pin the record for the operator to enter in Blender scene render properties (no rendering, no post-render resizing).
17
+
18
+ ## When to use
19
+ - before render
20
+ - when consumer requires specific aspect / resolution
21
+ - before composition planning (aspect drives composition rules)
22
+
23
+ ## When not to use
24
+ <!-- blendops:generated:start exclusions -->
25
+ - after render is complete (no benefit) → use `../camera-composition/SKILL.md` (no benefit)
26
+ - pure modeling → use `../output-format-decision/SKILL.md` (Delegates out-of-scope requests to output-format-decision)
27
+ - internal preview-only renders (any reasonable size works) → use `../composition-quality-checker/SKILL.md` (any reasonable size works)
28
+ <!-- blendops:generated:end exclusions -->
29
+
30
+ ## Trigger phrases
31
+ <!-- blendops:generated:start triggers -->
32
+ - "what resolution"
33
+ - "how big should the render be"
34
+ - "16:9 or square"
35
+ <!-- blendops:generated:end triggers -->
36
+
37
+ ## Prerequisites / readiness
38
+ - Consumer use case and target placement are known (or ready to be confirmed with one question).
39
+ - Color config (`color-management-decision`), container/codec (`output-format-decision`), and engine (`cycles-vs-eevee-decision`) remain separate decisions owned by their respective skills.
40
+
41
+ ## Input schema
42
+
43
+ ### Required inputs
44
+
45
+ | Input | Why it is required |
46
+ |---|---|
47
+ | Consumer use case / placement | Determines target aspect ratio and required pixel dimensions |
48
+ | Print physical dimensions + target DPI/PPI (if print) | Required to compute exact pixel width and height (`W × H`) before render |
49
+
50
+ ### Optional inputs
51
+
52
+ | Input | Use |
53
+ |---|---|
54
+ | Brand or platform delivery spec | Overrides category defaults with exact required `W × H` and aspect |
55
+ | Multi-stream delivery list | Produces separate per-stream resolution records for each target aspect/size |
56
+ | Render time / memory constraints | Flags caveats if high pixel counts require operator budget review |
57
+
58
+ ### Assumptions to confirm
59
+ - The target machine and render budget can handle the pinned `W × H` resolution.
60
+ - Multiple aspect ratios will be framed via camera/scene setup rather than post-render cropping.
61
+
62
+ ## Output schema
63
+
64
+ ### Primary output
65
+ A 3-line resolution record per target stream:
66
+ 1. Aspect ratio (`W:H`)
67
+ 2. Render resolution (`W × H` pixels)
68
+ 3. `DPI / PPI` (explicit value for print; `N/A (screen delivery)` for digital)
69
+
70
+ ### Secondary output
71
+ - Per-stream resolution rules when delivering to multiple placements
72
+ - Caveats (hardware memory/time budget notes, framing handoff requirements)
73
+
74
+ ### Evidence / caveat output
75
+
76
+ ```txt
77
+ Runtime status: Not Run
78
+ Artifact status: Not Produced
79
+ Evidence used: <consumer spec, or "none">
80
+ Limitations: <unconfirmed platform specs, memory/time budget caveats>
81
+ ```
82
+
83
+ > **Truth-state rule:** Pinning an aspect ratio and resolution is a planning decision and never produces a file. Default to `Runtime status: Not Run` and `Artifact status: Not Produced`. Truth states are downgrade-only and must never be upgraded by this skill.
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
+ Decision skill — does not render. Pins resolution + aspect; operator applies in scene render properties.
94
+
95
+ ## Operating procedure
96
+
97
+ 1. Identify the consumer use case and all target delivery streams.
98
+ 2. Pin the required aspect ratio (`W:H`) for each stream from the consumer spec (or mark fallback defaults as assumptions to confirm).
99
+ 3. Pin the exact render resolution (`W × H`) and `DPI / PPI` (for print) to be set directly in scene render properties—do not prescribe post-render resizing, cropping, or upscaling.
100
+ 4. For multi-aspect deliverables, define a separate resolution record per stream and hand off camera framing to `camera-composition` and `composition-quality-checker`.
101
+ 5. Record caveats and set truth states to `Runtime status: Not Run` and `Artifact status: Not Produced`.
102
+
103
+ ## Decision tree
104
+
105
+ ```txt
106
+ Consumer provides exact W × H (and DPI for print)?
107
+ → Pin exact consumer spec; verify aspect ratio matches W × H.
108
+ Web / desktop widescreen placement?
109
+ → Pin widescreen aspect (e.g., 16:9) and target display W × H from spec; DPI: N/A.
110
+ Social square placement?
111
+ → Pin 1:1 aspect and platform-required W × H; DPI: N/A.
112
+ Mobile vertical / story placement?
113
+ → Pin 9:16 aspect and platform-required W × H; DPI: N/A.
114
+ Ultrawide / cinematic banner?
115
+ → Pin target banner aspect (e.g., 2.39:1) and spec W × H; DPI: N/A.
116
+ Print delivery (physical size + target DPI/PPI)?
117
+ → Compute W × H = (physical inches × DPI) at exact print aspect ratio; pin W × H and DPI.
118
+ Multiple aspects required from one scene?
119
+ → Emit one resolution record per stream; require per-aspect camera framing (never render-then-crop).
120
+ ```
121
+
122
+ ## Playbooks
123
+
124
+ ### Playbook A: Single-stream digital hero
125
+
126
+ Pin the target aspect ratio (such as `16:9`) and exact delivery `W × H` required by the placement spec (`DPI / PPI: N/A`). Operator enters `W × H` in scene render properties before composition check.
127
+
128
+ ### Playbook B: Multi-stream social campaign
129
+
130
+ Emit separate resolution records for each stream (for example, `9:16` vertical, `1:1` square, and `16:9` widescreen) with their respective target `W × H`. Hand off to `camera-composition` and `composition-quality-checker` so each aspect is properly framed in-camera rather than cropped post-render.
131
+
132
+ ### Playbook C: Print deliverable
133
+
134
+ Obtain physical print dimensions and required print density (`DPI / PPI`). Calculate exact pixel dimensions (`W × H`), pin the native print aspect ratio, and require rendering directly at final print resolution without post-render upscaling.
135
+
136
+ ### Playbook D: Multi-size asset family
137
+
138
+ When a consumer needs multiple distinct pixel dimensions, list each required `W × H` stream in the per-stream resolution record so the operator can plan native render outputs or hand off post-render image processing outside BlendOps.
139
+
140
+ ## Mode handling
141
+
142
+ ### Text-only mode
143
+
144
+ Return the resolution record, per-stream rules, caveats, and truth states (`Runtime status: Not Run`, `Artifact status: Not Produced`).
145
+
146
+ ### Runtime-ready mode
147
+
148
+ Return the exact same resolution record and truth states (`Runtime status: Not Run`, `Artifact status: Not Produced`) for the operator to apply in scene render properties. Actual file verification after rendering belongs strictly to `render-export-evidence`.
149
+
150
+ ### Blocked runtime mode
151
+
152
+ Return the resolution record, caveats, and truth states (`Runtime status: Not Run`, `Artifact status: Not Produced`).
153
+
154
+ ## Validation checklist
155
+
156
+ * [ ] Aspect ratio (`W:H`) explicitly pinned for every output stream
157
+ * [ ] Render resolution (`W × H`) explicitly pinned for every output stream
158
+ * [ ] `DPI / PPI` specified for print outputs (or marked `N/A` for screen)
159
+ * [ ] No post-render resize, crop, or upscale steps prescribed
160
+ * [ ] Caveats and downgrade-only truth states (`Not Run` / `Not Produced`) included
161
+
162
+ ## Pass / Warn / Fail rubric
163
+
164
+ | Verdict | Criteria |
165
+ | --- | --- |
166
+ | Pass | Aspect + `W × H` + `DPI / PPI` (if print) explicitly pinned per stream; matches consumer use case; no post-render crop/upscale assumed; truth states set to `Not Run` / `Not Produced`. |
167
+ | Warn | Aspect and `W × H` pinned using fallback assumptions because consumer spec was incomplete, or high pixel count risks memory/time budget limits. |
168
+ | Fail | Aspect omitted or mismatched to placement; relies on render-then-crop or post-render upscaling; upgrades truth state without verified evidence. |
169
+
170
+ ## Failure handling
171
+
172
+ * Consumer spec unspecified → ask once for placement and target dimensions; if unavailable, state a fallback aspect and `W × H` explicitly as an unconfirmed assumption in Caveats.
173
+ * Multi-aspect request → emit separate per-stream resolution records and route framing to `camera-composition` and `composition-quality-checker` (never advise silent cropping).
174
+ * Resolution exceeds hardware memory or render time budget → flag in Caveats and recommend operator review before rendering.
175
+
176
+ ## Troubleshooting
177
+
178
+ | Problem | Response |
179
+ |---|---|
180
+ | Final delivery looks soft | Probably upscaled from low-res; re-render at delivery res. |
181
+ | Aspect cropped wrong | Pre-render at correct aspect; do not crop. |
182
+ | Print too low-DPI | Render at delivery DPI from the start; do not upscale. |
183
+ | Consumer spec unclear | Ask once, then default per consumer category. |
184
+
185
+ ## Best practices
186
+
187
+ * Always pin the delivery aspect ratio before camera setup so `camera-composition` and `composition-quality-checker` frame against the true boundary.
188
+ * Render directly at the required delivery resolution (`W × H`); keep post-render resizing, cropping, or format conversion outside this skill.
189
+ * For multi-aspect deliverables, output explicit per-stream records and require per-aspect camera validation.
190
+ * Pass the pinned resolution record to `render-export-evidence` so rendered files can be checked against target dimensions after execution.
191
+
192
+ ## Good examples
193
+
194
+ * "Consumer: Web hero. Aspect: `16:9`. Resolution: `1920 × 1080` (per client spec). DPI/PPI: `N/A`. Multi-stream: none. Caveats: confirm whether high-DPI display tier requires a second native render stream. `Runtime status: Not Run`, `Artifact status: Not Produced`."
195
+
196
+ ## Bad examples
197
+ - "1080p." — no aspect.
198
+
199
+ ## User-facing response template
200
+
201
+ ```txt
202
+ Consumer use case: <web hero / social / print / app asset / banner>
203
+ Aspect ratio: <W:H>
204
+ Resolution: <W H px ×>
205
+ DPI / PPI: <value if print, else "N/A">
206
+
207
+ Per-stream outputs (if multiple):
208
+ - <stream name>: <W:H>, <W H px ×>, DPI/PPI: <value or N/A>
209
+
210
+ Caveats: <budget notes, unconfirmed spec assumptions>
211
+ Runtime status: Not Run
212
+ Artifact status: Not Produced
213
+ Evidence used: <consumer spec or "none">
214
+ Limitations: <known gaps>
215
+ Next: camera-composition -> composition-quality-checker -> render-export-evidence
216
+ ```
217
+
218
+ ## Anti-patterns
219
+ - "1080p" without aspect.
220
+ - Render small, upscale large.
221
+ - Crop instead of re-frame for different aspects.
222
+ - "Default size" answers.
223
+
224
+ ## Cross-skill handoff
225
+ <!-- blendops:generated:start handoffs -->
226
+ - [upstream_reference] Camera & composition planning (upstream framing setup) → `../camera-composition/SKILL.md`
227
+ - [progression] Composition framing validation against pinned aspect → `../composition-quality-checker/SKILL.md`
228
+ - [upstream_reference] Color configuration decision → `../color-management-decision/SKILL.md`
229
+ - [progression] Container / codec decision → `../output-format-decision/SKILL.md`
230
+ - [progression] Render engine decision → `../cycles-vs-eevee-decision/SKILL.md`
231
+ - [progression] Post-render saved file verification → `../render-export-evidence/SKILL.md`
232
+ <!-- blendops:generated:end handoffs -->
233
+
234
+ ## Non-goals
235
+
236
+ * Never execute Blender or trigger renders.
237
+ * Never resize, crop, upscale, or convert images post-render (belongs outside this skill).
238
+ * Never choose file containers, codecs, or bit depths (`output-format-decision`).
239
+ * Never configure color spaces or HDR view transforms (`color-management-decision`).
240
+ * Never validate camera composition (`composition-quality-checker`) or verify rendered output files (`render-export-evidence`).
241
+
242
+ ## References
243
+ - `references/aspect-defaults.md`
244
+ - `references/resolution-defaults.md`
245
+ - `references/print-vs-screen-rules.md`
246
+ - `../../docs/skill-system.md`