blendops 0.0.0-stage → 1.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +74 -0
- package/LICENSE +21 -0
- package/README.md +208 -2
- package/bin/blendops.mjs +4 -0
- package/bundles/claude-desktop-manual/BLENDOPS_SINGLE_FILE.md +78 -0
- package/bundles/claude-desktop-manual/IMPORT_STEPS.md +43 -0
- package/bundles/claude-desktop-manual/INSTALL_REPORT_TEMPLATE.md +13 -0
- package/bundles/claude-desktop-manual/README.md +70 -0
- package/bundles/claude-desktop-manual/SKILL.md +62 -0
- package/bundles/claude-desktop-manual/manifest.json +278 -0
- package/bundles/claude-desktop-manual/references/evidence-rules.md +13 -0
- package/bundles/claude-desktop-manual/references/install-boundary.md +13 -0
- package/bundles/claude-desktop-manual/references/laws/evidence-before-done.md +14 -0
- package/bundles/claude-desktop-manual/references/laws/no-arbitrary-python-interface.md +12 -0
- package/bundles/claude-desktop-manual/references/laws/non-blender-user-language.md +13 -0
- package/bundles/claude-desktop-manual/references/laws/official-runtime-only.md +20 -0
- package/bundles/claude-desktop-manual/references/packs/product-hero-v0.md +30 -0
- package/bundles/claude-desktop-manual/references/runtime-stacks.md +13 -0
- package/bundles/claude-desktop-manual/references/skill-map.md +36 -0
- package/bundles/claude-desktop-manual/references/skills/acceptance-criteria-builder.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/asset-discovery.md +73 -0
- package/bundles/claude-desktop-manual/references/skills/asset-fallback-strategy.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/asset-library-plan.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/asset-license-checker.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/asset-style-check.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/blender-brainstorming.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/blender-recipe-decomposer.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/blender-troubleshooting.md +78 -0
- package/bundles/claude-desktop-manual/references/skills/blendops-help.md +82 -0
- package/bundles/claude-desktop-manual/references/skills/bridge-conflicts.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/camera-composition.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/character-portrait.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/cli-appendix-job-outline.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/color-management-decision.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/composition-quality-checker.md +71 -0
- package/bundles/claude-desktop-manual/references/skills/cycles-vs-eevee-decision.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/done-criteria.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/environment-shot.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/glb-animation-handoff.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/glb-web-handoff.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/intent-to-3d-brief-writer.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/interior-scene.md +73 -0
- package/bundles/claude-desktop-manual/references/skills/lighting-material-plan.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/lighting-quality-checker.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/material-quality-checker.md +71 -0
- package/bundles/claude-desktop-manual/references/skills/mobile-glb-budget.md +73 -0
- package/bundles/claude-desktop-manual/references/skills/output-format-decision.md +63 -0
- package/bundles/claude-desktop-manual/references/skills/pack-prerequisite-checker.md +74 -0
- package/bundles/claude-desktop-manual/references/skills/path-one-host-outline.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/plain-language-response.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/polycount-budget-checker.md +71 -0
- package/bundles/claude-desktop-manual/references/skills/pre-handoff-verification.md +76 -0
- package/bundles/claude-desktop-manual/references/skills/preview-report.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/product-grid-scene-planner.md +72 -0
- package/bundles/claude-desktop-manual/references/skills/product-hero-scene-planner.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/r3f-component-plan.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/recipe-fit-assessor.md +75 -0
- package/bundles/claude-desktop-manual/references/skills/render-export-evidence.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/resolution-aspect-decision.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-attempt-report.md +67 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-path-picker.md +67 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-readiness.md +63 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-setup.md +63 -0
- package/bundles/claude-desktop-manual/references/skills/scene-readiness.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/scope-guard.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/stage-gates.md +91 -0
- package/bundles/claude-desktop-manual/references/skills/workflow-stage-router.md +67 -0
- package/bundles/generic-project-local/BLENDOPS.md +71 -0
- package/bundles/generic-project-local/INSTALL_REPORT_TEMPLATE.md +52 -0
- package/bundles/generic-project-local/README.md +73 -0
- package/bundles/generic-project-local/ROLLBACK.md +66 -0
- package/bundles/generic-project-local/manifest.json +66 -0
- package/bundles/skill-package/README.md +54 -0
- package/bundles/skill-package/blendops/LICENSE.txt +21 -0
- package/bundles/skill-package/blendops/SKILL.md +50 -0
- package/bundles/skill-package/blendops/agents/README.md +61 -0
- package/bundles/skill-package/blendops/agents/openai.yaml +4 -0
- package/bundles/skill-package/blendops/references/evidence-rules.md +17 -0
- package/bundles/skill-package/blendops/references/install-boundary.md +13 -0
- package/bundles/skill-package/blendops/references/law-evidence-before-done.md +12 -0
- package/bundles/skill-package/blendops/references/law-no-arbitrary-python-interface.md +7 -0
- package/bundles/skill-package/blendops/references/law-non-blender-user-language.md +8 -0
- package/bundles/skill-package/blendops/references/law-official-runtime-only.md +9 -0
- package/bundles/skill-package/blendops/references/pack-product-hero-v0.md +21 -0
- package/bundles/skill-package/blendops/references/runtime-stacks.md +13 -0
- package/bundles/skill-package/blendops/references/skill-acceptance-criteria-builder.md +51 -0
- package/bundles/skill-package/blendops/references/skill-asset-discovery.md +54 -0
- package/bundles/skill-package/blendops/references/skill-asset-fallback-strategy.md +48 -0
- package/bundles/skill-package/blendops/references/skill-asset-library-plan.md +51 -0
- package/bundles/skill-package/blendops/references/skill-asset-license-checker.md +51 -0
- package/bundles/skill-package/blendops/references/skill-asset-style-check.md +52 -0
- package/bundles/skill-package/blendops/references/skill-blender-brainstorming.md +43 -0
- package/bundles/skill-package/blendops/references/skill-blender-recipe-decomposer.md +48 -0
- package/bundles/skill-package/blendops/references/skill-blender-troubleshooting.md +59 -0
- package/bundles/skill-package/blendops/references/skill-blendops-help.md +62 -0
- package/bundles/skill-package/blendops/references/skill-bridge-conflicts.md +48 -0
- package/bundles/skill-package/blendops/references/skill-camera-composition.md +48 -0
- package/bundles/skill-package/blendops/references/skill-character-portrait.md +50 -0
- package/bundles/skill-package/blendops/references/skill-cli-appendix-job-outline.md +44 -0
- package/bundles/skill-package/blendops/references/skill-color-management-decision.md +50 -0
- package/bundles/skill-package/blendops/references/skill-composition-quality-checker.md +53 -0
- package/bundles/skill-package/blendops/references/skill-cycles-vs-eevee-decision.md +47 -0
- package/bundles/skill-package/blendops/references/skill-done-criteria.md +53 -0
- package/bundles/skill-package/blendops/references/skill-environment-shot.md +47 -0
- package/bundles/skill-package/blendops/references/skill-glb-animation-handoff.md +51 -0
- package/bundles/skill-package/blendops/references/skill-glb-web-handoff.md +51 -0
- package/bundles/skill-package/blendops/references/skill-intent-to-3d-brief-writer.md +50 -0
- package/bundles/skill-package/blendops/references/skill-interior-scene.md +54 -0
- package/bundles/skill-package/blendops/references/skill-lighting-material-plan.md +48 -0
- package/bundles/skill-package/blendops/references/skill-lighting-quality-checker.md +52 -0
- package/bundles/skill-package/blendops/references/skill-map.md +32 -0
- package/bundles/skill-package/blendops/references/skill-material-quality-checker.md +53 -0
- package/bundles/skill-package/blendops/references/skill-mobile-glb-budget.md +55 -0
- package/bundles/skill-package/blendops/references/skill-output-format-decision.md +46 -0
- package/bundles/skill-package/blendops/references/skill-pack-prerequisite-checker.md +56 -0
- package/bundles/skill-package/blendops/references/skill-path-one-host-outline.md +48 -0
- package/bundles/skill-package/blendops/references/skill-plain-language-response.md +53 -0
- package/bundles/skill-package/blendops/references/skill-polycount-budget-checker.md +53 -0
- package/bundles/skill-package/blendops/references/skill-pre-handoff-verification.md +57 -0
- package/bundles/skill-package/blendops/references/skill-preview-report.md +45 -0
- package/bundles/skill-package/blendops/references/skill-product-grid-scene-planner.md +54 -0
- package/bundles/skill-package/blendops/references/skill-product-hero-scene-planner.md +51 -0
- package/bundles/skill-package/blendops/references/skill-r3f-component-plan.md +48 -0
- package/bundles/skill-package/blendops/references/skill-recipe-fit-assessor.md +57 -0
- package/bundles/skill-package/blendops/references/skill-render-export-evidence.md +51 -0
- package/bundles/skill-package/blendops/references/skill-resolution-aspect-decision.md +48 -0
- package/bundles/skill-package/blendops/references/skill-runtime-attempt-report.md +49 -0
- package/bundles/skill-package/blendops/references/skill-runtime-path-picker.md +49 -0
- package/bundles/skill-package/blendops/references/skill-runtime-readiness.md +45 -0
- package/bundles/skill-package/blendops/references/skill-runtime-setup.md +45 -0
- package/bundles/skill-package/blendops/references/skill-scene-readiness.md +48 -0
- package/bundles/skill-package/blendops/references/skill-scope-guard.md +44 -0
- package/bundles/skill-package/blendops/references/skill-stage-gates.md +73 -0
- package/bundles/skill-package/blendops/references/skill-workflow-stage-router.md +49 -0
- package/docs/README.md +276 -0
- package/docs/examples/glb-web-handoff/README.md +174 -0
- package/docs/examples/glb-web-handoff/r3f-glb-viewer.tsx +320 -0
- package/docs/examples/glb-web-handoff/threejs-glb-viewer.mjs +709 -0
- package/docs/knowledge-and-recipe-catalog.md +236 -0
- package/docs/recipes/README.md +27 -0
- package/docs/recipes/cyberpunk-shoe-hero.md +97 -0
- package/docs/workflows/README.md +14 -0
- package/docs/workflows/full-non-blender-user-workflow.md +210 -0
- package/docs/workflows/product-hero-workflow.md +92 -0
- package/laws/README.md +32 -0
- package/laws/evidence-before-done.md +37 -0
- package/laws/no-arbitrary-python-interface.md +32 -0
- package/laws/non-blender-user-language.md +32 -0
- package/laws/official-runtime-only.md +78 -0
- package/package.json +103 -4
- package/packs/README.md +11 -0
- package/packs/product-hero-v0/PACK.md +114 -0
- package/registry/catalog-index.json +21344 -0
- package/registry/compatibility-matrix.json +533 -0
- package/registry/contract-context-fields.json +391 -0
- package/registry/knowledge-catalog.json +4648 -0
- package/registry/knowledge-sources.json +438 -0
- package/registry/recipe-catalog.json +2565 -0
- package/registry/runtime-capability-policy.json +525 -0
- package/registry/runtime-operations.json +4468 -0
- package/registry/skills.json +10231 -0
- package/registry/workflow-graph.json +7390 -0
- package/schemas/adapter-compatibility-matrix.schema.json +166 -0
- package/schemas/contract-context-fields.schema.json +147 -0
- package/schemas/execution-plan.schema.json +325 -0
- package/schemas/glb-web-handoff-manifest.schema.json +744 -0
- package/schemas/knowledge-record.schema.json +460 -0
- package/schemas/knowledge-source-registry.schema.json +268 -0
- package/schemas/operation-execution-ledger.schema.json +348 -0
- package/schemas/recipe-record.schema.json +469 -0
- package/schemas/runtime-capability-policy.schema.json +184 -0
- package/schemas/runtime-evidence-packet.schema.json +211 -0
- package/schemas/runtime-operations.schema.json +535 -0
- package/schemas/runtime-qualification-report.schema.json +540 -0
- package/schemas/runtime-session.schema.json +350 -0
- package/schemas/scene-spec.schema.json +624 -0
- package/schemas/skill-contract.schema.json +402 -0
- package/schemas/skill-eval.schema.json +509 -0
- package/scripts/build-knowledge-catalog.mjs +2376 -0
- package/scripts/compile-scene-plan.mjs +1945 -0
- package/scripts/export-claude-skills.mjs +634 -0
- package/scripts/generate-glb-handoff-report.mjs +2376 -0
- package/scripts/inspect-glb.mjs +1627 -0
- package/scripts/install-skills.mjs +5443 -0
- package/scripts/runtime-orchestrator.mjs +7713 -0
- package/scripts/validate-capability-policy.mjs +531 -0
- package/scripts/validate-evidence-packet.mjs +256 -0
- package/skills/README.md +315 -0
- package/skills/_template/SKILL.md +296 -0
- package/skills/acceptance-criteria-builder/EVAL.md +25 -0
- package/skills/acceptance-criteria-builder/SKILL.md +257 -0
- package/skills/acceptance-criteria-builder/contract.json +205 -0
- package/skills/acceptance-criteria-builder/references/brief-to-criteria-mapper.md +22 -0
- package/skills/acceptance-criteria-builder/references/checklist-patterns.md +22 -0
- package/skills/acceptance-criteria-builder/references/evidence-hook-rules.md +19 -0
- package/skills/asset-discovery/EVAL.md +81 -0
- package/skills/asset-discovery/SKILL.md +252 -0
- package/skills/asset-discovery/contract.json +291 -0
- package/skills/asset-discovery/references/asset-strategy-decision-tree.md +40 -0
- package/skills/asset-discovery/references/budget-reconciliation-patterns.md +54 -0
- package/skills/asset-discovery/references/license-confidence-table.md +41 -0
- package/skills/asset-fallback-strategy/EVAL.md +34 -0
- package/skills/asset-fallback-strategy/SKILL.md +248 -0
- package/skills/asset-fallback-strategy/contract.json +190 -0
- package/skills/asset-fallback-strategy/references/drop-with-caveat-rules.md +36 -0
- package/skills/asset-fallback-strategy/references/fallback-option-types.md +55 -0
- package/skills/asset-fallback-strategy/references/scoring-rubric.md +61 -0
- package/skills/asset-library-plan/EVAL.md +28 -0
- package/skills/asset-library-plan/SKILL.md +263 -0
- package/skills/asset-library-plan/contract.json +177 -0
- package/skills/asset-library-plan/references/folder-structure-rules.md +63 -0
- package/skills/asset-library-plan/references/metadata-schema.md +62 -0
- package/skills/asset-library-plan/references/naming-rules.md +51 -0
- package/skills/asset-license-checker/EVAL.md +33 -0
- package/skills/asset-license-checker/SKILL.md +245 -0
- package/skills/asset-license-checker/contract.json +172 -0
- package/skills/asset-license-checker/references/attribution-rendering-patterns.md +48 -0
- package/skills/asset-license-checker/references/common-license-mapping.md +39 -0
- package/skills/asset-license-checker/references/license-source-rules.md +38 -0
- package/skills/asset-style-check/EVAL.md +26 -0
- package/skills/asset-style-check/SKILL.md +238 -0
- package/skills/asset-style-check/contract.json +251 -0
- package/skills/asset-style-check/references/drift-classification.md +40 -0
- package/skills/asset-style-check/references/intentional-mixed-style.md +39 -0
- package/skills/asset-style-check/references/style-axes.md +46 -0
- package/skills/blender-brainstorming/EVAL.md +79 -0
- package/skills/blender-brainstorming/SKILL.md +228 -0
- package/skills/blender-brainstorming/contract.json +115 -0
- package/skills/blender-brainstorming/references/alternative-scoping-templates.md +43 -0
- package/skills/blender-brainstorming/references/clarification-patterns.md +29 -0
- package/skills/blender-brainstorming/references/intent-summary-style-guide.md +25 -0
- package/skills/blender-recipe-decomposer/EVAL.md +35 -0
- package/skills/blender-recipe-decomposer/SKILL.md +258 -0
- package/skills/blender-recipe-decomposer/contract.json +152 -0
- package/skills/blender-recipe-decomposer/references/dependency-patterns.md +53 -0
- package/skills/blender-recipe-decomposer/references/recipe-grouping-rules.md +58 -0
- package/skills/blender-recipe-decomposer/references/recipe-naming-rules.md +44 -0
- package/skills/blender-troubleshooting/EVAL.md +78 -0
- package/skills/blender-troubleshooting/SKILL.md +263 -0
- package/skills/blender-troubleshooting/contract.json +352 -0
- package/skills/blender-troubleshooting/references/common-symptom-playbooks.md +51 -0
- package/skills/blender-troubleshooting/references/divergence-routing-table.md +23 -0
- package/skills/blender-troubleshooting/references/four-phase-template.md +51 -0
- package/skills/blendops-help/EVAL.md +67 -0
- package/skills/blendops-help/SKILL.md +312 -0
- package/skills/blendops-help/contract.json +229 -0
- package/skills/blendops-help/references/lifecycle-phases.md +91 -0
- package/skills/blendops-help/references/quick-start-prompts.md +65 -0
- package/skills/blendops-help/references/routing-decision-tree.md +57 -0
- package/skills/bridge-conflicts/EVAL.md +83 -0
- package/skills/bridge-conflicts/SKILL.md +246 -0
- package/skills/bridge-conflicts/contract.json +145 -0
- package/skills/bridge-conflicts/references/bridge-state-matrix-template.md +82 -0
- package/skills/bridge-conflicts/references/conflict-playbooks.md +99 -0
- package/skills/bridge-conflicts/references/do-not-reminders.md +42 -0
- package/skills/camera-composition/EVAL.md +32 -0
- package/skills/camera-composition/SKILL.md +196 -0
- package/skills/camera-composition/contract.json +180 -0
- package/skills/camera-composition/references/camera-presets.md +30 -0
- package/skills/camera-composition/references/camera-rubric.md +24 -0
- package/skills/camera-composition/references/hero-composition-patterns.md +24 -0
- package/skills/camera-composition/references/web-layout-negative-space.md +25 -0
- package/skills/character-portrait/EVAL.md +42 -0
- package/skills/character-portrait/SKILL.md +245 -0
- package/skills/character-portrait/contract.json +205 -0
- package/skills/character-portrait/references/portrait-framing-rules.md +39 -0
- package/skills/character-portrait/references/portrait-lighting-patterns.md +50 -0
- package/skills/character-portrait/references/style-consistency-rules.md +41 -0
- package/skills/cli-appendix-job-outline/EVAL.md +26 -0
- package/skills/cli-appendix-job-outline/SKILL.md +252 -0
- package/skills/cli-appendix-job-outline/contract.json +147 -0
- package/skills/cli-appendix-job-outline/references/flag-order-reminders.md +16 -0
- package/skills/cli-appendix-job-outline/references/job-type-matrix.md +13 -0
- package/skills/cli-appendix-job-outline/references/stateless-limitations.md +12 -0
- package/skills/color-management-decision/EVAL.md +28 -0
- package/skills/color-management-decision/SKILL.md +254 -0
- package/skills/color-management-decision/contract.json +162 -0
- package/skills/color-management-decision/references/look-comparison.md +44 -0
- package/skills/color-management-decision/references/per-channel-rules.md +49 -0
- package/skills/color-management-decision/references/pipeline-mapping.md +47 -0
- package/skills/composition-quality-checker/EVAL.md +38 -0
- package/skills/composition-quality-checker/SKILL.md +260 -0
- package/skills/composition-quality-checker/contract.json +221 -0
- package/skills/composition-quality-checker/references/aspect-ratio-rules.md +37 -0
- package/skills/composition-quality-checker/references/composition-rules.md +58 -0
- package/skills/composition-quality-checker/references/headroom-leadroom-rules.md +46 -0
- package/skills/cycles-vs-eevee-decision/EVAL.md +26 -0
- package/skills/cycles-vs-eevee-decision/SKILL.md +249 -0
- package/skills/cycles-vs-eevee-decision/contract.json +142 -0
- package/skills/cycles-vs-eevee-decision/references/engine-feature-matrix.md +39 -0
- package/skills/cycles-vs-eevee-decision/references/gpu-device-rules.md +51 -0
- package/skills/cycles-vs-eevee-decision/references/samples-by-quality.md +53 -0
- package/skills/done-criteria/EVAL.md +33 -0
- package/skills/done-criteria/SKILL.md +225 -0
- package/skills/done-criteria/contract.json +199 -0
- package/skills/done-criteria/references/done-vs-perfect.md +56 -0
- package/skills/done-criteria/references/out-of-scope-patterns.md +50 -0
- package/skills/done-criteria/references/stop-condition-templates.md +39 -0
- package/skills/environment-shot/EVAL.md +44 -0
- package/skills/environment-shot/SKILL.md +237 -0
- package/skills/environment-shot/contract.json +162 -0
- package/skills/environment-shot/references/depth-layering-rules.md +49 -0
- package/skills/environment-shot/references/time-and-weather-rules.md +35 -0
- package/skills/environment-shot/references/wide-shot-camera-rules.md +51 -0
- package/skills/glb-animation-handoff/EVAL.md +39 -0
- package/skills/glb-animation-handoff/SKILL.md +271 -0
- package/skills/glb-animation-handoff/contract.json +247 -0
- package/skills/glb-animation-handoff/references/animation-types.md +36 -0
- package/skills/glb-animation-handoff/references/transition-rules.md +55 -0
- package/skills/glb-animation-handoff/references/web-stack-caveats.md +40 -0
- package/skills/glb-web-handoff/EVAL.md +33 -0
- package/skills/glb-web-handoff/SKILL.md +212 -0
- package/skills/glb-web-handoff/contract.json +171 -0
- package/skills/glb-web-handoff/references/artifact-status-language.md +26 -0
- package/skills/glb-web-handoff/references/glb-handoff-checklist.md +30 -0
- package/skills/glb-web-handoff/references/performance-caveats.md +26 -0
- package/skills/glb-web-handoff/references/threejs-r3f-handoff.md +28 -0
- package/skills/intent-to-3d-brief-writer/EVAL.md +82 -0
- package/skills/intent-to-3d-brief-writer/SKILL.md +238 -0
- package/skills/intent-to-3d-brief-writer/contract.json +195 -0
- package/skills/intent-to-3d-brief-writer/references/acceptance-criteria-patterns.md +46 -0
- package/skills/intent-to-3d-brief-writer/references/eight-slot-template.md +123 -0
- package/skills/intent-to-3d-brief-writer/references/mixed-audience-handling.md +39 -0
- package/skills/interior-scene/EVAL.md +44 -0
- package/skills/interior-scene/SKILL.md +261 -0
- package/skills/interior-scene/contract.json +277 -0
- package/skills/interior-scene/references/furniture-layout-rules.md +51 -0
- package/skills/interior-scene/references/interior-architecture-rules.md +47 -0
- package/skills/interior-scene/references/interior-camera-rules.md +47 -0
- package/skills/lighting-material-plan/EVAL.md +32 -0
- package/skills/lighting-material-plan/SKILL.md +194 -0
- package/skills/lighting-material-plan/contract.json +213 -0
- package/skills/lighting-material-plan/references/cyberpunk-lookdev.md +22 -0
- package/skills/lighting-material-plan/references/lighting-patterns.md +30 -0
- package/skills/lighting-material-plan/references/material-portability.md +25 -0
- package/skills/lighting-material-plan/references/reflective-floor-pattern.md +22 -0
- package/skills/lighting-material-plan/references/web-material-simplification.md +23 -0
- package/skills/lighting-quality-checker/EVAL.md +41 -0
- package/skills/lighting-quality-checker/SKILL.md +247 -0
- package/skills/lighting-quality-checker/contract.json +187 -0
- package/skills/lighting-quality-checker/references/hdri-balance-rules.md +48 -0
- package/skills/lighting-quality-checker/references/intensity-ranges.md +73 -0
- package/skills/lighting-quality-checker/references/shadow-softness-rules.md +38 -0
- package/skills/material-quality-checker/EVAL.md +40 -0
- package/skills/material-quality-checker/SKILL.md +261 -0
- package/skills/material-quality-checker/contract.json +244 -0
- package/skills/material-quality-checker/references/consumer-stack-rules.md +62 -0
- package/skills/material-quality-checker/references/pbr-sanity-rules.md +78 -0
- package/skills/material-quality-checker/references/texture-budget-rules.md +48 -0
- package/skills/mobile-glb-budget/EVAL.md +40 -0
- package/skills/mobile-glb-budget/SKILL.md +264 -0
- package/skills/mobile-glb-budget/contract.json +309 -0
- package/skills/mobile-glb-budget/references/budget-tiers.md +30 -0
- package/skills/mobile-glb-budget/references/degradation-plan.md +34 -0
- package/skills/mobile-glb-budget/references/violation-rules.md +43 -0
- package/skills/output-format-decision/EVAL.md +27 -0
- package/skills/output-format-decision/SKILL.md +222 -0
- package/skills/output-format-decision/contract.json +179 -0
- package/skills/output-format-decision/references/bit-depth-rules.md +56 -0
- package/skills/output-format-decision/references/compression-tradeoffs.md +62 -0
- package/skills/output-format-decision/references/format-decision-matrix.md +34 -0
- package/skills/pack-prerequisite-checker/EVAL.md +26 -0
- package/skills/pack-prerequisite-checker/SKILL.md +272 -0
- package/skills/pack-prerequisite-checker/contract.json +214 -0
- package/skills/pack-prerequisite-checker/references/blocked-start-playbook.md +21 -0
- package/skills/pack-prerequisite-checker/references/pack-readiness-template.md +38 -0
- package/skills/pack-prerequisite-checker/references/prerequisite-matrix.md +20 -0
- package/skills/path-one-host-outline/EVAL.md +26 -0
- package/skills/path-one-host-outline/SKILL.md +251 -0
- package/skills/path-one-host-outline/contract.json +167 -0
- package/skills/path-one-host-outline/references/connector-vs-manual-matrix.md +21 -0
- package/skills/path-one-host-outline/references/host-checklist-template.md +35 -0
- package/skills/path-one-host-outline/references/lab-addon-reminders.md +12 -0
- package/skills/plain-language-response/EVAL.md +33 -0
- package/skills/plain-language-response/SKILL.md +194 -0
- package/skills/plain-language-response/contract.json +242 -0
- package/skills/plain-language-response/references/caveat-language.md +25 -0
- package/skills/plain-language-response/references/plain-language-patterns.md +30 -0
- package/skills/plain-language-response/references/stakeholder-friendly-examples.md +30 -0
- package/skills/plain-language-response/references/status-summary-templates.md +50 -0
- package/skills/polycount-budget-checker/EVAL.md +40 -0
- package/skills/polycount-budget-checker/SKILL.md +251 -0
- package/skills/polycount-budget-checker/contract.json +196 -0
- package/skills/polycount-budget-checker/references/instance-counting-rules.md +39 -0
- package/skills/polycount-budget-checker/references/per-mesh-rules.md +43 -0
- package/skills/polycount-budget-checker/references/topology-hints.md +56 -0
- package/skills/pre-handoff-verification/EVAL.md +84 -0
- package/skills/pre-handoff-verification/SKILL.md +252 -0
- package/skills/pre-handoff-verification/contract.json +295 -0
- package/skills/pre-handoff-verification/references/downgrade-rules.md +39 -0
- package/skills/pre-handoff-verification/references/seven-point-checklist.md +46 -0
- package/skills/pre-handoff-verification/references/text-only-mode-handling.md +36 -0
- package/skills/preview-report/EVAL.md +39 -0
- package/skills/preview-report/SKILL.md +254 -0
- package/skills/preview-report/contract.json +141 -0
- package/skills/preview-report/references/handoff-recipients.md +41 -0
- package/skills/preview-report/references/report-schema.md +60 -0
- package/skills/preview-report/references/truth-label-rules.md +36 -0
- package/skills/product-grid-scene-planner/EVAL.md +42 -0
- package/skills/product-grid-scene-planner/SKILL.md +246 -0
- package/skills/product-grid-scene-planner/contract.json +257 -0
- package/skills/product-grid-scene-planner/references/grid-consistency-rules.md +53 -0
- package/skills/product-grid-scene-planner/references/grid-layout-rules.md +42 -0
- package/skills/product-grid-scene-planner/references/grid-output-naming-rules.md +52 -0
- package/skills/product-hero-scene-planner/EVAL.md +33 -0
- package/skills/product-hero-scene-planner/SKILL.md +227 -0
- package/skills/product-hero-scene-planner/contract.json +228 -0
- package/skills/product-hero-scene-planner/references/clarification-patterns.md +24 -0
- package/skills/product-hero-scene-planner/references/cyberpunk-shoe-example.md +28 -0
- package/skills/product-hero-scene-planner/references/product-hero-playbooks.md +22 -0
- package/skills/product-hero-scene-planner/references/scene-plan-schema.md +35 -0
- package/skills/r3f-component-plan/EVAL.md +43 -0
- package/skills/r3f-component-plan/SKILL.md +290 -0
- package/skills/r3f-component-plan/contract.json +171 -0
- package/skills/r3f-component-plan/references/component-shape-patterns.md +54 -0
- package/skills/r3f-component-plan/references/suspense-placement-rules.md +50 -0
- package/skills/r3f-component-plan/references/usegltf-caching-rules.md +53 -0
- package/skills/recipe-fit-assessor/EVAL.md +28 -0
- package/skills/recipe-fit-assessor/SKILL.md +266 -0
- package/skills/recipe-fit-assessor/contract.json +220 -0
- package/skills/recipe-fit-assessor/references/recipe-catalog.md +30 -0
- package/skills/recipe-fit-assessor/references/scope-gap-rules.md +27 -0
- package/skills/recipe-fit-assessor/references/workflow-recommendation-template.md +34 -0
- package/skills/render-export-evidence/EVAL.md +86 -0
- package/skills/render-export-evidence/SKILL.md +339 -0
- package/skills/render-export-evidence/contract.json +206 -0
- package/skills/render-export-evidence/references/attempted-vs-failed-rubric.md +75 -0
- package/skills/render-export-evidence/references/evidence-record-templates.md +143 -0
- package/skills/render-export-evidence/references/truth-label-decision-tree.md +57 -0
- package/skills/resolution-aspect-decision/EVAL.md +26 -0
- package/skills/resolution-aspect-decision/SKILL.md +246 -0
- package/skills/resolution-aspect-decision/contract.json +160 -0
- package/skills/resolution-aspect-decision/references/aspect-defaults.md +41 -0
- package/skills/resolution-aspect-decision/references/print-vs-screen-rules.md +58 -0
- package/skills/resolution-aspect-decision/references/resolution-defaults.md +64 -0
- package/skills/runtime-attempt-report/EVAL.md +26 -0
- package/skills/runtime-attempt-report/SKILL.md +268 -0
- package/skills/runtime-attempt-report/contract.json +176 -0
- package/skills/runtime-attempt-report/references/attempt-record-template.md +49 -0
- package/skills/runtime-attempt-report/references/triage-next-steps.md +15 -0
- package/skills/runtime-attempt-report/references/truth-label-blocks.md +27 -0
- package/skills/runtime-path-picker/EVAL.md +26 -0
- package/skills/runtime-path-picker/SKILL.md +268 -0
- package/skills/runtime-path-picker/contract.json +191 -0
- package/skills/runtime-path-picker/references/anti-patterns.md +14 -0
- package/skills/runtime-path-picker/references/decision-tree.md +29 -0
- package/skills/runtime-path-picker/references/path-constraints-table.md +18 -0
- package/skills/runtime-readiness/EVAL.md +33 -0
- package/skills/runtime-readiness/SKILL.md +218 -0
- package/skills/runtime-readiness/contract.json +190 -0
- package/skills/runtime-readiness/references/blocker-report-template.md +28 -0
- package/skills/runtime-readiness/references/evidence-examples.md +23 -0
- package/skills/runtime-readiness/references/readiness-matrix.md +46 -0
- package/skills/runtime-setup/EVAL.md +33 -0
- package/skills/runtime-setup/SKILL.md +209 -0
- package/skills/runtime-setup/contract.json +171 -0
- package/skills/runtime-setup/references/runtime-option-decision-tree.md +28 -0
- package/skills/runtime-setup/references/setup-summary-template.md +33 -0
- package/skills/runtime-setup/references/source-confidence-labels.md +23 -0
- package/skills/scene-readiness/EVAL.md +33 -0
- package/skills/scene-readiness/SKILL.md +195 -0
- package/skills/scene-readiness/contract.json +198 -0
- package/skills/scene-readiness/references/blocker-catalog.md +24 -0
- package/skills/scene-readiness/references/not-run-handling.md +22 -0
- package/skills/scene-readiness/references/quality-rubric.md +23 -0
- package/skills/scene-readiness/references/verdict-language.md +22 -0
- package/skills/scope-guard/EVAL.md +33 -0
- package/skills/scope-guard/SKILL.md +222 -0
- package/skills/scope-guard/contract.json +171 -0
- package/skills/scope-guard/references/options-language-template.md +51 -0
- package/skills/scope-guard/references/recurring-creep-patterns.md +55 -0
- package/skills/scope-guard/references/scope-addition-classification.md +55 -0
- package/skills/stage-gates/EVAL.md +40 -0
- package/skills/stage-gates/SKILL.md +257 -0
- package/skills/stage-gates/contract.json +490 -0
- package/skills/stage-gates/references/failed-gate-handling.md +42 -0
- package/skills/stage-gates/references/gate-template.md +46 -0
- package/skills/stage-gates/references/stage-decomposition-patterns.md +55 -0
- package/skills/workflow-stage-router/EVAL.md +25 -0
- package/skills/workflow-stage-router/SKILL.md +259 -0
- package/skills/workflow-stage-router/contract.json +150 -0
- package/skills/workflow-stage-router/references/milestone-model.md +20 -0
- package/skills/workflow-stage-router/references/routing-decision-tree.md +32 -0
- package/skills/workflow-stage-router/references/stage-handoff-template.md +37 -0
- package/skills.sh.json +102 -0
|
@@ -0,0 +1,248 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: asset-fallback-strategy
|
|
3
|
+
description: Provide a fallback strategy when an asset is unavailable, over-budget, license-blocked, or style-incompatible — without halting the recipe.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# asset-fallback-strategy
|
|
7
|
+
|
|
8
|
+
## Purpose
|
|
9
|
+
When `asset-license-checker`, `asset-style-check`, or `mobile-glb-budget` blocks an asset (or an asset is unavailable), this skill plans 2-3 actionable fallback options (replace / re-source / procedural / generative / drop-with-caveat) ordered by speed so the recipe can proceed. Any chosen replacement must re-pass `asset-license-checker` and `asset-style-check` (plus `mobile-glb-budget` when budget applies).
|
|
10
|
+
|
|
11
|
+
## Quick start
|
|
12
|
+
- read the failed asset + blocking reason
|
|
13
|
+
- propose 2-3 fallback options ordered by speed-to-implement (always including `drop-with-caveat`)
|
|
14
|
+
- score each option on time, brief-match, and license
|
|
15
|
+
- pick one only with explicit user agreement
|
|
16
|
+
- update the asset list and route any replacement back through `asset-license-checker` and `asset-style-check` (and `mobile-glb-budget` if budget-constrained)
|
|
17
|
+
|
|
18
|
+
## When to use
|
|
19
|
+
- after a checker fails an asset
|
|
20
|
+
- when an asset cannot be acquired in time
|
|
21
|
+
- when budget excludes the originally-planned asset
|
|
22
|
+
- when license blocks an asset
|
|
23
|
+
|
|
24
|
+
## When not to use
|
|
25
|
+
<!-- blendops:generated:start exclusions -->
|
|
26
|
+
- when no asset has failed (nothing to fall back to) → use `../asset-license-checker/SKILL.md` (nothing to fall back to)
|
|
27
|
+
- pure exploration (no concrete asset list) → use `../asset-discovery/SKILL.md` (no concrete asset list)
|
|
28
|
+
- when the user wants to wait for the original asset → use `../product-hero-scene-planner/SKILL.md` (Delegates out-of-scope requests to product-hero-scene-planner)
|
|
29
|
+
<!-- blendops:generated:end exclusions -->
|
|
30
|
+
|
|
31
|
+
## Trigger phrases
|
|
32
|
+
<!-- blendops:generated:start triggers -->
|
|
33
|
+
- "what if we can't get this asset"
|
|
34
|
+
- "fallback for the model"
|
|
35
|
+
- "the license blocks us"
|
|
36
|
+
- "scaled-down asset"
|
|
37
|
+
<!-- blendops:generated:end triggers -->
|
|
38
|
+
|
|
39
|
+
## Prerequisites / readiness
|
|
40
|
+
- failed asset + reason known
|
|
41
|
+
- recipe brief known (informs alternative selection)
|
|
42
|
+
|
|
43
|
+
## Input schema
|
|
44
|
+
|
|
45
|
+
### Required inputs
|
|
46
|
+
|
|
47
|
+
| Input | Why it is required |
|
|
48
|
+
|---|---|
|
|
49
|
+
| Failed asset + reason | Drives fallback search |
|
|
50
|
+
| Recipe brief | Alternative must satisfy brief |
|
|
51
|
+
| Time / budget remaining | Affects feasibility of options |
|
|
52
|
+
|
|
53
|
+
### Optional inputs
|
|
54
|
+
|
|
55
|
+
| Input | Use |
|
|
56
|
+
|---|---|
|
|
57
|
+
| Existing internal asset library | Source of fast fallbacks |
|
|
58
|
+
| Generative tool access (procedural / AI) | Adds option types |
|
|
59
|
+
|
|
60
|
+
### Assumptions to confirm
|
|
61
|
+
- The user accepts that a fallback is needed (vs waiting).
|
|
62
|
+
- "Drop with caveat" is a valid option even if not preferred.
|
|
63
|
+
|
|
64
|
+
## Output schema
|
|
65
|
+
|
|
66
|
+
### Primary output
|
|
67
|
+
A fallback option table: option (`replace` / `re-source` / `procedural` / `generative` / `drop-with-caveat`), source / method, time-to-implement, brief-match, license, and recommendation.
|
|
68
|
+
|
|
69
|
+
### Secondary output
|
|
70
|
+
- updated asset list reflecting the user-approved fallback
|
|
71
|
+
- mandatory re-check routing for replacements (`asset-license-checker`, `asset-style-check`, and `mobile-glb-budget`)
|
|
72
|
+
- caveat lines if `drop-with-caveat` is chosen
|
|
73
|
+
- evidence label
|
|
74
|
+
|
|
75
|
+
### Evidence / caveat output
|
|
76
|
+
|
|
77
|
+
```txt
|
|
78
|
+
Runtime status: Not Run | Attempted | Produced | Verified | Failed
|
|
79
|
+
Artifact status: Not Produced | Produced | Verified | Failed (default: Not Produced)
|
|
80
|
+
Rule: downgrade-only, never upgrade
|
|
81
|
+
Evidence used: <links, paths, logs, or "none">
|
|
82
|
+
Limitations: <known gaps>
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
## Required laws
|
|
86
|
+
- `../../laws/evidence-before-done.md`
|
|
87
|
+
- `../../laws/non-blender-user-language.md`
|
|
88
|
+
- `../../laws/no-arbitrary-python-interface.md`
|
|
89
|
+
- `../../laws/official-runtime-only.md`
|
|
90
|
+
|
|
91
|
+
## Official runtime boundary
|
|
92
|
+
|
|
93
|
+
Process and planning skill only — never acquires, generates, or edits assets itself. Outputs a fallback plan and routes execution or re-verification to dedicated skills.
|
|
94
|
+
|
|
95
|
+
## Operating procedure
|
|
96
|
+
|
|
97
|
+
1. Read failed asset + blocking reason.
|
|
98
|
+
2. Read brief style + budget context.
|
|
99
|
+
3. Propose 2-3 fallback options ordered by speed-to-implement (see `references/fallback-option-types.md`), always including `drop-with-caveat`.
|
|
100
|
+
4. Score each option on time, brief-match, and license.
|
|
101
|
+
5. Recommend one option and pause for explicit user agreement.
|
|
102
|
+
6. Once agreed, update the asset list and route the replacement back into the check chain (`asset-license-checker`, `asset-style-check`, and `mobile-glb-budget`), or escalate to `scope-guard` / `blender-recipe-decomposer` if no viable fallback exists.
|
|
103
|
+
|
|
104
|
+
## Decision tree
|
|
105
|
+
|
|
106
|
+
```txt
|
|
107
|
+
Failed by license?
|
|
108
|
+
→ (1) Replace from internal library (`asset-library-plan`)
|
|
109
|
+
→ (2) Re-source compliant alternative (`asset-discovery`)
|
|
110
|
+
→ (3) Drop with caveat
|
|
111
|
+
Failed by budget (size/poly)?
|
|
112
|
+
→ (1) Replace with lighter stand-in from internal library (`asset-library-plan`)
|
|
113
|
+
→ (2) Plan procedural / generative alternative
|
|
114
|
+
→ (3) Drop with caveat
|
|
115
|
+
Failed by style?
|
|
116
|
+
→ (1) Re-source style-aligned alternative (`asset-discovery`)
|
|
117
|
+
→ (2) Plan procedural / generative alternative matching brief
|
|
118
|
+
→ (3) Drop with caveat
|
|
119
|
+
Failed by unavailability?
|
|
120
|
+
→ (1) Replace from internal library (`asset-library-plan`)
|
|
121
|
+
→ (2) Plan procedural / generative alternative
|
|
122
|
+
→ (3) Drop with caveat
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
## Playbooks
|
|
126
|
+
|
|
127
|
+
### Playbook A: Hero shoe model unavailable
|
|
128
|
+
|
|
129
|
+
Options (ordered by speed): (1) Replace with stand-in mesh from internal library via `asset-library-plan` (fastest, lower brief-match). (2) Plan a procedural or generative alternative (medium speed, medium brief-match). (3) Drop with caveat: omit the hero shoe and adjust deliverables (fastest fallback exit, requires caveat note). Any replacement must re-pass `asset-license-checker` and `asset-style-check`.
|
|
130
|
+
|
|
131
|
+
### Playbook B: HDRI blocked by license
|
|
132
|
+
|
|
133
|
+
Options (ordered by speed): (1) Drop with caveat: omit HDRI and rely on planned scene lighting (caveat: ambient reflection changes). (2) Re-source a license-clear HDRI via `asset-discovery` (fast, high brief-match). (3) Plan a procedural sky alternative (medium speed, medium brief-match). Any replacement must re-pass `asset-license-checker` and `asset-style-check`.
|
|
134
|
+
|
|
135
|
+
### Playbook C: Texture over-budget
|
|
136
|
+
|
|
137
|
+
Options (ordered by speed): (1) Drop with caveat: omit high-cost texture variation and use a simpler material plan (caveat: reduced surface detail). (2) Replace with a lighter asset from the internal library via `asset-library-plan` (fast, medium brief-match). (3) Re-source a budget-compliant texture via `asset-discovery` (medium speed, high brief-match). Any replacement must re-pass `asset-license-checker`, `asset-style-check`, and `mobile-glb-budget`.
|
|
138
|
+
|
|
139
|
+
## Mode handling
|
|
140
|
+
|
|
141
|
+
### Text-only mode
|
|
142
|
+
|
|
143
|
+
Output the fallback strategy table and wait for user agreement.
|
|
144
|
+
|
|
145
|
+
### Runtime-ready mode
|
|
146
|
+
|
|
147
|
+
After user agreement on a fallback, hand off to `asset-discovery` (re-source) or `asset-library-plan` (internal library), then require re-verification through `asset-license-checker`, `asset-style-check`, and `mobile-glb-budget`.
|
|
148
|
+
|
|
149
|
+
### Blocked runtime mode
|
|
150
|
+
|
|
151
|
+
Strategy is recorded as a forward-plan; no immediate handoff execution.
|
|
152
|
+
|
|
153
|
+
## Validation checklist
|
|
154
|
+
|
|
155
|
+
* [ ] Failed asset + blocking reason explicitly stated
|
|
156
|
+
* [ ] 2-3 options ordered by speed, scored on time, brief-match, and license
|
|
157
|
+
* [ ] `drop-with-caveat` option included
|
|
158
|
+
* [ ] Recommendation explicit and user agreement required before proceeding
|
|
159
|
+
* [ ] Updated asset list reflected after agreement
|
|
160
|
+
* [ ] Picked replacement routed back to `asset-license-checker` and `asset-style-check` (plus `mobile-glb-budget` when applicable)
|
|
161
|
+
* [ ] Caveat lines documented if `drop-with-caveat` is chosen
|
|
162
|
+
|
|
163
|
+
## Pass / Warn / Fail rubric
|
|
164
|
+
|
|
165
|
+
| Verdict | Criteria |
|
|
166
|
+
| --- | --- |
|
|
167
|
+
| Pass | 2-3 speed-ordered options (including `drop-with-caveat`) scored on time/brief-match/license + explicit recommendation + user agreement + updated list + re-check routing to `asset-license-checker` and `asset-style-check`. |
|
|
168
|
+
| Warn | Options and `drop-with-caveat` present, but recommendation or re-check routing note is soft. |
|
|
169
|
+
| Fail | Missing `drop-with-caveat`; silent substitution without user agreement; skips replacement re-checks; or attempts to acquire, generate, or edit assets directly. |
|
|
170
|
+
|
|
171
|
+
## Failure handling
|
|
172
|
+
|
|
173
|
+
* No viable fallback exists → hand off to `scope-guard` for scope reduction or `blender-recipe-decomposer` to split the recipe.
|
|
174
|
+
* Picked replacement fails `asset-license-checker`, `asset-style-check`, or `mobile-glb-budget` → repeat the fallback planning cycle or escalate to scope reduction.
|
|
175
|
+
* User refuses all options → document refusal and flag as recipe-blocker.
|
|
176
|
+
|
|
177
|
+
## Troubleshooting
|
|
178
|
+
|
|
179
|
+
| Problem | Response |
|
|
180
|
+
| --- | --- |
|
|
181
|
+
| Fallback doesn't match brief | Propose scope reduction via `scope-guard` or select another fallback; do not silently lower quality. |
|
|
182
|
+
| Procedural option requires unavailable capability | Cross out procedural option; rely on `replace`, `re-source`, or `drop-with-caveat`. |
|
|
183
|
+
| Replacement or generative candidate has unclear license or style fit | Route through `asset-license-checker` and `asset-style-check` before accepting into the recipe. |
|
|
184
|
+
|
|
185
|
+
## Best practices
|
|
186
|
+
- Always offer at least 2 options.
|
|
187
|
+
- Always show a "drop with caveat" option (even if last choice).
|
|
188
|
+
- Time-to-implement is decisive; brief match is necessary; license confidence is non-negotiable.
|
|
189
|
+
- Keep this skill narrow.
|
|
190
|
+
|
|
191
|
+
## Good examples
|
|
192
|
+
|
|
193
|
+
* "Failed: `hero-shoe-mesh.glb` (blocked by `asset-license-checker`). Options (ordered by speed): (1) Drop with caveat — omit hero shoe mesh and note missing centerpiece (time: immediate, brief-match: low, license: clear). (2) Replace from internal library via `asset-library-plan` — generic shoe stand-in (time: fast, brief-match: medium, license: pre-cleared). (3) Re-source compliant commercial mesh via `asset-discovery` (time: slower, brief-match: high, license: requires verification). Recommended: (3) for brief fidelity. User agreement required; once picked, replacement must re-pass `asset-license-checker` and `asset-style-check`."
|
|
194
|
+
|
|
195
|
+
## Bad examples
|
|
196
|
+
- "We'll figure it out." — no options listed.
|
|
197
|
+
|
|
198
|
+
## User-facing response template
|
|
199
|
+
|
|
200
|
+
```txt
|
|
201
|
+
Failed asset: <name>
|
|
202
|
+
Reason: <license / budget / style / unavailable>
|
|
203
|
+
|
|
204
|
+
| Option | Type (replace / re-source / procedural / generative / drop-with-caveat) | Source / method | Time | Brief-match | License | Recommendation |
|
|
205
|
+
|---|---|---|---|---|---|---|
|
|
206
|
+
|
|
207
|
+
Recommendation: <option>
|
|
208
|
+
Decision needed: User agreement required before continuing.
|
|
209
|
+
Caveat lines (if drop-with-caveat): <list>
|
|
210
|
+
Updated asset list: <link or note>
|
|
211
|
+
Next re-checks (if replacement picked): asset-license-checker, asset-style-check, mobile-glb-budget (if budget applies)
|
|
212
|
+
Escalation (if no viable fallback): scope-guard or blender-recipe-decomposer
|
|
213
|
+
Runtime status: Not Run | Attempted | Produced | Verified | Failed
|
|
214
|
+
Artifact status: Not Produced | Produced | Verified | Failed (default: Not Produced; downgrade-only)
|
|
215
|
+
Evidence used: <links, paths, logs, or "none">
|
|
216
|
+
Limitations: <known gaps>
|
|
217
|
+
```
|
|
218
|
+
|
|
219
|
+
## Anti-patterns
|
|
220
|
+
|
|
221
|
+
* Dropping an asset without an explicit caveat ("just drop it").
|
|
222
|
+
* Omitting `drop-with-caveat` from the proposed option set.
|
|
223
|
+
* Silently substituting an asset without user agreement.
|
|
224
|
+
* Inventing fallback sources or acquiring, generating, or editing assets directly.
|
|
225
|
+
* Skipping `asset-license-checker`, `asset-style-check`, or `mobile-glb-budget` on the chosen replacement.
|
|
226
|
+
|
|
227
|
+
## Cross-skill handoff
|
|
228
|
+
<!-- blendops:generated:start handoffs -->
|
|
229
|
+
- [upstream_reference] Re-source external asset → `../asset-discovery/SKILL.md`
|
|
230
|
+
- [progression] Internal library lookup → `../asset-library-plan/SKILL.md`
|
|
231
|
+
- [fallback] License re-check on replacement → `../asset-license-checker/SKILL.md`
|
|
232
|
+
- [fallback] Style re-check on replacement → `../asset-style-check/SKILL.md`
|
|
233
|
+
- [progression] Budget re-check on replacement → `../mobile-glb-budget/SKILL.md`
|
|
234
|
+
- [fallback] Scope reduction when no viable fallback exists → `../scope-guard/SKILL.md`
|
|
235
|
+
- [fallback] Recipe split when no viable fallback exists → `../blender-recipe-decomposer/SKILL.md`
|
|
236
|
+
<!-- blendops:generated:end handoffs -->
|
|
237
|
+
|
|
238
|
+
## Non-goals
|
|
239
|
+
|
|
240
|
+
* Acquire, generate, or edit assets itself.
|
|
241
|
+
* Run Blender or execute Python.
|
|
242
|
+
* Perform license, style, or performance budget checks itself.
|
|
243
|
+
|
|
244
|
+
## References
|
|
245
|
+
- `references/fallback-option-types.md`
|
|
246
|
+
- `references/scoring-rubric.md`
|
|
247
|
+
- `references/drop-with-caveat-rules.md`
|
|
248
|
+
- `../../docs/skill-system.md`
|
|
@@ -0,0 +1,190 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "../../schemas/skill-contract.schema.json",
|
|
3
|
+
"id": "asset-fallback-strategy",
|
|
4
|
+
"version": "1.0.0",
|
|
5
|
+
"category": "asset-and-sourcing",
|
|
6
|
+
"role": "blocked-asset-replacement-planner",
|
|
7
|
+
"purpose": "Provide a fallback strategy when an asset is unavailable, over-budget, license-blocked, or style-incompatible — without halting the recipe.",
|
|
8
|
+
"capabilityTier": "L0",
|
|
9
|
+
"triggers": [
|
|
10
|
+
"what if we can't get this asset",
|
|
11
|
+
"fallback for the model",
|
|
12
|
+
"the license blocks us",
|
|
13
|
+
"scaled-down asset"
|
|
14
|
+
],
|
|
15
|
+
"exclusions": [
|
|
16
|
+
{
|
|
17
|
+
"condition": "when no asset has failed (nothing to fall back to)",
|
|
18
|
+
"delegateTo": "asset-license-checker",
|
|
19
|
+
"reason": "nothing to fall back to"
|
|
20
|
+
},
|
|
21
|
+
{
|
|
22
|
+
"condition": "pure exploration (no concrete asset list)",
|
|
23
|
+
"delegateTo": "asset-discovery",
|
|
24
|
+
"reason": "no concrete asset list"
|
|
25
|
+
},
|
|
26
|
+
{
|
|
27
|
+
"condition": "when the user wants to wait for the original asset",
|
|
28
|
+
"delegateTo": "product-hero-scene-planner",
|
|
29
|
+
"reason": "Delegates out-of-scope requests to product-hero-scene-planner"
|
|
30
|
+
}
|
|
31
|
+
],
|
|
32
|
+
"inputs": {
|
|
33
|
+
"required": [
|
|
34
|
+
{
|
|
35
|
+
"name": "blocked_asset_entry",
|
|
36
|
+
"type": "object",
|
|
37
|
+
"description": "Asset blocked by missing source, incompatible license, style mismatch, or budget breach"
|
|
38
|
+
},
|
|
39
|
+
{
|
|
40
|
+
"name": "blocking_reason",
|
|
41
|
+
"type": "enum",
|
|
42
|
+
"description": "Primary block reason (license_rejected, source_unavailable, style_mismatch, budget_exceeded)"
|
|
43
|
+
}
|
|
44
|
+
],
|
|
45
|
+
"optional": [
|
|
46
|
+
{
|
|
47
|
+
"name": "local_library_manifest",
|
|
48
|
+
"type": "object",
|
|
49
|
+
"description": "Optional inventory of cleared local assets from asset-library-plan"
|
|
50
|
+
}
|
|
51
|
+
]
|
|
52
|
+
},
|
|
53
|
+
"outputs": {
|
|
54
|
+
"primary": [
|
|
55
|
+
"ranked_fallback_options",
|
|
56
|
+
"selected_replacement_plan",
|
|
57
|
+
"revalidation_routing_hooks"
|
|
58
|
+
],
|
|
59
|
+
"truthStatePolicy": {
|
|
60
|
+
"runtimeDefault": "Not Run",
|
|
61
|
+
"artifactDefault": "Not Produced",
|
|
62
|
+
"mutationRule": "downgrade_only"
|
|
63
|
+
}
|
|
64
|
+
},
|
|
65
|
+
"handoffs": [
|
|
66
|
+
{
|
|
67
|
+
"target": "asset-discovery",
|
|
68
|
+
"type": "upstream_reference",
|
|
69
|
+
"label": "Re-source external asset",
|
|
70
|
+
"when": {
|
|
71
|
+
"all": [
|
|
72
|
+
{
|
|
73
|
+
"field": "brief.locked",
|
|
74
|
+
"operator": "equals",
|
|
75
|
+
"value": true
|
|
76
|
+
},
|
|
77
|
+
{
|
|
78
|
+
"field": "assets.discoveryComplete",
|
|
79
|
+
"operator": "equals",
|
|
80
|
+
"value": false
|
|
81
|
+
}
|
|
82
|
+
]
|
|
83
|
+
}
|
|
84
|
+
},
|
|
85
|
+
{
|
|
86
|
+
"target": "asset-library-plan",
|
|
87
|
+
"type": "progression",
|
|
88
|
+
"label": "Internal library lookup",
|
|
89
|
+
"when": {
|
|
90
|
+
"all": [
|
|
91
|
+
{
|
|
92
|
+
"field": "assets.discoveryComplete",
|
|
93
|
+
"operator": "equals",
|
|
94
|
+
"value": true
|
|
95
|
+
},
|
|
96
|
+
{
|
|
97
|
+
"field": "stage.current",
|
|
98
|
+
"operator": "equals",
|
|
99
|
+
"value": "library_organization"
|
|
100
|
+
}
|
|
101
|
+
]
|
|
102
|
+
}
|
|
103
|
+
},
|
|
104
|
+
{
|
|
105
|
+
"target": "asset-license-checker",
|
|
106
|
+
"type": "fallback",
|
|
107
|
+
"label": "License re-check on replacement",
|
|
108
|
+
"when": {
|
|
109
|
+
"all": [
|
|
110
|
+
{
|
|
111
|
+
"field": "assets.externalUsed",
|
|
112
|
+
"operator": "equals",
|
|
113
|
+
"value": true
|
|
114
|
+
},
|
|
115
|
+
{
|
|
116
|
+
"field": "assets.licenseCleared",
|
|
117
|
+
"operator": "equals",
|
|
118
|
+
"value": false
|
|
119
|
+
}
|
|
120
|
+
]
|
|
121
|
+
}
|
|
122
|
+
},
|
|
123
|
+
{
|
|
124
|
+
"target": "asset-style-check",
|
|
125
|
+
"type": "fallback",
|
|
126
|
+
"label": "Style re-check on replacement",
|
|
127
|
+
"when": {
|
|
128
|
+
"all": [
|
|
129
|
+
{
|
|
130
|
+
"field": "assets.licenseCleared",
|
|
131
|
+
"operator": "equals",
|
|
132
|
+
"value": true
|
|
133
|
+
},
|
|
134
|
+
{
|
|
135
|
+
"field": "stage.current",
|
|
136
|
+
"operator": "equals",
|
|
137
|
+
"value": "style_check"
|
|
138
|
+
}
|
|
139
|
+
]
|
|
140
|
+
}
|
|
141
|
+
},
|
|
142
|
+
{
|
|
143
|
+
"target": "mobile-glb-budget",
|
|
144
|
+
"type": "progression",
|
|
145
|
+
"label": "Budget re-check on replacement",
|
|
146
|
+
"when": {
|
|
147
|
+
"all": [
|
|
148
|
+
{
|
|
149
|
+
"field": "artifact.type",
|
|
150
|
+
"operator": "equals",
|
|
151
|
+
"value": "glb"
|
|
152
|
+
},
|
|
153
|
+
{
|
|
154
|
+
"field": "budget.pinned",
|
|
155
|
+
"operator": "equals",
|
|
156
|
+
"value": false
|
|
157
|
+
}
|
|
158
|
+
]
|
|
159
|
+
}
|
|
160
|
+
},
|
|
161
|
+
{
|
|
162
|
+
"target": "scope-guard",
|
|
163
|
+
"type": "fallback",
|
|
164
|
+
"label": "Scope reduction when no viable fallback exists",
|
|
165
|
+
"when": {
|
|
166
|
+
"all": [
|
|
167
|
+
{
|
|
168
|
+
"field": "scope.driftDetected",
|
|
169
|
+
"operator": "equals",
|
|
170
|
+
"value": true
|
|
171
|
+
}
|
|
172
|
+
]
|
|
173
|
+
}
|
|
174
|
+
},
|
|
175
|
+
{
|
|
176
|
+
"target": "blender-recipe-decomposer",
|
|
177
|
+
"type": "fallback",
|
|
178
|
+
"label": "Recipe split when no viable fallback exists",
|
|
179
|
+
"when": {
|
|
180
|
+
"all": [
|
|
181
|
+
{
|
|
182
|
+
"field": "fit.multiDeliverableDetected",
|
|
183
|
+
"operator": "equals",
|
|
184
|
+
"value": true
|
|
185
|
+
}
|
|
186
|
+
]
|
|
187
|
+
}
|
|
188
|
+
}
|
|
189
|
+
]
|
|
190
|
+
}
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
# Drop-with-caveat rules
|
|
2
|
+
|
|
3
|
+
When dropping an asset, document the caveat; do not silently dilute the deliverable.
|
|
4
|
+
|
|
5
|
+
## What to record
|
|
6
|
+
|
|
7
|
+
- Original asset that was dropped
|
|
8
|
+
- Reason it was dropped
|
|
9
|
+
- Visual / functional change in the deliverable
|
|
10
|
+
- Whether the brief still matches after drop
|
|
11
|
+
- Updated stop condition (if changed)
|
|
12
|
+
|
|
13
|
+
## Example caveat
|
|
14
|
+
|
|
15
|
+
"Dropped: hero-shoe-mesh.glb (license-blocked, no fallback in time). Visual change: hero render now uses procedural-only abstraction instead of recognizable shoe. Brief match: lower (style match acceptable; shoe-specific recognition lost). User accepted change on <date>. Updated stop condition: 'render shows abstract product silhouette instead of literal shoe'."
|
|
16
|
+
|
|
17
|
+
## When NOT to drop
|
|
18
|
+
|
|
19
|
+
- The brief explicitly requires the asset (e.g., "render of THE shoe").
|
|
20
|
+
- Dropping breaks the recipe's purpose.
|
|
21
|
+
- Stakeholder expects the original.
|
|
22
|
+
|
|
23
|
+
In these cases, escalate scope reduction (drop the deliverable) or push the deadline.
|
|
24
|
+
|
|
25
|
+
## When drop is actually fine
|
|
26
|
+
|
|
27
|
+
- The asset is a "nice-to-have" not a "must-have" in the brief.
|
|
28
|
+
- An equivalent alternative is already accepted.
|
|
29
|
+
- The visual change is small.
|
|
30
|
+
|
|
31
|
+
## Recording in evidence
|
|
32
|
+
|
|
33
|
+
Drop-with-caveat events are part of the evidence trail. Append to `docs/evals/...` if a runtime evidence file is being maintained, or to the recipe handoff.
|
|
34
|
+
|
|
35
|
+
## Related skill
|
|
36
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
# Fallback option types
|
|
2
|
+
|
|
3
|
+
## Type A: Replace from open-license source
|
|
4
|
+
|
|
5
|
+
Find a CC0 / MIT / similar-permission alternative.
|
|
6
|
+
|
|
7
|
+
**Pros**: cheapest, no legal friction.
|
|
8
|
+
**Cons**: brief match may be approximate.
|
|
9
|
+
|
|
10
|
+
Sources: polyhaven.com, ambientcg.com, free Sketchfab CC0 tag, BlendSwap CC0 tag.
|
|
11
|
+
|
|
12
|
+
## Type B: Replace from paid licensed source
|
|
13
|
+
|
|
14
|
+
Buy a commercial license that fits the brief.
|
|
15
|
+
|
|
16
|
+
**Pros**: exact brief match; clear license.
|
|
17
|
+
**Cons**: cost; takes time to source.
|
|
18
|
+
|
|
19
|
+
Sources: TurboSquid, CGTrader, Sketchfab Store, brand-specific stock.
|
|
20
|
+
|
|
21
|
+
## Type C: Procedural / Geometry Nodes / shader-based
|
|
22
|
+
|
|
23
|
+
Build the asset programmatically inside Blender.
|
|
24
|
+
|
|
25
|
+
**Pros**: free, brand-aligned, fully controlled.
|
|
26
|
+
**Cons**: requires modeling skill; takes time.
|
|
27
|
+
|
|
28
|
+
Best for: textures (procedural noise), repeating geometry (Geometry Nodes), simple shapes.
|
|
29
|
+
|
|
30
|
+
## Type D: Generative (AI / photogrammetry service)
|
|
31
|
+
|
|
32
|
+
Use a service to generate / capture the asset.
|
|
33
|
+
|
|
34
|
+
**Pros**: novel; can match brief precisely.
|
|
35
|
+
**Cons**: license terms vary; quality varies; time varies.
|
|
36
|
+
|
|
37
|
+
Sources: Meshy, Luma AI, Polycam, Photogrammetry pipelines.
|
|
38
|
+
|
|
39
|
+
**Always run the AI-generated output through `asset-license-checker`** to verify the tool's commercial-use terms.
|
|
40
|
+
|
|
41
|
+
## Type E: Drop with caveat
|
|
42
|
+
|
|
43
|
+
Remove the asset; document the visual change.
|
|
44
|
+
|
|
45
|
+
**Pros**: zero time / cost.
|
|
46
|
+
**Cons**: deliverable changes; brief may be diluted.
|
|
47
|
+
|
|
48
|
+
Use when: deadline-critical, no budget for paid, no time for procedural / generative.
|
|
49
|
+
|
|
50
|
+
## Combination
|
|
51
|
+
|
|
52
|
+
Sometimes the best fallback combines types (e.g., Type A texture + Type C procedural displacement).
|
|
53
|
+
|
|
54
|
+
## Related skill
|
|
55
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
# Scoring rubric for fallback options
|
|
2
|
+
|
|
3
|
+
Score each option on 4 dimensions; recommend the best total.
|
|
4
|
+
|
|
5
|
+
## Dimensions
|
|
6
|
+
|
|
7
|
+
### 1. Time to implement
|
|
8
|
+
|
|
9
|
+
- < 1 hour: 5
|
|
10
|
+
- 1-4 hours: 4
|
|
11
|
+
- 4-8 hours: 3
|
|
12
|
+
- 1-3 days: 2
|
|
13
|
+
- > 3 days: 1
|
|
14
|
+
|
|
15
|
+
### 2. Brief match
|
|
16
|
+
|
|
17
|
+
- Exact match: 5
|
|
18
|
+
- Very close: 4
|
|
19
|
+
- Close (minor caveat): 3
|
|
20
|
+
- Approximate: 2
|
|
21
|
+
- Loose: 1
|
|
22
|
+
|
|
23
|
+
### 3. License confidence
|
|
24
|
+
|
|
25
|
+
- CC0 / MIT / fully cleared: 5
|
|
26
|
+
- CC-BY with clear attribution plan: 4
|
|
27
|
+
- Paid commercial with verified terms: 4
|
|
28
|
+
- Procedurally generated by you: 5
|
|
29
|
+
- Generative AI with clear terms: 3
|
|
30
|
+
- Generative AI with unclear terms: 1
|
|
31
|
+
- Unknown: 1
|
|
32
|
+
|
|
33
|
+
### 4. Quality match (per scene quality bar)
|
|
34
|
+
|
|
35
|
+
- Exceeds bar: 5
|
|
36
|
+
- Meets bar: 4
|
|
37
|
+
- Slightly below bar: 3
|
|
38
|
+
- Notably below: 2
|
|
39
|
+
- Unusable: 1
|
|
40
|
+
|
|
41
|
+
## Aggregation
|
|
42
|
+
|
|
43
|
+
- Sum the 4 scores; max 20.
|
|
44
|
+
- Recommend highest total.
|
|
45
|
+
- Tie-break: prefer lower time + higher license confidence.
|
|
46
|
+
|
|
47
|
+
## Examples
|
|
48
|
+
|
|
49
|
+
Option (1) CC0 from polyhaven: time 5, brief 3, license 5, quality 4 → 17.
|
|
50
|
+
Option (2) Paid $99 commercial: time 3, brief 5, license 4, quality 5 → 17.
|
|
51
|
+
Option (3) Procedural Geometry Nodes: time 1, brief 4, license 5, quality 4 → 14.
|
|
52
|
+
|
|
53
|
+
Tied (1) and (2) — pick (2) for brief fidelity if the quality bar matters most.
|
|
54
|
+
|
|
55
|
+
## When score is low
|
|
56
|
+
|
|
57
|
+
- Highest total < 12 → no good fallback exists.
|
|
58
|
+
- Recommend recipe scope reduction or wait-for-original.
|
|
59
|
+
|
|
60
|
+
## Related skill
|
|
61
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
# EVAL — asset-library-plan
|
|
2
|
+
|
|
3
|
+
## Text-only eval prompt
|
|
4
|
+
Apply asset-library-plan for a medium repo (~150 assets, mixed models / textures / HDRIs, git + LFS).
|
|
5
|
+
|
|
6
|
+
## Expected behavior
|
|
7
|
+
- folder tree pinned
|
|
8
|
+
- naming convention with examples
|
|
9
|
+
- metadata schema (fields)
|
|
10
|
+
- VCS rules (LFS threshold)
|
|
11
|
+
- license tracking strategy
|
|
12
|
+
- review process
|
|
13
|
+
- migration steps if relevant
|
|
14
|
+
|
|
15
|
+
## Pass / Warn / Fail criteria
|
|
16
|
+
- Pass: all sections pinned + naming + license tracking
|
|
17
|
+
- Warn: metadata schema partial
|
|
18
|
+
- Fail: "just dump in a folder", no naming, no license tracking
|
|
19
|
+
|
|
20
|
+
## Sample passing response outline
|
|
21
|
+
- Library size + VCS header
|
|
22
|
+
- Tree
|
|
23
|
+
- Naming + metadata + VCS + license + review sections
|
|
24
|
+
- Migration steps
|
|
25
|
+
|
|
26
|
+
## Sample failing response outline
|
|
27
|
+
- "Use a Drive folder"
|
|
28
|
+
- No naming or metadata
|