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,176 @@
1
+ {
2
+ "$schema": "../../schemas/skill-contract.schema.json",
3
+ "id": "runtime-attempt-report",
4
+ "version": "1.0.0",
5
+ "category": "runtime-and-execution",
6
+ "role": "execution-attempt-provenance-logger",
7
+ "purpose": "Produce an evidence-bound runtime attempt report with truth labels and next steps; does not certify upstream stack success.",
8
+ "capabilityTier": "L0",
9
+ "triggers": [
10
+ "write up what we tried",
11
+ "runtime attempt log",
12
+ "postmortem blender connect",
13
+ "evidence report template"
14
+ ],
15
+ "exclusions": [
16
+ {
17
+ "condition": "Classifying rendered or exported visual artifacts (render-export-evidence)",
18
+ "delegateTo": "render-export-evidence",
19
+ "reason": "render-export-evidence"
20
+ },
21
+ {
22
+ "condition": "Diagnosing systematic runtime or scene defects (blender-troubleshooting)",
23
+ "delegateTo": "blender-troubleshooting",
24
+ "reason": "blender-troubleshooting"
25
+ },
26
+ {
27
+ "condition": "Running pre-attempt environment checks (runtime-readiness)",
28
+ "delegateTo": "runtime-readiness",
29
+ "reason": "runtime-readiness"
30
+ },
31
+ {
32
+ "condition": "Selecting which runtime path to use before an attempt (runtime-path-picker)",
33
+ "delegateTo": "runtime-path-picker",
34
+ "reason": "runtime-path-picker"
35
+ },
36
+ {
37
+ "condition": "Performing final release or delivery gating (pre-handoff-verification)",
38
+ "delegateTo": "pre-handoff-verification",
39
+ "reason": "pre-handoff-verification"
40
+ }
41
+ ],
42
+ "inputs": {
43
+ "required": [
44
+ {
45
+ "name": "attempted_runtime_path_and_host",
46
+ "type": "object",
47
+ "description": "Path 1, Path 2, or CLI appendix route and MCP host configuration used during the attempt"
48
+ },
49
+ {
50
+ "name": "chronological_execution_log",
51
+ "type": "array",
52
+ "description": "Timestamped sequence of read-only or mutation tool calls, responses, and observed outcomes"
53
+ },
54
+ {
55
+ "name": "version_stamps",
56
+ "type": "object",
57
+ "description": "Exact Blender version, add-on version, and MCP client version strings"
58
+ }
59
+ ],
60
+ "optional": [
61
+ {
62
+ "name": "pre_mutation_backup_record",
63
+ "type": "object",
64
+ "description": "Optional .blend checkpoint backup metadata if an L1+ mutation was attempted"
65
+ }
66
+ ]
67
+ },
68
+ "outputs": {
69
+ "primary": [
70
+ "structured_runtime_attempt_report_md",
71
+ "locked_runtime_and_artifact_truth_labels",
72
+ "eval_evidence_archival_path"
73
+ ],
74
+ "truthStatePolicy": {
75
+ "runtimeDefault": "Not Run",
76
+ "artifactDefault": "Not Produced",
77
+ "mutationRule": "downgrade_only"
78
+ }
79
+ },
80
+ "handoffs": [
81
+ {
82
+ "target": "runtime-readiness",
83
+ "type": "upstream_reference",
84
+ "label": "Pre-attempt readiness check",
85
+ "when": {
86
+ "all": [
87
+ {
88
+ "field": "runtime.path",
89
+ "operator": "not_equals",
90
+ "value": "unselected"
91
+ },
92
+ {
93
+ "field": "runtime.verifiedReady",
94
+ "operator": "equals",
95
+ "value": false
96
+ }
97
+ ]
98
+ }
99
+ },
100
+ {
101
+ "target": "runtime-path-picker",
102
+ "type": "upstream_reference",
103
+ "label": "Runtime path selection context",
104
+ "when": {
105
+ "all": [
106
+ {
107
+ "field": "runtime.path",
108
+ "operator": "equals",
109
+ "value": "unselected"
110
+ }
111
+ ]
112
+ }
113
+ },
114
+ {
115
+ "target": "bridge-conflicts",
116
+ "type": "fallback",
117
+ "label": "Bridge / port / host conflicts",
118
+ "when": {
119
+ "all": [
120
+ {
121
+ "field": "runtime.conflictDetected",
122
+ "operator": "equals",
123
+ "value": true
124
+ }
125
+ ]
126
+ }
127
+ },
128
+ {
129
+ "target": "blender-troubleshooting",
130
+ "type": "fallback",
131
+ "label": "Runtime or scene defect diagnosis",
132
+ "when": {
133
+ "all": [
134
+ {
135
+ "field": "runtime.errorDetected",
136
+ "operator": "equals",
137
+ "value": true
138
+ }
139
+ ]
140
+ }
141
+ },
142
+ {
143
+ "target": "render-export-evidence",
144
+ "type": "progression",
145
+ "label": "Artifact evidence classification",
146
+ "when": {
147
+ "all": [
148
+ {
149
+ "field": "stage.current",
150
+ "operator": "equals",
151
+ "value": "post_execution_audit"
152
+ }
153
+ ]
154
+ }
155
+ },
156
+ {
157
+ "target": "pre-handoff-verification",
158
+ "type": "fallback",
159
+ "label": "Final handoff gate & failure exit",
160
+ "when": {
161
+ "any": [
162
+ {
163
+ "field": "gate.status",
164
+ "operator": "equals",
165
+ "value": "failed"
166
+ },
167
+ {
168
+ "field": "runtime.mode",
169
+ "operator": "equals",
170
+ "value": "blocked"
171
+ }
172
+ ]
173
+ }
174
+ }
175
+ ]
176
+ }
@@ -0,0 +1,49 @@
1
+ # Attempt record template
2
+
3
+ Use this template with `runtime-attempt-report` to record chronological, secret-free provenance for Path 1 (Lab MCP), Path 2 (`mcp-for-blender`), or CLI fallback runs. Save completed reports under `docs/evals/` and link them in `docs/evals/README.md`.
4
+
5
+ ```md
6
+ # <Path> Runtime Attempt Record — <Host or Runner> — YYYY-MM-DD
7
+
8
+ ## A. Summary
9
+ Path: Path 1 Lab MCP (Blender 5.1+) | Path 2 community mcp-for-blender (Blender 3.0+, non-release) | CLI fallback appendix
10
+ Host: <Claude Desktop (a) Connector | Claude Desktop (b) manual | Cursor | Codex | Headless shell>
11
+ Goal: <read-only smoke | scene mutation | render preview | GLB export | batch CLI>
12
+ Date/time (UTC): <YYYY-MM-DDTHH:MM:SSZ>
13
+ Operator: <name or handle>
14
+
15
+ ## B. Versions & config provenance
16
+ Blender (`blender --version`): <exact version string or unrecorded>
17
+ Add-on / bridge package: <Lab MCP add-on version (min 5.1.0) | mcp-for-blender version/commit | N/A>
18
+ MCP server / launcher: <`.mcpb` filename or commit | `uvx mcp-for-blender` version | `blender --background`>
19
+ MCP host / client version: <product + version>
20
+ Bridge listener port check (`localhost:9876`): <single active bridge confirmed | conflict noted | N/A>
21
+
22
+ ## C. Actions chronology (secrets & private paths redacted)
23
+ 1. <HH:MM:SSZ — exact read-only preflight or command attempted>
24
+ 2. <HH:MM:SSZ — MCP tool name or CLI command called with redacted workspace paths>
25
+ 3. <HH:MM:SSZ — observed completion, timeout, or termination point>
26
+
27
+ ## D. Signals observed
28
+ - Expected: <e.g., `get_blendfile_summary_path_info` returned scene name, or exit code 0>
29
+ - Unexpected: <e.g., connection refused on `localhost:9876`, add-on disabled, or `none`>
30
+ - Redacted log snippet: <short error/stdout excerpt with home paths, tokens, and env vars removed>
31
+
32
+ ## E. Truth labels (downgrade-only)
33
+ Runtime status: Not Run | Attempted | Produced | Verified | Failed
34
+ Artifact status: Not Produced | Produced | Verified | Failed
35
+ Evidence pointers: <redacted repo-relative or sanitized file paths, or `none`>
36
+
37
+ ## F. Limitations, redactions & next routing
38
+ Secrets removed: Yes (trusted sandbox hygiene verified; no API keys, bearer tokens, or private home paths)
39
+ Constraints / caveats:
40
+ - <If Path 1 host (a): Connector is not standalone; requires Lab MCP add-on in Blender 5.1+>
41
+ - <If Path 2: third-party maintainer stack (`mcp-for-blender`); never treated as official Anthropic/Blender release evidence>
42
+ - <If CLI appendix: batch/stateless execution record only>
43
+ Next routing: <render-export-evidence | blender-troubleshooting | bridge-conflicts | pre-handoff-verification>
44
+ ```
45
+
46
+ ## Redaction & downgrade checklist
47
+ - Never upgrade `Runtime status` to `Verified` from partial logs or memory without observed read-only/execution proof.
48
+ - Always default `Artifact status` to `Not Produced`; never assign `Attempted` to artifacts (use `Not Produced` or `Failed`), and route any output files on disk through `render-export-evidence`.
49
+ - Strip OS home directories, user tokens, license keys, and `.mcp` auth headers before saving under `docs/evals/`.
@@ -0,0 +1,15 @@
1
+ # Runtime Failure Triage & Next Actions
2
+
3
+ Match the observed failure signal cleanly without guessing or loosening safety gates:
4
+
5
+ | Observed Signal | Probable Root Cause | Verified Next Action |
6
+ |---|---|---|
7
+ | **Timeout on first MCP handshake / `tools/list`** | MCP server not listening, host sandbox firewall blocking localhost socket, or STDIO command wrong path | Inspect host MCP log; confirm Blender is open with add-on ticked enabled; keep `Runtime status: Failed` or `Attempted`. |
8
+ | **Lab MCP add-on fails to load inside Blender** | Blender version below `5.1.0` (Path 1 manifest floor) or wrong zip structure installed | Run `blender --version` verbatim. If `< 5.1.0`, route back to `runtime-path-picker` (Path 2 `3.0+` or CLI appendix). |
9
+ | **Port `9876` already bound / inconsistent tool schemas** | Dual bridge collision (Path 1 + Path 2 active together) or stale Blender headless process holding socket | Stop immediately and invoke `bridge-conflicts`; disable competing add-on and restart clean Blender session. |
10
+ | **CLI exits `0` but no render/GLB appears** | `-o` flag placed after `-f`, relative `//` path without `.blend` saved, or omitted `--python-exit-code 1` | Check stderr, fix flag order (`cli-appendix-job-outline`), verify `fs` output before updating `Artifact status`. |
11
+ | **Enterprise policy disallows external MCP / sockets** | Network or client policy blocks local MCP transport | Switch outline cleanly to CLI appendix batch job or pure planning deliverables; keep `Runtime status: Not Run`. |
12
+ | **Tool call mutates unexpected object or returns invalid payload** | Unqualified third-party tool or outdated schema drift | Abort mutation batch, run rollback verification, redact any sensitive tokens before recording `docs/evals/` packet. |
13
+
14
+ ## Related skill
15
+ - [SKILL.md](../SKILL.md)
@@ -0,0 +1,27 @@
1
+ # Truth label blocks
2
+
3
+ Use definitions from `laws/evidence-before-done.md`.
4
+
5
+ **Runtime status**
6
+
7
+ - `Not Run` — no attempt started.
8
+ - `Attempted` — tried; incomplete evidence or blocked mid-flight.
9
+ - `Produced` — observable runtime output exists but validation incomplete.
10
+ - `Verified` — output exists AND checks recorded (rare immediately after first connect).
11
+ - `Failed` — attempt concluded negatively with evidence.
12
+
13
+ A blocked environment (no attempt started) stays `Not Run`; an attempt that could not finish stays `Attempted`. Do not introduce a `Blocked` runtime state — it is not one of the 5 truth states.
14
+
15
+ **Artifact status** (renders, GLB, previews)
16
+
17
+ - Default stance remains conservative until paths cited.
18
+
19
+ Include a one-line educator note for stakeholders ("Verified requires proof, not confidence").
20
+
21
+ ## Red Flags & Rationalization Prevention
22
+
23
+ | Excuse | Reality |
24
+ |---|---|
25
+ | "Connecting to Blender failed, so let's call it `Blocked`." | `Blocked` is NOT a valid state. If no runtime session started, stamp `Not Run`; if mid-flight abort/crash, stamp `Attempted` or `Failed`. |
26
+ | "Path 2 community `mcp-for-blender` rendered fine, so mark release-ready." | Path 2 carries mandatory third-party caveats and **never** counts as official release certification. |
27
+ | "I'll paste the raw MCP JSON config to save time." | Secret hygiene violation. Redact all bearer tokens, API keys, and local usernames before saving logs. |
@@ -0,0 +1,26 @@
1
+ # EVAL — runtime-path-picker
2
+
3
+ ## Text-only eval prompt
4
+
5
+ User has Blender 4.2 LTS, wants MCP steering from Cursor. Pick path.
6
+
7
+ ## Expected behavior
8
+
9
+ - Path 1 unavailable (needs Blender 5.1+ for Lab add-on); explain succinctly
10
+ - Path 2 likely fit if user accepts community bridge caveats
11
+ - CLI appendix optional note for batch exports only
12
+ - Hand off to setup guide + unofficial bridges doc awareness
13
+
14
+ ## Pass / Warn / Fail criteria
15
+
16
+ - Pass: primary path + version gating explained
17
+ - Warn: user vague on headless vs interactive — ask one clarifier
18
+ - Fail: recommends Path 1 without 5.1+ guard
19
+
20
+ ## Sample passing response outline
21
+
22
+ - Conditional matrix + pick
23
+
24
+ ## Sample failing response outline
25
+
26
+ - "Install Connector" for Blender 4.2 without caveat
@@ -0,0 +1,268 @@
1
+ ---
2
+ name: runtime-path-picker
3
+ description: Choose Path 1 Lab MCP, Path 2 mcp-for-blender bridge, or CLI appendix from constraints; Connector hosts Path 1 only with Lab add-on inside Blender.
4
+ ---
5
+
6
+ # runtime-path-picker
7
+
8
+ ## Purpose
9
+
10
+ Produce a **single primary** runtime execution choice among Path 1 (Blender Lab MCP), Path 2 (community `mcp-for-blender` (formerly `ahujasid/blender-mcp`)), or the CLI fallback appendix — with explicit tradeoffs and no false "standalone Connector" claims.
11
+
12
+ ## Quick start
13
+
14
+ - collect Blender version band, host app (Claude Desktop vs coding agent vs CI), interactivity needs
15
+ - score against `references/path-constraints-table.md`
16
+ - walk `references/decision-tree.md`
17
+ - document choice using `references/anti-patterns.md` guardrails
18
+
19
+ ## When to use
20
+
21
+ - user unsure Lab vs community vs CLI
22
+ - environment pinned to Blender below 5.1 (Path 1 unavailable)
23
+ - automation / batch render discussion
24
+
25
+ ## When not to use
26
+ <!-- blendops:generated:start exclusions -->
27
+ - prerequisite framing or install steps → use `../runtime-setup/SKILL.md` (Delegates out-of-scope requests to runtime-setup)
28
+ - running the readiness matrix → use `../runtime-readiness/SKILL.md` (Delegates out-of-scope requests to runtime-readiness)
29
+ - detailing Path 1 host (a) Connector vs (b) manual MCP client → use `../path-one-host-outline/SKILL.md` (Delegates out-of-scope requests to path-one-host-outline)
30
+ - outlining headless CLI jobs → use `../cli-appendix-job-outline/SKILL.md` (Delegates out-of-scope requests to cli-appendix-job-outline)
31
+ - resolving active bridge or port collisions → use `../bridge-conflicts/SKILL.md` (Delegates out-of-scope requests to bridge-conflicts)
32
+ - halting on contradictory constraints before handoff → use `../pre-handoff-verification/SKILL.md` (Delegates out-of-scope requests to pre-handoff-verification)
33
+ <!-- blendops:generated:end exclusions -->
34
+
35
+ ## Trigger phrases
36
+ <!-- blendops:generated:start triggers -->
37
+ - "which MCP should I use"
38
+ - "Lab MCP or mcp-for-blender"
39
+ - "Path 1 or Path 2"
40
+ - "CLI vs MCP"
41
+ <!-- blendops:generated:end triggers -->
42
+
43
+ ## Prerequisites / readiness
44
+
45
+ - target Blender major/minor known or explicitly unknown
46
+ - whether interactive steering vs batch matters
47
+
48
+ ## Input schema
49
+
50
+ ### Required inputs
51
+
52
+ | Input | Why it is required |
53
+ |---|---|
54
+ | Blender version (or uncertainty) | Gates Path 1 |
55
+ | Host environment category | Connector vs generic MCP vs CI |
56
+
57
+ ### Optional inputs
58
+
59
+ | Input | Use |
60
+ |---|---|
61
+ | Org IT constraints | May force CLI appendix |
62
+ | Prior tooling investment | Path loyalty |
63
+
64
+ ## Output schema
65
+
66
+ ### Primary output
67
+
68
+ - **single** primary path recommendation + rationale (this skill configures nothing)
69
+ - rejected paths + explicit rationale for each rejected option
70
+ - if **Path 1** is recommended: host option note covering (a) Anthropic Connector in Claude Desktop or (b) any manually configured MCP client — **both** require the Official Blender Lab MCP add-on (`blender_version_min = "5.1.0"`) inside Blender; Connector is NOT standalone
71
+ - if **Path 2** (`mcp-for-blender`, renamed from `ahujasid/blender-mcp`) is recommended: explicit third-party caveats (`Blender 3.0+`) + mandatory **non-release evidence** label (never release evidence)
72
+ - if **CLI fallback** is recommended: mandatory **appendix-only** label (`blender --background --python`), stating it is never a peer path without an eval record
73
+
74
+ ### Evidence / caveat output
75
+
76
+ ```txt
77
+ Runtime status: Not Run | Attempted | Produced | Verified | Failed
78
+ Artifact status: Not Produced | Produced | Verified | Failed
79
+ Blockers: <separate line; route contradictory constraints to pre-handoff-verification>
80
+ Evidence used: <user-stated constraints only unless logs provided>
81
+ Limitations: <unknown Blender build or unverified host state>
82
+ ```
83
+
84
+ - Artifacts default to `Not Produced`; truth states are **downgrade-only, never upgrade**.
85
+
86
+ ## Required laws
87
+
88
+ - `../../laws/evidence-before-done.md`
89
+ - `../../laws/non-blender-user-language.md`
90
+ - `../../laws/no-arbitrary-python-interface.md`
91
+ - `../../laws/official-runtime-only.md`
92
+
93
+ ## Official runtime boundary
94
+
95
+ Decision skill only — chooses a single primary path from constraints and configures nothing (see `../../docs/runtime-stack-strategy.md` for the canonical model).
96
+ - **Path 1**: Official Blender Lab MCP in Blender 5.1+ (add-on manifest literal `blender_version_min = "5.1.0"`), hosted from (a) Anthropic Connector in Claude Desktop or (b) any manually configured MCP client. Connector is NOT standalone.
97
+ - **Path 2**: Community `mcp-for-blender` (renamed from `ahujasid/blender-mcp`), third-party, Blender 3.0+, recommended only with explicit caveats and **never as release evidence**. Manual configuration responsibility; see `docs/unofficial-runtime-bridges.md`.
98
+ - **CLI fallback**: Appendix only (`blender --background --python`), never a peer path without an eval record. Documented upstream as a first-class Blender CLI surface (render/Cycles/format/Python sections read in the current Blender 5.2 LTS Manual); **no in-repo evidence file yet** for BlendOps-run CLI examples.
99
+ - **Bridge limit**: One MCP bridge per Blender instance (default port 9876).
100
+ - **Role boundary**: Prerequisite framing belongs to `runtime-setup`; readiness matrix checks belong to `runtime-readiness`; Path 1 host a/b details belong to `path-one-host-outline`; headless job outlines belong to `cli-appendix-job-outline`; bridge conflicts belong to `bridge-conflicts`.
101
+
102
+ ## Operating procedure
103
+
104
+ 1. Check constraints for contradictions (e.g., requires official release evidence on Blender `<5.1`, or demands interactive MCP where all local ports/addons and CLI are forbidden). If constraints are contradictory, stop and exit to `pre-handoff-verification`.
105
+ 2. Gate **Path 1** on Blender 5.1+ feasibility (`blender_version_min = "5.1.0"`) with host (a) Anthropic Connector in Claude Desktop or (b) manually configured MCP client (handoff host details to `path-one-host-outline`).
106
+ 3. If Path 1 is impossible, Blender is `3.0+`, and interactive MCP is required → select **Path 2** (`mcp-for-blender`, formerly `ahujasid/blender-mcp`) only with explicit third-party caveats and a **non-release evidence** label.
107
+ 4. If batch, headless, or CI constraints dominate → select the **CLI fallback** (`blender --background --python`) labeled strictly as **appendix-only** (never a peer path without an eval record) and hand off job structure to `cli-appendix-job-outline`.
108
+ 5. Enforce the one MCP bridge per Blender instance rule (default port 9876); if multiple bridges are active or requested on one instance, hand off to `bridge-conflicts`.
109
+
110
+ ## Decision tree
111
+
112
+ ```txt
113
+ Are the user's constraints mutually contradictory (e.g., demands official Path 1 release evidence on Blender 4.2 LTS, or requires interactive MCP when all local ports/add-ons are forbidden)?
114
+ Yes → STOP; record contradiction on Blockers line and exit to pre-handoff-verification
115
+ No → continue
116
+ Are both Path 1 and Path 2 bridges configured or requested simultaneously on the same Blender instance (port 9876)?
117
+ Yes → STOP; route to bridge-conflicts (Single-bridge constraint)
118
+ No → continue
119
+ Does the workflow require non-interactive CI, render-farm, or headless batch automation rather than interactive viewport steering?
120
+ Yes → select CLI fallback (`blender --background --python`) with mandatory **appendix-only** label (never a peer path without an eval record) and hand off to cli-appendix-job-outline
121
+ No (interactive MCP steering required) → continue
122
+ Is Blender 5.1+ (`blender_version_min = "5.1.0"`) available and can the Official Blender Lab MCP add-on be installed inside Blender?
123
+ Yes → select **Path 1 — Official Blender Lab MCP** (hosted via (a) Anthropic Connector in Claude Desktop or (b) manual MCP client; Connector is NOT standalone) and hand off host specifics to path-one-host-outline
124
+ No (Blender is 3.0–5.0, e.g., Blender 4.2 LTS) →
125
+ Does the user accept third-party community bridge maintenance and non-release evidence caveats?
126
+ Yes → select **Path 2 — Community `mcp-for-blender`** (formerly `ahujasid/blender-mcp`, Blender 3.0+) with mandatory **non-release evidence** label
127
+ No → block execution and route to pre-handoff-verification
128
+ ```
129
+
130
+ ## Playbooks
131
+
132
+ ### Playbook A: Blender 5.1+ interactive workstation (`Path 1` selected)
133
+
134
+ - Verify Blender `>= 5.1.0` (`blender_version_min = "5.1.0"`) against `references/path-constraints-table.md`.
135
+ - Recommend **Path 1 — Official Blender Lab MCP** as the single primary path, explicitly noting both host options — **(a)** Anthropic Connector in Claude Desktop and **(b)** manual MCP client — and stating that the Lab MCP add-on inside Blender is required for both (**Connector is NOT standalone**).
136
+ - Reject Path 2 (unnecessary third-party surface when 5.1+ is available) and CLI appendix (poor fit for interactive look-dev), then hand off to `../path-one-host-outline/SKILL.md` or `../runtime-setup/SKILL.md`.
137
+
138
+ ### Playbook B: Blender 3.0–4.x LTS interactive MCP request (`Path 2` selected with caveats)
139
+
140
+ - Explain succinctly that **Path 1** is unavailable because the Official Blender Lab MCP add-on manifest requires `blender_version_min = "5.1.0"`.
141
+ - Recommend **Path 2 — Community `mcp-for-blender`** (renamed from `ahujasid/blender-mcp`, `Blender 3.0+`) as the single primary path **only** with explicit third-party maintenance caveats (`../../docs/unofficial-runtime-bridges.md`) and a mandatory **never release evidence** label.
142
+ - Enforce the single-bridge rule (one MCP bridge per Blender instance on default port `9876`).
143
+
144
+ ### Playbook C: Headless CI or batch export pipeline (`CLI fallback appendix` selected)
145
+
146
+ - Select the **CLI fallback (`blender --background --python`)** with the mandatory **appendix-only** label (documented upstream as a first-class Blender CLI surface, with no in-repo BlendOps eval record yet — never a peer MCP path).
147
+ - Reject Path 1 and Path 2 for stateless batch runners and hand off job structure to `../cli-appendix-job-outline/SKILL.md`.
148
+
149
+ ## Mode handling
150
+
151
+ ### Text-only mode
152
+
153
+ Deliver a single hypothetical path recommendation with rejected-paths rationale, required labels, Runtime status `Not Run`, and Artifact status `Not Produced`.
154
+
155
+ ### Runtime-ready mode
156
+
157
+ Cross-check constraints against `runtime-readiness` output if present; preserve or downgrade truth states (downgrade-only, never upgrade; artifacts default `Not Produced`).
158
+
159
+ ### Blocked runtime mode
160
+
161
+ Record blockers on a separate line, keep truth states downgraded (`Not Run` / `Failed` for runtime, `Not Produced` / `Failed` for artifacts), and route contradictory constraints to `pre-handoff-verification`.
162
+
163
+ ## Validation checklist
164
+
165
+ - [ ] Exactly one primary path recommended, with rejected paths and rationale included
166
+ - [ ] Path 1 mentions include `blender_version_min = "5.1.0"` and state that Anthropic Connector is NOT standalone
167
+ - [ ] Path 2 pick includes `Blender 3.0+` floor, third-party caveats, and **never release evidence** label
168
+ - [ ] CLI pick includes **appendix-only** label (`blender --background --python`) and is never framed as a peer path without an eval record
169
+ - [ ] One MCP bridge per Blender instance (default port 9876) noted; no role blur into setup, readiness, host outline, CLI outline, or conflict resolution
170
+ - [ ] Truth states use allowed values only, default artifacts to `Not Produced`, and strictly downgrade-only
171
+ - [ ] Contradictory constraints exit to `pre-handoff-verification`
172
+
173
+ ## Pass / Warn / Fail rubric
174
+
175
+ | Verdict | Criteria |
176
+ |---|---|
177
+ | Pass | Single primary path + rejected-paths rationale mapped to constraints, required Path 1/Path 2/CLI labels attached, boundaries respected, truth states valid. |
178
+ | Warn | Blender version or host detail unknown — single primary path chosen conditionally with explicit fallback branches and `Not Produced` artifact default. |
179
+ | Fail | Recommends multiple primary paths; claims Connector is standalone; picks Path 2 without caveats + non-release label; treats CLI as a peer path without an eval record; blurs roles with neighbor skills; upgrades truth states; or fails to exit to `pre-handoff-verification` on contradictory constraints. |
180
+
181
+ ## Failure handling
182
+
183
+ - If constraints are contradictory (such as requiring official Path 1 release certification while locked to Blender 4.2 LTS, or demanding live MCP steering where local sockets and add-ons are banned by policy), do not force a broken pick; record the contradiction under `Blockers`, keep `Runtime status: Not Run` and `Artifact status: Not Produced`, and exit to `../pre-handoff-verification/SKILL.md`.
184
+ - If the user's Blender version is unknown, emit a `Warn`-level conditional pick that branches explicitly on `Blender >= 5.1.0` (Path 1) vs `Blender 3.0–5.0` (Path 2 with non-release caveats) until the version is confirmed.
185
+ - If the user attempts to attach both Path 1 and Path 2 to the same Blender instance, stop path selection and route to `../bridge-conflicts/SKILL.md`.
186
+
187
+ ## Troubleshooting
188
+
189
+ | Symptom | Cause | Safe resolution |
190
+ |---|---|---|
191
+ | User on Blender 4.2 LTS asks to install the Anthropic Blender Connector | Anthropic tutorial prose mentions "Blender 4.2 or later", but the Lab MCP add-on manifest enforces `blender_version_min = "5.1.0"` | Explain the binding 5.1.0 manifest floor; reject Path 1 unless the user upgrades to Blender 5.1+, or recommend Path 2 (`mcp-for-blender`) with third-party non-release caveats. |
192
+ | User wants to run Path 1 in Claude Desktop and Path 2 in Cursor against one open Blender window | Violates the Single-bridge constraint on port `9876` | Warn that Blender accepts only one active MCP bridge session per instance and route to `../bridge-conflicts/SKILL.md`. |
193
+ | User treats `blender --background` as "Path 3 MCP" | Confusion between MCP bridges and Blender's native command-line interface | Clarify that `blender --background --python` is the **CLI fallback appendix** (no MCP involved, not a peer path without an eval record) and hand off to `../cli-appendix-job-outline/SKILL.md`. |
194
+
195
+ ## Best practices
196
+
197
+ - Always select **exactly one** primary runtime path and provide explicit rejection rationales for the other two options (`references/path-constraints-table.md`).
198
+ - Whenever Path 1 is mentioned, state both `blender_version_min = "5.1.0"` (**Blender 5.1+**) and that the **Anthropic Connector is NOT standalone**.
199
+ - Whenever Path 2 (`mcp-for-blender`, formerly `ahujasid/blender-mcp`) is recommended, attach the `Blender 3.0+` floor, third-party maintenance caveat, and **never release evidence** label.
200
+ - Keep `Runtime status: Not Run` and `Artifact status: Not Produced` when choosing a runtime path.
201
+
202
+ ## Good examples
203
+
204
+ - "Primary path: **Path 2 — Community `mcp-for-blender`** (formerly `ahujasid/blender-mcp`, `Blender 3.0+`, third-party community bridge — **never release evidence**). Rejected paths: **Path 1 — Official Blender Lab MCP** (rejected because the environment is pinned to Blender 4.2 LTS, below the binding `blender_version_min = \"5.1.0\"` floor; note that Anthropic Connector is also not standalone); **CLI fallback appendix** (`blender --background --python`, appendix-only, rejected because interactive Cursor look-dev steering is required). Single-bridge rule: one MCP bridge per Blender instance (port 9876). `Runtime status: Not Run`. `Artifact status: Not Produced`."
205
+ - "Primary path: **Path 1 — Official Blender Lab MCP** in **Blender 5.1+** (`blender_version_min = \"5.1.0\"`), hosted via **(a)** Anthropic Connector in Claude Desktop or **(b)** manual MCP client (both require the Lab MCP add-on inside Blender; Connector is NOT standalone). Hand off host details to `../path-one-host-outline/SKILL.md`. `Runtime status: Not Run`. `Artifact status: Not Produced`."
206
+
207
+ ## Bad examples
208
+
209
+ - "You can use either Path 1 or Path 2, or run both together on port 9876." — fails to pick a single primary path and violates the Single-bridge constraint.
210
+ - "On Blender 4.2, use Path 1 via the standalone Anthropic Connector in Claude Desktop." — violates both the Blender 5.1+ manifest floor and the non-standalone Connector rule.
211
+ - "Use Path 2 (`blender-mcp`) to generate certified release evidence." — uses bare `blender-mcp` and falsely promotes Path 2 to release evidence.
212
+
213
+ ## User-facing response template
214
+
215
+ ```txt
216
+ Primary runtime path: <Path 1 — Official Blender Lab MCP (Blender 5.1+) | Path 2 — Community mcp-for-blender (Blender 3.0+, non-release evidence) | CLI fallback appendix (blender --background --python, appendix-only)>
217
+ Why this path fits: <constraint-mapped rationale>
218
+
219
+ Mandatory path guardrails:
220
+ - Path 1 note: Requires Lab MCP add-on (`blender_version_min = "5.1.0"`) inside Blender 5.1+ for both Host (a) Anthropic Connector and Host (b) manual MCP client; Connector is NOT standalone.
221
+ - Path 2 note: `mcp-for-blender` (formerly `ahujasid/blender-mcp`), third-party, Blender 3.0+, manual config, never release evidence.
222
+ - CLI fallback note: Appendix-only (`blender --background --python`), never a peer path without an eval record.
223
+ - Single-bridge rule: One MCP bridge per Blender instance (default port 9876).
224
+
225
+ Rejected paths & rationale:
226
+ - <Rejected option 1>: <why rejected>
227
+ - <Rejected option 2>: <why rejected>
228
+
229
+ Blockers: <none or contradictory constraints routed to pre-handoff-verification>
230
+ Runtime status: Not Run
231
+ Artifact status: Not Produced
232
+ Evidence used: <user-stated constraints + docs/runtime-stack-strategy.md>
233
+ Limitations: <unverified Blender build or host permissions>
234
+ Next skill: <path-one-host-outline | runtime-setup | cli-appendix-job-outline | bridge-conflicts | pre-handoff-verification>
235
+ ```
236
+
237
+ ## Anti-patterns
238
+
239
+ - Recommending two primary paths at once instead of committing to a single primary recommendation (`references/anti-patterns.md`).
240
+ - Claiming the Anthropic Blender Connector works standalone without installing the Official Blender Lab MCP add-on inside **Blender 5.1+**.
241
+ - Applying the Path 1 **Blender 5.1+** floor to Path 2 (`mcp-for-blender`) or the CLI fallback appendix.
242
+ - Recommending Path 2 without explicit third-party caveats and the **never release evidence** label, or calling it bare `blender-mcp`.
243
+ - Treating the CLI fallback appendix as a peer MCP path without an in-repo evaluation record.
244
+ - Writing `Artifact status: Not Run` or upgrading truth states during path selection.
245
+
246
+ ## Cross-skill handoff
247
+ <!-- blendops:generated:start handoffs -->
248
+ - [progression] Prerequisite framing → `../runtime-setup/SKILL.md`
249
+ - [progression] Readiness matrix check → `../runtime-readiness/SKILL.md`
250
+ - [progression] Host (a)/(b) specifics for Path 1 → `../path-one-host-outline/SKILL.md`
251
+ - [progression] Headless CLI appendix job outline → `../cli-appendix-job-outline/SKILL.md`
252
+ - [fallback] Bridge or port 9876 conflicts → `../bridge-conflicts/SKILL.md`
253
+ - [fallback] Contradictory constraints failure exit → `../pre-handoff-verification/SKILL.md`
254
+ <!-- blendops:generated:end handoffs -->
255
+
256
+ ## Non-goals
257
+
258
+ - Walking through step-by-step add-on installation or host config file edits (owned by `../runtime-setup/SKILL.md`).
259
+ - Probing live runtime connectivity (owned by `../runtime-readiness/SKILL.md`).
260
+ - Detailing Path 1 Host (a) vs Host (b) architecture (owned by `../path-one-host-outline/SKILL.md`) or CLI batch job phases (owned by `../cli-appendix-job-outline/SKILL.md`).
261
+ - Executing Blender, generating Python code, or verifying artifacts.
262
+
263
+ ## References
264
+
265
+ - `references/path-constraints-table.md`
266
+ - `references/decision-tree.md`
267
+ - `references/anti-patterns.md`
268
+ - `../../docs/runtime-stack-strategy.md`