blendops 0.0.0-stage → 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +62 -0
- package/LICENSE +21 -0
- package/README.md +189 -2
- package/bin/blendops.mjs +4 -0
- package/bundles/claude-desktop-manual/BLENDOPS_SINGLE_FILE.md +78 -0
- package/bundles/claude-desktop-manual/IMPORT_STEPS.md +43 -0
- package/bundles/claude-desktop-manual/INSTALL_REPORT_TEMPLATE.md +13 -0
- package/bundles/claude-desktop-manual/README.md +70 -0
- package/bundles/claude-desktop-manual/SKILL.md +62 -0
- package/bundles/claude-desktop-manual/manifest.json +278 -0
- package/bundles/claude-desktop-manual/references/evidence-rules.md +13 -0
- package/bundles/claude-desktop-manual/references/install-boundary.md +13 -0
- package/bundles/claude-desktop-manual/references/laws/evidence-before-done.md +14 -0
- package/bundles/claude-desktop-manual/references/laws/no-arbitrary-python-interface.md +12 -0
- package/bundles/claude-desktop-manual/references/laws/non-blender-user-language.md +13 -0
- package/bundles/claude-desktop-manual/references/laws/official-runtime-only.md +20 -0
- package/bundles/claude-desktop-manual/references/packs/product-hero-v0.md +30 -0
- package/bundles/claude-desktop-manual/references/runtime-stacks.md +13 -0
- package/bundles/claude-desktop-manual/references/skill-map.md +36 -0
- package/bundles/claude-desktop-manual/references/skills/acceptance-criteria-builder.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/asset-discovery.md +73 -0
- package/bundles/claude-desktop-manual/references/skills/asset-fallback-strategy.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/asset-library-plan.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/asset-license-checker.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/asset-style-check.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/blender-brainstorming.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/blender-recipe-decomposer.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/blender-troubleshooting.md +78 -0
- package/bundles/claude-desktop-manual/references/skills/blendops-help.md +82 -0
- package/bundles/claude-desktop-manual/references/skills/bridge-conflicts.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/camera-composition.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/character-portrait.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/cli-appendix-job-outline.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/color-management-decision.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/composition-quality-checker.md +71 -0
- package/bundles/claude-desktop-manual/references/skills/cycles-vs-eevee-decision.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/done-criteria.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/environment-shot.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/glb-animation-handoff.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/glb-web-handoff.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/intent-to-3d-brief-writer.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/interior-scene.md +73 -0
- package/bundles/claude-desktop-manual/references/skills/lighting-material-plan.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/lighting-quality-checker.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/material-quality-checker.md +71 -0
- package/bundles/claude-desktop-manual/references/skills/mobile-glb-budget.md +73 -0
- package/bundles/claude-desktop-manual/references/skills/output-format-decision.md +63 -0
- package/bundles/claude-desktop-manual/references/skills/pack-prerequisite-checker.md +74 -0
- package/bundles/claude-desktop-manual/references/skills/path-one-host-outline.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/plain-language-response.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/polycount-budget-checker.md +71 -0
- package/bundles/claude-desktop-manual/references/skills/pre-handoff-verification.md +76 -0
- package/bundles/claude-desktop-manual/references/skills/preview-report.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/product-grid-scene-planner.md +72 -0
- package/bundles/claude-desktop-manual/references/skills/product-hero-scene-planner.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/r3f-component-plan.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/recipe-fit-assessor.md +75 -0
- package/bundles/claude-desktop-manual/references/skills/render-export-evidence.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/resolution-aspect-decision.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-attempt-report.md +67 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-path-picker.md +67 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-readiness.md +63 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-setup.md +63 -0
- package/bundles/claude-desktop-manual/references/skills/scene-readiness.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/scope-guard.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/stage-gates.md +91 -0
- package/bundles/claude-desktop-manual/references/skills/workflow-stage-router.md +67 -0
- package/bundles/generic-project-local/BLENDOPS.md +71 -0
- package/bundles/generic-project-local/INSTALL_REPORT_TEMPLATE.md +52 -0
- package/bundles/generic-project-local/README.md +72 -0
- package/bundles/generic-project-local/ROLLBACK.md +66 -0
- package/bundles/generic-project-local/manifest.json +66 -0
- package/bundles/skill-package/README.md +54 -0
- package/bundles/skill-package/blendops/LICENSE.txt +21 -0
- package/bundles/skill-package/blendops/SKILL.md +50 -0
- package/bundles/skill-package/blendops/agents/README.md +61 -0
- package/bundles/skill-package/blendops/agents/openai.yaml +4 -0
- package/bundles/skill-package/blendops/references/evidence-rules.md +17 -0
- package/bundles/skill-package/blendops/references/install-boundary.md +13 -0
- package/bundles/skill-package/blendops/references/law-evidence-before-done.md +12 -0
- package/bundles/skill-package/blendops/references/law-no-arbitrary-python-interface.md +7 -0
- package/bundles/skill-package/blendops/references/law-non-blender-user-language.md +8 -0
- package/bundles/skill-package/blendops/references/law-official-runtime-only.md +9 -0
- package/bundles/skill-package/blendops/references/pack-product-hero-v0.md +21 -0
- package/bundles/skill-package/blendops/references/runtime-stacks.md +13 -0
- package/bundles/skill-package/blendops/references/skill-acceptance-criteria-builder.md +51 -0
- package/bundles/skill-package/blendops/references/skill-asset-discovery.md +54 -0
- package/bundles/skill-package/blendops/references/skill-asset-fallback-strategy.md +48 -0
- package/bundles/skill-package/blendops/references/skill-asset-library-plan.md +51 -0
- package/bundles/skill-package/blendops/references/skill-asset-license-checker.md +51 -0
- package/bundles/skill-package/blendops/references/skill-asset-style-check.md +52 -0
- package/bundles/skill-package/blendops/references/skill-blender-brainstorming.md +43 -0
- package/bundles/skill-package/blendops/references/skill-blender-recipe-decomposer.md +48 -0
- package/bundles/skill-package/blendops/references/skill-blender-troubleshooting.md +59 -0
- package/bundles/skill-package/blendops/references/skill-blendops-help.md +62 -0
- package/bundles/skill-package/blendops/references/skill-bridge-conflicts.md +48 -0
- package/bundles/skill-package/blendops/references/skill-camera-composition.md +48 -0
- package/bundles/skill-package/blendops/references/skill-character-portrait.md +50 -0
- package/bundles/skill-package/blendops/references/skill-cli-appendix-job-outline.md +44 -0
- package/bundles/skill-package/blendops/references/skill-color-management-decision.md +50 -0
- package/bundles/skill-package/blendops/references/skill-composition-quality-checker.md +53 -0
- package/bundles/skill-package/blendops/references/skill-cycles-vs-eevee-decision.md +47 -0
- package/bundles/skill-package/blendops/references/skill-done-criteria.md +53 -0
- package/bundles/skill-package/blendops/references/skill-environment-shot.md +47 -0
- package/bundles/skill-package/blendops/references/skill-glb-animation-handoff.md +51 -0
- package/bundles/skill-package/blendops/references/skill-glb-web-handoff.md +51 -0
- package/bundles/skill-package/blendops/references/skill-intent-to-3d-brief-writer.md +50 -0
- package/bundles/skill-package/blendops/references/skill-interior-scene.md +54 -0
- package/bundles/skill-package/blendops/references/skill-lighting-material-plan.md +48 -0
- package/bundles/skill-package/blendops/references/skill-lighting-quality-checker.md +52 -0
- package/bundles/skill-package/blendops/references/skill-map.md +32 -0
- package/bundles/skill-package/blendops/references/skill-material-quality-checker.md +53 -0
- package/bundles/skill-package/blendops/references/skill-mobile-glb-budget.md +55 -0
- package/bundles/skill-package/blendops/references/skill-output-format-decision.md +46 -0
- package/bundles/skill-package/blendops/references/skill-pack-prerequisite-checker.md +56 -0
- package/bundles/skill-package/blendops/references/skill-path-one-host-outline.md +48 -0
- package/bundles/skill-package/blendops/references/skill-plain-language-response.md +53 -0
- package/bundles/skill-package/blendops/references/skill-polycount-budget-checker.md +53 -0
- package/bundles/skill-package/blendops/references/skill-pre-handoff-verification.md +57 -0
- package/bundles/skill-package/blendops/references/skill-preview-report.md +45 -0
- package/bundles/skill-package/blendops/references/skill-product-grid-scene-planner.md +54 -0
- package/bundles/skill-package/blendops/references/skill-product-hero-scene-planner.md +51 -0
- package/bundles/skill-package/blendops/references/skill-r3f-component-plan.md +48 -0
- package/bundles/skill-package/blendops/references/skill-recipe-fit-assessor.md +57 -0
- package/bundles/skill-package/blendops/references/skill-render-export-evidence.md +51 -0
- package/bundles/skill-package/blendops/references/skill-resolution-aspect-decision.md +48 -0
- package/bundles/skill-package/blendops/references/skill-runtime-attempt-report.md +49 -0
- package/bundles/skill-package/blendops/references/skill-runtime-path-picker.md +49 -0
- package/bundles/skill-package/blendops/references/skill-runtime-readiness.md +45 -0
- package/bundles/skill-package/blendops/references/skill-runtime-setup.md +45 -0
- package/bundles/skill-package/blendops/references/skill-scene-readiness.md +48 -0
- package/bundles/skill-package/blendops/references/skill-scope-guard.md +44 -0
- package/bundles/skill-package/blendops/references/skill-stage-gates.md +73 -0
- package/bundles/skill-package/blendops/references/skill-workflow-stage-router.md +49 -0
- package/docs/examples/glb-web-handoff/README.md +174 -0
- package/docs/examples/glb-web-handoff/r3f-glb-viewer.tsx +320 -0
- package/docs/examples/glb-web-handoff/threejs-glb-viewer.mjs +709 -0
- package/docs/knowledge-and-recipe-catalog.md +236 -0
- package/docs/recipes/README.md +27 -0
- package/docs/recipes/cyberpunk-shoe-hero.md +97 -0
- package/docs/workflows/README.md +14 -0
- package/docs/workflows/full-non-blender-user-workflow.md +210 -0
- package/docs/workflows/product-hero-workflow.md +92 -0
- package/laws/README.md +32 -0
- package/laws/evidence-before-done.md +37 -0
- package/laws/no-arbitrary-python-interface.md +32 -0
- package/laws/non-blender-user-language.md +32 -0
- package/laws/official-runtime-only.md +78 -0
- package/package.json +99 -4
- package/packs/README.md +11 -0
- package/packs/product-hero-v0/PACK.md +114 -0
- package/registry/catalog-index.json +21344 -0
- package/registry/compatibility-matrix.json +533 -0
- package/registry/contract-context-fields.json +391 -0
- package/registry/knowledge-catalog.json +4648 -0
- package/registry/knowledge-sources.json +438 -0
- package/registry/recipe-catalog.json +2565 -0
- package/registry/runtime-capability-policy.json +525 -0
- package/registry/runtime-operations.json +4468 -0
- package/registry/skills.json +10231 -0
- package/registry/workflow-graph.json +7390 -0
- package/schemas/adapter-compatibility-matrix.schema.json +166 -0
- package/schemas/contract-context-fields.schema.json +147 -0
- package/schemas/execution-plan.schema.json +325 -0
- package/schemas/glb-web-handoff-manifest.schema.json +744 -0
- package/schemas/knowledge-record.schema.json +460 -0
- package/schemas/knowledge-source-registry.schema.json +268 -0
- package/schemas/operation-execution-ledger.schema.json +348 -0
- package/schemas/recipe-record.schema.json +469 -0
- package/schemas/runtime-capability-policy.schema.json +184 -0
- package/schemas/runtime-evidence-packet.schema.json +211 -0
- package/schemas/runtime-operations.schema.json +535 -0
- package/schemas/runtime-qualification-report.schema.json +540 -0
- package/schemas/runtime-session.schema.json +350 -0
- package/schemas/scene-spec.schema.json +624 -0
- package/schemas/skill-contract.schema.json +402 -0
- package/schemas/skill-eval.schema.json +509 -0
- package/scripts/build-knowledge-catalog.mjs +2376 -0
- package/scripts/compile-scene-plan.mjs +1945 -0
- package/scripts/export-claude-skills.mjs +634 -0
- package/scripts/generate-glb-handoff-report.mjs +2376 -0
- package/scripts/inspect-glb.mjs +1627 -0
- package/scripts/install-skills.mjs +5369 -0
- package/scripts/runtime-orchestrator.mjs +7652 -0
- package/scripts/validate-capability-policy.mjs +531 -0
- package/scripts/validate-evidence-packet.mjs +256 -0
- package/skills/README.md +315 -0
- package/skills/_template/SKILL.md +296 -0
- package/skills/acceptance-criteria-builder/EVAL.md +25 -0
- package/skills/acceptance-criteria-builder/SKILL.md +257 -0
- package/skills/acceptance-criteria-builder/contract.json +205 -0
- package/skills/acceptance-criteria-builder/references/brief-to-criteria-mapper.md +22 -0
- package/skills/acceptance-criteria-builder/references/checklist-patterns.md +22 -0
- package/skills/acceptance-criteria-builder/references/evidence-hook-rules.md +19 -0
- package/skills/asset-discovery/EVAL.md +81 -0
- package/skills/asset-discovery/SKILL.md +252 -0
- package/skills/asset-discovery/contract.json +291 -0
- package/skills/asset-discovery/references/asset-strategy-decision-tree.md +40 -0
- package/skills/asset-discovery/references/budget-reconciliation-patterns.md +54 -0
- package/skills/asset-discovery/references/license-confidence-table.md +41 -0
- package/skills/asset-fallback-strategy/EVAL.md +34 -0
- package/skills/asset-fallback-strategy/SKILL.md +248 -0
- package/skills/asset-fallback-strategy/contract.json +190 -0
- package/skills/asset-fallback-strategy/references/drop-with-caveat-rules.md +36 -0
- package/skills/asset-fallback-strategy/references/fallback-option-types.md +55 -0
- package/skills/asset-fallback-strategy/references/scoring-rubric.md +61 -0
- package/skills/asset-library-plan/EVAL.md +28 -0
- package/skills/asset-library-plan/SKILL.md +263 -0
- package/skills/asset-library-plan/contract.json +177 -0
- package/skills/asset-library-plan/references/folder-structure-rules.md +63 -0
- package/skills/asset-library-plan/references/metadata-schema.md +62 -0
- package/skills/asset-library-plan/references/naming-rules.md +51 -0
- package/skills/asset-license-checker/EVAL.md +33 -0
- package/skills/asset-license-checker/SKILL.md +245 -0
- package/skills/asset-license-checker/contract.json +172 -0
- package/skills/asset-license-checker/references/attribution-rendering-patterns.md +48 -0
- package/skills/asset-license-checker/references/common-license-mapping.md +39 -0
- package/skills/asset-license-checker/references/license-source-rules.md +38 -0
- package/skills/asset-style-check/EVAL.md +26 -0
- package/skills/asset-style-check/SKILL.md +238 -0
- package/skills/asset-style-check/contract.json +251 -0
- package/skills/asset-style-check/references/drift-classification.md +40 -0
- package/skills/asset-style-check/references/intentional-mixed-style.md +39 -0
- package/skills/asset-style-check/references/style-axes.md +46 -0
- package/skills/blender-brainstorming/EVAL.md +79 -0
- package/skills/blender-brainstorming/SKILL.md +228 -0
- package/skills/blender-brainstorming/contract.json +115 -0
- package/skills/blender-brainstorming/references/alternative-scoping-templates.md +43 -0
- package/skills/blender-brainstorming/references/clarification-patterns.md +29 -0
- package/skills/blender-brainstorming/references/intent-summary-style-guide.md +25 -0
- package/skills/blender-recipe-decomposer/EVAL.md +35 -0
- package/skills/blender-recipe-decomposer/SKILL.md +258 -0
- package/skills/blender-recipe-decomposer/contract.json +152 -0
- package/skills/blender-recipe-decomposer/references/dependency-patterns.md +53 -0
- package/skills/blender-recipe-decomposer/references/recipe-grouping-rules.md +58 -0
- package/skills/blender-recipe-decomposer/references/recipe-naming-rules.md +44 -0
- package/skills/blender-troubleshooting/EVAL.md +78 -0
- package/skills/blender-troubleshooting/SKILL.md +263 -0
- package/skills/blender-troubleshooting/contract.json +352 -0
- package/skills/blender-troubleshooting/references/common-symptom-playbooks.md +51 -0
- package/skills/blender-troubleshooting/references/divergence-routing-table.md +23 -0
- package/skills/blender-troubleshooting/references/four-phase-template.md +51 -0
- package/skills/blendops-help/EVAL.md +67 -0
- package/skills/blendops-help/SKILL.md +312 -0
- package/skills/blendops-help/contract.json +229 -0
- package/skills/blendops-help/references/lifecycle-phases.md +91 -0
- package/skills/blendops-help/references/quick-start-prompts.md +65 -0
- package/skills/blendops-help/references/routing-decision-tree.md +57 -0
- package/skills/bridge-conflicts/EVAL.md +83 -0
- package/skills/bridge-conflicts/SKILL.md +246 -0
- package/skills/bridge-conflicts/contract.json +145 -0
- package/skills/bridge-conflicts/references/bridge-state-matrix-template.md +82 -0
- package/skills/bridge-conflicts/references/conflict-playbooks.md +99 -0
- package/skills/bridge-conflicts/references/do-not-reminders.md +42 -0
- package/skills/camera-composition/EVAL.md +32 -0
- package/skills/camera-composition/SKILL.md +196 -0
- package/skills/camera-composition/contract.json +180 -0
- package/skills/camera-composition/references/camera-presets.md +30 -0
- package/skills/camera-composition/references/camera-rubric.md +24 -0
- package/skills/camera-composition/references/hero-composition-patterns.md +24 -0
- package/skills/camera-composition/references/web-layout-negative-space.md +25 -0
- package/skills/character-portrait/EVAL.md +42 -0
- package/skills/character-portrait/SKILL.md +245 -0
- package/skills/character-portrait/contract.json +205 -0
- package/skills/character-portrait/references/portrait-framing-rules.md +39 -0
- package/skills/character-portrait/references/portrait-lighting-patterns.md +50 -0
- package/skills/character-portrait/references/style-consistency-rules.md +41 -0
- package/skills/cli-appendix-job-outline/EVAL.md +26 -0
- package/skills/cli-appendix-job-outline/SKILL.md +252 -0
- package/skills/cli-appendix-job-outline/contract.json +147 -0
- package/skills/cli-appendix-job-outline/references/flag-order-reminders.md +16 -0
- package/skills/cli-appendix-job-outline/references/job-type-matrix.md +13 -0
- package/skills/cli-appendix-job-outline/references/stateless-limitations.md +12 -0
- package/skills/color-management-decision/EVAL.md +28 -0
- package/skills/color-management-decision/SKILL.md +254 -0
- package/skills/color-management-decision/contract.json +162 -0
- package/skills/color-management-decision/references/look-comparison.md +44 -0
- package/skills/color-management-decision/references/per-channel-rules.md +49 -0
- package/skills/color-management-decision/references/pipeline-mapping.md +47 -0
- package/skills/composition-quality-checker/EVAL.md +38 -0
- package/skills/composition-quality-checker/SKILL.md +260 -0
- package/skills/composition-quality-checker/contract.json +221 -0
- package/skills/composition-quality-checker/references/aspect-ratio-rules.md +37 -0
- package/skills/composition-quality-checker/references/composition-rules.md +58 -0
- package/skills/composition-quality-checker/references/headroom-leadroom-rules.md +46 -0
- package/skills/cycles-vs-eevee-decision/EVAL.md +26 -0
- package/skills/cycles-vs-eevee-decision/SKILL.md +249 -0
- package/skills/cycles-vs-eevee-decision/contract.json +142 -0
- package/skills/cycles-vs-eevee-decision/references/engine-feature-matrix.md +39 -0
- package/skills/cycles-vs-eevee-decision/references/gpu-device-rules.md +51 -0
- package/skills/cycles-vs-eevee-decision/references/samples-by-quality.md +53 -0
- package/skills/done-criteria/EVAL.md +33 -0
- package/skills/done-criteria/SKILL.md +225 -0
- package/skills/done-criteria/contract.json +199 -0
- package/skills/done-criteria/references/done-vs-perfect.md +56 -0
- package/skills/done-criteria/references/out-of-scope-patterns.md +50 -0
- package/skills/done-criteria/references/stop-condition-templates.md +39 -0
- package/skills/environment-shot/EVAL.md +44 -0
- package/skills/environment-shot/SKILL.md +237 -0
- package/skills/environment-shot/contract.json +162 -0
- package/skills/environment-shot/references/depth-layering-rules.md +49 -0
- package/skills/environment-shot/references/time-and-weather-rules.md +35 -0
- package/skills/environment-shot/references/wide-shot-camera-rules.md +51 -0
- package/skills/glb-animation-handoff/EVAL.md +39 -0
- package/skills/glb-animation-handoff/SKILL.md +271 -0
- package/skills/glb-animation-handoff/contract.json +247 -0
- package/skills/glb-animation-handoff/references/animation-types.md +36 -0
- package/skills/glb-animation-handoff/references/transition-rules.md +55 -0
- package/skills/glb-animation-handoff/references/web-stack-caveats.md +40 -0
- package/skills/glb-web-handoff/EVAL.md +33 -0
- package/skills/glb-web-handoff/SKILL.md +212 -0
- package/skills/glb-web-handoff/contract.json +171 -0
- package/skills/glb-web-handoff/references/artifact-status-language.md +26 -0
- package/skills/glb-web-handoff/references/glb-handoff-checklist.md +30 -0
- package/skills/glb-web-handoff/references/performance-caveats.md +26 -0
- package/skills/glb-web-handoff/references/threejs-r3f-handoff.md +28 -0
- package/skills/intent-to-3d-brief-writer/EVAL.md +82 -0
- package/skills/intent-to-3d-brief-writer/SKILL.md +238 -0
- package/skills/intent-to-3d-brief-writer/contract.json +195 -0
- package/skills/intent-to-3d-brief-writer/references/acceptance-criteria-patterns.md +46 -0
- package/skills/intent-to-3d-brief-writer/references/eight-slot-template.md +123 -0
- package/skills/intent-to-3d-brief-writer/references/mixed-audience-handling.md +39 -0
- package/skills/interior-scene/EVAL.md +44 -0
- package/skills/interior-scene/SKILL.md +261 -0
- package/skills/interior-scene/contract.json +277 -0
- package/skills/interior-scene/references/furniture-layout-rules.md +51 -0
- package/skills/interior-scene/references/interior-architecture-rules.md +47 -0
- package/skills/interior-scene/references/interior-camera-rules.md +47 -0
- package/skills/lighting-material-plan/EVAL.md +32 -0
- package/skills/lighting-material-plan/SKILL.md +194 -0
- package/skills/lighting-material-plan/contract.json +213 -0
- package/skills/lighting-material-plan/references/cyberpunk-lookdev.md +22 -0
- package/skills/lighting-material-plan/references/lighting-patterns.md +30 -0
- package/skills/lighting-material-plan/references/material-portability.md +25 -0
- package/skills/lighting-material-plan/references/reflective-floor-pattern.md +22 -0
- package/skills/lighting-material-plan/references/web-material-simplification.md +23 -0
- package/skills/lighting-quality-checker/EVAL.md +41 -0
- package/skills/lighting-quality-checker/SKILL.md +247 -0
- package/skills/lighting-quality-checker/contract.json +187 -0
- package/skills/lighting-quality-checker/references/hdri-balance-rules.md +48 -0
- package/skills/lighting-quality-checker/references/intensity-ranges.md +73 -0
- package/skills/lighting-quality-checker/references/shadow-softness-rules.md +38 -0
- package/skills/material-quality-checker/EVAL.md +40 -0
- package/skills/material-quality-checker/SKILL.md +261 -0
- package/skills/material-quality-checker/contract.json +244 -0
- package/skills/material-quality-checker/references/consumer-stack-rules.md +62 -0
- package/skills/material-quality-checker/references/pbr-sanity-rules.md +78 -0
- package/skills/material-quality-checker/references/texture-budget-rules.md +48 -0
- package/skills/mobile-glb-budget/EVAL.md +40 -0
- package/skills/mobile-glb-budget/SKILL.md +264 -0
- package/skills/mobile-glb-budget/contract.json +309 -0
- package/skills/mobile-glb-budget/references/budget-tiers.md +30 -0
- package/skills/mobile-glb-budget/references/degradation-plan.md +34 -0
- package/skills/mobile-glb-budget/references/violation-rules.md +43 -0
- package/skills/output-format-decision/EVAL.md +27 -0
- package/skills/output-format-decision/SKILL.md +222 -0
- package/skills/output-format-decision/contract.json +179 -0
- package/skills/output-format-decision/references/bit-depth-rules.md +56 -0
- package/skills/output-format-decision/references/compression-tradeoffs.md +62 -0
- package/skills/output-format-decision/references/format-decision-matrix.md +34 -0
- package/skills/pack-prerequisite-checker/EVAL.md +26 -0
- package/skills/pack-prerequisite-checker/SKILL.md +272 -0
- package/skills/pack-prerequisite-checker/contract.json +214 -0
- package/skills/pack-prerequisite-checker/references/blocked-start-playbook.md +21 -0
- package/skills/pack-prerequisite-checker/references/pack-readiness-template.md +38 -0
- package/skills/pack-prerequisite-checker/references/prerequisite-matrix.md +20 -0
- package/skills/path-one-host-outline/EVAL.md +26 -0
- package/skills/path-one-host-outline/SKILL.md +251 -0
- package/skills/path-one-host-outline/contract.json +167 -0
- package/skills/path-one-host-outline/references/connector-vs-manual-matrix.md +21 -0
- package/skills/path-one-host-outline/references/host-checklist-template.md +35 -0
- package/skills/path-one-host-outline/references/lab-addon-reminders.md +12 -0
- package/skills/plain-language-response/EVAL.md +33 -0
- package/skills/plain-language-response/SKILL.md +194 -0
- package/skills/plain-language-response/contract.json +242 -0
- package/skills/plain-language-response/references/caveat-language.md +25 -0
- package/skills/plain-language-response/references/plain-language-patterns.md +30 -0
- package/skills/plain-language-response/references/stakeholder-friendly-examples.md +30 -0
- package/skills/plain-language-response/references/status-summary-templates.md +50 -0
- package/skills/polycount-budget-checker/EVAL.md +40 -0
- package/skills/polycount-budget-checker/SKILL.md +251 -0
- package/skills/polycount-budget-checker/contract.json +196 -0
- package/skills/polycount-budget-checker/references/instance-counting-rules.md +39 -0
- package/skills/polycount-budget-checker/references/per-mesh-rules.md +43 -0
- package/skills/polycount-budget-checker/references/topology-hints.md +56 -0
- package/skills/pre-handoff-verification/EVAL.md +84 -0
- package/skills/pre-handoff-verification/SKILL.md +252 -0
- package/skills/pre-handoff-verification/contract.json +295 -0
- package/skills/pre-handoff-verification/references/downgrade-rules.md +39 -0
- package/skills/pre-handoff-verification/references/seven-point-checklist.md +46 -0
- package/skills/pre-handoff-verification/references/text-only-mode-handling.md +36 -0
- package/skills/preview-report/EVAL.md +39 -0
- package/skills/preview-report/SKILL.md +254 -0
- package/skills/preview-report/contract.json +141 -0
- package/skills/preview-report/references/handoff-recipients.md +41 -0
- package/skills/preview-report/references/report-schema.md +60 -0
- package/skills/preview-report/references/truth-label-rules.md +36 -0
- package/skills/product-grid-scene-planner/EVAL.md +42 -0
- package/skills/product-grid-scene-planner/SKILL.md +246 -0
- package/skills/product-grid-scene-planner/contract.json +257 -0
- package/skills/product-grid-scene-planner/references/grid-consistency-rules.md +53 -0
- package/skills/product-grid-scene-planner/references/grid-layout-rules.md +42 -0
- package/skills/product-grid-scene-planner/references/grid-output-naming-rules.md +52 -0
- package/skills/product-hero-scene-planner/EVAL.md +33 -0
- package/skills/product-hero-scene-planner/SKILL.md +227 -0
- package/skills/product-hero-scene-planner/contract.json +228 -0
- package/skills/product-hero-scene-planner/references/clarification-patterns.md +24 -0
- package/skills/product-hero-scene-planner/references/cyberpunk-shoe-example.md +28 -0
- package/skills/product-hero-scene-planner/references/product-hero-playbooks.md +22 -0
- package/skills/product-hero-scene-planner/references/scene-plan-schema.md +35 -0
- package/skills/r3f-component-plan/EVAL.md +43 -0
- package/skills/r3f-component-plan/SKILL.md +290 -0
- package/skills/r3f-component-plan/contract.json +171 -0
- package/skills/r3f-component-plan/references/component-shape-patterns.md +54 -0
- package/skills/r3f-component-plan/references/suspense-placement-rules.md +50 -0
- package/skills/r3f-component-plan/references/usegltf-caching-rules.md +53 -0
- package/skills/recipe-fit-assessor/EVAL.md +28 -0
- package/skills/recipe-fit-assessor/SKILL.md +266 -0
- package/skills/recipe-fit-assessor/contract.json +220 -0
- package/skills/recipe-fit-assessor/references/recipe-catalog.md +30 -0
- package/skills/recipe-fit-assessor/references/scope-gap-rules.md +27 -0
- package/skills/recipe-fit-assessor/references/workflow-recommendation-template.md +34 -0
- package/skills/render-export-evidence/EVAL.md +86 -0
- package/skills/render-export-evidence/SKILL.md +339 -0
- package/skills/render-export-evidence/contract.json +206 -0
- package/skills/render-export-evidence/references/attempted-vs-failed-rubric.md +75 -0
- package/skills/render-export-evidence/references/evidence-record-templates.md +143 -0
- package/skills/render-export-evidence/references/truth-label-decision-tree.md +57 -0
- package/skills/resolution-aspect-decision/EVAL.md +26 -0
- package/skills/resolution-aspect-decision/SKILL.md +246 -0
- package/skills/resolution-aspect-decision/contract.json +160 -0
- package/skills/resolution-aspect-decision/references/aspect-defaults.md +41 -0
- package/skills/resolution-aspect-decision/references/print-vs-screen-rules.md +58 -0
- package/skills/resolution-aspect-decision/references/resolution-defaults.md +64 -0
- package/skills/runtime-attempt-report/EVAL.md +26 -0
- package/skills/runtime-attempt-report/SKILL.md +268 -0
- package/skills/runtime-attempt-report/contract.json +176 -0
- package/skills/runtime-attempt-report/references/attempt-record-template.md +49 -0
- package/skills/runtime-attempt-report/references/triage-next-steps.md +15 -0
- package/skills/runtime-attempt-report/references/truth-label-blocks.md +27 -0
- package/skills/runtime-path-picker/EVAL.md +26 -0
- package/skills/runtime-path-picker/SKILL.md +268 -0
- package/skills/runtime-path-picker/contract.json +191 -0
- package/skills/runtime-path-picker/references/anti-patterns.md +14 -0
- package/skills/runtime-path-picker/references/decision-tree.md +29 -0
- package/skills/runtime-path-picker/references/path-constraints-table.md +18 -0
- package/skills/runtime-readiness/EVAL.md +33 -0
- package/skills/runtime-readiness/SKILL.md +218 -0
- package/skills/runtime-readiness/contract.json +190 -0
- package/skills/runtime-readiness/references/blocker-report-template.md +28 -0
- package/skills/runtime-readiness/references/evidence-examples.md +23 -0
- package/skills/runtime-readiness/references/readiness-matrix.md +46 -0
- package/skills/runtime-setup/EVAL.md +33 -0
- package/skills/runtime-setup/SKILL.md +209 -0
- package/skills/runtime-setup/contract.json +171 -0
- package/skills/runtime-setup/references/runtime-option-decision-tree.md +28 -0
- package/skills/runtime-setup/references/setup-summary-template.md +33 -0
- package/skills/runtime-setup/references/source-confidence-labels.md +23 -0
- package/skills/scene-readiness/EVAL.md +33 -0
- package/skills/scene-readiness/SKILL.md +195 -0
- package/skills/scene-readiness/contract.json +198 -0
- package/skills/scene-readiness/references/blocker-catalog.md +24 -0
- package/skills/scene-readiness/references/not-run-handling.md +22 -0
- package/skills/scene-readiness/references/quality-rubric.md +23 -0
- package/skills/scene-readiness/references/verdict-language.md +22 -0
- package/skills/scope-guard/EVAL.md +33 -0
- package/skills/scope-guard/SKILL.md +222 -0
- package/skills/scope-guard/contract.json +171 -0
- package/skills/scope-guard/references/options-language-template.md +51 -0
- package/skills/scope-guard/references/recurring-creep-patterns.md +55 -0
- package/skills/scope-guard/references/scope-addition-classification.md +55 -0
- package/skills/stage-gates/EVAL.md +40 -0
- package/skills/stage-gates/SKILL.md +257 -0
- package/skills/stage-gates/contract.json +490 -0
- package/skills/stage-gates/references/failed-gate-handling.md +42 -0
- package/skills/stage-gates/references/gate-template.md +46 -0
- package/skills/stage-gates/references/stage-decomposition-patterns.md +55 -0
- package/skills/workflow-stage-router/EVAL.md +25 -0
- package/skills/workflow-stage-router/SKILL.md +259 -0
- package/skills/workflow-stage-router/contract.json +150 -0
- package/skills/workflow-stage-router/references/milestone-model.md +20 -0
- package/skills/workflow-stage-router/references/routing-decision-tree.md +32 -0
- package/skills/workflow-stage-router/references/stage-handoff-template.md +37 -0
- package/skills.sh.json +102 -0
|
@@ -0,0 +1,263 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: asset-library-plan
|
|
3
|
+
description: Plan an internal asset library structure (folders, naming, metadata, license tracking, version control) so future recipes find and reuse assets reliably.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# asset-library-plan
|
|
7
|
+
|
|
8
|
+
## Purpose
|
|
9
|
+
Plan a maintainable internal asset library structure (folder tree, naming convention, per-asset metadata schema, license-tracking strategy, version-control rules, migration steps, and review process) so future recipes can:
|
|
10
|
+
- find existing assets quickly,
|
|
11
|
+
- avoid re-licensing the same source,
|
|
12
|
+
- reuse PBR materials and HDRIs,
|
|
13
|
+
- track versions and revisions,
|
|
14
|
+
- serve as the internal-library source for `asset-discovery` and `asset-fallback-strategy`.
|
|
15
|
+
|
|
16
|
+
## Quick start
|
|
17
|
+
- pin folder structure (kebab-case, by category)
|
|
18
|
+
- pin naming convention (asset name + version + license slug)
|
|
19
|
+
- pin metadata schema (license, source, date, version, hash)
|
|
20
|
+
- pin version control rules (LFS for large binaries, plain text for metadata)
|
|
21
|
+
- emit a library-init plan
|
|
22
|
+
|
|
23
|
+
## When to use
|
|
24
|
+
- starting a new BlendOps repo with multiple recipes
|
|
25
|
+
- existing library is disorganized; recipes can't find assets
|
|
26
|
+
- before scaling to 50+ assets
|
|
27
|
+
|
|
28
|
+
## When not to use
|
|
29
|
+
<!-- blendops:generated:start exclusions -->
|
|
30
|
+
- single-recipe repo with < 5 assets → use `../asset-discovery/SKILL.md` (Delegates out-of-scope requests to asset-discovery)
|
|
31
|
+
- pure planning before any asset categories or storage constraints are known → use `../asset-license-checker/SKILL.md` (Delegates out-of-scope requests to asset-license-checker)
|
|
32
|
+
- sourcing or acquiring external assets → use `../asset-discovery/SKILL.md` (use asset-discovery)
|
|
33
|
+
- verifying asset licenses → use `../asset-license-checker/SKILL.md` (use asset-license-checker)
|
|
34
|
+
- checking visual style consistency across assets → use `../asset-style-check/SKILL.md` (use asset-style-check)
|
|
35
|
+
- planning fallback substitutions when an asset is missing or fails → use `../asset-fallback-strategy/SKILL.md` (use asset-fallback-strategy)
|
|
36
|
+
- enforcing file size or polygon/asset count performance budgets → use `../mobile-glb-budget/SKILL.md` (use mobile-glb-budget)
|
|
37
|
+
<!-- blendops:generated:end exclusions -->
|
|
38
|
+
|
|
39
|
+
## Trigger phrases
|
|
40
|
+
<!-- blendops:generated:start triggers -->
|
|
41
|
+
- "organize the assets"
|
|
42
|
+
- "asset library structure"
|
|
43
|
+
- "where should assets go"
|
|
44
|
+
- "name our assets"
|
|
45
|
+
<!-- blendops:generated:end triggers -->
|
|
46
|
+
|
|
47
|
+
## Prerequisites / readiness
|
|
48
|
+
- baseline asset count + categories known
|
|
49
|
+
- version control system known (git + LFS / Perforce / DAM)
|
|
50
|
+
- internal team conventions (if any)
|
|
51
|
+
|
|
52
|
+
## Input schema
|
|
53
|
+
|
|
54
|
+
### Required inputs
|
|
55
|
+
|
|
56
|
+
| Input | Why it is required |
|
|
57
|
+
|---|---|
|
|
58
|
+
| Asset categories | Drives folder structure |
|
|
59
|
+
| Version control system | Drives binary storage rules |
|
|
60
|
+
| Existing convention (if any) | Maintain consistency |
|
|
61
|
+
|
|
62
|
+
### Optional inputs
|
|
63
|
+
|
|
64
|
+
| Input | Use |
|
|
65
|
+
|---|---|
|
|
66
|
+
| Team size | Affects review process |
|
|
67
|
+
| Cloud storage / DAM | Alternative storage path |
|
|
68
|
+
|
|
69
|
+
### Assumptions to confirm
|
|
70
|
+
- The library is shared across future recipes.
|
|
71
|
+
- License metadata must be queryable.
|
|
72
|
+
- Versioning is discrete (not "latest" symlinks; pinned versions).
|
|
73
|
+
|
|
74
|
+
## Output schema
|
|
75
|
+
|
|
76
|
+
### Primary output
|
|
77
|
+
A library plan: folder tree, naming convention, per-asset metadata schema, version control rules, license tracking strategy.
|
|
78
|
+
|
|
79
|
+
### Secondary output
|
|
80
|
+
- migration steps if existing assets need re-organizing
|
|
81
|
+
- review process for adding new assets
|
|
82
|
+
- evidence label
|
|
83
|
+
|
|
84
|
+
### Evidence / caveat output
|
|
85
|
+
|
|
86
|
+
```txt
|
|
87
|
+
Runtime status: Not Run | Attempted | Produced | Verified | Failed
|
|
88
|
+
Artifact status: Not Produced | Produced | Verified | Failed
|
|
89
|
+
Evidence used: <links, paths, logs, or "none">
|
|
90
|
+
Limitations: <known gaps>
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
Truth-state rules:
|
|
94
|
+
|
|
95
|
+
* Default `Artifact status` is `Not Produced`.
|
|
96
|
+
* States are downgrade-only, never upgrade.
|
|
97
|
+
* Planning a library never produces library files (`Runtime status: Not Run`, `Artifact status: Not Produced` unless verifying pre-existing external evidence).
|
|
98
|
+
|
|
99
|
+
## Required laws
|
|
100
|
+
- `../../laws/evidence-before-done.md`
|
|
101
|
+
- `../../laws/non-blender-user-language.md`
|
|
102
|
+
- `../../laws/no-arbitrary-python-interface.md`
|
|
103
|
+
- `../../laws/official-runtime-only.md`
|
|
104
|
+
|
|
105
|
+
## Official runtime boundary
|
|
106
|
+
|
|
107
|
+
Planning skill — never moves files, never configures git/LFS/DAM, never runs Blender, and never produces library files. Outputs a structure spec, migration steps, and review process only.
|
|
108
|
+
|
|
109
|
+
## Operating procedure
|
|
110
|
+
1. Read asset categories.
|
|
111
|
+
2. Pin folder structure (see `references/folder-structure-rules.md`).
|
|
112
|
+
3. Pin naming convention (see `references/naming-rules.md`).
|
|
113
|
+
4. Pin metadata schema (see `references/metadata-schema.md`).
|
|
114
|
+
5. Pin version control rules (LFS thresholds, branching).
|
|
115
|
+
6. Pin license tracking (license file lives next to the asset; unlicensed old assets go to Quarantine for `asset-license-checker`).
|
|
116
|
+
7. Recommend a review process for new asset additions.
|
|
117
|
+
8. Emit library-init plan + migration steps.
|
|
118
|
+
|
|
119
|
+
## Decision tree
|
|
120
|
+
|
|
121
|
+
```txt
|
|
122
|
+
< 50 total assets?
|
|
123
|
+
→ Simple flat structure may suffice
|
|
124
|
+
50-500 assets?
|
|
125
|
+
→ Categorical folders + subfolders
|
|
126
|
+
500+ assets?
|
|
127
|
+
→ DAM (Digital Asset Management) tool recommended
|
|
128
|
+
Mostly small files (< 50MB each)?
|
|
129
|
+
→ Plain git OK
|
|
130
|
+
Mixed sizes including > 50MB?
|
|
131
|
+
→ Git LFS or external storage
|
|
132
|
+
> 1GB total?
|
|
133
|
+
→ External DAM strongly recommended
|
|
134
|
+
```
|
|
135
|
+
|
|
136
|
+
## Playbooks
|
|
137
|
+
|
|
138
|
+
### Playbook A: Small repo (< 50 assets)
|
|
139
|
+
|
|
140
|
+
Flat folders by category: `assets/models/`, `assets/textures/`, `assets/hdris/`, `assets/fonts/`. Per-asset license file and metadata file live directly next to each asset file, plus one README per category folder.
|
|
141
|
+
|
|
142
|
+
### Playbook B: Medium repo (50-500 assets)
|
|
143
|
+
|
|
144
|
+
Nested by category + sub-category: `assets/models/products/`, `assets/models/characters/`, `assets/textures/pbr/`, etc. Per-asset `LICENSE.txt` + `metadata.json` next to the asset.
|
|
145
|
+
|
|
146
|
+
### Playbook C: Large repo (500+)
|
|
147
|
+
|
|
148
|
+
External DAM tool + git pointer files. Library plan focuses on folder taxonomy, naming convention, and per-asset metadata/license schema; binary storage is offloaded (operator configures DAM/VCS externally).
|
|
149
|
+
|
|
150
|
+
## Mode handling
|
|
151
|
+
|
|
152
|
+
### Text-only mode
|
|
153
|
+
|
|
154
|
+
Library structure plan, migration steps, and review process only (`Runtime status: Not Run`, `Artifact status: Not Produced`).
|
|
155
|
+
|
|
156
|
+
### Runtime-ready mode
|
|
157
|
+
|
|
158
|
+
Library plan + recommended directory creation and migration steps for the operator to run manually. This skill never creates directories, never moves files, never configures git/LFS/DAM, and never produces library files (`Runtime status: Not Run`, `Artifact status: Not Produced`).
|
|
159
|
+
|
|
160
|
+
### Blocked runtime mode
|
|
161
|
+
|
|
162
|
+
Library plan only (`Runtime status: Not Run`, `Artifact status: Not Produced`).
|
|
163
|
+
|
|
164
|
+
## Validation checklist
|
|
165
|
+
- [ ] Folder structure pinned
|
|
166
|
+
- [ ] Naming convention pinned
|
|
167
|
+
- [ ] Metadata schema pinned
|
|
168
|
+
- [ ] Version control rules pinned
|
|
169
|
+
- [ ] License tracking strategy pinned
|
|
170
|
+
- [ ] Review process for new assets
|
|
171
|
+
- [ ] Migration steps (if existing library)
|
|
172
|
+
|
|
173
|
+
## Pass / Warn / Fail rubric
|
|
174
|
+
|
|
175
|
+
| Verdict | Criteria |
|
|
176
|
+
|---|---|
|
|
177
|
+
| Pass | All sections pinned + migration plan if needed + review process. |
|
|
178
|
+
| Warn | One section soft (e.g. metadata schema partial). |
|
|
179
|
+
| Fail | "Just dump in a folder" advice; no naming convention; no license tracking. |
|
|
180
|
+
|
|
181
|
+
## Failure handling
|
|
182
|
+
- Existing library cannot be reorganized → plan a parallel new library + gradual migration.
|
|
183
|
+
- VCS not in place → recommend git or alternative before any asset commit.
|
|
184
|
+
- Team lacks process discipline → recommend lightweight review checklist (1-page).
|
|
185
|
+
|
|
186
|
+
## Troubleshooting
|
|
187
|
+
|
|
188
|
+
| Problem | Response |
|
|
189
|
+
| --- | --- |
|
|
190
|
+
| Asset duplicates across folders | Plan a hash-check step in the migration plan so the operator can deduplicate before re-organizing (this skill does not move or delete files). |
|
|
191
|
+
| Lost license info on old assets | Plan a `Quarantine/` holding path; mark unlicensed old assets as Quarantine and hand off to `asset-license-checker` before any recipe uses them. |
|
|
192
|
+
| Naming inconsistency | Apply convention to new assets immediately; schedule batch renames of old assets in phased migration steps. |
|
|
193
|
+
|
|
194
|
+
## Best practices
|
|
195
|
+
- One library, one source of truth.
|
|
196
|
+
- License lives next to the asset, always.
|
|
197
|
+
- Naming convention is unforgiving; enforce in code review.
|
|
198
|
+
- Avoid deeply-nested folders (> 4 levels gets confusing).
|
|
199
|
+
|
|
200
|
+
## Good examples
|
|
201
|
+
- "assets/models/products/sneaker-v01-cc0.glb + assets/models/products/sneaker-v01-cc0.metadata.json + assets/models/products/sneaker-v01-cc0.LICENSE.txt"
|
|
202
|
+
|
|
203
|
+
## Bad examples
|
|
204
|
+
- "Just use a Drive folder." — no version, no license tracking.
|
|
205
|
+
|
|
206
|
+
## User-facing response template
|
|
207
|
+
|
|
208
|
+
```txt
|
|
209
|
+
Library size estimate: <N assets>
|
|
210
|
+
VCS: <git / git+lfs / DAM>
|
|
211
|
+
|
|
212
|
+
Folder structure:
|
|
213
|
+
<tree>
|
|
214
|
+
|
|
215
|
+
Naming convention: <pattern + examples>
|
|
216
|
+
|
|
217
|
+
Metadata schema (per asset):
|
|
218
|
+
<fields>
|
|
219
|
+
|
|
220
|
+
Version control:
|
|
221
|
+
<rules>
|
|
222
|
+
|
|
223
|
+
License tracking: <per-asset license file next to asset + Quarantine rule for unlicensed legacy assets>
|
|
224
|
+
|
|
225
|
+
Review process: <1-page checklist>
|
|
226
|
+
|
|
227
|
+
Migration steps (if applicable): <list>
|
|
228
|
+
|
|
229
|
+
Runtime status: Not Run | Attempted | Produced | Verified | Failed
|
|
230
|
+
Artifact status: Not Produced | Produced | Verified | Failed
|
|
231
|
+
Evidence used: <links, paths, logs, or "none">
|
|
232
|
+
Limitations: <known gaps>
|
|
233
|
+
Next: operator implements structure; `asset-discovery` and `asset-fallback-strategy` use this library as their internal source
|
|
234
|
+
```
|
|
235
|
+
|
|
236
|
+
## Anti-patterns
|
|
237
|
+
- "Just a folder."
|
|
238
|
+
- No license file.
|
|
239
|
+
- Mutable "latest" pointers.
|
|
240
|
+
- Mixing assets and recipes in the same folders.
|
|
241
|
+
|
|
242
|
+
## Cross-skill handoff
|
|
243
|
+
<!-- blendops:generated:start handoffs -->
|
|
244
|
+
- [upstream_reference] External asset sourcing into this library → `../asset-discovery/SKILL.md`
|
|
245
|
+
- [upstream_reference] License verification (license file next to asset; unlicensed old assets to Quarantine) → `../asset-license-checker/SKILL.md`
|
|
246
|
+
- [upstream_reference] Visual style consistency checks → `../asset-style-check/SKILL.md`
|
|
247
|
+
- [fallback] Consuming this library as fastest fallback source → `../asset-fallback-strategy/SKILL.md`
|
|
248
|
+
- [progression] File size and asset/polygon count pressure → `../mobile-glb-budget/SKILL.md`
|
|
249
|
+
<!-- blendops:generated:end handoffs -->
|
|
250
|
+
|
|
251
|
+
## Non-goals
|
|
252
|
+
|
|
253
|
+
* Move, rename, or delete files.
|
|
254
|
+
* Configure git, Git LFS, Perforce, or DAM tools.
|
|
255
|
+
* Run Blender or execute Python.
|
|
256
|
+
* Buy or source external assets (use `asset-discovery`).
|
|
257
|
+
* Verify licenses, style consistency, or performance budgets (use `asset-license-checker`, `asset-style-check`, `mobile-glb-budget`).
|
|
258
|
+
|
|
259
|
+
## References
|
|
260
|
+
- `references/folder-structure-rules.md`
|
|
261
|
+
- `references/naming-rules.md`
|
|
262
|
+
- `references/metadata-schema.md`
|
|
263
|
+
- `../../docs/skill-system.md`
|
|
@@ -0,0 +1,177 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "../../schemas/skill-contract.schema.json",
|
|
3
|
+
"id": "asset-library-plan",
|
|
4
|
+
"version": "1.0.0",
|
|
5
|
+
"category": "asset-and-sourcing",
|
|
6
|
+
"role": "local-asset-library-taxonomy-planner",
|
|
7
|
+
"purpose": "Plan an internal asset library structure (folders, naming, metadata, license tracking, version control) so future recipes find and reuse assets reliably.",
|
|
8
|
+
"capabilityTier": "L0",
|
|
9
|
+
"triggers": [
|
|
10
|
+
"organize the assets",
|
|
11
|
+
"asset library structure",
|
|
12
|
+
"where should assets go",
|
|
13
|
+
"name our assets"
|
|
14
|
+
],
|
|
15
|
+
"exclusions": [
|
|
16
|
+
{
|
|
17
|
+
"condition": "single-recipe repo with < 5 assets",
|
|
18
|
+
"delegateTo": "asset-discovery",
|
|
19
|
+
"reason": "Delegates out-of-scope requests to asset-discovery"
|
|
20
|
+
},
|
|
21
|
+
{
|
|
22
|
+
"condition": "pure planning before any asset categories or storage constraints are known",
|
|
23
|
+
"delegateTo": "asset-license-checker",
|
|
24
|
+
"reason": "Delegates out-of-scope requests to asset-license-checker"
|
|
25
|
+
},
|
|
26
|
+
{
|
|
27
|
+
"condition": "sourcing or acquiring external assets",
|
|
28
|
+
"delegateTo": "asset-discovery",
|
|
29
|
+
"reason": "use asset-discovery"
|
|
30
|
+
},
|
|
31
|
+
{
|
|
32
|
+
"condition": "verifying asset licenses",
|
|
33
|
+
"delegateTo": "asset-license-checker",
|
|
34
|
+
"reason": "use asset-license-checker"
|
|
35
|
+
},
|
|
36
|
+
{
|
|
37
|
+
"condition": "checking visual style consistency across assets",
|
|
38
|
+
"delegateTo": "asset-style-check",
|
|
39
|
+
"reason": "use asset-style-check"
|
|
40
|
+
},
|
|
41
|
+
{
|
|
42
|
+
"condition": "planning fallback substitutions when an asset is missing or fails",
|
|
43
|
+
"delegateTo": "asset-fallback-strategy",
|
|
44
|
+
"reason": "use asset-fallback-strategy"
|
|
45
|
+
},
|
|
46
|
+
{
|
|
47
|
+
"condition": "enforcing file size or polygon/asset count performance budgets",
|
|
48
|
+
"delegateTo": "mobile-glb-budget",
|
|
49
|
+
"reason": "use mobile-glb-budget"
|
|
50
|
+
}
|
|
51
|
+
],
|
|
52
|
+
"inputs": {
|
|
53
|
+
"required": [
|
|
54
|
+
{
|
|
55
|
+
"name": "raw_asset_inventory",
|
|
56
|
+
"type": "array",
|
|
57
|
+
"description": "List of 3D models, PBR material sets, HDRIs, and license sidecar files to organize"
|
|
58
|
+
},
|
|
59
|
+
{
|
|
60
|
+
"name": "project_storage_scope",
|
|
61
|
+
"type": "string",
|
|
62
|
+
"description": "Whether the library is project-local or shared across multiple BlendOps packs"
|
|
63
|
+
}
|
|
64
|
+
],
|
|
65
|
+
"optional": [
|
|
66
|
+
{
|
|
67
|
+
"name": "naming_prefix_convention",
|
|
68
|
+
"type": "string",
|
|
69
|
+
"description": "Optional studio or project naming prefix for datablocks and folders"
|
|
70
|
+
}
|
|
71
|
+
]
|
|
72
|
+
},
|
|
73
|
+
"outputs": {
|
|
74
|
+
"primary": [
|
|
75
|
+
"directory_taxonomy_plan",
|
|
76
|
+
"datablock_naming_rules",
|
|
77
|
+
"quarantine_and_license_sidecar_policy"
|
|
78
|
+
],
|
|
79
|
+
"truthStatePolicy": {
|
|
80
|
+
"runtimeDefault": "Not Run",
|
|
81
|
+
"artifactDefault": "Not Produced",
|
|
82
|
+
"mutationRule": "downgrade_only"
|
|
83
|
+
}
|
|
84
|
+
},
|
|
85
|
+
"handoffs": [
|
|
86
|
+
{
|
|
87
|
+
"target": "asset-discovery",
|
|
88
|
+
"type": "upstream_reference",
|
|
89
|
+
"label": "External asset sourcing into this library",
|
|
90
|
+
"when": {
|
|
91
|
+
"all": [
|
|
92
|
+
{
|
|
93
|
+
"field": "brief.locked",
|
|
94
|
+
"operator": "equals",
|
|
95
|
+
"value": true
|
|
96
|
+
},
|
|
97
|
+
{
|
|
98
|
+
"field": "assets.discoveryComplete",
|
|
99
|
+
"operator": "equals",
|
|
100
|
+
"value": false
|
|
101
|
+
}
|
|
102
|
+
]
|
|
103
|
+
}
|
|
104
|
+
},
|
|
105
|
+
{
|
|
106
|
+
"target": "asset-license-checker",
|
|
107
|
+
"type": "upstream_reference",
|
|
108
|
+
"label": "License verification (license file next to asset; unlicensed old assets to Quarantine)",
|
|
109
|
+
"when": {
|
|
110
|
+
"all": [
|
|
111
|
+
{
|
|
112
|
+
"field": "assets.externalUsed",
|
|
113
|
+
"operator": "equals",
|
|
114
|
+
"value": true
|
|
115
|
+
},
|
|
116
|
+
{
|
|
117
|
+
"field": "assets.licenseCleared",
|
|
118
|
+
"operator": "equals",
|
|
119
|
+
"value": false
|
|
120
|
+
}
|
|
121
|
+
]
|
|
122
|
+
}
|
|
123
|
+
},
|
|
124
|
+
{
|
|
125
|
+
"target": "asset-style-check",
|
|
126
|
+
"type": "upstream_reference",
|
|
127
|
+
"label": "Visual style consistency checks",
|
|
128
|
+
"when": {
|
|
129
|
+
"all": [
|
|
130
|
+
{
|
|
131
|
+
"field": "assets.licenseCleared",
|
|
132
|
+
"operator": "equals",
|
|
133
|
+
"value": true
|
|
134
|
+
},
|
|
135
|
+
{
|
|
136
|
+
"field": "stage.current",
|
|
137
|
+
"operator": "equals",
|
|
138
|
+
"value": "style_check"
|
|
139
|
+
}
|
|
140
|
+
]
|
|
141
|
+
}
|
|
142
|
+
},
|
|
143
|
+
{
|
|
144
|
+
"target": "asset-fallback-strategy",
|
|
145
|
+
"type": "fallback",
|
|
146
|
+
"label": "Consuming this library as fastest fallback source",
|
|
147
|
+
"when": {
|
|
148
|
+
"all": [
|
|
149
|
+
{
|
|
150
|
+
"field": "assets.fallbackNeeded",
|
|
151
|
+
"operator": "equals",
|
|
152
|
+
"value": true
|
|
153
|
+
}
|
|
154
|
+
]
|
|
155
|
+
}
|
|
156
|
+
},
|
|
157
|
+
{
|
|
158
|
+
"target": "mobile-glb-budget",
|
|
159
|
+
"type": "progression",
|
|
160
|
+
"label": "File size and asset/polygon count pressure",
|
|
161
|
+
"when": {
|
|
162
|
+
"all": [
|
|
163
|
+
{
|
|
164
|
+
"field": "artifact.type",
|
|
165
|
+
"operator": "equals",
|
|
166
|
+
"value": "glb"
|
|
167
|
+
},
|
|
168
|
+
{
|
|
169
|
+
"field": "budget.pinned",
|
|
170
|
+
"operator": "equals",
|
|
171
|
+
"value": false
|
|
172
|
+
}
|
|
173
|
+
]
|
|
174
|
+
}
|
|
175
|
+
}
|
|
176
|
+
]
|
|
177
|
+
}
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
# Folder structure rules
|
|
2
|
+
|
|
3
|
+
## Top-level structure (recommended)
|
|
4
|
+
|
|
5
|
+
```
|
|
6
|
+
assets/
|
|
7
|
+
models/
|
|
8
|
+
textures/
|
|
9
|
+
hdris/
|
|
10
|
+
fonts/
|
|
11
|
+
audio/
|
|
12
|
+
brushes/
|
|
13
|
+
presets/
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
All kebab-case, all lowercase.
|
|
17
|
+
|
|
18
|
+
## Per-category sub-structure
|
|
19
|
+
|
|
20
|
+
### models/
|
|
21
|
+
- products/
|
|
22
|
+
- characters/
|
|
23
|
+
- environments/
|
|
24
|
+
- props/
|
|
25
|
+
|
|
26
|
+
### textures/
|
|
27
|
+
- pbr/
|
|
28
|
+
- metals/
|
|
29
|
+
- woods/
|
|
30
|
+
- fabrics/
|
|
31
|
+
- gradients/
|
|
32
|
+
- alphas/
|
|
33
|
+
|
|
34
|
+
### hdris/
|
|
35
|
+
- studio/
|
|
36
|
+
- outdoor/
|
|
37
|
+
- indoor/
|
|
38
|
+
|
|
39
|
+
### fonts/
|
|
40
|
+
- (subfolders only if >50 fonts)
|
|
41
|
+
|
|
42
|
+
## Rules
|
|
43
|
+
|
|
44
|
+
- Max nesting depth: 4 levels.
|
|
45
|
+
- Each folder has a README.md describing what belongs there.
|
|
46
|
+
- Each asset folder has a LICENSE.txt or LICENSE per asset.
|
|
47
|
+
|
|
48
|
+
## Anti-patterns
|
|
49
|
+
|
|
50
|
+
- "misc/" or "other/" folders → vague; rejects organization discipline.
|
|
51
|
+
- Date-prefixed folder names ("2026-projects/") → mixes time-based and category-based; pick one.
|
|
52
|
+
- Per-recipe folders inside `assets/` → assets are reusable; recipes consume them.
|
|
53
|
+
|
|
54
|
+
## Migration
|
|
55
|
+
|
|
56
|
+
When reorganizing existing assets:
|
|
57
|
+
1. Inventory existing assets with paths.
|
|
58
|
+
2. Map each to new location.
|
|
59
|
+
3. Update references (Blender file paths, recipes).
|
|
60
|
+
4. Re-test renders that used the assets.
|
|
61
|
+
|
|
62
|
+
## Related skill
|
|
63
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
# Metadata schema
|
|
2
|
+
|
|
3
|
+
Each asset has a sidecar `<asset-name>.metadata.json` (or .yaml) with these fields.
|
|
4
|
+
|
|
5
|
+
## Required fields
|
|
6
|
+
|
|
7
|
+
```json
|
|
8
|
+
{
|
|
9
|
+
"name": "sneaker-hero",
|
|
10
|
+
"version": "v01",
|
|
11
|
+
"category": "models/products",
|
|
12
|
+
"license": "CC0 1.0",
|
|
13
|
+
"license_url": "https://creativecommons.org/publicdomain/zero/1.0/",
|
|
14
|
+
"source_url": "https://polyhaven.com/...",
|
|
15
|
+
"source_platform": "polyhaven",
|
|
16
|
+
"acquired_date": "2026-05-09",
|
|
17
|
+
"file_hash_sha256": "<hash>",
|
|
18
|
+
"file_size_bytes": 1234567,
|
|
19
|
+
"format": "glb"
|
|
20
|
+
}
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
## Optional fields
|
|
24
|
+
|
|
25
|
+
```json
|
|
26
|
+
{
|
|
27
|
+
"author": "Original creator name",
|
|
28
|
+
"tags": ["sneaker", "footwear", "product-hero"],
|
|
29
|
+
"polycount": 24500,
|
|
30
|
+
"texture_resolutions": ["2048x2048", "1024x1024"],
|
|
31
|
+
"uv_layouts": 1,
|
|
32
|
+
"rigged": false,
|
|
33
|
+
"animated": false,
|
|
34
|
+
"preview_image": "preview.png",
|
|
35
|
+
"notes": "Free-form notes",
|
|
36
|
+
"supersedes": "sneaker-hero-old-v01-cc0.glb",
|
|
37
|
+
"review_status": "approved",
|
|
38
|
+
"reviewer": "alice"
|
|
39
|
+
}
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
## Why a sidecar file
|
|
43
|
+
|
|
44
|
+
- Survives version control (text diffs).
|
|
45
|
+
- Searchable by tools.
|
|
46
|
+
- Decoupled from binary file format.
|
|
47
|
+
- Re-readable without opening the asset.
|
|
48
|
+
|
|
49
|
+
## Required fields rationale
|
|
50
|
+
|
|
51
|
+
- `license` + `license_url`: enables `asset-license-checker` lookups.
|
|
52
|
+
- `source_url`: provenance.
|
|
53
|
+
- `acquired_date`: license version pinning.
|
|
54
|
+
- `file_hash_sha256`: detect tampering / accidental changes.
|
|
55
|
+
- `file_size_bytes`: inform storage / VCS choice.
|
|
56
|
+
|
|
57
|
+
## Generating metadata
|
|
58
|
+
|
|
59
|
+
Most fields can be auto-derived (size, hash, format, polycount). License + source require human input at acquisition time.
|
|
60
|
+
|
|
61
|
+
## Related skill
|
|
62
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
# Naming rules
|
|
2
|
+
|
|
3
|
+
## Pattern
|
|
4
|
+
|
|
5
|
+
```
|
|
6
|
+
<asset-name>-<version>-<license-slug>.<ext>
|
|
7
|
+
```
|
|
8
|
+
|
|
9
|
+
Examples:
|
|
10
|
+
- `sneaker-hero-v01-cc0.glb`
|
|
11
|
+
- `studio-hdri-v02-cc0.exr`
|
|
12
|
+
- `oak-wood-pbr-v01-cc-by.zip`
|
|
13
|
+
- `helvetica-neue-v01-proprietary.ttf`
|
|
14
|
+
|
|
15
|
+
## Rules
|
|
16
|
+
|
|
17
|
+
- Kebab-case lowercase.
|
|
18
|
+
- No spaces.
|
|
19
|
+
- No special characters except hyphen and dot.
|
|
20
|
+
- Version always present (start at v01).
|
|
21
|
+
- License slug always present.
|
|
22
|
+
|
|
23
|
+
## License slugs
|
|
24
|
+
|
|
25
|
+
| License | Slug |
|
|
26
|
+
|---|---|
|
|
27
|
+
| CC0 | cc0 |
|
|
28
|
+
| CC-BY 4.0 | cc-by |
|
|
29
|
+
| CC-BY-SA 4.0 | cc-by-sa |
|
|
30
|
+
| CC-BY-NC 4.0 | cc-by-nc |
|
|
31
|
+
| MIT | mit |
|
|
32
|
+
| Apache 2.0 | apache-2 |
|
|
33
|
+
| Proprietary / commercial | proprietary |
|
|
34
|
+
| Internal / confidential | internal |
|
|
35
|
+
| Unknown / quarantine | quarantine |
|
|
36
|
+
|
|
37
|
+
## Versioning
|
|
38
|
+
|
|
39
|
+
- Bump version when the asset content changes meaningfully (re-modeled, re-textured, re-rendered HDRI).
|
|
40
|
+
- Do not bump version for metadata changes only.
|
|
41
|
+
- Keep prior versions in the library (do not delete) until referenced recipes are updated.
|
|
42
|
+
|
|
43
|
+
## Forbidden in names
|
|
44
|
+
|
|
45
|
+
- Date stamps (use git history instead).
|
|
46
|
+
- "Final", "v2-final", "v3-real-final" (use proper version numbers).
|
|
47
|
+
- Author initials (use git author info).
|
|
48
|
+
- Project codenames (assets are reusable; not project-bound).
|
|
49
|
+
|
|
50
|
+
## Related skill
|
|
51
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
# EVAL — asset-license-checker
|
|
2
|
+
|
|
3
|
+
## Text-only eval prompt
|
|
4
|
+
Apply asset-license-checker on a 4-asset list (1 CC0 HDRI from polyhaven, 1 MIT model from sketchfab, 1 unknown texture, 1 paid commercial license model). Intended use: commercial brand campaign.
|
|
5
|
+
|
|
6
|
+
## Expected behavior
|
|
7
|
+
- 4-row asset table with source / license / permissions / verdict
|
|
8
|
+
- attribution lines listed
|
|
9
|
+
- assets to remove flagged (the unknown one as Fail)
|
|
10
|
+
- top-line status
|
|
11
|
+
- "not legal advice" caveat
|
|
12
|
+
|
|
13
|
+
## Pass / Warn / Fail criteria
|
|
14
|
+
- Pass: 4 rows + verdicts + attribution + caveat
|
|
15
|
+
- Warn: rows present but attribution incomplete
|
|
16
|
+
- Fail: marks "should be fine" verdicts, fabricates license terms
|
|
17
|
+
|
|
18
|
+
## Common failure modes
|
|
19
|
+
- "Should be fine" verdicts
|
|
20
|
+
- skipping attribution plan
|
|
21
|
+
- inventing license terms
|
|
22
|
+
- treating "all rights reserved" as usable
|
|
23
|
+
|
|
24
|
+
## Sample passing response outline
|
|
25
|
+
- Header: intended use + attribution policy
|
|
26
|
+
- 4 rows + verdicts
|
|
27
|
+
- Attribution list
|
|
28
|
+
- Assets to remove
|
|
29
|
+
- Top-line + caveat
|
|
30
|
+
|
|
31
|
+
## Sample failing response outline
|
|
32
|
+
- "Looks OK to use"
|
|
33
|
+
- No license terms cited
|