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