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.
- package/CHANGELOG.md +74 -0
- package/LICENSE +21 -0
- package/README.md +208 -2
- package/bin/blendops.mjs +4 -0
- package/bundles/claude-desktop-manual/BLENDOPS_SINGLE_FILE.md +78 -0
- package/bundles/claude-desktop-manual/IMPORT_STEPS.md +43 -0
- package/bundles/claude-desktop-manual/INSTALL_REPORT_TEMPLATE.md +13 -0
- package/bundles/claude-desktop-manual/README.md +70 -0
- package/bundles/claude-desktop-manual/SKILL.md +62 -0
- package/bundles/claude-desktop-manual/manifest.json +278 -0
- package/bundles/claude-desktop-manual/references/evidence-rules.md +13 -0
- package/bundles/claude-desktop-manual/references/install-boundary.md +13 -0
- package/bundles/claude-desktop-manual/references/laws/evidence-before-done.md +14 -0
- package/bundles/claude-desktop-manual/references/laws/no-arbitrary-python-interface.md +12 -0
- package/bundles/claude-desktop-manual/references/laws/non-blender-user-language.md +13 -0
- package/bundles/claude-desktop-manual/references/laws/official-runtime-only.md +20 -0
- package/bundles/claude-desktop-manual/references/packs/product-hero-v0.md +30 -0
- package/bundles/claude-desktop-manual/references/runtime-stacks.md +13 -0
- package/bundles/claude-desktop-manual/references/skill-map.md +36 -0
- package/bundles/claude-desktop-manual/references/skills/acceptance-criteria-builder.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/asset-discovery.md +73 -0
- package/bundles/claude-desktop-manual/references/skills/asset-fallback-strategy.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/asset-library-plan.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/asset-license-checker.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/asset-style-check.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/blender-brainstorming.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/blender-recipe-decomposer.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/blender-troubleshooting.md +78 -0
- package/bundles/claude-desktop-manual/references/skills/blendops-help.md +82 -0
- package/bundles/claude-desktop-manual/references/skills/bridge-conflicts.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/camera-composition.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/character-portrait.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/cli-appendix-job-outline.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/color-management-decision.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/composition-quality-checker.md +71 -0
- package/bundles/claude-desktop-manual/references/skills/cycles-vs-eevee-decision.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/done-criteria.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/environment-shot.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/glb-animation-handoff.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/glb-web-handoff.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/intent-to-3d-brief-writer.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/interior-scene.md +73 -0
- package/bundles/claude-desktop-manual/references/skills/lighting-material-plan.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/lighting-quality-checker.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/material-quality-checker.md +71 -0
- package/bundles/claude-desktop-manual/references/skills/mobile-glb-budget.md +73 -0
- package/bundles/claude-desktop-manual/references/skills/output-format-decision.md +63 -0
- package/bundles/claude-desktop-manual/references/skills/pack-prerequisite-checker.md +74 -0
- package/bundles/claude-desktop-manual/references/skills/path-one-host-outline.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/plain-language-response.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/polycount-budget-checker.md +71 -0
- package/bundles/claude-desktop-manual/references/skills/pre-handoff-verification.md +76 -0
- package/bundles/claude-desktop-manual/references/skills/preview-report.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/product-grid-scene-planner.md +72 -0
- package/bundles/claude-desktop-manual/references/skills/product-hero-scene-planner.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/r3f-component-plan.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/recipe-fit-assessor.md +75 -0
- package/bundles/claude-desktop-manual/references/skills/render-export-evidence.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/resolution-aspect-decision.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-attempt-report.md +67 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-path-picker.md +67 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-readiness.md +63 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-setup.md +63 -0
- package/bundles/claude-desktop-manual/references/skills/scene-readiness.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/scope-guard.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/stage-gates.md +91 -0
- package/bundles/claude-desktop-manual/references/skills/workflow-stage-router.md +67 -0
- package/bundles/generic-project-local/BLENDOPS.md +71 -0
- package/bundles/generic-project-local/INSTALL_REPORT_TEMPLATE.md +52 -0
- package/bundles/generic-project-local/README.md +73 -0
- package/bundles/generic-project-local/ROLLBACK.md +66 -0
- package/bundles/generic-project-local/manifest.json +66 -0
- package/bundles/skill-package/README.md +54 -0
- package/bundles/skill-package/blendops/LICENSE.txt +21 -0
- package/bundles/skill-package/blendops/SKILL.md +50 -0
- package/bundles/skill-package/blendops/agents/README.md +61 -0
- package/bundles/skill-package/blendops/agents/openai.yaml +4 -0
- package/bundles/skill-package/blendops/references/evidence-rules.md +17 -0
- package/bundles/skill-package/blendops/references/install-boundary.md +13 -0
- package/bundles/skill-package/blendops/references/law-evidence-before-done.md +12 -0
- package/bundles/skill-package/blendops/references/law-no-arbitrary-python-interface.md +7 -0
- package/bundles/skill-package/blendops/references/law-non-blender-user-language.md +8 -0
- package/bundles/skill-package/blendops/references/law-official-runtime-only.md +9 -0
- package/bundles/skill-package/blendops/references/pack-product-hero-v0.md +21 -0
- package/bundles/skill-package/blendops/references/runtime-stacks.md +13 -0
- package/bundles/skill-package/blendops/references/skill-acceptance-criteria-builder.md +51 -0
- package/bundles/skill-package/blendops/references/skill-asset-discovery.md +54 -0
- package/bundles/skill-package/blendops/references/skill-asset-fallback-strategy.md +48 -0
- package/bundles/skill-package/blendops/references/skill-asset-library-plan.md +51 -0
- package/bundles/skill-package/blendops/references/skill-asset-license-checker.md +51 -0
- package/bundles/skill-package/blendops/references/skill-asset-style-check.md +52 -0
- package/bundles/skill-package/blendops/references/skill-blender-brainstorming.md +43 -0
- package/bundles/skill-package/blendops/references/skill-blender-recipe-decomposer.md +48 -0
- package/bundles/skill-package/blendops/references/skill-blender-troubleshooting.md +59 -0
- package/bundles/skill-package/blendops/references/skill-blendops-help.md +62 -0
- package/bundles/skill-package/blendops/references/skill-bridge-conflicts.md +48 -0
- package/bundles/skill-package/blendops/references/skill-camera-composition.md +48 -0
- package/bundles/skill-package/blendops/references/skill-character-portrait.md +50 -0
- package/bundles/skill-package/blendops/references/skill-cli-appendix-job-outline.md +44 -0
- package/bundles/skill-package/blendops/references/skill-color-management-decision.md +50 -0
- package/bundles/skill-package/blendops/references/skill-composition-quality-checker.md +53 -0
- package/bundles/skill-package/blendops/references/skill-cycles-vs-eevee-decision.md +47 -0
- package/bundles/skill-package/blendops/references/skill-done-criteria.md +53 -0
- package/bundles/skill-package/blendops/references/skill-environment-shot.md +47 -0
- package/bundles/skill-package/blendops/references/skill-glb-animation-handoff.md +51 -0
- package/bundles/skill-package/blendops/references/skill-glb-web-handoff.md +51 -0
- package/bundles/skill-package/blendops/references/skill-intent-to-3d-brief-writer.md +50 -0
- package/bundles/skill-package/blendops/references/skill-interior-scene.md +54 -0
- package/bundles/skill-package/blendops/references/skill-lighting-material-plan.md +48 -0
- package/bundles/skill-package/blendops/references/skill-lighting-quality-checker.md +52 -0
- package/bundles/skill-package/blendops/references/skill-map.md +32 -0
- package/bundles/skill-package/blendops/references/skill-material-quality-checker.md +53 -0
- package/bundles/skill-package/blendops/references/skill-mobile-glb-budget.md +55 -0
- package/bundles/skill-package/blendops/references/skill-output-format-decision.md +46 -0
- package/bundles/skill-package/blendops/references/skill-pack-prerequisite-checker.md +56 -0
- package/bundles/skill-package/blendops/references/skill-path-one-host-outline.md +48 -0
- package/bundles/skill-package/blendops/references/skill-plain-language-response.md +53 -0
- package/bundles/skill-package/blendops/references/skill-polycount-budget-checker.md +53 -0
- package/bundles/skill-package/blendops/references/skill-pre-handoff-verification.md +57 -0
- package/bundles/skill-package/blendops/references/skill-preview-report.md +45 -0
- package/bundles/skill-package/blendops/references/skill-product-grid-scene-planner.md +54 -0
- package/bundles/skill-package/blendops/references/skill-product-hero-scene-planner.md +51 -0
- package/bundles/skill-package/blendops/references/skill-r3f-component-plan.md +48 -0
- package/bundles/skill-package/blendops/references/skill-recipe-fit-assessor.md +57 -0
- package/bundles/skill-package/blendops/references/skill-render-export-evidence.md +51 -0
- package/bundles/skill-package/blendops/references/skill-resolution-aspect-decision.md +48 -0
- package/bundles/skill-package/blendops/references/skill-runtime-attempt-report.md +49 -0
- package/bundles/skill-package/blendops/references/skill-runtime-path-picker.md +49 -0
- package/bundles/skill-package/blendops/references/skill-runtime-readiness.md +45 -0
- package/bundles/skill-package/blendops/references/skill-runtime-setup.md +45 -0
- package/bundles/skill-package/blendops/references/skill-scene-readiness.md +48 -0
- package/bundles/skill-package/blendops/references/skill-scope-guard.md +44 -0
- package/bundles/skill-package/blendops/references/skill-stage-gates.md +73 -0
- package/bundles/skill-package/blendops/references/skill-workflow-stage-router.md +49 -0
- package/docs/README.md +276 -0
- package/docs/examples/glb-web-handoff/README.md +174 -0
- package/docs/examples/glb-web-handoff/r3f-glb-viewer.tsx +320 -0
- package/docs/examples/glb-web-handoff/threejs-glb-viewer.mjs +709 -0
- package/docs/knowledge-and-recipe-catalog.md +236 -0
- package/docs/recipes/README.md +27 -0
- package/docs/recipes/cyberpunk-shoe-hero.md +97 -0
- package/docs/workflows/README.md +14 -0
- package/docs/workflows/full-non-blender-user-workflow.md +210 -0
- package/docs/workflows/product-hero-workflow.md +92 -0
- package/laws/README.md +32 -0
- package/laws/evidence-before-done.md +37 -0
- package/laws/no-arbitrary-python-interface.md +32 -0
- package/laws/non-blender-user-language.md +32 -0
- package/laws/official-runtime-only.md +78 -0
- package/package.json +103 -4
- package/packs/README.md +11 -0
- package/packs/product-hero-v0/PACK.md +114 -0
- package/registry/catalog-index.json +21344 -0
- package/registry/compatibility-matrix.json +533 -0
- package/registry/contract-context-fields.json +391 -0
- package/registry/knowledge-catalog.json +4648 -0
- package/registry/knowledge-sources.json +438 -0
- package/registry/recipe-catalog.json +2565 -0
- package/registry/runtime-capability-policy.json +525 -0
- package/registry/runtime-operations.json +4468 -0
- package/registry/skills.json +10231 -0
- package/registry/workflow-graph.json +7390 -0
- package/schemas/adapter-compatibility-matrix.schema.json +166 -0
- package/schemas/contract-context-fields.schema.json +147 -0
- package/schemas/execution-plan.schema.json +325 -0
- package/schemas/glb-web-handoff-manifest.schema.json +744 -0
- package/schemas/knowledge-record.schema.json +460 -0
- package/schemas/knowledge-source-registry.schema.json +268 -0
- package/schemas/operation-execution-ledger.schema.json +348 -0
- package/schemas/recipe-record.schema.json +469 -0
- package/schemas/runtime-capability-policy.schema.json +184 -0
- package/schemas/runtime-evidence-packet.schema.json +211 -0
- package/schemas/runtime-operations.schema.json +535 -0
- package/schemas/runtime-qualification-report.schema.json +540 -0
- package/schemas/runtime-session.schema.json +350 -0
- package/schemas/scene-spec.schema.json +624 -0
- package/schemas/skill-contract.schema.json +402 -0
- package/schemas/skill-eval.schema.json +509 -0
- package/scripts/build-knowledge-catalog.mjs +2376 -0
- package/scripts/compile-scene-plan.mjs +1945 -0
- package/scripts/export-claude-skills.mjs +634 -0
- package/scripts/generate-glb-handoff-report.mjs +2376 -0
- package/scripts/inspect-glb.mjs +1627 -0
- package/scripts/install-skills.mjs +5443 -0
- package/scripts/runtime-orchestrator.mjs +7713 -0
- package/scripts/validate-capability-policy.mjs +531 -0
- package/scripts/validate-evidence-packet.mjs +256 -0
- package/skills/README.md +315 -0
- package/skills/_template/SKILL.md +296 -0
- package/skills/acceptance-criteria-builder/EVAL.md +25 -0
- package/skills/acceptance-criteria-builder/SKILL.md +257 -0
- package/skills/acceptance-criteria-builder/contract.json +205 -0
- package/skills/acceptance-criteria-builder/references/brief-to-criteria-mapper.md +22 -0
- package/skills/acceptance-criteria-builder/references/checklist-patterns.md +22 -0
- package/skills/acceptance-criteria-builder/references/evidence-hook-rules.md +19 -0
- package/skills/asset-discovery/EVAL.md +81 -0
- package/skills/asset-discovery/SKILL.md +252 -0
- package/skills/asset-discovery/contract.json +291 -0
- package/skills/asset-discovery/references/asset-strategy-decision-tree.md +40 -0
- package/skills/asset-discovery/references/budget-reconciliation-patterns.md +54 -0
- package/skills/asset-discovery/references/license-confidence-table.md +41 -0
- package/skills/asset-fallback-strategy/EVAL.md +34 -0
- package/skills/asset-fallback-strategy/SKILL.md +248 -0
- package/skills/asset-fallback-strategy/contract.json +190 -0
- package/skills/asset-fallback-strategy/references/drop-with-caveat-rules.md +36 -0
- package/skills/asset-fallback-strategy/references/fallback-option-types.md +55 -0
- package/skills/asset-fallback-strategy/references/scoring-rubric.md +61 -0
- package/skills/asset-library-plan/EVAL.md +28 -0
- package/skills/asset-library-plan/SKILL.md +263 -0
- package/skills/asset-library-plan/contract.json +177 -0
- package/skills/asset-library-plan/references/folder-structure-rules.md +63 -0
- package/skills/asset-library-plan/references/metadata-schema.md +62 -0
- package/skills/asset-library-plan/references/naming-rules.md +51 -0
- package/skills/asset-license-checker/EVAL.md +33 -0
- package/skills/asset-license-checker/SKILL.md +245 -0
- package/skills/asset-license-checker/contract.json +172 -0
- package/skills/asset-license-checker/references/attribution-rendering-patterns.md +48 -0
- package/skills/asset-license-checker/references/common-license-mapping.md +39 -0
- package/skills/asset-license-checker/references/license-source-rules.md +38 -0
- package/skills/asset-style-check/EVAL.md +26 -0
- package/skills/asset-style-check/SKILL.md +238 -0
- package/skills/asset-style-check/contract.json +251 -0
- package/skills/asset-style-check/references/drift-classification.md +40 -0
- package/skills/asset-style-check/references/intentional-mixed-style.md +39 -0
- package/skills/asset-style-check/references/style-axes.md +46 -0
- package/skills/blender-brainstorming/EVAL.md +79 -0
- package/skills/blender-brainstorming/SKILL.md +228 -0
- package/skills/blender-brainstorming/contract.json +115 -0
- package/skills/blender-brainstorming/references/alternative-scoping-templates.md +43 -0
- package/skills/blender-brainstorming/references/clarification-patterns.md +29 -0
- package/skills/blender-brainstorming/references/intent-summary-style-guide.md +25 -0
- package/skills/blender-recipe-decomposer/EVAL.md +35 -0
- package/skills/blender-recipe-decomposer/SKILL.md +258 -0
- package/skills/blender-recipe-decomposer/contract.json +152 -0
- package/skills/blender-recipe-decomposer/references/dependency-patterns.md +53 -0
- package/skills/blender-recipe-decomposer/references/recipe-grouping-rules.md +58 -0
- package/skills/blender-recipe-decomposer/references/recipe-naming-rules.md +44 -0
- package/skills/blender-troubleshooting/EVAL.md +78 -0
- package/skills/blender-troubleshooting/SKILL.md +263 -0
- package/skills/blender-troubleshooting/contract.json +352 -0
- package/skills/blender-troubleshooting/references/common-symptom-playbooks.md +51 -0
- package/skills/blender-troubleshooting/references/divergence-routing-table.md +23 -0
- package/skills/blender-troubleshooting/references/four-phase-template.md +51 -0
- package/skills/blendops-help/EVAL.md +67 -0
- package/skills/blendops-help/SKILL.md +312 -0
- package/skills/blendops-help/contract.json +229 -0
- package/skills/blendops-help/references/lifecycle-phases.md +91 -0
- package/skills/blendops-help/references/quick-start-prompts.md +65 -0
- package/skills/blendops-help/references/routing-decision-tree.md +57 -0
- package/skills/bridge-conflicts/EVAL.md +83 -0
- package/skills/bridge-conflicts/SKILL.md +246 -0
- package/skills/bridge-conflicts/contract.json +145 -0
- package/skills/bridge-conflicts/references/bridge-state-matrix-template.md +82 -0
- package/skills/bridge-conflicts/references/conflict-playbooks.md +99 -0
- package/skills/bridge-conflicts/references/do-not-reminders.md +42 -0
- package/skills/camera-composition/EVAL.md +32 -0
- package/skills/camera-composition/SKILL.md +196 -0
- package/skills/camera-composition/contract.json +180 -0
- package/skills/camera-composition/references/camera-presets.md +30 -0
- package/skills/camera-composition/references/camera-rubric.md +24 -0
- package/skills/camera-composition/references/hero-composition-patterns.md +24 -0
- package/skills/camera-composition/references/web-layout-negative-space.md +25 -0
- package/skills/character-portrait/EVAL.md +42 -0
- package/skills/character-portrait/SKILL.md +245 -0
- package/skills/character-portrait/contract.json +205 -0
- package/skills/character-portrait/references/portrait-framing-rules.md +39 -0
- package/skills/character-portrait/references/portrait-lighting-patterns.md +50 -0
- package/skills/character-portrait/references/style-consistency-rules.md +41 -0
- package/skills/cli-appendix-job-outline/EVAL.md +26 -0
- package/skills/cli-appendix-job-outline/SKILL.md +252 -0
- package/skills/cli-appendix-job-outline/contract.json +147 -0
- package/skills/cli-appendix-job-outline/references/flag-order-reminders.md +16 -0
- package/skills/cli-appendix-job-outline/references/job-type-matrix.md +13 -0
- package/skills/cli-appendix-job-outline/references/stateless-limitations.md +12 -0
- package/skills/color-management-decision/EVAL.md +28 -0
- package/skills/color-management-decision/SKILL.md +254 -0
- package/skills/color-management-decision/contract.json +162 -0
- package/skills/color-management-decision/references/look-comparison.md +44 -0
- package/skills/color-management-decision/references/per-channel-rules.md +49 -0
- package/skills/color-management-decision/references/pipeline-mapping.md +47 -0
- package/skills/composition-quality-checker/EVAL.md +38 -0
- package/skills/composition-quality-checker/SKILL.md +260 -0
- package/skills/composition-quality-checker/contract.json +221 -0
- package/skills/composition-quality-checker/references/aspect-ratio-rules.md +37 -0
- package/skills/composition-quality-checker/references/composition-rules.md +58 -0
- package/skills/composition-quality-checker/references/headroom-leadroom-rules.md +46 -0
- package/skills/cycles-vs-eevee-decision/EVAL.md +26 -0
- package/skills/cycles-vs-eevee-decision/SKILL.md +249 -0
- package/skills/cycles-vs-eevee-decision/contract.json +142 -0
- package/skills/cycles-vs-eevee-decision/references/engine-feature-matrix.md +39 -0
- package/skills/cycles-vs-eevee-decision/references/gpu-device-rules.md +51 -0
- package/skills/cycles-vs-eevee-decision/references/samples-by-quality.md +53 -0
- package/skills/done-criteria/EVAL.md +33 -0
- package/skills/done-criteria/SKILL.md +225 -0
- package/skills/done-criteria/contract.json +199 -0
- package/skills/done-criteria/references/done-vs-perfect.md +56 -0
- package/skills/done-criteria/references/out-of-scope-patterns.md +50 -0
- package/skills/done-criteria/references/stop-condition-templates.md +39 -0
- package/skills/environment-shot/EVAL.md +44 -0
- package/skills/environment-shot/SKILL.md +237 -0
- package/skills/environment-shot/contract.json +162 -0
- package/skills/environment-shot/references/depth-layering-rules.md +49 -0
- package/skills/environment-shot/references/time-and-weather-rules.md +35 -0
- package/skills/environment-shot/references/wide-shot-camera-rules.md +51 -0
- package/skills/glb-animation-handoff/EVAL.md +39 -0
- package/skills/glb-animation-handoff/SKILL.md +271 -0
- package/skills/glb-animation-handoff/contract.json +247 -0
- package/skills/glb-animation-handoff/references/animation-types.md +36 -0
- package/skills/glb-animation-handoff/references/transition-rules.md +55 -0
- package/skills/glb-animation-handoff/references/web-stack-caveats.md +40 -0
- package/skills/glb-web-handoff/EVAL.md +33 -0
- package/skills/glb-web-handoff/SKILL.md +212 -0
- package/skills/glb-web-handoff/contract.json +171 -0
- package/skills/glb-web-handoff/references/artifact-status-language.md +26 -0
- package/skills/glb-web-handoff/references/glb-handoff-checklist.md +30 -0
- package/skills/glb-web-handoff/references/performance-caveats.md +26 -0
- package/skills/glb-web-handoff/references/threejs-r3f-handoff.md +28 -0
- package/skills/intent-to-3d-brief-writer/EVAL.md +82 -0
- package/skills/intent-to-3d-brief-writer/SKILL.md +238 -0
- package/skills/intent-to-3d-brief-writer/contract.json +195 -0
- package/skills/intent-to-3d-brief-writer/references/acceptance-criteria-patterns.md +46 -0
- package/skills/intent-to-3d-brief-writer/references/eight-slot-template.md +123 -0
- package/skills/intent-to-3d-brief-writer/references/mixed-audience-handling.md +39 -0
- package/skills/interior-scene/EVAL.md +44 -0
- package/skills/interior-scene/SKILL.md +261 -0
- package/skills/interior-scene/contract.json +277 -0
- package/skills/interior-scene/references/furniture-layout-rules.md +51 -0
- package/skills/interior-scene/references/interior-architecture-rules.md +47 -0
- package/skills/interior-scene/references/interior-camera-rules.md +47 -0
- package/skills/lighting-material-plan/EVAL.md +32 -0
- package/skills/lighting-material-plan/SKILL.md +194 -0
- package/skills/lighting-material-plan/contract.json +213 -0
- package/skills/lighting-material-plan/references/cyberpunk-lookdev.md +22 -0
- package/skills/lighting-material-plan/references/lighting-patterns.md +30 -0
- package/skills/lighting-material-plan/references/material-portability.md +25 -0
- package/skills/lighting-material-plan/references/reflective-floor-pattern.md +22 -0
- package/skills/lighting-material-plan/references/web-material-simplification.md +23 -0
- package/skills/lighting-quality-checker/EVAL.md +41 -0
- package/skills/lighting-quality-checker/SKILL.md +247 -0
- package/skills/lighting-quality-checker/contract.json +187 -0
- package/skills/lighting-quality-checker/references/hdri-balance-rules.md +48 -0
- package/skills/lighting-quality-checker/references/intensity-ranges.md +73 -0
- package/skills/lighting-quality-checker/references/shadow-softness-rules.md +38 -0
- package/skills/material-quality-checker/EVAL.md +40 -0
- package/skills/material-quality-checker/SKILL.md +261 -0
- package/skills/material-quality-checker/contract.json +244 -0
- package/skills/material-quality-checker/references/consumer-stack-rules.md +62 -0
- package/skills/material-quality-checker/references/pbr-sanity-rules.md +78 -0
- package/skills/material-quality-checker/references/texture-budget-rules.md +48 -0
- package/skills/mobile-glb-budget/EVAL.md +40 -0
- package/skills/mobile-glb-budget/SKILL.md +264 -0
- package/skills/mobile-glb-budget/contract.json +309 -0
- package/skills/mobile-glb-budget/references/budget-tiers.md +30 -0
- package/skills/mobile-glb-budget/references/degradation-plan.md +34 -0
- package/skills/mobile-glb-budget/references/violation-rules.md +43 -0
- package/skills/output-format-decision/EVAL.md +27 -0
- package/skills/output-format-decision/SKILL.md +222 -0
- package/skills/output-format-decision/contract.json +179 -0
- package/skills/output-format-decision/references/bit-depth-rules.md +56 -0
- package/skills/output-format-decision/references/compression-tradeoffs.md +62 -0
- package/skills/output-format-decision/references/format-decision-matrix.md +34 -0
- package/skills/pack-prerequisite-checker/EVAL.md +26 -0
- package/skills/pack-prerequisite-checker/SKILL.md +272 -0
- package/skills/pack-prerequisite-checker/contract.json +214 -0
- package/skills/pack-prerequisite-checker/references/blocked-start-playbook.md +21 -0
- package/skills/pack-prerequisite-checker/references/pack-readiness-template.md +38 -0
- package/skills/pack-prerequisite-checker/references/prerequisite-matrix.md +20 -0
- package/skills/path-one-host-outline/EVAL.md +26 -0
- package/skills/path-one-host-outline/SKILL.md +251 -0
- package/skills/path-one-host-outline/contract.json +167 -0
- package/skills/path-one-host-outline/references/connector-vs-manual-matrix.md +21 -0
- package/skills/path-one-host-outline/references/host-checklist-template.md +35 -0
- package/skills/path-one-host-outline/references/lab-addon-reminders.md +12 -0
- package/skills/plain-language-response/EVAL.md +33 -0
- package/skills/plain-language-response/SKILL.md +194 -0
- package/skills/plain-language-response/contract.json +242 -0
- package/skills/plain-language-response/references/caveat-language.md +25 -0
- package/skills/plain-language-response/references/plain-language-patterns.md +30 -0
- package/skills/plain-language-response/references/stakeholder-friendly-examples.md +30 -0
- package/skills/plain-language-response/references/status-summary-templates.md +50 -0
- package/skills/polycount-budget-checker/EVAL.md +40 -0
- package/skills/polycount-budget-checker/SKILL.md +251 -0
- package/skills/polycount-budget-checker/contract.json +196 -0
- package/skills/polycount-budget-checker/references/instance-counting-rules.md +39 -0
- package/skills/polycount-budget-checker/references/per-mesh-rules.md +43 -0
- package/skills/polycount-budget-checker/references/topology-hints.md +56 -0
- package/skills/pre-handoff-verification/EVAL.md +84 -0
- package/skills/pre-handoff-verification/SKILL.md +252 -0
- package/skills/pre-handoff-verification/contract.json +295 -0
- package/skills/pre-handoff-verification/references/downgrade-rules.md +39 -0
- package/skills/pre-handoff-verification/references/seven-point-checklist.md +46 -0
- package/skills/pre-handoff-verification/references/text-only-mode-handling.md +36 -0
- package/skills/preview-report/EVAL.md +39 -0
- package/skills/preview-report/SKILL.md +254 -0
- package/skills/preview-report/contract.json +141 -0
- package/skills/preview-report/references/handoff-recipients.md +41 -0
- package/skills/preview-report/references/report-schema.md +60 -0
- package/skills/preview-report/references/truth-label-rules.md +36 -0
- package/skills/product-grid-scene-planner/EVAL.md +42 -0
- package/skills/product-grid-scene-planner/SKILL.md +246 -0
- package/skills/product-grid-scene-planner/contract.json +257 -0
- package/skills/product-grid-scene-planner/references/grid-consistency-rules.md +53 -0
- package/skills/product-grid-scene-planner/references/grid-layout-rules.md +42 -0
- package/skills/product-grid-scene-planner/references/grid-output-naming-rules.md +52 -0
- package/skills/product-hero-scene-planner/EVAL.md +33 -0
- package/skills/product-hero-scene-planner/SKILL.md +227 -0
- package/skills/product-hero-scene-planner/contract.json +228 -0
- package/skills/product-hero-scene-planner/references/clarification-patterns.md +24 -0
- package/skills/product-hero-scene-planner/references/cyberpunk-shoe-example.md +28 -0
- package/skills/product-hero-scene-planner/references/product-hero-playbooks.md +22 -0
- package/skills/product-hero-scene-planner/references/scene-plan-schema.md +35 -0
- package/skills/r3f-component-plan/EVAL.md +43 -0
- package/skills/r3f-component-plan/SKILL.md +290 -0
- package/skills/r3f-component-plan/contract.json +171 -0
- package/skills/r3f-component-plan/references/component-shape-patterns.md +54 -0
- package/skills/r3f-component-plan/references/suspense-placement-rules.md +50 -0
- package/skills/r3f-component-plan/references/usegltf-caching-rules.md +53 -0
- package/skills/recipe-fit-assessor/EVAL.md +28 -0
- package/skills/recipe-fit-assessor/SKILL.md +266 -0
- package/skills/recipe-fit-assessor/contract.json +220 -0
- package/skills/recipe-fit-assessor/references/recipe-catalog.md +30 -0
- package/skills/recipe-fit-assessor/references/scope-gap-rules.md +27 -0
- package/skills/recipe-fit-assessor/references/workflow-recommendation-template.md +34 -0
- package/skills/render-export-evidence/EVAL.md +86 -0
- package/skills/render-export-evidence/SKILL.md +339 -0
- package/skills/render-export-evidence/contract.json +206 -0
- package/skills/render-export-evidence/references/attempted-vs-failed-rubric.md +75 -0
- package/skills/render-export-evidence/references/evidence-record-templates.md +143 -0
- package/skills/render-export-evidence/references/truth-label-decision-tree.md +57 -0
- package/skills/resolution-aspect-decision/EVAL.md +26 -0
- package/skills/resolution-aspect-decision/SKILL.md +246 -0
- package/skills/resolution-aspect-decision/contract.json +160 -0
- package/skills/resolution-aspect-decision/references/aspect-defaults.md +41 -0
- package/skills/resolution-aspect-decision/references/print-vs-screen-rules.md +58 -0
- package/skills/resolution-aspect-decision/references/resolution-defaults.md +64 -0
- package/skills/runtime-attempt-report/EVAL.md +26 -0
- package/skills/runtime-attempt-report/SKILL.md +268 -0
- package/skills/runtime-attempt-report/contract.json +176 -0
- package/skills/runtime-attempt-report/references/attempt-record-template.md +49 -0
- package/skills/runtime-attempt-report/references/triage-next-steps.md +15 -0
- package/skills/runtime-attempt-report/references/truth-label-blocks.md +27 -0
- package/skills/runtime-path-picker/EVAL.md +26 -0
- package/skills/runtime-path-picker/SKILL.md +268 -0
- package/skills/runtime-path-picker/contract.json +191 -0
- package/skills/runtime-path-picker/references/anti-patterns.md +14 -0
- package/skills/runtime-path-picker/references/decision-tree.md +29 -0
- package/skills/runtime-path-picker/references/path-constraints-table.md +18 -0
- package/skills/runtime-readiness/EVAL.md +33 -0
- package/skills/runtime-readiness/SKILL.md +218 -0
- package/skills/runtime-readiness/contract.json +190 -0
- package/skills/runtime-readiness/references/blocker-report-template.md +28 -0
- package/skills/runtime-readiness/references/evidence-examples.md +23 -0
- package/skills/runtime-readiness/references/readiness-matrix.md +46 -0
- package/skills/runtime-setup/EVAL.md +33 -0
- package/skills/runtime-setup/SKILL.md +209 -0
- package/skills/runtime-setup/contract.json +171 -0
- package/skills/runtime-setup/references/runtime-option-decision-tree.md +28 -0
- package/skills/runtime-setup/references/setup-summary-template.md +33 -0
- package/skills/runtime-setup/references/source-confidence-labels.md +23 -0
- package/skills/scene-readiness/EVAL.md +33 -0
- package/skills/scene-readiness/SKILL.md +195 -0
- package/skills/scene-readiness/contract.json +198 -0
- package/skills/scene-readiness/references/blocker-catalog.md +24 -0
- package/skills/scene-readiness/references/not-run-handling.md +22 -0
- package/skills/scene-readiness/references/quality-rubric.md +23 -0
- package/skills/scene-readiness/references/verdict-language.md +22 -0
- package/skills/scope-guard/EVAL.md +33 -0
- package/skills/scope-guard/SKILL.md +222 -0
- package/skills/scope-guard/contract.json +171 -0
- package/skills/scope-guard/references/options-language-template.md +51 -0
- package/skills/scope-guard/references/recurring-creep-patterns.md +55 -0
- package/skills/scope-guard/references/scope-addition-classification.md +55 -0
- package/skills/stage-gates/EVAL.md +40 -0
- package/skills/stage-gates/SKILL.md +257 -0
- package/skills/stage-gates/contract.json +490 -0
- package/skills/stage-gates/references/failed-gate-handling.md +42 -0
- package/skills/stage-gates/references/gate-template.md +46 -0
- package/skills/stage-gates/references/stage-decomposition-patterns.md +55 -0
- package/skills/workflow-stage-router/EVAL.md +25 -0
- package/skills/workflow-stage-router/SKILL.md +259 -0
- package/skills/workflow-stage-router/contract.json +150 -0
- package/skills/workflow-stage-router/references/milestone-model.md +20 -0
- package/skills/workflow-stage-router/references/routing-decision-tree.md +32 -0
- package/skills/workflow-stage-router/references/stage-handoff-template.md +37 -0
- package/skills.sh.json +102 -0
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
All notable changes to BlendOps are documented here. BlendOps is a **production v1.0.0**
|
|
4
|
+
content and tooling layer (skills + contracts + laws + packs + CLI); it does not own runtime execution,
|
|
5
|
+
which is redirected to upstream (Blender Lab MCP, Anthropic Connector,
|
|
6
|
+
community `mcp-for-blender`, Blender CLI).
|
|
7
|
+
|
|
8
|
+
## [v1.0.0] - Production Release
|
|
9
|
+
|
|
10
|
+
### Added & Changed
|
|
11
|
+
- **Production Release Normalization (`v1.0.0`)**:
|
|
12
|
+
- Promoted package metadata, JSON Schemas, CLI version (`1.0.0`), documentation, install targets (`26` docs, `35+` CLI targets), adapters (`6`), packs, laws, bundles, and review guides from draft snapshots to clean `v1.0.0`.
|
|
13
|
+
- Removed obsolete intermediate development phase snapshots and promoted current-state audit truth (`docs/audits/current/*`) to `v1.0.0-current` (`87.0/100`, `48/48` contracted skills, `269/269` deterministic eval cases passing, `90/90` bilingual retrieval evals passing).
|
|
14
|
+
- Normalized descriptive test suite filenames across `scripts/test-*.mjs` and removed legacy draft/phase inspector scaffolding from `scripts/dev-server.mjs`.
|
|
15
|
+
- **Skill & Reference Hardening (`skills/*/references/*.md`)**:
|
|
16
|
+
- Enriched all **151/151 skill reference guides** (Principled BSDF PBR numeric lookup tables, multi-engine Web/Unreal/Unity/Godot export parity, 6-gate mesh/UV QA tolerances, AgX vs Khronos PBR Neutral tone-mapping rules, Reference-Image-Match silhouette loops, and Superpowers-style verification rubrics).
|
|
17
|
+
- Updated runtime readiness matrices (`skills/runtime-readiness/references/readiness-matrix.md`) and attempt record templates (`skills/runtime-attempt-report/references/attempt-record-template.md`) for complete v1.0.0 operator provenance capture.
|
|
18
|
+
- **Secure Async MCP Client, Runtime Governance & `skills.sh` Compatibility (`scripts/runtime-orchestrator.mjs`, `scripts/install-skills.mjs`, `skills.sh.json`, `registry/runtime-operations.json`)**:
|
|
19
|
+
- Added `@modelcontextprotocol/sdk@1.32.2` async STDIO and Streamable HTTP client (`connectMcpRuntimeClient`), 7-state connection lifecycle, 4-part SHA-256 tool contract fingerprinting, unforgeable mock-fixture provenance, 7-check rollback verification, output staging + `gltf-validator` helpers, governed live read-only (`L0`) inspection, deterministic CLI exit codes `0..7`, root `skills.sh.json` 8-group catalog, `vercel-labs/skills` Lockfile v2 (`skills-lock.json`), and `--with-skills-dir` + `--skill <slug>` installation with transactional rollback.
|
|
20
|
+
- **Repository Architecture & Finalization (`scripts/validate-repository-architecture.mjs`, `docs/audits/current/repository-inventory.json`)**:
|
|
21
|
+
- Complete machine-readable repository inventory classifying tracked files, automated internal reference & schema integrity verification (`npm run arch:check`), `.gitattributes` and `.editorconfig` cross-platform hygiene, and comprehensive architecture documentation (`docs/architecture.md`).
|
|
22
|
+
- **Web-Ready GLB Delivery & Viewer Integration (`schemas/glb-web-handoff-manifest.schema.json`, `scripts/inspect-glb.mjs`, `scripts/generate-glb-handoff-report.mjs`, `docs/examples/glb-web-handoff/`)**:
|
|
23
|
+
- GLB 2.0 scene hierarchy, accessor bounds, extension, and URI safety inspection, deterministic JSON/Markdown/HTML web handoff reports, CLI subcommands (`blendops glb-inspect`, `blendops glb-handoff`, `blendops glb-validate-manifest`), and Three.js / React Three Fiber viewer modules.
|
|
24
|
+
- **Distributable CLI & Safe Project-Local Installer (`bin/blendops.mjs`, `scripts/install-skills.mjs`)**:
|
|
25
|
+
- Added `blendops` CLI entrypoint, `package.json` `"bin"` and `"files"` allowlist for `npm pack` tarballs, public-release metadata (`publishConfig.access: public`), `--doctor`, `--dry-run`, `--write`, and `--rollback` with transactional journals and SHA-256 ownership tracking.
|
|
26
|
+
|
|
27
|
+
### Truth-State Posture
|
|
28
|
+
- In-repo live Blender runtime status remains `Not Run` and live Blender artifacts remain `Not Produced`.
|
|
29
|
+
- Public npm distribution is live as [`blendops@1.0.0`](https://www.npmjs.com/package/blendops) (`latest` dist-tag); the repository's Agent Skills source is also [listed on skills.sh](https://www.skills.sh/ThanhNguyxnOrg/blendops). Official marketplace/plugin listings remain unpublished.
|
|
30
|
+
|
|
31
|
+
## [v0.8.0-draft] — 2026-10-16
|
|
32
|
+
|
|
33
|
+
Skills-layer review hardening + runtime consistency.
|
|
34
|
+
|
|
35
|
+
### Changed
|
|
36
|
+
- All 48 skills hardened through external review packets: role boundaries,
|
|
37
|
+
truth-state discipline (`Not Run` runtime / `Not Produced` artifact,
|
|
38
|
+
downgrade-only), cross-skill handoff wiring.
|
|
39
|
+
- Runtime docs swept to the 2-path + CLI appendix model (Path 1 Lab MCP in
|
|
40
|
+
Blender 5.1+ via Anthropic Connector or manual host; Path 2 community
|
|
41
|
+
`mcp-for-blender`; CLI appendix-only, never a peer path).
|
|
42
|
+
|
|
43
|
+
## [v0.7.0-draft]
|
|
44
|
+
- 26 install targets.
|
|
45
|
+
|
|
46
|
+
## [v0.6.0-draft]
|
|
47
|
+
- 20 install targets.
|
|
48
|
+
|
|
49
|
+
## [v0.5.0-draft]
|
|
50
|
+
- 48 skills.
|
|
51
|
+
|
|
52
|
+
## [v0.4.0-draft]
|
|
53
|
+
- 40 skills.
|
|
54
|
+
|
|
55
|
+
## [v0.3.0-draft]
|
|
56
|
+
- 32 skills.
|
|
57
|
+
|
|
58
|
+
## [v0.2.0-draft]
|
|
59
|
+
- 24 skills.
|
|
60
|
+
|
|
61
|
+
## [v0.1.0-draft]
|
|
62
|
+
- 16 baseline skills.
|
|
63
|
+
|
|
64
|
+
## [1.0.1] - 2026-11-20
|
|
65
|
+
|
|
66
|
+
### Bug Fixes and Performance
|
|
67
|
+
|
|
68
|
+
- SemVer 2.0 prerelease order, exact skills.sh matching, <=255 description, and CodeQL-clean tests ([12a7a12](https://github.com/ThanhNguyxnOrg/blendops/commit/12a7a1257d740441d2e212df5f482e7819d0abab))
|
|
69
|
+
- restore original scripts, files, and keywords while keeping <=255 char description ([9cc3de8](https://github.com/ThanhNguyxnOrg/blendops/commit/9cc3de808a567b99d4d6420bf5b8ce1ae5042266))
|
|
70
|
+
|
|
71
|
+
## [1.1.0] - 2026-11-21
|
|
72
|
+
|
|
73
|
+
Re-declared at 466a4a92232b after prepared commit fcd0a0e8eb2f failed its required checks.
|
|
74
|
+
|
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 BlendOps Contributors
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,209 @@
|
|
|
1
|
-
|
|
1
|
+
<div align="center">
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
<picture>
|
|
4
|
+
<source media="(prefers-color-scheme: dark)" srcset=".github/assets/logo.png" />
|
|
5
|
+
<source media="(prefers-color-scheme: light)" srcset=".github/assets/logo-dark.png" />
|
|
6
|
+
<img src=".github/assets/logo.png" alt="BlendOps logo" width="140" />
|
|
7
|
+
</picture>
|
|
8
|
+
|
|
9
|
+
# 🦾 BlendOps
|
|
10
|
+
|
|
11
|
+
**AI-native Blender workflow specs for people who do not know Blender.**
|
|
12
|
+
|
|
13
|
+
[](./LICENSE)
|
|
14
|
+
[](https://www.npmjs.com/package/blendops)
|
|
15
|
+
[](./docs/release-readiness.md)
|
|
16
|
+
[](./docs/runtime-stack-strategy.md)
|
|
17
|
+
[](./docs/evals/blender-connector-read-only-smoke-test.md)
|
|
18
|
+
[](./docs/unofficial-runtime-bridges.md)
|
|
19
|
+
[](./docs/release-readiness.md)
|
|
20
|
+
[](./docs/release-readiness.md)
|
|
21
|
+
[](https://github.com/ThanhNguyxnOrg/blendops/releases/tag/v1.0.0)
|
|
22
|
+
|
|
23
|
+
[](./skills/README.md)
|
|
24
|
+
[](./laws/README.md)
|
|
25
|
+
[](./packs/README.md)
|
|
26
|
+
[](./docs/install/README.md)
|
|
27
|
+
[](./docs/adapters/README.md)
|
|
28
|
+
[](./bundles/)
|
|
29
|
+
|
|
30
|
+
|
|
31
|
+
[-d97757.svg?style=flat-square)](https://claude.com/resources/tutorials/using-the-blender-connector-in-claude)
|
|
32
|
+
[-f5792a.svg?style=flat-square)](https://www.blender.org/lab/mcp-server/)
|
|
33
|
+
[-181717.svg?style=flat-square&logo=github)](https://github.com/ahujasid/mcp-for-blender)
|
|
34
|
+
|
|
35
|
+
[](./docs/install/claude-code.md)
|
|
36
|
+
[](./docs/install/cursor.md)
|
|
37
|
+
[](./docs/install/codex.md)
|
|
38
|
+
[](./docs/install/cline.md)
|
|
39
|
+
[](./docs/install/continue.md)
|
|
40
|
+
[](./docs/install/zed.md)
|
|
41
|
+
[-FF8C00.svg?style=flat-square)](./docs/install/goose.md)
|
|
42
|
+
[](./docs/install/roo-code.md)
|
|
43
|
+
[](./docs/install/windsurf.md)
|
|
44
|
+
[](./docs/install/openhands.md)
|
|
45
|
+
[](./docs/install/jetbrains-junie.md)
|
|
46
|
+
[-4285F4.svg?style=flat-square)](./docs/install/antigravity.md)
|
|
47
|
+
[](./docs/install/blackbox-ai.md)
|
|
48
|
+
[](./docs/install/augment-code.md)
|
|
49
|
+
[](./docs/install/aider.md)
|
|
50
|
+
[-ef4444.svg?style=flat-square)](./docs/install/trae.md)
|
|
51
|
+
[](./docs/install/sourcegraph-cody.md)
|
|
52
|
+
[](./docs/install/amazon-q-developer.md)
|
|
53
|
+
[](./docs/install/README.md)
|
|
54
|
+
|
|
55
|
+
[](./docs/install/ollama.md)
|
|
56
|
+
[](./docs/install/lm-studio.md)
|
|
57
|
+
[](./docs/install/open-webui.md)
|
|
58
|
+
|
|
59
|
+
</div>
|
|
60
|
+
|
|
61
|
+
> [!IMPORTANT]
|
|
62
|
+
> This README is a quick skim. **Full documentation lives in [`docs/README.md`](./docs/README.md)** — bookmark that page for everything (specs, runtime, install, evals, laws, skills, recipes, research).
|
|
63
|
+
|
|
64
|
+
---
|
|
65
|
+
|
|
66
|
+
## ✨ What it is, in 3 lines
|
|
67
|
+
|
|
68
|
+
- A **portable AI-agent Skills pack for Blender**, built for users who don't know Blender.
|
|
69
|
+
- A **content layer** (`SKILL.md`-based) that loads inside any compatible AI agent.
|
|
70
|
+
- **Complements** Anthropic Blender Connector + Blender Lab MCP — does **not** replace them.
|
|
71
|
+
|
|
72
|
+
```txt
|
|
73
|
+
Human intent (non-Blender user)
|
|
74
|
+
→ BlendOps Skills (planning · readiness · evidence · handoff)
|
|
75
|
+
→ external Blender runtime (Path 1 Lab MCP / Path 2 community / CLI)
|
|
76
|
+
→ validated artifacts + non-Blender-user response
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
---
|
|
80
|
+
|
|
81
|
+
## 🎯 Scope (what BlendOps is and isn't)
|
|
82
|
+
|
|
83
|
+
| BlendOps **publishes** (this repo's deliverable) | BlendOps **redirects to** (upstream — not this repo's work) |
|
|
84
|
+
|---|---|
|
|
85
|
+
| 48 skills (baseline + web 3D deep + quality validators + domain planners + process discipline + asset/sourcing + color/format/output + recipe/pack ops + runtime path discipline, …) | **Path 1 — Blender Lab MCP** (Lab add-on + Lab server). Owner: Blender Foundation. Source: [blender.org/lab/mcp-server](https://www.blender.org/lab/mcp-server/) |
|
|
86
|
+
| 4 laws (evidence-before-done, official-runtime-only, no-arbitrary-python-interface, non-blender-user-language) | **Path 1 host (a) — Anthropic Blender Connector** (Claude-Desktop-specific MCP host). Owner: Anthropic. Source: [claude.com/.../using-the-blender-connector-in-claude](https://claude.com/resources/tutorials/using-the-blender-connector-in-claude) |
|
|
87
|
+
| 1 pack (`product-hero-v0`), 3 bundles (skill-package, claude-desktop-manual, generic-project-local) | **Path 2 — Community `mcp-for-blender` (formerly `blender-mcp`)** (different add-on/server). Owner: mature community project. Source: [github.com/ahujasid/mcp-for-blender](https://github.com/ahujasid/mcp-for-blender) |
|
|
88
|
+
| 26 install target docs + **35+ CLI targets** (`--with-skills-dir`, `skills.sh.json`, `skills-lock.json` v2) + 3 mode auto-detect install flow | **CLI fallback** (`blender --background --python ...`). Owner: Blender Foundation. Source: [docs.blender.org/manual/.../command_line](https://docs.blender.org/manual/en/latest/advanced/command_line/index.html) |
|
|
89
|
+
| Skill ZIP / OpenAI YAML / canonical bundle generation (`npm run skills:export` → 48 ZIPs, one per `skills/*/SKILL.md`) + distributable local CLI (`bin/blendops.mjs` / `scripts/install-skills.mjs`, packable via `npm pack`) + GLB 2.0 web handoff toolkit (`blendops glb-inspect`, `blendops glb-handoff`, `blendops glb-validate-manifest`, Three.js & R3F integration examples in [`docs/examples/glb-web-handoff/README.md`](./docs/examples/glb-web-handoff/README.md)) | The Blender executable, MCP servers, MCP host clients, OS, GPU drivers, network. |
|
|
90
|
+
|
|
91
|
+
**What this means for "completeness":**
|
|
92
|
+
|
|
93
|
+
- The **skills layer** (48 skills + 151 deep reference guides across 8 `skills.sh.json` groups + 26 install docs + 35+ CLI targets + ZIP/package export + deterministic CI guards) is **complete and production-ready at `v1.0.0`** — nothing upstream blocks it. Milestones: `v0.4.0-draft` (40 skills) → `v0.5.0-draft` (48 skills) → `v0.8.0-draft` (hardening) → `v0.9.0-draft` (catalog & CLI readiness) → **`v1.0.0` (production release)**.
|
|
94
|
+
- Whether the **upstream runtime paths work in your environment** is up to upstream Blender Foundation / Anthropic / community `mcp-for-blender` (Path 1 + Path 2 are user-reported verified by the repo owner — operator statement, does not promote eval scope; CLI is upstream-documented). BlendOps **redirects** to them via per-target install docs but does not own their stability.
|
|
95
|
+
- The "Full runtime eval: Not Run" / "Artifacts: Not Produced" labels refer to **in-repo provenance evidence files only** — operator-side records under `docs/evals/`. They do **not** mean "the upstream runtime paths don't work" or "BlendOps is incomplete."
|
|
96
|
+
|
|
97
|
+
---
|
|
98
|
+
|
|
99
|
+
## 🧭 10-Second Skill Decision Tree
|
|
100
|
+
|
|
101
|
+
Start at `blendops-help` or jump straight into the narrowest group from [`skills.sh.json`](./skills.sh.json) and [`skills/README.md`](./skills/README.md):
|
|
102
|
+
|
|
103
|
+
```txt
|
|
104
|
+
Goal unclear or messy request? ──▶ blendops-help / blender-brainstorming ──▶ intent-to-3d-brief-writer
|
|
105
|
+
Know what you want to build? ──▶ recipe-fit-assessor / workflow-stage-router
|
|
106
|
+
├─ Product / Catalog ──▶ product-hero-scene-planner / product-grid-scene-planner
|
|
107
|
+
├─ Character / Env ──▶ character-portrait / environment-shot / interior-scene
|
|
108
|
+
└─ Complex (4+ steps)──▶ blender-recipe-decomposer ──▶ stage-gates ──▶ done-criteria
|
|
109
|
+
Need visual / budget checks? ──▶ lighting-quality-checker • material-quality-checker • composition-quality-checker • polycount-budget-checker
|
|
110
|
+
Need render / format rules? ──▶ color-management-decision • cycles-vs-eevee-decision • resolution-aspect-decision • output-format-decision
|
|
111
|
+
Ready for Web 3D / GLB? ──▶ mobile-glb-budget ──▶ glb-animation-handoff / r3f-component-plan ──▶ glb-web-handoff
|
|
112
|
+
Setting up or auditing runtime? ──▶ runtime-path-picker ──▶ runtime-readiness ──▶ runtime-attempt-report (or bridge-conflicts)
|
|
113
|
+
Ready to deliver / claim Pass? ──▶ scene-readiness ──▶ render-export-evidence ──▶ pre-handoff-verification ──▶ plain-language-response
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
---
|
|
117
|
+
|
|
118
|
+
## ⚡ Use in 30 seconds
|
|
119
|
+
|
|
120
|
+
### Option 1 — Universal Agent Prompt (works in any chat or IDE agent)
|
|
121
|
+
|
|
122
|
+
Paste this into any AI agent:
|
|
123
|
+
|
|
124
|
+
```txt
|
|
125
|
+
Read and follow the BlendOps AI Agent Quickstart:
|
|
126
|
+
https://raw.githubusercontent.com/ThanhNguyxnOrg/blendops/main/docs/ai-agent-quickstart.md
|
|
127
|
+
|
|
128
|
+
Auto-detect your environment first, then pick one mode:
|
|
129
|
+
- If you have project filesystem write access → Mode A: install BlendOps project-locally (skills/, laws/, packs/, target-specific entrypoint).
|
|
130
|
+
- If you are in a chat-only UI (Claude Desktop chat, Claude.ai, ChatGPT) with no filesystem write → Mode B: output 48 separate ZIPs from skills/*/SKILL.md (one ZIP per skill) for me to drag-drop into the Skills UI manually.
|
|
131
|
+
- If you cannot fetch the repo, cannot write, AND cannot output ZIPs → Mode C: ask one concise question.
|
|
132
|
+
|
|
133
|
+
Do not install Blender, configure runtime connectors, run Blender, or claim generated artifacts. Report the selected mode, files changed or ZIP filenames, runtime status, artifact status, and limitations.
|
|
134
|
+
```
|
|
135
|
+
|
|
136
|
+
### Option 2 — Install BlendOps Agent Skills
|
|
137
|
+
|
|
138
|
+
The BlendOps GitHub repository is already listed on [skills.sh](https://www.skills.sh/ThanhNguyxnOrg/blendops). Install the skill collection with the Agent Skills CLI:
|
|
139
|
+
|
|
140
|
+
```bash
|
|
141
|
+
npx skills add ThanhNguyxnOrg/blendops
|
|
142
|
+
```
|
|
143
|
+
|
|
144
|
+
The Skills CLI guides you through choosing skills and supported agent targets. The repository's `skills.sh.json` defines eight display groups for the listing. It is source metadata; no ZIP upload or separate npm publication is required for skills.sh.
|
|
145
|
+
|
|
146
|
+
### Option 3 — Install and run the published BlendOps npm CLI
|
|
147
|
+
|
|
148
|
+
The public npm package is `blendops@1.0.0` (dist-tag `latest`). No clone or global install is required:
|
|
149
|
+
|
|
150
|
+
```bash
|
|
151
|
+
npx blendops --help
|
|
152
|
+
npx blendops doctor --project .
|
|
153
|
+
npx blendops install --target auto --project . --dry-run
|
|
154
|
+
npx blendops install --target auto --project . --write
|
|
155
|
+
```
|
|
156
|
+
|
|
157
|
+
Review the dry-run plan before running the matching `--write`. The installer changes only the selected project; it does not install Blender or configure an MCP runtime.
|
|
158
|
+
|
|
159
|
+
### Option 4 — Local checkout installer
|
|
160
|
+
|
|
161
|
+
For contributors working from a local clone, use the repository scripts:
|
|
162
|
+
|
|
163
|
+
```bash
|
|
164
|
+
npm run skills:install -- --target universal --project /path/to/your-project --with-skills-dir --dry-run
|
|
165
|
+
npm run skills:install -- --target universal --project /path/to/your-project --with-skills-dir --write
|
|
166
|
+
```
|
|
167
|
+
|
|
168
|
+
The agent auto-detects which mode applies. Coding agents (Claude Code, Cursor, Codex, OpenCode, Cline, Roo Code, Blackbox AI, Continue, Zed, Windsurf, Trae, Augment Code, goose, OpenHands, JetBrains Junie, Sourcegraph Cody, Aider, Amazon Q Developer, Gemini, Copilot, Antigravity, Kiro, Amp, Droid, Kilo, OpenClaw, ClawdBot, VS Code, universal `.agents/skills/`) hit **Mode A** and install **project-locally**. Claude Desktop / Claude.ai / ChatGPT chats hit **Mode B** and output **separate ZIPs from skills/*/SKILL.md** (one per skill, 48 total) for you to drag-drop into the Skills UI manually. Anything else falls back to **Mode C — blocked-needs-input**. Full mode logic in [`docs/ai-agent-install-flow.md`](./docs/ai-agent-install-flow.md).
|
|
169
|
+
|
|
170
|
+
---
|
|
171
|
+
|
|
172
|
+
## 🧭 Runtime in one paragraph
|
|
173
|
+
|
|
174
|
+
BlendOps recognizes **2 MCP execution paths + a CLI fallback appendix** ([full doc](./docs/runtime-stack-strategy.md)):
|
|
175
|
+
|
|
176
|
+
- **Path 1 — Official Blender Lab MCP** (Lab add-on + Lab server installed in Blender 5.1+, hosted from either (a) **Anthropic Blender Connector** in Claude Desktop, or (b) any other MCP client configured manually).
|
|
177
|
+
- **Path 2 — Community `mcp-for-blender` (formerly `blender-mcp`)** (different add-on/server, mature third-party, Blender 3.0+).
|
|
178
|
+
- **CLI fallback (appendix)** — direct `blender --background --python`. Documented upstream as a first-class Blender CLI surface; no in-repo evidence file yet.
|
|
179
|
+
|
|
180
|
+
> [!WARNING]
|
|
181
|
+
> **Anthropic Connector is not standalone.** Anthropic's tutorial step 2 explicitly tells you to install the Blender Lab MCP add-on inside Blender. The Connector is the Claude-Desktop-specific MCP host on top of the Lab stack. **Path 1 needs Blender 5.1+ regardless of host** because of the Lab add-on manifest.
|
|
182
|
+
|
|
183
|
+
---
|
|
184
|
+
|
|
185
|
+
## 📚 Read more
|
|
186
|
+
|
|
187
|
+
| Want to | Open |
|
|
188
|
+
|---|---|
|
|
189
|
+
| **Read everything (the hub)** | [`docs/README.md`](./docs/README.md) |
|
|
190
|
+
| 5-minute orientation | [`docs/start-here.md`](./docs/start-here.md) |
|
|
191
|
+
| Set up Blender runtime | [`docs/external-runtime-setup.md`](./docs/external-runtime-setup.md) |
|
|
192
|
+
| Install BlendOps in your AI tool | [`docs/install/README.md`](./docs/install/README.md) |
|
|
193
|
+
| Inspect a GLB & generate a web handoff report (Three.js / R3F) | [`docs/examples/glb-web-handoff/README.md`](./docs/examples/glb-web-handoff/README.md) |
|
|
194
|
+
| Browse skills / laws / packs | [`skills/README.md`](./skills/README.md) · [`laws/README.md`](./laws/README.md) · [`packs/README.md`](./packs/README.md) |
|
|
195
|
+
| Check release readiness | [`docs/release-readiness.md`](./docs/release-readiness.md) |
|
|
196
|
+
| Inspect repository architecture & file inventory | [`docs/architecture.md`](./docs/architecture.md) · [`docs/audits/current/repository-inventory.json`](./docs/audits/current/repository-inventory.json) |
|
|
197
|
+
| See the canonical portable skill package | [`bundles/skill-package/blendops/`](./bundles/skill-package/blendops/) |
|
|
198
|
+
|
|
199
|
+
---
|
|
200
|
+
|
|
201
|
+
## 🚫 What it does **not** do
|
|
202
|
+
|
|
203
|
+
BlendOps does not install Blender, ship its own runtime, configure Anthropic Connector or the Lab MCP add-on for you, run Blender, claim mutation/render/export artifacts, or claim an official marketplace/plugin listing. npm and skills.sh provide content/CLI distribution only; Blender runtime setup is separate. See [`docs/release-readiness.md`](./docs/release-readiness.md) for the honest current state.
|
|
204
|
+
|
|
205
|
+
---
|
|
206
|
+
|
|
207
|
+
## 📄 License
|
|
208
|
+
|
|
209
|
+
MIT — see [`LICENSE`](./LICENSE).
|
package/bin/blendops.mjs
ADDED
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
# BlendOps Single-File Fallback (Claude Desktop)
|
|
2
|
+
|
|
3
|
+
Status: 1.0.0 fallback only
|
|
4
|
+
|
|
5
|
+
> [!IMPORTANT]
|
|
6
|
+
> This file is a **fallback only**. It is less complete than the full manual bundle (`SKILL.md` + `references/`). Use this only when your Claude Desktop import/copy path supports one file.
|
|
7
|
+
|
|
8
|
+
## Condensed skill map (baseline 16 — full inventory: 48 skills)
|
|
9
|
+
|
|
10
|
+
The routes below cover the canonical baseline workflow (full inventory: **48 skills** = 16 core + 32 specialized across web 3D handoff deep, quality validators, domain scene planners, process discipline, asset/sourcing, color/format/output decisions, recipe/pack ops, runtime path discipline). For the full inventory, switch to the multi-file bundle (`bundles/claude-desktop-manual/references/skills/*.md`) or browse `skills/README.md` upstream. When in doubt, route to `blendops-help`.
|
|
11
|
+
|
|
12
|
+
Baseline routes:
|
|
13
|
+
- unclear next step → `blendops-help`
|
|
14
|
+
- vague creative request, intent exploration → `blender-brainstorming` (Superpowers `/brainstorming` analog)
|
|
15
|
+
- convert intent → 8-slot 3D brief → `intent-to-3d-brief-writer` (BMad analysis-phase analog)
|
|
16
|
+
- per-asset acquisition strategy → `asset-discovery`
|
|
17
|
+
- runtime setup prerequisites → `runtime-setup`
|
|
18
|
+
- runtime preflight/readiness → `runtime-readiness`
|
|
19
|
+
- MCP bridge conflicts (Path 1 + Path 2 + port 9876) → `bridge-conflicts`
|
|
20
|
+
- scene planning → `product-hero-scene-planner`
|
|
21
|
+
- composition/camera planning → `camera-composition`
|
|
22
|
+
- lighting/material planning → `lighting-material-plan`
|
|
23
|
+
- quality gate decision → `scene-readiness`
|
|
24
|
+
- output looks wrong, root-cause analysis → `blender-troubleshooting` (Superpowers `/systematic-debugging` analog)
|
|
25
|
+
- artifact truth/evidence → `render-export-evidence`
|
|
26
|
+
- 7-point gate before any "ready" / `Verified` claim → `pre-handoff-verification` (Superpowers `/verification-before-completion` analog)
|
|
27
|
+
- GLB/web handoff framing → `glb-web-handoff`
|
|
28
|
+
- plain-language final answer → `plain-language-response`
|
|
29
|
+
|
|
30
|
+
Expansion routes (load via the multi-file bundle for full SKILL.md content):
|
|
31
|
+
- recipe/pack fit → `recipe-fit-assessor`; pre-flight → `pack-prerequisite-checker`; resume routing → `workflow-stage-router`; acceptance criteria → `acceptance-criteria-builder`
|
|
32
|
+
- runtime path discipline: `runtime-path-picker`, `path-one-host-outline`, `cli-appendix-job-outline`, `runtime-attempt-report`
|
|
33
|
+
- web 3D deep: `mobile-glb-budget`, `glb-animation-handoff`, `r3f-component-plan`, `preview-report`
|
|
34
|
+
- quality validators: `material-quality-checker`, `lighting-quality-checker`, `composition-quality-checker`, `polycount-budget-checker`
|
|
35
|
+
- domain scene planners: `character-portrait`, `environment-shot`, `interior-scene`, `product-grid-scene-planner`
|
|
36
|
+
- process discipline: `stage-gates`, `done-criteria`, `scope-guard`, `blender-recipe-decomposer`
|
|
37
|
+
- asset/sourcing: `asset-license-checker`, `asset-style-check`, `asset-fallback-strategy`, `asset-library-plan`
|
|
38
|
+
- color/format/output: `color-management-decision`, `output-format-decision`, `resolution-aspect-decision`, `cycles-vs-eevee-decision`
|
|
39
|
+
|
|
40
|
+
## Runtime boundary
|
|
41
|
+
|
|
42
|
+
Skill guidance is not runtime setup.
|
|
43
|
+
|
|
44
|
+
Do not claim this file:
|
|
45
|
+
- installs Blender,
|
|
46
|
+
- configures Claude Desktop Connector,
|
|
47
|
+
- configures official Blender MCP bridge/add-on,
|
|
48
|
+
- runs Blender/runtime eval,
|
|
49
|
+
- produces preview/render/GLB artifacts.
|
|
50
|
+
|
|
51
|
+
## Runtime paths
|
|
52
|
+
|
|
53
|
+
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.
|
|
54
|
+
2. **Path 2 — Community `mcp-for-blender` (formerly `blender-mcp`).** Different add-on/server. Mature third-party, Blender 3.0+.
|
|
55
|
+
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.
|
|
56
|
+
|
|
57
|
+
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).
|
|
58
|
+
|
|
59
|
+
## Evidence rules
|
|
60
|
+
|
|
61
|
+
Use explicit states:
|
|
62
|
+
- Runtime: `Not Run | Attempted | Produced | Verified | Failed`
|
|
63
|
+
- Artifact: `Not Produced | Produced | Verified | Failed`
|
|
64
|
+
|
|
65
|
+
No preview/render/GLB claim without evidence.
|
|
66
|
+
|
|
67
|
+
## Condensed output template
|
|
68
|
+
|
|
69
|
+
```md
|
|
70
|
+
## BlendOps fallback response
|
|
71
|
+
|
|
72
|
+
- Route:
|
|
73
|
+
- Runtime status:
|
|
74
|
+
- Artifact status:
|
|
75
|
+
- Evidence:
|
|
76
|
+
- Caveats:
|
|
77
|
+
- Next action:
|
|
78
|
+
```
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
# Claude Desktop Manual Import Steps (BlendOps)
|
|
2
|
+
|
|
3
|
+
Status: 1.0.0 manual procedure
|
|
4
|
+
|
|
5
|
+
## Important boundaries
|
|
6
|
+
|
|
7
|
+
- Start with the universal prompt in `README.md` when asking an AI/chat to prepare BlendOps.
|
|
8
|
+
- Expected Claude Desktop mode: **skill.zip preparation**.
|
|
9
|
+
- Do not assume a fixed local Claude Desktop skill path.
|
|
10
|
+
- Do not assume an AI agent can click Claude Desktop UI.
|
|
11
|
+
- Treat upload/import/copy as a manual user action.
|
|
12
|
+
- Runtime setup is separate from this bundle import.
|
|
13
|
+
|
|
14
|
+
## Recommended order
|
|
15
|
+
|
|
16
|
+
1. Ask Claude Desktop or another chat assistant to use the universal prompt and prepare `skill.zip` from `bundles/skill-package/blendops/`.
|
|
17
|
+
- ZIP root must contain `SKILL.md`, `agents/openai.yaml`, `references/*.md`, and `LICENSE.txt`.
|
|
18
|
+
- `agents/openai.yaml` is OpenAI/ChatGPT Skills UI metadata only and does not configure Claude Desktop Connector.
|
|
19
|
+
2. Upload/import `skill.zip` if your Claude Desktop workflow supports package upload/import.
|
|
20
|
+
3. Optionally attach `dist/shared-catalog/blendops-knowledge-and-recipes.zip` to Claude Project Knowledge / chat attachments for structured `knowledge.*`, `recipe.*`, and `SceneSpec` lookup (do not upload this archive as a Claude Skill ZIP — it intentionally contains no `SKILL.md`).
|
|
21
|
+
4. If package upload/import is unavailable, manually copy `SKILL.md` plus `references/` from this manual bundle.
|
|
22
|
+
5. Use `BLENDOPS_SINGLE_FILE.md` only when your setup supports one file only.
|
|
23
|
+
|
|
24
|
+
## Manual checklist
|
|
25
|
+
|
|
26
|
+
- [ ] Universal prompt used when asking an AI/chat to prepare the package.
|
|
27
|
+
- [ ] Full `skill.zip` used when possible.
|
|
28
|
+
- [ ] Single-file fallback used only if full bundle was not feasible.
|
|
29
|
+
- [ ] Runtime components were not configured as part of this import.
|
|
30
|
+
- [ ] Runtime eval was not run.
|
|
31
|
+
- [ ] Preview/render/GLB artifacts were not claimed.
|
|
32
|
+
|
|
33
|
+
## Single-file fallback
|
|
34
|
+
|
|
35
|
+
If Claude returns only `BLENDOPS_SINGLE_FILE.md` or a `blendops.md` summary, treat it as fallback only. Ask it to create the full `skill.zip` when possible.
|
|
36
|
+
|
|
37
|
+
## After import
|
|
38
|
+
|
|
39
|
+
Record a manual install note using `INSTALL_REPORT_TEMPLATE.md`.
|
|
40
|
+
|
|
41
|
+
Required status fields:
|
|
42
|
+
- Runtime status: `Not Run`
|
|
43
|
+
- Artifact status: `Not Produced`
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
# BlendOps Claude Desktop Manual Install Report
|
|
2
|
+
|
|
3
|
+
Status: 1.0.0 template
|
|
4
|
+
|
|
5
|
+
- Full bundle used: yes/no
|
|
6
|
+
- Single-file fallback used: yes/no
|
|
7
|
+
- Files user imported/copied:
|
|
8
|
+
- Files skipped:
|
|
9
|
+
- Runtime setup performed: No
|
|
10
|
+
- Runtime status: Not Run
|
|
11
|
+
- Artifact status: Not Produced
|
|
12
|
+
- Next action:
|
|
13
|
+
- Notes/limitations:
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
# BlendOps Claude Desktop Manual Bundle
|
|
2
|
+
|
|
3
|
+
Status: 1.0.0 fixture
|
|
4
|
+
Target: `claude-desktop-manual`
|
|
5
|
+
|
|
6
|
+
## What this bundle is
|
|
7
|
+
|
|
8
|
+
This is the Claude Desktop manual bundle for attaching BlendOps guidance. Claude Desktop is one consumer of the canonical portable package; it does not own the package source.
|
|
9
|
+
|
|
10
|
+
It provides:
|
|
11
|
+
- one Claude Desktop-facing router skill (`SKILL.md`),
|
|
12
|
+
- reference summaries for skills, laws, packs, runtime stacks, and evidence rules,
|
|
13
|
+
- one single-file fallback (`BLENDOPS_SINGLE_FILE.md`) for one-file-only import situations.
|
|
14
|
+
|
|
15
|
+
## Preferred vs fallback
|
|
16
|
+
|
|
17
|
+
- **Preferred:** upload/import canonical package source at `bundles/skill-package/blendops/` (or per-skill ZIPs in `dist/claude-skills/desktop-zips/*.zip`). The `agents/openai.yaml` file in that package is OpenAI/ChatGPT Skills UI metadata only and does not configure Claude Desktop Connector.
|
|
18
|
+
- **Shared Knowledge & Recipe Catalog attachment (optional):** attach `dist/shared-catalog/blendops-knowledge-and-recipes.zip` as a Claude Project Knowledge / file attachment (contains `knowledge-catalog.json`, `recipe-catalog.json`, `catalog-index.json`, `knowledge-and-recipe-catalog.md`, and schemas; contains zero `SKILL.md` files and is not a Claude Skill upload ZIP).
|
|
19
|
+
- **Manual copy fallback:** `SKILL.md` + `references/` from this manual bundle
|
|
20
|
+
- **Fallback only:** `BLENDOPS_SINGLE_FILE.md` when import/copy supports only one file
|
|
21
|
+
|
|
22
|
+
The single-file fallback is intentionally less complete than the full bundle.
|
|
23
|
+
|
|
24
|
+
## Runtime boundary
|
|
25
|
+
|
|
26
|
+
This bundle is guidance-only.
|
|
27
|
+
|
|
28
|
+
It does **not**:
|
|
29
|
+
- install Blender,
|
|
30
|
+
- configure Claude Desktop Connector,
|
|
31
|
+
- configure the official Blender MCP bridge/add-on,
|
|
32
|
+
- run Blender,
|
|
33
|
+
- run runtime eval,
|
|
34
|
+
- produce preview/render/GLB artifacts.
|
|
35
|
+
|
|
36
|
+
Runtime status remains `Not Run`. Artifact status remains `Not Produced` until evidence exists.
|
|
37
|
+
|
|
38
|
+
## Installation mode
|
|
39
|
+
|
|
40
|
+
Claude Desktop is a manual/user-managed flow, not a normal coding-agent auto-install target.
|
|
41
|
+
|
|
42
|
+
Use [IMPORT_STEPS.md](./IMPORT_STEPS.md) for upload/import/copy instructions.
|
|
43
|
+
|
|
44
|
+
## Canonical source alignment
|
|
45
|
+
|
|
46
|
+
This bundle is a condensed reference fixture aligned to canonical project sources:
|
|
47
|
+
- `skills/`
|
|
48
|
+
- `laws/`
|
|
49
|
+
- `packs/`
|
|
50
|
+
- `docs/skill-system.md`
|
|
51
|
+
- `docs/runtime-stack-strategy.md`
|
|
52
|
+
- `docs/ai-agent-install-flow.md`
|
|
53
|
+
- `docs/install/claude-desktop.md`
|
|
54
|
+
- `docs/install/installer-spec.md`
|
|
55
|
+
|
|
56
|
+
## Deterministic reference summary generation
|
|
57
|
+
|
|
58
|
+
All 48 per-skill summary files in `bundles/claude-desktop-manual/references/skills/<skill-id>.md` (along with the 48 flattened package summaries in `bundles/skill-package/blendops/references/skill-<skill-id>.md`) are deterministically generated from canonical skill sources:
|
|
59
|
+
|
|
60
|
+
- `skills/<skill-id>/SKILL.md`
|
|
61
|
+
- `skills/<skill-id>/contract.json`
|
|
62
|
+
|
|
63
|
+
Do not manually edit files under `bundles/claude-desktop-manual/references/skills/*.md`. Instead, update the canonical `skills/<skill-id>/SKILL.md` and/or `skills/<skill-id>/contract.json`, then regenerate and verify both bundle profiles:
|
|
64
|
+
|
|
65
|
+
```bash
|
|
66
|
+
npm run bundles:summaries:build
|
|
67
|
+
npm run bundles:summaries:check
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
Non-skill bundle references (`references/skill-map.md`, `references/runtime-stacks.md`, `references/evidence-rules.md`, `references/install-boundary.md`, `references/laws/*.md`, and `references/packs/product-hero-v0.md`) remain preserved as non-generated bundle reference fixtures.
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: blendops-claude-desktop-router
|
|
3
|
+
description: Claude Desktop-facing BlendOps router skill for planning, runtime readiness, evidence truth, and non-Blender-user outputs using bundled references.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# BlendOps Claude Desktop Router Skill
|
|
7
|
+
|
|
8
|
+
## Purpose
|
|
9
|
+
|
|
10
|
+
Provide one main Claude Desktop-facing skill entrypoint that routes to the correct BlendOps reference summary while preserving runtime/artifact truth.
|
|
11
|
+
|
|
12
|
+
## How to use this router
|
|
13
|
+
|
|
14
|
+
1. Classify user intent (help/routing, planning, runtime readiness, evidence, handoff, communication).
|
|
15
|
+
2. Consult `references/skill-map.md` to choose the relevant subskill summary.
|
|
16
|
+
3. Apply law summaries from `references/laws/` before final output.
|
|
17
|
+
4. Keep runtime/artifact states explicit.
|
|
18
|
+
|
|
19
|
+
## Reference-first routing
|
|
20
|
+
|
|
21
|
+
Use these references as needed:
|
|
22
|
+
- skill routing: `references/skill-map.md`
|
|
23
|
+
- runtime stacks: `references/runtime-stacks.md`
|
|
24
|
+
- evidence policy: `references/evidence-rules.md`
|
|
25
|
+
- install/runtime boundary: `references/install-boundary.md`
|
|
26
|
+
- concise subskill summaries: `references/skills/*.md`
|
|
27
|
+
- concise law summaries: `references/laws/*.md`
|
|
28
|
+
- pack summary: `references/packs/product-hero-v0.md`
|
|
29
|
+
|
|
30
|
+
Do not duplicate all subskills in this router. Route and apply the relevant reference file(s).
|
|
31
|
+
|
|
32
|
+
## Runtime and artifact truth
|
|
33
|
+
|
|
34
|
+
Always state:
|
|
35
|
+
- Runtime status: `Not Run | Attempted | Produced | Verified | Failed`
|
|
36
|
+
- Artifact status: `Not Produced | Produced | Verified | Failed`
|
|
37
|
+
|
|
38
|
+
Do not claim preview/render/GLB artifacts without evidence.
|
|
39
|
+
|
|
40
|
+
## Runtime path policy
|
|
41
|
+
|
|
42
|
+
Preserve the 2-path + CLI appendix runtime model (replaces older 3-stack and 4-route drafts that mis-described how the Anthropic Connector relates to Blender Lab MCP):
|
|
43
|
+
|
|
44
|
+
1. **Path 1 — Official Blender Lab MCP** (Lab add-on + Lab server 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 — Anthropic's tutorial step 2 tells you to install the Lab add-on inside Blender. The 5.1+ floor applies regardless of host option.
|
|
45
|
+
2. **Path 2 — Community `mcp-for-blender` (formerly `blender-mcp`)** (different `addon.py` + server via `uvx mcp-for-blender`, mature third-party, Blender 3.0+).
|
|
46
|
+
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.
|
|
47
|
+
|
|
48
|
+
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).
|
|
49
|
+
|
|
50
|
+
## Output template
|
|
51
|
+
|
|
52
|
+
```md
|
|
53
|
+
## BlendOps response
|
|
54
|
+
|
|
55
|
+
- Chosen route:
|
|
56
|
+
- References consulted:
|
|
57
|
+
- Runtime status:
|
|
58
|
+
- Artifact status:
|
|
59
|
+
- Evidence used:
|
|
60
|
+
- Caveats:
|
|
61
|
+
- Next safe action:
|
|
62
|
+
```
|