blendops 0.0.0-stage → 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +62 -0
- package/LICENSE +21 -0
- package/README.md +189 -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 +72 -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/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 +99 -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 +5369 -0
- package/scripts/runtime-orchestrator.mjs +7652 -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,23 @@
|
|
|
1
|
+
# Divergence Routing Table
|
|
2
|
+
|
|
3
|
+
When Phase 3 identifies the first diverging workflow stage, route the proposed fix to the right downstream skill. Each row in this table maps a divergence point to its handoff.
|
|
4
|
+
|
|
5
|
+
| Divergence at this stage | Symptoms typical of this stage | Route the fix to |
|
|
6
|
+
|---|---|---|
|
|
7
|
+
| **Intent / brief** — user said one thing, the brief recorded another | Wrong subject, wrong audience, missing deliverable type | `blender-brainstorming` (re-clarify) → `intent-to-3d-brief-writer` (re-lock brief) |
|
|
8
|
+
| **Asset plan** — wrong asset strategy, wrong source, license mismatch | Brand restriction violated, generative-when-should-be-procedural, library asset wrong style | `asset-discovery` (re-decide strategy) |
|
|
9
|
+
| **Scene plan** — wrong subject placement, wrong scene scope | Hero shoe in corner instead of center, missing required props | `product-hero-scene-planner` |
|
|
10
|
+
| **Composition / camera** — framing wrong | Subject cropped, hero centered when negative space requested, wrong focal length | `camera-composition` |
|
|
11
|
+
| **Lighting / material** — mood wrong, render too dark / too bright | Black render, blown out, no neon, materials look plastic | `lighting-material-plan` |
|
|
12
|
+
| **Quality gate skipped** — plan never reviewed | Sketchy plan went to execution, fail surfaces only post-render | `scene-readiness` |
|
|
13
|
+
| **Runtime path conflict** — readiness signals inconsistent | Tool surface wrong path, Path 1+2 both installed, port collision | `bridge-conflicts` |
|
|
14
|
+
| **Runtime readiness** — missing add-on, wrong Blender version | Add-on not loaded, Path 1 host on Blender 4.x | `runtime-readiness` |
|
|
15
|
+
| **Runtime setup** — never set up correctly | No Lab MCP add-on installed, wrong host config | `runtime-setup` |
|
|
16
|
+
| **Render / export** — output exists but quality wrong | Render visible but mood off, GLB exists but mis-scaled | `render-export-evidence` |
|
|
17
|
+
| **GLB / web handoff** — output OK but handoff caveat missing | GLB ≤ 10MB but no validation notes, no R3F snippet | `glb-web-handoff` |
|
|
18
|
+
| **Final response** — output good but message uses jargon | "BSDF subsurf" leaked into response | `plain-language-response` |
|
|
19
|
+
| **Pre-handoff verification** — claim upgraded improperly | "Verified" claimed without validation notes | `pre-handoff-verification` |
|
|
20
|
+
|
|
21
|
+
## Routing rule
|
|
22
|
+
|
|
23
|
+
Always route to the **earliest** diverging stage. Do not skip ahead. Fixing a downstream symptom while the upstream root cause remains will create the same symptom again.
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
# 4-Phase Diagnostic Template
|
|
2
|
+
|
|
3
|
+
Use this template to record the diagnostic. Fill every phase or mark explicitly **Blocked**.
|
|
4
|
+
|
|
5
|
+
## Phase 1 — Reproduce
|
|
6
|
+
|
|
7
|
+
| Field | Value |
|
|
8
|
+
|---|---|
|
|
9
|
+
| Symptom (one sentence) | |
|
|
10
|
+
| Expected outcome (quoted from intent / brief / planner) | |
|
|
11
|
+
| Observed outcome (file path / log / response text) | |
|
|
12
|
+
| Reproducibility (e.g. 3/3, 1/5, intermittent) | |
|
|
13
|
+
| Locked inputs (prompt, scene file, Blender version, MCP host, add-on commit) | |
|
|
14
|
+
| Phase 1 verdict | Locked / Intermittent / Blocked-no-evidence |
|
|
15
|
+
|
|
16
|
+
If Phase 1 is `Intermittent` or `Blocked-no-evidence`, **stop and gather more evidence**. Do not propose fixes yet.
|
|
17
|
+
|
|
18
|
+
## Phase 2 — Narrow
|
|
19
|
+
|
|
20
|
+
| Field | Value |
|
|
21
|
+
|---|---|
|
|
22
|
+
| Stripped what | (e.g. removed neon prompt, removed floor) |
|
|
23
|
+
| Symptom persisted? | Yes / No / Partial |
|
|
24
|
+
| Minimum reproducing input | |
|
|
25
|
+
| Phase 2 verdict | Narrowed / Partially narrowed / Blocked |
|
|
26
|
+
|
|
27
|
+
## Phase 3 — Identify root cause
|
|
28
|
+
|
|
29
|
+
| Field | Value |
|
|
30
|
+
|---|---|
|
|
31
|
+
| Workflow stages compared (intent → brief → plan → execution → output → response) | |
|
|
32
|
+
| First diverging stage | |
|
|
33
|
+
| Candidate root cause #1 (highest evidence weight) | |
|
|
34
|
+
| Candidate root cause #2 (rejected because…) | |
|
|
35
|
+
| Candidate root cause #3 (rejected because…) | |
|
|
36
|
+
| Phase 3 verdict | Identified / Tied (rank pending) / Blocked |
|
|
37
|
+
|
|
38
|
+
## Phase 4 — Propose fix
|
|
39
|
+
|
|
40
|
+
| Field | Value |
|
|
41
|
+
|---|---|
|
|
42
|
+
| Proposed fix (one sentence) | |
|
|
43
|
+
| Pass criteria (observable test) | |
|
|
44
|
+
| Handoff target skill | |
|
|
45
|
+
| Phase 4 verdict | Targeted / Speculative / Blocked |
|
|
46
|
+
|
|
47
|
+
## Final verdict
|
|
48
|
+
|
|
49
|
+
- **Pass** — all 4 phases completed, root cause + 1-2 rejected alternatives, fix targeted with pass criteria + handoff.
|
|
50
|
+
- **Warn** — phases completed but reproducibility unclear OR fix lacks pass criteria.
|
|
51
|
+
- **Fail** — skipped phases OR multiple speculative causes claimed simultaneously.
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
# EVAL — blendops-help
|
|
2
|
+
|
|
3
|
+
Status: 1.0.0 text-only baseline
|
|
4
|
+
Scope: routing/triage only
|
|
5
|
+
|
|
6
|
+
## Text-only eval prompt
|
|
7
|
+
|
|
8
|
+
Use blendops-help to choose the next safe BlendOps action from an unclear or mixed user request. Do not run Blender, do not run a runtime eval, and do not claim preview/render/GLB artifacts.
|
|
9
|
+
|
|
10
|
+
## Expected behavior
|
|
11
|
+
|
|
12
|
+
- states routing scope and text-only mode
|
|
13
|
+
- recommends exactly one safe next action when the next step is unclear
|
|
14
|
+
- routes runtime requests to runtime readiness without changing runtime status from `Not Run`
|
|
15
|
+
- routes artifact-evidence questions to `render-export-evidence` without upgrading artifact status without evidence
|
|
16
|
+
- keeps package, plugin, marketplace, and direct official MCP support claims conservative unless verified
|
|
17
|
+
|
|
18
|
+
## Eval cases
|
|
19
|
+
|
|
20
|
+
| Case | Input condition | Expected routing | Required status language |
|
|
21
|
+
|---|---|---|---|
|
|
22
|
+
| Unclear next step | User asks what to do next without a concrete goal | Recommend exactly one safe next action and name the target doc/skill | No runtime or artifact status upgrade |
|
|
23
|
+
| Runtime request | User asks whether BlendOps can run Blender now | Route to `runtime-readiness` and runtime stack docs | Runtime: `Not Run` until a real eval occurs |
|
|
24
|
+
| Artifact claim without evidence | User says a render/export/GLB exists but provides no path or validation | Route to `render-export-evidence` | Artifact: `Not Produced` or `Attempted`, never `Produced`/`Verified` |
|
|
25
|
+
| Package/marketplace request | User asks to package, publish, list, or install from a marketplace | Route to install/distribution docs | Package/listing: future or unverified unless evidence exists |
|
|
26
|
+
| Unsupported direct official MCP request | User asks to use direct official MCP from non-Claude Desktop agents | Route to runtime stack strategy and mark as future research | Direct official MCP for non-Claude agents: unverified and not a supported route |
|
|
27
|
+
|
|
28
|
+
## Expected evidence/status fields
|
|
29
|
+
|
|
30
|
+
| Field | Required content |
|
|
31
|
+
|---|---|
|
|
32
|
+
| User goal | Short restatement of the routing problem |
|
|
33
|
+
| Mode | `Text-only routing`, `No runtime execution` |
|
|
34
|
+
| Recommended next action | Exactly one action when ambiguous |
|
|
35
|
+
| Target handoff | Skill or doc path to use next |
|
|
36
|
+
| Runtime status | `Not Run` unless existing evidence says otherwise |
|
|
37
|
+
| Artifact status | `Not Produced`, `Attempted`, or unchanged unless evidence exists |
|
|
38
|
+
| Packaging/listing status | Future/unverified unless verified source evidence exists |
|
|
39
|
+
| Limitations | Missing evidence, missing runtime access, or unsupported route caveat |
|
|
40
|
+
|
|
41
|
+
## Pass / Warn / Fail criteria
|
|
42
|
+
|
|
43
|
+
- Pass: one safe next action, correct handoff, explicit conservative status fields, and no unsupported runtime/artifact/package claims
|
|
44
|
+
- Warn: safe routing with minor missing context or a non-blocking caveat, but no overclaim
|
|
45
|
+
- Fail: multiple conflicting next actions when one was required, runtime/artifact success claim without evidence, marketplace/plugin availability claim without verification, or direct official MCP support claim for non-Claude agents
|
|
46
|
+
|
|
47
|
+
## Common failure modes
|
|
48
|
+
|
|
49
|
+
- giving a long roadmap instead of one safe next action for an unclear request
|
|
50
|
+
- treating runtime readiness as runtime execution success
|
|
51
|
+
- treating a claimed artifact as produced without output path and validation notes
|
|
52
|
+
- saying a package, plugin, or marketplace listing exists without verified listing evidence
|
|
53
|
+
- presenting direct official MCP from Claude Code/OpenCode/Cursor/Codex/Gemini as supported
|
|
54
|
+
|
|
55
|
+
## Sample passing response outline
|
|
56
|
+
|
|
57
|
+
- Scope: text-only routing; no runtime or artifact action performed
|
|
58
|
+
- Recommended next action: exactly one skill/doc handoff
|
|
59
|
+
- Status fields: runtime/artifacts/package/direct MCP remain conservative
|
|
60
|
+
- Reason: concise evidence-based explanation
|
|
61
|
+
|
|
62
|
+
## Sample failing response outline
|
|
63
|
+
|
|
64
|
+
- Claims Blender was run or an artifact exists
|
|
65
|
+
- Recommends several unrelated next actions without priority
|
|
66
|
+
- Promotes unsupported direct official MCP as available
|
|
67
|
+
- Claims package or marketplace availability without verification
|
|
@@ -0,0 +1,312 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: blendops-help
|
|
3
|
+
description: Help users and agents choose the next safe BlendOps action across skills, docs, runtime readiness, evals, packaging, and 1.0.0 release boundaries.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# blendops-help
|
|
7
|
+
|
|
8
|
+
## Purpose
|
|
9
|
+
|
|
10
|
+
Help an agent or user decide the single safest next action in BlendOps when the goal is unclear, current status is unknown, or an entry point into skills, docs, runtime readiness, packaging, or release review is needed.
|
|
11
|
+
|
|
12
|
+
Once the user's goal is clear and workflow artifacts exist, hand off routing to `workflow-stage-router` rather than duplicating stage precedence logic here.
|
|
13
|
+
|
|
14
|
+
## Quick start
|
|
15
|
+
|
|
16
|
+
1. Ask for the current goal and status if missing.
|
|
17
|
+
2. If the goal is already clear and artifacts exist, hand off immediately to `workflow-stage-router`.
|
|
18
|
+
3. Otherwise, identify whether the entry need is brief/planning setup, runtime readiness, evidence verification, install/package docs, or release review.
|
|
19
|
+
4. Route to the single smallest safe skill or doc.
|
|
20
|
+
5. Preserve release, runtime, and artifact truth (downgrade-only, never upgrade).
|
|
21
|
+
|
|
22
|
+
## When to use
|
|
23
|
+
|
|
24
|
+
Use this skill when:
|
|
25
|
+
|
|
26
|
+
- the user asks “what should I do next?” and the goal or current state is unclear
|
|
27
|
+
- the user is unsure how to enter the BlendOps skill catalog or documentation
|
|
28
|
+
- runtime, artifact, packaging, or release status is unknown and needs initial triage
|
|
29
|
+
- no workflow artifacts exist yet and the user needs a safe starting skill or doc
|
|
30
|
+
- an agent needs a concise entry-point recommendation before starting work
|
|
31
|
+
|
|
32
|
+
## When not to use
|
|
33
|
+
<!-- blendops:generated:start exclusions -->
|
|
34
|
+
- The goal is clear, preflight is passed, and stage or artifact inventory already exists → use `../workflow-stage-router/SKILL.md` (Selects the single immediate next skill from a locked precedence order and exits to pre-handoff-verification on any failed gate)
|
|
35
|
+
- The goal is clear and the user wants to select the right recipe or pack → use `../recipe-fit-assessor/SKILL.md` (Scores candidate recipes/packs and detects multi-deliverable scope)
|
|
36
|
+
- A recipe or pack is already selected and needs preflight readiness verification → use `../pack-prerequisite-checker/SKILL.md` (Evaluates the preflight matrix across brief completeness, runtime posture, and asset readiness)
|
|
37
|
+
- The user explicitly asks to turn an idea into a structured 3D brief → use `../intent-to-3d-brief-writer/SKILL.md` (Locks the canonical 8-slot 3D brief before scene planning)
|
|
38
|
+
- The user asks to plan a product-hero scene directly → use `../product-hero-scene-planner/SKILL.md` (Handles domain-specific scene planning once brief and recipe are known)
|
|
39
|
+
- The user asks for render or export artifact verification → use `../render-export-evidence/SKILL.md` (Classifies artifact truth states from on-disk paths and validation notes)
|
|
40
|
+
- The user asks for Blender MCP runtime preflight verification → use `../runtime-readiness/SKILL.md` (Verifies Path 1 or Path 2 runtime readiness without claiming execution)
|
|
41
|
+
<!-- blendops:generated:end exclusions -->
|
|
42
|
+
|
|
43
|
+
## Trigger phrases
|
|
44
|
+
<!-- blendops:generated:start triggers -->
|
|
45
|
+
- "What should I do next?"
|
|
46
|
+
- "Which BlendOps skill should I use?"
|
|
47
|
+
- "Is this ready?"
|
|
48
|
+
- "Can I run the runtime eval?"
|
|
49
|
+
- "How do I package/install BlendOps?"
|
|
50
|
+
- "What is blocked?"
|
|
51
|
+
<!-- blendops:generated:end triggers -->
|
|
52
|
+
|
|
53
|
+
## Prerequisites / readiness
|
|
54
|
+
|
|
55
|
+
- Know whether the user wants initial planning/briefing, runtime readiness, artifact evidence, install/package work, or release readiness.
|
|
56
|
+
- If status is unknown, ask for current goal and known evidence first.
|
|
57
|
+
- If the goal is clear and artifacts exist, defer directly to `workflow-stage-router`.
|
|
58
|
+
- Treat runtime status as `Not Run` and artifacts as `Not Produced` by default unless verified evidence says otherwise; apply downgrade-only rules and never upgrade states.
|
|
59
|
+
|
|
60
|
+
## Input schema
|
|
61
|
+
|
|
62
|
+
### Required inputs
|
|
63
|
+
|
|
64
|
+
| Input | Why it is required |
|
|
65
|
+
|---|---|
|
|
66
|
+
| Current goal | Determines route. |
|
|
67
|
+
| Known status | Prevents unsupported readiness or artifact claims. |
|
|
68
|
+
| Target surface | Needed for install/adaptor/package questions. |
|
|
69
|
+
|
|
70
|
+
### Optional inputs
|
|
71
|
+
|
|
72
|
+
| Input | Use |
|
|
73
|
+
|---|---|
|
|
74
|
+
| Runtime stack | Routes to readiness or stack docs. |
|
|
75
|
+
| Existing evidence | Enables evidence-aware recommendation. |
|
|
76
|
+
| Desired output | Helps choose planning, validation, export, or handoff skill. |
|
|
77
|
+
|
|
78
|
+
### Assumptions to confirm
|
|
79
|
+
|
|
80
|
+
- Skill install is separate from runtime install.
|
|
81
|
+
- Runtime readiness is separate from full runtime eval.
|
|
82
|
+
- Read-only connector smoke evidence is not artifact evidence.
|
|
83
|
+
|
|
84
|
+
## Output schema
|
|
85
|
+
|
|
86
|
+
### Primary output
|
|
87
|
+
|
|
88
|
+
A short next-step recommendation with one safe primary action.
|
|
89
|
+
|
|
90
|
+
### Secondary output
|
|
91
|
+
|
|
92
|
+
- applicable skill/doc
|
|
93
|
+
- blocker/caveat
|
|
94
|
+
- evidence state
|
|
95
|
+
- optional follow-up action
|
|
96
|
+
|
|
97
|
+
### Evidence / caveat output
|
|
98
|
+
|
|
99
|
+
```txt
|
|
100
|
+
Recommended next action: <skill/doc/action>
|
|
101
|
+
Runtime status: Not Run | Attempted | Produced | Verified | Failed
|
|
102
|
+
Artifact status: Not Produced | Produced | Verified | Failed
|
|
103
|
+
Evidence used: <links/paths or none>
|
|
104
|
+
Why this is safe: <reason>
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
## Required laws
|
|
108
|
+
|
|
109
|
+
- `../../laws/official-runtime-only.md`
|
|
110
|
+
- `../../laws/evidence-before-done.md`
|
|
111
|
+
- `../../laws/non-blender-user-language.md`
|
|
112
|
+
- `../../laws/no-arbitrary-python-interface.md`
|
|
113
|
+
|
|
114
|
+
## Official runtime boundary
|
|
115
|
+
|
|
116
|
+
Before runtime work, point to `../../docs/runtime-stack-strategy.md`, `runtime-path-picker`, and `runtime-readiness`.
|
|
117
|
+
|
|
118
|
+
BlendOps runtime guidance uses **2 MCP execution paths plus a CLI fallback appendix**:
|
|
119
|
+
|
|
120
|
+
1. **Path 1 — Official Blender Lab MCP** in Blender 5.1+ (add-on manifest literal `blender_version_min = "5.1.0"`), hosted from either (a) Anthropic Connector in Claude Desktop or (b) any manually configured MCP client. The Connector is **not** standalone: Anthropic tutorial step 2 installs the Lab add-on inside Blender, and although the tutorial prerequisite says "Blender 4.2 or later", the binding floor is Blender 5.1+.
|
|
121
|
+
2. **Path 2 — Community `mcp-for-blender` (renamed from `ahujasid/blender-mcp`)**, third-party, Blender 3.0+, started via `uvx mcp-for-blender`. Use only with caveats and **never** accepted as release evidence.
|
|
122
|
+
3. **CLI fallback (appendix only)** — `blender --background --python` (documented flags: `--background`, `--python`, `-E/--engine`; run `blender -E help` for exact engine tokens). Appendix only, **never** a peer path without an eval record.
|
|
123
|
+
|
|
124
|
+
Single-bridge constraint: One MCP bridge is allowed per Blender instance (default port 9876; side-by-side on separate instances via per-instance `--port 9877` is supported upstream). If bridge conflicts occur, route to `bridge-conflicts`.
|
|
125
|
+
|
|
126
|
+
This skill does not run Blender, mutate scenes, render, export, install runtimes, or claim artifacts.
|
|
127
|
+
|
|
128
|
+
## Operating procedure
|
|
129
|
+
|
|
130
|
+
1. Check whether the goal is already clear and artifacts exist:
|
|
131
|
+
- if yes, route immediately to `workflow-stage-router`
|
|
132
|
+
2. If goal or status is unclear, classify the entry request:
|
|
133
|
+
- entry help / initial triage
|
|
134
|
+
- intent brief or initial scene planning
|
|
135
|
+
- runtime path selection or readiness
|
|
136
|
+
- render/export evidence check
|
|
137
|
+
- install/package/adaptor docs
|
|
138
|
+
- release readiness docs
|
|
139
|
+
3. Identify known evidence and assign conservative truth states (downgrade-only):
|
|
140
|
+
- Runtime: `Not Run | Attempted | Produced | Verified | Failed`
|
|
141
|
+
- Artifacts: `Not Run | Not Produced | Produced | Verified | Failed` (default `Not Produced`)
|
|
142
|
+
4. Pick the single safest entry skill or doc.
|
|
143
|
+
5. State the blocker if no safe active step exists and return the recommendation.
|
|
144
|
+
|
|
145
|
+
## Decision tree
|
|
146
|
+
|
|
147
|
+
```txt
|
|
148
|
+
Goal unclear or status unknown?
|
|
149
|
+
→ ask for current goal/status
|
|
150
|
+
Goal clear and artifacts already exist?
|
|
151
|
+
→ workflow-stage-router (exits to pre-handoff-verification on any failed gate)
|
|
152
|
+
Need to turn a rough idea into a 3D brief?
|
|
153
|
+
→ intent-to-3d-brief-writer
|
|
154
|
+
Need an initial scene plan (no artifacts yet)?
|
|
155
|
+
→ product-hero-scene-planner (or character-portrait / environment-shot / interior-scene / product-grid-scene-planner)
|
|
156
|
+
Need runtime path choice, setup, or preflight?
|
|
157
|
+
→ runtime-path-picker / runtime-setup / runtime-readiness
|
|
158
|
+
Need artifact proof?
|
|
159
|
+
→ render-export-evidence
|
|
160
|
+
Need install/package docs?
|
|
161
|
+
→ docs/ai-agent-install-flow.md + docs/distribution-strategy.md
|
|
162
|
+
Need release readiness docs?
|
|
163
|
+
→ docs/release-readiness.md
|
|
164
|
+
```
|
|
165
|
+
|
|
166
|
+
## Playbooks
|
|
167
|
+
|
|
168
|
+
### Playbook A: First-time user
|
|
169
|
+
|
|
170
|
+
- Recommend reading `docs/README.md`, `docs/skill-system.md`, and `docs/external-runtime-setup.md`, or starting with `intent-to-3d-brief-writer`.
|
|
171
|
+
- Keep runtime status `Not Run` and artifact status `Not Produced`.
|
|
172
|
+
- Suggest planning mode unless runtime is explicitly available.
|
|
173
|
+
|
|
174
|
+
### Playbook B: Runtime request
|
|
175
|
+
|
|
176
|
+
- Route to `runtime-path-picker`, `runtime-setup`, or `runtime-readiness`.
|
|
177
|
+
- Require read-only inspection smoke test before mutation (`execute_blender_code`), render, or export.
|
|
178
|
+
- Do not treat readiness as runtime success; keep states downgrade-only.
|
|
179
|
+
|
|
180
|
+
### Playbook C: Artifact claim request
|
|
181
|
+
|
|
182
|
+
- Route to `render-export-evidence` (or `pre-handoff-verification` if a workflow gate failed).
|
|
183
|
+
- Require command/tool, input/scene, output path, file existence, validation notes, and limitations.
|
|
184
|
+
- If evidence is missing, keep artifact status at `Not Produced` (or `Failed` if a run failed; never use `Attempted` for artifacts) and downgrade any unsupported claim.
|
|
185
|
+
|
|
186
|
+
### Playbook D: Packaging request
|
|
187
|
+
|
|
188
|
+
- Route to `docs/multi-agent-install-strategy.md` and `docs/distribution-strategy.md`.
|
|
189
|
+
- Keep packaged skill, plugin listing, and marketplace listing as future until verified.
|
|
190
|
+
|
|
191
|
+
## Mode handling
|
|
192
|
+
|
|
193
|
+
### Text-only mode
|
|
194
|
+
|
|
195
|
+
Recommend planning, docs, or eval prep only. Runtime remains `Not Run`.
|
|
196
|
+
|
|
197
|
+
### Runtime-ready mode
|
|
198
|
+
|
|
199
|
+
Recommend readiness preflight and evidence capture before any mutation/render/export.
|
|
200
|
+
|
|
201
|
+
### Blocked runtime mode
|
|
202
|
+
|
|
203
|
+
Name blocker and suggest the next non-runtime planning or documentation step.
|
|
204
|
+
|
|
205
|
+
## Validation checklist
|
|
206
|
+
|
|
207
|
+
- [ ] Current goal/status identified.
|
|
208
|
+
- [ ] Handed off to `workflow-stage-router` if goal is clear and artifacts exist.
|
|
209
|
+
- [ ] Recommended exactly one safest next action using a real catalog skill or doc.
|
|
210
|
+
- [ ] Runtime status is explicit (`Not Run | Attempted | Produced | Verified | Failed`).
|
|
211
|
+
- [ ] Artifact status is explicit (`Not Run | Not Produced | Produced | Verified | Failed`, default `Not Produced`).
|
|
212
|
+
- [ ] Truth states follow downgrade-only rules (never upgraded).
|
|
213
|
+
- [ ] Runtime boundaries respected (Path 1 5.1+ non-standalone Connector, Path 2 `mcp-for-blender` caveats/never release evidence, CLI appendix-only).
|
|
214
|
+
- [ ] Handoff skill/doc is named.
|
|
215
|
+
|
|
216
|
+
## Pass / Warn / Fail rubric
|
|
217
|
+
|
|
218
|
+
| Verdict | Criteria |
|
|
219
|
+
|---|---|
|
|
220
|
+
| Pass | Recommendation is specific, safe, evidence-bound, defers to `workflow-stage-router` when artifacts exist, and points to a valid skill/doc. |
|
|
221
|
+
| Warn | Recommendation is safe but depends on missing status or user confirmation before routing. |
|
|
222
|
+
| Fail | Recommendation duplicates `workflow-stage-router` precedence, upgrades truth states, assigns `Attempted` to artifacts, treats Path 2 as release evidence or CLI as a peer path without an eval record, or claims standalone/sub-5.1 Path 1 support. |
|
|
223
|
+
|
|
224
|
+
## Failure handling
|
|
225
|
+
|
|
226
|
+
- If status is unknown, ask for goal/status instead of guessing.
|
|
227
|
+
- If the goal is clear and artifacts exist, stop entry triage and route to `workflow-stage-router`.
|
|
228
|
+
- If the user asks to run Path 1 on Blender below 5.1 or via Anthropic Connector without the Lab add-on installed in Blender, explain that the binding floor is `blender_version_min = "5.1.0"` and the Connector is not standalone.
|
|
229
|
+
- If the user asks to use Path 2 (`mcp-for-blender`, renamed from `ahujasid/blender-mcp`) for release evidence or CLI (`blender --background --python`) as a peer path without an eval record, block the claim and state the upstream boundary.
|
|
230
|
+
- If the user asks for artifacts with no evidence, route to `render-export-evidence` and keep artifact status `Not Produced`.
|
|
231
|
+
- If the user asks for release/tag, route to release readiness docs and current blockers.
|
|
232
|
+
|
|
233
|
+
## Troubleshooting
|
|
234
|
+
|
|
235
|
+
| Problem | Safe response |
|
|
236
|
+
|---|---|
|
|
237
|
+
| User says “make it ready” | Ask which layer: skill install, runtime readiness, artifact evidence, or release readiness. |
|
|
238
|
+
| User says “runtime works” | Ask for eval evidence and route to readiness/evidence docs. |
|
|
239
|
+
| User says “package it” | Keep package/listing as future unless verified. |
|
|
240
|
+
|
|
241
|
+
## Best practices
|
|
242
|
+
|
|
243
|
+
- Keep recommendations short and pick one primary action.
|
|
244
|
+
- Defer to `workflow-stage-router` as soon as the goal is clear and artifacts exist.
|
|
245
|
+
- Preserve conservative 1.0.0 status and downgrade-only truth states.
|
|
246
|
+
- Treat read-only MCP inspection access as scoped smoke evidence only, never artifact evidence.
|
|
247
|
+
|
|
248
|
+
## Good examples
|
|
249
|
+
|
|
250
|
+
- “Next safe action: run `runtime-readiness` for Path 1 (Official Blender Lab MCP 5.1+, host (a) Anthropic Connector in Claude Desktop with Lab add-on installed). Runtime status: Not Run. Artifact status: Not Produced.”
|
|
251
|
+
- “Next safe action: use `product-hero-scene-planner` to plan the scene; no runtime is needed yet. Runtime status: Not Run. Artifact status: Not Produced.”
|
|
252
|
+
- “Next safe action: hand off to `workflow-stage-router` because your goal is clear and scene artifacts already exist.”
|
|
253
|
+
|
|
254
|
+
## Bad examples
|
|
255
|
+
|
|
256
|
+
- “Proceed to render” before readiness.
|
|
257
|
+
- “Artifacts are ready” without paths and validation.
|
|
258
|
+
- “Publish the package” without install/listing evidence.
|
|
259
|
+
|
|
260
|
+
## User-facing response template
|
|
261
|
+
|
|
262
|
+
```txt
|
|
263
|
+
Next safe action: <action>
|
|
264
|
+
Use: <skill/doc>
|
|
265
|
+
Runtime status: <state>
|
|
266
|
+
Artifact status: <state>
|
|
267
|
+
Evidence used: <evidence or none>
|
|
268
|
+
Why: <short reason>
|
|
269
|
+
```
|
|
270
|
+
|
|
271
|
+
## Anti-patterns
|
|
272
|
+
|
|
273
|
+
- Duplicating `workflow-stage-router` stage precedence instead of handing off when the goal is clear and artifacts exist.
|
|
274
|
+
- Turning a help response into implementation or Python execution without confirmation.
|
|
275
|
+
- Claiming Anthropic Connector works standalone without the Lab add-on or on Blender below 5.1 (`blender_version_min = "5.1.0"`).
|
|
276
|
+
- Treating Path 2 (`mcp-for-blender`, renamed from `ahujasid/blender-mcp`) as release evidence or CLI fallback (`blender --background --python`) as a peer path without an eval record.
|
|
277
|
+
- Assigning `Attempted` to artifact status or upgrading runtime/artifact truth states without evidence.
|
|
278
|
+
- Treating install docs as runtime evidence or future packaging tasks as completed.
|
|
279
|
+
|
|
280
|
+
## Cross-skill handoff
|
|
281
|
+
<!-- blendops:generated:start handoffs -->
|
|
282
|
+
- [progression] Recipe or pack selection when goal becomes clear → `../recipe-fit-assessor/SKILL.md`
|
|
283
|
+
- [conditional] Pack preflight readiness check when recipe is already chosen → `../pack-prerequisite-checker/SKILL.md`
|
|
284
|
+
- [conditional] In-flight workflow routing (clear goal + existing artifacts) → `../workflow-stage-router/SKILL.md`
|
|
285
|
+
- [progression] Initial 3D brief creation → `../intent-to-3d-brief-writer/SKILL.md`
|
|
286
|
+
- [conditional] Runtime path selection → `../runtime-path-picker/SKILL.md`
|
|
287
|
+
- [conditional] Official runtime setup → `../runtime-setup/SKILL.md`
|
|
288
|
+
- [conditional] Runtime readiness preflight → `../runtime-readiness/SKILL.md`
|
|
289
|
+
- [fallback] MCP bridge port/session conflict → `../bridge-conflicts/SKILL.md`
|
|
290
|
+
- [alternative] Scene planning → `../product-hero-scene-planner/SKILL.md`
|
|
291
|
+
- [conditional] Render/export evidence → `../render-export-evidence/SKILL.md`
|
|
292
|
+
- [fallback] Failed workflow gate / pre-handoff check → `../pre-handoff-verification/SKILL.md`
|
|
293
|
+
- [conditional] GLB handoff → `../glb-web-handoff/SKILL.md`
|
|
294
|
+
- [progression] Final response → `../plain-language-response/SKILL.md`
|
|
295
|
+
<!-- blendops:generated:end handoffs -->
|
|
296
|
+
|
|
297
|
+
## Non-goals
|
|
298
|
+
|
|
299
|
+
- Replace or duplicate `workflow-stage-router` precedence logic once the goal is clear and artifacts exist.
|
|
300
|
+
- Install Blender or runtimes.
|
|
301
|
+
- Run Blender or execute Python.
|
|
302
|
+
- Create or mutate scene data.
|
|
303
|
+
- Render/export artifacts.
|
|
304
|
+
- Publish packages or marketplace listings.
|
|
305
|
+
|
|
306
|
+
## References
|
|
307
|
+
|
|
308
|
+
- `../../docs/skill-system.md`
|
|
309
|
+
- `../../docs/runtime-stack-strategy.md`
|
|
310
|
+
- `../../docs/evals/runtime-availability-checklist.md`
|
|
311
|
+
- `../../docs/release-readiness.md`
|
|
312
|
+
- `../../docs/distribution-strategy.md`
|