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,229 @@
1
+ {
2
+ "$schema": "../../schemas/skill-contract.schema.json",
3
+ "id": "blendops-help",
4
+ "version": "1.0.0",
5
+ "category": "routing-and-governance",
6
+ "role": "ambiguous-intent-entry-router",
7
+ "purpose": "Route users to the right BlendOps skill, document, or next safe action without overclaiming runtime, artifact, or package readiness.",
8
+ "capabilityTier": "L0",
9
+ "routingPrecedence": {
10
+ "group": "entry-and-stage-routing",
11
+ "rank": 1,
12
+ "activationGate": {
13
+ "goalClarity": "ambiguous_or_mixed",
14
+ "recipeSelected": false,
15
+ "preflightPassed": false,
16
+ "hasStageOrArtifactInventory": false
17
+ }
18
+ },
19
+ "triggers": [
20
+ "What should I do next?",
21
+ "Which BlendOps skill should I use?",
22
+ "Is this ready?",
23
+ "Can I run the runtime eval?",
24
+ "How do I package/install BlendOps?",
25
+ "What is blocked?"
26
+ ],
27
+ "exclusions": [
28
+ {
29
+ "condition": "The goal is clear, preflight is passed, and stage or artifact inventory already exists",
30
+ "delegateTo": "workflow-stage-router",
31
+ "reason": "Selects the single immediate next skill from a locked precedence order and exits to pre-handoff-verification on any failed gate"
32
+ },
33
+ {
34
+ "condition": "The goal is clear and the user wants to select the right recipe or pack",
35
+ "delegateTo": "recipe-fit-assessor",
36
+ "reason": "Scores candidate recipes/packs and detects multi-deliverable scope"
37
+ },
38
+ {
39
+ "condition": "A recipe or pack is already selected and needs preflight readiness verification",
40
+ "delegateTo": "pack-prerequisite-checker",
41
+ "reason": "Evaluates the preflight matrix across brief completeness, runtime posture, and asset readiness"
42
+ },
43
+ {
44
+ "condition": "The user explicitly asks to turn an idea into a structured 3D brief",
45
+ "delegateTo": "intent-to-3d-brief-writer",
46
+ "reason": "Locks the canonical 8-slot 3D brief before scene planning"
47
+ },
48
+ {
49
+ "condition": "The user asks to plan a product-hero scene directly",
50
+ "delegateTo": "product-hero-scene-planner",
51
+ "reason": "Handles domain-specific scene planning once brief and recipe are known"
52
+ },
53
+ {
54
+ "condition": "The user asks for render or export artifact verification",
55
+ "delegateTo": "render-export-evidence",
56
+ "reason": "Classifies artifact truth states from on-disk paths and validation notes"
57
+ },
58
+ {
59
+ "condition": "The user asks for Blender MCP runtime preflight verification",
60
+ "delegateTo": "runtime-readiness",
61
+ "reason": "Verifies Path 1 or Path 2 runtime readiness without claiming execution"
62
+ }
63
+ ],
64
+ "inputs": {
65
+ "required": [
66
+ {
67
+ "name": "user_request",
68
+ "type": "string",
69
+ "description": "Ambiguous, mixed, or entry-level user question about BlendOps capabilities or next action"
70
+ }
71
+ ],
72
+ "optional": [
73
+ {
74
+ "name": "current_status_context",
75
+ "type": "object",
76
+ "description": "Optional context about known files, docs, or blockers"
77
+ }
78
+ ]
79
+ },
80
+ "outputs": {
81
+ "primary": [
82
+ "recommended_next_action",
83
+ "target_skill_or_doc",
84
+ "why_this_is_safe"
85
+ ],
86
+ "truthStatePolicy": {
87
+ "runtimeDefault": "Not Run",
88
+ "artifactDefault": "Not Produced",
89
+ "mutationRule": "downgrade_only"
90
+ }
91
+ },
92
+ "handoffs": [
93
+ {
94
+ "target": "recipe-fit-assessor",
95
+ "type": "progression",
96
+ "label": "Recipe or pack selection when goal becomes clear",
97
+ "when": {
98
+ "all": [
99
+ { "field": "goal.clarity", "operator": "equals", "value": "clear" },
100
+ { "field": "recipe.selected", "operator": "equals", "value": false }
101
+ ]
102
+ }
103
+ },
104
+ {
105
+ "target": "pack-prerequisite-checker",
106
+ "type": "conditional",
107
+ "label": "Pack preflight readiness check when recipe is already chosen",
108
+ "when": {
109
+ "all": [
110
+ { "field": "recipe.selected", "operator": "equals", "value": true },
111
+ { "field": "preflight.passed", "operator": "equals", "value": false }
112
+ ]
113
+ }
114
+ },
115
+ {
116
+ "target": "workflow-stage-router",
117
+ "type": "conditional",
118
+ "label": "In-flight workflow routing (clear goal + existing artifacts)",
119
+ "when": {
120
+ "all": [
121
+ { "field": "goal.clarity", "operator": "equals", "value": "clear" },
122
+ { "field": "preflight.passed", "operator": "equals", "value": true },
123
+ { "field": "inventory.exists", "operator": "equals", "value": true }
124
+ ]
125
+ }
126
+ },
127
+ {
128
+ "target": "intent-to-3d-brief-writer",
129
+ "type": "progression",
130
+ "label": "Initial 3D brief creation",
131
+ "when": {
132
+ "all": [
133
+ { "field": "brief.locked", "operator": "equals", "value": false }
134
+ ]
135
+ }
136
+ },
137
+ {
138
+ "target": "runtime-path-picker",
139
+ "type": "conditional",
140
+ "label": "Runtime path selection",
141
+ "when": {
142
+ "all": [
143
+ { "field": "request.topic", "operator": "equals", "value": "runtime_selection" }
144
+ ]
145
+ }
146
+ },
147
+ {
148
+ "target": "runtime-setup",
149
+ "type": "conditional",
150
+ "label": "Official runtime setup",
151
+ "when": {
152
+ "all": [
153
+ { "field": "request.topic", "operator": "equals", "value": "runtime_setup" }
154
+ ]
155
+ }
156
+ },
157
+ {
158
+ "target": "runtime-readiness",
159
+ "type": "conditional",
160
+ "label": "Runtime readiness preflight",
161
+ "when": {
162
+ "all": [
163
+ { "field": "request.topic", "operator": "equals", "value": "runtime_readiness" }
164
+ ]
165
+ }
166
+ },
167
+ {
168
+ "target": "bridge-conflicts",
169
+ "type": "fallback",
170
+ "label": "MCP bridge port/session conflict",
171
+ "when": {
172
+ "all": [
173
+ { "field": "runtime.conflictDetected", "operator": "equals", "value": true }
174
+ ]
175
+ }
176
+ },
177
+ {
178
+ "target": "product-hero-scene-planner",
179
+ "type": "alternative",
180
+ "label": "Scene planning",
181
+ "when": {
182
+ "all": [
183
+ { "field": "brief.locked", "operator": "equals", "value": true },
184
+ { "field": "recipe.id", "operator": "equals", "value": "product-hero-v0" }
185
+ ]
186
+ }
187
+ },
188
+ {
189
+ "target": "render-export-evidence",
190
+ "type": "conditional",
191
+ "label": "Render/export evidence",
192
+ "when": {
193
+ "all": [
194
+ { "field": "request.topic", "operator": "equals", "value": "artifact_evidence" }
195
+ ]
196
+ }
197
+ },
198
+ {
199
+ "target": "pre-handoff-verification",
200
+ "type": "fallback",
201
+ "label": "Failed workflow gate / pre-handoff check",
202
+ "when": {
203
+ "all": [
204
+ { "field": "gate.status", "operator": "equals", "value": "failed" }
205
+ ]
206
+ }
207
+ },
208
+ {
209
+ "target": "glb-web-handoff",
210
+ "type": "conditional",
211
+ "label": "GLB handoff",
212
+ "when": {
213
+ "all": [
214
+ { "field": "request.topic", "operator": "equals", "value": "glb_handoff" }
215
+ ]
216
+ }
217
+ },
218
+ {
219
+ "target": "plain-language-response",
220
+ "type": "progression",
221
+ "label": "Final response",
222
+ "when": {
223
+ "all": [
224
+ { "field": "stage.current", "operator": "equals", "value": "final_communication" }
225
+ ]
226
+ }
227
+ }
228
+ ]
229
+ }
@@ -0,0 +1,91 @@
1
+ # Lifecycle Phases
2
+
3
+ A complete BlendOps run for a non-Blender user passes through 6 phases. Each phase loads a specific subset of the **48** skills (16 baseline + 32 expansion across Batches 1–8). Use `workflow-stage-router` whenever you need to interleave expansion skills with the baseline chain summarized below.
4
+
5
+ ## Phase A — Intent
6
+
7
+ Goal: convert the user's vague request into a confirmed structured brief.
8
+
9
+ | Skill | Role |
10
+ |---|---|
11
+ | `blender-brainstorming` | Socratic clarification when intent is vague (3-5 questions, 2-3 alternative scopings) |
12
+ | `intent-to-3d-brief-writer` | Lock confirmed intent into the 8-slot brief |
13
+
14
+ Exit gate: brief echoed and confirmed by user. Runtime status `Not Run`.
15
+
16
+ ## Phase B — Asset planning
17
+
18
+ Goal: decide where every asset comes from before scene plan.
19
+
20
+ | Skill | Role |
21
+ |---|---|
22
+ | `asset-discovery` | Per-asset strategy (procedural / library / generative / photogrammetry) + license + budget |
23
+
24
+ Exit gate: asset plan reconciled against brief constraints. Generative strategy flagged with Path 2 caveat if used.
25
+
26
+ ## Phase C — Runtime readiness
27
+
28
+ Goal: confirm operator can actually run Blender, OR explicitly stay in text-only mode.
29
+
30
+ | Skill | Role |
31
+ |---|---|
32
+ | `runtime-setup` | Choose runtime path (Path 1 host a/b, Path 2, CLI fallback) prerequisites |
33
+ | `runtime-readiness` | Build readiness matrix; verdict Ready / Partially Ready / Blocked / Unknown |
34
+ | `bridge-conflicts` | If readiness signals are inconsistent (Path 1 + Path 2 both installed, port collision, two MCP clients) |
35
+
36
+ Exit gate: ONE runtime path selected and ready, OR explicit "stay text-only" decision.
37
+
38
+ ## Phase D — Scene planning
39
+
40
+ Goal: produce the structured plan downstream skills can act on.
41
+
42
+ | Skill | Role |
43
+ |---|---|
44
+ | `product-hero-scene-planner` | Subject + scene structure |
45
+ | `camera-composition` | Framing + camera |
46
+ | `lighting-material-plan` | Mood / lookdev / portability |
47
+
48
+ Exit gate: plans reviewable in plain language; no jargon leaks.
49
+
50
+ ## Phase E — Quality + execution + evidence
51
+
52
+ Goal: gate runtime work, capture evidence honestly, downgrade unsupported claims.
53
+
54
+ | Skill | Role |
55
+ |---|---|
56
+ | `scene-readiness` | Pass/Warn/Fail readiness verdict before runtime mutation |
57
+ | `blender-troubleshooting` | When output diverges from intent (4-phase root-cause) |
58
+ | `render-export-evidence` | Classify artifact evidence (Not Run / Attempted / Produced / Verified / Failed) |
59
+ | `pre-handoff-verification` | 7-point gate before any "ready" / `Verified` claim leaves the workflow |
60
+
61
+ Exit gate: verified evidence record OR explicit downgrade with reasoning.
62
+
63
+ ## Phase F — Handoff + response
64
+
65
+ Goal: communicate status to the non-Blender user without jargon.
66
+
67
+ | Skill | Role |
68
+ |---|---|
69
+ | `glb-web-handoff` | If GLB / web is in scope, frame caveats + R3F / Three.js snippets |
70
+ | `plain-language-response` | Plain-language final response with truth labels visible |
71
+
72
+ Exit gate: response confirmed plain-language by check 7 of `pre-handoff-verification`.
73
+
74
+ ## Phases by truth label
75
+
76
+ | Phase | Default truth label after exit |
77
+ |---|---|
78
+ | A — Intent | `Not Run`, `Not Produced` |
79
+ | B — Asset planning | `Not Run`, `Not Produced` |
80
+ | C — Runtime readiness | `Not Run` (readiness ≠ run) |
81
+ | D — Scene planning | `Not Run`, `Not Produced` |
82
+ | E — Quality + evidence | Whatever the actual evidence supports (downgraded if needed) |
83
+ | F — Handoff | Whatever Phase E concluded; never upgraded by handoff |
84
+
85
+ ## Skipping phases
86
+
87
+ - A user with a structured request can skip Phase A.
88
+ - A user supplying all assets can skip Phase B.
89
+ - A text-only iteration loop can skip Phase C and stop after Phase D.
90
+ - A read-only smoke run stops after Phase C with a smoke evidence record.
91
+ - The full chain (A → F) is only needed for a "publish-ready" deliverable.
@@ -0,0 +1,65 @@
1
+ # Quick-Start Prompts
2
+
3
+ Copy-paste prompts the user can give an AI agent to load BlendOps skills correctly. Each is paired with the routing decision the agent should make.
4
+
5
+ ## Prompt 1 — "I want to make a 3D scene but I don't know what to do"
6
+
7
+ ```txt
8
+ I want to make a 3D scene of <subject> but I'm not sure exactly what.
9
+ Help me think it through with BlendOps before any planning.
10
+ ```
11
+
12
+ **Agent should load:** `blender-brainstorming` first. After confirmed intent, route to `intent-to-3d-brief-writer`.
13
+
14
+ ## Prompt 2 — "I have a clear request, plan it"
15
+
16
+ ```txt
17
+ Plan a BlendOps scene for: <one-paragraph clear request including subject + mood + deliverable + audience>.
18
+ Lock the brief first, then route to the planners.
19
+ ```
20
+
21
+ **Agent should load:** `intent-to-3d-brief-writer` first (skip brainstorming because the request is structured). Then planners.
22
+
23
+ ## Prompt 3 — "Check if my Blender setup is ready before I run it"
24
+
25
+ ```txt
26
+ Check BlendOps runtime readiness for my setup. I'm using <Path 1 host (a/b) / Path 2 / CLI fallback>.
27
+ Don't run Blender; just report readiness.
28
+ ```
29
+
30
+ **Agent should load:** `runtime-readiness`. If signals inconsistent, escalate to `bridge-conflicts`.
31
+
32
+ ## Prompt 4 — "My render came out wrong, debug it"
33
+
34
+ ```txt
35
+ My render output doesn't match what I asked for.
36
+ Run BlendOps `blender-troubleshooting` 4-phase diagnostic.
37
+ Don't propose fixes until Phase 1 reproduction is locked.
38
+ ```
39
+
40
+ **Agent should load:** `blender-troubleshooting`. After Phase 4, route to the skill at the divergence point.
41
+
42
+ ## Prompt 5 — "I think we're ready to ship; verify before handoff"
43
+
44
+ ```txt
45
+ I'm about to send <deliverable> to <audience>.
46
+ Run BlendOps `pre-handoff-verification` 7-point gate before I claim it's ready.
47
+ Downgrade the claim explicitly if any check fails.
48
+ ```
49
+
50
+ **Agent should load:** `pre-handoff-verification`. Only after Pass verdict, route to `plain-language-response`.
51
+
52
+ ## Prompt 6 — "Write the final response for stakeholders"
53
+
54
+ ```txt
55
+ Summarize the BlendOps run results for <audience> in plain language.
56
+ Keep it non-technical. Cite evidence labels (`Verified` / `Produced` / `Not Run` etc.).
57
+ ```
58
+
59
+ **Agent should load:** `plain-language-response`. If `pre-handoff-verification` did not run yet, route there first.
60
+
61
+ ## Anti-patterns
62
+
63
+ - Loading `product-hero-scene-planner` directly from a vague request without brainstorming. Will produce an under-specified plan.
64
+ - Loading `pre-handoff-verification` after the response is already sent. The gate must run BEFORE handoff.
65
+ - Skipping `blendops-help` when intent is unclear. The router exists for this reason.
@@ -0,0 +1,57 @@
1
+ # Routing Decision Tree
2
+
3
+ When the user's intent is unclear, walk this tree top-down. Stop at the first matching condition and load the named skill.
4
+
5
+ ```
6
+ 1. Is the user's request VAGUE or has multiple plausible interpretations?
7
+ YES → load `blender-brainstorming` (Socratic exploration first).
8
+ NO → continue to 2.
9
+
10
+ 2. Is intent confirmed but no STRUCTURED BRIEF exists yet?
11
+ YES → load `intent-to-3d-brief-writer` (8-slot brief).
12
+ NO → continue to 3.
13
+
14
+ 3. Are SCENE ASSETS not trivially given (e.g. "a shoe" without a model)?
15
+ YES → load `asset-discovery` (per-asset strategy).
16
+ NO → continue to 4.
17
+
18
+ 4. Does the user want to RUN BLENDER right now?
19
+ YES → load `runtime-readiness` first.
20
+ If readiness reports inconsistent signals → `bridge-conflicts`.
21
+ If readiness reports Blocked / Unknown → `runtime-setup`.
22
+ NO → continue to 5.
23
+
24
+ 5. Is the user asking for a SCENE / COMPOSITION / LIGHTING / MATERIAL plan?
25
+ Scene plan → `product-hero-scene-planner`
26
+ Composition → `camera-composition`
27
+ Lighting/material → `lighting-material-plan`
28
+ Quality gate → `scene-readiness`
29
+
30
+ 6. Has output ALREADY EXISTED but it looks WRONG?
31
+ YES → load `blender-troubleshooting` (4-phase root-cause).
32
+
33
+ 7. Is there a render / GLB / preview to CLASSIFY for evidence?
34
+ YES → load `render-export-evidence`.
35
+
36
+ 8. Is a DELIVERABLE about to be HANDED OFF as "ready"?
37
+ YES → load `pre-handoff-verification` (7-point gate). Never skip.
38
+
39
+ 9. Is the deliverable a GLB or web asset that needs HANDOFF FRAMING?
40
+ YES → load `glb-web-handoff` (caveats + R3F snippets).
41
+
42
+ 10. Does the user need a PLAIN-LANGUAGE SUMMARY for non-Blender stakeholders?
43
+ YES → load `plain-language-response` (final response).
44
+ ```
45
+
46
+ ## Multi-skill chains
47
+
48
+ Most real workflows chain 4-7 skills. Common chains:
49
+
50
+ | Chain | Skills in order |
51
+ |---|---|
52
+ | First-time user, vague request | `blender-brainstorming` → `intent-to-3d-brief-writer` → `asset-discovery` → planners → quality gate → evidence → verification → response |
53
+ | Iteration on existing scene | `blender-troubleshooting` → relevant planner → quality gate → evidence → verification → response |
54
+ | Pre-release verification | `pre-handoff-verification` → (downgrade if needed) → response |
55
+ | Runtime conflict triage | `runtime-readiness` → `bridge-conflicts` → readiness re-check |
56
+
57
+ See `docs/workflows/full-non-blender-user-workflow.md` for the full canonical chain.
@@ -0,0 +1,83 @@
1
+ # EVAL — bridge-conflicts
2
+
3
+ Status: 1.0.0 text-only baseline
4
+ Scope: diagnose single-bridge constraint conflicts and propose resolutions; no execution.
5
+
6
+ ## Text-only eval prompt
7
+
8
+ Use bridge-conflicts to build a bridge state matrix, identify the intended path, name residual bridges, and propose the cheapest resolution. Do not disable add-ons, edit configs, change ports, or run Blender from this skill.
9
+
10
+ ## Expected behavior
11
+
12
+ - builds a complete bridge state matrix (every MCP client + Blender-side add-ons)
13
+ - identifies the intended runtime path explicitly (from brief / readiness checker / user)
14
+ - names residual / unintended bridges with reasons
15
+ - checks for port collision (or marks unknown if no log access)
16
+ - proposes the cheapest resolution step + rationale
17
+ - includes explicit "do-not" reminders for the operator
18
+ - hands off to `runtime-readiness` for re-verification
19
+ - never executes the resolution
20
+
21
+ ## Eval cases
22
+
23
+ | Case | Input | Expected output | Required evidence |
24
+ |---|---|---|---|
25
+ | Path 1 + Path 2 both installed | Lab MCP add-on AND `mcp-for-blender` `addon.py` both enabled in Blender | Conflict diagnosis; cheapest fix = disable unintended; do-not reminder; handoff | matrix, intended path, fix, reminder, handoff |
26
+ | Two MCP clients pointing at same Blender | Claude Desktop Connector ON + Cursor with manual `uvx mcp-for-blender` | Conflict diagnosis; pick one client per session; unregister other from this Blender | matrix, single-client decision, fix |
27
+ | Port collision | Lab MCP server + community server both on `localhost:9876` | Diagnose port collision; change one server's port; update its client config | matrix, port reasoning, port change proposal |
28
+ | Anthropic Connector + manual mcpServers Lab MCP both ON | Claude Desktop has Connector toggle + manual `mcpServers.blender` Lab entry | Diagnose: both are Path 1 host options targeting same Lab stack; pick one host per session | matrix, host decision, do-not reminder |
29
+ | Matrix clean but smoke fails | Single intended path, single client, no port collision; smoke still fails | Route to `blender-troubleshooting` | clean matrix, route to troubleshooting |
30
+ | No log access for ports | Operator doesn't have netstat output | Mark port check `Unknown`; proceed with config-based diagnosis | unknown port marker, partial diagnosis |
31
+ | Operator wants both paths on different Blender instances | Two Blender processes, two ports | Explicit port isolation plan + separate processes; matrix verifies isolation | isolation plan, matrix verifies |
32
+
33
+ ## Expected evidence/status fields
34
+
35
+ | Field | Required content |
36
+ |---|---|
37
+ | Bridge state matrix | Per-client + per-Blender-add-on table |
38
+ | Intended path | Path 1 host a/b / Path 2 / CLI fallback / text-only |
39
+ | Residual bridges | Named with reason |
40
+ | Port collision | Pass / Fail / Unknown with note |
41
+ | Resolution proposal | Cheapest step + rationale |
42
+ | Do-not reminders | Explicit list |
43
+ | Handoff target | `runtime-readiness` (or `blender-troubleshooting` if matrix clean) |
44
+ | Runtime status | Unchanged by this skill |
45
+ | Artifact status | Unchanged by this skill |
46
+
47
+ ## Pass / Warn / Fail criteria
48
+
49
+ - Pass: matrix complete, intended path explicit, residual named with reason, port checked or marked unknown, resolution + rationale, do-not reminders, handoff named
50
+ - Warn: matrix partial with notes, OR intended path inferred without confirmation, OR resolution missing rationale
51
+ - Fail: no matrix, OR intended path not identified, OR claimed resolution executed by this skill, OR ignored port collision
52
+
53
+ ## Common failure modes
54
+
55
+ - proposing a fix without the matrix ("just try restarting")
56
+ - treating Anthropic Connector and manual MCP as separate paths (both are Path 1 host options)
57
+ - skipping port check
58
+ - claiming the fix worked from this skill (only readiness checker can verify)
59
+ - forgetting do-not reminders so operator re-enables the conflict next session
60
+
61
+ ## Evidence expectations
62
+
63
+ - markdown matrix visible
64
+ - intended path quoted
65
+ - conflict reasoning explicit per residual bridge
66
+ - resolution rationale text-explicit
67
+ - do-not reminder list
68
+ - handoff line
69
+
70
+ ## Sample passing response outline
71
+
72
+ - Bridge state matrix (markdown)
73
+ - Intended path: Path 1 host (a) Anthropic Connector
74
+ - Conflicts: Lab add-on + ahujasid `addon.py` both enabled; manual `mcpServers.blender` redundant
75
+ - Cheapest fix: disable ahujasid `addon.py`; remove manual entry; restart Claude Desktop
76
+ - Do-not: keep both Blender-side add-ons enabled simultaneously
77
+ - Handoff: `runtime-readiness`
78
+
79
+ ## Sample failing response outline
80
+
81
+ - "Just looks misconfigured, restart everything" (no matrix, no intended path, no rationale)
82
+ - Claimed "I disabled the addon" (this skill cannot execute)
83
+ - Skipped port check entirely