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