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,51 @@
|
|
|
1
|
+
<!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/product-hero-scene-planner/SKILL.md and skills/product-hero-scene-planner/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
|
|
2
|
+
# product-hero-scene-planner
|
|
3
|
+
|
|
4
|
+
Purpose: Generate a complete product-hero scene plan from non-Blender-user intent with explicit assumptions and gates.
|
|
5
|
+
|
|
6
|
+
Turn user intent or an upstream brief into a complete, plain-language product-hero scene plan (subject, composition, camera, lighting, material, environment, plus render, export, and web-handoff intent) before any runtime phase.
|
|
7
|
+
|
|
8
|
+
Metadata: Contract `v1.0.0` | Category `scene-planners` | Role `single-product-hero-scene-architect` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
|
|
9
|
+
|
|
10
|
+
## When to use & trigger cues
|
|
11
|
+
- single product-hero scene planning from user intent or an `intent-to-3d-brief-writer` brief
|
|
12
|
+
- pre-runtime structural planning across subject, camera, composition, lighting, material, environment, and delivery intent
|
|
13
|
+
- translating non-Blender product presentation goals into an assumption-tracked scene plan
|
|
14
|
+
- Trigger phrases: "plan a product hero scene", "turn this into a Blender plan", "prepare cyberpunk shoe scene plan"
|
|
15
|
+
|
|
16
|
+
## When not to use (delegation boundaries)
|
|
17
|
+
- to execute Blender commands, write Python, or claim generated artifacts → use `intent-to-3d-brief-writer` (`references/skill-intent-to-3d-brief-writer.md`; Delegates out-of-scope requests to intent-to-3d-brief-writer)
|
|
18
|
+
- to skip unresolved critical ambiguity or hide missing inputs → use `camera-composition` (`references/skill-camera-composition.md`; Delegates out-of-scope requests to camera-composition)
|
|
19
|
+
- when raw user intent still needs initial brief normalization → use `intent-to-3d-brief-writer` (`references/skill-intent-to-3d-brief-writer.md`; use intent-to-3d-brief-writer first)
|
|
20
|
+
- when planning a multi-item catalog or grid layout → use `product-grid-scene-planner` (`references/skill-product-grid-scene-planner.md`; use product-grid-scene-planner)
|
|
21
|
+
- when deep-diving camera/framing mechanics → use `camera-composition` (`references/skill-camera-composition.md`; use lighting-material-plan)
|
|
22
|
+
- when writing measurable pass/fail acceptance tables → use `acceptance-criteria-builder` (`references/skill-acceptance-criteria-builder.md`; use scene-readiness)
|
|
23
|
+
|
|
24
|
+
## Input & output contract
|
|
25
|
+
- Required input `locked_3d_brief` (`object`): Locked 8-slot 3D brief defining the hero product, hero feature callout, mood, and output channel
|
|
26
|
+
- Required input `sourced_product_asset_status` (`object`): Hero product model posture and material readiness from asset-discovery
|
|
27
|
+
- Optional input `pack_context` (`string`): Optional pack reference such as packs/product-hero-v0/PACK.md
|
|
28
|
+
- Output contract: `hero_product_staging_and_pedestal_plan`, `camera_and_lookdev_handoff_inputs`, `scene_quality_validation_hooks` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
|
|
29
|
+
|
|
30
|
+
## Quick-start steps
|
|
31
|
+
1. confirm this skill fits your goal
|
|
32
|
+
2. provide required inputs first
|
|
33
|
+
3. keep runtime claims evidence-bound
|
|
34
|
+
4. follow suggested next-skill handoff
|
|
35
|
+
|
|
36
|
+
## Cross-skill handoffs
|
|
37
|
+
- [upstream_reference] Upstream input (if raw prompt needs structuring) → `intent-to-3d-brief-writer` (`references/skill-intent-to-3d-brief-writer.md`) — `when.all: [goal.clarity equals "clear"; brief.locked equals false]`
|
|
38
|
+
- [progression] Next (deep-dive framing & camera) → `camera-composition` (`references/skill-camera-composition.md`) — `when.all: [brief.locked equals true; stage.current equals "camera_planning"]`
|
|
39
|
+
- [progression] Next (deep-dive lookdev & lighting) → `lighting-material-plan` (`references/skill-lighting-material-plan.md`) — `when.all: [brief.locked equals true; stage.current equals "lookdev_planning"]`
|
|
40
|
+
- [fallback] Then (measurable pass/fail rows) → `acceptance-criteria-builder` (`references/skill-acceptance-criteria-builder.md`) — `when.all: [brief.locked equals true; stage.current equals "acceptance_criteria"]`
|
|
41
|
+
- [upstream_reference] Then (pin done condition) → `done-criteria` (`references/skill-done-criteria.md`) — `when.all: [brief.locked equals true; stage.current equals "stop_condition"]`
|
|
42
|
+
- [progression] Later (post-build readiness review) → `scene-readiness` (`references/skill-scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
|
|
43
|
+
- [conditional] Delivery handoff (when web/render output is targeted) (glb-web-handoff) → `glb-web-handoff` (`references/skill-glb-web-handoff.md`) — `when.all: [artifact.type equals "glb"; handoff.consumerStack equals "web_glb"]`
|
|
44
|
+
- [conditional] Delivery handoff (when web/render output is targeted) (render-export-evidence) → `render-export-evidence` (`references/skill-render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
|
|
45
|
+
|
|
46
|
+
## Safety boundaries & non-goals
|
|
47
|
+
- Runtime boundary: Planning-only skill: no Blender execution, no Python scripts, and no artifact generation. - Runtime truth state must remain `Not Run` (from canonical states `Not Run | Attempted | Produced | Verified | Failed`). - Artifact truth state must remain `Not Produced` (downgrade-only, never upgrade). - When a live scene exists, consume read-only inspection results (`get_objects_summary`) rather than assuming object dimensions, without executing scene mutations.
|
|
48
|
+
- executing Blender commands, MCP mutations, or CLI jobs
|
|
49
|
+
- writing Python scripts
|
|
50
|
+
- claiming `Attempted`, `Produced`, or `Verified` runtime/artifact states
|
|
51
|
+
- replacing `intent-to-3d-brief-writer` (upstream brief), `camera-composition` (deep framing), `lighting-material-plan` (deep lookdev), `acceptance-criteria-builder` (measurable acceptance rows), `done-criteria` (done conditions), or `scene-readiness` (readiness review)
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
<!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/r3f-component-plan/SKILL.md and skills/r3f-component-plan/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
|
|
2
|
+
# r3f-component-plan
|
|
3
|
+
|
|
4
|
+
Purpose: Plan the React Three Fiber component shape (props, refs, Suspense, useGLTF cache, animation hooks) before delivering a GLB to a web team.
|
|
5
|
+
|
|
6
|
+
Translate a planned GLB delivery into the exact public surface a React Three Fiber component should expose, so the web engineer's contract is locked before code is written.
|
|
7
|
+
|
|
8
|
+
Metadata: Contract `v1.0.0` | Category `evidence-and-handoff` | Role `r3f-component-contract-architect` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
|
|
9
|
+
|
|
10
|
+
## When to use & trigger cues
|
|
11
|
+
- the GLB will ship to a web app using React Three Fiber
|
|
12
|
+
- before the web team writes the component
|
|
13
|
+
- when "I'll just import the GLB" needs more rigor (multiple clips, prop overrides, lazy loading)
|
|
14
|
+
- Trigger phrases: "how should the React component look", "what props should I expose", "ref shape for the model", "we use react-three-fiber"
|
|
15
|
+
|
|
16
|
+
## When not to use (delegation boundaries)
|
|
17
|
+
- consumers using vanilla Three.js (different API) → use `glb-web-handoff` (`references/skill-glb-web-handoff.md`; different API)
|
|
18
|
+
- consumers using Babylon / model-viewer (different stack) → use `glb-animation-handoff` (`references/skill-glb-animation-handoff.md`; different stack)
|
|
19
|
+
- the GLB is rendered server-side (e.g. AR pre-render); no React component needed → use `plain-language-response` (`references/skill-plain-language-response.md`; Delegates out-of-scope requests to plain-language-response)
|
|
20
|
+
|
|
21
|
+
## Input & output contract
|
|
22
|
+
- Required input `glb_delivery_contract` (`object`): Locked GLB node hierarchy, material slots, and compression spec from glb-web-handoff
|
|
23
|
+
- Required input `r3f_version_and_use_case` (`object`): Target @react-three/fiber major version (8 vs 9) and interactive component use case
|
|
24
|
+
- Optional input `animation_clip_contract` (`object`): Optional clip names, triggers, and crossfade rules from glb-animation-handoff
|
|
25
|
+
- Output contract: `r3f_component_props_and_ref_spec`, `suspense_caching_and_dispose_contract`, `consumer_call_site_usage_outline` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
|
|
26
|
+
|
|
27
|
+
## Quick-start steps
|
|
28
|
+
1. enumerate the props the consumer needs (color, animation name, scale, onLoaded)
|
|
29
|
+
2. decide ref shape (forwardRef, imperative methods)
|
|
30
|
+
3. decide Suspense boundary location
|
|
31
|
+
4. decide useGLTF caching + cleanup strategy
|
|
32
|
+
5. decide animation hook contract (auto-play, manual control)
|
|
33
|
+
|
|
34
|
+
## Cross-skill handoffs
|
|
35
|
+
- [upstream_reference] Animation contract → `glb-animation-handoff` (`references/skill-glb-animation-handoff.md`) — `when.all: [artifact.hasAnimation equals true; stage.current equals "animation_handoff"]`
|
|
36
|
+
- [upstream_reference] Performance budget ceilings → `mobile-glb-budget` (`references/skill-mobile-glb-budget.md`) — `when.all: [artifact.type equals "glb"; budget.pinned equals false]`
|
|
37
|
+
- [upstream_reference] Color and material checks (color-management-decision) → `color-management-decision` (`references/skill-color-management-decision.md`) — `when.all: [decision.colorLocked equals false]`
|
|
38
|
+
- [upstream_reference] Color and material checks (material-quality-checker) → `material-quality-checker` (`references/skill-material-quality-checker.md`) — `when.all: [quality.domain equals "material"; quality.verdict equals "not_run"]`
|
|
39
|
+
- [upstream_reference] Web delivery packaging → `glb-web-handoff` (`references/skill-glb-web-handoff.md`) — `when.all: [artifact.type equals "glb"; handoff.consumerStack equals "web_glb"]`
|
|
40
|
+
- [progression] Final user-facing response → `plain-language-response` (`references/skill-plain-language-response.md`) — `when.all: [stage.current equals "final_communication"]`
|
|
41
|
+
|
|
42
|
+
## Safety boundaries & non-goals
|
|
43
|
+
- Runtime boundary: This skill produces **planning specs only**. It does not generate component code, run a web app, or claim that the resulting component will perform correctly without measured load tests. Web-side implementation is owned by the consumer team.
|
|
44
|
+
- Generate React or Three.js component implementation code.
|
|
45
|
+
- Run web apps or execute React Three Fiber at runtime.
|
|
46
|
+
- Claim or verify web runtime performance.
|
|
47
|
+
- Upgrade truth states (web runtime belongs to the consumer team, not BlendOps).
|
|
48
|
+
- Own animation contracts, performance budgets, color/material validation, or web delivery packaging.
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
<!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/recipe-fit-assessor/SKILL.md and skills/recipe-fit-assessor/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
|
|
2
|
+
# recipe-fit-assessor
|
|
3
|
+
|
|
4
|
+
Purpose: Score whether a user's 3D goal fits an existing BlendOps recipe or pack, or needs custom decomposition, and name the exact next skill.
|
|
5
|
+
|
|
6
|
+
Map a user's stated goal to the closest documented BlendOps recipe or pack before expensive planning or runtime work, returning a fit verdict (`Strong` / `Partial` / `Poor`), rationale, explicit gap list, and **one** recommended next skill. This skill is planning-only and never runs Blender, packs, or runtime.
|
|
7
|
+
|
|
8
|
+
Metadata: Contract `v1.0.0` | Category `routing-and-governance` | Role `recipe-and-pack-selector` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
|
|
9
|
+
Routing precedence: group `entry-and-stage-routing`, rank `2` | activationGate: `goalClarity="clear"`, `recipeSelected=false`, `preflightPassed=false`, `hasStageOrArtifactInventory=false`
|
|
10
|
+
|
|
11
|
+
## When to use & trigger cues
|
|
12
|
+
- user asks "which recipe / pack fits my idea"
|
|
13
|
+
- scope drifts between product hero, portrait, interior, web GLB, batch renders
|
|
14
|
+
- before locking `intent-to-3d-brief-writer` output to a pack
|
|
15
|
+
- Trigger phrases: "what recipe should I use", "does product hero fit", "closest workflow for X", "which pack"
|
|
16
|
+
|
|
17
|
+
## When not to use (delegation boundaries)
|
|
18
|
+
- Diverging raw creative ideas before a delivery shape exists → use `blender-brainstorming` (`references/skill-blender-brainstorming.md`; Explores creative directions and clarifies vague ideas before recipe selection)
|
|
19
|
+
- General entry routing across BlendOps when the goal itself is unclear → use `blendops-help` (`references/skill-blendops-help.md`; Handles ambiguous entry triage at precedence Rank 1)
|
|
20
|
+
- Checking whether a selected pack's preflight prerequisites are met → use `pack-prerequisite-checker` (`references/skill-pack-prerequisite-checker.md`; Evaluates preflight readiness once the recipe/pack is already selected)
|
|
21
|
+
- Picking the next workflow stage after preflight passed and artifacts already exist → use `workflow-stage-router` (`references/skill-workflow-stage-router.md`; Routes active in-flight workflows at precedence Rank 4)
|
|
22
|
+
- Writing the structured 8-slot 3D brief after recipe fit is settled → use `intent-to-3d-brief-writer` (`references/skill-intent-to-3d-brief-writer.md`; Authors the formal brief after recipe fit is determined)
|
|
23
|
+
- Detailed scene planning once a domain and brief are locked → use `product-hero-scene-planner` (`references/skill-product-hero-scene-planner.md`; Builds the domain-specific scene plan after preflight passes)
|
|
24
|
+
- Runtime setup, path selection, or bridge conflict troubleshooting → use `runtime-path-picker` (`references/skill-runtime-path-picker.md`; Handles MCP runtime selection and setup outside recipe scoring)
|
|
25
|
+
- Legal or asset license verification → use `asset-license-checker` (`references/skill-asset-license-checker.md`; Audits asset provenance and license compatibility)
|
|
26
|
+
|
|
27
|
+
## Input & output contract
|
|
28
|
+
- Required input `user_goal_summary` (`string`): Plain-language 3D goal and intended deliverable subject
|
|
29
|
+
- Required input `target_output_destination` (`string`): Target format or channel (e.g., hero still, catalog grid, turntable, web GLB)
|
|
30
|
+
- Optional input `candidate_pack_hint` (`string`): Optional pack or recipe the user is considering
|
|
31
|
+
- Output contract: `recipe_fit_verdict`, `candidate_comparison_table`, `recommended_next_skill` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
|
|
32
|
+
|
|
33
|
+
## Quick-start steps
|
|
34
|
+
1. capture goal + constraints + deliverables
|
|
35
|
+
2. compare against catalog rows in `skills/recipe-fit-assessor/references/recipe-catalog.md`
|
|
36
|
+
3. assign fit verdict (Strong / Partial / Poor)
|
|
37
|
+
4. list gap fixes or recommend a different workflow entrypoint
|
|
38
|
+
|
|
39
|
+
## Cross-skill handoffs
|
|
40
|
+
- [upstream_reference] Upstream creative divergence → `blender-brainstorming` (`references/skill-blender-brainstorming.md`) — `when.all: [goal.clarity equals "ambiguous_or_mixed"]`
|
|
41
|
+
- [boundary_delegation] General entry routing → `blendops-help` (`references/skill-blendops-help.md`) — `when.all: [request.scope equals "general_help"]`
|
|
42
|
+
- [conditional] Multi-deliverable scope split when prompt spans multiple incompatible recipes → `blender-recipe-decomposer` (`references/skill-blender-recipe-decomposer.md`) — `when.all: [fit.multiDeliverableDetected equals true]`
|
|
43
|
+
- [progression] Downstream structured brief → `intent-to-3d-brief-writer` (`references/skill-intent-to-3d-brief-writer.md`) — `when.all: [fit.verdict in ["strong_fit","partial_fit"]; brief.locked equals false]`
|
|
44
|
+
- [progression] Pack prerequisite verification → `pack-prerequisite-checker` (`references/skill-pack-prerequisite-checker.md`) — `when.all: [fit.verdict equals "strong_fit"; brief.locked equals true]`
|
|
45
|
+
- [conditional] Post-artifact stage routing → `workflow-stage-router` (`references/skill-workflow-stage-router.md`) — `when.all: [preflight.passed equals true; inventory.exists equals true]`
|
|
46
|
+
- [alternative] Domain scene planner (product hero) → `product-hero-scene-planner` (`references/skill-product-hero-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.domain equals "product_hero"]`
|
|
47
|
+
- [alternative] Domain scene planner (product grid) → `product-grid-scene-planner` (`references/skill-product-grid-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.domain equals "product_grid"]`
|
|
48
|
+
- [alternative] Domain scene planner (character portrait) → `character-portrait` (`references/skill-character-portrait.md`) — `when.all: [brief.locked equals true; recipe.domain equals "character_portrait"]`
|
|
49
|
+
- [alternative] Domain scene planner (environment establishing shot) → `environment-shot` (`references/skill-environment-shot.md`) — `when.all: [brief.locked equals true; recipe.domain equals "environment_shot"]`
|
|
50
|
+
- [alternative] Domain scene planner (interior architectural) → `interior-scene` (`references/skill-interior-scene.md`) — `when.all: [brief.locked equals true; recipe.domain equals "interior_archviz"]`
|
|
51
|
+
|
|
52
|
+
## Safety boundaries & non-goals
|
|
53
|
+
- Runtime boundary: Planning-only skill. Does not configure MCP, Blender, or hosts. When mentioning runtime, use the 2-path + CLI appendix model from `docs/runtime-stack-strategy.md` only as context for whether a workflow expects interactive MCP vs batch CLI — never claim runtime success.
|
|
54
|
+
- Brainstorming open-ended creative concepts before a goal exists (use `blender-brainstorming`).
|
|
55
|
+
- Authoring the locked 8-slot 3D brief (use `intent-to-3d-brief-writer`).
|
|
56
|
+
- Running the 7-row pack preflight gate (use `pack-prerequisite-checker`).
|
|
57
|
+
- Selecting MCP runtime paths, configuring Blender, or verifying rendered/exported artifacts.
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
<!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/render-export-evidence/SKILL.md and skills/render-export-evidence/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
|
|
2
|
+
# render-export-evidence
|
|
3
|
+
|
|
4
|
+
Purpose: Verify preview/render/GLB artifact truth by recording commands, inputs, output paths, file existence, validation notes, limitations, and conservative status labels.
|
|
5
|
+
|
|
6
|
+
Classify preview, render, `.blend`, and GLB/export evidence into a conservative, one-row-per-artifact-type evidence ledger.
|
|
7
|
+
|
|
8
|
+
Metadata: Contract `v1.0.0` | Category `evidence-and-handoff` | Role `artifact-truth-and-provenance-auditor` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
|
|
9
|
+
|
|
10
|
+
## When to use & trigger cues
|
|
11
|
+
- a user asks whether a preview, render, `.blend`, or GLB/export was actually produced or verified
|
|
12
|
+
- an agent needs to classify raw runtime outputs into a structured, one-row-per-artifact-type evidence ledger
|
|
13
|
+
- a runtime attempt (`runtime-attempt-report`) recorded commands, tools, or output files that need artifact status labels
|
|
14
|
+
- `pre-handoff-verification` or `preview-report` requires classified artifact truth labels as input
|
|
15
|
+
- Trigger phrases: "Did the render produce?", "Can I claim the GLB exists?", "Verify export evidence.", "What artifact status should this have?", "Summarize preview/render/GLB evidence."
|
|
16
|
+
|
|
17
|
+
## When not to use (delegation boundaries)
|
|
18
|
+
- the user only needs a scene plan with no runtime or artifact evidence → use `runtime-readiness` (`references/skill-runtime-readiness.md`; Delegates out-of-scope requests to runtime-readiness)
|
|
19
|
+
- runtime readiness or path selection has not been completed and the user wants setup or routing; use runtime-readiness or runtime-path-picker → use `runtime-readiness` (`references/skill-runtime-readiness.md`; Delegates out-of-scope requests to runtime-readiness)
|
|
20
|
+
- the task is gating a handoff via confirm-or-downgrade rules; use pre-handoff-verification → use `pre-handoff-verification` (`references/skill-pre-handoff-verification.md`; Delegates out-of-scope requests to pre-handoff-verification)
|
|
21
|
+
- the task is rendering the formatted preview/eval report Markdown; use preview-report → use `preview-report` (`references/skill-preview-report.md`; Delegates out-of-scope requests to preview-report)
|
|
22
|
+
- the task is GLB web integration after evidence is already classified and gated; use glb-web-handoff → use `glb-web-handoff` (`references/skill-glb-web-handoff.md`; Delegates out-of-scope requests to glb-web-handoff)
|
|
23
|
+
|
|
24
|
+
## Input & output contract
|
|
25
|
+
- Required input `candidate_artifact_records` (`array`): Reported file paths, byte sizes, SHA-256 digests, and inspection outputs for renders or GLBs
|
|
26
|
+
- Required input `runtime_execution_trace` (`object`): Factual runtime attempt record indicating whether Blender actually ran
|
|
27
|
+
- Optional input `glb_inspector_or_validator_report` (`object`): Optional output from scripts/inspect-glb.mjs or Khronos gltf-validator
|
|
28
|
+
- Output contract: `artifact_truth_state_ledger`, `downgrade_only_evidence_classification`, `missing_evidence_remediation_checklist` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
|
|
29
|
+
|
|
30
|
+
## Quick-start steps
|
|
31
|
+
1. Identify the runtime state (`Not Run | Attempted | Produced | Verified | Failed`) and list one ledger row per claimed artifact type.
|
|
32
|
+
2. Collect command/tool (plus exact command and exit code for CLI), input/script/scene, output path, current-run provenance, file existence, validation notes, and limitations.
|
|
33
|
+
3. Assign the most conservative valid artifact status (`Not Run | Not Produced | Produced | Verified | Failed`, defaulting to `Not Produced`, downgrade-only) and label any Path 2 evidence as `non-release`.
|
|
34
|
+
4. Pass the classified ledger to `pre-handoff-verification` to gate handoffs, `preview-report` to render report Markdown, `glb-web-handoff` for web integration, or `plain-language-response` for plain-language user responses.
|
|
35
|
+
|
|
36
|
+
## Cross-skill handoffs
|
|
37
|
+
- [upstream_reference] Runtime readiness → `runtime-readiness` (`references/skill-runtime-readiness.md`) — `when.all: [runtime.path not_equals "unselected"; runtime.verifiedReady equals false]`
|
|
38
|
+
- [upstream_reference] Runtime attempt recording → `runtime-attempt-report` (`references/skill-runtime-attempt-report.md`) — `when.all: [runtime.status in ["Attempted","Produced","Verified","Failed"]; request.topic equals "attempt_report"]`
|
|
39
|
+
- [upstream_reference] Scene validation → `scene-readiness` (`references/skill-scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
|
|
40
|
+
- [progression] Handoff gating (confirm-or-downgrade) → `pre-handoff-verification` (`references/skill-pre-handoff-verification.md`) — `when.all: [stage.current equals "final_verification"]`
|
|
41
|
+
- [progression] Report Markdown rendering → `preview-report` (`references/skill-preview-report.md`) — `when.all: [stage.current equals "report_formatting"; handoff.consumerStack equals "stakeholder_report"]`
|
|
42
|
+
- [progression] GLB/web handoff → `glb-web-handoff` (`references/skill-glb-web-handoff.md`) — `when.all: [artifact.type equals "glb"; handoff.consumerStack equals "web_glb"]`
|
|
43
|
+
- [progression] User-facing explanation → `plain-language-response` (`references/skill-plain-language-response.md`) — `when.all: [stage.current equals "final_communication"]`
|
|
44
|
+
|
|
45
|
+
## Safety boundaries & non-goals
|
|
46
|
+
- Runtime boundary: This skill classifies evidence from the 2-path + CLI appendix runtime model (see `docs/runtime-stack-strategy.md`):
|
|
47
|
+
- Run Blender, render images, export GLB, or modify scene data.
|
|
48
|
+
- Install or configure runtime bridges.
|
|
49
|
+
- Gate handoffs or perform confirm-or-downgrade release decisions (`pre-handoff-verification`).
|
|
50
|
+
- Render the formatted preview or evaluation report Markdown (`preview-report`).
|
|
51
|
+
- Own GLB web integration handoffs (`glb-web-handoff`).
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
<!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/resolution-aspect-decision/SKILL.md and skills/resolution-aspect-decision/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
|
|
2
|
+
# resolution-aspect-decision
|
|
3
|
+
|
|
4
|
+
Purpose: Pick the right render resolution + aspect ratio for the consumer use case before render; avoid render-then-crop and aspect mismatch.
|
|
5
|
+
|
|
6
|
+
Avoid the most common render planning mistake: rendering at one aspect / resolution and cropping or upscaling to fit. Pick the consumer's required output upfront.
|
|
7
|
+
|
|
8
|
+
Metadata: Contract `v1.0.0` | Category `render-and-output-decisions` | Role `resolution-and-aspect-ratio-pinner` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
|
|
9
|
+
|
|
10
|
+
## When to use & trigger cues
|
|
11
|
+
- before render
|
|
12
|
+
- when consumer requires specific aspect / resolution
|
|
13
|
+
- before composition planning (aspect drives composition rules)
|
|
14
|
+
- Trigger phrases: "what resolution", "how big should the render be", "16:9 or square"
|
|
15
|
+
|
|
16
|
+
## When not to use (delegation boundaries)
|
|
17
|
+
- after render is complete (no benefit) → use `camera-composition` (`references/skill-camera-composition.md`; no benefit)
|
|
18
|
+
- pure modeling → use `output-format-decision` (`references/skill-output-format-decision.md`; Delegates out-of-scope requests to output-format-decision)
|
|
19
|
+
- internal preview-only renders (any reasonable size works) → use `composition-quality-checker` (`references/skill-composition-quality-checker.md`; any reasonable size works)
|
|
20
|
+
|
|
21
|
+
## Input & output contract
|
|
22
|
+
- Required input `target_delivery_surfaces` (`array`): Target display placements (desktop hero banner, mobile portrait feed, 1:1 e-commerce card, 4K print)
|
|
23
|
+
- Required input `framing_and_crop_strategy` (`string`): Whether deliverables use a single master aspect ratio with safe-zone crops or separate camera setups
|
|
24
|
+
- Optional input `render_time_constraints` (`string`): Optional render time ceiling influencing pixel dimensions and percentage scale
|
|
25
|
+
- Output contract: `pinned_pixel_dimensions_and_aspect_ratio`, `safe_frame_and_overscan_margins`, `camera_sensor_fit_alignment_notes` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
|
|
26
|
+
|
|
27
|
+
## Quick-start steps
|
|
28
|
+
1. Identify the consumer use case and target placement (web hero, social feed, print, app asset).
|
|
29
|
+
2. Pick the delivery aspect ratio (`W:H`) upfront so camera framing matches target placement.
|
|
30
|
+
3. Pick exact render resolution (`W × H` in pixels) and `DPI / PPI` for print deliverables.
|
|
31
|
+
4. Define per-stream resolution records if multiple delivery targets exist.
|
|
32
|
+
5. Pin the record for the operator to enter in Blender scene render properties (no rendering, no post-render resizing).
|
|
33
|
+
|
|
34
|
+
## Cross-skill handoffs
|
|
35
|
+
- [upstream_reference] Camera & composition planning (upstream framing setup) → `camera-composition` (`references/skill-camera-composition.md`) — `when.all: [brief.locked equals true; stage.current equals "camera_planning"]`
|
|
36
|
+
- [progression] Composition framing validation against pinned aspect → `composition-quality-checker` (`references/skill-composition-quality-checker.md`) — `when.all: [quality.domain equals "composition"; quality.verdict equals "not_run"]`
|
|
37
|
+
- [upstream_reference] Color configuration decision → `color-management-decision` (`references/skill-color-management-decision.md`) — `when.all: [decision.colorLocked equals false]`
|
|
38
|
+
- [progression] Container / codec decision → `output-format-decision` (`references/skill-output-format-decision.md`) — `when.all: [decision.formatLocked equals false]`
|
|
39
|
+
- [progression] Render engine decision → `cycles-vs-eevee-decision` (`references/skill-cycles-vs-eevee-decision.md`) — `when.all: [decision.engineLocked equals false]`
|
|
40
|
+
- [progression] Post-render saved file verification → `render-export-evidence` (`references/skill-render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
|
|
41
|
+
|
|
42
|
+
## Safety boundaries & non-goals
|
|
43
|
+
- Runtime boundary: Decision skill — does not render. Pins resolution + aspect; operator applies in scene render properties.
|
|
44
|
+
- Never execute Blender or trigger renders.
|
|
45
|
+
- Never resize, crop, upscale, or convert images post-render (belongs outside this skill).
|
|
46
|
+
- Never choose file containers, codecs, or bit depths (`output-format-decision`).
|
|
47
|
+
- Never configure color spaces or HDR view transforms (`color-management-decision`).
|
|
48
|
+
- Never validate camera composition (`composition-quality-checker`) or verify rendered output files (`render-export-evidence`).
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
<!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/runtime-attempt-report/SKILL.md and skills/runtime-attempt-report/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
|
|
2
|
+
# runtime-attempt-report
|
|
3
|
+
|
|
4
|
+
Purpose: Produce an evidence-bound runtime attempt report with truth labels and next steps; does not certify upstream stack success.
|
|
5
|
+
|
|
6
|
+
Record a chronological, secret-free runtime attempt log—including version stamps, downgrade-only truth labels, and routed next steps—for Path 1, Path 2, or CLI appendix runs. A report produced by this skill can serve as an in-repo provenance record under `docs/evals/`, without certifying artifact quality or diagnosing runtime defects.
|
|
7
|
+
|
|
8
|
+
Metadata: Contract `v1.0.0` | Category `runtime-and-execution` | Role `execution-attempt-provenance-logger` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
|
|
9
|
+
|
|
10
|
+
## When to use & trigger cues
|
|
11
|
+
- after any Blender connect attempt (success or failure)
|
|
12
|
+
- preparing notes for `docs/evals/` style provenance
|
|
13
|
+
- teaching non-technical stakeholders what actually occurred
|
|
14
|
+
- Trigger phrases: "write up what we tried", "runtime attempt log", "postmortem blender connect", "evidence report template"
|
|
15
|
+
|
|
16
|
+
## When not to use (delegation boundaries)
|
|
17
|
+
- Classifying rendered or exported visual artifacts (render-export-evidence) → use `render-export-evidence` (`references/skill-render-export-evidence.md`; render-export-evidence)
|
|
18
|
+
- Diagnosing systematic runtime or scene defects (blender-troubleshooting) → use `blender-troubleshooting` (`references/skill-blender-troubleshooting.md`; blender-troubleshooting)
|
|
19
|
+
- Running pre-attempt environment checks (runtime-readiness) → use `runtime-readiness` (`references/skill-runtime-readiness.md`; runtime-readiness)
|
|
20
|
+
- Selecting which runtime path to use before an attempt (runtime-path-picker) → use `runtime-path-picker` (`references/skill-runtime-path-picker.md`; runtime-path-picker)
|
|
21
|
+
- Performing final release or delivery gating (pre-handoff-verification) → use `pre-handoff-verification` (`references/skill-pre-handoff-verification.md`; pre-handoff-verification)
|
|
22
|
+
|
|
23
|
+
## Input & output contract
|
|
24
|
+
- Required input `attempted_runtime_path_and_host` (`object`): Path 1, Path 2, or CLI appendix route and MCP host configuration used during the attempt
|
|
25
|
+
- Required input `chronological_execution_log` (`array`): Timestamped sequence of read-only or mutation tool calls, responses, and observed outcomes
|
|
26
|
+
- Required input `version_stamps` (`object`): Exact Blender version, add-on version, and MCP client version strings
|
|
27
|
+
- Optional input `pre_mutation_backup_record` (`object`): Optional .blend checkpoint backup metadata if an L1+ mutation was attempted
|
|
28
|
+
- Output contract: `structured_runtime_attempt_report_md`, `locked_runtime_and_artifact_truth_labels`, `eval_evidence_archival_path` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
|
|
29
|
+
|
|
30
|
+
## Quick-start steps
|
|
31
|
+
1. gather timestamps, commands/config surfaces touched (no secrets)
|
|
32
|
+
2. choose blocks from `skills/runtime-attempt-report/references/truth-label-blocks.md`
|
|
33
|
+
3. fill `skills/runtime-attempt-report/references/attempt-record-template.md`
|
|
34
|
+
4. route improvements via `skills/runtime-attempt-report/references/triage-next-steps.md`
|
|
35
|
+
|
|
36
|
+
## Cross-skill handoffs
|
|
37
|
+
- [upstream_reference] Pre-attempt readiness check → `runtime-readiness` (`references/skill-runtime-readiness.md`) — `when.all: [runtime.path not_equals "unselected"; runtime.verifiedReady equals false]`
|
|
38
|
+
- [upstream_reference] Runtime path selection context → `runtime-path-picker` (`references/skill-runtime-path-picker.md`) — `when.all: [runtime.path equals "unselected"]`
|
|
39
|
+
- [fallback] Bridge / port / host conflicts → `bridge-conflicts` (`references/skill-bridge-conflicts.md`) — `when.all: [runtime.conflictDetected equals true]`
|
|
40
|
+
- [fallback] Runtime or scene defect diagnosis → `blender-troubleshooting` (`references/skill-blender-troubleshooting.md`) — `when.all: [runtime.errorDetected equals true]`
|
|
41
|
+
- [progression] Artifact evidence classification → `render-export-evidence` (`references/skill-render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
|
|
42
|
+
- [fallback] Final handoff gate & failure exit → `pre-handoff-verification` (`references/skill-pre-handoff-verification.md`) — `when.any: [gate.status equals "failed"; runtime.mode equals "blocked"]`
|
|
43
|
+
|
|
44
|
+
## Safety boundaries & non-goals
|
|
45
|
+
- Runtime boundary: Documentation skill only—never executes Blender or generates Python. Reports must strictly preserve upstream runtime distinctions: - **Path 1**: Official Blender Lab MCP in Blender 5.1+, hosted from (a) Anthropic Connector or (b) manual MCP client. The Connector is NOT standalone. - **Path 2**: Community `mcp-for-blender` (third-party, Blender 3.0+); document only with explicit caveats and never treat as release evidence. - **CLI fallback**: Appendix only (`blender --background --python`); remains upstream-documented with no in-repo evidence file unless a report written by this skill becomes one under `docs/evals/`.
|
|
46
|
+
- Executing Blender, running MCP commands, or writing Python scripts.
|
|
47
|
+
- Certifying visual artifact quality or export integrity (owned by `render-export-evidence`).
|
|
48
|
+
- Diagnosing runtime crashes, bridge conflicts, or scene errors (owned by `blender-troubleshooting` and `bridge-conflicts`).
|
|
49
|
+
- Approving final delivery packages without passing through `pre-handoff-verification`.
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
<!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/runtime-path-picker/SKILL.md and skills/runtime-path-picker/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
|
|
2
|
+
# runtime-path-picker
|
|
3
|
+
|
|
4
|
+
Purpose: Choose Path 1 Lab MCP, Path 2 mcp-for-blender bridge, or CLI appendix from constraints; Connector hosts Path 1 only with Lab add-on inside Blender.
|
|
5
|
+
|
|
6
|
+
Produce a **single primary** runtime execution choice among Path 1 (Blender Lab MCP), Path 2 (community `mcp-for-blender` (formerly `ahujasid/blender-mcp`)), or the CLI fallback appendix — with explicit tradeoffs and no false "standalone Connector" claims.
|
|
7
|
+
|
|
8
|
+
Metadata: Contract `v1.0.0` | Category `runtime-and-execution` | Role `execution-path-selector` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
|
|
9
|
+
|
|
10
|
+
## When to use & trigger cues
|
|
11
|
+
- user unsure Lab vs community vs CLI
|
|
12
|
+
- environment pinned to Blender below 5.1 (Path 1 unavailable)
|
|
13
|
+
- automation / batch render discussion
|
|
14
|
+
- Trigger phrases: "which MCP should I use", "Lab MCP or mcp-for-blender", "Path 1 or Path 2", "CLI vs MCP"
|
|
15
|
+
|
|
16
|
+
## When not to use (delegation boundaries)
|
|
17
|
+
- prerequisite framing or install steps → use `runtime-setup` (`references/skill-runtime-setup.md`; Delegates out-of-scope requests to runtime-setup)
|
|
18
|
+
- running the readiness matrix → use `runtime-readiness` (`references/skill-runtime-readiness.md`; Delegates out-of-scope requests to runtime-readiness)
|
|
19
|
+
- detailing Path 1 host (a) Connector vs (b) manual MCP client → use `path-one-host-outline` (`references/skill-path-one-host-outline.md`; Delegates out-of-scope requests to path-one-host-outline)
|
|
20
|
+
- outlining headless CLI jobs → use `cli-appendix-job-outline` (`references/skill-cli-appendix-job-outline.md`; Delegates out-of-scope requests to cli-appendix-job-outline)
|
|
21
|
+
- resolving active bridge or port collisions → use `bridge-conflicts` (`references/skill-bridge-conflicts.md`; Delegates out-of-scope requests to bridge-conflicts)
|
|
22
|
+
- halting on contradictory constraints before handoff → use `pre-handoff-verification` (`references/skill-pre-handoff-verification.md`; Delegates out-of-scope requests to pre-handoff-verification)
|
|
23
|
+
|
|
24
|
+
## Input & output contract
|
|
25
|
+
- Required input `blender_version_posture` (`string`): Installed or available Blender version (e.g., 5.1+, 4.2 LTS, 3.6 LTS, or unknown)
|
|
26
|
+
- Required input `host_environment_category` (`string`): Available MCP client host (Claude Desktop Connector, manual MCP IDE client, or headless CI)
|
|
27
|
+
- Optional input `organizational_policy_constraints` (`string`): Optional security or IT constraints restricting third-party add-ons or interactive GUI sessions
|
|
28
|
+
- Output contract: `single_recommended_runtime_path`, `rejected_paths_comparison_table`, `path_specific_caveat_and_next_skill` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
|
|
29
|
+
|
|
30
|
+
## Quick-start steps
|
|
31
|
+
1. collect Blender version band, host app (Claude Desktop vs coding agent vs CI), interactivity needs
|
|
32
|
+
2. score against `skills/runtime-path-picker/references/path-constraints-table.md`
|
|
33
|
+
3. walk `skills/runtime-path-picker/references/decision-tree.md`
|
|
34
|
+
4. document choice using `skills/runtime-path-picker/references/anti-patterns.md` guardrails
|
|
35
|
+
|
|
36
|
+
## Cross-skill handoffs
|
|
37
|
+
- [progression] Prerequisite framing → `runtime-setup` (`references/skill-runtime-setup.md`) — `when.all: [runtime.path not_equals "unselected"; stage.current equals "runtime_setup"]`
|
|
38
|
+
- [progression] Readiness matrix check → `runtime-readiness` (`references/skill-runtime-readiness.md`) — `when.all: [runtime.path not_equals "unselected"; runtime.verifiedReady equals false]`
|
|
39
|
+
- [progression] Host (a)/(b) specifics for Path 1 → `path-one-host-outline` (`references/skill-path-one-host-outline.md`) — `when.all: [runtime.path equals "path_1"; stage.current equals "runtime_setup"]`
|
|
40
|
+
- [progression] Headless CLI appendix job outline → `cli-appendix-job-outline` (`references/skill-cli-appendix-job-outline.md`) — `when.all: [runtime.path equals "cli_appendix"; request.topic equals "cli_batch"]`
|
|
41
|
+
- [fallback] Bridge or port 9876 conflicts → `bridge-conflicts` (`references/skill-bridge-conflicts.md`) — `when.all: [runtime.conflictDetected equals true]`
|
|
42
|
+
- [fallback] Contradictory constraints failure exit → `pre-handoff-verification` (`references/skill-pre-handoff-verification.md`) — `when.any: [gate.status equals "failed"; runtime.mode equals "blocked"]`
|
|
43
|
+
|
|
44
|
+
## Safety boundaries & non-goals
|
|
45
|
+
- Runtime boundary: Decision skill only — chooses a single primary path from constraints and configures nothing (see `docs/runtime-stack-strategy.md` for the canonical model). - **Path 1**: Official Blender Lab MCP in Blender 5.1+ (add-on manifest literal `blender_version_min = "5.1.0"`), hosted from (a) Anthropic Connector in Claude Desktop or (b) any manually configured MCP client. Connector is NOT standalone. - **Path 2**: Community `mcp-for-blender` (renamed from `ahujasid/blender-mcp`), third-party, Blender 3.0+, recommended only with explicit caveats and **never as release evidence**. Manual configuration responsibility; see `docs/unofficial-runtime-bridges.md`. - **CLI fallback**: Appendix only (`blender --background --python`), never a peer path without an eval record. Documented upstream as a first-class Blender CLI surface (render/Cycles/format/Python sections read in the current Blender 5.2 LTS Manual); **no in-repo evidence file yet** for BlendOps-run CLI examples. - **Bridge limit**: One MCP bridge per Blender instance (default port 9876). - **Role boundary**: Prerequisite framing belongs to `runtime-setup`; readiness matrix checks belong to `runtime-readiness`; Path 1 host a/b details belong to `path-one-host-outline`; headless job outlines belong to `cli-appendix-job-outline`; bridge conflicts belong to `bridge-conflicts`.
|
|
46
|
+
- Walking through step-by-step add-on installation or host config file edits (owned by `runtime-setup`).
|
|
47
|
+
- Probing live runtime connectivity (owned by `runtime-readiness`).
|
|
48
|
+
- Detailing Path 1 Host (a) vs Host (b) architecture (owned by `path-one-host-outline`) or CLI batch job phases (owned by `cli-appendix-job-outline`).
|
|
49
|
+
- Executing Blender, generating Python code, or verifying artifacts.
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
<!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/runtime-readiness/SKILL.md and skills/runtime-readiness/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
|
|
2
|
+
# runtime-readiness
|
|
3
|
+
|
|
4
|
+
Purpose: Evaluate whether official runtime appears ready using evidence-bound checks and explicit readiness states.
|
|
5
|
+
|
|
6
|
+
Run the evidence-bound readiness matrix to evaluate check completeness (`Ready | Partially Ready | Blocked | Unknown`) before any runtime attempt.
|
|
7
|
+
|
|
8
|
+
Metadata: Contract `v1.0.0` | Category `runtime-and-execution` | Role `runtime-connection-and-version-preflight` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
|
|
9
|
+
|
|
10
|
+
## When to use & trigger cues
|
|
11
|
+
- to run the readiness matrix after prerequisites are framed (`runtime-setup`) and a target path is selected (`runtime-path-picker`)
|
|
12
|
+
- before any runtime manual evaluation or planning handoff
|
|
13
|
+
- Trigger phrases: "check runtime readiness", "is runtime available", "can we run this now", "run the readiness matrix for our chosen Blender path"
|
|
14
|
+
|
|
15
|
+
## When not to use (delegation boundaries)
|
|
16
|
+
- as proof that Blender ran or that runtime execution succeeded → use `runtime-path-picker` (`references/skill-runtime-path-picker.md`; Delegates out-of-scope requests to runtime-path-picker)
|
|
17
|
+
- as a substitute for runtime truth states (Not Run | Attempted | Produced | Verified | Failed) or artifact status (default Not Produced) → use `path-one-host-outline` (`references/skill-path-one-host-outline.md`; default Not Produced)
|
|
18
|
+
- to choose a runtime path → use `path-one-host-outline` (`references/skill-path-one-host-outline.md`; use path-one-host-outline)
|
|
19
|
+
|
|
20
|
+
## Input & output contract
|
|
21
|
+
- Required input `selected_runtime_path` (`string`): Target runtime path to verify (Path 1 Official Blender Lab MCP 5.1+, Path 2 mcp-for-blender 3.0+, or CLI appendix)
|
|
22
|
+
- Required input `observed_environment_signals` (`object`): Observed Blender version, enabled add-on state, MCP host configuration, and tool surface signals
|
|
23
|
+
- Optional input `port_or_session_diagnostics` (`object`): Optional port 9876 listener status or active Blender session count
|
|
24
|
+
- Output contract: `runtime_readiness_matrix`, `readiness_verdict_and_missing_prerequisites`, `preserved_not_run_truth_state_block` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
|
|
25
|
+
|
|
26
|
+
## Quick-start steps
|
|
27
|
+
1. confirm this skill fits your goal
|
|
28
|
+
2. provide required inputs first
|
|
29
|
+
3. keep runtime claims evidence-bound
|
|
30
|
+
4. follow suggested next-skill handoff
|
|
31
|
+
|
|
32
|
+
## Cross-skill handoffs
|
|
33
|
+
- [upstream_reference] If runtime path is not yet chosen → `runtime-path-picker` (`references/skill-runtime-path-picker.md`) — `when.all: [runtime.path equals "unselected"]`
|
|
34
|
+
- [upstream_reference] If Path 1 host (a) or (b) outline is needed → `path-one-host-outline` (`references/skill-path-one-host-outline.md`) — `when.all: [runtime.path equals "path_1"; stage.current equals "runtime_setup"]`
|
|
35
|
+
- [fallback] If prerequisites/boundaries are missing (Blocked / Unknown) → `runtime-setup` (`references/skill-runtime-setup.md`) — `when.all: [runtime.path not_equals "unselected"; stage.current equals "runtime_setup"]`
|
|
36
|
+
- [fallback] If bridge contention is detected → `bridge-conflicts` (`references/skill-bridge-conflicts.md`) — `when.all: [runtime.conflictDetected equals true]`
|
|
37
|
+
- [upstream_reference] If CLI appendix job structure is needed → `cli-appendix-job-outline` (`references/skill-cli-appendix-job-outline.md`) — `when.all: [runtime.path equals "cli_appendix"; request.topic equals "cli_batch"]`
|
|
38
|
+
- [alternative] If Ready / Partially Ready and moving to scene planning (product-hero-scene-planner) → `product-hero-scene-planner` (`references/skill-product-hero-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.domain equals "product_hero"]`
|
|
39
|
+
- [conditional] If Ready / Partially Ready and moving to scene planning (workflow-stage-router) → `workflow-stage-router` (`references/skill-workflow-stage-router.md`) — `when.all: [preflight.passed equals true; inventory.exists equals true]`
|
|
40
|
+
|
|
41
|
+
## Safety boundaries & non-goals
|
|
42
|
+
- Runtime boundary: - Readiness ≠ execution: `Ready` means readiness checks passed, never that Blender executed or artifacts exist. - Readiness statuses (`Ready | Partially Ready | Blocked | Unknown`) describe check completeness only; never conflate them with runtime truth states (`Not Run | Attempted | Produced | Verified | Failed`, downgrade-only) or artifact state (default `Not Produced`). - This skill can check local readiness signals. - This skill must not claim runtime artifact production. - This skill must not claim execution success without execution evidence. - Path 1 Anthropic Connector is never standalone: it always requires the Official Blender Lab MCP add-on installed inside Blender 5.1+. - Path 2 (`mcp-for-blender`) is third-party only, carries mandatory caveats, and is never release evidence. - CLI fallback (`blender --background --python`) is appendix-only and never a peer path without an evaluation record.
|
|
43
|
+
- runtime execution
|
|
44
|
+
- artifact generation claims
|
|
45
|
+
- uncaveated Path 2 / peer-path CLI fallback
|
|
@@ -0,0 +1,45 @@
|
|
|
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
|
|
3
|
+
|
|
4
|
+
Purpose: Establish official runtime prerequisites and setup boundaries before any Blender execution claim.
|
|
5
|
+
|
|
6
|
+
Establish runtime setup prerequisites, per-path minimum versions, source-confidence labels, truth-state defaults, and single-bridge boundaries before any Blender execution claim.
|
|
7
|
+
|
|
8
|
+
Metadata: Contract `v1.0.0` | Category `runtime-and-execution` | Role `path-1-and-2-setup-instructor` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
|
|
9
|
+
|
|
10
|
+
## When to use & trigger cues
|
|
11
|
+
- beginning of a Blender-related task before any runtime path is executed
|
|
12
|
+
- user asks what prerequisites, version floors, or setup boundaries apply
|
|
13
|
+
- framing official vs third-party vs CLI appendix constraints before handoff
|
|
14
|
+
- Trigger phrases: "set up Blender runtime prerequisites", "what are the Blender runtime setup boundaries", "prepare Official Blender Lab MCP setup prerequisites", "runtime prerequisites and version minimums"
|
|
15
|
+
|
|
16
|
+
## When not to use (delegation boundaries)
|
|
17
|
+
- to install or configure a runtime automatically → use `runtime-path-picker` (`references/skill-runtime-path-picker.md`; Delegates out-of-scope requests to runtime-path-picker)
|
|
18
|
+
- to claim runtime execution has already succeeded → use `path-one-host-outline` (`references/skill-path-one-host-outline.md`; Delegates out-of-scope requests to path-one-host-outline)
|
|
19
|
+
- to choose a runtime path → use `runtime-readiness` (`references/skill-runtime-readiness.md`; runtime-readiness)
|
|
20
|
+
|
|
21
|
+
## Input & output contract
|
|
22
|
+
- Required input `selected_runtime_path` (`string`): Chosen execution path from runtime-path-picker (Path 1 Lab MCP, Path 2 mcp-for-blender, or CLI appendix)
|
|
23
|
+
- Required input `host_client_environment` (`string`): User MCP host application (Claude Desktop Connector, Claude Code, Cursor, Windsurf, or manual client)
|
|
24
|
+
- Optional input `installed_blender_version` (`string`): Installed Blender version used to check the Blender 5.1+ floor for Path 1 vs 3.0+ for Path 2
|
|
25
|
+
- Output contract: `step_by_step_setup_prerequisites`, `path_version_and_host_boundary_notes`, `readiness_verification_handoff` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
|
|
26
|
+
|
|
27
|
+
## Quick-start steps
|
|
28
|
+
1. confirm this skill fits your goal
|
|
29
|
+
2. provide required inputs first
|
|
30
|
+
3. keep runtime claims evidence-bound
|
|
31
|
+
4. follow suggested next-skill handoff
|
|
32
|
+
|
|
33
|
+
## Cross-skill handoffs
|
|
34
|
+
- [upstream_reference] Path selection → `runtime-path-picker` (`references/skill-runtime-path-picker.md`) — `when.all: [runtime.path equals "unselected"]`
|
|
35
|
+
- [progression] Path 1 host (a)/(b) details → `path-one-host-outline` (`references/skill-path-one-host-outline.md`) — `when.all: [runtime.path equals "path_1"; stage.current equals "runtime_setup"]`
|
|
36
|
+
- [progression] CLI appendix job structure → `cli-appendix-job-outline` (`references/skill-cli-appendix-job-outline.md`) — `when.all: [runtime.path equals "cli_appendix"; request.topic equals "cli_batch"]`
|
|
37
|
+
- [fallback] Bridge conflict resolution → `bridge-conflicts` (`references/skill-bridge-conflicts.md`) — `when.all: [runtime.conflictDetected equals true]`
|
|
38
|
+
- [progression] Readiness matrix check → `runtime-readiness` (`references/skill-runtime-readiness.md`) — `when.all: [runtime.path not_equals "unselected"; runtime.verifiedReady equals false]`
|
|
39
|
+
- [alternative] Scene planning after readiness → `product-hero-scene-planner` (`references/skill-product-hero-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.domain equals "product_hero"]`
|
|
40
|
+
|
|
41
|
+
## Safety boundaries & non-goals
|
|
42
|
+
- 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
|
|
43
|
+
- runtime installer creation
|
|
44
|
+
- runtime execution automation
|
|
45
|
+
- custom runtime ownership
|
|
@@ -0,0 +1,48 @@
|
|
|
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
|
|
3
|
+
|
|
4
|
+
Purpose: Apply multi-category readiness gates with pass/warn/fail and evidence-bound verdicts.
|
|
5
|
+
|
|
6
|
+
Evaluate scene/workflow readiness honestly and consistently before any success claim.
|
|
7
|
+
|
|
8
|
+
Metadata: Contract `v1.0.0` | Category `quality-validators` | Role `holistic-scene-readiness-aggregator` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
|
|
9
|
+
|
|
10
|
+
## When to use & trigger cues
|
|
11
|
+
- before readiness, export, or handoff claims to get a broad multi-category review
|
|
12
|
+
- after planning passes or after focused domain checkers have run
|
|
13
|
+
- during text-only or runtime evaluation reporting
|
|
14
|
+
- Trigger phrases: "quality-check this scene", "is this ready", "evaluate pass warn fail"
|
|
15
|
+
|
|
16
|
+
## When not to use (delegation boundaries)
|
|
17
|
+
- as a replacement for evidence collection → use `product-hero-scene-planner` (`references/skill-product-hero-scene-planner.md`; Delegates out-of-scope requests to product-hero-scene-planner)
|
|
18
|
+
- to fabricate confidence in missing artifacts → use `lighting-material-plan` (`references/skill-lighting-material-plan.md`; Delegates out-of-scope requests to lighting-material-plan)
|
|
19
|
+
|
|
20
|
+
## Input & output contract
|
|
21
|
+
- Required input `scene_plan_and_specialist_verdicts` (`object`): Scene specification plus specialist rows from material, lighting, composition, and polycount checkers
|
|
22
|
+
- Required input `acceptance_criteria_table` (`object`): Measurable Pass/Warn/Fail thresholds for the target deliverable
|
|
23
|
+
- Optional input `preview_or_inspection_notes` (`object`): Optional read-only scene inspection summary or viewport preview notes
|
|
24
|
+
- Output contract: `holistic_scene_quality_verdict`, `aggregated_pass_warn_fail_table`, `blocking_defect_remediation_route` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
|
|
25
|
+
|
|
26
|
+
## Quick-start steps
|
|
27
|
+
1. confirm this skill fits your goal
|
|
28
|
+
2. provide required inputs first
|
|
29
|
+
3. keep runtime claims evidence-bound
|
|
30
|
+
4. follow suggested next-skill handoff
|
|
31
|
+
|
|
32
|
+
## Cross-skill handoffs
|
|
33
|
+
- [upstream_reference] Focused domain validation (if gaps found) (composition-quality-checker) → `composition-quality-checker` (`references/skill-composition-quality-checker.md`) — `when.all: [quality.domain equals "composition"; quality.verdict equals "not_run"]`
|
|
34
|
+
- [upstream_reference] Focused domain validation (if gaps found) (lighting-quality-checker) → `lighting-quality-checker` (`references/skill-lighting-quality-checker.md`) — `when.all: [quality.domain equals "lighting"; quality.verdict equals "not_run"]`
|
|
35
|
+
- [upstream_reference] Focused domain validation (if gaps found) (material-quality-checker) → `material-quality-checker` (`references/skill-material-quality-checker.md`) — `when.all: [quality.domain equals "material"; quality.verdict equals "not_run"]`
|
|
36
|
+
- [upstream_reference] Focused domain validation (if gaps found) (polycount-budget-checker) → `polycount-budget-checker` (`references/skill-polycount-budget-checker.md`) — `when.all: [quality.domain equals "polycount"; budget.verdict equals "Not Run"]`
|
|
37
|
+
- [progression] Evidence classification → `render-export-evidence` (`references/skill-render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
|
|
38
|
+
- [progression] Handoff gate → `pre-handoff-verification` (`references/skill-pre-handoff-verification.md`) — `when.all: [stage.current equals "final_verification"]`
|
|
39
|
+
- [conditional] Web delivery (when applicable) → `glb-web-handoff` (`references/skill-glb-web-handoff.md`) — `when.all: [artifact.type equals "glb"; handoff.consumerStack equals "web_glb"]`
|
|
40
|
+
- [progression] Final communication → `plain-language-response` (`references/skill-plain-language-response.md`) — `when.all: [stage.current equals "final_communication"]`
|
|
41
|
+
|
|
42
|
+
## Safety boundaries & non-goals
|
|
43
|
+
- 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.
|
|
44
|
+
- executing Blender or running/generating Python code
|
|
45
|
+
- producing or classifying raw render/export artifacts (owned by `render-export-evidence`)
|
|
46
|
+
- replacing focused domain validators (`material-quality-checker`, `lighting-quality-checker`, `composition-quality-checker`, `polycount-budget-checker`)
|
|
47
|
+
- owning final handoff gating (`pre-handoff-verification`) or web handoff packaging (`glb-web-handoff`)
|
|
48
|
+
- making evidence-free readiness claims
|
|
@@ -0,0 +1,44 @@
|
|
|
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
|
|
3
|
+
|
|
4
|
+
Purpose: Detect mid-recipe scope creep and push back constructively before the recipe drifts; require explicit user agreement before scope expansion.
|
|
5
|
+
|
|
6
|
+
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.
|
|
7
|
+
|
|
8
|
+
Metadata: Contract `v1.0.0` | Category `process-discipline` | Role `scope-creep-and-change-request-guard` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
|
|
9
|
+
|
|
10
|
+
## When to use & trigger cues
|
|
11
|
+
- mid-recipe, when user adds new requests beyond the brief
|
|
12
|
+
- when "while we're at it" appears
|
|
13
|
+
- when stages start exceeding their gates "just a bit"
|
|
14
|
+
- Trigger phrases: "can you also", "while you're at it", "actually let's also", "one more thing"
|
|
15
|
+
|
|
16
|
+
## When not to use (delegation boundaries)
|
|
17
|
+
- early planning before scope is pinned → use `done-criteria` (`references/skill-done-criteria.md`; use intent-to-3d-brief-writer and done-criteria)
|
|
18
|
+
- pure brainstorming with no active recipe → use `blender-brainstorming` (`references/skill-blender-brainstorming.md`; use blender-brainstorming)
|
|
19
|
+
- when the addition is already explicitly covered by existing gate criteria in stage-gates / acceptance-criteria-builder (verified against w → use `acceptance-criteria-builder` (`references/skill-acceptance-criteria-builder.md`; verified against written criteria, never judged by feel)
|
|
20
|
+
|
|
21
|
+
## Input & output contract
|
|
22
|
+
- Required input `locked_baseline_brief` (`object`): Currently locked 3D brief, acceptance criteria, and stop conditions
|
|
23
|
+
- Required input `proposed_scope_change` (`string`): Mid-workflow user request adding new deliverables, environments, animations, or scope
|
|
24
|
+
- Optional input `current_workflow_stage` (`string`): Active stage when the scope expansion was requested
|
|
25
|
+
- Output contract: `scope_classification_verdict`, `impact_on_locked_brief_and_budget`, `defer_split_or_reopen_decision` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
|
|
26
|
+
|
|
27
|
+
## Quick-start steps
|
|
28
|
+
1. when scope drift is detected, name it
|
|
29
|
+
2. offer 3 options: decline / explicit-add-now (with agreement) / defer to follow-up recipe
|
|
30
|
+
3. record the decision before proceeding
|
|
31
|
+
|
|
32
|
+
## Cross-skill handoffs
|
|
33
|
+
- [upstream_reference] Original brief → `intent-to-3d-brief-writer` (`references/skill-intent-to-3d-brief-writer.md`) — `when.all: [goal.clarity equals "clear"; brief.locked equals false]`
|
|
34
|
+
- [upstream_reference] Stop condition pinned beforehand / updated on expansion → `done-criteria` (`references/skill-done-criteria.md`) — `when.all: [brief.locked equals true; stage.current equals "stop_condition"]`
|
|
35
|
+
- [upstream_reference] Per-stage gates enforced / updated on expansion → `stage-gates` (`references/skill-stage-gates.md`) — `when.all: [brief.locked equals true; stage.current equals "stage_gates"]`
|
|
36
|
+
- [boundary_delegation] Measurable acceptance rows for added scope → `acceptance-criteria-builder` (`references/skill-acceptance-criteria-builder.md`) — `when.all: [brief.locked equals true; stage.current equals "acceptance_criteria"]`
|
|
37
|
+
- [boundary_delegation] Deferred scope split into follow-up recipes → `blender-recipe-decomposer` (`references/skill-blender-recipe-decomposer.md`) — `when.all: [fit.multiDeliverableDetected equals true]`
|
|
38
|
+
- [progression] Delivery gate after scope and gates settle → `pre-handoff-verification` (`references/skill-pre-handoff-verification.md`) — `when.all: [stage.current equals "final_verification"]`
|
|
39
|
+
|
|
40
|
+
## Safety boundaries & non-goals
|
|
41
|
+
- 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).
|
|
42
|
+
- Run Blender.
|
|
43
|
+
- Author the recipe.
|
|
44
|
+
- Decide for the user (the user picks among options).
|