blendops 0.0.0-stage → 1.0.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 (484) hide show
  1. package/CHANGELOG.md +62 -0
  2. package/LICENSE +21 -0
  3. package/README.md +189 -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 +72 -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/examples/glb-web-handoff/README.md +174 -0
  136. package/docs/examples/glb-web-handoff/r3f-glb-viewer.tsx +320 -0
  137. package/docs/examples/glb-web-handoff/threejs-glb-viewer.mjs +709 -0
  138. package/docs/knowledge-and-recipe-catalog.md +236 -0
  139. package/docs/recipes/README.md +27 -0
  140. package/docs/recipes/cyberpunk-shoe-hero.md +97 -0
  141. package/docs/workflows/README.md +14 -0
  142. package/docs/workflows/full-non-blender-user-workflow.md +210 -0
  143. package/docs/workflows/product-hero-workflow.md +92 -0
  144. package/laws/README.md +32 -0
  145. package/laws/evidence-before-done.md +37 -0
  146. package/laws/no-arbitrary-python-interface.md +32 -0
  147. package/laws/non-blender-user-language.md +32 -0
  148. package/laws/official-runtime-only.md +78 -0
  149. package/package.json +99 -4
  150. package/packs/README.md +11 -0
  151. package/packs/product-hero-v0/PACK.md +114 -0
  152. package/registry/catalog-index.json +21344 -0
  153. package/registry/compatibility-matrix.json +533 -0
  154. package/registry/contract-context-fields.json +391 -0
  155. package/registry/knowledge-catalog.json +4648 -0
  156. package/registry/knowledge-sources.json +438 -0
  157. package/registry/recipe-catalog.json +2565 -0
  158. package/registry/runtime-capability-policy.json +525 -0
  159. package/registry/runtime-operations.json +4468 -0
  160. package/registry/skills.json +10231 -0
  161. package/registry/workflow-graph.json +7390 -0
  162. package/schemas/adapter-compatibility-matrix.schema.json +166 -0
  163. package/schemas/contract-context-fields.schema.json +147 -0
  164. package/schemas/execution-plan.schema.json +325 -0
  165. package/schemas/glb-web-handoff-manifest.schema.json +744 -0
  166. package/schemas/knowledge-record.schema.json +460 -0
  167. package/schemas/knowledge-source-registry.schema.json +268 -0
  168. package/schemas/operation-execution-ledger.schema.json +348 -0
  169. package/schemas/recipe-record.schema.json +469 -0
  170. package/schemas/runtime-capability-policy.schema.json +184 -0
  171. package/schemas/runtime-evidence-packet.schema.json +211 -0
  172. package/schemas/runtime-operations.schema.json +535 -0
  173. package/schemas/runtime-qualification-report.schema.json +540 -0
  174. package/schemas/runtime-session.schema.json +350 -0
  175. package/schemas/scene-spec.schema.json +624 -0
  176. package/schemas/skill-contract.schema.json +402 -0
  177. package/schemas/skill-eval.schema.json +509 -0
  178. package/scripts/build-knowledge-catalog.mjs +2376 -0
  179. package/scripts/compile-scene-plan.mjs +1945 -0
  180. package/scripts/export-claude-skills.mjs +634 -0
  181. package/scripts/generate-glb-handoff-report.mjs +2376 -0
  182. package/scripts/inspect-glb.mjs +1627 -0
  183. package/scripts/install-skills.mjs +5369 -0
  184. package/scripts/runtime-orchestrator.mjs +7652 -0
  185. package/scripts/validate-capability-policy.mjs +531 -0
  186. package/scripts/validate-evidence-packet.mjs +256 -0
  187. package/skills/README.md +315 -0
  188. package/skills/_template/SKILL.md +296 -0
  189. package/skills/acceptance-criteria-builder/EVAL.md +25 -0
  190. package/skills/acceptance-criteria-builder/SKILL.md +257 -0
  191. package/skills/acceptance-criteria-builder/contract.json +205 -0
  192. package/skills/acceptance-criteria-builder/references/brief-to-criteria-mapper.md +22 -0
  193. package/skills/acceptance-criteria-builder/references/checklist-patterns.md +22 -0
  194. package/skills/acceptance-criteria-builder/references/evidence-hook-rules.md +19 -0
  195. package/skills/asset-discovery/EVAL.md +81 -0
  196. package/skills/asset-discovery/SKILL.md +252 -0
  197. package/skills/asset-discovery/contract.json +291 -0
  198. package/skills/asset-discovery/references/asset-strategy-decision-tree.md +40 -0
  199. package/skills/asset-discovery/references/budget-reconciliation-patterns.md +54 -0
  200. package/skills/asset-discovery/references/license-confidence-table.md +41 -0
  201. package/skills/asset-fallback-strategy/EVAL.md +34 -0
  202. package/skills/asset-fallback-strategy/SKILL.md +248 -0
  203. package/skills/asset-fallback-strategy/contract.json +190 -0
  204. package/skills/asset-fallback-strategy/references/drop-with-caveat-rules.md +36 -0
  205. package/skills/asset-fallback-strategy/references/fallback-option-types.md +55 -0
  206. package/skills/asset-fallback-strategy/references/scoring-rubric.md +61 -0
  207. package/skills/asset-library-plan/EVAL.md +28 -0
  208. package/skills/asset-library-plan/SKILL.md +263 -0
  209. package/skills/asset-library-plan/contract.json +177 -0
  210. package/skills/asset-library-plan/references/folder-structure-rules.md +63 -0
  211. package/skills/asset-library-plan/references/metadata-schema.md +62 -0
  212. package/skills/asset-library-plan/references/naming-rules.md +51 -0
  213. package/skills/asset-license-checker/EVAL.md +33 -0
  214. package/skills/asset-license-checker/SKILL.md +245 -0
  215. package/skills/asset-license-checker/contract.json +172 -0
  216. package/skills/asset-license-checker/references/attribution-rendering-patterns.md +48 -0
  217. package/skills/asset-license-checker/references/common-license-mapping.md +39 -0
  218. package/skills/asset-license-checker/references/license-source-rules.md +38 -0
  219. package/skills/asset-style-check/EVAL.md +26 -0
  220. package/skills/asset-style-check/SKILL.md +238 -0
  221. package/skills/asset-style-check/contract.json +251 -0
  222. package/skills/asset-style-check/references/drift-classification.md +40 -0
  223. package/skills/asset-style-check/references/intentional-mixed-style.md +39 -0
  224. package/skills/asset-style-check/references/style-axes.md +46 -0
  225. package/skills/blender-brainstorming/EVAL.md +79 -0
  226. package/skills/blender-brainstorming/SKILL.md +228 -0
  227. package/skills/blender-brainstorming/contract.json +115 -0
  228. package/skills/blender-brainstorming/references/alternative-scoping-templates.md +43 -0
  229. package/skills/blender-brainstorming/references/clarification-patterns.md +29 -0
  230. package/skills/blender-brainstorming/references/intent-summary-style-guide.md +25 -0
  231. package/skills/blender-recipe-decomposer/EVAL.md +35 -0
  232. package/skills/blender-recipe-decomposer/SKILL.md +258 -0
  233. package/skills/blender-recipe-decomposer/contract.json +152 -0
  234. package/skills/blender-recipe-decomposer/references/dependency-patterns.md +53 -0
  235. package/skills/blender-recipe-decomposer/references/recipe-grouping-rules.md +58 -0
  236. package/skills/blender-recipe-decomposer/references/recipe-naming-rules.md +44 -0
  237. package/skills/blender-troubleshooting/EVAL.md +78 -0
  238. package/skills/blender-troubleshooting/SKILL.md +263 -0
  239. package/skills/blender-troubleshooting/contract.json +352 -0
  240. package/skills/blender-troubleshooting/references/common-symptom-playbooks.md +51 -0
  241. package/skills/blender-troubleshooting/references/divergence-routing-table.md +23 -0
  242. package/skills/blender-troubleshooting/references/four-phase-template.md +51 -0
  243. package/skills/blendops-help/EVAL.md +67 -0
  244. package/skills/blendops-help/SKILL.md +312 -0
  245. package/skills/blendops-help/contract.json +229 -0
  246. package/skills/blendops-help/references/lifecycle-phases.md +91 -0
  247. package/skills/blendops-help/references/quick-start-prompts.md +65 -0
  248. package/skills/blendops-help/references/routing-decision-tree.md +57 -0
  249. package/skills/bridge-conflicts/EVAL.md +83 -0
  250. package/skills/bridge-conflicts/SKILL.md +246 -0
  251. package/skills/bridge-conflicts/contract.json +145 -0
  252. package/skills/bridge-conflicts/references/bridge-state-matrix-template.md +82 -0
  253. package/skills/bridge-conflicts/references/conflict-playbooks.md +99 -0
  254. package/skills/bridge-conflicts/references/do-not-reminders.md +42 -0
  255. package/skills/camera-composition/EVAL.md +32 -0
  256. package/skills/camera-composition/SKILL.md +196 -0
  257. package/skills/camera-composition/contract.json +180 -0
  258. package/skills/camera-composition/references/camera-presets.md +30 -0
  259. package/skills/camera-composition/references/camera-rubric.md +24 -0
  260. package/skills/camera-composition/references/hero-composition-patterns.md +24 -0
  261. package/skills/camera-composition/references/web-layout-negative-space.md +25 -0
  262. package/skills/character-portrait/EVAL.md +42 -0
  263. package/skills/character-portrait/SKILL.md +245 -0
  264. package/skills/character-portrait/contract.json +205 -0
  265. package/skills/character-portrait/references/portrait-framing-rules.md +39 -0
  266. package/skills/character-portrait/references/portrait-lighting-patterns.md +50 -0
  267. package/skills/character-portrait/references/style-consistency-rules.md +41 -0
  268. package/skills/cli-appendix-job-outline/EVAL.md +26 -0
  269. package/skills/cli-appendix-job-outline/SKILL.md +252 -0
  270. package/skills/cli-appendix-job-outline/contract.json +147 -0
  271. package/skills/cli-appendix-job-outline/references/flag-order-reminders.md +16 -0
  272. package/skills/cli-appendix-job-outline/references/job-type-matrix.md +13 -0
  273. package/skills/cli-appendix-job-outline/references/stateless-limitations.md +12 -0
  274. package/skills/color-management-decision/EVAL.md +28 -0
  275. package/skills/color-management-decision/SKILL.md +254 -0
  276. package/skills/color-management-decision/contract.json +162 -0
  277. package/skills/color-management-decision/references/look-comparison.md +44 -0
  278. package/skills/color-management-decision/references/per-channel-rules.md +49 -0
  279. package/skills/color-management-decision/references/pipeline-mapping.md +47 -0
  280. package/skills/composition-quality-checker/EVAL.md +38 -0
  281. package/skills/composition-quality-checker/SKILL.md +260 -0
  282. package/skills/composition-quality-checker/contract.json +221 -0
  283. package/skills/composition-quality-checker/references/aspect-ratio-rules.md +37 -0
  284. package/skills/composition-quality-checker/references/composition-rules.md +58 -0
  285. package/skills/composition-quality-checker/references/headroom-leadroom-rules.md +46 -0
  286. package/skills/cycles-vs-eevee-decision/EVAL.md +26 -0
  287. package/skills/cycles-vs-eevee-decision/SKILL.md +249 -0
  288. package/skills/cycles-vs-eevee-decision/contract.json +142 -0
  289. package/skills/cycles-vs-eevee-decision/references/engine-feature-matrix.md +39 -0
  290. package/skills/cycles-vs-eevee-decision/references/gpu-device-rules.md +51 -0
  291. package/skills/cycles-vs-eevee-decision/references/samples-by-quality.md +53 -0
  292. package/skills/done-criteria/EVAL.md +33 -0
  293. package/skills/done-criteria/SKILL.md +225 -0
  294. package/skills/done-criteria/contract.json +199 -0
  295. package/skills/done-criteria/references/done-vs-perfect.md +56 -0
  296. package/skills/done-criteria/references/out-of-scope-patterns.md +50 -0
  297. package/skills/done-criteria/references/stop-condition-templates.md +39 -0
  298. package/skills/environment-shot/EVAL.md +44 -0
  299. package/skills/environment-shot/SKILL.md +237 -0
  300. package/skills/environment-shot/contract.json +162 -0
  301. package/skills/environment-shot/references/depth-layering-rules.md +49 -0
  302. package/skills/environment-shot/references/time-and-weather-rules.md +35 -0
  303. package/skills/environment-shot/references/wide-shot-camera-rules.md +51 -0
  304. package/skills/glb-animation-handoff/EVAL.md +39 -0
  305. package/skills/glb-animation-handoff/SKILL.md +271 -0
  306. package/skills/glb-animation-handoff/contract.json +247 -0
  307. package/skills/glb-animation-handoff/references/animation-types.md +36 -0
  308. package/skills/glb-animation-handoff/references/transition-rules.md +55 -0
  309. package/skills/glb-animation-handoff/references/web-stack-caveats.md +40 -0
  310. package/skills/glb-web-handoff/EVAL.md +33 -0
  311. package/skills/glb-web-handoff/SKILL.md +212 -0
  312. package/skills/glb-web-handoff/contract.json +171 -0
  313. package/skills/glb-web-handoff/references/artifact-status-language.md +26 -0
  314. package/skills/glb-web-handoff/references/glb-handoff-checklist.md +30 -0
  315. package/skills/glb-web-handoff/references/performance-caveats.md +26 -0
  316. package/skills/glb-web-handoff/references/threejs-r3f-handoff.md +28 -0
  317. package/skills/intent-to-3d-brief-writer/EVAL.md +82 -0
  318. package/skills/intent-to-3d-brief-writer/SKILL.md +238 -0
  319. package/skills/intent-to-3d-brief-writer/contract.json +195 -0
  320. package/skills/intent-to-3d-brief-writer/references/acceptance-criteria-patterns.md +46 -0
  321. package/skills/intent-to-3d-brief-writer/references/eight-slot-template.md +123 -0
  322. package/skills/intent-to-3d-brief-writer/references/mixed-audience-handling.md +39 -0
  323. package/skills/interior-scene/EVAL.md +44 -0
  324. package/skills/interior-scene/SKILL.md +261 -0
  325. package/skills/interior-scene/contract.json +277 -0
  326. package/skills/interior-scene/references/furniture-layout-rules.md +51 -0
  327. package/skills/interior-scene/references/interior-architecture-rules.md +47 -0
  328. package/skills/interior-scene/references/interior-camera-rules.md +47 -0
  329. package/skills/lighting-material-plan/EVAL.md +32 -0
  330. package/skills/lighting-material-plan/SKILL.md +194 -0
  331. package/skills/lighting-material-plan/contract.json +213 -0
  332. package/skills/lighting-material-plan/references/cyberpunk-lookdev.md +22 -0
  333. package/skills/lighting-material-plan/references/lighting-patterns.md +30 -0
  334. package/skills/lighting-material-plan/references/material-portability.md +25 -0
  335. package/skills/lighting-material-plan/references/reflective-floor-pattern.md +22 -0
  336. package/skills/lighting-material-plan/references/web-material-simplification.md +23 -0
  337. package/skills/lighting-quality-checker/EVAL.md +41 -0
  338. package/skills/lighting-quality-checker/SKILL.md +247 -0
  339. package/skills/lighting-quality-checker/contract.json +187 -0
  340. package/skills/lighting-quality-checker/references/hdri-balance-rules.md +48 -0
  341. package/skills/lighting-quality-checker/references/intensity-ranges.md +73 -0
  342. package/skills/lighting-quality-checker/references/shadow-softness-rules.md +38 -0
  343. package/skills/material-quality-checker/EVAL.md +40 -0
  344. package/skills/material-quality-checker/SKILL.md +261 -0
  345. package/skills/material-quality-checker/contract.json +244 -0
  346. package/skills/material-quality-checker/references/consumer-stack-rules.md +62 -0
  347. package/skills/material-quality-checker/references/pbr-sanity-rules.md +78 -0
  348. package/skills/material-quality-checker/references/texture-budget-rules.md +48 -0
  349. package/skills/mobile-glb-budget/EVAL.md +40 -0
  350. package/skills/mobile-glb-budget/SKILL.md +264 -0
  351. package/skills/mobile-glb-budget/contract.json +309 -0
  352. package/skills/mobile-glb-budget/references/budget-tiers.md +30 -0
  353. package/skills/mobile-glb-budget/references/degradation-plan.md +34 -0
  354. package/skills/mobile-glb-budget/references/violation-rules.md +43 -0
  355. package/skills/output-format-decision/EVAL.md +27 -0
  356. package/skills/output-format-decision/SKILL.md +222 -0
  357. package/skills/output-format-decision/contract.json +179 -0
  358. package/skills/output-format-decision/references/bit-depth-rules.md +56 -0
  359. package/skills/output-format-decision/references/compression-tradeoffs.md +62 -0
  360. package/skills/output-format-decision/references/format-decision-matrix.md +34 -0
  361. package/skills/pack-prerequisite-checker/EVAL.md +26 -0
  362. package/skills/pack-prerequisite-checker/SKILL.md +272 -0
  363. package/skills/pack-prerequisite-checker/contract.json +214 -0
  364. package/skills/pack-prerequisite-checker/references/blocked-start-playbook.md +21 -0
  365. package/skills/pack-prerequisite-checker/references/pack-readiness-template.md +38 -0
  366. package/skills/pack-prerequisite-checker/references/prerequisite-matrix.md +20 -0
  367. package/skills/path-one-host-outline/EVAL.md +26 -0
  368. package/skills/path-one-host-outline/SKILL.md +251 -0
  369. package/skills/path-one-host-outline/contract.json +167 -0
  370. package/skills/path-one-host-outline/references/connector-vs-manual-matrix.md +21 -0
  371. package/skills/path-one-host-outline/references/host-checklist-template.md +35 -0
  372. package/skills/path-one-host-outline/references/lab-addon-reminders.md +12 -0
  373. package/skills/plain-language-response/EVAL.md +33 -0
  374. package/skills/plain-language-response/SKILL.md +194 -0
  375. package/skills/plain-language-response/contract.json +242 -0
  376. package/skills/plain-language-response/references/caveat-language.md +25 -0
  377. package/skills/plain-language-response/references/plain-language-patterns.md +30 -0
  378. package/skills/plain-language-response/references/stakeholder-friendly-examples.md +30 -0
  379. package/skills/plain-language-response/references/status-summary-templates.md +50 -0
  380. package/skills/polycount-budget-checker/EVAL.md +40 -0
  381. package/skills/polycount-budget-checker/SKILL.md +251 -0
  382. package/skills/polycount-budget-checker/contract.json +196 -0
  383. package/skills/polycount-budget-checker/references/instance-counting-rules.md +39 -0
  384. package/skills/polycount-budget-checker/references/per-mesh-rules.md +43 -0
  385. package/skills/polycount-budget-checker/references/topology-hints.md +56 -0
  386. package/skills/pre-handoff-verification/EVAL.md +84 -0
  387. package/skills/pre-handoff-verification/SKILL.md +252 -0
  388. package/skills/pre-handoff-verification/contract.json +295 -0
  389. package/skills/pre-handoff-verification/references/downgrade-rules.md +39 -0
  390. package/skills/pre-handoff-verification/references/seven-point-checklist.md +46 -0
  391. package/skills/pre-handoff-verification/references/text-only-mode-handling.md +36 -0
  392. package/skills/preview-report/EVAL.md +39 -0
  393. package/skills/preview-report/SKILL.md +254 -0
  394. package/skills/preview-report/contract.json +141 -0
  395. package/skills/preview-report/references/handoff-recipients.md +41 -0
  396. package/skills/preview-report/references/report-schema.md +60 -0
  397. package/skills/preview-report/references/truth-label-rules.md +36 -0
  398. package/skills/product-grid-scene-planner/EVAL.md +42 -0
  399. package/skills/product-grid-scene-planner/SKILL.md +246 -0
  400. package/skills/product-grid-scene-planner/contract.json +257 -0
  401. package/skills/product-grid-scene-planner/references/grid-consistency-rules.md +53 -0
  402. package/skills/product-grid-scene-planner/references/grid-layout-rules.md +42 -0
  403. package/skills/product-grid-scene-planner/references/grid-output-naming-rules.md +52 -0
  404. package/skills/product-hero-scene-planner/EVAL.md +33 -0
  405. package/skills/product-hero-scene-planner/SKILL.md +227 -0
  406. package/skills/product-hero-scene-planner/contract.json +228 -0
  407. package/skills/product-hero-scene-planner/references/clarification-patterns.md +24 -0
  408. package/skills/product-hero-scene-planner/references/cyberpunk-shoe-example.md +28 -0
  409. package/skills/product-hero-scene-planner/references/product-hero-playbooks.md +22 -0
  410. package/skills/product-hero-scene-planner/references/scene-plan-schema.md +35 -0
  411. package/skills/r3f-component-plan/EVAL.md +43 -0
  412. package/skills/r3f-component-plan/SKILL.md +290 -0
  413. package/skills/r3f-component-plan/contract.json +171 -0
  414. package/skills/r3f-component-plan/references/component-shape-patterns.md +54 -0
  415. package/skills/r3f-component-plan/references/suspense-placement-rules.md +50 -0
  416. package/skills/r3f-component-plan/references/usegltf-caching-rules.md +53 -0
  417. package/skills/recipe-fit-assessor/EVAL.md +28 -0
  418. package/skills/recipe-fit-assessor/SKILL.md +266 -0
  419. package/skills/recipe-fit-assessor/contract.json +220 -0
  420. package/skills/recipe-fit-assessor/references/recipe-catalog.md +30 -0
  421. package/skills/recipe-fit-assessor/references/scope-gap-rules.md +27 -0
  422. package/skills/recipe-fit-assessor/references/workflow-recommendation-template.md +34 -0
  423. package/skills/render-export-evidence/EVAL.md +86 -0
  424. package/skills/render-export-evidence/SKILL.md +339 -0
  425. package/skills/render-export-evidence/contract.json +206 -0
  426. package/skills/render-export-evidence/references/attempted-vs-failed-rubric.md +75 -0
  427. package/skills/render-export-evidence/references/evidence-record-templates.md +143 -0
  428. package/skills/render-export-evidence/references/truth-label-decision-tree.md +57 -0
  429. package/skills/resolution-aspect-decision/EVAL.md +26 -0
  430. package/skills/resolution-aspect-decision/SKILL.md +246 -0
  431. package/skills/resolution-aspect-decision/contract.json +160 -0
  432. package/skills/resolution-aspect-decision/references/aspect-defaults.md +41 -0
  433. package/skills/resolution-aspect-decision/references/print-vs-screen-rules.md +58 -0
  434. package/skills/resolution-aspect-decision/references/resolution-defaults.md +64 -0
  435. package/skills/runtime-attempt-report/EVAL.md +26 -0
  436. package/skills/runtime-attempt-report/SKILL.md +268 -0
  437. package/skills/runtime-attempt-report/contract.json +176 -0
  438. package/skills/runtime-attempt-report/references/attempt-record-template.md +49 -0
  439. package/skills/runtime-attempt-report/references/triage-next-steps.md +15 -0
  440. package/skills/runtime-attempt-report/references/truth-label-blocks.md +27 -0
  441. package/skills/runtime-path-picker/EVAL.md +26 -0
  442. package/skills/runtime-path-picker/SKILL.md +268 -0
  443. package/skills/runtime-path-picker/contract.json +191 -0
  444. package/skills/runtime-path-picker/references/anti-patterns.md +14 -0
  445. package/skills/runtime-path-picker/references/decision-tree.md +29 -0
  446. package/skills/runtime-path-picker/references/path-constraints-table.md +18 -0
  447. package/skills/runtime-readiness/EVAL.md +33 -0
  448. package/skills/runtime-readiness/SKILL.md +218 -0
  449. package/skills/runtime-readiness/contract.json +190 -0
  450. package/skills/runtime-readiness/references/blocker-report-template.md +28 -0
  451. package/skills/runtime-readiness/references/evidence-examples.md +23 -0
  452. package/skills/runtime-readiness/references/readiness-matrix.md +46 -0
  453. package/skills/runtime-setup/EVAL.md +33 -0
  454. package/skills/runtime-setup/SKILL.md +209 -0
  455. package/skills/runtime-setup/contract.json +171 -0
  456. package/skills/runtime-setup/references/runtime-option-decision-tree.md +28 -0
  457. package/skills/runtime-setup/references/setup-summary-template.md +33 -0
  458. package/skills/runtime-setup/references/source-confidence-labels.md +23 -0
  459. package/skills/scene-readiness/EVAL.md +33 -0
  460. package/skills/scene-readiness/SKILL.md +195 -0
  461. package/skills/scene-readiness/contract.json +198 -0
  462. package/skills/scene-readiness/references/blocker-catalog.md +24 -0
  463. package/skills/scene-readiness/references/not-run-handling.md +22 -0
  464. package/skills/scene-readiness/references/quality-rubric.md +23 -0
  465. package/skills/scene-readiness/references/verdict-language.md +22 -0
  466. package/skills/scope-guard/EVAL.md +33 -0
  467. package/skills/scope-guard/SKILL.md +222 -0
  468. package/skills/scope-guard/contract.json +171 -0
  469. package/skills/scope-guard/references/options-language-template.md +51 -0
  470. package/skills/scope-guard/references/recurring-creep-patterns.md +55 -0
  471. package/skills/scope-guard/references/scope-addition-classification.md +55 -0
  472. package/skills/stage-gates/EVAL.md +40 -0
  473. package/skills/stage-gates/SKILL.md +257 -0
  474. package/skills/stage-gates/contract.json +490 -0
  475. package/skills/stage-gates/references/failed-gate-handling.md +42 -0
  476. package/skills/stage-gates/references/gate-template.md +46 -0
  477. package/skills/stage-gates/references/stage-decomposition-patterns.md +55 -0
  478. package/skills/workflow-stage-router/EVAL.md +25 -0
  479. package/skills/workflow-stage-router/SKILL.md +259 -0
  480. package/skills/workflow-stage-router/contract.json +150 -0
  481. package/skills/workflow-stage-router/references/milestone-model.md +20 -0
  482. package/skills/workflow-stage-router/references/routing-decision-tree.md +32 -0
  483. package/skills/workflow-stage-router/references/stage-handoff-template.md +37 -0
  484. package/skills.sh.json +102 -0
@@ -0,0 +1,92 @@
1
+ # Workflow: product-hero-workflow
2
+
3
+ Status: 1.0.0
4
+
5
+ ## Trigger
6
+
7
+ Use this workflow when a non-Blender user asks for a product hero 3D output with web-ready handoff expectations.
8
+
9
+ ## Inputs
10
+
11
+ - natural-language user prompt
12
+ - target output context (web/app/game/render)
13
+ - optional visual/style/performance constraints
14
+
15
+ ## Laws applied
16
+
17
+ - [../../laws/official-runtime-only.md](../../laws/official-runtime-only.md)
18
+ - [../../laws/no-arbitrary-python-interface.md](../../laws/no-arbitrary-python-interface.md)
19
+ - [../../laws/evidence-before-done.md](../../laws/evidence-before-done.md)
20
+ - [../../laws/non-blender-user-language.md](../../laws/non-blender-user-language.md)
21
+
22
+ ## Skills composed
23
+
24
+ - [../../skills/runtime-setup/SKILL.md](../../skills/runtime-setup/SKILL.md)
25
+ - [../../skills/product-hero-scene-planner/SKILL.md](../../skills/product-hero-scene-planner/SKILL.md)
26
+ - [../../skills/scene-readiness/SKILL.md](../../skills/scene-readiness/SKILL.md)
27
+ - [../../skills/glb-web-handoff/SKILL.md](../../skills/glb-web-handoff/SKILL.md)
28
+ - [../../skills/plain-language-response/SKILL.md](../../skills/plain-language-response/SKILL.md)
29
+
30
+ ## Stages
31
+
32
+ > [!NOTE]
33
+ > These are workflow stages (per-run pipeline steps). Project roadmap and release checks live in [`TODO.md`](../../TODO.md).
34
+
35
+ ### Stage 1 — Runtime readiness gate
36
+ - Confirm official runtime path selection.
37
+ - Capture source confidence (`verified-read` or `linked-only`).
38
+ - Block workflow if official runtime prerequisites are not acknowledged.
39
+
40
+ ### Stage 2 — Intent and plan
41
+ - Normalize intent.
42
+ - Ask minimal clarification questions.
43
+ - Build scene plan: composition, lighting, materials, camera, handoff intent.
44
+
45
+ ### Stage 3 — Quality gate
46
+ - Apply pass/warn/fail checks against requested intent.
47
+ - Identify blockers and unresolved risks.
48
+
49
+ ### Stage 4 — GLB/web handoff gate
50
+ - Prepare handoff expectation report.
51
+ - Record compatibility assumptions and caveats.
52
+
53
+ ### Stage 5 — Final non-Blender-user response
54
+ - Produce plain-language status and next actions.
55
+
56
+ ## Outputs
57
+
58
+ - intent summary
59
+ - scene plan
60
+ - quality gate report
61
+ - GLB/web handoff report
62
+ - final user-facing plain-language response
63
+
64
+ ## Validation gates
65
+
66
+ - Gate A: official runtime-only references present
67
+ - Gate B: scene plan completeness
68
+ - Gate C: quality checklist status assigned
69
+ - Gate D: handoff caveat transparency
70
+ - Gate E: non-Blender-user readability check
71
+
72
+ ## Failure modes
73
+
74
+ - runtime prerequisites unclear
75
+ - prompt ambiguity unresolved
76
+ - insufficient evidence for readiness claims
77
+ - handoff compatibility uncertainty
78
+
79
+ ## Runtime evidence expectations
80
+
81
+ Every run must capture:
82
+ - selected official runtime path
83
+ - source confidence level
84
+ - what was verified vs what remains linked-only
85
+ - text-only dry-eval marker when runtime is not executed (`Runtime status: Not Run`, `Artifact status: Not Produced`)
86
+
87
+ ## Final response format
88
+
89
+ 1. What you asked for
90
+ 2. What is ready now
91
+ 3. What is not fully verified yet
92
+ 4. Recommended next step
package/laws/README.md ADDED
@@ -0,0 +1,32 @@
1
+ # BlendOps Laws Collection
2
+
3
+ > [!NOTE]
4
+ > Status: 1.0.0. These laws are shared guardrails for installable Blender skills in `skills/` and pack manifests in `packs/`.
5
+
6
+ ## Law index
7
+
8
+ | Law | Doc | Protects |
9
+ |---|---|---|
10
+ | Official runtime only | [official-runtime-only](./official-runtime-only.md) | Keeps BlendOps aligned to official runtime paths only |
11
+ | No arbitrary Python interface | [no-arbitrary-python-interface](./no-arbitrary-python-interface.md) | Prevents arbitrary Python from becoming the user-facing workflow |
12
+ | Evidence before done | [evidence-before-done](./evidence-before-done.md) | Blocks artifact and runtime overclaims without evidence |
13
+ | Non-Blender-user language | [non-blender-user-language](./non-blender-user-language.md) | Keeps outputs clear for users who don't know Blender internals |
14
+
15
+ ## Scope
16
+
17
+ | Applies to | Requirement |
18
+ |---|---|
19
+ | Root-level skill units | Follow every relevant law during planning, validation, handoff, and final response. |
20
+ | Pack manifests | Include laws explicitly and preserve their constraints. |
21
+ | User-facing outputs | State artifact/runtime status truthfully and in plain language. |
22
+ | Install docs | Preserve no-runtime and no-global-config-by-default constraints. |
23
+
24
+ ## Status block
25
+
26
+ | Field | Value |
27
+ |---|---|
28
+ | Collection status | 1.0.0 |
29
+ | Runtime posture | Official-runtime-only |
30
+ | Runtime install | Not included |
31
+ | Runtime execution guarantee | Not claimed |
32
+ | Promotion requirement | Review and eval evidence must be recorded before any runtime/artifact claim |
@@ -0,0 +1,37 @@
1
+ # Law: evidence-before-done
2
+
3
+ Status: 1.0.0
4
+
5
+ ## Purpose
6
+ Block readiness/success claims that are not backed by evidence.
7
+
8
+ ## Applies to
9
+ All skills/workflows/evals/pack outputs.
10
+
11
+ ## Must do
12
+ - include artifact status (`Not Produced`, `Produced`, `Verified`, `Failed`)
13
+ - include runtime status (`Not Run`, `Attempted`, `Produced`, `Verified`, `Failed`)
14
+ - include verification outcomes
15
+ - include caveats for unresolved checks
16
+
17
+ ## Canonical truth states
18
+ - Runtime status: `Not Run`, `Attempted`, `Produced`, `Verified`, `Failed`.
19
+ - Artifact status: `Not Produced` by default; allowed values are `Not Produced`, `Produced`, `Verified`, `Failed` (`Not Run` is never an Artifact status).
20
+ - Do not invent other runtime states; a blocked environment stays `Not Run` (nothing attempted) or `Attempted` (started but incomplete).
21
+
22
+ ## Must not do
23
+ - must not claim preview/render/GLB exists without evidence
24
+ - must not mark Ready if evidence is missing
25
+
26
+ ## Blocking conditions
27
+ - success claim appears without artifact/evidence section
28
+
29
+ ## Validation
30
+ - pass/warn/fail present
31
+ - final verdict maps to evidence state
32
+
33
+ ## Good example
34
+ “Status: Conditionally Ready. Plan complete; Runtime status: Not Run; Artifact status: Not Produced.”
35
+
36
+ ## Bad example
37
+ “Everything exported and ready.” (no evidence)
@@ -0,0 +1,32 @@
1
+ # Law: no-arbitrary-python-interface
2
+
3
+ Status: 1.0.0
4
+
5
+ ## Purpose
6
+ Prevent arbitrary-code style final interfaces in user-facing BlendOps outputs.
7
+
8
+ This law governs the product surface, not execution sandboxing: it bans "paste this Python" as the user-facing flow, but it does not cover operator-side sandbox hygiene (trusted environment, secrets handling). Sandbox guidance lives in `runtime-readiness` and `runtime-attempt-report`.
9
+
10
+ ## Applies to
11
+ All skills/workflows/pack outputs.
12
+
13
+ ## Must do
14
+ - keep outputs workflow- and validation-driven
15
+ - keep runtime execution external and evidence-bound
16
+
17
+ ## Must not do
18
+ - must not present arbitrary Python execution as final user interface
19
+ - must not bypass law/validation gates with opaque low-level execution guidance
20
+
21
+ ## Blocking conditions
22
+ - output recommends arbitrary-code interface as normal user flow
23
+
24
+ ## Validation
25
+ - user-facing output is intent-first and constrained
26
+ - caveats are explicit when runtime certainty is missing
27
+
28
+ ## Good example
29
+ “BlendOps provides a structured plan and checks; runtime execution remains external.”
30
+
31
+ ## Bad example
32
+ “Paste and run arbitrary Python as the default BlendOps flow.”
@@ -0,0 +1,32 @@
1
+ # Law: non-blender-user-language
2
+
3
+ Status: 1.0.0
4
+
5
+ ## Purpose
6
+ Ensure user-facing outputs remain understandable for non-Blender users.
7
+
8
+ ## Applies to
9
+ All final summaries and user-facing response templates.
10
+
11
+ ## Must do
12
+ - use plain language first
13
+ - explain unavoidable technical terms briefly
14
+ - provide clear next actions
15
+
16
+ ## Must not do
17
+ - must not rely on dense Blender jargon
18
+ - must not present raw runtime logs as final explanation
19
+
20
+ ## Blocking conditions
21
+ - user-facing output cannot be understood without Blender internals
22
+
23
+ ## Validation
24
+ - summary is plain-language
25
+ - caveats and status are clear
26
+ - next actions are actionable
27
+
28
+ ## Good example
29
+ “Runtime was not executed yet (`Runtime status: Not Run`), so no output files were created (`Artifact status: Not Produced`).”
30
+
31
+ ## Bad example
32
+ “Deferred pipeline tangent-space mismatch requires shader graph remediation.”
@@ -0,0 +1,78 @@
1
+
2
+
3
+ # Law: official-runtime-only
4
+
5
+ Status: 1.0.0
6
+
7
+ ## Purpose
8
+
9
+ Ensure active skill outputs reference well-defined Blender runtime paths only and never invent or imply a runtime path that does not exist.
10
+
11
+ ## "Official" definition for this law
12
+
13
+ This law uses the term **"official"** to mean: the runtime path is documented by Anthropic, the Blender Foundation, or its mature published upstream maintainer; the source URL/repo can be linked; and the path is one of the two MCP paths (or the CLI appendix) listed in [`docs/runtime-stack-strategy.md`](../docs/runtime-stack-strategy.md).
14
+
15
+ The currently recognized paths are:
16
+
17
+ | Path | Provenance | "Official" status for this law |
18
+ |---|---|---|
19
+ | **Path 1** Official Blender Lab MCP (Lab add-on + Lab server in Blender; host = Anthropic Blender Connector OR manual MCP client) | Blender Foundation Lab (`bpype/blender_mcp`) for the Blender-side stack; Anthropic for host option (a) | Official — endorsed by Blender Foundation for the Blender side, and by Anthropic for host option (a). Anthropic Connector is **not** a separate runtime; it is one MCP host on top of Lab MCP. |
20
+ | **Path 2** Community `mcp-for-blender` | Community / `ahujasid` (mature prior art) | Third-party but **mature and recognized**; treated as a supported path in BlendOps with extra caveats in [`docs/unofficial-runtime-bridges.md`](../docs/unofficial-runtime-bridges.md). |
21
+ | **CLI fallback (appendix)** | Blender Foundation | Official source for `blender` CLI. **Documented upstream** as a first-class Blender CLI surface; BlendOps simply has no in-repo evidence file yet capturing a per-recipe CLI-fallback eval. Appendix only — not presented as a peer execution path of Path 1/2 because no in-repo eval record exists. |
22
+
23
+ What this law forbids:
24
+
25
+ - Inventing a runtime path that is not one of the above.
26
+ - Linking to non-public, non-listed, or speculative MCP forks.
27
+ - Implying that BlendOps owns or ships a runtime.
28
+ - Describing the Anthropic Connector as if it were standalone or as if it bypassed the Blender Lab MCP add-on. (It does not — Anthropic's tutorial step 2 explicitly tells you to install the Lab add-on inside Blender.)
29
+ - Applying a Blender version floor incorrectly across paths (the 5.1+ floor is bound to Path 1 because of the Lab add-on manifest; Path 2 is 3.0+; CLI is 4.2+ recommended).
30
+ - Presenting CLI fallback as a publisher-verified peer of Path 1 / Path 2.
31
+
32
+ What this law permits (clarified 2026-05-08, updated for the 2-path model):
33
+
34
+ - Documenting Path 2 with full setup instructions and tool surface, because it is the only currently user-verified BlendOps runtime path and the de facto standard for many MCP clients on older Blender.
35
+ - Listing both Path 1 (with both host options a/b) and Path 2 side-by-side in user-facing docs.
36
+ - Recording per-path verification status (`Not Verified`, `Read-only smoke`, `User-reported verified`, `Verified`, `Not Run`).
37
+
38
+ ## Applies to
39
+
40
+ All files under `skills/` and `packs/`.
41
+
42
+ ## Must do
43
+
44
+ - name the runtime path explicitly (Path 1 or Path 2) when discussing runtime steps; for Path 1 also name the host option (a — Anthropic Connector, b — manual MCP client) when relevant
45
+ - include source confidence (`verified-read`, `linked-only`, `unknown`) per claim
46
+ - defer exact setup details to the upstream tutorials when unverified
47
+ - treat CLI fallback as appendix, not peer
48
+
49
+ ## Must not do
50
+
51
+ - must not invent a runtime path outside the recognized set
52
+ - must not imply BlendOps owns a runtime
53
+ - must not invent setup commands/details
54
+ - must not describe Anthropic Connector as standalone or as not requiring the Lab add-on inside Blender
55
+ - must not loosen the Blender 5.1+ floor for Path 1 (regardless of host option)
56
+ - must not call Path 2 "experimental" in a way that implies engineering immaturity (it is a mature prior-art project; the caveat is provenance, not maturity)
57
+ - must not present CLI fallback as publisher-verified
58
+
59
+ ## Blocking conditions
60
+
61
+ - runtime setup instruction references a path outside the recognized set
62
+ - runtime setup claim lacks confidence/caveat
63
+ - a per-path property is mis-attributed (e.g., Anthropic Connector framed as Blender-4.2+-enough)
64
+
65
+ ## Validation
66
+
67
+ - official source links present per path mentioned (Anthropic tutorial + Lab MCP for Path 1; `mcp-for-blender` for Path 2; Blender CLI docs for CLI appendix)
68
+ - no invented runtime path references
69
+ - confidence labels used when needed
70
+ - per-path Blender-version requirement is correctly attributed (Path 1 → 5.1+; Path 2 → 3.0+; CLI → 4.2+ recommended, not verified)
71
+
72
+ ## Good example
73
+
74
+ "Path 1 with host option (a) Anthropic Connector requires Blender 5.1+ because the Lab MCP add-on it depends on declares `blender_version_min = 5.1.0`. Source confidence: linked-only for Anthropic tutorial, linked-only for Lab MCP page."
75
+
76
+ ## Bad example
77
+
78
+ "Use the Anthropic Connector path; Blender 4.2+ is enough." (mis-attributes the version floor; ignores that Anthropic's own tutorial tells you to install the Lab add-on which requires 5.1+)
package/package.json CHANGED
@@ -1,6 +1,101 @@
1
1
  {
2
2
  "name": "blendops",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
3
+ "version": "1.0.0",
4
+ "description": "AI-native Blender workflow, knowledge catalog, and portable skill pack for non-Blender users. Ships 48 Anthropic Skills, 4 hard guardrail laws, 10 canonical recipes, deterministic SceneSpec/ExecutionPlan compilation, MCP runtime qualification, GLB inspection, and 26+ agent install targets.",
5
+ "homepage": "https://github.com/ThanhNguyxnOrg/blendops#readme",
6
+ "repository": {
7
+ "type": "git",
8
+ "url": "https://github.com/ThanhNguyxnOrg/blendops.git"
9
+ },
10
+ "bugs": {
11
+ "url": "https://github.com/ThanhNguyxnOrg/blendops/issues"
12
+ },
13
+ "license": "MIT",
14
+ "keywords": [
15
+ "blender",
16
+ "blender-mcp",
17
+ "claude",
18
+ "claude-skills",
19
+ "anthropic-skills",
20
+ "openai-skills",
21
+ "ai-agent",
22
+ "mcp",
23
+ "model-context-protocol",
24
+ "workflow",
25
+ "3d",
26
+ "glb",
27
+ "non-blender-user"
28
+ ],
29
+ "engines": {
30
+ "node": ">=20.0.0"
31
+ },
32
+ "bin": {
33
+ "blendops": "bin/blendops.mjs"
34
+ },
35
+ "files": [
36
+ "bin/",
37
+ "scripts/install-skills.mjs",
38
+ "scripts/build-knowledge-catalog.mjs",
39
+ "scripts/compile-scene-plan.mjs",
40
+ "scripts/runtime-orchestrator.mjs",
41
+ "scripts/validate-capability-policy.mjs",
42
+ "scripts/validate-evidence-packet.mjs",
43
+ "scripts/export-claude-skills.mjs",
44
+ "scripts/inspect-glb.mjs",
45
+ "scripts/generate-glb-handoff-report.mjs",
46
+ "docs/knowledge-and-recipe-catalog.md",
47
+ "docs/recipes/",
48
+ "docs/workflows/",
49
+ "docs/examples/glb-web-handoff/",
50
+ "skills/",
51
+ "laws/",
52
+ "packs/",
53
+ "bundles/generic-project-local/",
54
+ "bundles/claude-desktop-manual/",
55
+ "bundles/skill-package/",
56
+ "registry/",
57
+ "schemas/",
58
+ "skills.sh.json",
59
+ "README.md",
60
+ "LICENSE",
61
+ "CHANGELOG.md"
62
+ ],
63
+ "scripts": {
64
+ "dev": "node scripts/dev-server.mjs",
65
+ "start": "node scripts/dev-server.mjs",
66
+ "build": "npm run ci",
67
+ "catalog:build": "node scripts/build-knowledge-catalog.mjs --build",
68
+ "catalog:check": "node scripts/build-knowledge-catalog.mjs --check",
69
+ "catalog:eval": "node scripts/build-knowledge-catalog.mjs --eval",
70
+ "plan:compile": "node scripts/compile-scene-plan.mjs",
71
+ "operations:check": "node scripts/runtime-orchestrator.mjs --check",
72
+ "registry:build": "node scripts/build-registry.mjs",
73
+ "registry:check": "node scripts/build-registry.mjs --check",
74
+ "evals:build": "node scripts/run-evals.mjs --build",
75
+ "evals:check": "node scripts/run-evals.mjs --check",
76
+ "evals:list": "node scripts/run-evals.mjs --list",
77
+ "evals:run": "node scripts/run-evals.mjs",
78
+ "bundles:summaries:build": "node scripts/generate-bundle-reference-summaries.mjs",
79
+ "bundles:summaries:check": "node scripts/generate-bundle-reference-summaries.mjs --check",
80
+ "skills:install": "node scripts/install-skills.mjs",
81
+ "glb:inspect": "node scripts/inspect-glb.mjs",
82
+ "glb:handoff": "node scripts/generate-glb-handoff-report.mjs",
83
+ "arch:build": "node scripts/validate-repository-architecture.mjs",
84
+ "arch:check": "node scripts/validate-repository-architecture.mjs --check",
85
+ "test": "node --test scripts/test-skills-export.mjs scripts/test-routing-contracts.mjs scripts/test-behavioral-evals.mjs scripts/test-skill-templates.mjs scripts/test-catalog-contracts.mjs scripts/test-eval-coverage.mjs scripts/test-adapter-matrix.mjs scripts/test-bundle-summaries.mjs scripts/test-dev-server.mjs scripts/test-project-installer.mjs scripts/test-cli-package.mjs scripts/test-glb-handoff.mjs scripts/test-repository-architecture.mjs scripts/test-knowledge-catalog.mjs scripts/test-scene-spec-harmonizer.mjs scripts/test-runtime-orchestrator.mjs scripts/test-runtime-hardening.mjs scripts/test-mcp-qualification.mjs scripts/test-mcp-client-skills-sh.mjs",
86
+ "docs:check": "node scripts/check-docs.mjs",
87
+ "skills:export": "node scripts/export-claude-skills.mjs",
88
+ "ci": "npm run docs:check && npm run catalog:check && npm run operations:check && npm run arch:check && npm run registry:check && npm run evals:check && npm run evals:run && npm run bundles:summaries:check && npm run skills:export && npm test",
89
+ "audit:sync-digest": "node scripts/sync-current-audit-digest.mjs"
90
+ },
91
+ "dependencies": {
92
+ "@modelcontextprotocol/sdk": "1.32.2",
93
+ "ajv": "8.20.0",
94
+ "fflate": "0.8.3",
95
+ "zod": "4.6.7"
96
+ },
97
+ "devDependencies": {},
98
+ "publishConfig": {
99
+ "access": "public"
100
+ }
101
+ }
@@ -0,0 +1,11 @@
1
+ # BlendOps Packs
2
+
3
+ Status: 1.0.0
4
+
5
+ Packs compose multiple skills and shared laws into versioned bundles.
6
+
7
+ Packs are not runtime code and do not install/run Blender.
8
+
9
+ ## Pack index
10
+
11
+ - [product-hero-v0/PACK.md](./product-hero-v0/PACK.md)
@@ -0,0 +1,114 @@
1
+ # PACK: product-hero-v0
2
+
3
+ > [!NOTE]
4
+ > Status: 1.0.0. This pack composes laws and skills for product-hero planning, validation, and handoff under official-runtime-only boundaries (retaining canonical pack identifier `product-hero-v0`).
5
+
6
+ ## Pack status
7
+
8
+ | Field | Value |
9
+ |---|---|
10
+ | Pack name | `product-hero-v0` |
11
+ | Version | `1.0.0` |
12
+ | Release posture | Production (`v1.0.0`) |
13
+ | Runtime posture | Official-runtime-only |
14
+ | Runtime install | Not included |
15
+ | Runtime execution guarantee | Not claimed |
16
+ | Artifact guarantee | Not claimed without evidence |
17
+
18
+ ## Intended workflow
19
+
20
+ Compose the included skills to plan, validate, and communicate product-hero Blender/web-3D outcomes under official-runtime-only boundaries.
21
+
22
+ | Stage | Skill family | Output |
23
+ |---|---|---|
24
+ | Help | Next-step routing skill | Safe entrypoint and skill/doc handoff |
25
+ | Setup | Runtime setup and readiness skills | Prerequisites, confidence labels, blockers |
26
+ | Planning | Product, camera, lighting, and material planners | Structured scene/workflow plan |
27
+ | Quality | Scene quality and render/export evidence skills | Pass/warn/fail readiness verdict and artifact truth labels |
28
+ | Handoff | GLB/web and response writer skills | Plain-language status and web handoff notes |
29
+
30
+ ## Included laws
31
+
32
+ | Law | Path |
33
+ |---|---|
34
+ | Official runtime only | `../../laws/official-runtime-only.md` |
35
+ | No arbitrary Python interface | `../../laws/no-arbitrary-python-interface.md` |
36
+ | Evidence before done | `../../laws/evidence-before-done.md` |
37
+ | Non-Blender-user language | `../../laws/non-blender-user-language.md` |
38
+
39
+ ## Included skills
40
+
41
+ | Category | Skill path | Status |
42
+ |---|---|---|
43
+ | Help / routing | `../../skills/blendops-help/SKILL.md` | 1.0.0 |
44
+ | Process / discipline (Superpowers + BMad inspired) | `../../skills/blender-brainstorming/SKILL.md` | 1.0.0 |
45
+ | Process / discipline | `../../skills/intent-to-3d-brief-writer/SKILL.md` | 1.0.0 |
46
+ | Process / discipline | `../../skills/asset-discovery/SKILL.md` | 1.0.0 |
47
+ | Setup / readiness | `../../skills/runtime-setup/SKILL.md` | 1.0.0 |
48
+ | Setup / readiness | `../../skills/runtime-readiness/SKILL.md` | 1.0.0 |
49
+ | Setup / readiness | `../../skills/bridge-conflicts/SKILL.md` | 1.0.0 |
50
+ | Planning | `../../skills/product-hero-scene-planner/SKILL.md` | 1.0.0 |
51
+ | Planning | `../../skills/camera-composition/SKILL.md` | 1.0.0 |
52
+ | Planning | `../../skills/lighting-material-plan/SKILL.md` | 1.0.0 |
53
+ | Quality / eval | `../../skills/scene-readiness/SKILL.md` | 1.0.0 |
54
+ | Quality / debugging | `../../skills/blender-troubleshooting/SKILL.md` | 1.0.0 |
55
+ | Quality / evidence | `../../skills/render-export-evidence/SKILL.md` | 1.0.0 |
56
+ | Quality / pre-handoff | `../../skills/pre-handoff-verification/SKILL.md` | 1.0.0 |
57
+ | Handoff / communication | `../../skills/glb-web-handoff/SKILL.md` | 1.0.0 |
58
+ | Handoff / communication | `../../skills/plain-language-response/SKILL.md` | 1.0.0 |
59
+
60
+ ## Recipe scenario
61
+
62
+ | Scenario | Status |
63
+ |---|---|
64
+ | Cyberpunk shoe hero planning and handoff | Text-only and planning flow supported; runtime output not claimed |
65
+
66
+ ## Activation prompt
67
+
68
+ ```txt
69
+ Use the product-hero-v0 pack to plan a cyberpunk shoe web hero. Do not run Blender unless official runtime is available.
70
+ ```
71
+
72
+ ## Required review gates
73
+
74
+ This pack expects included skills to pass Gate 0 through Gate 8 in `skill-reviews/review-gates.md`.
75
+
76
+ ## Eval expectations
77
+
78
+ | Expectation | Status language |
79
+ |---|---|
80
+ | Per-skill evals | Each included skill ships `SKILL.md`, `contract.json`, `EVAL.md`, `evals/suites/<id>.eval.json`, and 3+ `references/` files. |
81
+ | Automated deterministic evals | Verified across all 48 catalog skills (`269/269` deterministic cases via `npm run evals:run`). |
82
+ | Runtime blockers | Must be recordable without overclaims. |
83
+ | Depth audit | Tracked in `skill-reviews/reports/v0-skill-depth-audit.md`. |
84
+ | Gate review | Tracked in `skill-reviews/reports/v0-skill-gate-review.md`. |
85
+
86
+ ## Release readiness checklist
87
+
88
+ - [ ] all included skills pass review gates or have explicit warnings
89
+ - [ ] no uncaveated Path 2 references; CLI appendix never a peer path
90
+ - [ ] no artifact overclaims without evidence
91
+ - [ ] install dry-run in disposable fixture succeeds
92
+ - [ ] rollback instructions validated
93
+ - [ ] runtime eval findings integrated
94
+
95
+ ## Non-goals
96
+
97
+ | Non-goal | Meaning |
98
+ |---|---|
99
+ | No runtime installation | The pack doesn't install Blender or runtime connectors. |
100
+ | No runtime execution guarantees | The pack doesn't claim Blender execution works. |
101
+ | No custom CLI/MCP/addon runtime ownership | BlendOps remains a product/workflow layer. |
102
+
103
+ ## Verification expectations
104
+
105
+ | Expectation | Required behavior |
106
+ |---|---|
107
+ | Law compliance | All outputs follow included laws. |
108
+ | Evidence before done | No artifact or runtime success claims without evidence. |
109
+ | Artifact status | Use `Produced`, `Not Produced`, `Verified`, or `Failed` (`Not Run` is reserved exclusively for Runtime/Eval status). |
110
+ | Plain language | Preserve non-Blender-user clarity. |
111
+
112
+ ## Release gates
113
+
114
+ Review gates (`Gate 0` through `Gate 8`), `npm run ci`, and deterministic behavioral evaluations must remain green across every skill and pack change; live runtime/artifact claims remain gated on recorded evidence under `docs/evals/`.