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,225 @@
1
+ ---
2
+ name: done-criteria
3
+ description: Define explicit "done" conditions for a Blender recipe before starting work, so the agent stops at the right point instead of drifting into endless polish.
4
+ ---
5
+
6
+ # done-criteria
7
+
8
+ ## Purpose
9
+ Pin a single, explicit stop condition for one recipe BEFORE work begins—consisting of one concrete sentence, an explicit out-of-scope list, and a handoff trigger—so the agent stops at the right point instead of drifting into endless polish. Firing the stop condition routes the deliverable to the next skill; it never upgrades any runtime or artifact truth state. Inspired by Anthropic Superpowers `/just-say-when-it's-done` analog.
10
+
11
+ ## Quick start
12
+ - write one stop condition per recipe (one sentence, concrete)
13
+ - write what is OUT OF SCOPE for "done"
14
+ - write the handoff trigger (which skill receives the deliverable when stop condition fires)
15
+ - enforce: do not polish past the stop condition; do not declare done before it
16
+
17
+ ## When to use
18
+ - BEFORE starting work on any non-trivial single Blender recipe
19
+ - after `blender-recipe-decomposer` has isolated a single recipe and `acceptance-criteria-builder` has provided measurable acceptance rows
20
+ - when previous attempts drifted into endless polish or unclear completion boundaries
21
+
22
+ ## When not to use
23
+ <!-- blendops:generated:start exclusions -->
24
+ - pure exploration or brainstorming → use `../blender-brainstorming/SKILL.md` (use blender-brainstorming; goal is divergence)
25
+ - tiny single-shot requests → use `../intent-to-3d-brief-writer/SKILL.md` (Delegates out-of-scope requests to intent-to-3d-brief-writer)
26
+ - splitting a broad multi-recipe request beforehand → use `../blender-recipe-decomposer/SKILL.md` (use blender-recipe-decomposer first)
27
+ - authoring measurable acceptance rows from scratch → use `../acceptance-criteria-builder/SKILL.md` (use acceptance-criteria-builder first)
28
+ - enforcing per-stage checklist gates during execution → use `../stage-gates/SKILL.md` (use stage-gates)
29
+ - after work has already started and scope is drifting mid-flight → use `../scope-guard/SKILL.md` (use scope-guard)
30
+ - performing the final verification gate before delivery → use `../pre-handoff-verification/SKILL.md` (use pre-handoff-verification)
31
+ <!-- blendops:generated:end exclusions -->
32
+
33
+ ## Trigger phrases
34
+ <!-- blendops:generated:start triggers -->
35
+ - "when are we done"
36
+ - "let's set the bar"
37
+ - "what does done look like"
38
+ <!-- blendops:generated:end triggers -->
39
+
40
+ ## Prerequisites / readiness
41
+ - single-recipe scope is clear (split beforehand via `blender-recipe-decomposer` if needed)
42
+ - measurable acceptance rows are available from `acceptance-criteria-builder`
43
+ - user accepts a written stop condition BEFORE work begins
44
+
45
+ ## Input schema
46
+
47
+ ### Required inputs
48
+
49
+ | Input | Why it is required |
50
+ |---|---|
51
+ | Single recipe scope | Anchors the stop condition to one recipe (via `blender-recipe-decomposer` if previously multi-part) |
52
+ | Measurable acceptance rows | Consumed from `acceptance-criteria-builder` to define what "done" means concretely |
53
+
54
+ ### Optional inputs
55
+
56
+ | Input | Use |
57
+ |---|---|
58
+ | Time / budget constraints | Forces tighter out-of-scope boundaries |
59
+ | Reference deliverable | Calibrates the measurable bar |
60
+
61
+ ### Assumptions to confirm
62
+ - The stop condition is written and agreed to BEFORE work begins.
63
+ - "Done" is the stop and handoff point, not a temporary plateau before extra polish.
64
+ - Ambiguous "done" means the recipe is not yet ready to start.
65
+
66
+ ## Output schema
67
+
68
+ ### Primary output
69
+ A single stop condition record written before work begins: one concrete sentence, an out-of-scope list (3-5 items), and a named handoff trigger skill.
70
+
71
+ ### Secondary output
72
+ - explicit guardrails: what does NOT count as done
73
+ - next-step routing instruction when the stop condition fires
74
+
75
+ ### Evidence / caveat output
76
+
77
+ ```txt
78
+ Runtime status: Not Run | Attempted | Produced | Verified | Failed
79
+ Artifact status: Not Produced | Produced | Verified | Failed
80
+ Evidence used: <links, paths, logs, or "none">
81
+ Limitations: <known gaps>
82
+ ```
83
+
84
+ - Default artifact status is `Not Produced`; default runtime status before execution is `Not Run`.
85
+ - Truth states are downgrade-only, never upgrade.
86
+ - A stop condition firing does NOT upgrade any truth state; downstream evidence skills (such as `render-export-evidence` and `pre-handoff-verification`) decide labels.
87
+
88
+ ## Required laws
89
+ - `../../laws/evidence-before-done.md`
90
+ - `../../laws/non-blender-user-language.md`
91
+ - `../../laws/no-arbitrary-python-interface.md`
92
+ - `../../laws/official-runtime-only.md`
93
+
94
+ ## Official runtime boundary
95
+
96
+ Process and discipline skill only—no Python code and no Blender execution. This skill writes the stop condition before work starts and routes handoff when the condition is met; it never executes runtime tasks or upgrades truth states.
97
+
98
+ ## Operating procedure
99
+ 1. Confirm single-recipe scope BEFORE work begins (if multiple recipes exist, hand off to `blender-recipe-decomposer` first).
100
+ 2. Consume measurable acceptance rows from `acceptance-criteria-builder` and write one concrete stop-condition sentence for the recipe.
101
+ 3. List 3-5 items that are explicitly OUT OF SCOPE for "done".
102
+ 4. Pin the exact catalog skill that receives the handoff when the stop condition fires.
103
+ 5. Hold the boundary: stop polishing once the condition fires and route to the handoff skill (such as `pre-handoff-verification` or `render-export-evidence`) without claiming a truth-state upgrade.
104
+
105
+ ## Decision tree
106
+
107
+ ```txt
108
+ Stop condition vague ("looks great")?
109
+ → Route to acceptance-criteria-builder for measurable rows, then rewrite as one concrete sentence
110
+ Multiple stop conditions or recipes proposed?
111
+ → Route to blender-recipe-decomposer to split scope, or keep the highest-priority condition and move others to out-of-scope
112
+ Work already started and scope is shifting mid-flight?
113
+ → Hand off to scope-guard
114
+ Stop condition not yet evaluable in current mode?
115
+ → Mark as forward-condition; keep runtime Not Run and artifact Not Produced
116
+ ```
117
+
118
+ ## Playbooks
119
+
120
+ ### Playbook A: Hero render
121
+ "Done = `out/render-2026-05-09.png` exists at 1920×1080, 128+ Cycles samples, mood matches brief, validation logged." Handoff trigger: `render-export-evidence` (then `pre-handoff-verification`). Out of scope: animation, post-process, alternate lighting takes.
122
+
123
+ ### Playbook B: GLB handoff
124
+ "Done = `out/scene.glb` exists, gltf-validator passes, triangle count within budget, animation contract documented." Handoff trigger: `glb-web-handoff` (or `pre-handoff-verification`). Out of scope: high-poly cinematic renders, custom shader authoring, additional LOD tiers, promotional stills.
125
+
126
+ ### Playbook C: Text-only plan
127
+ "Done = scene plan section count >= 7, all sections concrete, asset list flagged, handoff to scene quality checker." Handoff trigger: `scene-readiness`. Out of scope: running Blender, producing files, writing Python.
128
+
129
+ ## Mode handling
130
+
131
+ ### Text-only mode
132
+ Stop condition refers strictly to plan completeness. Runtime status remains `Not Run` and artifact status remains `Not Produced`.
133
+
134
+ ### Runtime-ready mode
135
+ Stop condition refers to target artifacts and acceptance rows. When the condition fires, it routes to `render-export-evidence` or `pre-handoff-verification`—firing does not itself upgrade runtime or artifact status to `Produced` or `Verified`.
136
+
137
+ ### Blocked runtime mode
138
+ Stop condition is recorded before work begins as a forward condition awaiting runtime readiness; runtime status stays `Not Run` and artifact status stays `Not Produced`.
139
+
140
+ ## Validation checklist
141
+ - [ ] Written BEFORE work begins on a single recipe
142
+ - [ ] Stop condition is exactly one concrete sentence consuming `acceptance-criteria-builder` rows
143
+ - [ ] Out-of-scope list (3-5 items) is present and explicit
144
+ - [ ] Handoff trigger names a real BlendOps catalog skill
145
+ - [ ] Does not claim or trigger a truth-state upgrade upon firing
146
+ - [ ] Plain language used (no Python, no Blender execution claims)
147
+
148
+ ## Pass / Warn / Fail rubric
149
+
150
+ | Verdict | Criteria |
151
+ |---|---|
152
+ | Pass | One concrete stop condition + out-of-scope + handoff. |
153
+ | Warn | Stop condition present but slightly soft; out-of-scope partial. |
154
+ | Fail | Vague "looks good" stop condition; no out-of-scope; no handoff; multiple conditions stacked. |
155
+
156
+ ## Failure handling
157
+ - Vague stop condition without measurable criteria → route to `acceptance-criteria-builder`, then rewrite.
158
+ - Multiple recipes or conditions stacked → route to `blender-recipe-decomposer` to split into separate recipes.
159
+ - User pushes for "more polish" or changes scope after work starts → hand off to `scope-guard`.
160
+
161
+ ## Troubleshooting
162
+
163
+ | Problem | Response |
164
+ | --- | --- |
165
+ | User wants "perfect" before stopping | Consume concrete rows from `acceptance-criteria-builder`; place "perfect" polish items into the out-of-scope list. |
166
+ | Stop condition keeps moving mid-flight | Mid-recipe scope drift; hand off to `scope-guard`. |
167
+ | Firing treated as `Verified` without evidence | Downgrade-only rule applies (default artifact `Not Produced`); route to `render-export-evidence` and `pre-handoff-verification` to evaluate truth states. |
168
+
169
+ ## Best practices
170
+ - One sentence, one stop condition, one recipe.
171
+ - Write the condition BEFORE work begins.
172
+ - Out-of-scope is at least as important as in-scope.
173
+ - "Done" is honest, not optimistic.
174
+
175
+ ## Good examples
176
+ - "Done = single hero still exported at 1920x1080 meeting the approved framing and lighting acceptance rows. Out of scope: animation, post-process grading, alternate lighting takes. Handoff trigger: `render-export-evidence`."
177
+
178
+ ## Bad examples
179
+ - "Done when it looks great." — vague.
180
+
181
+ ## User-facing response template
182
+
183
+ ```txt
184
+ Recipe: <name>
185
+ Stop condition (one sentence, concrete): <…>
186
+ Out of scope for "done":
187
+ - <…>
188
+ - <…>
189
+ - <…>
190
+ Handoff trigger: <skill>
191
+ Mode: <text-only / runtime-ready / blocked>
192
+ Limitations: <gaps>
193
+ ```
194
+
195
+ ## Anti-patterns
196
+ - Stacking multiple stop conditions or multiple recipes into one record.
197
+ - Using vague language ("when it looks great").
198
+ - Defining or moving the stop condition after work has already begun.
199
+ - Treating a fired stop condition as an automatic upgrade to `Produced` or `Verified`.
200
+ - Blurring roles with `acceptance-criteria-builder`, `stage-gates`, or `scope-guard`.
201
+
202
+ ## Cross-skill handoff
203
+ <!-- blendops:generated:start handoffs -->
204
+ - [upstream_reference] Intent brief → `../intent-to-3d-brief-writer/SKILL.md`
205
+ - [boundary_delegation] Scope splitting beforehand → `../blender-recipe-decomposer/SKILL.md`
206
+ - [upstream_reference] Measurable acceptance rows → `../acceptance-criteria-builder/SKILL.md`
207
+ - [progression] Per-stage workflow gates → `../stage-gates/SKILL.md`
208
+ - [progression] Mid-flight scope drift → `../scope-guard/SKILL.md`
209
+ - [progression] Artifact and render evidence → `../render-export-evidence/SKILL.md`
210
+ - [progression] Final pre-handoff gate → `../pre-handoff-verification/SKILL.md`
211
+ <!-- blendops:generated:end handoffs -->
212
+
213
+ ## Non-goals
214
+ - Run Blender or execute Python.
215
+ - Split multi-recipe scope (`blender-recipe-decomposer`).
216
+ - Author raw measurable acceptance rows (`acceptance-criteria-builder`).
217
+ - Enforce per-stage checklist gates (`stage-gates`).
218
+ - Police mid-flight scope drift (`scope-guard`).
219
+ - Gate the final delivery (`pre-handoff-verification`) or upgrade runtime/artifact truth states.
220
+
221
+ ## References
222
+ - `references/stop-condition-templates.md`
223
+ - `references/out-of-scope-patterns.md`
224
+ - `references/done-vs-perfect.md`
225
+ - `../../docs/skill-system.md`
@@ -0,0 +1,199 @@
1
+ {
2
+ "$schema": "../../schemas/skill-contract.schema.json",
3
+ "id": "done-criteria",
4
+ "version": "1.0.0",
5
+ "category": "process-discipline",
6
+ "role": "done-condition-and-iteration-cap-pinner",
7
+ "purpose": "Define explicit \"done\" conditions for a Blender recipe before starting work, so the agent stops at the right point instead of drifting into endless polish.",
8
+ "capabilityTier": "L0",
9
+ "triggers": [
10
+ "when are we done",
11
+ "let's set the bar",
12
+ "what does done look like"
13
+ ],
14
+ "exclusions": [
15
+ {
16
+ "condition": "pure exploration or brainstorming",
17
+ "delegateTo": "blender-brainstorming",
18
+ "reason": "use blender-brainstorming; goal is divergence"
19
+ },
20
+ {
21
+ "condition": "tiny single-shot requests",
22
+ "delegateTo": "intent-to-3d-brief-writer",
23
+ "reason": "Delegates out-of-scope requests to intent-to-3d-brief-writer"
24
+ },
25
+ {
26
+ "condition": "splitting a broad multi-recipe request beforehand",
27
+ "delegateTo": "blender-recipe-decomposer",
28
+ "reason": "use blender-recipe-decomposer first"
29
+ },
30
+ {
31
+ "condition": "authoring measurable acceptance rows from scratch",
32
+ "delegateTo": "acceptance-criteria-builder",
33
+ "reason": "use acceptance-criteria-builder first"
34
+ },
35
+ {
36
+ "condition": "enforcing per-stage checklist gates during execution",
37
+ "delegateTo": "stage-gates",
38
+ "reason": "use stage-gates"
39
+ },
40
+ {
41
+ "condition": "after work has already started and scope is drifting mid-flight",
42
+ "delegateTo": "scope-guard",
43
+ "reason": "use scope-guard"
44
+ },
45
+ {
46
+ "condition": "performing the final verification gate before delivery",
47
+ "delegateTo": "pre-handoff-verification",
48
+ "reason": "use pre-handoff-verification"
49
+ }
50
+ ],
51
+ "inputs": {
52
+ "required": [
53
+ {
54
+ "name": "locked_3d_brief",
55
+ "type": "object",
56
+ "description": "Locked 8-slot 3D brief defining deliverable intent"
57
+ },
58
+ {
59
+ "name": "acceptance_criteria_rows",
60
+ "type": "array",
61
+ "description": "Measurable Pass/Warn/Fail criteria from acceptance-criteria-builder"
62
+ }
63
+ ],
64
+ "optional": [
65
+ {
66
+ "name": "iteration_budget_preference",
67
+ "type": "integer",
68
+ "description": "Maximum refinement passes before halting or escalating"
69
+ }
70
+ ]
71
+ },
72
+ "outputs": {
73
+ "primary": [
74
+ "definition_of_done_checklist",
75
+ "max_iteration_caps_per_stage",
76
+ "halt_and_escalation_triggers"
77
+ ],
78
+ "truthStatePolicy": {
79
+ "runtimeDefault": "Not Run",
80
+ "artifactDefault": "Not Produced",
81
+ "mutationRule": "downgrade_only"
82
+ }
83
+ },
84
+ "handoffs": [
85
+ {
86
+ "target": "intent-to-3d-brief-writer",
87
+ "type": "upstream_reference",
88
+ "label": "Intent brief",
89
+ "when": {
90
+ "all": [
91
+ {
92
+ "field": "goal.clarity",
93
+ "operator": "equals",
94
+ "value": "clear"
95
+ },
96
+ {
97
+ "field": "brief.locked",
98
+ "operator": "equals",
99
+ "value": false
100
+ }
101
+ ]
102
+ }
103
+ },
104
+ {
105
+ "target": "blender-recipe-decomposer",
106
+ "type": "boundary_delegation",
107
+ "label": "Scope splitting beforehand",
108
+ "when": {
109
+ "all": [
110
+ {
111
+ "field": "fit.multiDeliverableDetected",
112
+ "operator": "equals",
113
+ "value": true
114
+ }
115
+ ]
116
+ }
117
+ },
118
+ {
119
+ "target": "acceptance-criteria-builder",
120
+ "type": "upstream_reference",
121
+ "label": "Measurable acceptance rows",
122
+ "when": {
123
+ "all": [
124
+ {
125
+ "field": "brief.locked",
126
+ "operator": "equals",
127
+ "value": true
128
+ },
129
+ {
130
+ "field": "stage.current",
131
+ "operator": "equals",
132
+ "value": "acceptance_criteria"
133
+ }
134
+ ]
135
+ }
136
+ },
137
+ {
138
+ "target": "stage-gates",
139
+ "type": "progression",
140
+ "label": "Per-stage workflow gates",
141
+ "when": {
142
+ "all": [
143
+ {
144
+ "field": "brief.locked",
145
+ "operator": "equals",
146
+ "value": true
147
+ },
148
+ {
149
+ "field": "stage.current",
150
+ "operator": "equals",
151
+ "value": "stage_gates"
152
+ }
153
+ ]
154
+ }
155
+ },
156
+ {
157
+ "target": "scope-guard",
158
+ "type": "progression",
159
+ "label": "Mid-flight scope drift",
160
+ "when": {
161
+ "all": [
162
+ {
163
+ "field": "scope.driftDetected",
164
+ "operator": "equals",
165
+ "value": true
166
+ }
167
+ ]
168
+ }
169
+ },
170
+ {
171
+ "target": "render-export-evidence",
172
+ "type": "progression",
173
+ "label": "Artifact and render evidence",
174
+ "when": {
175
+ "all": [
176
+ {
177
+ "field": "stage.current",
178
+ "operator": "equals",
179
+ "value": "post_execution_audit"
180
+ }
181
+ ]
182
+ }
183
+ },
184
+ {
185
+ "target": "pre-handoff-verification",
186
+ "type": "progression",
187
+ "label": "Final pre-handoff gate",
188
+ "when": {
189
+ "all": [
190
+ {
191
+ "field": "stage.current",
192
+ "operator": "equals",
193
+ "value": "final_verification"
194
+ }
195
+ ]
196
+ }
197
+ }
198
+ ]
199
+ }
@@ -0,0 +1,56 @@
1
+ # Done vs perfect
2
+
3
+ ## Why this matters
4
+
5
+ "Done" is honest completion against a stop condition. "Perfect" is an asymptote — pursuing it eats time without bounded benefit.
6
+
7
+ The stop condition pins "done" so the agent stops before drifting toward "perfect".
8
+
9
+ ## When users push past the stop condition
10
+
11
+ User says: "Looks great, but can we also...?"
12
+
13
+ Response:
14
+ 1. Acknowledge the stop condition is met.
15
+ 2. Offer the addition as a new scope agreement (new recipe / new stop condition).
16
+ 3. Do not silently absorb.
17
+
18
+ User says: "Almost there, just one more pass at...?"
19
+
20
+ Response:
21
+ 1. Check: does the stop condition actually require another pass?
22
+ 2. If yes (the condition not yet evaluated true) → continue.
23
+ 3. If no (condition is met but user wants more polish) → flag as scope addition; require new agreement.
24
+
25
+ ## Polish vs done — the test
26
+
27
+ Question to self: **Has the stop condition been verified by evidence?**
28
+ - Yes → done. Stop. Hand off.
29
+ - No → not done. Continue per checklist gates.
30
+
31
+ This separates "honest done" from "feels not done".
32
+
33
+ ## When not done feels done
34
+
35
+ Sometimes a render "feels great" but the stop condition is technically not met (e.g. samples threshold not yet reached, or validation not logged). In this case:
36
+ - "Done" remains `Pending` until evidence supports it.
37
+ - The user can choose to amend the stop condition (with a new agreement) if the original bar was too strict.
38
+ - Do not silently mark done.
39
+
40
+ ## When done feels not done
41
+
42
+ Sometimes the stop condition is met but the result feels disappointing. In this case:
43
+ - The recipe is honestly done per agreed bar.
44
+ - Disappointment indicates the stop condition was the wrong target.
45
+ - Document as a learning for the next recipe; do not extend this one silently.
46
+
47
+ ## Rationalization prevention table
48
+
49
+ | Excuse | Reality |
50
+ |---|---|
51
+ | "Let me add one extra camera bevel/polish before stopping." | Polish past the written stop condition is silent scope creep. Stop and route to handoff. |
52
+ | "The scene looks great, so the stop condition doesn't matter." | Subjectivity cannot replace the agreed acceptance row. Verify the row or downgrade to `Pending`. |
53
+ | "I'll adjust the stop condition slightly to match what was built." | Moving the goalpost after execution corrupts truth discipline. Route to `scope-guard`. |
54
+
55
+ ## Related skill
56
+ `../SKILL.md`
@@ -0,0 +1,50 @@
1
+ # Out-of-scope patterns
2
+
3
+ The "out of scope" list is at least as important as the stop condition. It prevents:
4
+ - silent scope creep
5
+ - "while we're at it" drift
6
+ - post-stop polish that compounds time
7
+
8
+ ## Common out-of-scope items per recipe type
9
+
10
+ ### Render hero
11
+ - Alternate lighting takes
12
+ - Animation
13
+ - Post-process color grade beyond default
14
+ - Multiple aspect ratios from same scene
15
+ - Variant material colors
16
+
17
+ ### GLB export
18
+ - Multiple LOD levels (unless explicit)
19
+ - Animation re-targeting
20
+ - Web component implementation
21
+ - Asset re-licensing
22
+
23
+ ### Scene plan (text-only)
24
+ - Modeling work
25
+ - Asset sourcing (only flagging)
26
+ - Render preview
27
+ - Final-quality rendering
28
+
29
+ ### Multi-product grid
30
+ - Per-product hero variants
31
+ - Lifestyle context shots
32
+ - Animation
33
+ - Per-product separate renders (unless requested)
34
+
35
+ ## When to add to out-of-scope
36
+
37
+ If during work the user says "could you also...", that addition goes to:
38
+ - (a) a new follow-up recipe with its own stop condition, OR
39
+ - (b) the current recipe's out-of-scope (if the user is just exploring, not requesting).
40
+
41
+ Never silently expand the in-scope work to absorb the addition.
42
+
43
+ ## How to phrase
44
+
45
+ - "Animation" (not "we won't animate" — phrase as a topic, not a verb negation)
46
+ - "Lifestyle context shots" (specific, not "anything else")
47
+ - Pair with "deferred to follow-up recipe" if the user wants to do it later.
48
+
49
+ ## Related skill
50
+ `../SKILL.md`
@@ -0,0 +1,39 @@
1
+ # Stop condition templates
2
+
3
+ ## Template by recipe type
4
+
5
+ ### Render hero
6
+ "Done = `out/<name>.png` exists at <W>×<H>, <samples>+ samples, mood matches brief reference (diff < <X>%), validation logged in `docs/evals/...`."
7
+
8
+ ### GLB export
9
+ "Done = `out/<name>.glb` exists, `gltf-validator` passes, triangle count <= <budget>, animation contract documented in `glb-animation-handoff` output."
10
+
11
+ ### Text-only scene plan
12
+ "Done = scene plan with all <N> required sections concrete (no "TBD"), asset list flagged for discovery, handoff to `<next skill>`."
13
+
14
+ ### Multi-render grid
15
+ "Done = <N> renders exist for grid cells, all consistent (camera + lighting + background within tolerance), composite layout image produced."
16
+
17
+ ### Pre-runtime readiness
18
+ "Done = readiness checklist all green, runtime path chosen + recorded, no Blocked items remain."
19
+
20
+ ### Final response writing
21
+ "Done = stakeholder-facing response written, jargon checked, evidence labels honest, no overclaim."
22
+
23
+ ## Common boilerplate
24
+
25
+ Every stop condition contains:
26
+ - A specific artifact or evaluable state.
27
+ - A measurable threshold (resolution, samples, count, percentage).
28
+ - A reference for "match" if applicable (brief, image, validator output).
29
+ - A truth label rule per `evidence-before-done.md`.
30
+
31
+ ## Templates to NOT use
32
+
33
+ - "Done when good."
34
+ - "Done when ready."
35
+ - "Done when the user says so." (Imprecise; user input is needed for scope agreement, not the stop condition itself.)
36
+ - "Done when there are no blockers." (Negative phrasing; rephrase positively.)
37
+
38
+ ## Related skill
39
+ `../SKILL.md`
@@ -0,0 +1,44 @@
1
+ # EVAL — environment-shot
2
+
3
+ ## Text-only eval prompt
4
+ Use environment-shot on a brief: "cyberpunk city street at night, light rain, cinematic 2.39:1 mood".
5
+
6
+ ## Expected behavior
7
+ - Locale + time of day + weather pinned
8
+ - Atmosphere + sky chosen
9
+ - Camera position + lens + altitude + tilt explicit
10
+ - FG / MG / BG composition layers explicit
11
+ - Focal subject named (or explicit "none")
12
+ - Asset list flagged
13
+ - Handoff named
14
+ - Honest evidence label
15
+
16
+ ## Pass / Warn / Fail criteria
17
+ - Pass: all sections + plausible weather + focal subject + assets flagged
18
+ - Warn: locale broad / one section ambiguous
19
+ - Fail: contradictory time + weather, no depth layers, no focal subject
20
+
21
+ ## Common failure modes
22
+ - "Beautiful weather" without specifics
23
+ - mixing portrait scope into establishing
24
+ - skipping atmospheric haze decision
25
+ - treating sky as afterthought
26
+
27
+ ## Evidence expectations
28
+ - explicit time-of-day + weather + atmosphere
29
+ - depth layers separated
30
+ - handoff list
31
+
32
+ ## Sample passing response outline
33
+ - Locale + time + weather header
34
+ - Atmosphere + sky line
35
+ - Camera row
36
+ - FG / MG / BG layers
37
+ - Focal subject
38
+ - Asset list
39
+ - Next: handoff named
40
+
41
+ ## Sample failing response outline
42
+ - "Wide shot of a city"
43
+ - No time / weather
44
+ - No depth layers