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,259 @@
1
+ ---
2
+ name: workflow-stage-router
3
+ description: Given current artifacts and intent, name the next BlendOps skill or workflow stage and preconditions to advance.
4
+ ---
5
+
6
+ # workflow-stage-router
7
+
8
+ ## Purpose
9
+
10
+ Reduce skill-choice paralysis by mapping **current state → next narrow skill** across BlendOps workflows while preserving evidence and runtime boundaries.
11
+
12
+ ## Quick start
13
+
14
+ - capture what exists now (brief, plan, renders, GLB, evidence logs)
15
+ - compare against `references/milestone-model.md`
16
+ - emit route via `references/routing-decision-tree.md`
17
+ - fill `references/stage-handoff-template.md`
18
+
19
+ ## When to use
20
+
21
+ - user asks "what skill next" after partial progress
22
+ - agent risks loading too many skills at once
23
+ - resume after interruption
24
+
25
+ ## When not to use
26
+ <!-- blendops:generated:start exclusions -->
27
+ - Initial goal is vague or entry point is unknown → use `../blendops-help/SKILL.md` (Triages ambiguous entry requests at precedence Rank 1)
28
+ - Goal is clear but no recipe or pack has been chosen yet → use `../recipe-fit-assessor/SKILL.md` (Selects the fitting recipe/pack at precedence Rank 2)
29
+ - Pack is selected and brief exists, but pack preflight has not completed yet → use `../pack-prerequisite-checker/SKILL.md` (Executes preflight readiness verification at precedence Rank 3 before stage routing)
30
+ - Active MCP runtime bridge conflict on port 9876 → use `../bridge-conflicts/SKILL.md` (Resolves port and dual add-on conflicts before advancing)
31
+ - Final stakeholder-facing wording and plain-language summary → use `../plain-language-response/SKILL.md` (Formats validated workflow outputs for non-Blender users)
32
+ <!-- blendops:generated:end exclusions -->
33
+
34
+ ## Trigger phrases
35
+ <!-- blendops:generated:start triggers -->
36
+ - "where are we in the workflow"
37
+ - "what's next"
38
+ - "resume from here"
39
+ - "next skill"
40
+ <!-- blendops:generated:end triggers -->
41
+
42
+ ## Prerequisites / readiness
43
+
44
+ - honest inventory of artifacts + truth labels
45
+ - user goal unchanged or explicitly revised
46
+
47
+ ## Input schema
48
+
49
+ ### Required inputs
50
+
51
+ | Input | Why it is required |
52
+ |---|---|
53
+ | Current artifact inventory | Determines stage |
54
+ | Active intent | Prevents wrong branch |
55
+
56
+ ### Optional inputs
57
+
58
+ | Input | Use |
59
+ |---|---|
60
+ | Target pack/recipe | Narrows milestone track |
61
+
62
+ ## Output schema
63
+
64
+ ### Primary output
65
+
66
+ - current stage name
67
+ - single immediate next skill from the locked precedence order + why (or escalation to the precedence owner if a multi-skill clash lacks a locked order, or immediate exit to `pre-handoff-verification` on any failed gate / blocked mode)
68
+ - preconditions checklist for advancing
69
+
70
+ ### Evidence / caveat output
71
+
72
+ ```txt
73
+ Runtime status: Not Run | Attempted | Produced | Verified | Failed
74
+ Artifact status: Not Produced | Produced | Verified | Failed (defaults to Not Produced; downgrade-only, never upgrade)
75
+ Evidence used: <inventory references>
76
+ Limitations: <unknown state>
77
+ ```
78
+
79
+ ## Required laws
80
+
81
+ - `../../laws/evidence-before-done.md`
82
+ - `../../laws/non-blender-user-language.md`
83
+ - `../../laws/no-arbitrary-python-interface.md`
84
+ - `../../laws/official-runtime-only.md`
85
+
86
+ ## Official runtime boundary
87
+
88
+ Routing only — no Python and no Blender execution (`execute_blender_code` is never invoked here). If the next step requires runtime selection or configuration, route to `runtime-path-picker`, `runtime-setup`, `runtime-readiness`, `path-one-host-outline`, or `cli-appendix-job-outline` with these locked boundaries:
89
+
90
+ - **Path 1 (Official Blender Lab MCP):** Requires Blender 5.1+ (`blender_version_min = "5.1.0"`), hosted via Anthropic Connector in Claude Desktop or a manually configured MCP client. The Connector is not standalone and never replaces the Lab MCP add-on inside Blender (even though the Anthropic tutorial prerequisite text says "Blender 4.2 or later", the binding minimum is 5.1+).
91
+ - **Path 2 (Community `mcp-for-blender`):** Renamed from `ahujasid/blender-mcp`, third-party, Blender 3.0+. Use only with caveats and never as release evidence.
92
+ - **CLI fallback (`blender --background --python`):** Appendix only (`cli-appendix-job-outline`), never a peer path without an evaluation record.
93
+
94
+ ## Operating procedure
95
+
96
+ 1. Normalize the artifact inventory and runtime state against `references/milestone-model.md`. Default any missing or unverified artifact status to `Not Produced`; apply truth states as downgrade-only (never upgrade).
97
+ 2. Enforce the locked precedence rules without re-deciding cross-skill precedence locally:
98
+ - **Evidence beats assumption**
99
+ - **Geometry lock before look-dev**
100
+ - **Export waits for validation**
101
+ 3. If any gate has failed or the workflow is in blocked mode, exit immediately to `pre-handoff-verification` — never route forward.
102
+ 4. Walk `references/routing-decision-tree.md` to select the single immediate next skill. If multiple skills clash without a locked precedence order, stop and escalate to the precedence owner rather than picking a skill locally.
103
+ 5. Emit `references/stage-handoff-template.md`.
104
+
105
+ ## Decision tree
106
+
107
+ ```txt
108
+ Is the initial goal vague or are recipe/preflight gates still incomplete?
109
+ Goal vague / no entry context → route to blendops-help (Rank 1)
110
+ Goal clear, no recipe/pack selected → route to recipe-fit-assessor (Rank 2)
111
+ Recipe selected, pack preflight not completed → route to pack-prerequisite-checker (Rank 3)
112
+ Has any quality gate failed, is an evidence contradiction present, or is the workflow in blocked mode?
113
+ Active MCP port 9876 / dual-bridge conflict → route to bridge-conflicts
114
+ Any other failed gate, evidence contradiction, or blocked mode → exit immediately to pre-handoff-verification (never route forward)
115
+ Does the user request mid-workflow scope expansion or an unapproved extra deliverable?
116
+ Yes → route to scope-guard before advancing
117
+ No → walk the locked milestone precedence order (`references/routing-decision-tree.md`):
118
+ 1. Unverified render/export files claimed as done → render-export-evidence (evidence beats assumption)
119
+ 2. Runtime mutation requested while Runtime status is Not Run → runtime-readiness
120
+ 3. Scene/geometry/asset plan incomplete → domain scene planner or asset-discovery (geometry lock before look-dev)
121
+ 4. Geometry locked, camera/composition or lighting/materials needed → camera-composition / lighting-material-plan
122
+ 5. Plans complete, pre-export quality validation needed → scene-readiness or narrow quality checker (export waits for validation)
123
+ 6. Evidence verified and stakeholder summary needed → glb-web-handoff or plain-language-response
124
+ 7. Multi-skill clash with no locked precedence order → stop and escalate to the precedence owner
125
+ ```
126
+
127
+ ## Playbooks
128
+
129
+ ### Playbook A: Mid-planning progression (`Geometry lock before look-dev`)
130
+
131
+ - Inspect the inventory snapshot (`references/milestone-model.md`): locked brief and scene/camera composition plan exist, `Runtime status: Not Run`, `Artifact status: Not Produced`.
132
+ - Apply locked precedence (`geometry lock before look-dev`) to select `../lighting-material-plan/SKILL.md` as the single immediate next skill.
133
+ - Emit `references/stage-handoff-template.md` with explicit preconditions (composition plan consumed; no runtime mutation claimed).
134
+
135
+ ### Playbook B: Unverified artifact claim interception (`Evidence beats assumption`)
136
+
137
+ - When the user claims a render or GLB is "done" and asks to jump straight to stakeholder handoff (`plain-language-response`) without an evidence ledger, enforce **evidence beats assumption**.
138
+ - Keep unverified artifacts downgraded (`Not Produced` or `Produced`, never `Verified`) and route immediately to `../render-export-evidence/SKILL.md`.
139
+
140
+ ### Playbook C: Failed gate or mid-stream scope creep (`Stop & gate`)
141
+
142
+ - If a quality checker (`scene-readiness`, `polycount-budget-checker`) returned `Fail` or runtime is blocked, halt forward progression and exit immediately to `../pre-handoff-verification/SKILL.md`.
143
+ - If the user injects new deliverables mid-workflow, route to `../scope-guard/SKILL.md` before loading any downstream planner.
144
+
145
+ ## Mode handling
146
+
147
+ ### Text-only mode
148
+
149
+ Do not upgrade unverified claims: evidence beats assumption. Keep unverified artifacts at `Not Produced` (downgrade-only, never upgrade) and flag all unverified claims before routing.
150
+
151
+ ### Runtime-ready mode
152
+
153
+ Route to `runtime-readiness` before any scene planning or mutation-dependent workflow stage when the inventory shows `Runtime status: Not Run` and the user wants runtime changes.
154
+
155
+ ### Blocked runtime mode
156
+
157
+ Do not route forward to planning or execution skills. Exit immediately to `pre-handoff-verification` (or route strictly to `bridge-conflicts` when the block is an active MCP bridge conflict on port 9876).
158
+
159
+ ## Validation checklist
160
+
161
+ - [ ] Stage named
162
+ - [ ] Single immediate next skill selected from locked precedence (no local cross-skill precedence re-decision)
163
+ - [ ] Multi-skill clashes without locked order escalated to precedence owner
164
+ - [ ] Any failed gate or blocked mode exits to `pre-handoff-verification` (never forward)
165
+ - [ ] Preconditions listed (`evidence beats assumption; geometry lock before look-dev; export waits for validation`)
166
+ - [ ] Truth states preserved as downgrade-only with artifacts defaulting to `Not Produced`
167
+
168
+ ## Pass / Warn / Fail rubric
169
+
170
+ | Verdict | Criteria |
171
+ |---|---|
172
+ | Pass | Single next skill selected from locked precedence order with clear preconditions and downgrade-only truth states |
173
+ | Warn | Multi-skill clash has no locked precedence order — escalated to precedence owner instead of guessing locally |
174
+ | Fail | Failed gate, blocked mode, or evidence contradiction encountered — mandatory immediate exit to `pre-handoff-verification` (never forward) |
175
+
176
+ ## Failure handling
177
+
178
+ - On any failed validation gate, blocked runtime mode (other than a port `9876` bridge collision routed to `../bridge-conflicts/SKILL.md`), or contradicted evidence claim, exit immediately to `../pre-handoff-verification/SKILL.md` — never route forward to downstream planning or export skills.
179
+ - If two candidate skills clash and no locked precedence rule resolves them, stop and escalate to the precedence owner instead of inventing local tie-breaking rules.
180
+ - If the user attempts to expand deliverables mid-stream, pause stage progression and route to `../scope-guard/SKILL.md`.
181
+ - Preserve downgrade-only truth states (`Artifact status` defaults to `Not Produced`; never upgrade states during routing).
182
+
183
+ ## Troubleshooting
184
+
185
+ | Symptom | Cause | Safe resolution |
186
+ |---|---|---|
187
+ | Agent tries to load camera, lighting, material, and quality skills all at once | Skill-choice fan-out without milestone gating | Enforce `references/routing-decision-tree.md`: pick **one** immediate next skill from the locked precedence order and list any others only as future milestones. |
188
+ | User wants to export GLB before `scene-readiness` or `polycount-budget-checker` has run | Violates `export waits for validation` | Route to the required validator skill first and list validation pass as a precondition for export/handoff. |
189
+ | User asks "what's next?" when no recipe or brief exists yet | Request arrived at Rank 4 router before Ranks 1–3 completed | Delegate back to `../blendops-help/SKILL.md`, `../recipe-fit-assessor/SKILL.md`, or `../pack-prerequisite-checker/SKILL.md` per `When not to use`. |
190
+
191
+ ## Best practices
192
+
193
+ - Always enforce the three locked ordering invariants in every stage handoff: **evidence beats assumption**, **geometry lock before look-dev**, and **export waits for validation**.
194
+ - Recommend **exactly one** immediate next skill and list 2–3 concrete preconditions before opening that skill (`references/stage-handoff-template.md`).
195
+ - Keep `Runtime status` and `Artifact status` explicit and downgrade-only on every routing response.
196
+ - Exit to `../pre-handoff-verification/SKILL.md` immediately whenever a gate fails rather than trying to "route around" the failure.
197
+
198
+ ## Good examples
199
+
200
+ - "`Current stage: Planning (Look-dev boundary)`. Inventory: Brief locked, composition plan present, `Runtime status: Not Run`, `Artifact status: Not Produced`. `Primary next skill`: `../lighting-material-plan/SKILL.md`. Preconditions: (1) geometry/camera framing locked (`geometry lock before look-dev`); (2) target render engine noted; (3) runtime readiness checked via `../runtime-readiness/SKILL.md` if live Blender mutation is next."
201
+ - "`Current stage: Blocked gate`. `polycount-budget-checker` returned `Fail` (180k triangles vs 50k mobile budget). Forward routing halted (`export waits for validation`). `Primary next skill`: `../pre-handoff-verification/SKILL.md`. `Runtime status: Not Run`. `Artifact status: Not Produced`."
202
+
203
+ ## Bad examples
204
+
205
+ - "Next skills: run `lighting-material-plan`, `cycles-vs-eevee-decision`, `render-export-evidence`, and `glb-web-handoff` in parallel." — causes multi-skill fan-out and skips validation gates.
206
+ - "Your quality check failed, so let's skip ahead to `plain-language-response` and mark `Artifact status: Verified`." — routes forward on a failed gate and fabricates `Verified` status.
207
+ - "I executed `execute_blender_code` to check your scene objects and advance the stage." — violates the routing-only boundary (`laws/no-arbitrary-python-interface.md`).
208
+
209
+ ## User-facing response template
210
+
211
+ ```txt
212
+ Current stage: <Intent | Fit & prerequisites | Planning | Quality planning | Execution prep | Evidence | Handoff>
213
+ Inventory snapshot:
214
+ - Brief: <present / absent>
215
+ - Plans & checks: <completed planning or validation outputs>
216
+ - Runtime status: <Not Run | Attempted | Produced | Verified | Failed>
217
+ - Artifact status: <Not Produced | Produced | Verified | Failed>
218
+
219
+ Primary next skill: <single catalog skill path>
220
+ Why this skill: <1–2 sentences anchored in locked precedence: evidence beats assumption / geometry lock before look-dev / export waits for validation>
221
+ Preconditions before advancing:
222
+ 1. <precondition 1>
223
+ 2. <precondition 2>
224
+ Stop conditions: <when to return to workflow-stage-router or exit to pre-handoff-verification>
225
+ Evidence used: <artifact inventory and stage records>
226
+ Limitations: <unverified state or pending checks>
227
+ ```
228
+
229
+ ## Anti-patterns
230
+
231
+ - Routing forward after a failed quality gate or blocked runtime state instead of exiting immediately to `../pre-handoff-verification/SKILL.md`.
232
+ - Re-inventing cross-skill precedence locally when multiple skills clash without a locked order, instead of escalating to the precedence owner.
233
+ - Upgrading unverified user claims to `Produced` or `Verified` (violating **evidence beats assumption**), or writing `Artifact status: Not Run` instead of `Artifact status: Not Produced`.
234
+ - Routing to look-dev (`lighting-material-plan`) before scene/geometry planning is locked, or routing to export/handoff before validation passes.
235
+ - Invoking Blender, generating Python (`execute_blender_code`), or duplicating `blendops-help` / `recipe-fit-assessor` / `pack-prerequisite-checker` entry gates.
236
+
237
+ ## Cross-skill handoff
238
+ <!-- blendops:generated:start handoffs -->
239
+ - [upstream_reference] Pack entry preflight gate → `../pack-prerequisite-checker/SKILL.md`
240
+ - [conditional] Runtime readiness check → `../runtime-readiness/SKILL.md`
241
+ - [fallback] Active MCP bridge conflict on port 9876 → `../bridge-conflicts/SKILL.md`
242
+ - [boundary_delegation] Mid-workflow scope expansion or unapproved deliverable addition → `../scope-guard/SKILL.md`
243
+ - [progression] Evidence updates for render or export outputs → `../render-export-evidence/SKILL.md`
244
+ - [fallback] Failed gate / blocked mode exit / final gate → `../pre-handoff-verification/SKILL.md`
245
+ <!-- blendops:generated:end handoffs -->
246
+
247
+ ## Non-goals
248
+
249
+ - Initial entry triage when the user's goal is unclear (use `../blendops-help/SKILL.md`).
250
+ - Selecting a recipe/pack (`../recipe-fit-assessor/SKILL.md`) or running initial pack preflight (`../pack-prerequisite-checker/SKILL.md`).
251
+ - Executing domain scene planning, running Blender or Python, or verifying artifact files directly.
252
+ - Writing final stakeholder-facing delivery copy (use `../plain-language-response/SKILL.md` after verification).
253
+
254
+ ## References
255
+
256
+ - `references/milestone-model.md`
257
+ - `references/routing-decision-tree.md`
258
+ - `references/stage-handoff-template.md`
259
+ - `../../docs/workflows/full-non-blender-user-workflow.md`
@@ -0,0 +1,150 @@
1
+ {
2
+ "$schema": "../../schemas/skill-contract.schema.json",
3
+ "id": "workflow-stage-router",
4
+ "version": "1.0.0",
5
+ "category": "routing-and-governance",
6
+ "role": "mid-workflow-stage-router",
7
+ "purpose": "Given current artifacts and intent, name the next BlendOps skill or workflow stage and preconditions to advance.",
8
+ "capabilityTier": "L0",
9
+ "routingPrecedence": {
10
+ "group": "entry-and-stage-routing",
11
+ "rank": 4,
12
+ "activationGate": {
13
+ "goalClarity": "clear",
14
+ "recipeSelected": true,
15
+ "preflightPassed": true,
16
+ "hasStageOrArtifactInventory": true
17
+ }
18
+ },
19
+ "triggers": [
20
+ "where are we in the workflow",
21
+ "what's next",
22
+ "resume from here",
23
+ "next skill"
24
+ ],
25
+ "exclusions": [
26
+ {
27
+ "condition": "Initial goal is vague or entry point is unknown",
28
+ "delegateTo": "blendops-help",
29
+ "reason": "Triages ambiguous entry requests at precedence Rank 1"
30
+ },
31
+ {
32
+ "condition": "Goal is clear but no recipe or pack has been chosen yet",
33
+ "delegateTo": "recipe-fit-assessor",
34
+ "reason": "Selects the fitting recipe/pack at precedence Rank 2"
35
+ },
36
+ {
37
+ "condition": "Pack is selected and brief exists, but pack preflight has not completed yet",
38
+ "delegateTo": "pack-prerequisite-checker",
39
+ "reason": "Executes preflight readiness verification at precedence Rank 3 before stage routing"
40
+ },
41
+ {
42
+ "condition": "Active MCP runtime bridge conflict on port 9876",
43
+ "delegateTo": "bridge-conflicts",
44
+ "reason": "Resolves port and dual add-on conflicts before advancing"
45
+ },
46
+ {
47
+ "condition": "Final stakeholder-facing wording and plain-language summary",
48
+ "delegateTo": "plain-language-response",
49
+ "reason": "Formats validated workflow outputs for non-Blender users"
50
+ }
51
+ ],
52
+ "inputs": {
53
+ "required": [
54
+ {
55
+ "name": "current_artifact_inventory",
56
+ "type": "artifact_inventory",
57
+ "description": "Determines current milestone stage and downgrade-only truth labels"
58
+ },
59
+ {
60
+ "name": "active_intent",
61
+ "type": "string",
62
+ "description": "Prevents routing to the wrong domain branch"
63
+ }
64
+ ],
65
+ "optional": [
66
+ {
67
+ "name": "target_pack_or_recipe",
68
+ "type": "string",
69
+ "description": "Narrows milestone track"
70
+ }
71
+ ]
72
+ },
73
+ "outputs": {
74
+ "primary": [
75
+ "current_stage_name",
76
+ "single_immediate_next_skill",
77
+ "preconditions_checklist"
78
+ ],
79
+ "truthStatePolicy": {
80
+ "runtimeDefault": "Not Run",
81
+ "artifactDefault": "Not Produced",
82
+ "mutationRule": "downgrade_only"
83
+ }
84
+ },
85
+ "handoffs": [
86
+ {
87
+ "target": "pack-prerequisite-checker",
88
+ "type": "upstream_reference",
89
+ "label": "Pack entry preflight gate",
90
+ "when": {
91
+ "all": [
92
+ { "field": "preflight.passed", "operator": "equals", "value": false }
93
+ ]
94
+ }
95
+ },
96
+ {
97
+ "target": "runtime-readiness",
98
+ "type": "conditional",
99
+ "label": "Runtime readiness check",
100
+ "when": {
101
+ "all": [
102
+ { "field": "runtime.status", "operator": "equals", "value": "Not Run" },
103
+ { "field": "stage.requiresRuntime", "operator": "equals", "value": true }
104
+ ]
105
+ }
106
+ },
107
+ {
108
+ "target": "bridge-conflicts",
109
+ "type": "fallback",
110
+ "label": "Active MCP bridge conflict on port 9876",
111
+ "when": {
112
+ "all": [
113
+ { "field": "runtime.conflictDetected", "operator": "equals", "value": true }
114
+ ]
115
+ }
116
+ },
117
+ {
118
+ "target": "scope-guard",
119
+ "type": "boundary_delegation",
120
+ "label": "Mid-workflow scope expansion or unapproved deliverable addition",
121
+ "when": {
122
+ "all": [
123
+ { "field": "scope.driftDetected", "operator": "equals", "value": true }
124
+ ]
125
+ }
126
+ },
127
+ {
128
+ "target": "render-export-evidence",
129
+ "type": "progression",
130
+ "label": "Evidence updates for render or export outputs",
131
+ "when": {
132
+ "all": [
133
+ { "field": "stage.current", "operator": "equals", "value": "post_execution_audit" }
134
+ ]
135
+ }
136
+ },
137
+ {
138
+ "target": "pre-handoff-verification",
139
+ "type": "fallback",
140
+ "label": "Failed gate / blocked mode exit / final gate",
141
+ "when": {
142
+ "any": [
143
+ { "field": "gate.status", "operator": "equals", "value": "failed" },
144
+ { "field": "runtime.mode", "operator": "equals", "value": "blocked" },
145
+ { "field": "stage.current", "operator": "equals", "value": "final_verification" }
146
+ ]
147
+ }
148
+ }
149
+ ]
150
+ }
@@ -0,0 +1,20 @@
1
+ # Milestone Model (7 Canonical Stages)
2
+
3
+ Stages describe the logical workflow state of a 3D project — not Git branches or rigid linear files. Always map observed project inventory to the earliest incomplete milestone before recommending the next skill.
4
+
5
+ | Stage | Core Goal | Required Inventory Before Leaving Stage | Canonical Skills in Stage |
6
+ |---|---|---|---|
7
+ | **1. Intent & Discovery** | Clarify user goal, audience, and target deliverables in plain language | Confirmed user goal + rough output type (`still` / `video` / `.glb`) | `blendops-help`, `blender-brainstorming`, `intent-to-3d-brief-writer` |
8
+ | **2. Fit, Scope & Prerequisites** | Match to existing recipe/pack, lock single primary deliverable, verify licenses & runtime posture | 8-slot brief, recipe fit verdict, clear `asset-license-checker`, pack `GO` verdict | `recipe-fit-assessor`, `scope-guard`, `pack-prerequisite-checker`, `asset-discovery`, `asset-license-checker`, `runtime-path-picker` |
9
+ | **3. Scene & Lookdev Planning** | Lock footprint, camera preset, lighting ratio, PBR material tiers, color & render decisions | Complete Scene Plan (`Z = 0`, focal length, light ratios, material tier, `AgX`/`PBR Neutral`) | `product-hero-scene-planner`, `camera-composition`, `lighting-material-plan`, `color-management-decision`, `output-format-decision`, `resolution-aspect-decision`, `cycles-vs-eevee-decision` |
10
+ | **4. Quality & Budget Planning** | Set measurable acceptance gates (`P0/P1/P2`), polycount/texture limits, and stop rules | Acceptance checklist + `mobile-glb-budget` / `polycount-budget-checker` thresholds | `acceptance-criteria-builder`, `done-criteria`, `stage-gates`, `polycount-budget-checker`, `mobile-glb-budget` |
11
+ | **5. Execution Prep & Runtime** | Verify single-bridge MCP or CLI readiness and execute build/render/export upstream | Observed Blender version, active single bridge (`Path 1`/`Path 2`/`CLI`), `.blend` backup | `runtime-setup`, `runtime-readiness`, `bridge-conflicts`, `path-one-host-outline`, `cli-appendix-job-outline`, `blender-troubleshooting` |
12
+ | **6. Evidence & Inspection** | Record raw observed command outputs, renders, `.glb` inspection, and failures honestly | Verified file paths, byte sizes, `gltf-validator` / preview inspection records | `render-export-evidence`, `runtime-attempt-report`, `preview-report`, `scene-readiness`, `material-quality-checker`, `lighting-quality-checker`, `composition-quality-checker` |
13
+ | **7. Handoff & Plain Summary** | Package verified web 3D deliverables + stakeholder summary with honest caveats | `pre-handoff-verification` 7-point pass + plain-language report | `glb-web-handoff`, `r3f-component-plan`, `pre-handoff-verification`, `plain-language-response` |
14
+
15
+ ## Inventory Routing Hints
16
+ - Brief missing or vague -> hold at **Stage 1** (`intent-to-3d-brief-writer`).
17
+ - Plans complete, zero `.blend`/render/`.glb` files on disk -> you are at **Stage 4 -> Stage 5** (`Runtime status: Not Run`, `Artifact status: Not Produced`). Never jump straight to **Stage 7** claiming `Ready`.
18
+
19
+ ## Related skill
20
+ [../SKILL.md](../SKILL.md)
@@ -0,0 +1,32 @@
1
+ # Routing decision tree
2
+
3
+ ```txt
4
+ No structured brief?
5
+ → intent-to-3d-brief-writer (or blender-brainstorming if goal fuzzy)
6
+
7
+ Brief exists but recipe/pack unclear?
8
+ → recipe-fit-assessor
9
+
10
+ Pack chosen but prerequisites unchecked?
11
+ → pack-prerequisite-checker
12
+
13
+ Need explicit Path 1 vs Path 2 vs CLI?
14
+ → runtime-path-picker
15
+
16
+ Bridge / port confusion?
17
+ → bridge-conflicts
18
+
19
+ Planning outputs missing for user's ask?
20
+ → narrow planner (product hero / domain planner)
21
+
22
+ Validators requested before runtime?
23
+ → relevant quality checker (material / lighting / composition / polycount)
24
+
25
+ Artifacts claimed without proof?
26
+ → render-export-evidence + downgrade claims
27
+
28
+ Ready to ship words to non-Blender stakeholder?
29
+ → plain-language-response (+ pre-handoff-verification if "ready" stated)
30
+ ```
31
+
32
+ Prefer **one** primary recommendation; list alternates only when user must choose tradeoffs.
@@ -0,0 +1,37 @@
1
+ # Stage Handoff Template
2
+
3
+ Use this compact routing card at the end of `workflow-stage-router` so any AI agent or user knows the exact active milestone, observed truth state, preconditions, and single next skill to invoke.
4
+
5
+ ```txt
6
+ Current milestone: <Stage 1..7 name, e.g. Stage 3: Scene & Lookdev Planning>
7
+
8
+ Observed inventory snapshot:
9
+ - Brief (8-slot): <present (path) | partial (missing slots) | absent>
10
+ - Scene / camera / lighting plans: <present | partial | absent>
11
+ - Acceptance / budget gates: <present | absent>
12
+ - Runtime setup / readiness: <verified (Path 1/2/CLI) | blocked | Not Run>
13
+ - Output artifacts (.blend / PNG / .glb): <Produced/Verified paths | Not Produced>
14
+
15
+ Primary next skill: <exact single skill slug, e.g. lighting-material-plan>
16
+ Why this skill now: <1-2 plain-language sentences tying current inventory gap to the next milestone>
17
+
18
+ Preconditions before running next skill:
19
+ 1. <e.g. Confirm whether web .glb export is required alongside still PNG>
20
+ 2. <e.g. Lock primary product dimensions and floor height Z = 0>
21
+
22
+ Optional parallel skills (only if user explicitly requests batching):
23
+ - <slug> (caution: confirm no conflicting budget edits against primary path)
24
+
25
+ Stop condition (when to return to workflow-stage-router):
26
+ - <e.g. Return after material portability tier and view transform are recorded, or immediately if scope conflicts emerge>
27
+
28
+ Truth reminder:
29
+ Runtime status: <Not Run | Attempted | Produced | Verified | Failed>
30
+ Artifact status: <Not Produced | Produced | Verified | Failed>
31
+ ```
32
+
33
+ ## Routing Discipline
34
+ - Recommend **one primary next skill** by default; keep optional parallel skills explicitly gated so beginners are never overwhelmed.
35
+
36
+ ## Related skill
37
+ [../SKILL.md](../SKILL.md)
package/skills.sh.json ADDED
@@ -0,0 +1,102 @@
1
+ {
2
+ "$schema": "https://skills.sh/schemas/skills.sh.schema.json",
3
+ "notGrouped": "bottom",
4
+ "groupings": [
5
+ {
6
+ "title": "Workflow & Intake",
7
+ "description": "Guided intake, brainstorming, 3D briefs, stage routing, scope guards, acceptance gates, and plain-language reporting for non-Blender users.",
8
+ "skills": [
9
+ "blendops-help",
10
+ "blender-brainstorming",
11
+ "intent-to-3d-brief-writer",
12
+ "workflow-stage-router",
13
+ "stage-gates",
14
+ "scope-guard",
15
+ "done-criteria",
16
+ "acceptance-criteria-builder",
17
+ "plain-language-response"
18
+ ]
19
+ },
20
+ {
21
+ "title": "Scene Planning",
22
+ "description": "Domain scene planners, recipe decomposition, fit assessment, and pack prerequisite checks before touching Blender.",
23
+ "skills": [
24
+ "product-hero-scene-planner",
25
+ "product-grid-scene-planner",
26
+ "character-portrait",
27
+ "environment-shot",
28
+ "interior-scene",
29
+ "blender-recipe-decomposer",
30
+ "recipe-fit-assessor",
31
+ "pack-prerequisite-checker"
32
+ ]
33
+ },
34
+ {
35
+ "title": "Camera, Lighting & Materials",
36
+ "description": "Camera framing, lighting rigs, PBR material planning, AgX/Filmic color management, and quality validators.",
37
+ "skills": [
38
+ "camera-composition",
39
+ "lighting-material-plan",
40
+ "composition-quality-checker",
41
+ "lighting-quality-checker",
42
+ "material-quality-checker",
43
+ "color-management-decision"
44
+ ]
45
+ },
46
+ {
47
+ "title": "Assets & Budgets",
48
+ "description": "3D asset discovery, license verification, style consistency, fallback strategies, library planning, and polycount/GLB budgets.",
49
+ "skills": [
50
+ "asset-discovery",
51
+ "asset-license-checker",
52
+ "asset-style-check",
53
+ "asset-fallback-strategy",
54
+ "asset-library-plan",
55
+ "polycount-budget-checker",
56
+ "mobile-glb-budget"
57
+ ]
58
+ },
59
+ {
60
+ "title": "Render & Output",
61
+ "description": "Cycles vs EEVEE engine selection, resolution and aspect ratio decisions, output format selection, preview reports, and export evidence.",
62
+ "skills": [
63
+ "cycles-vs-eevee-decision",
64
+ "resolution-aspect-decision",
65
+ "output-format-decision",
66
+ "preview-report",
67
+ "render-export-evidence"
68
+ ]
69
+ },
70
+ {
71
+ "title": "Scene Verification",
72
+ "description": "Pre-render scene readiness checks, pre-handoff verification gates, and deterministic Blender troubleshooting.",
73
+ "skills": [
74
+ "scene-readiness",
75
+ "pre-handoff-verification",
76
+ "blender-troubleshooting"
77
+ ]
78
+ },
79
+ {
80
+ "title": "Web 3D & GLB",
81
+ "description": "Production GLB web handoff, skeletal/keyframe animation handoff, and React Three Fiber (R3F) component planning.",
82
+ "skills": [
83
+ "glb-web-handoff",
84
+ "glb-animation-handoff",
85
+ "r3f-component-plan"
86
+ ]
87
+ },
88
+ {
89
+ "title": "Runtime & MCP",
90
+ "description": "2-path Blender MCP runtime setup, readiness checks, Path 1/Path 2/CLI selection, bridge conflict detection, and truth-state attempt reports.",
91
+ "skills": [
92
+ "runtime-setup",
93
+ "runtime-readiness",
94
+ "runtime-path-picker",
95
+ "path-one-host-outline",
96
+ "cli-appendix-job-outline",
97
+ "bridge-conflicts",
98
+ "runtime-attempt-report"
99
+ ]
100
+ }
101
+ ]
102
+ }