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,63 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/runtime-setup/SKILL.md and skills/runtime-setup/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # runtime-setup (reference summary)
3
+
4
+ ## Purpose
5
+ Establish official runtime prerequisites and setup boundaries before any Blender execution claim.
6
+
7
+ Establish runtime setup prerequisites, per-path minimum versions, source-confidence labels, truth-state defaults, and single-bridge boundaries before any Blender execution claim.
8
+
9
+ ## Metadata & truth boundary
10
+ - **Canonical skill:** `skills/runtime-setup/SKILL.md`
11
+ - **Contract:** `skills/runtime-setup/contract.json` (`v1.0.0`)
12
+ - **Category / role:** `runtime-and-execution` / `path-1-and-2-setup-instructor`
13
+ - **Capability tier:** `L0`
14
+ - **Truth-state policy:** Runtime status defaults to `Not Run`; Artifact status defaults to `Not Produced`; mutation rule is `downgrade_only` (never upgrade without verified evidence).
15
+
16
+ ## When to use
17
+ - beginning of a Blender-related task before any runtime path is executed
18
+ - user asks what prerequisites, version floors, or setup boundaries apply
19
+ - framing official vs third-party vs CLI appendix constraints before handoff
20
+
21
+ ## Trigger cues
22
+ - "set up Blender runtime prerequisites"
23
+ - "what are the Blender runtime setup boundaries"
24
+ - "prepare Official Blender Lab MCP setup prerequisites"
25
+ - "runtime prerequisites and version minimums"
26
+
27
+ ## When not to use
28
+ - to install or configure a runtime automatically → delegate to `runtime-path-picker` (`references/skills/runtime-path-picker.md`; Delegates out-of-scope requests to runtime-path-picker)
29
+ - to claim runtime execution has already succeeded → delegate to `path-one-host-outline` (`references/skills/path-one-host-outline.md`; Delegates out-of-scope requests to path-one-host-outline)
30
+ - to choose a runtime path → delegate to `runtime-readiness` (`references/skills/runtime-readiness.md`; runtime-readiness)
31
+
32
+ ## Inputs & output/evidence contract
33
+ ### Required inputs
34
+ - `selected_runtime_path` (`string`): Chosen execution path from runtime-path-picker (Path 1 Lab MCP, Path 2 mcp-for-blender, or CLI appendix)
35
+ - `host_client_environment` (`string`): User MCP host application (Claude Desktop Connector, Claude Code, Cursor, Windsurf, or manual client)
36
+
37
+ ### Optional inputs
38
+ - `installed_blender_version` (`string`): Installed Blender version used to check the Blender 5.1+ floor for Path 1 vs 3.0+ for Path 2
39
+
40
+ ### Primary outputs
41
+ - `step_by_step_setup_prerequisites`
42
+ - `path_version_and_host_boundary_notes`
43
+ - `readiness_verification_handoff`
44
+
45
+ ## Quick-start procedure
46
+ 1. confirm this skill fits your goal
47
+ 2. provide required inputs first
48
+ 3. keep runtime claims evidence-bound
49
+ 4. follow suggested next-skill handoff
50
+
51
+ ## Handoff notes
52
+ - **[upstream_reference]** Path selection → `runtime-path-picker` (`references/skills/runtime-path-picker.md`) — `when.all: [runtime.path equals "unselected"]`
53
+ - **[progression]** Path 1 host (a)/(b) details → `path-one-host-outline` (`references/skills/path-one-host-outline.md`) — `when.all: [runtime.path equals "path_1"; stage.current equals "runtime_setup"]`
54
+ - **[progression]** CLI appendix job structure → `cli-appendix-job-outline` (`references/skills/cli-appendix-job-outline.md`) — `when.all: [runtime.path equals "cli_appendix"; request.topic equals "cli_batch"]`
55
+ - **[fallback]** Bridge conflict resolution → `bridge-conflicts` (`references/skills/bridge-conflicts.md`) — `when.all: [runtime.conflictDetected equals true]`
56
+ - **[progression]** Readiness matrix check → `runtime-readiness` (`references/skills/runtime-readiness.md`) — `when.all: [runtime.path not_equals "unselected"; runtime.verifiedReady equals false]`
57
+ - **[alternative]** Scene planning after readiness → `product-hero-scene-planner` (`references/skills/product-hero-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.domain equals "product_hero"]`
58
+
59
+ ## Safety boundaries & non-goals
60
+ - **Runtime boundary:** - This skill does not install or configure Blender runtime. - This skill does not run Blender or emit Python. - This skill does not provide custom CLI/MCP/addon runtime. - This skill frames **two MCP execution paths plus a CLI fallback appendix** (see `docs/runtime-stack-strategy.md`): - **Path 1 — Official Blender Lab MCP** (in Blender 5.1+, add-on manifest literal `blender_version_min = "5.1.0"`, hosted from either (a) Anthropic Connector in Claude Desktop OR (b) any manually configured MCP client). The Anthropic Connector is **not** standalone — Anthropic's tutorial step 2 installs the Lab add-on inside Blender; although the tutorial prerequisite says "Blender 4.2 or later", the binding floor is **Blender 5.1+**. Sources: https://claude.com/resources/tutorials/using-the-blender-connector-in-claude (host a), https://www.blender.org/lab/mcp-server/ (Blender side, both hosts). - **Path 2 — Community `mcp-for-blender` (renamed from `ahujasid/blender-mcp`)** (third-party, minimum **Blender 3.0+**, exposes nine tools including `get_scene_info` and `execute_blender_code`). Use **only with caveats** and **never as release evidence**. Source: https://github.com/ahujasid/mcp-for-blender - **CLI fallback (appendix only)** — direct `blender --background --python`, **never a peer path without an eval record**. Documented flags: `--background`, `--python`, `-E/--engine` (run `blender -E help` for exact engine tokens; Eevee token is `BLENDER_EEVEE` on 4.0–4.1 and 5.x, `BLENDER_EEVEE_NEXT` on 4.2–4.x). Source: https://docs.blender.org/manual/en/latest/advanced/command_line/index.html
61
+ - runtime installer creation
62
+ - runtime execution automation
63
+ - custom runtime ownership
@@ -0,0 +1,65 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/scene-readiness/SKILL.md and skills/scene-readiness/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # scene-readiness (reference summary)
3
+
4
+ ## Purpose
5
+ Apply multi-category readiness gates with pass/warn/fail and evidence-bound verdicts.
6
+
7
+ Evaluate scene/workflow readiness honestly and consistently before any success claim.
8
+
9
+ ## Metadata & truth boundary
10
+ - **Canonical skill:** `skills/scene-readiness/SKILL.md`
11
+ - **Contract:** `skills/scene-readiness/contract.json` (`v1.0.0`)
12
+ - **Category / role:** `quality-validators` / `holistic-scene-readiness-aggregator`
13
+ - **Capability tier:** `L0`
14
+ - **Truth-state policy:** Runtime status defaults to `Not Run`; Artifact status defaults to `Not Produced`; mutation rule is `downgrade_only` (never upgrade without verified evidence).
15
+
16
+ ## When to use
17
+ - before readiness, export, or handoff claims to get a broad multi-category review
18
+ - after planning passes or after focused domain checkers have run
19
+ - during text-only or runtime evaluation reporting
20
+
21
+ ## Trigger cues
22
+ - "quality-check this scene"
23
+ - "is this ready"
24
+ - "evaluate pass warn fail"
25
+
26
+ ## When not to use
27
+ - as a replacement for evidence collection → delegate to `product-hero-scene-planner` (`references/skills/product-hero-scene-planner.md`; Delegates out-of-scope requests to product-hero-scene-planner)
28
+ - to fabricate confidence in missing artifacts → delegate to `lighting-material-plan` (`references/skills/lighting-material-plan.md`; Delegates out-of-scope requests to lighting-material-plan)
29
+
30
+ ## Inputs & output/evidence contract
31
+ ### Required inputs
32
+ - `scene_plan_and_specialist_verdicts` (`object`): Scene specification plus specialist rows from material, lighting, composition, and polycount checkers
33
+ - `acceptance_criteria_table` (`object`): Measurable Pass/Warn/Fail thresholds for the target deliverable
34
+
35
+ ### Optional inputs
36
+ - `preview_or_inspection_notes` (`object`): Optional read-only scene inspection summary or viewport preview notes
37
+
38
+ ### Primary outputs
39
+ - `holistic_scene_quality_verdict`
40
+ - `aggregated_pass_warn_fail_table`
41
+ - `blocking_defect_remediation_route`
42
+
43
+ ## Quick-start procedure
44
+ 1. confirm this skill fits your goal
45
+ 2. provide required inputs first
46
+ 3. keep runtime claims evidence-bound
47
+ 4. follow suggested next-skill handoff
48
+
49
+ ## Handoff notes
50
+ - **[upstream_reference]** Focused domain validation (if gaps found) (composition-quality-checker) → `composition-quality-checker` (`references/skills/composition-quality-checker.md`) — `when.all: [quality.domain equals "composition"; quality.verdict equals "not_run"]`
51
+ - **[upstream_reference]** Focused domain validation (if gaps found) (lighting-quality-checker) → `lighting-quality-checker` (`references/skills/lighting-quality-checker.md`) — `when.all: [quality.domain equals "lighting"; quality.verdict equals "not_run"]`
52
+ - **[upstream_reference]** Focused domain validation (if gaps found) (material-quality-checker) → `material-quality-checker` (`references/skills/material-quality-checker.md`) — `when.all: [quality.domain equals "material"; quality.verdict equals "not_run"]`
53
+ - **[upstream_reference]** Focused domain validation (if gaps found) (polycount-budget-checker) → `polycount-budget-checker` (`references/skills/polycount-budget-checker.md`) — `when.all: [quality.domain equals "polycount"; budget.verdict equals "Not Run"]`
54
+ - **[progression]** Evidence classification → `render-export-evidence` (`references/skills/render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
55
+ - **[progression]** Handoff gate → `pre-handoff-verification` (`references/skills/pre-handoff-verification.md`) — `when.all: [stage.current equals "final_verification"]`
56
+ - **[conditional]** Web delivery (when applicable) → `glb-web-handoff` (`references/skills/glb-web-handoff.md`) — `when.all: [artifact.type equals "glb"; handoff.consumerStack equals "web_glb"]`
57
+ - **[progression]** Final communication → `plain-language-response` (`references/skills/plain-language-response.md`) — `when.all: [stage.current equals "final_communication"]`
58
+
59
+ ## Safety boundaries & non-goals
60
+ - **Runtime boundary:** Review-only skill: never executes Blender, never runs or emits Python, and never produces artifacts. Runtime truth state stays `Not Run` unless a real attempt was recorded; artifact truth state defaults to `Not Produced` unless concrete output evidence from the current run exists. Truth states are downgrade-only (never upgrade). Text-only and blocked modes must remain explicit.
61
+ - executing Blender or running/generating Python code
62
+ - producing or classifying raw render/export artifacts (owned by `render-export-evidence`)
63
+ - replacing focused domain validators (`material-quality-checker`, `lighting-quality-checker`, `composition-quality-checker`, `polycount-budget-checker`)
64
+ - owning final handoff gating (`pre-handoff-verification`) or web handoff packaging (`glb-web-handoff`)
65
+ - making evidence-free readiness claims
@@ -0,0 +1,62 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/scope-guard/SKILL.md and skills/scope-guard/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # scope-guard (reference summary)
3
+
4
+ ## Purpose
5
+ Detect mid-recipe scope creep and push back constructively before the recipe drifts; require explicit user agreement before scope expansion.
6
+
7
+ Catch mid-flight scope creep ("can you also do X?") and force an explicit recorded decision: (a) decline the expansion, (b) add now with explicit user agreement (updating the stop condition and stage gates), or (c) defer to a follow-up recipe. Prevents silent absorption that breaks gates and stop conditions. Trivial in-gate items may be absorbed only when existing gate criteria explicitly cover them — never by feel.
8
+
9
+ ## Metadata & truth boundary
10
+ - **Canonical skill:** `skills/scope-guard/SKILL.md`
11
+ - **Contract:** `skills/scope-guard/contract.json` (`v1.0.0`)
12
+ - **Category / role:** `process-discipline` / `scope-creep-and-change-request-guard`
13
+ - **Capability tier:** `L0`
14
+ - **Truth-state policy:** Runtime status defaults to `Not Run`; Artifact status defaults to `Not Produced`; mutation rule is `downgrade_only` (never upgrade without verified evidence).
15
+
16
+ ## When to use
17
+ - mid-recipe, when user adds new requests beyond the brief
18
+ - when "while we're at it" appears
19
+ - when stages start exceeding their gates "just a bit"
20
+
21
+ ## Trigger cues
22
+ - "can you also"
23
+ - "while you're at it"
24
+ - "actually let's also"
25
+ - "one more thing"
26
+
27
+ ## When not to use
28
+ - early planning before scope is pinned → delegate to `done-criteria` (`references/skills/done-criteria.md`; use intent-to-3d-brief-writer and done-criteria)
29
+ - pure brainstorming with no active recipe → delegate to `blender-brainstorming` (`references/skills/blender-brainstorming.md`; use blender-brainstorming)
30
+ - when the addition is already explicitly covered by existing gate criteria in stage-gates / acceptance-criteria-builder (verified against w → delegate to `acceptance-criteria-builder` (`references/skills/acceptance-criteria-builder.md`; verified against written criteria, never judged by feel)
31
+
32
+ ## Inputs & output/evidence contract
33
+ ### Required inputs
34
+ - `locked_baseline_brief` (`object`): Currently locked 3D brief, acceptance criteria, and stop conditions
35
+ - `proposed_scope_change` (`string`): Mid-workflow user request adding new deliverables, environments, animations, or scope
36
+
37
+ ### Optional inputs
38
+ - `current_workflow_stage` (`string`): Active stage when the scope expansion was requested
39
+
40
+ ### Primary outputs
41
+ - `scope_classification_verdict`
42
+ - `impact_on_locked_brief_and_budget`
43
+ - `defer_split_or_reopen_decision`
44
+
45
+ ## Quick-start procedure
46
+ 1. when scope drift is detected, name it
47
+ 2. offer 3 options: decline / explicit-add-now (with agreement) / defer to follow-up recipe
48
+ 3. record the decision before proceeding
49
+
50
+ ## Handoff notes
51
+ - **[upstream_reference]** Original brief → `intent-to-3d-brief-writer` (`references/skills/intent-to-3d-brief-writer.md`) — `when.all: [goal.clarity equals "clear"; brief.locked equals false]`
52
+ - **[upstream_reference]** Stop condition pinned beforehand / updated on expansion → `done-criteria` (`references/skills/done-criteria.md`) — `when.all: [brief.locked equals true; stage.current equals "stop_condition"]`
53
+ - **[upstream_reference]** Per-stage gates enforced / updated on expansion → `stage-gates` (`references/skills/stage-gates.md`) — `when.all: [brief.locked equals true; stage.current equals "stage_gates"]`
54
+ - **[boundary_delegation]** Measurable acceptance rows for added scope → `acceptance-criteria-builder` (`references/skills/acceptance-criteria-builder.md`) — `when.all: [brief.locked equals true; stage.current equals "acceptance_criteria"]`
55
+ - **[boundary_delegation]** Deferred scope split into follow-up recipes → `blender-recipe-decomposer` (`references/skills/blender-recipe-decomposer.md`) — `when.all: [fit.multiDeliverableDetected equals true]`
56
+ - **[progression]** Delivery gate after scope and gates settle → `pre-handoff-verification` (`references/skills/pre-handoff-verification.md`) — `when.all: [stage.current equals "final_verification"]`
57
+
58
+ ## Safety boundaries & non-goals
59
+ - **Runtime boundary:** Process / discipline skill — does not run Blender or execute Python. Decisions govern scope boundaries, stop conditions, and stage gates. A scope decision never upgrades runtime (`Not Run | Attempted | Produced | Verified | Failed`) or artifact (`Not Run | Not Produced | Produced | Verified | Failed`, default `Not Produced`) truth states; truth-state changes are downgrade-only (for example, when added scope invalidates a previously satisfied gate).
60
+ - Run Blender.
61
+ - Author the recipe.
62
+ - Decide for the user (the user picks among options).
@@ -0,0 +1,91 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/stage-gates/SKILL.md and skills/stage-gates/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # stage-gates (reference summary)
3
+
4
+ ## Purpose
5
+ Define explicit per-stage gates and acceptance checklists before any modeling, render, or export work — work only proceeds gate by gate.
6
+
7
+ Enforce a checklist-driven discipline where every stage of a Blender recipe (brief → asset → scene → render → export → handoff) has a written acceptance gate. Work does not advance until the previous stage's gate is checked off. Inspired by Anthropic Superpowers `/test-driven-development` analog: gate first, work second.
8
+
9
+ ## Metadata & truth boundary
10
+ - **Canonical skill:** `skills/stage-gates/SKILL.md`
11
+ - **Contract:** `skills/stage-gates/contract.json` (`v1.0.0`)
12
+ - **Category / role:** `process-discipline` / `stage-gate-checklist-enforcer`
13
+ - **Capability tier:** `L0`
14
+ - **Truth-state policy:** Runtime status defaults to `Not Run`; Artifact status defaults to `Not Produced`; mutation rule is `downgrade_only` (never upgrade without verified evidence).
15
+
16
+ ## When to use
17
+ - complex multi-stage recipe (4+ distinct stages) requiring per-stage gate enforcement
18
+ - when work must be locked behind explicit `Pending | Pass | Fail | Blocked` stage gates before advancing
19
+ - when the user wants verifiable proof that each stage passes its checks before starting the next stage
20
+ - before any runtime work begins, to lock concrete checks, required evidence, and failure exits per stage
21
+
22
+ ## Trigger cues
23
+ - "let's do this step by step"
24
+ - "what's done before we move on"
25
+ - "checklist for this work"
26
+ - "I want to make sure each stage is solid"
27
+
28
+ ## When not to use
29
+ - single-step requests → delegate to `blender-brainstorming` (`references/skills/blender-brainstorming.md`; Delegates out-of-scope requests to blender-brainstorming)
30
+ - pure exploratory brainstorming → delegate to `blender-brainstorming` (`references/skills/blender-brainstorming.md`; use blender-brainstorming)
31
+ - decomposing a brief into stages → delegate to `blender-recipe-decomposer` (`references/skills/blender-recipe-decomposer.md`; use blender-recipe-decomposer)
32
+ - writing measurable acceptance criteria rows from scratch → delegate to `acceptance-criteria-builder` (`references/skills/acceptance-criteria-builder.md`; use acceptance-criteria-builder)
33
+ - pinning the overall done/stop condition → delegate to `done-criteria` (`references/skills/done-criteria.md`; use done-criteria)
34
+ - guarding against mid-flight scope creep → delegate to `scope-guard` (`references/skills/scope-guard.md`; use scope-guard)
35
+ - selecting which skill runs next across the workflow → delegate to `workflow-stage-router` (`references/skills/workflow-stage-router.md`; use workflow-stage-router)
36
+ - fixing repeated stage failures or broken renders → delegate to `blender-troubleshooting` (`references/skills/blender-troubleshooting.md`; use blender-troubleshooting)
37
+ - executing the final 7-point handoff gate → delegate to `pre-handoff-verification` (`references/skills/pre-handoff-verification.md`; use pre-handoff-verification)
38
+
39
+ ## Inputs & output/evidence contract
40
+ ### Required inputs
41
+ - `active_workflow_stages` (`array`): Ordered stages of the selected BlendOps recipe or custom workflow
42
+ - `locked_acceptance_criteria` (`object`): Measurable acceptance rows from acceptance-criteria-builder
43
+
44
+ ### Optional inputs
45
+ - `current_stage_status` (`string`): Current stage progress and completed gate checks
46
+
47
+ ### Primary outputs
48
+ - `stage_gate_checklists`
49
+ - `entry_and_exit_preconditions`
50
+ - `gate_failure_routing_rules`
51
+
52
+ ## Quick-start procedure
53
+ 1. list the stages of the user's recipe
54
+ 2. write the gate per stage (specific, checkable conditions)
55
+ 3. run the gate after each stage; do not proceed if it fails
56
+ 4. record the gate result + evidence per stage
57
+
58
+ ## Handoff notes
59
+ - **[upstream_reference]** Brainstorming → `blender-brainstorming` (`references/skills/blender-brainstorming.md`) — `when.all: [goal.clarity equals "ambiguous_or_mixed"]`
60
+ - **[upstream_reference]** Brief authoring → `intent-to-3d-brief-writer` (`references/skills/intent-to-3d-brief-writer.md`) — `when.all: [goal.clarity equals "clear"; brief.locked equals false]`
61
+ - **[upstream_reference]** Recipe stage decomposition → `blender-recipe-decomposer` (`references/skills/blender-recipe-decomposer.md`) — `when.all: [fit.multiDeliverableDetected equals true]`
62
+ - **[upstream_reference]** Measurable acceptance rows → `acceptance-criteria-builder` (`references/skills/acceptance-criteria-builder.md`) — `when.all: [brief.locked equals true; stage.current equals "acceptance_criteria"]`
63
+ - **[upstream_reference]** Overall done condition → `done-criteria` (`references/skills/done-criteria.md`) — `when.all: [brief.locked equals true; stage.current equals "stop_condition"]`
64
+ - **[progression]** Scope creep protection → `scope-guard` (`references/skills/scope-guard.md`) — `when.all: [scope.driftDetected equals true]`
65
+ - **[progression]** Next-skill routing across stages → `workflow-stage-router` (`references/skills/workflow-stage-router.md`) — `when.all: [preflight.passed equals true; inventory.exists equals true]`
66
+ - **[progression]** Asset discovery → `asset-discovery` (`references/skills/asset-discovery.md`) — `when.all: [brief.locked equals true; assets.discoveryComplete equals false]`
67
+ - **[progression]** Scene planners (camera-composition) → `camera-composition` (`references/skills/camera-composition.md`) — `when.all: [brief.locked equals true; stage.current equals "camera_planning"]`
68
+ - **[progression]** Scene planners (lighting-material-plan) → `lighting-material-plan` (`references/skills/lighting-material-plan.md`) — `when.all: [brief.locked equals true; stage.current equals "lookdev_planning"]`
69
+ - **[alternative]** Scene planners (character-portrait) → `character-portrait` (`references/skills/character-portrait.md`) — `when.all: [brief.locked equals true; recipe.domain equals "character_portrait"]`
70
+ - **[alternative]** Scene planners (environment-shot) → `environment-shot` (`references/skills/environment-shot.md`) — `when.all: [brief.locked equals true; recipe.domain equals "environment_shot"]`
71
+ - **[alternative]** Scene planners (interior-scene) → `interior-scene` (`references/skills/interior-scene.md`) — `when.all: [brief.locked equals true; recipe.domain equals "interior_archviz"]`
72
+ - **[alternative]** Scene planners (product-grid-scene-planner) → `product-grid-scene-planner` (`references/skills/product-grid-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.domain equals "product_grid"]`
73
+ - **[alternative]** Scene planners (product-hero-scene-planner) → `product-hero-scene-planner` (`references/skills/product-hero-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.domain equals "product_hero"]`
74
+ - **[progression]** Quality validators (scene-readiness) → `scene-readiness` (`references/skills/scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
75
+ - **[progression]** Quality validators (composition-quality-checker) → `composition-quality-checker` (`references/skills/composition-quality-checker.md`) — `when.all: [quality.domain equals "composition"; quality.verdict equals "not_run"]`
76
+ - **[progression]** Quality validators (lighting-quality-checker) → `lighting-quality-checker` (`references/skills/lighting-quality-checker.md`) — `when.all: [quality.domain equals "lighting"; quality.verdict equals "not_run"]`
77
+ - **[progression]** Quality validators (material-quality-checker) → `material-quality-checker` (`references/skills/material-quality-checker.md`) — `when.all: [quality.domain equals "material"; quality.verdict equals "not_run"]`
78
+ - **[progression]** Quality validators (polycount-budget-checker) → `polycount-budget-checker` (`references/skills/polycount-budget-checker.md`) — `when.all: [quality.domain equals "polycount"; budget.verdict equals "Not Run"]`
79
+ - **[fallback]** Repeated gate failures → `blender-troubleshooting` (`references/skills/blender-troubleshooting.md`) — `when.all: [runtime.errorDetected equals true]`
80
+ - **[progression]** Final 7-point gate → `pre-handoff-verification` (`references/skills/pre-handoff-verification.md`) — `when.all: [stage.current equals "final_verification"]`
81
+
82
+ ## Safety boundaries & non-goals
83
+ - **Runtime boundary:** Process / discipline skill — does not run Blender. Gates are written and evaluated against produced artifacts (per `evidence-before-done.md`). Gate verdicts are honest labels, not motivation.
84
+ - Run Blender or execute Python.
85
+ - Decompose recipes into stages (`blender-recipe-decomposer`).
86
+ - Write measurable acceptance criteria rows (`acceptance-criteria-builder`).
87
+ - Pin the overall done/stop condition (`done-criteria`).
88
+ - Guard against scope creep (`scope-guard`).
89
+ - Pick next skills across the workflow (`workflow-stage-router`).
90
+ - Diagnose repeated technical failures (`blender-troubleshooting`).
91
+ - Replace the final 7-point handoff gate (`pre-handoff-verification`).
@@ -0,0 +1,67 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/workflow-stage-router/SKILL.md and skills/workflow-stage-router/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # workflow-stage-router (reference summary)
3
+
4
+ ## Purpose
5
+ Given current artifacts and intent, name the next BlendOps skill or workflow stage and preconditions to advance.
6
+
7
+ Reduce skill-choice paralysis by mapping **current state → next narrow skill** across BlendOps workflows while preserving evidence and runtime boundaries.
8
+
9
+ ## Metadata & truth boundary
10
+ - **Canonical skill:** `skills/workflow-stage-router/SKILL.md`
11
+ - **Contract:** `skills/workflow-stage-router/contract.json` (`v1.0.0`)
12
+ - **Category / role:** `routing-and-governance` / `mid-workflow-stage-router`
13
+ - **Capability tier:** `L0`
14
+ - **Routing precedence:** group `entry-and-stage-routing`, rank `4` | activationGate: `goalClarity="clear"`, `recipeSelected=true`, `preflightPassed=true`, `hasStageOrArtifactInventory=true`
15
+ - **Truth-state policy:** Runtime status defaults to `Not Run`; Artifact status defaults to `Not Produced`; mutation rule is `downgrade_only` (never upgrade without verified evidence).
16
+
17
+ ## When to use
18
+ - user asks "what skill next" after partial progress
19
+ - agent risks loading too many skills at once
20
+ - resume after interruption
21
+
22
+ ## Trigger cues
23
+ - "where are we in the workflow"
24
+ - "what's next"
25
+ - "resume from here"
26
+ - "next skill"
27
+
28
+ ## When not to use
29
+ - Initial goal is vague or entry point is unknown → delegate to `blendops-help` (`references/skills/blendops-help.md`; Triages ambiguous entry requests at precedence Rank 1)
30
+ - Goal is clear but no recipe or pack has been chosen yet → delegate to `recipe-fit-assessor` (`references/skills/recipe-fit-assessor.md`; Selects the fitting recipe/pack at precedence Rank 2)
31
+ - Pack is selected and brief exists, but pack preflight has not completed yet → delegate to `pack-prerequisite-checker` (`references/skills/pack-prerequisite-checker.md`; Executes preflight readiness verification at precedence Rank 3 before stage routing)
32
+ - Active MCP runtime bridge conflict on port 9876 → delegate to `bridge-conflicts` (`references/skills/bridge-conflicts.md`; Resolves port and dual add-on conflicts before advancing)
33
+ - Final stakeholder-facing wording and plain-language summary → delegate to `plain-language-response` (`references/skills/plain-language-response.md`; Formats validated workflow outputs for non-Blender users)
34
+
35
+ ## Inputs & output/evidence contract
36
+ ### Required inputs
37
+ - `current_artifact_inventory` (`artifact_inventory`): Determines current milestone stage and downgrade-only truth labels
38
+ - `active_intent` (`string`): Prevents routing to the wrong domain branch
39
+
40
+ ### Optional inputs
41
+ - `target_pack_or_recipe` (`string`): Narrows milestone track
42
+
43
+ ### Primary outputs
44
+ - `current_stage_name`
45
+ - `single_immediate_next_skill`
46
+ - `preconditions_checklist`
47
+
48
+ ## Quick-start procedure
49
+ 1. capture what exists now (brief, plan, renders, GLB, evidence logs)
50
+ 2. compare against `skills/workflow-stage-router/references/milestone-model.md`
51
+ 3. emit route via `skills/workflow-stage-router/references/routing-decision-tree.md`
52
+ 4. fill `skills/workflow-stage-router/references/stage-handoff-template.md`
53
+
54
+ ## Handoff notes
55
+ - **[upstream_reference]** Pack entry preflight gate → `pack-prerequisite-checker` (`references/skills/pack-prerequisite-checker.md`) — `when.all: [preflight.passed equals false]`
56
+ - **[conditional]** Runtime readiness check → `runtime-readiness` (`references/skills/runtime-readiness.md`) — `when.all: [runtime.status equals "Not Run"; stage.requiresRuntime equals true]`
57
+ - **[fallback]** Active MCP bridge conflict on port 9876 → `bridge-conflicts` (`references/skills/bridge-conflicts.md`) — `when.all: [runtime.conflictDetected equals true]`
58
+ - **[boundary_delegation]** Mid-workflow scope expansion or unapproved deliverable addition → `scope-guard` (`references/skills/scope-guard.md`) — `when.all: [scope.driftDetected equals true]`
59
+ - **[progression]** Evidence updates for render or export outputs → `render-export-evidence` (`references/skills/render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
60
+ - **[fallback]** Failed gate / blocked mode exit / final gate → `pre-handoff-verification` (`references/skills/pre-handoff-verification.md`) — `when.any: [gate.status equals "failed"; runtime.mode equals "blocked"; stage.current equals "final_verification"]`
61
+
62
+ ## Safety boundaries & non-goals
63
+ - **Runtime boundary:** Routing only — no Python and no Blender execution (`execute_blender_code` is never invoked here). If the next step requires runtime selection or configuration, route to `runtime-path-picker`, `runtime-setup`, `runtime-readiness`, `path-one-host-outline`, or `cli-appendix-job-outline` with these locked boundaries:
64
+ - Initial entry triage when the user's goal is unclear (use `blendops-help`).
65
+ - Selecting a recipe/pack (`recipe-fit-assessor`) or running initial pack preflight (`pack-prerequisite-checker`).
66
+ - Executing domain scene planning, running Blender or Python, or verifying artifact files directly.
67
+ - Writing final stakeholder-facing delivery copy (use `plain-language-response` after verification).
@@ -0,0 +1,71 @@
1
+ # BLENDOPS
2
+
3
+ Status: 1.0.0 project-local instruction fixture
4
+ Target: generic-project
5
+
6
+ Use BlendOps as project-local workflow guidance for Blender planning, readiness, evidence, and handoff.
7
+
8
+ ## Load as guidance
9
+
10
+ Reference the canonical BlendOps sources from the repository copy or attached project files:
11
+
12
+ - `docs/ai-agent-install-flow.md`
13
+ - `docs/install/generic-project.md`
14
+ - `docs/skill-system.md`
15
+ - `docs/knowledge-and-recipe-catalog.md` (or project-local `.blendops/catalog/knowledge-and-recipe-catalog.md`)
16
+ - `docs/runtime-stack-strategy.md`
17
+ - `registry/knowledge-catalog.json` (or `.blendops/catalog/knowledge-catalog.json`)
18
+ - `registry/recipe-catalog.json` (or `.blendops/catalog/recipe-catalog.json`)
19
+ - `registry/catalog-index.json` (or `.blendops/catalog/catalog-index.json`)
20
+ - `registry/runtime-operations.json` (or `.blendops/catalog/runtime-operations.json`)
21
+ - `registry/runtime-capability-policy.json` (or `.blendops/catalog/runtime-capability-policy.json`)
22
+ - `schemas/scene-spec.schema.json` (or `.blendops/catalog/schemas/scene-spec.schema.json`)
23
+ - `schemas/execution-plan.schema.json` (or `.blendops/catalog/schemas/execution-plan.schema.json`)
24
+ - `schemas/runtime-session.schema.json` (or `.blendops/catalog/schemas/runtime-session.schema.json`)
25
+ - `schemas/runtime-operations.schema.json` (or `.blendops/catalog/schemas/runtime-operations.schema.json`)
26
+ - `schemas/operation-execution-ledger.schema.json` (or `.blendops/catalog/schemas/operation-execution-ledger.schema.json`)
27
+ - `skills/README.md`
28
+ - `laws/README.md`
29
+ - `packs/README.md`
30
+ - `packs/product-hero-v0/PACK.md`
31
+
32
+ Do not duplicate the whole BlendOps repository into the target project unless the user explicitly asks and rollback is documented.
33
+
34
+ ## Runtime path boundaries
35
+
36
+ Preserve the **2 MCP execution paths + CLI fallback appendix** model (see `docs/runtime-stack-strategy.md`):
37
+
38
+ 1. **Path 1 — Official Blender Lab MCP.** Lab MCP add-on + Lab MCP server installed in Blender 5.1+, hosted from either (a) Anthropic Blender Connector in Claude Desktop, or (b) any other MCP client configured manually. Anthropic Connector is **not** standalone — Lab add-on inside Blender is required either way.
39
+ 2. **Path 2 — Community `mcp-for-blender` (formerly `blender-mcp`).** Different add-on/server. Mature third-party, Blender 3.0+.
40
+ 3. **CLI fallback (appendix).** Direct `blender --background --python`. No MCP. **Documented upstream** as a first-class Blender CLI surface; no in-repo evidence file yet.
41
+
42
+ Single-bridge constraint: Blender accepts one MCP bridge session per Blender instance. Do not run Path 1 + Path 2 concurrently against the same Blender instance on `localhost:9876` (side-by-side on separate instances via per-instance `--port 9877` is supported upstream).
43
+
44
+ ## Evidence states
45
+
46
+ Use these states consistently:
47
+
48
+ - `Not Run`
49
+ - `Attempted`
50
+ - `Produced`
51
+ - `Verified`
52
+ - `Failed`
53
+
54
+ Do not claim preview/render/GLB artifacts without evidence. A valid artifact claim needs output path or visible evidence plus validation notes.
55
+
56
+ ## Preferred flow
57
+
58
+ 1. Plan the workflow.
59
+ 2. Check runtime readiness.
60
+ 3. Record evidence state.
61
+ 4. Validate or downgrade claims.
62
+ 5. Explain status in non-Blender-user language.
63
+
64
+ ## Runtime boundary
65
+
66
+ Runtime setup is separate from skill install. This project-local instruction file does not install Blender, configure connector/MCP, run runtime eval, render, export GLB, or create artifacts.
67
+
68
+ Default status after install:
69
+
70
+ - Runtime status: `Not Run`
71
+ - Artifact status: `Not Produced`
@@ -0,0 +1,52 @@
1
+ # BlendOps Generic Project Install Report
2
+
3
+ Status: 1.0.0 report template
4
+ Target: generic-project
5
+
6
+ ## Summary
7
+
8
+ - Target selected: generic-project
9
+ - Confidence:
10
+ - Scope: project-local
11
+ - Install mode: manual fixture copy / reference
12
+ - Global files touched: No
13
+ - Runtime status: Not Run
14
+ - Artifact status: Not Produced
15
+ - Runtime setup: Separate; not performed
16
+
17
+ ## Files created/modified
18
+
19
+ | Path | Action | Backup |
20
+ |---|---|---|
21
+ | `BLENDOPS.md` | created / skipped / modified | n/a |
22
+ | `AGENTS.md` | not touched / patched | |
23
+
24
+ ## Files skipped
25
+
26
+ | Path | Reason |
27
+ |---|---|
28
+ | | |
29
+
30
+ ## Rollback steps
31
+
32
+ 1. Remove `BLENDOPS.md` if it was created by this install.
33
+ 2. Restore `AGENTS.md` from the backup listed above if it was patched.
34
+ 3. Remove any project-local metadata folder listed by the install report.
35
+ 4. Confirm no global files were touched.
36
+
37
+ ## Safety confirmations
38
+
39
+ - [ ] Blender was not installed.
40
+ - [ ] Claude Desktop Connector was not configured.
41
+ - [ ] Official Blender MCP bridge/add-on was not configured.
42
+ - [ ] Third-party runtime bridges were not configured.
43
+ - [ ] Blender was not run.
44
+ - [ ] Runtime eval was not run.
45
+ - [ ] Preview/render/GLB artifacts were not created or claimed.
46
+ - [ ] Global files were not touched.
47
+
48
+ ## Limitations
49
+
50
+ - This report covers project-local skill/instruction attachment only.
51
+ - Runtime setup remains separate.
52
+ - Artifact evidence remains unavailable until a runtime eval records it.
@@ -0,0 +1,73 @@
1
+ # Generic Project-Local BlendOps Bundle
2
+
3
+ Status: 1.0.0 reference fixture
4
+ Target: `generic-project`
5
+
6
+ ## What this bundle is
7
+
8
+ This is a static, inspectable project-local install fixture for BlendOps. It gives an AI coding agent a minimal set of files it can copy into another repository when target detection is unknown or ambiguous.
9
+
10
+ This directory is a static reference fixture only; it is not itself an installer script, an npm package, a separate release artifact, an official marketplace listing, or a runtime setup. For the published CLI, use [`blendops@1.0.0`](https://www.npmjs.com/package/blendops); for direct Agent Skills installation, use [`skills.sh`](https://www.skills.sh/ThanhNguyxnOrg/blendops).
11
+
12
+ ## When to use it
13
+
14
+ Use this bundle when:
15
+
16
+ - no target-specific AI coding agent path is verified,
17
+ - multiple targets are detected and the user chooses the generic fallback,
18
+ - a project needs reversible BlendOps instructions without global config writes,
19
+ - automated or manual fallback installs need a small reference fixture to copy from or validate against.
20
+
21
+ ## When not to use it
22
+
23
+ Do not use this bundle when:
24
+
25
+ - the user asked for a verified target-native install path and that path is known,
26
+ - the user expects Blender runtime setup,
27
+ - the user expects a Claude Desktop Connector or Blender MCP bridge configuration,
28
+ - the user expects preview/render/GLB artifacts,
29
+ - the user expects to invoke the published npm CLI directly (use `npx blendops` instead of copying this static fixture),
30
+ - the user expects an official marketplace install (no such listing is claimed).
31
+
32
+ ## Relationship to install docs
33
+
34
+ - Main paste prompt: [docs/ai-agent-install-flow.md](../../docs/ai-agent-install-flow.md)
35
+ - Generic target doc: [docs/install/generic-project.md](../../docs/install/generic-project.md)
36
+ - Installer & CLI spec: [docs/install/installer-spec.md](../../docs/install/installer-spec.md)
37
+
38
+ This fixture serves as the static manual reference alongside the local repository installer (`scripts/install-skills.mjs`) and distributable CLI (`bin/blendops.mjs`).
39
+
40
+ ## Bundle contents
41
+
42
+ | File | Purpose |
43
+ |---|---|
44
+ | `BLENDOPS.md` | Project instruction file to copy into a target project root. |
45
+ | `ROLLBACK.md` | Manual rollback instructions. |
46
+ | `INSTALL_REPORT_TEMPLATE.md` | Report template for install attempts. |
47
+ | `manifest.json` | Machine-readable fixture metadata. |
48
+
49
+ ## Install sketch
50
+
51
+ Manual copy only:
52
+
53
+ 1. Copy `BLENDOPS.md` to the target project root.
54
+ 2. If patching `AGENTS.md` later, back it up first.
55
+ 3. Do not write global config.
56
+ 4. Fill out `INSTALL_REPORT_TEMPLATE.md` after the install attempt.
57
+ 5. Keep `ROLLBACK.md` with the install notes or copy its steps into the report.
58
+
59
+ ## Runtime boundary
60
+
61
+ Skill install is not runtime setup.
62
+
63
+ This bundle does not:
64
+
65
+ - install Blender,
66
+ - configure Claude Desktop Connector,
67
+ - configure the official Blender MCP bridge/add-on,
68
+ - configure third-party runtime bridges,
69
+ - run Blender,
70
+ - run runtime eval,
71
+ - create, render, export, or claim preview/render/GLB artifacts.
72
+
73
+ Runtime status remains `Not Run`. Artifact status remains `Not Produced` until evidence exists.
@@ -0,0 +1,66 @@
1
+ # Generic Project-Local Rollback
2
+
3
+ Status: 1.0.0 rollback notes
4
+ Target: generic-project
5
+
6
+ ## Remove BLENDOPS.md
7
+
8
+ If the generic bundle installed `BLENDOPS.md` at the project root:
9
+
10
+ ```sh
11
+ rm BLENDOPS.md
12
+ ```
13
+
14
+ On PowerShell:
15
+
16
+ ```powershell
17
+ Remove-Item BLENDOPS.md
18
+ ```
19
+
20
+ ## Restore AGENTS.md if patched
21
+
22
+ If an install patched `AGENTS.md`, restore the backup recorded in the install report.
23
+
24
+ Example:
25
+
26
+ ```sh
27
+ cp AGENTS.md.blendops-backup AGENTS.md
28
+ ```
29
+
30
+ On PowerShell:
31
+
32
+ ```powershell
33
+ Copy-Item AGENTS.md.blendops-backup AGENTS.md -Force
34
+ ```
35
+
36
+ Only run the restore command if that backup file exists and the install report confirms it was created.
37
+
38
+ ## Remove project-local metadata
39
+
40
+ If the installer creates a project-local metadata folder such as `.blendops/`, remove only the folder listed in the install report.
41
+
42
+ Example:
43
+
44
+ ```sh
45
+ rm -rf .blendops
46
+ ```
47
+
48
+ On PowerShell:
49
+
50
+ ```powershell
51
+ Remove-Item .blendops -Recurse -Force
52
+ ```
53
+
54
+ ## No global rollback
55
+
56
+ The generic project-local bundle must not touch global files. If an install report says global files were touched, treat that as outside this fixture's expected behavior and review manually before deleting anything.
57
+
58
+ ## Post-rollback check
59
+
60
+ After rollback, verify:
61
+
62
+ - `BLENDOPS.md` is absent or restored to its pre-install state,
63
+ - `AGENTS.md` is restored if it was patched,
64
+ - any project-local metadata folder listed by the report is removed,
65
+ - runtime status remains `Not Run`,
66
+ - artifact status remains `Not Produced`.