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,236 @@
|
|
|
1
|
+
# BlendOps Knowledge & Recipe Catalog
|
|
2
|
+
|
|
3
|
+
> Generated deterministically from `registry/knowledge-sources.json`, `registry/knowledge-catalog.json`, and `registry/recipe-catalog.json` via `npm run catalog:build`. Do not edit by hand.
|
|
4
|
+
|
|
5
|
+
## Overview & Retrieval CLI
|
|
6
|
+
|
|
7
|
+
BlendOps separates **atomic agent workflow skills** (`skills/*/SKILL.md`) from **reusable 3D/Blender domain knowledge** (`knowledge.*`) and **multi-stage construction recipes** (`recipe.*`).
|
|
8
|
+
|
|
9
|
+
- **Deterministic Local Search (English & Vietnamese)**: `npx blendops catalog-search "<query>" [--type knowledge|recipe] [--domain <domain>]`
|
|
10
|
+
- **Deterministic Record Resolution**: `npx blendops catalog-resolve <knowledge.id | recipe.id | source.id | skill-id>`
|
|
11
|
+
- **Catalog Schema & Cross-Reference Validation**: `npx blendops catalog-validate`
|
|
12
|
+
- **SceneSpec Validation & Plan Compilation**: `npx blendops scene-spec-validate <spec.json>` / `npx blendops plan-compile <spec.json>`
|
|
13
|
+
|
|
14
|
+
| Metric | Count | Canonical Source |
|
|
15
|
+
| :--- | ---: | :--- |
|
|
16
|
+
| Knowledge Domains | 11 | `registry/knowledge-sources.json` |
|
|
17
|
+
| Canonical Knowledge Records (`knowledge.*`) | 30 | `registry/knowledge-catalog.json` |
|
|
18
|
+
| Canonical Recipes (`recipe.*`) | 10 | `registry/recipe-catalog.json` |
|
|
19
|
+
| Authoritative Sources (`source.*`) | 20 | `registry/knowledge-sources.json` |
|
|
20
|
+
| Latest Stable Blender LTS Baseline | `5.2.3 LTS` | `registry/knowledge-sources.json` |
|
|
21
|
+
|
|
22
|
+
---
|
|
23
|
+
|
|
24
|
+
## 1. Canonical Recipes (`recipe.*`)
|
|
25
|
+
|
|
26
|
+
| Recipe ID | Title | Primary Domain | Stages | Required Skills | Linked Knowledge | Min Blender | Doc-Checked LTS | Evidence Status |
|
|
27
|
+
| :--- | :--- | :--- | ---: | ---: | ---: | :--- | :--- | :--- |
|
|
28
|
+
| `recipe.product-hero-scene` | Product Hero Scene & Web-Ready Presentation | `lighting-camera-and-rendering` | 4 | 18 | 10 | `3.6 LTS` | `5.2.3 LTS` | `version-checked` |
|
|
29
|
+
| `recipe.stylized-environment-scene` | Stylized Environment & Establishing Shot Assembly | `environment-and-architecture` | 4 | 15 | 9 | `3.6 LTS` | `5.2.3 LTS` | `version-checked` |
|
|
30
|
+
| `recipe.hard-surface-prop` | Non-Destructive Hard-Surface Prop Modeling & Shading Hygiene | `hard-surface-and-organic` | 4 | 10 | 10 | `3.6 LTS` | `5.2.3 LTS` | `version-checked` |
|
|
31
|
+
| `recipe.procedural-geometry-nodes-asset` | Procedural Geometry Nodes Asset & Scatter Pipeline | `geometry-nodes-and-procedural` | 4 | 11 | 6 | `3.6 LTS` | `5.2.3 LTS` | `version-checked` |
|
|
32
|
+
| `recipe.uv-and-pbr-material-preparation` | UV Unwrapping, Texel Density & Energy-Conserving PBR Material Preparation | `uv-texturing-and-baking` | 4 | 9 | 9 | `3.6 LTS` | `5.2.3 LTS` | `version-checked` |
|
|
33
|
+
| `recipe.presentation-lighting-and-camera` | Studio Lighting, Physical Camera & Color-Managed Render Setup | `lighting-camera-and-rendering` | 4 | 14 | 5 | `3.6 LTS` | `5.2.3 LTS` | `version-checked` |
|
|
34
|
+
| `recipe.rigged-and-animated-asset` | Skeletal Rigging, Skin Weight Normalization & NLA Action Baking for Export | `rigging-and-animation` | 4 | 9 | 8 | `3.6 LTS` | `5.2.3 LTS` | `version-checked` |
|
|
35
|
+
| `recipe.scene-quality-inspection-and-correction` | Multi-Gate Scene Quality Inspection, Root-Cause Triage & Correction Plan | `lighting-camera-and-rendering` | 4 | 11 | 10 | `3.6 LTS` | `5.2.3 LTS` | `version-checked` |
|
|
36
|
+
| `recipe.blender-to-glb-handoff` | Verified Blender-to-GLB Export, Binary Inspection & Web Viewer Handoff | `interchange-gltf-and-web` | 4 | 9 | 7 | `3.6 LTS` | `5.2.3 LTS` | `version-checked` |
|
|
37
|
+
| `recipe.web-ready-asset-optimization` | Mobile/Web GLB Performance Budgeting, Compression & LOD Pipeline | `optimization-lod-and-performance` | 4 | 10 | 8 | `3.6 LTS` | `5.2.3 LTS` | `version-checked` |
|
|
38
|
+
|
|
39
|
+
### Recipe Details & Scenario Linkages
|
|
40
|
+
|
|
41
|
+
#### `recipe.product-hero-scene` — Product Hero Scene & Web-Ready Presentation
|
|
42
|
+
|
|
43
|
+
- **Intent**: Transform a product brief into a verified single-subject hero scene with three-point/accent lighting, physically plausible materials, controlled reflections, and an optional web-ready GLB handoff package.
|
|
44
|
+
- **Domain**: `lighting-camera-and-rendering`
|
|
45
|
+
- **Required Skills**: `intent-to-3d-brief-writer`, `done-criteria`, `asset-discovery`, `asset-license-checker`, `product-hero-scene-planner`, `camera-composition`, `resolution-aspect-decision`, `lighting-material-plan`, `color-management-decision`, `cycles-vs-eevee-decision`, `lighting-quality-checker`, `material-quality-checker`, `composition-quality-checker`, `scene-readiness`, `render-export-evidence`, `pre-handoff-verification`, `glb-web-handoff`, `plain-language-response`
|
|
46
|
+
- **Knowledge Records**: `knowledge.mesh-manifold-normals-and-scale-hygiene`, `knowledge.triangle-draw-call-and-vram-budgets`, `knowledge.physically-based-camera-lens-and-dof`, `knowledge.modular-architectural-grid-and-metric-scale`, `knowledge.three-point-and-hdri-studio-lighting`, `knowledge.principled-bsdf-v2-energy-conserving-pbr`, `knowledge.agx-filmic-color-management-and-cycles-eevee`, `knowledge.shader-node-gltf-export-portability`, `knowledge.glb-binary-chunk-alignment-and-khronos-validation`, `knowledge.threejs-r3f-tone-mapping-and-environment-parity`
|
|
47
|
+
- **Stages**: `stage-brief-and-scope` (Stage 1) → `stage-scene-and-camera-plan` (Stage 2) → `stage-lighting-and-materials` (Stage 3) → `stage-quality-and-handoff` (Stage 4)
|
|
48
|
+
- **Scenario Reference Doc**: `docs/recipes/cyberpunk-shoe-hero.md`
|
|
49
|
+
|
|
50
|
+
#### `recipe.stylized-environment-scene` — Stylized Environment & Establishing Shot Assembly
|
|
51
|
+
|
|
52
|
+
- **Intent**: Plan and assemble a readable environment or diorama establishing shot with metric scale cues, three-plane depth staging, instanced foliage/props, and time-of-day atmospheric lighting.
|
|
53
|
+
- **Domain**: `environment-and-architecture`
|
|
54
|
+
- **Required Skills**: `intent-to-3d-brief-writer`, `asset-discovery`, `asset-license-checker`, `asset-style-check`, `environment-shot`, `camera-composition`, `resolution-aspect-decision`, `lighting-material-plan`, `polycount-budget-checker`, `cycles-vs-eevee-decision`, `composition-quality-checker`, `lighting-quality-checker`, `scene-readiness`, `pre-handoff-verification`, `plain-language-response`
|
|
55
|
+
- **Knowledge Records**: `knowledge.modular-architectural-grid-and-metric-scale`, `knowledge.mesh-manifold-normals-and-scale-hygiene`, `knowledge.environment-depth-layering-and-atmospheric-perspective`, `knowledge.physically-based-camera-lens-and-dof`, `knowledge.procedural-instancing-and-realize-instances-budget`, `knowledge.procedural-scatter-poisson-disk-and-slope-masking`, `knowledge.volumetrics-fog-and-principled-volume-tradeoffs`, `knowledge.agx-filmic-color-management-and-cycles-eevee`, `knowledge.triangle-draw-call-and-vram-budgets`
|
|
56
|
+
- **Stages**: `stage-environment-brief-and-assets` (Stage 1) → `stage-depth-layering-and-camera` (Stage 2) → `stage-procedural-scatter-and-atmosphere` (Stage 3) → `stage-environment-validation-and-handoff` (Stage 4)
|
|
57
|
+
|
|
58
|
+
#### `recipe.hard-surface-prop` — Non-Destructive Hard-Surface Prop Modeling & Shading Hygiene
|
|
59
|
+
|
|
60
|
+
- **Intent**: Design and validate a mechanical or manufactured hard-surface prop with consistent millimeter bevel widths, clean boolean shading via weighted normals or quad holding loops, and export-ready mesh hygiene.
|
|
61
|
+
- **Domain**: `hard-surface-and-organic`
|
|
62
|
+
- **Required Skills**: `intent-to-3d-brief-writer`, `done-criteria`, `scope-guard`, `stage-gates`, `polycount-budget-checker`, `lighting-material-plan`, `material-quality-checker`, `scene-readiness`, `pre-handoff-verification`, `plain-language-response`
|
|
63
|
+
- **Knowledge Records**: `knowledge.mesh-manifold-normals-and-scale-hygiene`, `knowledge.cad-creases-and-panel-gap-detailing`, `knowledge.non-destructive-hard-surface-modifier-stack`, `knowledge.boolean-bevel-shading-cleanup`, `knowledge.quad-dominant-subdivision-topology`, `knowledge.uv-seam-placement-and-texel-density`, `knowledge.high-to-low-normal-and-ao-baking`, `knowledge.principled-bsdf-v2-energy-conserving-pbr`, `knowledge.triangle-draw-call-and-vram-budgets`, `knowledge.gltf-2-coordinate-system-and-transform-conventions`
|
|
64
|
+
- **Stages**: `stage-prop-scale-and-blockout` (Stage 1) → `stage-modifier-stack-and-topology` (Stage 2) → `stage-uv-and-surface-materials` (Stage 3) → `stage-prop-validation-and-handoff` (Stage 4)
|
|
65
|
+
|
|
66
|
+
#### `recipe.procedural-geometry-nodes-asset` — Procedural Geometry Nodes Asset & Scatter Pipeline
|
|
67
|
+
|
|
68
|
+
- **Intent**: Build a deterministic, parameter-exposed Geometry Nodes asset or scatter system with explicit attribute domain propagation, instance memory discipline, and clear realization rules for rendering vs. glTF export.
|
|
69
|
+
- **Domain**: `geometry-nodes-and-procedural`
|
|
70
|
+
- **Required Skills**: `intent-to-3d-brief-writer`, `done-criteria`, `stage-gates`, `polycount-budget-checker`, `asset-style-check`, `lighting-material-plan`, `material-quality-checker`, `scene-readiness`, `glb-web-handoff`, `pre-handoff-verification`, `plain-language-response`
|
|
71
|
+
- **Knowledge Records**: `knowledge.geometry-nodes-fields-and-anonymous-attributes`, `knowledge.mesh-manifold-normals-and-scale-hygiene`, `knowledge.procedural-scatter-poisson-disk-and-slope-masking`, `knowledge.procedural-instancing-and-realize-instances-budget`, `knowledge.shader-node-gltf-export-portability`, `knowledge.glb-binary-chunk-alignment-and-khronos-validation`
|
|
72
|
+
- **Stages**: `stage-gn-interface-and-inputs` (Stage 1) → `stage-gn-distribution-and-instancing` (Stage 2) → `stage-gn-attributes-and-shading` (Stage 3) → `stage-gn-realization-and-export` (Stage 4)
|
|
73
|
+
|
|
74
|
+
#### `recipe.uv-and-pbr-material-preparation` — UV Unwrapping, Texel Density & Energy-Conserving PBR Material Preparation
|
|
75
|
+
|
|
76
|
+
- **Intent**: Prepare clean, non-overlapping 0-1 UV layouts (or UDIM tiles for offline renders), bake high-to-low or procedural maps without seam artifacts, and wire physically accurate PBR materials.
|
|
77
|
+
- **Domain**: `uv-texturing-and-baking`
|
|
78
|
+
- **Required Skills**: `stage-gates`, `material-quality-checker`, `cycles-vs-eevee-decision`, `output-format-decision`, `lighting-material-plan`, `mobile-glb-budget`, `scene-readiness`, `pre-handoff-verification`, `plain-language-response`
|
|
79
|
+
- **Knowledge Records**: `knowledge.uv-seam-placement-and-texel-density`, `knowledge.udim-vs-single-atlas-uv-packing`, `knowledge.mesh-manifold-normals-and-scale-hygiene`, `knowledge.high-to-low-normal-and-ao-baking`, `knowledge.normal-roughness-and-orm-channel-packing`, `knowledge.principled-bsdf-v2-energy-conserving-pbr`, `knowledge.shader-node-gltf-export-portability`, `knowledge.texture-resolution-ktx2-and-draco-meshopt-compression`, `knowledge.triangle-draw-call-and-vram-budgets`
|
|
80
|
+
- **Stages**: `stage-uv-seams-and-unwrap` (Stage 1) → `stage-mikktspace-baking` (Stage 2) → `stage-principled-bsdf-wiring` (Stage 3) → `stage-material-validation-and-handoff` (Stage 4)
|
|
81
|
+
|
|
82
|
+
#### `recipe.presentation-lighting-and-camera` — Studio Lighting, Physical Camera & Color-Managed Render Setup
|
|
83
|
+
|
|
84
|
+
- **Intent**: Configure a production-ready camera, lighting rig, color management pipeline, and render engine (Cycles or EEVEE) with verified contrast ratios, shadow softness, and output format settings.
|
|
85
|
+
- **Domain**: `lighting-camera-and-rendering`
|
|
86
|
+
- **Required Skills**: `camera-composition`, `resolution-aspect-decision`, `character-portrait`, `interior-scene`, `lighting-material-plan`, `lighting-quality-checker`, `color-management-decision`, `cycles-vs-eevee-decision`, `output-format-decision`, `composition-quality-checker`, `scene-readiness`, `render-export-evidence`, `pre-handoff-verification`, `plain-language-response`
|
|
87
|
+
- **Knowledge Records**: `knowledge.physically-based-camera-lens-and-dof`, `knowledge.modular-architectural-grid-and-metric-scale`, `knowledge.three-point-and-hdri-studio-lighting`, `knowledge.principled-bsdf-v2-energy-conserving-pbr`, `knowledge.agx-filmic-color-management-and-cycles-eevee`
|
|
88
|
+
- **Stages**: `stage-camera-optics-and-framing` (Stage 1) → `stage-three-point-and-hdri-lighting` (Stage 2) → `stage-color-and-render-engine` (Stage 3) → `stage-render-quality-and-handoff` (Stage 4)
|
|
89
|
+
|
|
90
|
+
#### `recipe.rigged-and-animated-asset` — Skeletal Rigging, Skin Weight Normalization & NLA Action Baking for Export
|
|
91
|
+
|
|
92
|
+
- **Intent**: Rig, skin, animate, and bake skeletal or shape-key animations so that IK/constraint rigs convert cleanly into self-contained FK deform keyframes and export to GLB without deformation breakage.
|
|
93
|
+
- **Domain**: `rigging-and-animation`
|
|
94
|
+
- **Required Skills**: `intent-to-3d-brief-writer`, `stage-gates`, `polycount-budget-checker`, `mobile-glb-budget`, `glb-animation-handoff`, `r3f-component-plan`, `glb-web-handoff`, `pre-handoff-verification`, `plain-language-response`
|
|
95
|
+
- **Knowledge Records**: `knowledge.armature-joint-hierarchy-and-linear-blend-skinning`, `knowledge.mesh-manifold-normals-and-scale-hygiene`, `knowledge.organic-sculpt-to-retopology-workflow`, `knowledge.nla-action-baking-and-morph-target-export`, `knowledge.rigid-body-cloth-and-simulation-cache-baking`, `knowledge.gltf-2-coordinate-system-and-transform-conventions`, `knowledge.glb-binary-chunk-alignment-and-khronos-validation`, `knowledge.threejs-r3f-tone-mapping-and-environment-parity`
|
|
96
|
+
- **Stages**: `stage-armature-and-transform-hygiene` (Stage 1) → `stage-skin-weights-and-morphs` (Stage 2) → `stage-nla-action-baking` (Stage 3) → `stage-animation-validation-and-handoff` (Stage 4)
|
|
97
|
+
|
|
98
|
+
#### `recipe.scene-quality-inspection-and-correction` — Multi-Gate Scene Quality Inspection, Root-Cause Triage & Correction Plan
|
|
99
|
+
|
|
100
|
+
- **Intent**: Systematically evaluate a 3D scene or plan against domain quality rubrics, classify blockers vs. warnings, run 4-phase root-cause troubleshooting on defects, and issue an evidence-backed Pass/Warn/Fail readiness verdict.
|
|
101
|
+
- **Domain**: `lighting-camera-and-rendering`
|
|
102
|
+
- **Required Skills**: `blender-troubleshooting`, `polycount-budget-checker`, `material-quality-checker`, `lighting-quality-checker`, `color-management-decision`, `composition-quality-checker`, `scene-readiness`, `stage-gates`, `render-export-evidence`, `pre-handoff-verification`, `plain-language-response`
|
|
103
|
+
- **Knowledge Records**: `knowledge.mesh-manifold-normals-and-scale-hygiene`, `knowledge.boolean-bevel-shading-cleanup`, `knowledge.triangle-draw-call-and-vram-budgets`, `knowledge.principled-bsdf-v2-energy-conserving-pbr`, `knowledge.normal-roughness-and-orm-channel-packing`, `knowledge.three-point-and-hdri-studio-lighting`, `knowledge.agx-filmic-color-management-and-cycles-eevee`, `knowledge.physically-based-camera-lens-and-dof`, `knowledge.environment-depth-layering-and-atmospheric-perspective`, `knowledge.glb-binary-chunk-alignment-and-khronos-validation`
|
|
104
|
+
- **Stages**: `stage-symptom-triage-and-geometry-audit` (Stage 1) → `stage-material-and-lighting-audit` (Stage 2) → `stage-composition-and-holistic-readiness` (Stage 3) → `stage-correction-verification-and-response` (Stage 4)
|
|
105
|
+
|
|
106
|
+
#### `recipe.blender-to-glb-handoff` — Verified Blender-to-GLB Export, Binary Inspection & Web Viewer Handoff
|
|
107
|
+
|
|
108
|
+
- **Intent**: Ensure a Blender asset exports cleanly to a spec-compliant GLB 2.0 binary container, run deterministic structural inspection (`blendops glb-inspect` / `glb-handoff`), and provide complete Three.js or React Three Fiber integration guidance.
|
|
109
|
+
- **Domain**: `interchange-gltf-and-web`
|
|
110
|
+
- **Required Skills**: `material-quality-checker`, `polycount-budget-checker`, `glb-animation-handoff`, `render-export-evidence`, `preview-report`, `r3f-component-plan`, `glb-web-handoff`, `pre-handoff-verification`, `plain-language-response`
|
|
111
|
+
- **Knowledge Records**: `knowledge.gltf-2-coordinate-system-and-transform-conventions`, `knowledge.shader-node-gltf-export-portability`, `knowledge.normal-roughness-and-orm-channel-packing`, `knowledge.glb-binary-chunk-alignment-and-khronos-validation`, `knowledge.texture-resolution-ktx2-and-draco-meshopt-compression`, `knowledge.threejs-r3f-tone-mapping-and-environment-parity`, `knowledge.agx-filmic-color-management-and-cycles-eevee`
|
|
112
|
+
- **Stages**: `stage-pre-export-gltf-audit` (Stage 1) → `stage-glb-container-inspection` (Stage 2) → `stage-web-viewer-component-plan` (Stage 3) → `stage-handoff-verification-and-summary` (Stage 4)
|
|
113
|
+
|
|
114
|
+
#### `recipe.web-ready-asset-optimization` — Mobile/Web GLB Performance Budgeting, Compression & LOD Pipeline
|
|
115
|
+
|
|
116
|
+
- **Intent**: Pin device-tier performance budgets upfront, audit geometry/texture/draw-call bottlenecks, design a progressive degradation and LOD plan, and select optimal texture (KTX2 ETC1S/UASTC) and mesh (Draco vs. Meshopt) compression.
|
|
117
|
+
- **Domain**: `optimization-lod-and-performance`
|
|
118
|
+
- **Required Skills**: `mobile-glb-budget`, `done-criteria`, `polycount-budget-checker`, `asset-fallback-strategy`, `material-quality-checker`, `output-format-decision`, `glb-web-handoff`, `r3f-component-plan`, `pre-handoff-verification`, `plain-language-response`
|
|
119
|
+
- **Knowledge Records**: `knowledge.triangle-draw-call-and-vram-budgets`, `knowledge.lod-hierarchy-and-decimation-strategy`, `knowledge.procedural-instancing-and-realize-instances-budget`, `knowledge.normal-roughness-and-orm-channel-packing`, `knowledge.texture-resolution-ktx2-and-draco-meshopt-compression`, `knowledge.udim-vs-single-atlas-uv-packing`, `knowledge.glb-binary-chunk-alignment-and-khronos-validation`, `knowledge.threejs-r3f-tone-mapping-and-environment-parity`
|
|
120
|
+
- **Stages**: `stage-pin-device-budget` (Stage 1) → `stage-geometry-and-lod-optimization` (Stage 2) → `stage-texture-and-mesh-compression` (Stage 3) → `stage-optimization-verification-and-handoff` (Stage 4)
|
|
121
|
+
|
|
122
|
+
---
|
|
123
|
+
|
|
124
|
+
## 2. Canonical Knowledge Records by Domain (`knowledge.*`)
|
|
125
|
+
|
|
126
|
+
### Domain: `modeling-and-topology` (3 records)
|
|
127
|
+
|
|
128
|
+
| Knowledge ID | Title | Kind | Min Blender | Doc-Checked LTS | Evidence Status | Linked Skills | Linked Recipes |
|
|
129
|
+
| :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
|
|
130
|
+
| `knowledge.quad-dominant-subdivision-topology` | Quad-Dominant Subdivision Topology, Pole Routing & Edge-Flow Discipline | `topology-rule` | `3.0+` | `5.2.3 LTS` | `version-checked` | `polycount-budget-checker`, `scene-readiness`, `product-hero-scene-planner`, `character-portrait` | `recipe.product-hero-scene`, `recipe.hard-surface-prop` |
|
|
131
|
+
| `knowledge.mesh-manifold-normals-and-scale-hygiene` | Mesh Manifold Integrity, Outward Normals & Applied Scale Hygiene | `topology-rule` | `3.0+` | `5.2.3 LTS` | `version-checked` | `blender-troubleshooting`, `polycount-budget-checker`, `scene-readiness`, `pre-handoff-verification` | `recipe.product-hero-scene`, `recipe.hard-surface-prop`, `recipe.uv-and-pbr-material-preparation`, `recipe.scene-quality-inspection-and-correction` |
|
|
132
|
+
| `knowledge.boolean-bevel-shading-cleanup` | Boolean Cutout Shading Cleanup, Custom Split Normals & Smooth by Angle | `topology-rule` | `3.6 LTS` | `5.2.3 LTS` | `version-checked` | `blender-troubleshooting`, `polycount-budget-checker`, `scene-readiness` | `recipe.hard-surface-prop`, `recipe.scene-quality-inspection-and-correction` |
|
|
133
|
+
|
|
134
|
+
### Domain: `hard-surface-and-organic` (3 records)
|
|
135
|
+
|
|
136
|
+
| Knowledge ID | Title | Kind | Min Blender | Doc-Checked LTS | Evidence Status | Linked Skills | Linked Recipes |
|
|
137
|
+
| :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
|
|
138
|
+
| `knowledge.non-destructive-hard-surface-modifier-stack` | Non-Destructive Hard-Surface Modifier Stack Ordering & Evaluation Rules | `modeling-workflow` | `3.6 LTS` | `5.2.3 LTS` | `version-checked` | `product-hero-scene-planner`, `polycount-budget-checker`, `blender-troubleshooting` | `recipe.hard-surface-prop`, `recipe.product-hero-scene` |
|
|
139
|
+
| `knowledge.organic-sculpt-to-retopology-workflow` | Organic High-Poly Sculpting to Clean Quad Retopology & Detail Transfer | `modeling-workflow` | `3.6 LTS` | `5.2.3 LTS` | `version-checked` | `character-portrait`, `polycount-budget-checker`, `mobile-glb-budget` | `recipe.rigged-and-animated-asset`, `recipe.uv-and-pbr-material-preparation` |
|
|
140
|
+
| `knowledge.cad-creases-and-panel-gap-detailing` | Physical Bevel Minimums, Panel Seam Gaps & Industrial Readability | `modeling-workflow` | `3.0+` | `5.2.3 LTS` | `version-checked` | `product-hero-scene-planner`, `lighting-material-plan`, `polycount-budget-checker` | `recipe.product-hero-scene`, `recipe.hard-surface-prop` |
|
|
141
|
+
|
|
142
|
+
### Domain: `geometry-nodes-and-procedural` (3 records)
|
|
143
|
+
|
|
144
|
+
| Knowledge ID | Title | Kind | Min Blender | Doc-Checked LTS | Evidence Status | Linked Skills | Linked Recipes |
|
|
145
|
+
| :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
|
|
146
|
+
| `knowledge.geometry-nodes-fields-and-anonymous-attributes` | Geometry Nodes Fields Evaluation, Attribute Domains & UV/Shader Persistence | `procedural-system` | `3.6 LTS` | `5.2.3 LTS` | `version-checked` | `polycount-budget-checker`, `lighting-material-plan`, `material-quality-checker`, `glb-web-handoff` | `recipe.procedural-geometry-nodes-asset`, `recipe.stylized-environment-scene` |
|
|
147
|
+
| `knowledge.procedural-instancing-and-realize-instances-budget` | Procedural Collection Instancing vs. Realize Instances Memory & Export Tradeoffs | `procedural-system` | `3.6 LTS` | `5.2.3 LTS` | `version-checked` | `polycount-budget-checker`, `mobile-glb-budget`, `r3f-component-plan`, `glb-web-handoff` | `recipe.procedural-geometry-nodes-asset`, `recipe.stylized-environment-scene`, `recipe.web-ready-asset-optimization` |
|
|
148
|
+
| `knowledge.procedural-scatter-poisson-disk-and-slope-masking` | Poisson Disk Point Distribution, Slope/Altitude Masking & Orientation Alignment | `procedural-system` | `3.6 LTS` | `5.2.3 LTS` | `version-checked` | `environment-shot`, `polycount-budget-checker`, `product-hero-scene-planner` | `recipe.procedural-geometry-nodes-asset`, `recipe.stylized-environment-scene` |
|
|
149
|
+
|
|
150
|
+
### Domain: `uv-texturing-and-baking` (3 records)
|
|
151
|
+
|
|
152
|
+
| Knowledge ID | Title | Kind | Min Blender | Doc-Checked LTS | Evidence Status | Linked Skills | Linked Recipes |
|
|
153
|
+
| :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
|
|
154
|
+
| `knowledge.uv-seam-placement-and-texel-density` | UV Seam Placement, Hard-Edge Splits, Texel Density & Mipmap Padding | `uv-baking-rule` | `3.6 LTS` | `5.2.3 LTS` | `version-checked` | `material-quality-checker`, `lighting-material-plan`, `mobile-glb-budget` | `recipe.uv-and-pbr-material-preparation`, `recipe.hard-surface-prop`, `recipe.product-hero-scene` |
|
|
155
|
+
| `knowledge.udim-vs-single-atlas-uv-packing` | Single 0-1 UV Atlas Packing vs. Multi-Tile UDIM Workflows for Offline & glTF | `uv-baking-rule` | `3.6 LTS` | `5.2.3 LTS` | `version-checked` | `material-quality-checker`, `mobile-glb-budget`, `lighting-material-plan`, `glb-web-handoff` | `recipe.uv-and-pbr-material-preparation`, `recipe.web-ready-asset-optimization` |
|
|
156
|
+
| `knowledge.high-to-low-normal-and-ao-baking` | Tangent-Space MikkTSpace Normal & Ambient Occlusion Baking Protocol | `uv-baking-rule` | `3.6 LTS` | `5.2.3 LTS` | `version-checked` | `material-quality-checker`, `lighting-material-plan`, `cycles-vs-eevee-decision` | `recipe.uv-and-pbr-material-preparation`, `recipe.hard-surface-prop`, `recipe.product-hero-scene` |
|
|
157
|
+
|
|
158
|
+
### Domain: `materials-shaders-and-pbr` (3 records)
|
|
159
|
+
|
|
160
|
+
| Knowledge ID | Title | Kind | Min Blender | Doc-Checked LTS | Evidence Status | Linked Skills | Linked Recipes |
|
|
161
|
+
| :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
|
|
162
|
+
| `knowledge.principled-bsdf-v2-energy-conserving-pbr` | Principled BSDF v2 Energy Conservation, Dielectric vs. Conductor Albedo & Blender 4.0+ Socket Changes | `material-shader-profile` | `3.6 LTS` | `5.2.3 LTS` | `version-checked` | `lighting-material-plan`, `material-quality-checker`, `product-hero-scene-planner` | `recipe.product-hero-scene`, `recipe.uv-and-pbr-material-preparation`, `recipe.presentation-lighting-and-camera`, `recipe.scene-quality-inspection-and-correction` |
|
|
163
|
+
| `knowledge.normal-roughness-and-orm-channel-packing` | ORM Channel Packing (Occlusion/Roughness/Metallic) & Linear Non-Color Space Discipline | `material-shader-profile` | `3.6 LTS` | `5.2.3 LTS` | `version-checked` | `material-quality-checker`, `lighting-material-plan`, `glb-web-handoff`, `mobile-glb-budget` | `recipe.uv-and-pbr-material-preparation`, `recipe.product-hero-scene`, `recipe.blender-to-glb-handoff`, `recipe.web-ready-asset-optimization` |
|
|
164
|
+
| `knowledge.shader-node-gltf-export-portability` | Blender Shader Graph to Khronos glTF 2.0 Export Portability & Extension Matrix | `material-shader-profile` | `3.6 LTS` | `5.2.3 LTS` | `version-checked` | `lighting-material-plan`, `material-quality-checker`, `glb-web-handoff`, `r3f-component-plan` | `recipe.product-hero-scene`, `recipe.uv-and-pbr-material-preparation`, `recipe.blender-to-glb-handoff`, `recipe.procedural-geometry-nodes-asset` |
|
|
165
|
+
|
|
166
|
+
### Domain: `lighting-camera-and-rendering` (3 records)
|
|
167
|
+
|
|
168
|
+
| Knowledge ID | Title | Kind | Min Blender | Doc-Checked LTS | Evidence Status | Linked Skills | Linked Recipes |
|
|
169
|
+
| :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
|
|
170
|
+
| `knowledge.three-point-and-hdri-studio-lighting` | Three-Point Studio Lighting Ratios, Area Light Angular Size & HDRI Balance | `lighting-camera-rule` | `3.6 LTS` | `5.2.3 LTS` | `version-checked` | `lighting-material-plan`, `lighting-quality-checker`, `product-hero-scene-planner`, `character-portrait` | `recipe.product-hero-scene`, `recipe.presentation-lighting-and-camera`, `recipe.scene-quality-inspection-and-correction` |
|
|
171
|
+
| `knowledge.physically-based-camera-lens-and-dof` | Physical Camera Sensor Size, Focal Length Compression, Tilt-Shift & Depth of Field | `lighting-camera-rule` | `3.0+` | `5.2.3 LTS` | `version-checked` | `camera-composition`, `composition-quality-checker`, `product-hero-scene-planner`, `character-portrait`, `interior-scene`, `environment-shot` | `recipe.product-hero-scene`, `recipe.presentation-lighting-and-camera`, `recipe.stylized-environment-scene` |
|
|
172
|
+
| `knowledge.agx-filmic-color-management-and-cycles-eevee` | AgX vs. Filmic Color Management, EEVEE Next (4.2+) vs. Cycles & Output Bit Depth | `render-engine-profile` | `3.6 LTS` | `5.2.3 LTS` | `version-checked` | `color-management-decision`, `cycles-vs-eevee-decision`, `output-format-decision`, `lighting-quality-checker` | `recipe.product-hero-scene`, `recipe.presentation-lighting-and-camera`, `recipe.stylized-environment-scene`, `recipe.scene-quality-inspection-and-correction`, `recipe.blender-to-glb-handoff` |
|
|
173
|
+
|
|
174
|
+
### Domain: `rigging-and-animation` (2 records)
|
|
175
|
+
|
|
176
|
+
| Knowledge ID | Title | Kind | Min Blender | Doc-Checked LTS | Evidence Status | Linked Skills | Linked Recipes |
|
|
177
|
+
| :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
|
|
178
|
+
| `knowledge.armature-joint-hierarchy-and-linear-blend-skinning` | Armature Joint Hierarchy, Transform Alignment & 4-Bone Linear Blend Skinning | `rigging-animation-rule` | `3.6 LTS` | `5.2.3 LTS` | `version-checked` | `glb-animation-handoff`, `polycount-budget-checker`, `mobile-glb-budget`, `r3f-component-plan` | `recipe.rigged-and-animated-asset`, `recipe.blender-to-glb-handoff` |
|
|
179
|
+
| `knowledge.nla-action-baking-and-morph-target-export` | NLA Action Baking, Constraint Sampling, and Shape Key (Morph Target) Export Rules | `rigging-animation-rule` | `3.6 LTS` | `5.2.3 LTS` | `version-checked` | `glb-animation-handoff`, `r3f-component-plan`, `glb-web-handoff`, `mobile-glb-budget` | `recipe.rigged-and-animated-asset`, `recipe.blender-to-glb-handoff` |
|
|
180
|
+
|
|
181
|
+
### Domain: `simulation-and-vfx` (2 records)
|
|
182
|
+
|
|
183
|
+
| Knowledge ID | Title | Kind | Min Blender | Doc-Checked LTS | Evidence Status | Linked Skills | Linked Recipes |
|
|
184
|
+
| :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
|
|
185
|
+
| `knowledge.rigid-body-cloth-and-simulation-cache-baking` | Rigid Body, Cloth, and Physics Simulation Cache Baking vs. Real-Time Tradeoffs | `simulation-vfx-profile` | `3.0+` | `5.2.3 LTS` | `source-reviewed` | `glb-animation-handoff`, `scene-readiness`, `glb-web-handoff` | `recipe.rigged-and-animated-asset`, `recipe.blender-to-glb-handoff` |
|
|
186
|
+
| `knowledge.volumetrics-fog-and-principled-volume-tradeoffs` | Volumetric Lighting, Principled Volume, and Real-Time Depth Fog Tradeoffs | `simulation-vfx-profile` | `3.0+` | `5.2.3 LTS` | `version-checked` | `lighting-material-plan`, `environment-shot`, `cycles-vs-eevee-decision`, `r3f-component-plan` | `recipe.stylized-environment-scene`, `recipe.product-hero-scene`, `recipe.presentation-lighting-and-camera` |
|
|
187
|
+
|
|
188
|
+
### Domain: `environment-and-architecture` (2 records)
|
|
189
|
+
|
|
190
|
+
| Knowledge ID | Title | Kind | Min Blender | Doc-Checked LTS | Evidence Status | Linked Skills | Linked Recipes |
|
|
191
|
+
| :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
|
|
192
|
+
| `knowledge.modular-architectural-grid-and-metric-scale` | Modular Architectural Grid Snapping, Pivot Placement, and Real-World Metric Scale | `scene-assembly-pattern` | `3.0+` | `5.2.3 LTS` | `version-checked` | `scene-readiness`, `interior-scene`, `environment-shot`, `product-hero-scene-planner` | `recipe.stylized-environment-scene`, `recipe.product-hero-scene`, `recipe.scene-quality-inspection-and-correction` |
|
|
193
|
+
| `knowledge.environment-depth-layering-and-atmospheric-perspective` | Foreground / Midground / Background Depth Layering and Cyclorama Staging | `scene-assembly-pattern` | `3.0+` | `5.2.3 LTS` | `source-reviewed` | `product-hero-scene-planner`, `environment-shot`, `camera-composition`, `composition-quality-checker` | `recipe.product-hero-scene`, `recipe.stylized-environment-scene`, `recipe.presentation-lighting-and-camera` |
|
|
194
|
+
|
|
195
|
+
### Domain: `optimization-lod-and-performance` (3 records)
|
|
196
|
+
|
|
197
|
+
| Knowledge ID | Title | Kind | Min Blender | Doc-Checked LTS | Evidence Status | Linked Skills | Linked Recipes |
|
|
198
|
+
| :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
|
|
199
|
+
| `knowledge.triangle-draw-call-and-vram-budgets` | Triangle, Draw Call, Texture VRAM, and File Size Budgets by Target Tier | `performance-budget-rule` | `3.0+` | `5.2.3 LTS` | `source-reviewed` | `polycount-budget-checker`, `mobile-glb-budget`, `material-quality-checker`, `acceptance-criteria-builder` | `recipe.web-ready-asset-optimization`, `recipe.blender-to-glb-handoff`, `recipe.scene-quality-inspection-and-correction` |
|
|
200
|
+
| `knowledge.lod-hierarchy-and-decimation-strategy` | Level of Detail (LOD0–LOD3) Hierarchy, Planar Dissolve, and UV-Safe Decimation | `performance-budget-rule` | `3.0+` | `5.2.3 LTS` | `source-reviewed` | `polycount-budget-checker`, `mobile-glb-budget`, `r3f-component-plan`, `scene-readiness` | `recipe.web-ready-asset-optimization`, `recipe.hard-surface-prop` |
|
|
201
|
+
| `knowledge.texture-resolution-ktx2-and-draco-meshopt-compression` | KTX2 / Basis Universal Texture Compression vs. Draco and Meshopt Geometry Compression | `performance-budget-rule` | `3.0+` | `5.2.3 LTS` | `version-checked` | `mobile-glb-budget`, `glb-web-handoff`, `r3f-component-plan`, `output-format-decision` | `recipe.web-ready-asset-optimization`, `recipe.blender-to-glb-handoff` |
|
|
202
|
+
|
|
203
|
+
### Domain: `interchange-gltf-and-web` (3 records)
|
|
204
|
+
|
|
205
|
+
| Knowledge ID | Title | Kind | Min Blender | Doc-Checked LTS | Evidence Status | Linked Skills | Linked Recipes |
|
|
206
|
+
| :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
|
|
207
|
+
| `knowledge.gltf-2-coordinate-system-and-transform-conventions` | glTF 2.0 Right-Handed +Y Up Coordinate System and Blender Transform Conversion | `interchange-export-rule` | `3.0+` | `5.2.3 LTS` | `source-reviewed` | `scene-readiness`, `glb-web-handoff`, `r3f-component-plan`, `pre-handoff-verification` | `recipe.blender-to-glb-handoff`, `recipe.scene-quality-inspection-and-correction`, `recipe.product-hero-scene` |
|
|
208
|
+
| `knowledge.glb-binary-chunk-alignment-and-khronos-validation` | GLB Binary Container Structure, Export Flags, and Khronos Validator Compliance | `interchange-export-rule` | `3.0+` | `5.2.3 LTS` | `version-checked` | `glb-web-handoff`, `render-export-evidence`, `pre-handoff-verification`, `output-format-decision` | `recipe.blender-to-glb-handoff`, `recipe.web-ready-asset-optimization`, `recipe.product-hero-scene` |
|
|
209
|
+
| `knowledge.threejs-r3f-tone-mapping-and-environment-parity` | Three.js and React Three Fiber Tone Mapping, Color Management, and IBL Parity with Blender | `interchange-export-rule` | `3.0+` | `5.2.3 LTS` | `version-checked` | `r3f-component-plan`, `glb-web-handoff`, `color-management-decision`, `pre-handoff-verification` | `recipe.blender-to-glb-handoff`, `recipe.product-hero-scene`, `recipe.web-ready-asset-optimization` |
|
|
210
|
+
|
|
211
|
+
---
|
|
212
|
+
|
|
213
|
+
## 3. Authoritative Source Registry (`source.*`)
|
|
214
|
+
|
|
215
|
+
| Source ID | Title | Authority | Publisher | Locator / Section | Verified Date | License / Usage |
|
|
216
|
+
| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
|
|
217
|
+
| `source.blender-manual-modeling` | Blender Reference Manual — Modeling, Meshes, Normals, and Modifiers | `official-product-manual` | Blender Documentation Team (docs.blender.org) | Modeling -> Meshes (Structure, Primitives, Editing, Normals) & Modifiers (Generate/Modify/Normals) | `2026-11-04` | CC-BY-SA 4.0 (referenced for factual behavior; no prose copied) |
|
|
218
|
+
| `source.blender-manual-geometry-nodes` | Blender Reference Manual — Geometry Nodes, Fields, Attributes, and Instances | `official-product-manual` | Blender Documentation Team (docs.blender.org) | Modeling -> Geometry Nodes -> Fields, Attributes, Point Distribution, and Instances | `2026-11-04` | CC-BY-SA 4.0 (referenced for node evaluation semantics) |
|
|
219
|
+
| `source.blender-manual-uv-baking` | Blender Reference Manual — UV Unwrapping, Texture Space, and Cycles Render Baking | `official-product-manual` | Blender Documentation Team (docs.blender.org) | Modeling -> Meshes -> UVs & Render -> Cycles -> Render Baking | `2026-11-04` | CC-BY-SA 4.0 (referenced for UV and baking parameters) |
|
|
220
|
+
| `source.blender-manual-shading-color` | Blender Reference Manual — Shader Nodes, Principled BSDF, and Color Management (AgX / Filmic) | `official-product-manual` | Blender Documentation Team (docs.blender.org) | Render -> Shader Nodes -> Shader -> Principled BSDF & Render -> Color Management | `2026-11-04` | CC-BY-SA 4.0 (referenced for Principled BSDF v2 and AgX color transforms) |
|
|
221
|
+
| `source.blender-manual-lighting-rendering` | Blender Reference Manual — Cycles, EEVEE Next, Lighting, and Cameras | `official-product-manual` | Blender Documentation Team (docs.blender.org) | Render -> Cycles, EEVEE, Light Objects, and Camera Properties | `2026-11-04` | CC-BY-SA 4.0 (referenced for Cycles and EEVEE Next rendering differences) |
|
|
222
|
+
| `source.blender-manual-rigging-animation` | Blender Reference Manual — Armatures, Skinning, Constraints, and NLA Action Baking | `official-product-manual` | Blender Documentation Team (docs.blender.org) | Animation & Rigging -> Armatures, Skinning, Constraints, Actions, and Nonlinear Animation | `2026-11-04` | CC-BY-SA 4.0 (referenced for armature and NLA baking workflows) |
|
|
223
|
+
| `source.blender-manual-physics` | Blender Reference Manual — Physics, Rigid Body, Cloth, and Point Cache Baking | `official-product-manual` | Blender Documentation Team (docs.blender.org) | Physics -> Rigid Body, Cloth, and Baking Physics Simulations | `2026-11-04` | CC-BY-SA 4.0 (referenced for physics caching and collision shapes) |
|
|
224
|
+
| `source.blender-manual-gltf-io` | Blender Reference Manual — glTF 2.0 Import/Export Add-on Specification | `official-product-manual` | Blender Documentation Team & Khronos glTF-Blender-IO Maintainers | Add-ons -> Import-Export -> glTF 2.0 (Material Node Graph Mapping & Transform Options) | `2026-11-04` | CC-BY-SA 4.0 (referenced for glTF socket mapping and exporter options) |
|
|
225
|
+
| `source.khronos-gltf-2-spec` | Khronos glTF 2.0.1 Specification & GLB Binary Container Format | `official-specification` | Khronos 3D Formats Working Group (ISO/IEC 12113:2022) | Sections 3.3 (Coordinate System), 3.7 (Meshes/Skins), 4.4 (GLB Binary Format), Appendix B (Metallic-Roughness Material Model) | `2026-11-04` | CC-BY 4.0 / Khronos Specification License |
|
|
226
|
+
| `source.khronos-gltf-asset-auditor` | Khronos glTF Asset Auditor & 3D Commerce Asset Creation Guidelines | `official-production-pipeline` | The Khronos Group | Real-Time E-Commerce Asset Creation & Audit Rules (Triangle Count, Draw Calls, Texture Atlas, Metric Scale) | `2026-11-04` | Apache-2.0 (referenced for real-time asset budgets and validation metrics) |
|
|
227
|
+
| `source.khronos-ktx2-draco-meshopt` | Khronos KHR_texture_basisu, KHR_draco_mesh_compression, and EXT_meshopt_compression | `official-specification` | Khronos 3D Formats Working Group | extensions/2.0/Khronos/KHR_texture_basisu, KHR_draco_mesh_compression & Vendor/EXT_meshopt_compression | `2026-11-04` | Apache-2.0 / Khronos License |
|
|
228
|
+
| `source.blender-studio-pipeline` | Blender Studio Pipeline & Asset Creation Conventions | `official-production-pipeline` | Blender Studio (studio.blender.org) | Pipeline & Tools -> Asset Creation, Naming Conventions, Collection Organization, and Staging | `2026-11-04` | CC-BY 4.0 (referenced for asset naming, collection organization, and staging conventions) |
|
|
229
|
+
| `source.pixar-opensubdiv-topology` | Pixar OpenSubdiv Catmull-Clark Subdivision Surface Specification | `official-specification` | Pixar Animation Studios (graphics.pixar.com) | Subdivision Surfaces -> Catmull-Clark Scheme, Extraordinary Vertices, and Semi-Sharp Creases | `2026-11-04` | Modified Apache-2.0 (referenced for Catmull-Clark valence and crease rules) |
|
|
230
|
+
| `source.mikktspace-tangent-standard` | MikkTSpace — Tangent Space Standard for Normal Mapping (Morten S. Mikkelsen) | `peer-reviewed-research` | Morten S. Mikkelsen (Simulation Rig / Blender Developer Wiki Archive) | Tangent Space Normal Maps -> MikkTSpace Order-Independent Tangent Generation & Triangulation Rules | `2026-11-04` | Public specification (normative in Blender and glTF 2.0) |
|
|
231
|
+
| `source.threejs-color-and-gltf` | Three.js Documentation — Color Management, GLTFLoader, and PBR Lighting | `official-product-manual` | Three.js Project (threejs.org) | Manual -> Color Management, GLTFLoader, WebGLRenderer.toneMapping, and PMREMGenerator | `2026-11-04` | MIT License |
|
|
232
|
+
| `source.blender-lab-mcp-and-runtime` | Blender Lab MCP Server & Command Line Interface Documentation | `official-product-manual` | Blender Foundation (blender.org/lab) | Blender Lab MCP Add-on Manifest (blender_version_min = 5.1.0) & CLI Background Execution | `2026-11-04` | Blender Foundation official documentation |
|
|
233
|
+
| `source.agentskills-specification` | Agent Skills Specification & Anthropic Claude Skills Best Practices | `official-specification` | Anthropic & AgentSkills.io | SKILL.md Frontmatter Specification (name <= 64 chars, description <= 200 chars) & Progressive Disclosure | `2026-11-04` | Public specification |
|
|
234
|
+
| `source.3dviz-pro-max-architecture` | 3dviz-pro-max — Evidence-Aware 3D Knowledge & Recipe Catalog Architecture Reference | `reference-implementation` | viettranx (GitHub) | Knowledge Catalog, Recipe Decomposition, and Evidence-Aware Verification Architecture | `2026-11-04` | MIT License (architectural pattern reference only; no catalog records copied) |
|
|
235
|
+
| `source.blender-release-notes` | Blender Developer Release Notes (Blender 3.6 LTS, 4.0, 4.1, 4.2 LTS, 4.5.15 LTS, 5.1, 5.2.3 LTS) | `official-product-manual` | Blender Developer Documentation (developer.blender.org) | Release Notes -> 3.6 LTS, 4.0, 4.1, 4.2 LTS, 4.5 LTS, 5.1, and 5.2 LTS | `2026-11-04` | CC-BY-SA 4.0 (referenced for version-specific API, node, and modifier transitions) |
|
|
236
|
+
| `source.google-filament-pbr` | Physically Based Rendering in Filament (Romain Guy & Mathias Agopian) | `peer-reviewed-research` | Google Filament Authors | Sections 4 (Material System / Dielectric F0 / Energy Conservation) & 5 (Photometric Lighting & Camera Exposure EV100) | `2026-11-04` | Apache-2.0 (referenced for microfacet BRDF, dielectric F0, and photometric lighting math) |
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
# Recipes
|
|
2
|
+
|
|
3
|
+
BlendOps organizes recipes across two linked surfaces so there is never a duplicate source of truth:
|
|
4
|
+
|
|
5
|
+
1. **Canonical Machine-Readable Recipe Registry (`registry/recipe-catalog.json`)**:
|
|
6
|
+
- Defines 10 reusable, multi-stage `recipe.<slug>` blueprints validated by `schemas/recipe-record.schema.json`, indexed in `registry/catalog-index.json`, and rendered in [`../knowledge-and-recipe-catalog.md`](../knowledge-and-recipe-catalog.md).
|
|
7
|
+
- Used by `recipe-fit-assessor`, `blender-recipe-decomposer`, `workflow-stage-router`, and `bin/blendops.mjs catalog-search --type recipe`.
|
|
8
|
+
2. **Human-Readable Scenario Recipes (`docs/recipes/*.md`)**:
|
|
9
|
+
- Concrete, styled walkthroughs that instantiate a canonical recipe for a specific user prompt (linked via `documentation_path` on the canonical recipe record).
|
|
10
|
+
|
|
11
|
+
## Canonical Machine-Readable Recipes (`registry/recipe-catalog.json`)
|
|
12
|
+
|
|
13
|
+
- `recipe.product-hero-scene` — Studio Product Hero Still & Web GLB Blueprint (scenario instance: [cyberpunk-shoe-hero](./cyberpunk-shoe-hero.md); pack: [`../../packs/product-hero-v0/PACK.md`](../../packs/product-hero-v0/PACK.md))
|
|
14
|
+
- `recipe.stylized-environment-scene` — Stylized / Architectural Environment Vista Blueprint
|
|
15
|
+
- `recipe.hard-surface-prop` — Non-Destructive Hard-Surface Prop Modeling Blueprint
|
|
16
|
+
- `recipe.procedural-geometry-nodes-asset` — Parametric Geometry Nodes Asset & Scatter Blueprint
|
|
17
|
+
- `recipe.uv-and-pbr-material-preparation` — UV Unwrapping, Packing & Cycles PBR Baking Blueprint
|
|
18
|
+
- `recipe.presentation-lighting-and-camera` — Studio Lighting, Physical Camera & Color Management Blueprint
|
|
19
|
+
- `recipe.rigged-and-animated-asset` — Skeletal Armature Rigging, Weight Painting & NLA Baking Blueprint
|
|
20
|
+
- `recipe.scene-quality-inspection-and-correction` — 7-Point Scene Quality Audit & Remediation Blueprint
|
|
21
|
+
- `recipe.blender-to-glb-handoff` — Blender to glTF 2.0 / GLB Export & Web Viewer Handoff Blueprint
|
|
22
|
+
- `recipe.web-ready-asset-optimization` — Web/Mobile LOD, KTX2 Texture & Draco/Meshopt Optimization Blueprint
|
|
23
|
+
|
|
24
|
+
## Scenario recipe index (`docs/recipes/`)
|
|
25
|
+
|
|
26
|
+
- [cyberpunk-shoe-hero](./cyberpunk-shoe-hero.md) — Golden-path scenario instance of `recipe.product-hero-scene`
|
|
27
|
+
|
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
# Recipe: cyberpunk-shoe-hero
|
|
2
|
+
|
|
3
|
+
Status: 1.0.0
|
|
4
|
+
|
|
5
|
+
> [!NOTE]
|
|
6
|
+
> This recipe is the **step-by-step template** for an AI agent to execute the cyberpunk-shoe-hero scenario. The matching **product/workflow specification** (the "what and why") lives at [`../golden-path-cyberpunk-shoe.md`](../golden-path-cyberpunk-shoe.md). The historical text-only runtime eval lives at [`../evals/cyberpunk-shoe-hero-v0-runtime-eval.md`](../evals/cyberpunk-shoe-hero-v0-runtime-eval.md). The pack that bundles the skills used here is [`packs/product-hero-v0/PACK.md`](../../packs/product-hero-v0/PACK.md).
|
|
7
|
+
|
|
8
|
+
## User prompt
|
|
9
|
+
|
|
10
|
+
“Create a cyberpunk shoe web hero with a floating shoe, neon lights, glossy dark floor, cinematic camera, export GLB, and give web usage guidance.”
|
|
11
|
+
|
|
12
|
+
## Assumptions
|
|
13
|
+
|
|
14
|
+
- User is non-Blender-technical.
|
|
15
|
+
- Runtime setup follows official runtime options only.
|
|
16
|
+
- Output needs both visual quality and web handoff clarity.
|
|
17
|
+
|
|
18
|
+
## Clarification questions
|
|
19
|
+
|
|
20
|
+
1. Is this optimized for realtime web, marketing visuals, or both?
|
|
21
|
+
2. Do you already have a source shoe model/reference?
|
|
22
|
+
3. Any required brand colors or forbidden motifs?
|
|
23
|
+
4. Preferred camera framing (square/wide/custom)?
|
|
24
|
+
5. Any performance constraints for web delivery?
|
|
25
|
+
|
|
26
|
+
## Scene intent
|
|
27
|
+
|
|
28
|
+
- Hero focus: floating shoe as central subject
|
|
29
|
+
- Mood: cyberpunk neon ambiance
|
|
30
|
+
- Surface context: glossy dark floor for reflection cues
|
|
31
|
+
- Output intent: web-ready GLB with explanation
|
|
32
|
+
|
|
33
|
+
## Composition plan
|
|
34
|
+
|
|
35
|
+
- subject hierarchy: shoe > support elements > background
|
|
36
|
+
- framing: cinematic 3/4 emphasis
|
|
37
|
+
- negative space reserved for hero text overlays (if needed)
|
|
38
|
+
|
|
39
|
+
## Lighting plan
|
|
40
|
+
|
|
41
|
+
- key light for silhouette readability
|
|
42
|
+
- neon accent/rim lighting for cyberpunk mood
|
|
43
|
+
- controlled reflections on glossy floor
|
|
44
|
+
|
|
45
|
+
## Material plan
|
|
46
|
+
|
|
47
|
+
- stylized-but-readable product material definition
|
|
48
|
+
- reflective floor tuned for contrast, not clutter
|
|
49
|
+
- portability awareness for export/handoff
|
|
50
|
+
|
|
51
|
+
## Camera plan
|
|
52
|
+
|
|
53
|
+
- hero camera angle fixed before final quality gate
|
|
54
|
+
- lens/framing chosen for product emphasis
|
|
55
|
+
|
|
56
|
+
## Official runtime assumptions
|
|
57
|
+
|
|
58
|
+
- Official Blender MCP Server: https://www.blender.org/lab/mcp-server/
|
|
59
|
+
- Official Claude Blender Connector: https://claude.com/resources/tutorials/using-the-blender-connector-in-claude
|
|
60
|
+
- Official Blender CLI docs: https://docs.blender.org/manual/en/latest/advanced/command_line/index.html
|
|
61
|
+
|
|
62
|
+
Source confidence note:
|
|
63
|
+
- keep `verified-read` vs `linked-only` explicit at runtime setup step.
|
|
64
|
+
|
|
65
|
+
## Validation checklist
|
|
66
|
+
|
|
67
|
+
- [ ] subject clarity
|
|
68
|
+
- [ ] composition coherence
|
|
69
|
+
- [ ] scale plausibility
|
|
70
|
+
- [ ] camera/framing intent
|
|
71
|
+
- [ ] lighting readability
|
|
72
|
+
- [ ] material consistency
|
|
73
|
+
- [ ] render/preview readiness
|
|
74
|
+
- [ ] export readiness
|
|
75
|
+
- [ ] web handoff caveat transparency
|
|
76
|
+
|
|
77
|
+
## Artifact handoff checklist
|
|
78
|
+
|
|
79
|
+
- [ ] GLB artifact status documented
|
|
80
|
+
- [ ] preview artifact status documented
|
|
81
|
+
- [ ] assumptions/caveats documented
|
|
82
|
+
- [ ] next-step runtime checks documented
|
|
83
|
+
|
|
84
|
+
## Non-Blender-user final response template
|
|
85
|
+
|
|
86
|
+
- **What you asked for:** concise restatement
|
|
87
|
+
- **What is ready now:** pass/warn/fail summary
|
|
88
|
+
- **What needs follow-up:** unresolved checks and impact
|
|
89
|
+
- **What to do next:** prioritized actions in plain language
|
|
90
|
+
|
|
91
|
+
## Failure/caveat examples
|
|
92
|
+
|
|
93
|
+
Example A (partial):
|
|
94
|
+
- “Scene intent and quality checks are mostly ready, but web runtime compatibility is not fully verified yet. Status: Conditionally Ready.”
|
|
95
|
+
|
|
96
|
+
Example B (not ready):
|
|
97
|
+
- “Official runtime setup evidence is incomplete, so export-readiness cannot be confirmed. Status: Not Ready.”
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
# Workflows
|
|
2
|
+
|
|
3
|
+
Workflows compose laws + skills into multi-step product processes.
|
|
4
|
+
|
|
5
|
+
A workflow:
|
|
6
|
+
- orchestrates multiple skills
|
|
7
|
+
- enforces all applicable laws
|
|
8
|
+
- remains runtime-light
|
|
9
|
+
- does not own runtime execution
|
|
10
|
+
|
|
11
|
+
## Workflow index
|
|
12
|
+
|
|
13
|
+
- [**full-non-blender-user-workflow**](./full-non-blender-user-workflow.md) — canonical full-lifecycle workflow chaining the original-16 baseline skills (Stages 1–7: Intent → Asset planning → Runtime readiness → Scene planning → Quality gate → Evidence + verification → Handoff); interleave the remaining 32 expansion skills via `workflow-stage-router`. Use when scope is broad.
|
|
14
|
+
- [product-hero-workflow](./product-hero-workflow.md) — narrower product-hero-specific subset. Use when the request is specifically a product hero scene.
|
|
@@ -0,0 +1,210 @@
|
|
|
1
|
+
# Workflow: full-non-blender-user-workflow
|
|
2
|
+
|
|
3
|
+
Status: 1.0.0
|
|
4
|
+
|
|
5
|
+
> [!NOTE]
|
|
6
|
+
> This is the **canonical full-lifecycle workflow** that chains the **original 16** BlendOps core skills for a complete non-Blender-user run. The repo now ships **48** composable skills (see [`skills/README.md`](../../skills/README.md)); use [`workflow-stage-router`](../../skills/workflow-stage-router/SKILL.md) when you need to interleave expansion skills. `product-hero-workflow.md` is the narrower product-hero-specific subset.
|
|
7
|
+
|
|
8
|
+
## Trigger
|
|
9
|
+
|
|
10
|
+
Use this workflow when a non-Blender user requests **any 3D scene + handoff** and the scope is broad enough to span intent exploration → planning → runtime execution → evidence → handoff.
|
|
11
|
+
|
|
12
|
+
If the user already has a confirmed brief, jump in at Stage 2. If runtime is not in scope (text-only iteration), stop after Stage 5.
|
|
13
|
+
|
|
14
|
+
## Inputs
|
|
15
|
+
|
|
16
|
+
- natural-language user prompt (any specificity)
|
|
17
|
+
- target deliverable hint (image / GLB / web hero / iteration / docs)
|
|
18
|
+
- target audience (non-Blender-technical / mixed / technical-OK)
|
|
19
|
+
- optional brand / mood / reference notes
|
|
20
|
+
- optional performance / time / scope constraints
|
|
21
|
+
|
|
22
|
+
## Laws applied
|
|
23
|
+
|
|
24
|
+
- [`../../laws/official-runtime-only.md`](../../laws/official-runtime-only.md)
|
|
25
|
+
- [`../../laws/no-arbitrary-python-interface.md`](../../laws/no-arbitrary-python-interface.md)
|
|
26
|
+
- [`../../laws/evidence-before-done.md`](../../laws/evidence-before-done.md)
|
|
27
|
+
- [`../../laws/non-blender-user-language.md`](../../laws/non-blender-user-language.md)
|
|
28
|
+
|
|
29
|
+
## Skills composed (baseline 16, canonical order)
|
|
30
|
+
|
|
31
|
+
```txt
|
|
32
|
+
Stage 1 — Intent
|
|
33
|
+
blender-brainstorming (Socratic, when intent is vague)
|
|
34
|
+
intent-to-3d-brief-writer (8-slot structured brief)
|
|
35
|
+
|
|
36
|
+
Stage 2 — Asset planning
|
|
37
|
+
asset-discovery (per-asset strategy + license + budget)
|
|
38
|
+
|
|
39
|
+
Stage 3 — Runtime readiness
|
|
40
|
+
runtime-setup (path + host prerequisites)
|
|
41
|
+
runtime-readiness (matrix + verdict)
|
|
42
|
+
bridge-conflicts (only if readiness signals are inconsistent)
|
|
43
|
+
|
|
44
|
+
Stage 4 — Scene planning
|
|
45
|
+
product-hero-scene-planner (subject + scene structure)
|
|
46
|
+
camera-composition (framing + camera)
|
|
47
|
+
lighting-material-plan (mood + lookdev + portability)
|
|
48
|
+
|
|
49
|
+
Stage 5 — Quality gate
|
|
50
|
+
scene-readiness (Pass / Warn / Fail readiness verdict)
|
|
51
|
+
blender-troubleshooting (only if output diverges from intent)
|
|
52
|
+
|
|
53
|
+
Stage 6 — Evidence + verification
|
|
54
|
+
render-export-evidence (classify each artifact's truth label)
|
|
55
|
+
pre-handoff-verification (7-point gate before any "ready" claim)
|
|
56
|
+
|
|
57
|
+
Stage 7 — Handoff + final response
|
|
58
|
+
glb-web-handoff (web/GLB framing if in scope)
|
|
59
|
+
plain-language-response (plain-language final response)
|
|
60
|
+
|
|
61
|
+
Routing utility (always available)
|
|
62
|
+
blendops-help (load when next safe action is unclear)
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
## Stages
|
|
66
|
+
|
|
67
|
+
> [!NOTE]
|
|
68
|
+
> These are workflow stages (per-run pipeline steps). Project roadmap and release checks live in [`TODO.md`](../../TODO.md).
|
|
69
|
+
|
|
70
|
+
### Stage 1 — Intent
|
|
71
|
+
|
|
72
|
+
Goal: confirmed user intent + 8-slot structured brief.
|
|
73
|
+
|
|
74
|
+
- If user request is vague: load `blender-brainstorming` first. Ask 3-5 batched clarifying questions, propose 2-3 alternative scopings, end with one-paragraph confirmed intent summary.
|
|
75
|
+
- Once intent is confirmed: load `intent-to-3d-brief-writer`. Fill the 8 slots (Subject, Mood, Deliverables, Constraints, Evidence expectations, Acceptance criteria, Audience, Owner). Echo to user. Confirm before proceeding.
|
|
76
|
+
|
|
77
|
+
Exit gate: brief locked. Runtime status `Not Run`. Artifact status `Not Produced`.
|
|
78
|
+
|
|
79
|
+
### Stage 2 — Asset planning
|
|
80
|
+
|
|
81
|
+
Goal: per-asset acquisition strategy with license + confidence + budget reconciliation.
|
|
82
|
+
|
|
83
|
+
- Load `asset-discovery`. Walk the 5-step decision tree (brand-restricted? specific? tight budget? iteration? mood-specific?).
|
|
84
|
+
- Per asset class, record strategy (procedural / library / generative / photogrammetry) + source candidate + license + confidence label + risk.
|
|
85
|
+
- Sum poly / GLB-size budget vs Slot 4 of the brief. Surface conflicts.
|
|
86
|
+
- If generative is chosen: flag with Path 2 caveat; route through Stage 3 readiness check before runtime.
|
|
87
|
+
|
|
88
|
+
Exit gate: asset plan reconciled with brief. Runtime status unchanged.
|
|
89
|
+
|
|
90
|
+
### Stage 3 — Runtime readiness
|
|
91
|
+
|
|
92
|
+
Goal: ONE selected runtime path that's actually ready, OR explicit "stay text-only" decision.
|
|
93
|
+
|
|
94
|
+
- Load `runtime-setup` to choose Path 1 host (a or b), Path 2, or CLI fallback per client + Blender version + brief preferences.
|
|
95
|
+
- Load `runtime-readiness` to build the readiness matrix (Blender version, MCP host product, Blender-side add-on, MCP server source, output path readiness, single-bridge constraint).
|
|
96
|
+
- If readiness signals are inconsistent (e.g. tool surface doesn't match labeled path, two MCP clients targeting same Blender, port `9876` collision): load `bridge-conflicts`. Build the bridge state matrix. Propose the cheapest resolution. Operator executes. Re-run readiness checker.
|
|
97
|
+
|
|
98
|
+
Exit gate: readiness verdict `Ready` or `Partially Ready` (with documented caveats), OR explicit "stay text-only — runtime out of scope for this run".
|
|
99
|
+
|
|
100
|
+
### Stage 4 — Scene planning
|
|
101
|
+
|
|
102
|
+
Goal: structured scene plan ready for runtime mutation.
|
|
103
|
+
|
|
104
|
+
- Load `product-hero-scene-planner` (subject, scene scope, hero placement, support elements).
|
|
105
|
+
- Load `camera-composition` (framing, focal length, negative space, hero centering).
|
|
106
|
+
- Load `lighting-material-plan` (mood lookdev, light placement, material portability per deliverable target).
|
|
107
|
+
|
|
108
|
+
Exit gate: plans reviewable in plain language; no jargon leak. Runtime status still `Not Run`.
|
|
109
|
+
|
|
110
|
+
### Stage 5 — Quality gate
|
|
111
|
+
|
|
112
|
+
Goal: Pass / Warn / Fail readiness verdict before any runtime mutation.
|
|
113
|
+
|
|
114
|
+
- Load `scene-readiness`. Score the plan against the rubric.
|
|
115
|
+
- If verdict is Pass: proceed to Stage 6.
|
|
116
|
+
- If verdict is Warn: record explicit caveats; user decides whether to proceed.
|
|
117
|
+
- If verdict is Fail: route back to the relevant Stage 4 planner.
|
|
118
|
+
- If post-runtime output diverges from intent (loop-back from Stage 6): load `blender-troubleshooting` for 4-phase root-cause; then route the proposed fix to the correct upstream stage.
|
|
119
|
+
|
|
120
|
+
Exit gate: explicit Pass or Warn-with-caveats. Runtime status still `Not Run`.
|
|
121
|
+
|
|
122
|
+
### Stage 6 — Evidence + verification
|
|
123
|
+
|
|
124
|
+
Goal: honest evidence record per artifact + 7-point pre-handoff gate before "ready" claim.
|
|
125
|
+
|
|
126
|
+
- Load `render-export-evidence`. For each artifact item (preview / render / GLB / blend), walk the truth-label decision tree (`Not Run` → `Attempted` → `Produced` → `Verified` / `Failed`). Save evidence file under `docs/evals/path-X-...md` using the templates in `skills/render-export-evidence/references/evidence-record-templates.md`.
|
|
127
|
+
- Load `pre-handoff-verification`. Run all 7 checks (claim named, path attribution, artifact paths exist, validation notes, tool names, no-mutation guarantee for read-only smoke, plain language). Confirm or downgrade the claim. Never upgrade.
|
|
128
|
+
|
|
129
|
+
Exit gate: evidence file exists + 7-point gate verdict (Pass / Warn / Fail) recorded. Truth label finalized.
|
|
130
|
+
|
|
131
|
+
### Stage 7 — Handoff + final response
|
|
132
|
+
|
|
133
|
+
Goal: plain-language response to non-Blender stakeholders.
|
|
134
|
+
|
|
135
|
+
- If GLB / web is in scope: load `glb-web-handoff`. Add R3F / Three.js snippets, performance caveats, artifact-status language per the bundled references.
|
|
136
|
+
- Always: load `plain-language-response`. Produce final user-facing response. Cite truth labels (`Not Run` / `Verified` etc.) explicitly. No Blender jargon without inline explanation.
|
|
137
|
+
|
|
138
|
+
Exit gate: response confirmed plain-language by check 7 of `pre-handoff-verification` (which already ran in Stage 6).
|
|
139
|
+
|
|
140
|
+
## Outputs
|
|
141
|
+
|
|
142
|
+
| Output | Source stage |
|
|
143
|
+
|---|---|
|
|
144
|
+
| confirmed intent paragraph | Stage 1 |
|
|
145
|
+
| 8-slot 3D brief | Stage 1 |
|
|
146
|
+
| per-asset acquisition plan | Stage 2 |
|
|
147
|
+
| runtime readiness matrix | Stage 3 |
|
|
148
|
+
| (optional) bridge state matrix + resolution | Stage 3 |
|
|
149
|
+
| structured scene plan | Stage 4 |
|
|
150
|
+
| composition + lighting + material plans | Stage 4 |
|
|
151
|
+
| quality gate verdict | Stage 5 |
|
|
152
|
+
| (optional) 4-phase troubleshooting record | Stage 5 |
|
|
153
|
+
| per-artifact evidence file under `docs/evals/path-X-...md` | Stage 6 |
|
|
154
|
+
| 7-point pre-handoff verification verdict | Stage 6 |
|
|
155
|
+
| (if GLB / web) handoff caveats + snippets | Stage 7 |
|
|
156
|
+
| plain-language final response | Stage 7 |
|
|
157
|
+
|
|
158
|
+
## Validation gates
|
|
159
|
+
|
|
160
|
+
- Gate A: brief echoed and confirmed (Stage 1)
|
|
161
|
+
- Gate B: asset budget reconciled (Stage 2)
|
|
162
|
+
- Gate C: runtime path selected and ready, OR explicit text-only decision (Stage 3)
|
|
163
|
+
- Gate D: scene + composition + lighting plans reviewable (Stage 4)
|
|
164
|
+
- Gate E: quality gate Pass or Warn-with-caveats (Stage 5)
|
|
165
|
+
- Gate F: evidence file + pre-handoff verification verdict recorded (Stage 6)
|
|
166
|
+
- Gate G: final response passes plain-language check 7 (Stage 7)
|
|
167
|
+
|
|
168
|
+
## Failure modes
|
|
169
|
+
|
|
170
|
+
- intent ambiguity unresolved → loop back to Stage 1
|
|
171
|
+
- license unknown / TBD on a hero asset → loop back to Stage 2 + brief slot 4
|
|
172
|
+
- runtime path unavailable / blocked → either choose different path in Stage 3 or stay text-only
|
|
173
|
+
- quality gate Fail → loop back to relevant Stage 4 planner
|
|
174
|
+
- runtime output diverges from intent → load `blender-troubleshooting`; route fix upstream per `divergence-routing-table.md`
|
|
175
|
+
- pre-handoff verification Fail (3+ checks) → route to `blender-troubleshooting`; do not let the deliverable through
|
|
176
|
+
|
|
177
|
+
## Runtime evidence expectations
|
|
178
|
+
|
|
179
|
+
Every run that reaches Stage 6 must capture:
|
|
180
|
+
|
|
181
|
+
- selected path + host option (Path 1 host a, Path 1 host b, Path 2, CLI fallback, or text-only)
|
|
182
|
+
- `blender --version` verbatim
|
|
183
|
+
- Blender-side add-on identity (Lab MCP add-on version OR `mcp-for-blender` `addon.py` commit)
|
|
184
|
+
- MCP server source (`.mcpb` filename / source commit / `uvx mcp-for-blender` version)
|
|
185
|
+
- MCP host product + version
|
|
186
|
+
- exact tool names called + responses
|
|
187
|
+
- single-bridge constraint check
|
|
188
|
+
- no-mutation guarantee (for read-only smoke claims)
|
|
189
|
+
|
|
190
|
+
## Final response format
|
|
191
|
+
|
|
192
|
+
1. What you asked for (one-paragraph restatement)
|
|
193
|
+
2. What is ready now (per-artifact truth label)
|
|
194
|
+
3. What is not fully verified yet (per-artifact downgrades + reasons)
|
|
195
|
+
4. Recommended next action (next-skill or operator action named)
|
|
196
|
+
|
|
197
|
+
## Relationship to other workflows
|
|
198
|
+
|
|
199
|
+
- [`product-hero-workflow.md`](./product-hero-workflow.md) is a narrower product-hero-specific subset. Use it when the request is specifically a product hero scene; use this full workflow when the request is broader.
|
|
200
|
+
- Recipes under `docs/recipes/` are scenario-specific instantiations of this workflow.
|
|
201
|
+
|
|
202
|
+
## Skipping stages
|
|
203
|
+
|
|
204
|
+
| Scenario | Skip |
|
|
205
|
+
|---|---|
|
|
206
|
+
| User provides a complete structured brief | Stage 1 brainstorming (jump to brief writer) |
|
|
207
|
+
| User supplies all assets | Stage 2 |
|
|
208
|
+
| Runtime not in scope | Stage 3, 6 (mutation/render/export); stop after Stage 5 |
|
|
209
|
+
| Iteration on existing scene | Stages 1, 2 (jump to relevant planner or troubleshooting) |
|
|
210
|
+
| Read-only smoke run only | Stop after Stage 3 with smoke evidence record |
|