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,291 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "../../schemas/skill-contract.schema.json",
|
|
3
|
+
"id": "asset-discovery",
|
|
4
|
+
"version": "1.0.0",
|
|
5
|
+
"category": "asset-and-sourcing",
|
|
6
|
+
"role": "asset-strategy-and-source-planner",
|
|
7
|
+
"purpose": "Plan the asset acquisition strategy (procedural, library, generative, photogrammetry) for a Blender scene without installing or executing. Use after the brief, before scene planning.",
|
|
8
|
+
"capabilityTier": "L0",
|
|
9
|
+
"triggers": [
|
|
10
|
+
"what assets do we need",
|
|
11
|
+
"where do the models come from",
|
|
12
|
+
"asset plan before scene planning",
|
|
13
|
+
"do we generate or import",
|
|
14
|
+
"surface asset license risks before planning"
|
|
15
|
+
],
|
|
16
|
+
"exclusions": [
|
|
17
|
+
{
|
|
18
|
+
"condition": "the user supplied all assets in the brief (skip; route directly to planner)",
|
|
19
|
+
"delegateTo": "intent-to-3d-brief-writer",
|
|
20
|
+
"reason": "skip; route directly to planner"
|
|
21
|
+
},
|
|
22
|
+
{
|
|
23
|
+
"condition": "runtime is already executing and assets are already in the scene",
|
|
24
|
+
"delegateTo": "product-hero-scene-planner",
|
|
25
|
+
"reason": "route to evidence skill"
|
|
26
|
+
},
|
|
27
|
+
{
|
|
28
|
+
"condition": "the request is iteration on an existing scene (assets are already chosen)",
|
|
29
|
+
"delegateTo": "render-export-evidence",
|
|
30
|
+
"reason": "assets are already chosen"
|
|
31
|
+
}
|
|
32
|
+
],
|
|
33
|
+
"inputs": {
|
|
34
|
+
"required": [
|
|
35
|
+
{
|
|
36
|
+
"name": "locked_3d_brief",
|
|
37
|
+
"type": "object",
|
|
38
|
+
"description": "Structured 3D brief listing required hero subject, props, environment, and materials"
|
|
39
|
+
},
|
|
40
|
+
{
|
|
41
|
+
"name": "target_delivery_channel",
|
|
42
|
+
"type": "string",
|
|
43
|
+
"description": "Target output surface driving geometry and texture fidelity requirements"
|
|
44
|
+
}
|
|
45
|
+
],
|
|
46
|
+
"optional": [
|
|
47
|
+
{
|
|
48
|
+
"name": "existing_user_assets",
|
|
49
|
+
"type": "array",
|
|
50
|
+
"description": "User-supplied CAD/FBX/OBJ/GLB files or brand texture sets"
|
|
51
|
+
}
|
|
52
|
+
]
|
|
53
|
+
},
|
|
54
|
+
"outputs": {
|
|
55
|
+
"primary": [
|
|
56
|
+
"asset_sourcing_matrix",
|
|
57
|
+
"procedural_vs_external_split",
|
|
58
|
+
"license_and_budget_risk_register"
|
|
59
|
+
],
|
|
60
|
+
"truthStatePolicy": {
|
|
61
|
+
"runtimeDefault": "Not Run",
|
|
62
|
+
"artifactDefault": "Not Produced",
|
|
63
|
+
"mutationRule": "downgrade_only"
|
|
64
|
+
}
|
|
65
|
+
},
|
|
66
|
+
"handoffs": [
|
|
67
|
+
{
|
|
68
|
+
"target": "intent-to-3d-brief-writer",
|
|
69
|
+
"type": "upstream_reference",
|
|
70
|
+
"label": "**Before this skill**",
|
|
71
|
+
"when": {
|
|
72
|
+
"all": [
|
|
73
|
+
{
|
|
74
|
+
"field": "goal.clarity",
|
|
75
|
+
"operator": "equals",
|
|
76
|
+
"value": "clear"
|
|
77
|
+
},
|
|
78
|
+
{
|
|
79
|
+
"field": "brief.locked",
|
|
80
|
+
"operator": "equals",
|
|
81
|
+
"value": false
|
|
82
|
+
}
|
|
83
|
+
]
|
|
84
|
+
}
|
|
85
|
+
},
|
|
86
|
+
{
|
|
87
|
+
"target": "character-portrait",
|
|
88
|
+
"type": "alternative",
|
|
89
|
+
"label": "**Scene planners (primary handoff with brief + asset plan)** (character-portrait)",
|
|
90
|
+
"when": {
|
|
91
|
+
"all": [
|
|
92
|
+
{
|
|
93
|
+
"field": "brief.locked",
|
|
94
|
+
"operator": "equals",
|
|
95
|
+
"value": true
|
|
96
|
+
},
|
|
97
|
+
{
|
|
98
|
+
"field": "recipe.domain",
|
|
99
|
+
"operator": "equals",
|
|
100
|
+
"value": "character_portrait"
|
|
101
|
+
}
|
|
102
|
+
]
|
|
103
|
+
}
|
|
104
|
+
},
|
|
105
|
+
{
|
|
106
|
+
"target": "environment-shot",
|
|
107
|
+
"type": "alternative",
|
|
108
|
+
"label": "**Scene planners (primary handoff with brief + asset plan)** (environment-shot)",
|
|
109
|
+
"when": {
|
|
110
|
+
"all": [
|
|
111
|
+
{
|
|
112
|
+
"field": "brief.locked",
|
|
113
|
+
"operator": "equals",
|
|
114
|
+
"value": true
|
|
115
|
+
},
|
|
116
|
+
{
|
|
117
|
+
"field": "recipe.domain",
|
|
118
|
+
"operator": "equals",
|
|
119
|
+
"value": "environment_shot"
|
|
120
|
+
}
|
|
121
|
+
]
|
|
122
|
+
}
|
|
123
|
+
},
|
|
124
|
+
{
|
|
125
|
+
"target": "interior-scene",
|
|
126
|
+
"type": "alternative",
|
|
127
|
+
"label": "**Scene planners (primary handoff with brief + asset plan)** (interior-scene)",
|
|
128
|
+
"when": {
|
|
129
|
+
"all": [
|
|
130
|
+
{
|
|
131
|
+
"field": "brief.locked",
|
|
132
|
+
"operator": "equals",
|
|
133
|
+
"value": true
|
|
134
|
+
},
|
|
135
|
+
{
|
|
136
|
+
"field": "recipe.domain",
|
|
137
|
+
"operator": "equals",
|
|
138
|
+
"value": "interior_archviz"
|
|
139
|
+
}
|
|
140
|
+
]
|
|
141
|
+
}
|
|
142
|
+
},
|
|
143
|
+
{
|
|
144
|
+
"target": "product-grid-scene-planner",
|
|
145
|
+
"type": "alternative",
|
|
146
|
+
"label": "**Scene planners (primary handoff with brief + asset plan)** (product-grid-scene-planner)",
|
|
147
|
+
"when": {
|
|
148
|
+
"all": [
|
|
149
|
+
{
|
|
150
|
+
"field": "brief.locked",
|
|
151
|
+
"operator": "equals",
|
|
152
|
+
"value": true
|
|
153
|
+
},
|
|
154
|
+
{
|
|
155
|
+
"field": "recipe.domain",
|
|
156
|
+
"operator": "equals",
|
|
157
|
+
"value": "product_grid"
|
|
158
|
+
}
|
|
159
|
+
]
|
|
160
|
+
}
|
|
161
|
+
},
|
|
162
|
+
{
|
|
163
|
+
"target": "product-hero-scene-planner",
|
|
164
|
+
"type": "alternative",
|
|
165
|
+
"label": "**Scene planners (primary handoff with brief + asset plan)** (product-hero-scene-planner)",
|
|
166
|
+
"when": {
|
|
167
|
+
"all": [
|
|
168
|
+
{
|
|
169
|
+
"field": "brief.locked",
|
|
170
|
+
"operator": "equals",
|
|
171
|
+
"value": true
|
|
172
|
+
},
|
|
173
|
+
{
|
|
174
|
+
"field": "recipe.domain",
|
|
175
|
+
"operator": "equals",
|
|
176
|
+
"value": "product_hero"
|
|
177
|
+
}
|
|
178
|
+
]
|
|
179
|
+
}
|
|
180
|
+
},
|
|
181
|
+
{
|
|
182
|
+
"target": "asset-license-checker",
|
|
183
|
+
"type": "progression",
|
|
184
|
+
"label": "**License verdicts**",
|
|
185
|
+
"when": {
|
|
186
|
+
"all": [
|
|
187
|
+
{
|
|
188
|
+
"field": "assets.externalUsed",
|
|
189
|
+
"operator": "equals",
|
|
190
|
+
"value": true
|
|
191
|
+
},
|
|
192
|
+
{
|
|
193
|
+
"field": "assets.licenseCleared",
|
|
194
|
+
"operator": "equals",
|
|
195
|
+
"value": false
|
|
196
|
+
}
|
|
197
|
+
]
|
|
198
|
+
}
|
|
199
|
+
},
|
|
200
|
+
{
|
|
201
|
+
"target": "asset-style-check",
|
|
202
|
+
"type": "progression",
|
|
203
|
+
"label": "**Style re-checks**",
|
|
204
|
+
"when": {
|
|
205
|
+
"all": [
|
|
206
|
+
{
|
|
207
|
+
"field": "assets.licenseCleared",
|
|
208
|
+
"operator": "equals",
|
|
209
|
+
"value": true
|
|
210
|
+
},
|
|
211
|
+
{
|
|
212
|
+
"field": "stage.current",
|
|
213
|
+
"operator": "equals",
|
|
214
|
+
"value": "style_check"
|
|
215
|
+
}
|
|
216
|
+
]
|
|
217
|
+
}
|
|
218
|
+
},
|
|
219
|
+
{
|
|
220
|
+
"target": "mobile-glb-budget",
|
|
221
|
+
"type": "progression",
|
|
222
|
+
"label": "**Budget reconciliation** (mobile-glb-budget)",
|
|
223
|
+
"when": {
|
|
224
|
+
"all": [
|
|
225
|
+
{
|
|
226
|
+
"field": "artifact.type",
|
|
227
|
+
"operator": "equals",
|
|
228
|
+
"value": "glb"
|
|
229
|
+
},
|
|
230
|
+
{
|
|
231
|
+
"field": "budget.pinned",
|
|
232
|
+
"operator": "equals",
|
|
233
|
+
"value": false
|
|
234
|
+
}
|
|
235
|
+
]
|
|
236
|
+
}
|
|
237
|
+
},
|
|
238
|
+
{
|
|
239
|
+
"target": "polycount-budget-checker",
|
|
240
|
+
"type": "progression",
|
|
241
|
+
"label": "**Budget reconciliation** (polycount-budget-checker)",
|
|
242
|
+
"when": {
|
|
243
|
+
"all": [
|
|
244
|
+
{
|
|
245
|
+
"field": "quality.domain",
|
|
246
|
+
"operator": "equals",
|
|
247
|
+
"value": "polycount"
|
|
248
|
+
},
|
|
249
|
+
{
|
|
250
|
+
"field": "budget.verdict",
|
|
251
|
+
"operator": "equals",
|
|
252
|
+
"value": "Not Run"
|
|
253
|
+
}
|
|
254
|
+
]
|
|
255
|
+
}
|
|
256
|
+
},
|
|
257
|
+
{
|
|
258
|
+
"target": "runtime-readiness",
|
|
259
|
+
"type": "upstream_reference",
|
|
260
|
+
"label": "**Generative readiness**",
|
|
261
|
+
"when": {
|
|
262
|
+
"all": [
|
|
263
|
+
{
|
|
264
|
+
"field": "runtime.path",
|
|
265
|
+
"operator": "not_equals",
|
|
266
|
+
"value": "unselected"
|
|
267
|
+
},
|
|
268
|
+
{
|
|
269
|
+
"field": "runtime.verifiedReady",
|
|
270
|
+
"operator": "equals",
|
|
271
|
+
"value": false
|
|
272
|
+
}
|
|
273
|
+
]
|
|
274
|
+
}
|
|
275
|
+
},
|
|
276
|
+
{
|
|
277
|
+
"target": "asset-fallback-strategy",
|
|
278
|
+
"type": "fallback",
|
|
279
|
+
"label": "**Fallback / constraint updates** (asset-fallback-strategy)",
|
|
280
|
+
"when": {
|
|
281
|
+
"all": [
|
|
282
|
+
{
|
|
283
|
+
"field": "assets.fallbackNeeded",
|
|
284
|
+
"operator": "equals",
|
|
285
|
+
"value": true
|
|
286
|
+
}
|
|
287
|
+
]
|
|
288
|
+
}
|
|
289
|
+
}
|
|
290
|
+
]
|
|
291
|
+
}
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
# Asset Strategy Decision Tree
|
|
2
|
+
|
|
3
|
+
Per-asset-class decision tree. Walk top-down, stop at the first matching condition.
|
|
4
|
+
|
|
5
|
+
```
|
|
6
|
+
1. Is the asset BRAND-RESTRICTED (e.g. specific branded product)?
|
|
7
|
+
YES → strategy = library OR user-supplied. Generative is risky for licensing. Photogrammetry only if legal-cleared.
|
|
8
|
+
NO → continue to 2.
|
|
9
|
+
|
|
10
|
+
2. Is the asset HIGHLY SPECIFIC and not in any free library?
|
|
11
|
+
YES → strategy = generative (Path 2 only) OR user-supplied OR photogrammetry. Mark generative with Path 2 caveat.
|
|
12
|
+
NO → continue to 3.
|
|
13
|
+
|
|
14
|
+
3. Is poly budget TIGHT (web GLB ≤ 10MB, mobile target)?
|
|
15
|
+
YES → strategy = procedural (Geometry Nodes inside Blender) preferred. Library only if low-poly source.
|
|
16
|
+
NO → continue to 4.
|
|
17
|
+
|
|
18
|
+
4. Is the deliverable an ITERATION LOOP (text-only first, runtime later)?
|
|
19
|
+
YES → strategy = procedural (cheap to iterate, no fetch needed).
|
|
20
|
+
NO → continue to 5.
|
|
21
|
+
|
|
22
|
+
5. Is mood / look HIGHLY SPECIFIC?
|
|
23
|
+
YES → strategy = library (Poly Haven HDRI for mood, branded asset library for subject).
|
|
24
|
+
NO → strategy = procedural-first as default (most reproducible per evidence-before-done law).
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
## Strategy → Source candidate map
|
|
28
|
+
|
|
29
|
+
| Strategy | Typical sources | Typical license | Typical confidence |
|
|
30
|
+
|---|---|---|---|
|
|
31
|
+
| Procedural | Geometry Nodes / shader nodes inside Blender | N/A (your work) | `verified-read` |
|
|
32
|
+
| Library | Poly Haven, Sketchfab (CC0), brand asset library, user-supplied .blend | CC0 / commercial-OK / brand-restricted | `verified-read` if you have the file; `linked-only` if reading upstream |
|
|
33
|
+
| Generative | Hyper3D Rodin, Hunyuan3D (Path 2 integrations) | Per upstream model terms (often commercial-OK; verify per model) | `linked-only` |
|
|
34
|
+
| Photogrammetry | User-supplied scan + preprocessing (Reality Capture, Meshroom, Polycam) | User's own | `verified-read` if scan exists |
|
|
35
|
+
|
|
36
|
+
## Anti-patterns
|
|
37
|
+
|
|
38
|
+
- "Just use any free model from the internet" — no source named, no license, no confidence label. **Rejected.**
|
|
39
|
+
- Choosing generative without checking Path 2 readiness (the host must have `mcp-for-blender` configured + `addon.py` enabled). Route to `runtime-readiness` first if generative.
|
|
40
|
+
- Choosing high-poly Sketchfab import for a tight web budget. Compare poly count to budget BEFORE the planner commits.
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
# Budget Reconciliation Patterns
|
|
2
|
+
|
|
3
|
+
After per-asset strategy is chosen, sum estimated poly / GLB-size / render-time and compare to the brief constraint slot. Surface conflicts before scene planner commits.
|
|
4
|
+
|
|
5
|
+
## Poly budget summing (web GLB target)
|
|
6
|
+
|
|
7
|
+
| Asset class | Typical poly cost (procedural) | Typical poly cost (library import) | Typical poly cost (generative) |
|
|
8
|
+
|---|---|---|---|
|
|
9
|
+
| Hero subject | 2K-8K | 5K-50K | 5K-30K (model-dependent) |
|
|
10
|
+
| Floor / large props | 100-500 (procedural plane + Geometry Nodes) | 1K-10K | N/A |
|
|
11
|
+
| Small props (5-10 items) | 200-2K total (instanced) | 5K-50K total | N/A |
|
|
12
|
+
| Lighting fixtures | 50-200 (mesh light shape) | 500-5K | N/A |
|
|
13
|
+
| HDRI environment | 0 (image only) | 0 (image only) | N/A |
|
|
14
|
+
|
|
15
|
+
## GLB-size summing rules of thumb
|
|
16
|
+
|
|
17
|
+
| Component | Size impact |
|
|
18
|
+
|---|---|
|
|
19
|
+
| Hero geometry | Dominant; Draco compression reduces ~5x |
|
|
20
|
+
| Textures | High impact; KTX2 compression critical for web |
|
|
21
|
+
| HDRI | Large; usually NOT included in GLB (hosted separately or replaced with cubemap) |
|
|
22
|
+
| Animation | Per-keyframe-per-bone cost; usually small for static heroes |
|
|
23
|
+
|
|
24
|
+
## Reconciliation table format
|
|
25
|
+
|
|
26
|
+
In the per-asset plan, include a budget summary table:
|
|
27
|
+
|
|
28
|
+
```md
|
|
29
|
+
## Budget summary
|
|
30
|
+
|
|
31
|
+
| Constraint | Target | Estimate | Verdict |
|
|
32
|
+
|---|---|---|---|
|
|
33
|
+
| Poly budget (mobile web) | ≤ 8K tris hero + 2K env | 6K + 1.5K | Pass |
|
|
34
|
+
| GLB size (compressed) | ≤ 10MB | ~6MB | Pass |
|
|
35
|
+
| Texture memory | ≤ 32MB | 24MB | Pass |
|
|
36
|
+
| Render time (preview) | ≤ 60s on M3 Pro | Estimate 45s | Pass |
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
## When the verdict is `Fail`
|
|
40
|
+
|
|
41
|
+
If estimated cost exceeds the constraint:
|
|
42
|
+
|
|
43
|
+
1. Surface the conflict explicitly. Don't quietly relax the constraint.
|
|
44
|
+
2. Propose 2-3 trade-off options:
|
|
45
|
+
- Reduce poly via procedural-LOD strategy.
|
|
46
|
+
- Drop a non-essential prop class.
|
|
47
|
+
- Relax the constraint after explicit user confirmation.
|
|
48
|
+
3. Route back to `intent-to-3d-brief-writer` slot 4 if the constraint is the bottleneck.
|
|
49
|
+
|
|
50
|
+
## Anti-patterns
|
|
51
|
+
|
|
52
|
+
- Summing without comparing against the constraint. The whole point is reconciliation.
|
|
53
|
+
- Estimating in vague terms ("should be fine"). Use numbers.
|
|
54
|
+
- Silently dropping a prop class because it doesn't fit. Surface it; let the user decide.
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
# License + Confidence Table
|
|
2
|
+
|
|
3
|
+
Every asset class entry must record both license AND confidence label.
|
|
4
|
+
|
|
5
|
+
## License taxonomy
|
|
6
|
+
|
|
7
|
+
| License | Meaning | Allowed for marketing render | Allowed for paid product distribution | Allowed for client deliverable |
|
|
8
|
+
|---|---|---|---|---|
|
|
9
|
+
| `CC0` | Public domain dedication; no attribution required | Yes | Yes | Yes |
|
|
10
|
+
| `CC-BY` | Attribution required | Yes (with credit) | Yes (with credit) | Yes (with credit) |
|
|
11
|
+
| `CC-BY-SA` | Attribution + share-alike | Yes (with credit) | Yes (with credit) | Conditionally (downstream must also be SA) |
|
|
12
|
+
| `commercial-OK` | Vendor allows commercial use | Yes | Per vendor terms | Per vendor terms |
|
|
13
|
+
| `royalty-free-with-license` | Paid library license | Per license tier | Per license tier | Per license tier |
|
|
14
|
+
| `brand-restricted` | Internal brand library, brand approval needed | Yes (internal) | Brand approval required | Brand approval required |
|
|
15
|
+
| `TBD` | Not yet decided | Block planner until resolved | | |
|
|
16
|
+
| `unknown` | Source not researched | Treat as `TBD` | | |
|
|
17
|
+
|
|
18
|
+
## Confidence taxonomy
|
|
19
|
+
|
|
20
|
+
Match BlendOps's standard confidence labels:
|
|
21
|
+
|
|
22
|
+
| Confidence | Meaning |
|
|
23
|
+
|---|---|
|
|
24
|
+
| `verified-read` | Asset file is on disk; license terms read directly from upstream |
|
|
25
|
+
| `linked-only` | Asset URL is known; license terms inferred from upstream docs but file not yet on disk |
|
|
26
|
+
| `unknown` | Source not yet researched |
|
|
27
|
+
|
|
28
|
+
## Required combination per asset class
|
|
29
|
+
|
|
30
|
+
Every row in the per-asset plan must satisfy:
|
|
31
|
+
|
|
32
|
+
1. License is **not** `TBD` or `unknown` before scene planner consumes the plan.
|
|
33
|
+
2. Confidence is **not** `unknown` before scene planner consumes the plan.
|
|
34
|
+
|
|
35
|
+
If license is `TBD` or confidence is `unknown` at handoff time, **block the scene planner** and route back to the user / brief writer to resolve.
|
|
36
|
+
|
|
37
|
+
## Common pitfalls
|
|
38
|
+
|
|
39
|
+
- "Probably CC0" — never. Open the upstream page and read the license. Assume nothing.
|
|
40
|
+
- "Brand asset library is fine" without checking which subset is approved for external deliverables. Brand restrictions vary by asset.
|
|
41
|
+
- Generative outputs (Hyper3D, Hunyuan3D) — **per-model license terms vary**. Read the specific model's terms; don't assume "commercial-OK".
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
# EVAL — asset-fallback-strategy
|
|
2
|
+
|
|
3
|
+
## Text-only eval prompt
|
|
4
|
+
Apply asset-fallback-strategy on a failed hero-shoe-mesh.glb (license-blocked) for a commercial brand campaign brief.
|
|
5
|
+
|
|
6
|
+
## Expected behavior
|
|
7
|
+
- 2-3 options (CC0 / paid commercial / procedural / drop)
|
|
8
|
+
- columns: time / brief match / license / recommendation
|
|
9
|
+
- recommendation given
|
|
10
|
+
- user agreement required
|
|
11
|
+
- caveat for drop option
|
|
12
|
+
- updated asset list
|
|
13
|
+
|
|
14
|
+
## Pass / Warn / Fail criteria
|
|
15
|
+
- Pass: 2-3 options + recommendation + agreement required + caveat
|
|
16
|
+
- Warn: options thin or recommendation soft
|
|
17
|
+
- Fail: silent substitution, no caveat, no agreement
|
|
18
|
+
|
|
19
|
+
## Common failure modes
|
|
20
|
+
- "we'll figure it out"
|
|
21
|
+
- skipping license check on fallback
|
|
22
|
+
- silent substitution
|
|
23
|
+
- omitting drop option
|
|
24
|
+
|
|
25
|
+
## Sample passing response outline
|
|
26
|
+
- Failed asset + reason
|
|
27
|
+
- Options table with columns
|
|
28
|
+
- Recommendation
|
|
29
|
+
- "Decision needed"
|
|
30
|
+
- Caveat / updated list
|
|
31
|
+
|
|
32
|
+
## Sample failing response outline
|
|
33
|
+
- "Use anything similar"
|
|
34
|
+
- No options table
|