blendops 0.0.0-stage → 1.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +74 -0
- package/LICENSE +21 -0
- package/README.md +208 -2
- package/bin/blendops.mjs +4 -0
- package/bundles/claude-desktop-manual/BLENDOPS_SINGLE_FILE.md +78 -0
- package/bundles/claude-desktop-manual/IMPORT_STEPS.md +43 -0
- package/bundles/claude-desktop-manual/INSTALL_REPORT_TEMPLATE.md +13 -0
- package/bundles/claude-desktop-manual/README.md +70 -0
- package/bundles/claude-desktop-manual/SKILL.md +62 -0
- package/bundles/claude-desktop-manual/manifest.json +278 -0
- package/bundles/claude-desktop-manual/references/evidence-rules.md +13 -0
- package/bundles/claude-desktop-manual/references/install-boundary.md +13 -0
- package/bundles/claude-desktop-manual/references/laws/evidence-before-done.md +14 -0
- package/bundles/claude-desktop-manual/references/laws/no-arbitrary-python-interface.md +12 -0
- package/bundles/claude-desktop-manual/references/laws/non-blender-user-language.md +13 -0
- package/bundles/claude-desktop-manual/references/laws/official-runtime-only.md +20 -0
- package/bundles/claude-desktop-manual/references/packs/product-hero-v0.md +30 -0
- package/bundles/claude-desktop-manual/references/runtime-stacks.md +13 -0
- package/bundles/claude-desktop-manual/references/skill-map.md +36 -0
- package/bundles/claude-desktop-manual/references/skills/acceptance-criteria-builder.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/asset-discovery.md +73 -0
- package/bundles/claude-desktop-manual/references/skills/asset-fallback-strategy.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/asset-library-plan.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/asset-license-checker.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/asset-style-check.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/blender-brainstorming.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/blender-recipe-decomposer.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/blender-troubleshooting.md +78 -0
- package/bundles/claude-desktop-manual/references/skills/blendops-help.md +82 -0
- package/bundles/claude-desktop-manual/references/skills/bridge-conflicts.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/camera-composition.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/character-portrait.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/cli-appendix-job-outline.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/color-management-decision.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/composition-quality-checker.md +71 -0
- package/bundles/claude-desktop-manual/references/skills/cycles-vs-eevee-decision.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/done-criteria.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/environment-shot.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/glb-animation-handoff.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/glb-web-handoff.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/intent-to-3d-brief-writer.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/interior-scene.md +73 -0
- package/bundles/claude-desktop-manual/references/skills/lighting-material-plan.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/lighting-quality-checker.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/material-quality-checker.md +71 -0
- package/bundles/claude-desktop-manual/references/skills/mobile-glb-budget.md +73 -0
- package/bundles/claude-desktop-manual/references/skills/output-format-decision.md +63 -0
- package/bundles/claude-desktop-manual/references/skills/pack-prerequisite-checker.md +74 -0
- package/bundles/claude-desktop-manual/references/skills/path-one-host-outline.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/plain-language-response.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/polycount-budget-checker.md +71 -0
- package/bundles/claude-desktop-manual/references/skills/pre-handoff-verification.md +76 -0
- package/bundles/claude-desktop-manual/references/skills/preview-report.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/product-grid-scene-planner.md +72 -0
- package/bundles/claude-desktop-manual/references/skills/product-hero-scene-planner.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/r3f-component-plan.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/recipe-fit-assessor.md +75 -0
- package/bundles/claude-desktop-manual/references/skills/render-export-evidence.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/resolution-aspect-decision.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-attempt-report.md +67 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-path-picker.md +67 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-readiness.md +63 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-setup.md +63 -0
- package/bundles/claude-desktop-manual/references/skills/scene-readiness.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/scope-guard.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/stage-gates.md +91 -0
- package/bundles/claude-desktop-manual/references/skills/workflow-stage-router.md +67 -0
- package/bundles/generic-project-local/BLENDOPS.md +71 -0
- package/bundles/generic-project-local/INSTALL_REPORT_TEMPLATE.md +52 -0
- package/bundles/generic-project-local/README.md +73 -0
- package/bundles/generic-project-local/ROLLBACK.md +66 -0
- package/bundles/generic-project-local/manifest.json +66 -0
- package/bundles/skill-package/README.md +54 -0
- package/bundles/skill-package/blendops/LICENSE.txt +21 -0
- package/bundles/skill-package/blendops/SKILL.md +50 -0
- package/bundles/skill-package/blendops/agents/README.md +61 -0
- package/bundles/skill-package/blendops/agents/openai.yaml +4 -0
- package/bundles/skill-package/blendops/references/evidence-rules.md +17 -0
- package/bundles/skill-package/blendops/references/install-boundary.md +13 -0
- package/bundles/skill-package/blendops/references/law-evidence-before-done.md +12 -0
- package/bundles/skill-package/blendops/references/law-no-arbitrary-python-interface.md +7 -0
- package/bundles/skill-package/blendops/references/law-non-blender-user-language.md +8 -0
- package/bundles/skill-package/blendops/references/law-official-runtime-only.md +9 -0
- package/bundles/skill-package/blendops/references/pack-product-hero-v0.md +21 -0
- package/bundles/skill-package/blendops/references/runtime-stacks.md +13 -0
- package/bundles/skill-package/blendops/references/skill-acceptance-criteria-builder.md +51 -0
- package/bundles/skill-package/blendops/references/skill-asset-discovery.md +54 -0
- package/bundles/skill-package/blendops/references/skill-asset-fallback-strategy.md +48 -0
- package/bundles/skill-package/blendops/references/skill-asset-library-plan.md +51 -0
- package/bundles/skill-package/blendops/references/skill-asset-license-checker.md +51 -0
- package/bundles/skill-package/blendops/references/skill-asset-style-check.md +52 -0
- package/bundles/skill-package/blendops/references/skill-blender-brainstorming.md +43 -0
- package/bundles/skill-package/blendops/references/skill-blender-recipe-decomposer.md +48 -0
- package/bundles/skill-package/blendops/references/skill-blender-troubleshooting.md +59 -0
- package/bundles/skill-package/blendops/references/skill-blendops-help.md +62 -0
- package/bundles/skill-package/blendops/references/skill-bridge-conflicts.md +48 -0
- package/bundles/skill-package/blendops/references/skill-camera-composition.md +48 -0
- package/bundles/skill-package/blendops/references/skill-character-portrait.md +50 -0
- package/bundles/skill-package/blendops/references/skill-cli-appendix-job-outline.md +44 -0
- package/bundles/skill-package/blendops/references/skill-color-management-decision.md +50 -0
- package/bundles/skill-package/blendops/references/skill-composition-quality-checker.md +53 -0
- package/bundles/skill-package/blendops/references/skill-cycles-vs-eevee-decision.md +47 -0
- package/bundles/skill-package/blendops/references/skill-done-criteria.md +53 -0
- package/bundles/skill-package/blendops/references/skill-environment-shot.md +47 -0
- package/bundles/skill-package/blendops/references/skill-glb-animation-handoff.md +51 -0
- package/bundles/skill-package/blendops/references/skill-glb-web-handoff.md +51 -0
- package/bundles/skill-package/blendops/references/skill-intent-to-3d-brief-writer.md +50 -0
- package/bundles/skill-package/blendops/references/skill-interior-scene.md +54 -0
- package/bundles/skill-package/blendops/references/skill-lighting-material-plan.md +48 -0
- package/bundles/skill-package/blendops/references/skill-lighting-quality-checker.md +52 -0
- package/bundles/skill-package/blendops/references/skill-map.md +32 -0
- package/bundles/skill-package/blendops/references/skill-material-quality-checker.md +53 -0
- package/bundles/skill-package/blendops/references/skill-mobile-glb-budget.md +55 -0
- package/bundles/skill-package/blendops/references/skill-output-format-decision.md +46 -0
- package/bundles/skill-package/blendops/references/skill-pack-prerequisite-checker.md +56 -0
- package/bundles/skill-package/blendops/references/skill-path-one-host-outline.md +48 -0
- package/bundles/skill-package/blendops/references/skill-plain-language-response.md +53 -0
- package/bundles/skill-package/blendops/references/skill-polycount-budget-checker.md +53 -0
- package/bundles/skill-package/blendops/references/skill-pre-handoff-verification.md +57 -0
- package/bundles/skill-package/blendops/references/skill-preview-report.md +45 -0
- package/bundles/skill-package/blendops/references/skill-product-grid-scene-planner.md +54 -0
- package/bundles/skill-package/blendops/references/skill-product-hero-scene-planner.md +51 -0
- package/bundles/skill-package/blendops/references/skill-r3f-component-plan.md +48 -0
- package/bundles/skill-package/blendops/references/skill-recipe-fit-assessor.md +57 -0
- package/bundles/skill-package/blendops/references/skill-render-export-evidence.md +51 -0
- package/bundles/skill-package/blendops/references/skill-resolution-aspect-decision.md +48 -0
- package/bundles/skill-package/blendops/references/skill-runtime-attempt-report.md +49 -0
- package/bundles/skill-package/blendops/references/skill-runtime-path-picker.md +49 -0
- package/bundles/skill-package/blendops/references/skill-runtime-readiness.md +45 -0
- package/bundles/skill-package/blendops/references/skill-runtime-setup.md +45 -0
- package/bundles/skill-package/blendops/references/skill-scene-readiness.md +48 -0
- package/bundles/skill-package/blendops/references/skill-scope-guard.md +44 -0
- package/bundles/skill-package/blendops/references/skill-stage-gates.md +73 -0
- package/bundles/skill-package/blendops/references/skill-workflow-stage-router.md +49 -0
- package/docs/README.md +276 -0
- package/docs/examples/glb-web-handoff/README.md +174 -0
- package/docs/examples/glb-web-handoff/r3f-glb-viewer.tsx +320 -0
- package/docs/examples/glb-web-handoff/threejs-glb-viewer.mjs +709 -0
- package/docs/knowledge-and-recipe-catalog.md +236 -0
- package/docs/recipes/README.md +27 -0
- package/docs/recipes/cyberpunk-shoe-hero.md +97 -0
- package/docs/workflows/README.md +14 -0
- package/docs/workflows/full-non-blender-user-workflow.md +210 -0
- package/docs/workflows/product-hero-workflow.md +92 -0
- package/laws/README.md +32 -0
- package/laws/evidence-before-done.md +37 -0
- package/laws/no-arbitrary-python-interface.md +32 -0
- package/laws/non-blender-user-language.md +32 -0
- package/laws/official-runtime-only.md +78 -0
- package/package.json +103 -4
- package/packs/README.md +11 -0
- package/packs/product-hero-v0/PACK.md +114 -0
- package/registry/catalog-index.json +21344 -0
- package/registry/compatibility-matrix.json +533 -0
- package/registry/contract-context-fields.json +391 -0
- package/registry/knowledge-catalog.json +4648 -0
- package/registry/knowledge-sources.json +438 -0
- package/registry/recipe-catalog.json +2565 -0
- package/registry/runtime-capability-policy.json +525 -0
- package/registry/runtime-operations.json +4468 -0
- package/registry/skills.json +10231 -0
- package/registry/workflow-graph.json +7390 -0
- package/schemas/adapter-compatibility-matrix.schema.json +166 -0
- package/schemas/contract-context-fields.schema.json +147 -0
- package/schemas/execution-plan.schema.json +325 -0
- package/schemas/glb-web-handoff-manifest.schema.json +744 -0
- package/schemas/knowledge-record.schema.json +460 -0
- package/schemas/knowledge-source-registry.schema.json +268 -0
- package/schemas/operation-execution-ledger.schema.json +348 -0
- package/schemas/recipe-record.schema.json +469 -0
- package/schemas/runtime-capability-policy.schema.json +184 -0
- package/schemas/runtime-evidence-packet.schema.json +211 -0
- package/schemas/runtime-operations.schema.json +535 -0
- package/schemas/runtime-qualification-report.schema.json +540 -0
- package/schemas/runtime-session.schema.json +350 -0
- package/schemas/scene-spec.schema.json +624 -0
- package/schemas/skill-contract.schema.json +402 -0
- package/schemas/skill-eval.schema.json +509 -0
- package/scripts/build-knowledge-catalog.mjs +2376 -0
- package/scripts/compile-scene-plan.mjs +1945 -0
- package/scripts/export-claude-skills.mjs +634 -0
- package/scripts/generate-glb-handoff-report.mjs +2376 -0
- package/scripts/inspect-glb.mjs +1627 -0
- package/scripts/install-skills.mjs +5443 -0
- package/scripts/runtime-orchestrator.mjs +7713 -0
- package/scripts/validate-capability-policy.mjs +531 -0
- package/scripts/validate-evidence-packet.mjs +256 -0
- package/skills/README.md +315 -0
- package/skills/_template/SKILL.md +296 -0
- package/skills/acceptance-criteria-builder/EVAL.md +25 -0
- package/skills/acceptance-criteria-builder/SKILL.md +257 -0
- package/skills/acceptance-criteria-builder/contract.json +205 -0
- package/skills/acceptance-criteria-builder/references/brief-to-criteria-mapper.md +22 -0
- package/skills/acceptance-criteria-builder/references/checklist-patterns.md +22 -0
- package/skills/acceptance-criteria-builder/references/evidence-hook-rules.md +19 -0
- package/skills/asset-discovery/EVAL.md +81 -0
- package/skills/asset-discovery/SKILL.md +252 -0
- package/skills/asset-discovery/contract.json +291 -0
- package/skills/asset-discovery/references/asset-strategy-decision-tree.md +40 -0
- package/skills/asset-discovery/references/budget-reconciliation-patterns.md +54 -0
- package/skills/asset-discovery/references/license-confidence-table.md +41 -0
- package/skills/asset-fallback-strategy/EVAL.md +34 -0
- package/skills/asset-fallback-strategy/SKILL.md +248 -0
- package/skills/asset-fallback-strategy/contract.json +190 -0
- package/skills/asset-fallback-strategy/references/drop-with-caveat-rules.md +36 -0
- package/skills/asset-fallback-strategy/references/fallback-option-types.md +55 -0
- package/skills/asset-fallback-strategy/references/scoring-rubric.md +61 -0
- package/skills/asset-library-plan/EVAL.md +28 -0
- package/skills/asset-library-plan/SKILL.md +263 -0
- package/skills/asset-library-plan/contract.json +177 -0
- package/skills/asset-library-plan/references/folder-structure-rules.md +63 -0
- package/skills/asset-library-plan/references/metadata-schema.md +62 -0
- package/skills/asset-library-plan/references/naming-rules.md +51 -0
- package/skills/asset-license-checker/EVAL.md +33 -0
- package/skills/asset-license-checker/SKILL.md +245 -0
- package/skills/asset-license-checker/contract.json +172 -0
- package/skills/asset-license-checker/references/attribution-rendering-patterns.md +48 -0
- package/skills/asset-license-checker/references/common-license-mapping.md +39 -0
- package/skills/asset-license-checker/references/license-source-rules.md +38 -0
- package/skills/asset-style-check/EVAL.md +26 -0
- package/skills/asset-style-check/SKILL.md +238 -0
- package/skills/asset-style-check/contract.json +251 -0
- package/skills/asset-style-check/references/drift-classification.md +40 -0
- package/skills/asset-style-check/references/intentional-mixed-style.md +39 -0
- package/skills/asset-style-check/references/style-axes.md +46 -0
- package/skills/blender-brainstorming/EVAL.md +79 -0
- package/skills/blender-brainstorming/SKILL.md +228 -0
- package/skills/blender-brainstorming/contract.json +115 -0
- package/skills/blender-brainstorming/references/alternative-scoping-templates.md +43 -0
- package/skills/blender-brainstorming/references/clarification-patterns.md +29 -0
- package/skills/blender-brainstorming/references/intent-summary-style-guide.md +25 -0
- package/skills/blender-recipe-decomposer/EVAL.md +35 -0
- package/skills/blender-recipe-decomposer/SKILL.md +258 -0
- package/skills/blender-recipe-decomposer/contract.json +152 -0
- package/skills/blender-recipe-decomposer/references/dependency-patterns.md +53 -0
- package/skills/blender-recipe-decomposer/references/recipe-grouping-rules.md +58 -0
- package/skills/blender-recipe-decomposer/references/recipe-naming-rules.md +44 -0
- package/skills/blender-troubleshooting/EVAL.md +78 -0
- package/skills/blender-troubleshooting/SKILL.md +263 -0
- package/skills/blender-troubleshooting/contract.json +352 -0
- package/skills/blender-troubleshooting/references/common-symptom-playbooks.md +51 -0
- package/skills/blender-troubleshooting/references/divergence-routing-table.md +23 -0
- package/skills/blender-troubleshooting/references/four-phase-template.md +51 -0
- package/skills/blendops-help/EVAL.md +67 -0
- package/skills/blendops-help/SKILL.md +312 -0
- package/skills/blendops-help/contract.json +229 -0
- package/skills/blendops-help/references/lifecycle-phases.md +91 -0
- package/skills/blendops-help/references/quick-start-prompts.md +65 -0
- package/skills/blendops-help/references/routing-decision-tree.md +57 -0
- package/skills/bridge-conflicts/EVAL.md +83 -0
- package/skills/bridge-conflicts/SKILL.md +246 -0
- package/skills/bridge-conflicts/contract.json +145 -0
- package/skills/bridge-conflicts/references/bridge-state-matrix-template.md +82 -0
- package/skills/bridge-conflicts/references/conflict-playbooks.md +99 -0
- package/skills/bridge-conflicts/references/do-not-reminders.md +42 -0
- package/skills/camera-composition/EVAL.md +32 -0
- package/skills/camera-composition/SKILL.md +196 -0
- package/skills/camera-composition/contract.json +180 -0
- package/skills/camera-composition/references/camera-presets.md +30 -0
- package/skills/camera-composition/references/camera-rubric.md +24 -0
- package/skills/camera-composition/references/hero-composition-patterns.md +24 -0
- package/skills/camera-composition/references/web-layout-negative-space.md +25 -0
- package/skills/character-portrait/EVAL.md +42 -0
- package/skills/character-portrait/SKILL.md +245 -0
- package/skills/character-portrait/contract.json +205 -0
- package/skills/character-portrait/references/portrait-framing-rules.md +39 -0
- package/skills/character-portrait/references/portrait-lighting-patterns.md +50 -0
- package/skills/character-portrait/references/style-consistency-rules.md +41 -0
- package/skills/cli-appendix-job-outline/EVAL.md +26 -0
- package/skills/cli-appendix-job-outline/SKILL.md +252 -0
- package/skills/cli-appendix-job-outline/contract.json +147 -0
- package/skills/cli-appendix-job-outline/references/flag-order-reminders.md +16 -0
- package/skills/cli-appendix-job-outline/references/job-type-matrix.md +13 -0
- package/skills/cli-appendix-job-outline/references/stateless-limitations.md +12 -0
- package/skills/color-management-decision/EVAL.md +28 -0
- package/skills/color-management-decision/SKILL.md +254 -0
- package/skills/color-management-decision/contract.json +162 -0
- package/skills/color-management-decision/references/look-comparison.md +44 -0
- package/skills/color-management-decision/references/per-channel-rules.md +49 -0
- package/skills/color-management-decision/references/pipeline-mapping.md +47 -0
- package/skills/composition-quality-checker/EVAL.md +38 -0
- package/skills/composition-quality-checker/SKILL.md +260 -0
- package/skills/composition-quality-checker/contract.json +221 -0
- package/skills/composition-quality-checker/references/aspect-ratio-rules.md +37 -0
- package/skills/composition-quality-checker/references/composition-rules.md +58 -0
- package/skills/composition-quality-checker/references/headroom-leadroom-rules.md +46 -0
- package/skills/cycles-vs-eevee-decision/EVAL.md +26 -0
- package/skills/cycles-vs-eevee-decision/SKILL.md +249 -0
- package/skills/cycles-vs-eevee-decision/contract.json +142 -0
- package/skills/cycles-vs-eevee-decision/references/engine-feature-matrix.md +39 -0
- package/skills/cycles-vs-eevee-decision/references/gpu-device-rules.md +51 -0
- package/skills/cycles-vs-eevee-decision/references/samples-by-quality.md +53 -0
- package/skills/done-criteria/EVAL.md +33 -0
- package/skills/done-criteria/SKILL.md +225 -0
- package/skills/done-criteria/contract.json +199 -0
- package/skills/done-criteria/references/done-vs-perfect.md +56 -0
- package/skills/done-criteria/references/out-of-scope-patterns.md +50 -0
- package/skills/done-criteria/references/stop-condition-templates.md +39 -0
- package/skills/environment-shot/EVAL.md +44 -0
- package/skills/environment-shot/SKILL.md +237 -0
- package/skills/environment-shot/contract.json +162 -0
- package/skills/environment-shot/references/depth-layering-rules.md +49 -0
- package/skills/environment-shot/references/time-and-weather-rules.md +35 -0
- package/skills/environment-shot/references/wide-shot-camera-rules.md +51 -0
- package/skills/glb-animation-handoff/EVAL.md +39 -0
- package/skills/glb-animation-handoff/SKILL.md +271 -0
- package/skills/glb-animation-handoff/contract.json +247 -0
- package/skills/glb-animation-handoff/references/animation-types.md +36 -0
- package/skills/glb-animation-handoff/references/transition-rules.md +55 -0
- package/skills/glb-animation-handoff/references/web-stack-caveats.md +40 -0
- package/skills/glb-web-handoff/EVAL.md +33 -0
- package/skills/glb-web-handoff/SKILL.md +212 -0
- package/skills/glb-web-handoff/contract.json +171 -0
- package/skills/glb-web-handoff/references/artifact-status-language.md +26 -0
- package/skills/glb-web-handoff/references/glb-handoff-checklist.md +30 -0
- package/skills/glb-web-handoff/references/performance-caveats.md +26 -0
- package/skills/glb-web-handoff/references/threejs-r3f-handoff.md +28 -0
- package/skills/intent-to-3d-brief-writer/EVAL.md +82 -0
- package/skills/intent-to-3d-brief-writer/SKILL.md +238 -0
- package/skills/intent-to-3d-brief-writer/contract.json +195 -0
- package/skills/intent-to-3d-brief-writer/references/acceptance-criteria-patterns.md +46 -0
- package/skills/intent-to-3d-brief-writer/references/eight-slot-template.md +123 -0
- package/skills/intent-to-3d-brief-writer/references/mixed-audience-handling.md +39 -0
- package/skills/interior-scene/EVAL.md +44 -0
- package/skills/interior-scene/SKILL.md +261 -0
- package/skills/interior-scene/contract.json +277 -0
- package/skills/interior-scene/references/furniture-layout-rules.md +51 -0
- package/skills/interior-scene/references/interior-architecture-rules.md +47 -0
- package/skills/interior-scene/references/interior-camera-rules.md +47 -0
- package/skills/lighting-material-plan/EVAL.md +32 -0
- package/skills/lighting-material-plan/SKILL.md +194 -0
- package/skills/lighting-material-plan/contract.json +213 -0
- package/skills/lighting-material-plan/references/cyberpunk-lookdev.md +22 -0
- package/skills/lighting-material-plan/references/lighting-patterns.md +30 -0
- package/skills/lighting-material-plan/references/material-portability.md +25 -0
- package/skills/lighting-material-plan/references/reflective-floor-pattern.md +22 -0
- package/skills/lighting-material-plan/references/web-material-simplification.md +23 -0
- package/skills/lighting-quality-checker/EVAL.md +41 -0
- package/skills/lighting-quality-checker/SKILL.md +247 -0
- package/skills/lighting-quality-checker/contract.json +187 -0
- package/skills/lighting-quality-checker/references/hdri-balance-rules.md +48 -0
- package/skills/lighting-quality-checker/references/intensity-ranges.md +73 -0
- package/skills/lighting-quality-checker/references/shadow-softness-rules.md +38 -0
- package/skills/material-quality-checker/EVAL.md +40 -0
- package/skills/material-quality-checker/SKILL.md +261 -0
- package/skills/material-quality-checker/contract.json +244 -0
- package/skills/material-quality-checker/references/consumer-stack-rules.md +62 -0
- package/skills/material-quality-checker/references/pbr-sanity-rules.md +78 -0
- package/skills/material-quality-checker/references/texture-budget-rules.md +48 -0
- package/skills/mobile-glb-budget/EVAL.md +40 -0
- package/skills/mobile-glb-budget/SKILL.md +264 -0
- package/skills/mobile-glb-budget/contract.json +309 -0
- package/skills/mobile-glb-budget/references/budget-tiers.md +30 -0
- package/skills/mobile-glb-budget/references/degradation-plan.md +34 -0
- package/skills/mobile-glb-budget/references/violation-rules.md +43 -0
- package/skills/output-format-decision/EVAL.md +27 -0
- package/skills/output-format-decision/SKILL.md +222 -0
- package/skills/output-format-decision/contract.json +179 -0
- package/skills/output-format-decision/references/bit-depth-rules.md +56 -0
- package/skills/output-format-decision/references/compression-tradeoffs.md +62 -0
- package/skills/output-format-decision/references/format-decision-matrix.md +34 -0
- package/skills/pack-prerequisite-checker/EVAL.md +26 -0
- package/skills/pack-prerequisite-checker/SKILL.md +272 -0
- package/skills/pack-prerequisite-checker/contract.json +214 -0
- package/skills/pack-prerequisite-checker/references/blocked-start-playbook.md +21 -0
- package/skills/pack-prerequisite-checker/references/pack-readiness-template.md +38 -0
- package/skills/pack-prerequisite-checker/references/prerequisite-matrix.md +20 -0
- package/skills/path-one-host-outline/EVAL.md +26 -0
- package/skills/path-one-host-outline/SKILL.md +251 -0
- package/skills/path-one-host-outline/contract.json +167 -0
- package/skills/path-one-host-outline/references/connector-vs-manual-matrix.md +21 -0
- package/skills/path-one-host-outline/references/host-checklist-template.md +35 -0
- package/skills/path-one-host-outline/references/lab-addon-reminders.md +12 -0
- package/skills/plain-language-response/EVAL.md +33 -0
- package/skills/plain-language-response/SKILL.md +194 -0
- package/skills/plain-language-response/contract.json +242 -0
- package/skills/plain-language-response/references/caveat-language.md +25 -0
- package/skills/plain-language-response/references/plain-language-patterns.md +30 -0
- package/skills/plain-language-response/references/stakeholder-friendly-examples.md +30 -0
- package/skills/plain-language-response/references/status-summary-templates.md +50 -0
- package/skills/polycount-budget-checker/EVAL.md +40 -0
- package/skills/polycount-budget-checker/SKILL.md +251 -0
- package/skills/polycount-budget-checker/contract.json +196 -0
- package/skills/polycount-budget-checker/references/instance-counting-rules.md +39 -0
- package/skills/polycount-budget-checker/references/per-mesh-rules.md +43 -0
- package/skills/polycount-budget-checker/references/topology-hints.md +56 -0
- package/skills/pre-handoff-verification/EVAL.md +84 -0
- package/skills/pre-handoff-verification/SKILL.md +252 -0
- package/skills/pre-handoff-verification/contract.json +295 -0
- package/skills/pre-handoff-verification/references/downgrade-rules.md +39 -0
- package/skills/pre-handoff-verification/references/seven-point-checklist.md +46 -0
- package/skills/pre-handoff-verification/references/text-only-mode-handling.md +36 -0
- package/skills/preview-report/EVAL.md +39 -0
- package/skills/preview-report/SKILL.md +254 -0
- package/skills/preview-report/contract.json +141 -0
- package/skills/preview-report/references/handoff-recipients.md +41 -0
- package/skills/preview-report/references/report-schema.md +60 -0
- package/skills/preview-report/references/truth-label-rules.md +36 -0
- package/skills/product-grid-scene-planner/EVAL.md +42 -0
- package/skills/product-grid-scene-planner/SKILL.md +246 -0
- package/skills/product-grid-scene-planner/contract.json +257 -0
- package/skills/product-grid-scene-planner/references/grid-consistency-rules.md +53 -0
- package/skills/product-grid-scene-planner/references/grid-layout-rules.md +42 -0
- package/skills/product-grid-scene-planner/references/grid-output-naming-rules.md +52 -0
- package/skills/product-hero-scene-planner/EVAL.md +33 -0
- package/skills/product-hero-scene-planner/SKILL.md +227 -0
- package/skills/product-hero-scene-planner/contract.json +228 -0
- package/skills/product-hero-scene-planner/references/clarification-patterns.md +24 -0
- package/skills/product-hero-scene-planner/references/cyberpunk-shoe-example.md +28 -0
- package/skills/product-hero-scene-planner/references/product-hero-playbooks.md +22 -0
- package/skills/product-hero-scene-planner/references/scene-plan-schema.md +35 -0
- package/skills/r3f-component-plan/EVAL.md +43 -0
- package/skills/r3f-component-plan/SKILL.md +290 -0
- package/skills/r3f-component-plan/contract.json +171 -0
- package/skills/r3f-component-plan/references/component-shape-patterns.md +54 -0
- package/skills/r3f-component-plan/references/suspense-placement-rules.md +50 -0
- package/skills/r3f-component-plan/references/usegltf-caching-rules.md +53 -0
- package/skills/recipe-fit-assessor/EVAL.md +28 -0
- package/skills/recipe-fit-assessor/SKILL.md +266 -0
- package/skills/recipe-fit-assessor/contract.json +220 -0
- package/skills/recipe-fit-assessor/references/recipe-catalog.md +30 -0
- package/skills/recipe-fit-assessor/references/scope-gap-rules.md +27 -0
- package/skills/recipe-fit-assessor/references/workflow-recommendation-template.md +34 -0
- package/skills/render-export-evidence/EVAL.md +86 -0
- package/skills/render-export-evidence/SKILL.md +339 -0
- package/skills/render-export-evidence/contract.json +206 -0
- package/skills/render-export-evidence/references/attempted-vs-failed-rubric.md +75 -0
- package/skills/render-export-evidence/references/evidence-record-templates.md +143 -0
- package/skills/render-export-evidence/references/truth-label-decision-tree.md +57 -0
- package/skills/resolution-aspect-decision/EVAL.md +26 -0
- package/skills/resolution-aspect-decision/SKILL.md +246 -0
- package/skills/resolution-aspect-decision/contract.json +160 -0
- package/skills/resolution-aspect-decision/references/aspect-defaults.md +41 -0
- package/skills/resolution-aspect-decision/references/print-vs-screen-rules.md +58 -0
- package/skills/resolution-aspect-decision/references/resolution-defaults.md +64 -0
- package/skills/runtime-attempt-report/EVAL.md +26 -0
- package/skills/runtime-attempt-report/SKILL.md +268 -0
- package/skills/runtime-attempt-report/contract.json +176 -0
- package/skills/runtime-attempt-report/references/attempt-record-template.md +49 -0
- package/skills/runtime-attempt-report/references/triage-next-steps.md +15 -0
- package/skills/runtime-attempt-report/references/truth-label-blocks.md +27 -0
- package/skills/runtime-path-picker/EVAL.md +26 -0
- package/skills/runtime-path-picker/SKILL.md +268 -0
- package/skills/runtime-path-picker/contract.json +191 -0
- package/skills/runtime-path-picker/references/anti-patterns.md +14 -0
- package/skills/runtime-path-picker/references/decision-tree.md +29 -0
- package/skills/runtime-path-picker/references/path-constraints-table.md +18 -0
- package/skills/runtime-readiness/EVAL.md +33 -0
- package/skills/runtime-readiness/SKILL.md +218 -0
- package/skills/runtime-readiness/contract.json +190 -0
- package/skills/runtime-readiness/references/blocker-report-template.md +28 -0
- package/skills/runtime-readiness/references/evidence-examples.md +23 -0
- package/skills/runtime-readiness/references/readiness-matrix.md +46 -0
- package/skills/runtime-setup/EVAL.md +33 -0
- package/skills/runtime-setup/SKILL.md +209 -0
- package/skills/runtime-setup/contract.json +171 -0
- package/skills/runtime-setup/references/runtime-option-decision-tree.md +28 -0
- package/skills/runtime-setup/references/setup-summary-template.md +33 -0
- package/skills/runtime-setup/references/source-confidence-labels.md +23 -0
- package/skills/scene-readiness/EVAL.md +33 -0
- package/skills/scene-readiness/SKILL.md +195 -0
- package/skills/scene-readiness/contract.json +198 -0
- package/skills/scene-readiness/references/blocker-catalog.md +24 -0
- package/skills/scene-readiness/references/not-run-handling.md +22 -0
- package/skills/scene-readiness/references/quality-rubric.md +23 -0
- package/skills/scene-readiness/references/verdict-language.md +22 -0
- package/skills/scope-guard/EVAL.md +33 -0
- package/skills/scope-guard/SKILL.md +222 -0
- package/skills/scope-guard/contract.json +171 -0
- package/skills/scope-guard/references/options-language-template.md +51 -0
- package/skills/scope-guard/references/recurring-creep-patterns.md +55 -0
- package/skills/scope-guard/references/scope-addition-classification.md +55 -0
- package/skills/stage-gates/EVAL.md +40 -0
- package/skills/stage-gates/SKILL.md +257 -0
- package/skills/stage-gates/contract.json +490 -0
- package/skills/stage-gates/references/failed-gate-handling.md +42 -0
- package/skills/stage-gates/references/gate-template.md +46 -0
- package/skills/stage-gates/references/stage-decomposition-patterns.md +55 -0
- package/skills/workflow-stage-router/EVAL.md +25 -0
- package/skills/workflow-stage-router/SKILL.md +259 -0
- package/skills/workflow-stage-router/contract.json +150 -0
- package/skills/workflow-stage-router/references/milestone-model.md +20 -0
- package/skills/workflow-stage-router/references/routing-decision-tree.md +32 -0
- package/skills/workflow-stage-router/references/stage-handoff-template.md +37 -0
- package/skills.sh.json +102 -0
|
@@ -0,0 +1,249 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: cycles-vs-eevee-decision
|
|
3
|
+
description: Pick Cycles, Eevee, or Workbench for a render based on quality bar, time budget, and feature requirements (caustics, subsurface, etc.). Note: Eevee was named Eevee Next on Blender 4.2-4.x only.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# cycles-vs-eevee-decision
|
|
7
|
+
|
|
8
|
+
## Purpose
|
|
9
|
+
Pick the render engine upfront based on quality + time tradeoff and feature requirements. Avoid the "use Cycles always" / "Eevee is faster" oversimplifications.
|
|
10
|
+
|
|
11
|
+
## Quick start
|
|
12
|
+
- Name the use case (hero / preview / animation / lookdev / flat clay).
|
|
13
|
+
- Evaluate required rendering features (caustics / subsurface scattering / volumetrics / global illumination accuracy).
|
|
14
|
+
- Evaluate time budget per frame and available hardware.
|
|
15
|
+
- Pick the engine: `Cycles`, `Eevee`, or `Workbench` (note: Eevee used the name Eevee Next and token `BLENDER_EEVEE_NEXT` on Blender 4.2–4.x only; it is `Eevee` with token `BLENDER_EEVEE` on 4.0–4.1 and 5.x).
|
|
16
|
+
- Pin the 4-item engine record: engine + samples + GPU device (if applicable) + caveats.
|
|
17
|
+
|
|
18
|
+
## When to use
|
|
19
|
+
- before render
|
|
20
|
+
- when feature support drives engine choice
|
|
21
|
+
- when time vs quality tradeoff matters
|
|
22
|
+
- when previous render was wrong engine
|
|
23
|
+
|
|
24
|
+
## When not to use
|
|
25
|
+
<!-- blendops:generated:start exclusions -->
|
|
26
|
+
- for a known repeat render (engine already chosen) → use `../lighting-material-plan/SKILL.md` (engine already chosen)
|
|
27
|
+
- for non-render work (modeling / animation prep) → use `../output-format-decision/SKILL.md` (modeling / animation prep)
|
|
28
|
+
<!-- blendops:generated:end exclusions -->
|
|
29
|
+
|
|
30
|
+
## Trigger phrases
|
|
31
|
+
<!-- blendops:generated:start triggers -->
|
|
32
|
+
- "Cycles or Eevee"
|
|
33
|
+
- "what render engine"
|
|
34
|
+
- "is Eevee enough"
|
|
35
|
+
- "render is too slow"
|
|
36
|
+
<!-- blendops:generated:end triggers -->
|
|
37
|
+
|
|
38
|
+
## Prerequisites / readiness
|
|
39
|
+
- use case known
|
|
40
|
+
- features needed known (caustics? SSS? volumetrics?)
|
|
41
|
+
- machine specs known (GPU? memory?)
|
|
42
|
+
- time budget known
|
|
43
|
+
|
|
44
|
+
## Input schema
|
|
45
|
+
|
|
46
|
+
### Required inputs
|
|
47
|
+
|
|
48
|
+
| Input | Why it is required |
|
|
49
|
+
|---|---|
|
|
50
|
+
| Use case | Hero vs preview drives quality threshold |
|
|
51
|
+
| Feature requirements | Determines engine compatibility |
|
|
52
|
+
| Time budget per frame | Drives engine + samples |
|
|
53
|
+
|
|
54
|
+
### Optional inputs
|
|
55
|
+
|
|
56
|
+
| Input | Use |
|
|
57
|
+
|---|---|
|
|
58
|
+
| GPU available | Cycles GPU dramatically faster |
|
|
59
|
+
| Reference quality bar | Calibrate samples |
|
|
60
|
+
|
|
61
|
+
### Assumptions to confirm
|
|
62
|
+
- The user accepts the tradeoff (Eevee is fast but approximates GI; Cycles is slow but accurate).
|
|
63
|
+
- Multi-engine workflow (Eevee preview, Cycles final) is common and valid.
|
|
64
|
+
|
|
65
|
+
## Output schema
|
|
66
|
+
|
|
67
|
+
### Primary output
|
|
68
|
+
A 4-item engine record per use case:
|
|
69
|
+
1. Engine (`Cycles` / `Eevee` / `Workbench`, plus version token `BLENDER_EEVEE` for 4.0–4.1 and 5.x or `BLENDER_EEVEE_NEXT` for 4.2–4.x if a token is needed)
|
|
70
|
+
2. Samples (pinned target sample count from consumer/project spec or reference table)
|
|
71
|
+
3. GPU device (pinned target compute device for the operator to set in scene render properties, or `CPU` fallback)
|
|
72
|
+
4. Caveats (feature tradeoffs, time budget notes, hardware assumptions)
|
|
73
|
+
|
|
74
|
+
### Secondary output
|
|
75
|
+
- Per-stream engine record if using a multi-engine workflow (for example, `Eevee` for lookdev preview and `Cycles` for final hero render)
|
|
76
|
+
- Evidence and truth-state block
|
|
77
|
+
|
|
78
|
+
### Evidence / caveat output
|
|
79
|
+
|
|
80
|
+
```txt
|
|
81
|
+
Runtime status: Not Run
|
|
82
|
+
Artifact status: Not Produced
|
|
83
|
+
Evidence used: <project spec, hardware spec, or "none">
|
|
84
|
+
Limitations: <unconfirmed hardware/time budget, denoiser/render optimization deferred>
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
> **Truth-state rule:** Pinning an engine is a planning decision and never produces a render. Default to `Runtime status: Not Run` and `Artifact status: Not Produced`. Truth states are downgrade-only and must never be upgraded by this skill.
|
|
88
|
+
|
|
89
|
+
## Required laws
|
|
90
|
+
- `../../laws/evidence-before-done.md`
|
|
91
|
+
- `../../laws/non-blender-user-language.md`
|
|
92
|
+
- `../../laws/no-arbitrary-python-interface.md`
|
|
93
|
+
- `../../laws/official-runtime-only.md`
|
|
94
|
+
|
|
95
|
+
## Official runtime boundary
|
|
96
|
+
|
|
97
|
+
Decision skill — does not run Blender. Pins config; operator applies in scene render properties.
|
|
98
|
+
|
|
99
|
+
## Operating procedure
|
|
100
|
+
|
|
101
|
+
1. Identify the use case, required shading/lighting features, and per-frame time budget.
|
|
102
|
+
2. Consult `references/engine-feature-matrix.md` to match feature requirements to `Cycles`, `Eevee`, or `Workbench`.
|
|
103
|
+
3. If specifying an internal Blender engine token for `Eevee`, use `BLENDER_EEVEE` on Blender 4.0–4.1 and 5.x, and `BLENDER_EEVEE_NEXT` on Blender 4.2–4.x only. Never present `Eevee Next` as the current name.
|
|
104
|
+
4. Pin target samples per `references/samples-by-quality.md` and GPU/CPU compute device per `references/gpu-device-rules.md` (without configuring denoisers, tile sizes, or engine-specific optimizations).
|
|
105
|
+
5. List caveats and set truth states to `Runtime status: Not Run` and `Artifact status: Not Produced`.
|
|
106
|
+
6. Hand off sibling decisions (`color-management-decision`, `output-format-decision`, `resolution-aspect-decision`) and post-render verification (`render-export-evidence`).
|
|
107
|
+
|
|
108
|
+
## Decision tree
|
|
109
|
+
|
|
110
|
+
```txt
|
|
111
|
+
Need path-traced caustics, complex refraction, or physically accurate volumetric/indirect light?
|
|
112
|
+
→ Cycles
|
|
113
|
+
Final hero quality where time budget and GPU/CPU hardware allow path tracing?
|
|
114
|
+
→ Cycles
|
|
115
|
+
Real-time viewport preview, fast iteration, or lookdev?
|
|
116
|
+
→ Eevee (token: BLENDER_EEVEE on 4.0-4.1 & 5.x; BLENDER_EEVEE_NEXT on 4.2-4.x)
|
|
117
|
+
High-frame-count animation with a tight per-frame time budget where approximated GI is acceptable?
|
|
118
|
+
→ Eevee (or Cycles only if confirmed hardware + time budget accommodate path tracing)
|
|
119
|
+
Stylized / non-photorealistic raster look?
|
|
120
|
+
→ Eevee or Workbench
|
|
121
|
+
Pure flat silhouette, matcap, or clay check?
|
|
122
|
+
→ Workbench
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
## Playbooks
|
|
126
|
+
|
|
127
|
+
### Playbook A: Hero path-traced render
|
|
128
|
+
|
|
129
|
+
Pick `Cycles`, pin sample count from `references/samples-by-quality.md` and target GPU device from `references/gpu-device-rules.md`, and note time-budget caveats. Leave denoiser and advanced render-setting tuning out of scope.
|
|
130
|
+
|
|
131
|
+
### Playbook B: Fast preview / lookdev pass
|
|
132
|
+
|
|
133
|
+
Pick `Eevee` (`BLENDER_EEVEE` on 4.0–4.1 and 5.x; `BLENDER_EEVEE_NEXT` on 4.2–4.x), pin preview sample count and GPU execution, and note global illumination approximation caveats.
|
|
134
|
+
|
|
135
|
+
### Playbook C: Tight-budget multi-frame animation
|
|
136
|
+
|
|
137
|
+
Pick `Eevee` when per-frame time budget rules out path tracing and feature requirements do not mandate `Cycles`; document any refraction or indirect-lighting tradeoffs in Caveats.
|
|
138
|
+
|
|
139
|
+
### Playbook D: Stylized or clay pass
|
|
140
|
+
|
|
141
|
+
Pick `Eevee` or `Workbench` based on whether shader evaluation (`Eevee`) or flat/matcap inspection (`Workbench`) is required; pin sample count and hardware target.
|
|
142
|
+
|
|
143
|
+
## Mode handling
|
|
144
|
+
|
|
145
|
+
### Text-only mode
|
|
146
|
+
|
|
147
|
+
Return the engine record (engine + samples + GPU device + caveats) with `Runtime status: Not Run` and `Artifact status: Not Produced`.
|
|
148
|
+
|
|
149
|
+
### Runtime-ready mode
|
|
150
|
+
|
|
151
|
+
Return the exact same engine record with `Runtime status: Not Run` and `Artifact status: Not Produced` for the operator to apply in scene render properties. Never claim a render preview was run or verified; actual rendered file verification belongs to `render-export-evidence`.
|
|
152
|
+
|
|
153
|
+
### Blocked runtime mode
|
|
154
|
+
|
|
155
|
+
Return the engine record, caveats, and truth states (`Runtime status: Not Run`, `Artifact status: Not Produced`).
|
|
156
|
+
|
|
157
|
+
## Validation checklist
|
|
158
|
+
|
|
159
|
+
* [ ] Use case, feature needs, and time budget evaluated
|
|
160
|
+
* [ ] Engine chosen (`Cycles`, `Eevee`, or `Workbench`—never presenting `Eevee Next` as the current name)
|
|
161
|
+
* [ ] Correct engine token used if version-specific token is referenced (`BLENDER_EEVEE` on 4.0–4.1/5.x; `BLENDER_EEVEE_NEXT` on 4.2–4.x)
|
|
162
|
+
* [ ] Samples and GPU/CPU device pinned without bundling denoiser or tile optimizations
|
|
163
|
+
* [ ] Caveats and downgrade-only truth states (`Not Run` / `Not Produced`) included
|
|
164
|
+
|
|
165
|
+
## Pass / Warn / Fail rubric
|
|
166
|
+
|
|
167
|
+
| Verdict | Criteria |
|
|
168
|
+
|---|---|
|
|
169
|
+
| Pass | Engine matches features + quality + time; samples appropriate; caveats explicit. |
|
|
170
|
+
| Warn | Borderline call (Eevee for hero with weak GI rendering); time budget tight. |
|
|
171
|
+
| Fail | Engine does not support required feature (Eevee for caustics); samples severely under-budget; "use Cycles" for animation that needs Eevee. |
|
|
172
|
+
|
|
173
|
+
## Failure handling
|
|
174
|
+
- Required feature unsupported → switch to engine that supports it; reject the impossible config.
|
|
175
|
+
- Time budget impossible at chosen samples → either lower samples (Warn) or change engine.
|
|
176
|
+
- GPU not available → Cycles falls back to CPU (much slower); recommend Eevee for previews.
|
|
177
|
+
|
|
178
|
+
## Troubleshooting
|
|
179
|
+
|
|
180
|
+
| Problem | Response |
|
|
181
|
+
| --- | --- |
|
|
182
|
+
| `Cycles` exceeds per-frame time budget | Confirm GPU device is pinned over CPU, lower pinned sample target within quality tolerance, or switch non-final passes to `Eevee`. |
|
|
183
|
+
| `Eevee` lacks required caustics or accurate refraction | Switch those shots to `Cycles` and document the per-frame time impact in Caveats. |
|
|
184
|
+
| Indirect bounce lighting in `Eevee` misses hero realism bar | Switch the final pass to `Cycles` while keeping `Eevee` for lookdev iteration. |
|
|
185
|
+
| Volumetric lighting lacks path-traced accuracy in `Eevee` | Pin `Cycles` for shots requiring physically accurate volumetric light transport. |
|
|
186
|
+
|
|
187
|
+
## Best practices
|
|
188
|
+
|
|
189
|
+
* Use `Eevee` for fast lookdev/iteration and `Cycles` for final path-traced hero delivery when both speed and physical accuracy matter.
|
|
190
|
+
* Always use current `Eevee` naming, noting `Eevee Next` (`BLENDER_EEVEE_NEXT`) only when targeting Blender 4.2–4.x.
|
|
191
|
+
* Keep this decision strictly to `engine + samples + GPU device + caveats`—leave denoiser specifics, tile sizes, color management, output format, and resolution to their dedicated skills or operator tuning.
|
|
192
|
+
* Pass the pinned engine record downstream so `render-export-evidence` can record it alongside verified output artifacts after rendering.
|
|
193
|
+
|
|
194
|
+
## Good examples
|
|
195
|
+
|
|
196
|
+
* "Use case: Hero product render requiring accurate glass refraction. Engine: `Cycles`. Samples: pinned per project quality tier. GPU device: pinned to available hardware GPU. Caveats: higher per-frame render time than `Eevee`; denoiser specifics out of scope. `Runtime status: Not Run`, `Artifact status: Not Produced`."
|
|
197
|
+
|
|
198
|
+
## Bad examples
|
|
199
|
+
- "Just use Cycles." — no context.
|
|
200
|
+
|
|
201
|
+
## User-facing response template
|
|
202
|
+
|
|
203
|
+
```txt
|
|
204
|
+
Use case: <hero / preview / animation / lookdev / stylized>
|
|
205
|
+
Feature requirements: <caustics, SSS, volumetrics, GI, etc.>
|
|
206
|
+
Time budget per frame: <target time budget>
|
|
207
|
+
Blender version (if token needed): <4.0-4.1 / 4.2-4.x / 5.x>
|
|
208
|
+
|
|
209
|
+
Engine config:
|
|
210
|
+
Engine: <Cycles / Eevee / Workbench>
|
|
211
|
+
Engine token (if needed): <BLENDER_EEVEE (4.0-4.1, 5.x) / BLENDER_EEVEE_NEXT (4.2-4.x)>
|
|
212
|
+
Samples: <pinned sample count>
|
|
213
|
+
GPU device: <pinned GPU device or CPU fallback>
|
|
214
|
+
Caveats: <tradeoffs, time/hardware assumptions>
|
|
215
|
+
|
|
216
|
+
Runtime status: Not Run
|
|
217
|
+
Artifact status: Not Produced
|
|
218
|
+
Evidence used: <spec inputs or "none">
|
|
219
|
+
Limitations: <known gaps; denoiser and render-setting optimization out of scope>
|
|
220
|
+
Next: color-management-decision -> resolution-aspect-decision -> output-format-decision -> render-export-evidence
|
|
221
|
+
```
|
|
222
|
+
|
|
223
|
+
## Anti-patterns
|
|
224
|
+
- "Always Cycles" without considering time.
|
|
225
|
+
- "Always Eevee" without considering features.
|
|
226
|
+
- Skipping GPU device choice.
|
|
227
|
+
- Choosing engine for animation without time-budget math.
|
|
228
|
+
|
|
229
|
+
## Cross-skill handoff
|
|
230
|
+
<!-- blendops:generated:start handoffs -->
|
|
231
|
+
- [upstream_reference] Lighting and material setup aligned with engine choice → `../lighting-material-plan/SKILL.md`
|
|
232
|
+
- [upstream_reference] Color configuration decision → `../color-management-decision/SKILL.md`
|
|
233
|
+
- [progression] Output container / codec decision → `../output-format-decision/SKILL.md`
|
|
234
|
+
- [upstream_reference] Render resolution and aspect ratio decision → `../resolution-aspect-decision/SKILL.md`
|
|
235
|
+
- [progression] Post-render output verification → `../render-export-evidence/SKILL.md`
|
|
236
|
+
<!-- blendops:generated:end handoffs -->
|
|
237
|
+
|
|
238
|
+
## Non-goals
|
|
239
|
+
|
|
240
|
+
* Never run Blender or execute a render or preview render.
|
|
241
|
+
* Never configure denoiser specifics, tile sizes, light probe volumes, or render-setting optimizations beyond `engine + samples + GPU device + caveats`.
|
|
242
|
+
* Never decide color management (`color-management-decision`), container/codec (`output-format-decision`), or resolution/aspect (`resolution-aspect-decision`).
|
|
243
|
+
* Never verify rendered files (`render-export-evidence`).
|
|
244
|
+
|
|
245
|
+
## References
|
|
246
|
+
- `references/engine-feature-matrix.md`
|
|
247
|
+
- `references/samples-by-quality.md`
|
|
248
|
+
- `references/gpu-device-rules.md`
|
|
249
|
+
- `../../docs/skill-system.md`
|
|
@@ -0,0 +1,142 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "../../schemas/skill-contract.schema.json",
|
|
3
|
+
"id": "cycles-vs-eevee-decision",
|
|
4
|
+
"version": "1.0.0",
|
|
5
|
+
"category": "render-and-output-decisions",
|
|
6
|
+
"role": "render-engine-tradeoff-selector",
|
|
7
|
+
"purpose": "Pick Cycles, Eevee, or Workbench for a render based on quality bar, time budget, and feature requirements (caustics, subsurface, etc.). Note: Eevee was named Eevee Next on Blender 4.2-4.x only.",
|
|
8
|
+
"capabilityTier": "L0",
|
|
9
|
+
"triggers": [
|
|
10
|
+
"Cycles or Eevee",
|
|
11
|
+
"what render engine",
|
|
12
|
+
"is Eevee enough",
|
|
13
|
+
"render is too slow"
|
|
14
|
+
],
|
|
15
|
+
"exclusions": [
|
|
16
|
+
{
|
|
17
|
+
"condition": "for a known repeat render (engine already chosen)",
|
|
18
|
+
"delegateTo": "lighting-material-plan",
|
|
19
|
+
"reason": "engine already chosen"
|
|
20
|
+
},
|
|
21
|
+
{
|
|
22
|
+
"condition": "for non-render work (modeling / animation prep)",
|
|
23
|
+
"delegateTo": "output-format-decision",
|
|
24
|
+
"reason": "modeling / animation prep"
|
|
25
|
+
}
|
|
26
|
+
],
|
|
27
|
+
"inputs": {
|
|
28
|
+
"required": [
|
|
29
|
+
{
|
|
30
|
+
"name": "deliverable_use_case",
|
|
31
|
+
"type": "string",
|
|
32
|
+
"description": "Whether the output is a final hero still, lookdev preview, animation turntable, or baked GLB source"
|
|
33
|
+
},
|
|
34
|
+
{
|
|
35
|
+
"name": "optical_feature_requirements",
|
|
36
|
+
"type": "array",
|
|
37
|
+
"description": "Required optical features (refraction, caustics, Volumetrics, SSS, soft area shadows)"
|
|
38
|
+
},
|
|
39
|
+
{
|
|
40
|
+
"name": "render_time_and_hardware_budget",
|
|
41
|
+
"type": "string",
|
|
42
|
+
"description": "Per-frame render time ceiling and available GPU/CPU compute posture"
|
|
43
|
+
}
|
|
44
|
+
],
|
|
45
|
+
"optional": [
|
|
46
|
+
{
|
|
47
|
+
"name": "blender_version_token",
|
|
48
|
+
"type": "string",
|
|
49
|
+
"description": "Target Blender version governing BLENDER_EEVEE vs BLENDER_EEVEE_NEXT naming"
|
|
50
|
+
}
|
|
51
|
+
]
|
|
52
|
+
},
|
|
53
|
+
"outputs": {
|
|
54
|
+
"primary": [
|
|
55
|
+
"selected_render_engine_record",
|
|
56
|
+
"sample_and_denoiser_targets",
|
|
57
|
+
"engine_tradeoff_and_fallback_caveats"
|
|
58
|
+
],
|
|
59
|
+
"truthStatePolicy": {
|
|
60
|
+
"runtimeDefault": "Not Run",
|
|
61
|
+
"artifactDefault": "Not Produced",
|
|
62
|
+
"mutationRule": "downgrade_only"
|
|
63
|
+
}
|
|
64
|
+
},
|
|
65
|
+
"handoffs": [
|
|
66
|
+
{
|
|
67
|
+
"target": "lighting-material-plan",
|
|
68
|
+
"type": "upstream_reference",
|
|
69
|
+
"label": "Lighting and material setup aligned with engine choice",
|
|
70
|
+
"when": {
|
|
71
|
+
"all": [
|
|
72
|
+
{
|
|
73
|
+
"field": "brief.locked",
|
|
74
|
+
"operator": "equals",
|
|
75
|
+
"value": true
|
|
76
|
+
},
|
|
77
|
+
{
|
|
78
|
+
"field": "stage.current",
|
|
79
|
+
"operator": "equals",
|
|
80
|
+
"value": "lookdev_planning"
|
|
81
|
+
}
|
|
82
|
+
]
|
|
83
|
+
}
|
|
84
|
+
},
|
|
85
|
+
{
|
|
86
|
+
"target": "color-management-decision",
|
|
87
|
+
"type": "upstream_reference",
|
|
88
|
+
"label": "Color configuration decision",
|
|
89
|
+
"when": {
|
|
90
|
+
"all": [
|
|
91
|
+
{
|
|
92
|
+
"field": "decision.colorLocked",
|
|
93
|
+
"operator": "equals",
|
|
94
|
+
"value": false
|
|
95
|
+
}
|
|
96
|
+
]
|
|
97
|
+
}
|
|
98
|
+
},
|
|
99
|
+
{
|
|
100
|
+
"target": "output-format-decision",
|
|
101
|
+
"type": "progression",
|
|
102
|
+
"label": "Output container / codec decision",
|
|
103
|
+
"when": {
|
|
104
|
+
"all": [
|
|
105
|
+
{
|
|
106
|
+
"field": "decision.formatLocked",
|
|
107
|
+
"operator": "equals",
|
|
108
|
+
"value": false
|
|
109
|
+
}
|
|
110
|
+
]
|
|
111
|
+
}
|
|
112
|
+
},
|
|
113
|
+
{
|
|
114
|
+
"target": "resolution-aspect-decision",
|
|
115
|
+
"type": "upstream_reference",
|
|
116
|
+
"label": "Render resolution and aspect ratio decision",
|
|
117
|
+
"when": {
|
|
118
|
+
"all": [
|
|
119
|
+
{
|
|
120
|
+
"field": "decision.aspectLocked",
|
|
121
|
+
"operator": "equals",
|
|
122
|
+
"value": false
|
|
123
|
+
}
|
|
124
|
+
]
|
|
125
|
+
}
|
|
126
|
+
},
|
|
127
|
+
{
|
|
128
|
+
"target": "render-export-evidence",
|
|
129
|
+
"type": "progression",
|
|
130
|
+
"label": "Post-render output verification",
|
|
131
|
+
"when": {
|
|
132
|
+
"all": [
|
|
133
|
+
{
|
|
134
|
+
"field": "stage.current",
|
|
135
|
+
"operator": "equals",
|
|
136
|
+
"value": "post_execution_audit"
|
|
137
|
+
}
|
|
138
|
+
]
|
|
139
|
+
}
|
|
140
|
+
}
|
|
141
|
+
]
|
|
142
|
+
}
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
# Engine feature matrix
|
|
2
|
+
|
|
3
|
+
| Feature | Cycles | Eevee Next (Blender 4.2+) | Eevee (legacy) | Workbench |
|
|
4
|
+
|---|---|---|---|---|
|
|
5
|
+
| Path-traced GI (accurate) | Y | Approximated | Approximated | N |
|
|
6
|
+
| Caustics | Y (with caustic flag) | Approximate | Approximate | N |
|
|
7
|
+
| Subsurface Scattering | Y (accurate) | Y (approximate) | Y (approximate) | N |
|
|
8
|
+
| Volumetrics with light interaction | Y | Y (improved Eevee Next) | Y (limited) | N |
|
|
9
|
+
| Refraction (accurate IOR) | Y | Y (with shadows) | Limited | N |
|
|
10
|
+
| Hair / particles fully | Y | Y | Y (limited) | Y (basic) |
|
|
11
|
+
| Real-time preview | N | Y | Y | Y |
|
|
12
|
+
| Denoiser | OPTIX / OIDN | Built-in | N | N |
|
|
13
|
+
| Render times | Slow (minutes) | Fast (seconds) | Fast (seconds) | Instant |
|
|
14
|
+
| GPU support | OPTIX / CUDA / HIP / METAL / ONEAPI / CPU | GPU rasterization | GPU rasterization | GPU |
|
|
15
|
+
|
|
16
|
+
## When each engine wins
|
|
17
|
+
|
|
18
|
+
| Use case | Engine |
|
|
19
|
+
|---|---|
|
|
20
|
+
| Final hero with realistic light | Cycles |
|
|
21
|
+
| Lookdev / iteration | Eevee Next |
|
|
22
|
+
| Animation with tight budget | Eevee Next (or Cycles GPU + denoiser if budget allows) |
|
|
23
|
+
| Stylized / non-PBR | Eevee Next |
|
|
24
|
+
| Clay / wireframe / shading test | Workbench |
|
|
25
|
+
| HDR scene with caustics | Cycles |
|
|
26
|
+
| Real-time interactive preview | Eevee Next |
|
|
27
|
+
|
|
28
|
+
## Eevee Next vs Eevee (legacy)
|
|
29
|
+
|
|
30
|
+
Eevee Next (Blender 4.2+) significantly improves:
|
|
31
|
+
- GI quality (Light Probe Volumes)
|
|
32
|
+
- Volumetrics
|
|
33
|
+
- Refraction
|
|
34
|
+
- Render quality at default settings
|
|
35
|
+
|
|
36
|
+
Use Eevee Next over legacy Eevee for any new project on Blender 4.2+.
|
|
37
|
+
|
|
38
|
+
## Related skill
|
|
39
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
# GPU device rules (Cycles)
|
|
2
|
+
|
|
3
|
+
## Device options
|
|
4
|
+
|
|
5
|
+
| Device | Hardware | Speed (relative) |
|
|
6
|
+
|---|---|---|
|
|
7
|
+
| OPTIX | NVIDIA RTX (RTX 20 / 30 / 40 / Ada / Hopper) | Fastest (RT cores accelerate) |
|
|
8
|
+
| CUDA | NVIDIA (any modern) | Fast (no RT cores acceleration) |
|
|
9
|
+
| METAL | Apple Silicon (M1 / M2 / M3 / M4) | Fast on Apple GPU |
|
|
10
|
+
| HIP | AMD (RDNA 2 / 3 / 4) | Fast |
|
|
11
|
+
| ONEAPI | Intel Arc / iGPU | Moderate |
|
|
12
|
+
| CPU | Any CPU | Slowest (10-50x slower than GPU) |
|
|
13
|
+
|
|
14
|
+
## Choosing on a multi-GPU / iGPU system
|
|
15
|
+
|
|
16
|
+
- OPTIX > CUDA on the same NVIDIA card; always pick OPTIX if available.
|
|
17
|
+
- METAL on Apple Silicon; never CPU-only on Apple Silicon for Cycles.
|
|
18
|
+
- HIP on modern AMD; CPU fallback if older AMD.
|
|
19
|
+
- Combine GPU+CPU rendering: append `+CPU` to GPU device (e.g., `OPTIX+CPU`); only marginal improvement on most systems.
|
|
20
|
+
|
|
21
|
+
## Memory considerations
|
|
22
|
+
|
|
23
|
+
- GPU rendering is limited by VRAM.
|
|
24
|
+
- Out-of-VRAM symptoms: render fails / falls back to CPU / artifacts.
|
|
25
|
+
- With OPTIX / CUDA / HIP, Blender can spill to system RAM with performance hit.
|
|
26
|
+
- Reduce: texture sizes, mesh polycount, hair density.
|
|
27
|
+
|
|
28
|
+
## CLI usage
|
|
29
|
+
|
|
30
|
+
For headless / CI:
|
|
31
|
+
|
|
32
|
+
```
|
|
33
|
+
blender -b file.blend -P script.py -- --cycles-device OPTIX
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
The `-- --cycles-device` syntax separates Blender args from CLI override.
|
|
37
|
+
|
|
38
|
+
## Memory + samples interaction
|
|
39
|
+
|
|
40
|
+
- High samples + high resolution + complex scene → may exceed VRAM.
|
|
41
|
+
- Reduce one of: samples, resolution, scene complexity.
|
|
42
|
+
- Or render in tiles (Cycles supports tile-based rendering).
|
|
43
|
+
|
|
44
|
+
## Common errors
|
|
45
|
+
|
|
46
|
+
- "CUDA out of memory" → reduce textures or resolution.
|
|
47
|
+
- "OPTIX not available" → driver / Blender version mismatch; verify Blender version supports OPTIX.
|
|
48
|
+
- "Slow Cycles on RTX" → forgot to enable OPTIX; verify Render properties → Device.
|
|
49
|
+
|
|
50
|
+
## Related skill
|
|
51
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
# Samples by quality bar
|
|
2
|
+
|
|
3
|
+
## Cycles
|
|
4
|
+
|
|
5
|
+
| Quality bar | Samples | Time per frame (typical) |
|
|
6
|
+
|---|---|---|
|
|
7
|
+
| Preview / draft | 32 | < 1 minute |
|
|
8
|
+
| Lookdev | 64-128 | 1-3 minutes |
|
|
9
|
+
| Animation frame | 64-256 (with denoiser) | 1-5 minutes |
|
|
10
|
+
| Hero final | 128-512 (with denoiser) | 5-30 minutes |
|
|
11
|
+
| Print / archival final | 512-2048+ | 30 minutes - hours |
|
|
12
|
+
|
|
13
|
+
Always enable denoiser (OPTIX or Open Image Denoise) for animation and final.
|
|
14
|
+
|
|
15
|
+
## Eevee Next
|
|
16
|
+
|
|
17
|
+
| Quality bar | Render samples | Light Probe samples | Time per frame |
|
|
18
|
+
|---|---|---|---|
|
|
19
|
+
| Preview / draft | Default 16 | Default 16 | < 1 second |
|
|
20
|
+
| Lookdev | 32-64 | 32-64 | 1-3 seconds |
|
|
21
|
+
| Animation | 32-64 | 64-128 | 1-5 seconds |
|
|
22
|
+
| Hero final (Eevee suitable) | 128-256 | 128-256 | 5-30 seconds |
|
|
23
|
+
|
|
24
|
+
## Eevee (legacy)
|
|
25
|
+
|
|
26
|
+
Similar to Eevee Next but without the improved GI sampling. Adjust accordingly.
|
|
27
|
+
|
|
28
|
+
## Adaptive sampling (Cycles)
|
|
29
|
+
|
|
30
|
+
Cycles supports adaptive sampling — render fewer samples in low-noise regions. Enable for hero work to reduce time without quality loss.
|
|
31
|
+
|
|
32
|
+
Threshold:
|
|
33
|
+
- 0.01 = high quality, slow
|
|
34
|
+
- 0.05 = balanced
|
|
35
|
+
- 0.1 = fast, more noise
|
|
36
|
+
|
|
37
|
+
## Per-feature sample considerations
|
|
38
|
+
|
|
39
|
+
- Caustics need extra samples (256+).
|
|
40
|
+
- Volumetrics need extra samples or higher light probe quality.
|
|
41
|
+
- Subsurface scattering benefits from higher samples.
|
|
42
|
+
- Stylized / NPR work can run with fewer samples.
|
|
43
|
+
|
|
44
|
+
## Verifying sample count
|
|
45
|
+
|
|
46
|
+
After test render, look for:
|
|
47
|
+
- Noise / grain in dark areas → samples too low.
|
|
48
|
+
- Splotchy / patchy lighting → samples too low or denoiser too aggressive.
|
|
49
|
+
- Smooth gradients → samples adequate.
|
|
50
|
+
- Acceptable but not perfect → likely good for animation.
|
|
51
|
+
|
|
52
|
+
## Related skill
|
|
53
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
# EVAL — done-criteria
|
|
2
|
+
|
|
3
|
+
## Text-only eval prompt
|
|
4
|
+
Use done-criteria on a hero render recipe (cyberpunk shoe, runtime-ready mode).
|
|
5
|
+
|
|
6
|
+
## Expected behavior
|
|
7
|
+
- one concrete stop condition
|
|
8
|
+
- 3-5 out-of-scope items
|
|
9
|
+
- handoff trigger named
|
|
10
|
+
- mode stated
|
|
11
|
+
- evidence label honest
|
|
12
|
+
|
|
13
|
+
## Pass / Warn / Fail criteria
|
|
14
|
+
- Pass: concrete one-sentence condition + out-of-scope + handoff
|
|
15
|
+
- Warn: condition slightly soft; out-of-scope partial
|
|
16
|
+
- Fail: vague "looks good", multiple stacked conditions, no out-of-scope
|
|
17
|
+
|
|
18
|
+
## Common failure modes
|
|
19
|
+
- "done when it looks great"
|
|
20
|
+
- multiple stop conditions
|
|
21
|
+
- no out-of-scope list
|
|
22
|
+
- declaring done without evidence
|
|
23
|
+
|
|
24
|
+
## Sample passing response outline
|
|
25
|
+
- Stop condition row
|
|
26
|
+
- Out-of-scope list (3-5)
|
|
27
|
+
- Handoff trigger
|
|
28
|
+
- Mode + limitations
|
|
29
|
+
|
|
30
|
+
## Sample failing response outline
|
|
31
|
+
- "When it looks good"
|
|
32
|
+
- Multiple stacked conditions
|
|
33
|
+
- No out-of-scope
|