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,75 @@
|
|
|
1
|
+
# `Attempted` vs `Failed` Rubric
|
|
2
|
+
|
|
3
|
+
These two labels are commonly confused. They are not synonyms.
|
|
4
|
+
|
|
5
|
+
## Definitions
|
|
6
|
+
|
|
7
|
+
| Label | Meaning |
|
|
8
|
+
|---|---|
|
|
9
|
+
| `Attempted` | Runtime action was started; **outcome is unknown or evidence is incomplete**. The action might have succeeded, failed, or been interrupted — we don't have enough evidence to say. |
|
|
10
|
+
| `Failed` | Runtime action was started; **we have evidence it did not meet stated criteria**. The failure is observed, not assumed. |
|
|
11
|
+
|
|
12
|
+
## Decision rule
|
|
13
|
+
|
|
14
|
+
```
|
|
15
|
+
Was a runtime action attempted?
|
|
16
|
+
NO → `Not Run`
|
|
17
|
+
YES → Did we OBSERVE evidence of the outcome?
|
|
18
|
+
NO → `Attempted` (unknown outcome)
|
|
19
|
+
YES → Did the observed outcome match the stated criteria?
|
|
20
|
+
YES → `Produced` or `Verified` (depending on validation)
|
|
21
|
+
NO → `Failed`
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
## Examples
|
|
25
|
+
|
|
26
|
+
### Example 1 — `Attempted` (correct)
|
|
27
|
+
|
|
28
|
+
> Operator ran `blender --background --python script.py`. The terminal session was killed before completion. No output file exists. No exit code captured. Stdout truncated.
|
|
29
|
+
|
|
30
|
+
→ Outcome unknown. Label = `Attempted`. We don't know if it would have succeeded.
|
|
31
|
+
|
|
32
|
+
### Example 2 — `Failed` (correct)
|
|
33
|
+
|
|
34
|
+
> Operator ran `blender --background --python script.py`. Exit code = 1. Stderr shows `ImportError: bpy module not found`. No output file.
|
|
35
|
+
|
|
36
|
+
→ Outcome observed and confirmed not-success. Label = `Failed`.
|
|
37
|
+
|
|
38
|
+
### Example 3 — Common mistake
|
|
39
|
+
|
|
40
|
+
> Operator ran a render. The system became unresponsive for 10 minutes. Operator gave up and force-quit. No output file.
|
|
41
|
+
|
|
42
|
+
| ❌ Wrong | ✅ Correct |
|
|
43
|
+
|---|---|
|
|
44
|
+
| `Failed` (because nothing came out) | `Attempted` (force-quit ≠ observed failure; the render might have been close to completing) |
|
|
45
|
+
|
|
46
|
+
The honest label depends on **what the operator actually saw**, not on what the operator assumes.
|
|
47
|
+
|
|
48
|
+
### Example 4 — `Failed` after partial success
|
|
49
|
+
|
|
50
|
+
> Render completed and `preview.png` exists at 1920×1080. Validation: subject is centered (Pass), mood is wrong (Fail — should be cyberpunk neon, but rendered with default lighting).
|
|
51
|
+
|
|
52
|
+
→ Output exists but validation failed. Label = `Failed`. (Not `Produced`, because validation notes were recorded and they fail the acceptance criteria.)
|
|
53
|
+
|
|
54
|
+
### Example 5 — `Produced` after partial validation
|
|
55
|
+
|
|
56
|
+
> Render completed and `preview.png` exists. Operator did not run the validation checklist yet.
|
|
57
|
+
|
|
58
|
+
→ Output exists, no validation. Label = `Produced`. Move to `Verified` only after validation runs and passes.
|
|
59
|
+
|
|
60
|
+
## Anti-patterns
|
|
61
|
+
|
|
62
|
+
| ❌ Don't | ✅ Do |
|
|
63
|
+
|---|---|
|
|
64
|
+
| Default to `Failed` because output is missing | Use `Attempted` if outcome is unknown; `Failed` only with observed evidence |
|
|
65
|
+
| Use `Failed` interchangeably with `Not Run` | `Not Run` = no attempt happened; `Failed` = attempt happened and observed not-success |
|
|
66
|
+
| Mark `Produced` when validation already failed | If validation notes exist and they fail, label is `Failed`, not `Produced` |
|
|
67
|
+
| Re-run forever to escape `Attempted` | Sometimes evidence is genuinely lost; `Attempted` is a valid honest label |
|
|
68
|
+
|
|
69
|
+
## Routing
|
|
70
|
+
|
|
71
|
+
If you find yourself stuck choosing between `Attempted` and `Failed`:
|
|
72
|
+
|
|
73
|
+
1. Check `pre-handoff-verification` 7-point gate first. The gate may downgrade `Failed` to `Attempted` if check 3 (artifact paths exist) fails.
|
|
74
|
+
2. If the truth genuinely is unknown, prefer `Attempted` — it is the more conservative label and respects `evidence-before-done` law.
|
|
75
|
+
3. Run `blender-troubleshooting` Phase 1 to determine if the symptom is reproducible. Reproducibility evidence helps choose between the two labels.
|
|
@@ -0,0 +1,143 @@
|
|
|
1
|
+
# Evidence Record Templates
|
|
2
|
+
|
|
3
|
+
Use these templates when filling `docs/evals/path-X-...md`. Copy the relevant template, fill every field, save under `docs/evals/`.
|
|
4
|
+
|
|
5
|
+
## Template A — Path 1 (Lab MCP) read-only smoke
|
|
6
|
+
|
|
7
|
+
```md
|
|
8
|
+
# Path 1 Read-Only Smoke Test (<host option a/b>) — YYYY-MM-DD
|
|
9
|
+
|
|
10
|
+
Status: Pass / Available — Path 1 read-only access via <host>
|
|
11
|
+
Date: <YYYY-MM-DD>
|
|
12
|
+
Operator: <name or handle>
|
|
13
|
+
|
|
14
|
+
## Identity
|
|
15
|
+
|
|
16
|
+
| Field | Value |
|
|
17
|
+
|---|---|
|
|
18
|
+
| Path | Path 1 — Official Blender Lab MCP |
|
|
19
|
+
| Host option | (a) Anthropic Connector OR (b) manual MCP client |
|
|
20
|
+
| MCP host product + version | <e.g. Claude Desktop X.Y.Z> |
|
|
21
|
+
| Blender version (`blender --version`) | <verbatim> |
|
|
22
|
+
| Lab MCP add-on version | <e.g. mcp-1.0.0> |
|
|
23
|
+
| Lab MCP server source | <`.mcpb` filename or commit> |
|
|
24
|
+
|
|
25
|
+
## Tools called (read-only only)
|
|
26
|
+
|
|
27
|
+
| # | Tool name | Status | Notes |
|
|
28
|
+
|---|---|---|---|
|
|
29
|
+
| 1 | get_blendfile_summary_path_info | ok | |
|
|
30
|
+
| 2 | get_blendfile_summary_datablocks | ok | |
|
|
31
|
+
| 3 | get_objects_summary | ok | |
|
|
32
|
+
|
|
33
|
+
## No-mutation guarantee
|
|
34
|
+
|
|
35
|
+
- [x] No `execute_blender_code` was called with mutating Python.
|
|
36
|
+
- [x] No render was triggered.
|
|
37
|
+
- [x] No GLB export was triggered.
|
|
38
|
+
- [x] No `.blend` file save.
|
|
39
|
+
|
|
40
|
+
## Verdict
|
|
41
|
+
|
|
42
|
+
```txt
|
|
43
|
+
Path 1 read-only access via <host>: Pass / Available
|
|
44
|
+
Path 1 mutation / render / export: Not Run
|
|
45
|
+
Other paths: unchanged
|
|
46
|
+
Full runtime manual eval: Not Run
|
|
47
|
+
Runtime artifacts: Not Produced
|
|
48
|
+
v0.1.0 tag: depends on full eval
|
|
49
|
+
```
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
## Template B — Path 2 (community `mcp-for-blender`) read-only smoke
|
|
53
|
+
|
|
54
|
+
See `docs/evals/path-2-mcp-for-blender-readonly-template.md` (canonical template). Copy it, fill, save.
|
|
55
|
+
|
|
56
|
+
## Template C — Full runtime eval (mutation / render / export)
|
|
57
|
+
|
|
58
|
+
```md
|
|
59
|
+
# <Path> Full Runtime Eval — <recipe name> — YYYY-MM-DD
|
|
60
|
+
|
|
61
|
+
Status: Verified / Produced / Failed (per truth-label-decision-tree)
|
|
62
|
+
Date: <YYYY-MM-DD>
|
|
63
|
+
Operator: <name or handle>
|
|
64
|
+
|
|
65
|
+
## Identity
|
|
66
|
+
(same fields as Template A or B per chosen path)
|
|
67
|
+
|
|
68
|
+
## Recipe
|
|
69
|
+
- Source recipe: `docs/recipes/<recipe>.md`
|
|
70
|
+
- Brief: `<link to brief or quote>`
|
|
71
|
+
|
|
72
|
+
## Actions executed
|
|
73
|
+
|
|
74
|
+
| # | Action | Tool / command | Result |
|
|
75
|
+
|---|---|---|---|
|
|
76
|
+
| 1 | <e.g. create scene> | <tool name> | ok / fail |
|
|
77
|
+
| ... | | | |
|
|
78
|
+
|
|
79
|
+
## Generated artifacts
|
|
80
|
+
|
|
81
|
+
| Artifact | Output path | File exists | File size | Validation notes | Truth label |
|
|
82
|
+
|---|---|---|---|---|---|
|
|
83
|
+
| Render preview | `renders/preview-<date>.png` | yes / no | <bytes> | <subject framing centered, mood visible, …> | Verified |
|
|
84
|
+
| GLB | `exports/<name>-<date>.glb` | yes / no | <bytes> | <gltf-validator pass, web import test pass> | Verified |
|
|
85
|
+
|
|
86
|
+
## Validation against acceptance criteria
|
|
87
|
+
|
|
88
|
+
For each acceptance criterion in the brief:
|
|
89
|
+
|
|
90
|
+
| # | Criterion | Result | Evidence |
|
|
91
|
+
|---|---|---|---|
|
|
92
|
+
| 1 | <e.g. subject centered with negative space> | Pass | <screenshot + brief reference> |
|
|
93
|
+
| 2 | <e.g. GLB ≤ 10MB> | Pass | <file size> |
|
|
94
|
+
|
|
95
|
+
## Failure / caveat log
|
|
96
|
+
|
|
97
|
+
- <any errors, warnings, environment notes>
|
|
98
|
+
|
|
99
|
+
## Pre-handoff verification
|
|
100
|
+
|
|
101
|
+
- [ ] Ran `pre-handoff-verification` 7-point gate
|
|
102
|
+
- [ ] Verdict: Pass / Warn / Fail
|
|
103
|
+
- [ ] Downgrades applied (if any)
|
|
104
|
+
|
|
105
|
+
## Verdict
|
|
106
|
+
|
|
107
|
+
```txt
|
|
108
|
+
<Path> full runtime eval for <recipe>: Verified / Produced / Failed
|
|
109
|
+
v0.1.0 tag: <upgrade decision>
|
|
110
|
+
```
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
## Template D — Failed run
|
|
114
|
+
|
|
115
|
+
```md
|
|
116
|
+
# <Path> Failed Runtime Attempt — <recipe> — YYYY-MM-DD
|
|
117
|
+
|
|
118
|
+
Status: Failed
|
|
119
|
+
Date: <YYYY-MM-DD>
|
|
120
|
+
|
|
121
|
+
## What was attempted
|
|
122
|
+
<brief description>
|
|
123
|
+
|
|
124
|
+
## Where it failed (Phase from `blender-troubleshooting`)
|
|
125
|
+
- Phase 1 reproducibility: <count>
|
|
126
|
+
- Phase 2 narrowed input: <minimum reproducing case>
|
|
127
|
+
- Phase 3 root cause: <one-sentence>
|
|
128
|
+
- Phase 4 proposed fix: <one-sentence + handoff skill>
|
|
129
|
+
|
|
130
|
+
## Truth labels
|
|
131
|
+
- Render: Failed (or Attempted if no output)
|
|
132
|
+
- GLB: Failed
|
|
133
|
+
- Overall: Failed
|
|
134
|
+
|
|
135
|
+
## Next action
|
|
136
|
+
<route to which skill, with what>
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
## Saving conventions
|
|
140
|
+
|
|
141
|
+
- Filename: `path-<N>-[host-]-<recipe>-<YYYY-MM-DD>.md` under `docs/evals/`.
|
|
142
|
+
- Append the new file to the "Evidence and result index" in `docs/evals/README.md`.
|
|
143
|
+
- If the new evidence changes a verdict, update `docs/release-readiness.md`.
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
# Truth Label Decision Tree
|
|
2
|
+
|
|
3
|
+
Walk this tree to assign one of the 5 truth labels to each artifact item. Stop at the first matching condition.
|
|
4
|
+
|
|
5
|
+
```
|
|
6
|
+
1. Was a runtime action ATTEMPTED?
|
|
7
|
+
NO → label = `Not Run`. Stop.
|
|
8
|
+
YES → continue to 2.
|
|
9
|
+
|
|
10
|
+
2. Did the runtime action COMPLETE?
|
|
11
|
+
NO (failed mid-execution / errored out) → label = `Failed`. Stop.
|
|
12
|
+
YES → continue to 3.
|
|
13
|
+
|
|
14
|
+
3. Does the OUTPUT PATH exist on disk OR is the output VISIBLE in a viewer?
|
|
15
|
+
NO → label = `Attempted`. Stop.
|
|
16
|
+
YES → continue to 4.
|
|
17
|
+
|
|
18
|
+
4. Are VALIDATION NOTES recorded against acceptance criteria?
|
|
19
|
+
NO → label = `Produced`. Stop.
|
|
20
|
+
YES → continue to 5.
|
|
21
|
+
|
|
22
|
+
5. Did validation PASS the stated acceptance criteria?
|
|
23
|
+
NO → label = `Failed` (or `Produced` if validation is partial; choose conservatively).
|
|
24
|
+
YES → label = `Verified`. Stop.
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
## State transitions
|
|
28
|
+
|
|
29
|
+
Labels can only move in these directions:
|
|
30
|
+
|
|
31
|
+
| From | To | When |
|
|
32
|
+
|---|---|---|
|
|
33
|
+
| `Not Run` | `Attempted` | Runtime action started but evidence incomplete |
|
|
34
|
+
| `Not Run` | `Failed` | Runtime action started and confirmed failed |
|
|
35
|
+
| `Attempted` | `Produced` | Output path or visible output now exists |
|
|
36
|
+
| `Attempted` | `Failed` | Confirmed the action did not produce output |
|
|
37
|
+
| `Produced` | `Verified` | Validation notes recorded and pass acceptance criteria |
|
|
38
|
+
| `Produced` | `Failed` | Validation notes recorded and fail acceptance criteria |
|
|
39
|
+
| `Verified` | (downgrade only) | Per `pre-handoff-verification` rules |
|
|
40
|
+
|
|
41
|
+
## Forbidden transitions
|
|
42
|
+
|
|
43
|
+
| From | To | Why forbidden |
|
|
44
|
+
|---|---|---|
|
|
45
|
+
| `Not Run` | `Produced` directly | Cannot produce without an attempt |
|
|
46
|
+
| `Not Run` | `Verified` directly | Cannot validate non-existent output |
|
|
47
|
+
| `Attempted` | `Verified` directly | Verification requires output path + validation notes |
|
|
48
|
+
| Any | upgrade by `pre-handoff-verification` | That skill never upgrades; only downgrades or confirms |
|
|
49
|
+
|
|
50
|
+
## Common confusion
|
|
51
|
+
|
|
52
|
+
| Mistake | Correct label |
|
|
53
|
+
|---|---|
|
|
54
|
+
| "It rendered, so `Verified`" | `Produced` until validation notes exist |
|
|
55
|
+
| "I saw the file, so `Produced`" | Confirm path on disk explicitly; otherwise `Attempted` |
|
|
56
|
+
| "The smoke test passed, so render `Verified`" | Smoke covers read-only access; render is a separate claim |
|
|
57
|
+
| "Most checks passed, so `Verified`" | If any acceptance criterion failed → `Failed` or `Produced`, not `Verified` |
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# EVAL — resolution-aspect-decision
|
|
2
|
+
|
|
3
|
+
## Text-only eval prompt
|
|
4
|
+
Apply resolution-aspect-decision for a web hero retina (16:9, 2880×1620, downscale to 1920×1080 + 960×540).
|
|
5
|
+
|
|
6
|
+
## Expected behavior
|
|
7
|
+
- aspect 16:9
|
|
8
|
+
- resolution 2880×1620
|
|
9
|
+
- downscale margin yes
|
|
10
|
+
- multi-resolution outputs listed
|
|
11
|
+
- caveats
|
|
12
|
+
- handoff to render-export-evidence
|
|
13
|
+
|
|
14
|
+
## Pass / Warn / Fail criteria
|
|
15
|
+
- Pass: aspect + resolution + DPI + downscale margin + caveats + handoff
|
|
16
|
+
- Warn: borderline resolution
|
|
17
|
+
- Fail: aspect mismatch, upscale plan, "1080p" without aspect
|
|
18
|
+
|
|
19
|
+
## Sample passing response outline
|
|
20
|
+
- Consumer + aspect + resolution + DPI rows
|
|
21
|
+
- Multi-resolution outputs
|
|
22
|
+
- Caveats
|
|
23
|
+
|
|
24
|
+
## Sample failing response outline
|
|
25
|
+
- "1080p"
|
|
26
|
+
- No aspect
|
|
@@ -0,0 +1,246 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: resolution-aspect-decision
|
|
3
|
+
description: Pick the right render resolution + aspect ratio for the consumer use case before render; avoid render-then-crop and aspect mismatch.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# resolution-aspect-decision
|
|
7
|
+
|
|
8
|
+
## Purpose
|
|
9
|
+
Avoid the most common render planning mistake: rendering at one aspect / resolution and cropping or upscaling to fit. Pick the consumer's required output upfront.
|
|
10
|
+
|
|
11
|
+
## Quick start
|
|
12
|
+
- Identify the consumer use case and target placement (web hero, social feed, print, app asset).
|
|
13
|
+
- Pick the delivery aspect ratio (`W:H`) upfront so camera framing matches target placement.
|
|
14
|
+
- Pick exact render resolution (`W × H` in pixels) and `DPI / PPI` for print deliverables.
|
|
15
|
+
- Define per-stream resolution records if multiple delivery targets exist.
|
|
16
|
+
- Pin the record for the operator to enter in Blender scene render properties (no rendering, no post-render resizing).
|
|
17
|
+
|
|
18
|
+
## When to use
|
|
19
|
+
- before render
|
|
20
|
+
- when consumer requires specific aspect / resolution
|
|
21
|
+
- before composition planning (aspect drives composition rules)
|
|
22
|
+
|
|
23
|
+
## When not to use
|
|
24
|
+
<!-- blendops:generated:start exclusions -->
|
|
25
|
+
- after render is complete (no benefit) → use `../camera-composition/SKILL.md` (no benefit)
|
|
26
|
+
- pure modeling → use `../output-format-decision/SKILL.md` (Delegates out-of-scope requests to output-format-decision)
|
|
27
|
+
- internal preview-only renders (any reasonable size works) → use `../composition-quality-checker/SKILL.md` (any reasonable size works)
|
|
28
|
+
<!-- blendops:generated:end exclusions -->
|
|
29
|
+
|
|
30
|
+
## Trigger phrases
|
|
31
|
+
<!-- blendops:generated:start triggers -->
|
|
32
|
+
- "what resolution"
|
|
33
|
+
- "how big should the render be"
|
|
34
|
+
- "16:9 or square"
|
|
35
|
+
<!-- blendops:generated:end triggers -->
|
|
36
|
+
|
|
37
|
+
## Prerequisites / readiness
|
|
38
|
+
- Consumer use case and target placement are known (or ready to be confirmed with one question).
|
|
39
|
+
- Color config (`color-management-decision`), container/codec (`output-format-decision`), and engine (`cycles-vs-eevee-decision`) remain separate decisions owned by their respective skills.
|
|
40
|
+
|
|
41
|
+
## Input schema
|
|
42
|
+
|
|
43
|
+
### Required inputs
|
|
44
|
+
|
|
45
|
+
| Input | Why it is required |
|
|
46
|
+
|---|---|
|
|
47
|
+
| Consumer use case / placement | Determines target aspect ratio and required pixel dimensions |
|
|
48
|
+
| Print physical dimensions + target DPI/PPI (if print) | Required to compute exact pixel width and height (`W × H`) before render |
|
|
49
|
+
|
|
50
|
+
### Optional inputs
|
|
51
|
+
|
|
52
|
+
| Input | Use |
|
|
53
|
+
|---|---|
|
|
54
|
+
| Brand or platform delivery spec | Overrides category defaults with exact required `W × H` and aspect |
|
|
55
|
+
| Multi-stream delivery list | Produces separate per-stream resolution records for each target aspect/size |
|
|
56
|
+
| Render time / memory constraints | Flags caveats if high pixel counts require operator budget review |
|
|
57
|
+
|
|
58
|
+
### Assumptions to confirm
|
|
59
|
+
- The target machine and render budget can handle the pinned `W × H` resolution.
|
|
60
|
+
- Multiple aspect ratios will be framed via camera/scene setup rather than post-render cropping.
|
|
61
|
+
|
|
62
|
+
## Output schema
|
|
63
|
+
|
|
64
|
+
### Primary output
|
|
65
|
+
A 3-line resolution record per target stream:
|
|
66
|
+
1. Aspect ratio (`W:H`)
|
|
67
|
+
2. Render resolution (`W × H` pixels)
|
|
68
|
+
3. `DPI / PPI` (explicit value for print; `N/A (screen delivery)` for digital)
|
|
69
|
+
|
|
70
|
+
### Secondary output
|
|
71
|
+
- Per-stream resolution rules when delivering to multiple placements
|
|
72
|
+
- Caveats (hardware memory/time budget notes, framing handoff requirements)
|
|
73
|
+
|
|
74
|
+
### Evidence / caveat output
|
|
75
|
+
|
|
76
|
+
```txt
|
|
77
|
+
Runtime status: Not Run
|
|
78
|
+
Artifact status: Not Produced
|
|
79
|
+
Evidence used: <consumer spec, or "none">
|
|
80
|
+
Limitations: <unconfirmed platform specs, memory/time budget caveats>
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
> **Truth-state rule:** Pinning an aspect ratio and resolution is a planning decision and never produces a file. Default to `Runtime status: Not Run` and `Artifact status: Not Produced`. Truth states are downgrade-only and must never be upgraded by this skill.
|
|
84
|
+
|
|
85
|
+
## Required laws
|
|
86
|
+
- `../../laws/evidence-before-done.md`
|
|
87
|
+
- `../../laws/non-blender-user-language.md`
|
|
88
|
+
- `../../laws/no-arbitrary-python-interface.md`
|
|
89
|
+
- `../../laws/official-runtime-only.md`
|
|
90
|
+
|
|
91
|
+
## Official runtime boundary
|
|
92
|
+
|
|
93
|
+
Decision skill — does not render. Pins resolution + aspect; operator applies in scene render properties.
|
|
94
|
+
|
|
95
|
+
## Operating procedure
|
|
96
|
+
|
|
97
|
+
1. Identify the consumer use case and all target delivery streams.
|
|
98
|
+
2. Pin the required aspect ratio (`W:H`) for each stream from the consumer spec (or mark fallback defaults as assumptions to confirm).
|
|
99
|
+
3. Pin the exact render resolution (`W × H`) and `DPI / PPI` (for print) to be set directly in scene render properties—do not prescribe post-render resizing, cropping, or upscaling.
|
|
100
|
+
4. For multi-aspect deliverables, define a separate resolution record per stream and hand off camera framing to `camera-composition` and `composition-quality-checker`.
|
|
101
|
+
5. Record caveats and set truth states to `Runtime status: Not Run` and `Artifact status: Not Produced`.
|
|
102
|
+
|
|
103
|
+
## Decision tree
|
|
104
|
+
|
|
105
|
+
```txt
|
|
106
|
+
Consumer provides exact W × H (and DPI for print)?
|
|
107
|
+
→ Pin exact consumer spec; verify aspect ratio matches W × H.
|
|
108
|
+
Web / desktop widescreen placement?
|
|
109
|
+
→ Pin widescreen aspect (e.g., 16:9) and target display W × H from spec; DPI: N/A.
|
|
110
|
+
Social square placement?
|
|
111
|
+
→ Pin 1:1 aspect and platform-required W × H; DPI: N/A.
|
|
112
|
+
Mobile vertical / story placement?
|
|
113
|
+
→ Pin 9:16 aspect and platform-required W × H; DPI: N/A.
|
|
114
|
+
Ultrawide / cinematic banner?
|
|
115
|
+
→ Pin target banner aspect (e.g., 2.39:1) and spec W × H; DPI: N/A.
|
|
116
|
+
Print delivery (physical size + target DPI/PPI)?
|
|
117
|
+
→ Compute W × H = (physical inches × DPI) at exact print aspect ratio; pin W × H and DPI.
|
|
118
|
+
Multiple aspects required from one scene?
|
|
119
|
+
→ Emit one resolution record per stream; require per-aspect camera framing (never render-then-crop).
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
## Playbooks
|
|
123
|
+
|
|
124
|
+
### Playbook A: Single-stream digital hero
|
|
125
|
+
|
|
126
|
+
Pin the target aspect ratio (such as `16:9`) and exact delivery `W × H` required by the placement spec (`DPI / PPI: N/A`). Operator enters `W × H` in scene render properties before composition check.
|
|
127
|
+
|
|
128
|
+
### Playbook B: Multi-stream social campaign
|
|
129
|
+
|
|
130
|
+
Emit separate resolution records for each stream (for example, `9:16` vertical, `1:1` square, and `16:9` widescreen) with their respective target `W × H`. Hand off to `camera-composition` and `composition-quality-checker` so each aspect is properly framed in-camera rather than cropped post-render.
|
|
131
|
+
|
|
132
|
+
### Playbook C: Print deliverable
|
|
133
|
+
|
|
134
|
+
Obtain physical print dimensions and required print density (`DPI / PPI`). Calculate exact pixel dimensions (`W × H`), pin the native print aspect ratio, and require rendering directly at final print resolution without post-render upscaling.
|
|
135
|
+
|
|
136
|
+
### Playbook D: Multi-size asset family
|
|
137
|
+
|
|
138
|
+
When a consumer needs multiple distinct pixel dimensions, list each required `W × H` stream in the per-stream resolution record so the operator can plan native render outputs or hand off post-render image processing outside BlendOps.
|
|
139
|
+
|
|
140
|
+
## Mode handling
|
|
141
|
+
|
|
142
|
+
### Text-only mode
|
|
143
|
+
|
|
144
|
+
Return the resolution record, per-stream rules, caveats, and truth states (`Runtime status: Not Run`, `Artifact status: Not Produced`).
|
|
145
|
+
|
|
146
|
+
### Runtime-ready mode
|
|
147
|
+
|
|
148
|
+
Return the exact same resolution record and truth states (`Runtime status: Not Run`, `Artifact status: Not Produced`) for the operator to apply in scene render properties. Actual file verification after rendering belongs strictly to `render-export-evidence`.
|
|
149
|
+
|
|
150
|
+
### Blocked runtime mode
|
|
151
|
+
|
|
152
|
+
Return the resolution record, caveats, and truth states (`Runtime status: Not Run`, `Artifact status: Not Produced`).
|
|
153
|
+
|
|
154
|
+
## Validation checklist
|
|
155
|
+
|
|
156
|
+
* [ ] Aspect ratio (`W:H`) explicitly pinned for every output stream
|
|
157
|
+
* [ ] Render resolution (`W × H`) explicitly pinned for every output stream
|
|
158
|
+
* [ ] `DPI / PPI` specified for print outputs (or marked `N/A` for screen)
|
|
159
|
+
* [ ] No post-render resize, crop, or upscale steps prescribed
|
|
160
|
+
* [ ] Caveats and downgrade-only truth states (`Not Run` / `Not Produced`) included
|
|
161
|
+
|
|
162
|
+
## Pass / Warn / Fail rubric
|
|
163
|
+
|
|
164
|
+
| Verdict | Criteria |
|
|
165
|
+
| --- | --- |
|
|
166
|
+
| Pass | Aspect + `W × H` + `DPI / PPI` (if print) explicitly pinned per stream; matches consumer use case; no post-render crop/upscale assumed; truth states set to `Not Run` / `Not Produced`. |
|
|
167
|
+
| Warn | Aspect and `W × H` pinned using fallback assumptions because consumer spec was incomplete, or high pixel count risks memory/time budget limits. |
|
|
168
|
+
| Fail | Aspect omitted or mismatched to placement; relies on render-then-crop or post-render upscaling; upgrades truth state without verified evidence. |
|
|
169
|
+
|
|
170
|
+
## Failure handling
|
|
171
|
+
|
|
172
|
+
* Consumer spec unspecified → ask once for placement and target dimensions; if unavailable, state a fallback aspect and `W × H` explicitly as an unconfirmed assumption in Caveats.
|
|
173
|
+
* Multi-aspect request → emit separate per-stream resolution records and route framing to `camera-composition` and `composition-quality-checker` (never advise silent cropping).
|
|
174
|
+
* Resolution exceeds hardware memory or render time budget → flag in Caveats and recommend operator review before rendering.
|
|
175
|
+
|
|
176
|
+
## Troubleshooting
|
|
177
|
+
|
|
178
|
+
| Problem | Response |
|
|
179
|
+
|---|---|
|
|
180
|
+
| Final delivery looks soft | Probably upscaled from low-res; re-render at delivery res. |
|
|
181
|
+
| Aspect cropped wrong | Pre-render at correct aspect; do not crop. |
|
|
182
|
+
| Print too low-DPI | Render at delivery DPI from the start; do not upscale. |
|
|
183
|
+
| Consumer spec unclear | Ask once, then default per consumer category. |
|
|
184
|
+
|
|
185
|
+
## Best practices
|
|
186
|
+
|
|
187
|
+
* Always pin the delivery aspect ratio before camera setup so `camera-composition` and `composition-quality-checker` frame against the true boundary.
|
|
188
|
+
* Render directly at the required delivery resolution (`W × H`); keep post-render resizing, cropping, or format conversion outside this skill.
|
|
189
|
+
* For multi-aspect deliverables, output explicit per-stream records and require per-aspect camera validation.
|
|
190
|
+
* Pass the pinned resolution record to `render-export-evidence` so rendered files can be checked against target dimensions after execution.
|
|
191
|
+
|
|
192
|
+
## Good examples
|
|
193
|
+
|
|
194
|
+
* "Consumer: Web hero. Aspect: `16:9`. Resolution: `1920 × 1080` (per client spec). DPI/PPI: `N/A`. Multi-stream: none. Caveats: confirm whether high-DPI display tier requires a second native render stream. `Runtime status: Not Run`, `Artifact status: Not Produced`."
|
|
195
|
+
|
|
196
|
+
## Bad examples
|
|
197
|
+
- "1080p." — no aspect.
|
|
198
|
+
|
|
199
|
+
## User-facing response template
|
|
200
|
+
|
|
201
|
+
```txt
|
|
202
|
+
Consumer use case: <web hero / social / print / app asset / banner>
|
|
203
|
+
Aspect ratio: <W:H>
|
|
204
|
+
Resolution: <W H px ×>
|
|
205
|
+
DPI / PPI: <value if print, else "N/A">
|
|
206
|
+
|
|
207
|
+
Per-stream outputs (if multiple):
|
|
208
|
+
- <stream name>: <W:H>, <W H px ×>, DPI/PPI: <value or N/A>
|
|
209
|
+
|
|
210
|
+
Caveats: <budget notes, unconfirmed spec assumptions>
|
|
211
|
+
Runtime status: Not Run
|
|
212
|
+
Artifact status: Not Produced
|
|
213
|
+
Evidence used: <consumer spec or "none">
|
|
214
|
+
Limitations: <known gaps>
|
|
215
|
+
Next: camera-composition -> composition-quality-checker -> render-export-evidence
|
|
216
|
+
```
|
|
217
|
+
|
|
218
|
+
## Anti-patterns
|
|
219
|
+
- "1080p" without aspect.
|
|
220
|
+
- Render small, upscale large.
|
|
221
|
+
- Crop instead of re-frame for different aspects.
|
|
222
|
+
- "Default size" answers.
|
|
223
|
+
|
|
224
|
+
## Cross-skill handoff
|
|
225
|
+
<!-- blendops:generated:start handoffs -->
|
|
226
|
+
- [upstream_reference] Camera & composition planning (upstream framing setup) → `../camera-composition/SKILL.md`
|
|
227
|
+
- [progression] Composition framing validation against pinned aspect → `../composition-quality-checker/SKILL.md`
|
|
228
|
+
- [upstream_reference] Color configuration decision → `../color-management-decision/SKILL.md`
|
|
229
|
+
- [progression] Container / codec decision → `../output-format-decision/SKILL.md`
|
|
230
|
+
- [progression] Render engine decision → `../cycles-vs-eevee-decision/SKILL.md`
|
|
231
|
+
- [progression] Post-render saved file verification → `../render-export-evidence/SKILL.md`
|
|
232
|
+
<!-- blendops:generated:end handoffs -->
|
|
233
|
+
|
|
234
|
+
## Non-goals
|
|
235
|
+
|
|
236
|
+
* Never execute Blender or trigger renders.
|
|
237
|
+
* Never resize, crop, upscale, or convert images post-render (belongs outside this skill).
|
|
238
|
+
* Never choose file containers, codecs, or bit depths (`output-format-decision`).
|
|
239
|
+
* Never configure color spaces or HDR view transforms (`color-management-decision`).
|
|
240
|
+
* Never validate camera composition (`composition-quality-checker`) or verify rendered output files (`render-export-evidence`).
|
|
241
|
+
|
|
242
|
+
## References
|
|
243
|
+
- `references/aspect-defaults.md`
|
|
244
|
+
- `references/resolution-defaults.md`
|
|
245
|
+
- `references/print-vs-screen-rules.md`
|
|
246
|
+
- `../../docs/skill-system.md`
|