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,261 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: interior-scene
|
|
3
|
+
description: Plan an interior architectural visualization scene (room layout, furniture, materials, natural + artificial lighting) before any modeling or render attempt.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# interior-scene
|
|
7
|
+
|
|
8
|
+
## Purpose
|
|
9
|
+
Translate an interior architectural visualization intent (room or interior space planned for catalog, brand, or showcase) into a complete, structured room plan with an assumptions register. Distinct from `environment-shot` (outdoor/wide places; an establishing shot of an interior room belongs HERE when furniture and surfaces dominate), `product-hero-scene-planner` (single manufactured product), and `character-portrait` (single subject).
|
|
10
|
+
|
|
11
|
+
## Quick start
|
|
12
|
+
- lock style early and pin room type + plausible room dimensions (never invent dimensions; record any defaults in the assumptions register)
|
|
13
|
+
- pin architecture basics (walls, floor, ceiling, windows, doors)
|
|
14
|
+
- pin furniture + props + material palette
|
|
15
|
+
- pin lighting (natural + artificial mix) + mood + time of day
|
|
16
|
+
- pin camera angle + lens
|
|
17
|
+
- emit a structured plan with an assumptions register + handoff to `asset-discovery`, `mobile-glb-budget`, `asset-style-check`, and quality checkers
|
|
18
|
+
|
|
19
|
+
## When to use
|
|
20
|
+
- intent is an interior room, space, or venue where furniture and surfaces dominate (including interior establishing shots)
|
|
21
|
+
- architectural visualization, catalog, brand showcase, hospitality, or residential room planning
|
|
22
|
+
- before any modeling, furniture sourcing, or rendering
|
|
23
|
+
|
|
24
|
+
## When not to use
|
|
25
|
+
<!-- blendops:generated:start exclusions -->
|
|
26
|
+
- outdoor establishing → use `../environment-shot/SKILL.md` (use environment-shot)
|
|
27
|
+
- single hero product → use `../product-hero-scene-planner/SKILL.md` (use product-hero-scene-planner)
|
|
28
|
+
- character portrait → use `../character-portrait/SKILL.md` (use character-portrait)
|
|
29
|
+
<!-- blendops:generated:end exclusions -->
|
|
30
|
+
|
|
31
|
+
## Trigger phrases
|
|
32
|
+
<!-- blendops:generated:start triggers -->
|
|
33
|
+
- "interior of"
|
|
34
|
+
- "living room scene"
|
|
35
|
+
- "office showcase"
|
|
36
|
+
- "hotel lobby"
|
|
37
|
+
- "kitchen showroom"
|
|
38
|
+
<!-- blendops:generated:end triggers -->
|
|
39
|
+
|
|
40
|
+
## Prerequisites / readiness
|
|
41
|
+
- brief from `intent-to-3d-brief-writer`
|
|
42
|
+
- room type + style known
|
|
43
|
+
- aspect / use case known
|
|
44
|
+
|
|
45
|
+
## Input schema
|
|
46
|
+
|
|
47
|
+
### Required inputs
|
|
48
|
+
|
|
49
|
+
| Input | Why it is required |
|
|
50
|
+
|---|---|
|
|
51
|
+
| Room type + plausible dimensions | Drives layout, scale, and furniture fit (dimensions must be plausible, never invented) |
|
|
52
|
+
| Style era / aesthetic | Locked early to drive architecture, material palette, and furniture choices |
|
|
53
|
+
| Time of day + mood | Drives natural light direction, intensity, and artificial fixture balance |
|
|
54
|
+
| Aspect ratio | Drives camera framing and composition rules |
|
|
55
|
+
|
|
56
|
+
### Optional inputs
|
|
57
|
+
|
|
58
|
+
| Input | Use |
|
|
59
|
+
|---|---|
|
|
60
|
+
| Reference images / boards | Style calibration |
|
|
61
|
+
| Brand guidelines | Color, material, and branding alignment |
|
|
62
|
+
| Specific furniture requests | Flagged as rows for `asset-discovery` |
|
|
63
|
+
|
|
64
|
+
### Assumptions to confirm
|
|
65
|
+
- Plausible room dimensions explicitly stated or flagged for confirmation (never silently invented).
|
|
66
|
+
- Style is locked early and consistent across architecture, furniture, and props (validated via `asset-style-check`).
|
|
67
|
+
- Scene scope is realizable within target asset/performance constraints (budget questions routed to `mobile-glb-budget`).
|
|
68
|
+
- Camera position, lens, and target are locked before modeling.
|
|
69
|
+
|
|
70
|
+
## Output schema
|
|
71
|
+
|
|
72
|
+
### Primary output
|
|
73
|
+
A complete interior room plan containing:
|
|
74
|
+
- Room (type, plausible dimensions, locked style)
|
|
75
|
+
- Architecture (walls, floor, ceiling, windows, doors)
|
|
76
|
+
- Furniture + props
|
|
77
|
+
- Material palette (key surfaces + finishes)
|
|
78
|
+
- Lighting (natural light via windows + artificial fixtures + practical lamps)
|
|
79
|
+
- Camera (position, lens, target)
|
|
80
|
+
- Mood + time of day
|
|
81
|
+
- Assumptions register (all unconfirmed inputs and plausible dimension assumptions)
|
|
82
|
+
|
|
83
|
+
### Secondary output
|
|
84
|
+
- asset rows flagged for `asset-discovery`
|
|
85
|
+
- style consistency notes for `asset-style-check`
|
|
86
|
+
- budget questions flagged for `mobile-glb-budget`
|
|
87
|
+
- validation handoff list for `composition-quality-checker`, `lighting-quality-checker`, `material-quality-checker`, and `scene-readiness`
|
|
88
|
+
|
|
89
|
+
### Evidence / caveat output
|
|
90
|
+
|
|
91
|
+
```txt
|
|
92
|
+
Runtime status: Not Run | Attempted | Produced | Verified | Failed
|
|
93
|
+
Artifact status: Not Produced | Produced | Verified | Failed
|
|
94
|
+
Evidence used: <links, paths, logs, or "none">
|
|
95
|
+
Limitations: <known gaps>
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
## Required laws
|
|
99
|
+
- `../../laws/evidence-before-done.md`
|
|
100
|
+
- `../../laws/non-blender-user-language.md`
|
|
101
|
+
- `../../laws/no-arbitrary-python-interface.md`
|
|
102
|
+
- `../../laws/official-runtime-only.md`
|
|
103
|
+
|
|
104
|
+
## Official runtime boundary
|
|
105
|
+
|
|
106
|
+
Planning-only skill — does not model, source furniture, render, or execute Blender. Runtime status stays `Not Run` and artifact status stays `Not Produced` (downgrade-only, never upgrade). Hand off asset sourcing to `asset-discovery`, budget questions to `mobile-glb-budget`, style checks to `asset-style-check`, and validation to `composition-quality-checker`, `lighting-quality-checker`, `material-quality-checker`, and `scene-readiness`.
|
|
107
|
+
|
|
108
|
+
## Operating procedure
|
|
109
|
+
1. Read brief from `intent-to-3d-brief-writer`; lock style early and pin room type + plausible room dimensions (never invent dimensions; log any unconfirmed values in the assumptions register).
|
|
110
|
+
2. Pin architecture basics: walls, floor, ceiling, windows, and doors (see `references/interior-architecture-rules.md`).
|
|
111
|
+
3. Plan furniture layout + props (see `references/furniture-layout-rules.md`).
|
|
112
|
+
4. Pin material palette and key surfaces matching the locked style.
|
|
113
|
+
5. Plan lighting: natural light (windows + sun direction) + artificial light (overhead fixtures + practical lamps).
|
|
114
|
+
6. Pin camera position, lens, and target (see `references/interior-camera-rules.md`).
|
|
115
|
+
7. Pin mood + time of day.
|
|
116
|
+
8. Compile the assumptions register and list asset rows for `asset-discovery`.
|
|
117
|
+
9. Emit handoffs to `asset-discovery`, `mobile-glb-budget`, `asset-style-check`, `composition-quality-checker`, `lighting-quality-checker`, `material-quality-checker`, and `scene-readiness`.
|
|
118
|
+
|
|
119
|
+
## Decision tree
|
|
120
|
+
|
|
121
|
+
```txt
|
|
122
|
+
Room dimensions missing or unrealistic for use case (e.g. 100m² home office)?
|
|
123
|
+
→ Do not invent dimensions; warn, propose plausible defaults in the assumptions register, and verify intent
|
|
124
|
+
Style unclear in brief?
|
|
125
|
+
→ Return to intent-to-3d-brief-writer before planning furniture or materials
|
|
126
|
+
Style + furniture mismatch (e.g. modern brief + ornate Victorian sofa)?
|
|
127
|
+
→ Fail; lock one style early and route to asset-style-check
|
|
128
|
+
Performance or polycount budget in question?
|
|
129
|
+
→ Route budget questions to mobile-glb-budget
|
|
130
|
+
Time of day mid-day but only artificial lighting planned?
|
|
131
|
+
→ Warn; natural window light should be accounted for alongside artificial fixtures
|
|
132
|
+
Wide-angle 14mm in a small room?
|
|
133
|
+
→ Warn; distortion likely; propose 24mm + camera repositioning
|
|
134
|
+
```
|
|
135
|
+
|
|
136
|
+
## Playbooks
|
|
137
|
+
|
|
138
|
+
### Playbook A: Modern living room hero (16:9 catalog)
|
|
139
|
+
24–35mm wide; camera in corner; afternoon natural light through window; sofa + coffee table + rug as primary furniture; minimal palette; soft shadows.
|
|
140
|
+
|
|
141
|
+
### Playbook B: Hospitality lobby (1:1 social)
|
|
142
|
+
35mm; camera centered toward focal art / reception; warm artificial lighting + minimal natural; rich materials.
|
|
143
|
+
|
|
144
|
+
### Playbook C: Office showroom (wide 2.39:1)
|
|
145
|
+
24mm; camera elevated; mix natural + artificial; clean material palette; depth layered (foreground furniture + midground workstations + background views).
|
|
146
|
+
|
|
147
|
+
## Mode handling
|
|
148
|
+
|
|
149
|
+
### Text-only mode
|
|
150
|
+
Emit the structured room plan, assumptions register, and handoff list. Runtime stays `Not Run`; artifacts stay `Not Produced`.
|
|
151
|
+
|
|
152
|
+
### Runtime-ready mode
|
|
153
|
+
Emit the structured room plan, assumptions register, and downstream handoffs. Do not execute Blender; runtime stays `Not Run` and artifacts stay `Not Produced`.
|
|
154
|
+
|
|
155
|
+
### Blocked runtime mode
|
|
156
|
+
Emit the structured room plan and assumptions register; flag what cannot be confirmed downstream. Runtime stays `Not Run`; artifacts stay `Not Produced`.
|
|
157
|
+
|
|
158
|
+
## Validation checklist
|
|
159
|
+
- [ ] Style locked early
|
|
160
|
+
- [ ] Room type + plausible dimensions pinned (never invented)
|
|
161
|
+
- [ ] Assumptions register populated
|
|
162
|
+
- [ ] Architecture basics (walls, floor, ceiling, windows, doors) pinned
|
|
163
|
+
- [ ] Furniture + props listed
|
|
164
|
+
- [ ] Material palette + key surfaces listed
|
|
165
|
+
- [ ] Lighting plan (natural + artificial) explicit
|
|
166
|
+
- [ ] Camera position + lens + target chosen
|
|
167
|
+
- [ ] Mood + time of day pinned
|
|
168
|
+
- [ ] Asset rows flagged for `asset-discovery`
|
|
169
|
+
- [ ] Handoffs named (`mobile-glb-budget`, `asset-style-check`, `composition-quality-checker`, `lighting-quality-checker`, `material-quality-checker`, `scene-readiness`)
|
|
170
|
+
- [ ] Runtime status locked to `Not Run` and Artifact status locked to `Not Produced`
|
|
171
|
+
|
|
172
|
+
## Pass / Warn / Fail rubric
|
|
173
|
+
|
|
174
|
+
| Verdict | Criteria |
|
|
175
|
+
| --- | --- |
|
|
176
|
+
| Pass | All room plan sections complete, style locked early, plausible dimensions with assumptions register, natural + artificial lighting planned, assets flagged, handoffs named, truth states set to `Not Run` / `Not Produced`. |
|
|
177
|
+
| Warn | Minor ambiguity recorded in assumptions register (e.g. secondary prop finish or exact window orientation pending confirmation). |
|
|
178
|
+
| Fail | Invented or implausible room dimensions; missing assumptions register; style + furniture clash; missing lighting or camera plan; truth states upgraded beyond `Not Run` / `Not Produced`. |
|
|
179
|
+
|
|
180
|
+
## Failure handling
|
|
181
|
+
- Unclear brief or style → hand off to `intent-to-3d-brief-writer`.
|
|
182
|
+
- Style mismatch across assets → hand off to `asset-style-check`.
|
|
183
|
+
- Unknown asset or performance budget → hand off to `mobile-glb-budget`.
|
|
184
|
+
- Composition, lighting, material, or overall scene validation issues → hand off to `composition-quality-checker`, `lighting-quality-checker`, `material-quality-checker`, and `scene-readiness`.
|
|
185
|
+
|
|
186
|
+
## Troubleshooting
|
|
187
|
+
|
|
188
|
+
| Problem | Resolution |
|
|
189
|
+
| --- | --- |
|
|
190
|
+
| Room dimensions not supplied by user | Do not invent silently; propose standard plausible dimensions in the assumptions register and request confirmation. |
|
|
191
|
+
| Planned layout feels empty or lacks depth | Add foreground/midground prop layers in the plan, place camera in a corner rather than room center, and flag for `composition-quality-checker`. |
|
|
192
|
+
| Planned lighting lacks contrast | Balance natural window light direction with warm artificial practical lamps, and flag for `lighting-quality-checker`. |
|
|
193
|
+
| Planned materials or furniture clash | Lock the style palette early and route to `asset-style-check` and `material-quality-checker`. |
|
|
194
|
+
| Wide-angle lens distortion risk in small room | Plan for a 24–35mm lens with corner camera placement and verify via `composition-quality-checker`. |
|
|
195
|
+
|
|
196
|
+
## Best practices
|
|
197
|
+
- Plan natural + artificial lighting together; they form a system.
|
|
198
|
+
- Always provide a camera in corner (not center) for room scenes — center loses depth.
|
|
199
|
+
- Lock palette early (3–5 colors max).
|
|
200
|
+
- Treat windows as light sources, not decorations.
|
|
201
|
+
|
|
202
|
+
## Good examples
|
|
203
|
+
- "Room: modern minimalist living room, 4×6m, ceiling 2.7m, style locked to warm Scandinavian modern. Architecture: light oak floor, matte white walls, floor-to-ceiling window on south wall, fireplace center back, flush wood door on east wall. Furniture + props: 3-seat neutral fabric sofa facing fireplace, low oak coffee table, woven area rug, single armchair right, ceramic vase on table. Material palette: light oak, matte white plaster, brushed concrete, warm grey linen. Lighting: afternoon natural sunlight through south window (dominant) + 2 recessed ceiling lights + 1 warm floor lamp by armchair. Camera: 35mm lens, north-east corner at eye-level, targeting sofa and fireplace framing. Mood + time of day: calm, warm afternoon (15:00). Assumptions register: 2.7m ceiling height assumed as plausible residential standard pending user confirmation; standard doorway width assumed. Runtime status: Not Run. Artifact status: Not Produced."
|
|
204
|
+
|
|
205
|
+
## Bad examples
|
|
206
|
+
- "Living room scene." — no dims, style, lighting, or camera.
|
|
207
|
+
|
|
208
|
+
## User-facing response template
|
|
209
|
+
|
|
210
|
+
```txt
|
|
211
|
+
Room: <type / plausible dims / locked style>
|
|
212
|
+
Architecture: <walls / floor / ceiling / windows / doors>
|
|
213
|
+
Furniture + props: <list>
|
|
214
|
+
Material palette: <3-5 dominant finishes>
|
|
215
|
+
Key surfaces: <floor / wall / ceiling / furniture fabric>
|
|
216
|
+
Lighting: Natural: <window + sun direction + intensity> | Artificial: <ceiling fixtures + practical lamps> | Ambient environment: <sky/exterior bounce if any>
|
|
217
|
+
Camera: <focal length> | <position> | <eye-line> | <target>
|
|
218
|
+
Mood + time of day: <line>
|
|
219
|
+
Assumptions register: <explicitly confirmed vs assumed plausible dimensions, style locks, and constraints>
|
|
220
|
+
|
|
221
|
+
Assets to discover (for asset-discovery): <list>
|
|
222
|
+
Runtime status: Not Run
|
|
223
|
+
Artifact status: Not Produced
|
|
224
|
+
Evidence used: <brief / inputs or "none">
|
|
225
|
+
Limitations: <gaps>
|
|
226
|
+
Next: asset-discovery | mobile-glb-budget | asset-style-check | composition-quality-checker | lighting-quality-checker | material-quality-checker | scene-readiness
|
|
227
|
+
```
|
|
228
|
+
|
|
229
|
+
## Anti-patterns
|
|
230
|
+
- Center-of-room camera for hero shots (loses depth).
|
|
231
|
+
- Skipping window light when natural light is available.
|
|
232
|
+
- Mixing style eras without intent.
|
|
233
|
+
- Inventing room dimensions.
|
|
234
|
+
|
|
235
|
+
## Cross-skill handoff
|
|
236
|
+
<!-- blendops:generated:start handoffs -->
|
|
237
|
+
- [upstream_reference] Upstream brief → `../intent-to-3d-brief-writer/SKILL.md`
|
|
238
|
+
- [upstream_reference] Outdoor / wide establishing shot redirect → `../environment-shot/SKILL.md`
|
|
239
|
+
- [upstream_reference] Single hero product redirect → `../product-hero-scene-planner/SKILL.md`
|
|
240
|
+
- [upstream_reference] Single character portrait redirect → `../character-portrait/SKILL.md`
|
|
241
|
+
- [upstream_reference] Asset discovery → `../asset-discovery/SKILL.md`
|
|
242
|
+
- [upstream_reference] Performance / polycount budget → `../mobile-glb-budget/SKILL.md`
|
|
243
|
+
- [upstream_reference] Style consistency check → `../asset-style-check/SKILL.md`
|
|
244
|
+
- [progression] Composition validation → `../composition-quality-checker/SKILL.md`
|
|
245
|
+
- [progression] Lighting validation → `../lighting-quality-checker/SKILL.md`
|
|
246
|
+
- [progression] Material validation → `../material-quality-checker/SKILL.md`
|
|
247
|
+
- [progression] Scene quality validation → `../scene-readiness/SKILL.md`
|
|
248
|
+
<!-- blendops:generated:end handoffs -->
|
|
249
|
+
|
|
250
|
+
## Non-goals
|
|
251
|
+
- Model the room or geometry.
|
|
252
|
+
- Source furniture or download assets (belongs to `asset-discovery`).
|
|
253
|
+
- Decide performance or polycount budgets (belongs to `mobile-glb-budget`).
|
|
254
|
+
- Audit cross-asset style consistency or validate composition, lighting, materials, or scene quality (belongs to `asset-style-check`, `composition-quality-checker`, `lighting-quality-checker`, `material-quality-checker`, and `scene-readiness`).
|
|
255
|
+
- Render or run Blender.
|
|
256
|
+
|
|
257
|
+
## References
|
|
258
|
+
- `references/interior-architecture-rules.md`
|
|
259
|
+
- `references/furniture-layout-rules.md`
|
|
260
|
+
- `references/interior-camera-rules.md`
|
|
261
|
+
- `../../docs/skill-system.md`
|
|
@@ -0,0 +1,277 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "../../schemas/skill-contract.schema.json",
|
|
3
|
+
"id": "interior-scene",
|
|
4
|
+
"version": "1.0.0",
|
|
5
|
+
"category": "scene-planners",
|
|
6
|
+
"role": "interior-archviz-scene-architect",
|
|
7
|
+
"purpose": "Plan an interior architectural visualization scene (room layout, furniture, materials, natural + artificial lighting) before any modeling or render attempt.",
|
|
8
|
+
"capabilityTier": "L0",
|
|
9
|
+
"triggers": [
|
|
10
|
+
"interior of",
|
|
11
|
+
"living room scene",
|
|
12
|
+
"office showcase",
|
|
13
|
+
"hotel lobby",
|
|
14
|
+
"kitchen showroom"
|
|
15
|
+
],
|
|
16
|
+
"exclusions": [
|
|
17
|
+
{
|
|
18
|
+
"condition": "outdoor establishing",
|
|
19
|
+
"delegateTo": "environment-shot",
|
|
20
|
+
"reason": "use environment-shot"
|
|
21
|
+
},
|
|
22
|
+
{
|
|
23
|
+
"condition": "single hero product",
|
|
24
|
+
"delegateTo": "product-hero-scene-planner",
|
|
25
|
+
"reason": "use product-hero-scene-planner"
|
|
26
|
+
},
|
|
27
|
+
{
|
|
28
|
+
"condition": "character portrait",
|
|
29
|
+
"delegateTo": "character-portrait",
|
|
30
|
+
"reason": "use character-portrait"
|
|
31
|
+
}
|
|
32
|
+
],
|
|
33
|
+
"inputs": {
|
|
34
|
+
"required": [
|
|
35
|
+
{
|
|
36
|
+
"name": "locked_3d_brief",
|
|
37
|
+
"type": "object",
|
|
38
|
+
"description": "Locked 3D brief specifying room type, architectural style, focal zone, and daylight/artificial mood"
|
|
39
|
+
},
|
|
40
|
+
{
|
|
41
|
+
"name": "room_dimensions_and_openings",
|
|
42
|
+
"type": "object",
|
|
43
|
+
"description": "Architectural envelope, window/door openings, and primary furniture anchor zones"
|
|
44
|
+
}
|
|
45
|
+
],
|
|
46
|
+
"optional": [
|
|
47
|
+
{
|
|
48
|
+
"name": "sourced_furniture_and_finish_assets",
|
|
49
|
+
"type": "array",
|
|
50
|
+
"description": "Available furniture and architectural material assets from asset-discovery"
|
|
51
|
+
}
|
|
52
|
+
]
|
|
53
|
+
},
|
|
54
|
+
"outputs": {
|
|
55
|
+
"primary": [
|
|
56
|
+
"interior_zone_and_circulation_plan",
|
|
57
|
+
"window_portal_and_fixture_lighting_plan",
|
|
58
|
+
"two_point_vertical_camera_constraints"
|
|
59
|
+
],
|
|
60
|
+
"truthStatePolicy": {
|
|
61
|
+
"runtimeDefault": "Not Run",
|
|
62
|
+
"artifactDefault": "Not Produced",
|
|
63
|
+
"mutationRule": "downgrade_only"
|
|
64
|
+
}
|
|
65
|
+
},
|
|
66
|
+
"handoffs": [
|
|
67
|
+
{
|
|
68
|
+
"target": "intent-to-3d-brief-writer",
|
|
69
|
+
"type": "upstream_reference",
|
|
70
|
+
"label": "Upstream brief",
|
|
71
|
+
"when": {
|
|
72
|
+
"all": [
|
|
73
|
+
{
|
|
74
|
+
"field": "goal.clarity",
|
|
75
|
+
"operator": "equals",
|
|
76
|
+
"value": "clear"
|
|
77
|
+
},
|
|
78
|
+
{
|
|
79
|
+
"field": "brief.locked",
|
|
80
|
+
"operator": "equals",
|
|
81
|
+
"value": false
|
|
82
|
+
}
|
|
83
|
+
]
|
|
84
|
+
}
|
|
85
|
+
},
|
|
86
|
+
{
|
|
87
|
+
"target": "environment-shot",
|
|
88
|
+
"type": "upstream_reference",
|
|
89
|
+
"label": "Outdoor / wide establishing shot redirect",
|
|
90
|
+
"when": {
|
|
91
|
+
"all": [
|
|
92
|
+
{
|
|
93
|
+
"field": "brief.locked",
|
|
94
|
+
"operator": "equals",
|
|
95
|
+
"value": true
|
|
96
|
+
},
|
|
97
|
+
{
|
|
98
|
+
"field": "recipe.domain",
|
|
99
|
+
"operator": "equals",
|
|
100
|
+
"value": "environment_shot"
|
|
101
|
+
}
|
|
102
|
+
]
|
|
103
|
+
}
|
|
104
|
+
},
|
|
105
|
+
{
|
|
106
|
+
"target": "product-hero-scene-planner",
|
|
107
|
+
"type": "upstream_reference",
|
|
108
|
+
"label": "Single hero product redirect",
|
|
109
|
+
"when": {
|
|
110
|
+
"all": [
|
|
111
|
+
{
|
|
112
|
+
"field": "brief.locked",
|
|
113
|
+
"operator": "equals",
|
|
114
|
+
"value": true
|
|
115
|
+
},
|
|
116
|
+
{
|
|
117
|
+
"field": "recipe.domain",
|
|
118
|
+
"operator": "equals",
|
|
119
|
+
"value": "product_hero"
|
|
120
|
+
}
|
|
121
|
+
]
|
|
122
|
+
}
|
|
123
|
+
},
|
|
124
|
+
{
|
|
125
|
+
"target": "character-portrait",
|
|
126
|
+
"type": "upstream_reference",
|
|
127
|
+
"label": "Single character portrait redirect",
|
|
128
|
+
"when": {
|
|
129
|
+
"all": [
|
|
130
|
+
{
|
|
131
|
+
"field": "brief.locked",
|
|
132
|
+
"operator": "equals",
|
|
133
|
+
"value": true
|
|
134
|
+
},
|
|
135
|
+
{
|
|
136
|
+
"field": "recipe.domain",
|
|
137
|
+
"operator": "equals",
|
|
138
|
+
"value": "character_portrait"
|
|
139
|
+
}
|
|
140
|
+
]
|
|
141
|
+
}
|
|
142
|
+
},
|
|
143
|
+
{
|
|
144
|
+
"target": "asset-discovery",
|
|
145
|
+
"type": "upstream_reference",
|
|
146
|
+
"label": "Asset discovery",
|
|
147
|
+
"when": {
|
|
148
|
+
"all": [
|
|
149
|
+
{
|
|
150
|
+
"field": "brief.locked",
|
|
151
|
+
"operator": "equals",
|
|
152
|
+
"value": true
|
|
153
|
+
},
|
|
154
|
+
{
|
|
155
|
+
"field": "assets.discoveryComplete",
|
|
156
|
+
"operator": "equals",
|
|
157
|
+
"value": false
|
|
158
|
+
}
|
|
159
|
+
]
|
|
160
|
+
}
|
|
161
|
+
},
|
|
162
|
+
{
|
|
163
|
+
"target": "mobile-glb-budget",
|
|
164
|
+
"type": "upstream_reference",
|
|
165
|
+
"label": "Performance / polycount budget",
|
|
166
|
+
"when": {
|
|
167
|
+
"all": [
|
|
168
|
+
{
|
|
169
|
+
"field": "artifact.type",
|
|
170
|
+
"operator": "equals",
|
|
171
|
+
"value": "glb"
|
|
172
|
+
},
|
|
173
|
+
{
|
|
174
|
+
"field": "budget.pinned",
|
|
175
|
+
"operator": "equals",
|
|
176
|
+
"value": false
|
|
177
|
+
}
|
|
178
|
+
]
|
|
179
|
+
}
|
|
180
|
+
},
|
|
181
|
+
{
|
|
182
|
+
"target": "asset-style-check",
|
|
183
|
+
"type": "upstream_reference",
|
|
184
|
+
"label": "Style consistency check",
|
|
185
|
+
"when": {
|
|
186
|
+
"all": [
|
|
187
|
+
{
|
|
188
|
+
"field": "assets.licenseCleared",
|
|
189
|
+
"operator": "equals",
|
|
190
|
+
"value": true
|
|
191
|
+
},
|
|
192
|
+
{
|
|
193
|
+
"field": "stage.current",
|
|
194
|
+
"operator": "equals",
|
|
195
|
+
"value": "style_check"
|
|
196
|
+
}
|
|
197
|
+
]
|
|
198
|
+
}
|
|
199
|
+
},
|
|
200
|
+
{
|
|
201
|
+
"target": "composition-quality-checker",
|
|
202
|
+
"type": "progression",
|
|
203
|
+
"label": "Composition validation",
|
|
204
|
+
"when": {
|
|
205
|
+
"all": [
|
|
206
|
+
{
|
|
207
|
+
"field": "quality.domain",
|
|
208
|
+
"operator": "equals",
|
|
209
|
+
"value": "composition"
|
|
210
|
+
},
|
|
211
|
+
{
|
|
212
|
+
"field": "quality.verdict",
|
|
213
|
+
"operator": "equals",
|
|
214
|
+
"value": "not_run"
|
|
215
|
+
}
|
|
216
|
+
]
|
|
217
|
+
}
|
|
218
|
+
},
|
|
219
|
+
{
|
|
220
|
+
"target": "lighting-quality-checker",
|
|
221
|
+
"type": "progression",
|
|
222
|
+
"label": "Lighting validation",
|
|
223
|
+
"when": {
|
|
224
|
+
"all": [
|
|
225
|
+
{
|
|
226
|
+
"field": "quality.domain",
|
|
227
|
+
"operator": "equals",
|
|
228
|
+
"value": "lighting"
|
|
229
|
+
},
|
|
230
|
+
{
|
|
231
|
+
"field": "quality.verdict",
|
|
232
|
+
"operator": "equals",
|
|
233
|
+
"value": "not_run"
|
|
234
|
+
}
|
|
235
|
+
]
|
|
236
|
+
}
|
|
237
|
+
},
|
|
238
|
+
{
|
|
239
|
+
"target": "material-quality-checker",
|
|
240
|
+
"type": "progression",
|
|
241
|
+
"label": "Material validation",
|
|
242
|
+
"when": {
|
|
243
|
+
"all": [
|
|
244
|
+
{
|
|
245
|
+
"field": "quality.domain",
|
|
246
|
+
"operator": "equals",
|
|
247
|
+
"value": "material"
|
|
248
|
+
},
|
|
249
|
+
{
|
|
250
|
+
"field": "quality.verdict",
|
|
251
|
+
"operator": "equals",
|
|
252
|
+
"value": "not_run"
|
|
253
|
+
}
|
|
254
|
+
]
|
|
255
|
+
}
|
|
256
|
+
},
|
|
257
|
+
{
|
|
258
|
+
"target": "scene-readiness",
|
|
259
|
+
"type": "progression",
|
|
260
|
+
"label": "Scene quality validation",
|
|
261
|
+
"when": {
|
|
262
|
+
"all": [
|
|
263
|
+
{
|
|
264
|
+
"field": "quality.domain",
|
|
265
|
+
"operator": "equals",
|
|
266
|
+
"value": "holistic"
|
|
267
|
+
},
|
|
268
|
+
{
|
|
269
|
+
"field": "stage.current",
|
|
270
|
+
"operator": "equals",
|
|
271
|
+
"value": "quality_validation"
|
|
272
|
+
}
|
|
273
|
+
]
|
|
274
|
+
}
|
|
275
|
+
}
|
|
276
|
+
]
|
|
277
|
+
}
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
# Furniture layout rules
|
|
2
|
+
|
|
3
|
+
## Living room baseline
|
|
4
|
+
|
|
5
|
+
- Sofa facing focal point (fireplace / TV / window view).
|
|
6
|
+
- Coffee table 40–50cm from sofa, height matching sofa seat.
|
|
7
|
+
- Area rug under or anchoring the seating area.
|
|
8
|
+
- Optional armchair + side table + floor lamp.
|
|
9
|
+
- Negative space behind / around furniture for camera angles.
|
|
10
|
+
|
|
11
|
+
## Bedroom baseline
|
|
12
|
+
|
|
13
|
+
- Bed centered against one wall (head against wall, not under window).
|
|
14
|
+
- Bedside tables symmetric.
|
|
15
|
+
- Wardrobe along longer wall.
|
|
16
|
+
- Optional reading chair + lamp.
|
|
17
|
+
|
|
18
|
+
## Office baseline
|
|
19
|
+
|
|
20
|
+
- Desk facing into room (back to wall) or facing window.
|
|
21
|
+
- Chair clearance 80cm behind desk.
|
|
22
|
+
- Bookshelf or storage along long wall.
|
|
23
|
+
- Single accent chair for visitors.
|
|
24
|
+
|
|
25
|
+
## Kitchen baseline
|
|
26
|
+
|
|
27
|
+
- Triangle: stove / sink / fridge within reachable distance.
|
|
28
|
+
- Counter depth 60cm; clearance 90–120cm.
|
|
29
|
+
- Island optional; requires 1.2m+ clearance all sides.
|
|
30
|
+
|
|
31
|
+
## Hospitality lobby baseline
|
|
32
|
+
|
|
33
|
+
- Reception / focal art on focal wall.
|
|
34
|
+
- Seating clusters (2-3 sofas + armchair + table).
|
|
35
|
+
- Path of travel clear from entrance to elevators / desk.
|
|
36
|
+
|
|
37
|
+
## Camera-friendly arrangement
|
|
38
|
+
|
|
39
|
+
- Place "hero furniture piece" (sofa, dining table, bed) so the camera can frame it from a corner.
|
|
40
|
+
- Avoid blocking camera path with door or low-ceiling beam.
|
|
41
|
+
- Foreground prop (lamp / armchair) gives depth.
|
|
42
|
+
|
|
43
|
+
## Common failures
|
|
44
|
+
|
|
45
|
+
- Furniture floating in center of room (no anchor).
|
|
46
|
+
- Sofa pressed against window (blocks light).
|
|
47
|
+
- Multiple focal points fighting (TV + fireplace + view all visible).
|
|
48
|
+
- No path of travel between camera and back wall.
|
|
49
|
+
|
|
50
|
+
## Related skill
|
|
51
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
# Interior architecture rules
|
|
2
|
+
|
|
3
|
+
## Standard room dimensions
|
|
4
|
+
|
|
5
|
+
| Room type | Typical area (m²) | Typical ceiling (m) |
|
|
6
|
+
|---|---|---|
|
|
7
|
+
| Bedroom (single) | 9–14 | 2.4–2.7 |
|
|
8
|
+
| Bedroom (master) | 14–25 | 2.4–2.7 |
|
|
9
|
+
| Living room | 16–35 | 2.4–3.0 |
|
|
10
|
+
| Kitchen | 8–18 | 2.4–2.7 |
|
|
11
|
+
| Bathroom | 4–10 | 2.3–2.6 |
|
|
12
|
+
| Open-plan living/dining | 30–60 | 2.7–3.5 |
|
|
13
|
+
| Hotel lobby | 50–200 | 3.5–6.0 |
|
|
14
|
+
| Office (small) | 10–30 | 2.7–3.0 |
|
|
15
|
+
| Office (open-plan) | 50–500+ | 2.7–3.5 |
|
|
16
|
+
|
|
17
|
+
## Floor / wall / ceiling
|
|
18
|
+
|
|
19
|
+
| Style | Floor | Walls | Ceiling |
|
|
20
|
+
|---|---|---|---|
|
|
21
|
+
| Modern minimalist | Light wood / polished concrete | White / light gray | Flat white |
|
|
22
|
+
| Mid-century modern | Wood (medium tone) | Cream / olive / accent walls | White |
|
|
23
|
+
| Industrial | Concrete | Exposed brick / dark gray | Exposed beams / ducts |
|
|
24
|
+
| Scandinavian | White-washed wood | White | White |
|
|
25
|
+
| Traditional | Hardwood | Cream / muted | Coffered |
|
|
26
|
+
| Hotel hospitality | Marble / travertine | Wood paneling / fabric | Coffered / dropped |
|
|
27
|
+
|
|
28
|
+
## Windows
|
|
29
|
+
|
|
30
|
+
- Natural light driver — plan window placement before furniture.
|
|
31
|
+
- Window-to-floor ratio: 10–25% for daylit spaces.
|
|
32
|
+
- Orientation matters: south-facing (NH) gets sun all day; east = morning; west = afternoon; north = soft diffuse.
|
|
33
|
+
- Single window vs floor-to-ceiling vs corner glazing → very different look.
|
|
34
|
+
|
|
35
|
+
## Doors
|
|
36
|
+
|
|
37
|
+
- Position relative to camera: avoid placing prominent door behind subject.
|
|
38
|
+
- Standard door: 0.9m × 2.1m.
|
|
39
|
+
|
|
40
|
+
## Common consistency failures
|
|
41
|
+
|
|
42
|
+
- Modern minimalist style + ornate Victorian moldings → Fail.
|
|
43
|
+
- Floor-to-ceiling window + heavy curtains in modern brief → Warn.
|
|
44
|
+
- Mixed era furniture without intent → Fail.
|
|
45
|
+
|
|
46
|
+
## Related skill
|
|
47
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
# Interior camera rules
|
|
2
|
+
|
|
3
|
+
## Position
|
|
4
|
+
|
|
5
|
+
- **Corner shot (default)**: camera in one corner, looking diagonally across room. Maximizes visible space and depth.
|
|
6
|
+
- **Doorway shot**: camera at door, looking in. Mimics entry POV.
|
|
7
|
+
- **Hero furniture shot**: camera framed on focal furniture piece; rest of room secondary.
|
|
8
|
+
|
|
9
|
+
## Lens
|
|
10
|
+
|
|
11
|
+
| Use case | Equivalent focal length |
|
|
12
|
+
|---|---|
|
|
13
|
+
| Tight room (< 15m²) | 24–35mm |
|
|
14
|
+
| Standard room (15–40m²) | 24–28mm |
|
|
15
|
+
| Large open-plan (>40m²) | 18–24mm |
|
|
16
|
+
| Hospitality lobby / large venue | 14–24mm |
|
|
17
|
+
|
|
18
|
+
Avoid lenses < 14mm for arch viz interior — fisheye distortion is rarely flattering.
|
|
19
|
+
|
|
20
|
+
## Eye-line
|
|
21
|
+
|
|
22
|
+
- Standard: 1.5–1.7m (human eye-level).
|
|
23
|
+
- Slightly low (0.9–1.2m): emphasizes ceiling height + sense of space.
|
|
24
|
+
- Eye-level seated (1.0–1.2m): emphasizes seating area.
|
|
25
|
+
- Top-down: rare; only for floor-plan visualization.
|
|
26
|
+
|
|
27
|
+
## Tilt
|
|
28
|
+
|
|
29
|
+
- Level (no tilt): standard arch viz.
|
|
30
|
+
- Slight up (0–3°): enhances ceiling height.
|
|
31
|
+
- Slight down (0–3°): emphasizes flooring / objects on floor.
|
|
32
|
+
- Avoid > 5° tilt; reads as cinematic, not arch viz.
|
|
33
|
+
|
|
34
|
+
## Common camera failures
|
|
35
|
+
|
|
36
|
+
- Center of room → loses depth.
|
|
37
|
+
- Eye-line too low (0.5m) → unnatural perspective.
|
|
38
|
+
- Wide-angle in a small room → distortion in foreground furniture.
|
|
39
|
+
- Camera too close to wall (< 0.5m) → wall distortion.
|
|
40
|
+
- Two-point perspective vs three-point: arch viz typically uses two-point (verticals stay vertical).
|
|
41
|
+
|
|
42
|
+
## Two-point perspective
|
|
43
|
+
|
|
44
|
+
To preserve verticals (walls stay vertical, no tilt), use **camera shift** in Blender's camera properties or align camera level. Arch viz convention is two-point.
|
|
45
|
+
|
|
46
|
+
## Related skill
|
|
47
|
+
`../SKILL.md`
|