Interior Architectural Scene Planner

interior-architectural-scene-planner

Purpose

Translate an interior arch viz intent (room / interior space planned for catalog / brand / showcase) into a structured scene plan. Distinct from environment-establishing-shot-planner (outdoor/wide) and product-hero-scene-planner (single product hero).

Quick start

• pin room type + dimensions + style
• pin furniture + props + key materials
• pin lighting (natural + artificial mix)
• pin camera angle + lens
• pin mood + time of day
• emit a structured plan + handoff to checkers

When to use

• intent is interior room / space / venue
• arch viz / catalog / brand / showcase / hospitality / residential
• before any modeling

When not to use

• outdoor establishing (use environment-establishing-shot-planner)
• single hero product (use product-hero-scene-planner)
• character portrait (use character-portrait-scene-planner)

Trigger phrases

• "interior of"
• "living room scene"
• "office showcase"
• "hotel lobby"
• "kitchen showroom"

Prerequisites / readiness

• brief from intent-to-3d-brief-writer
• room type + style known
• aspect / use case known

Input schema

Required inputs

| Input | Why it is required | |---|---| | Room type | Drives layout + furniture | | Style era / aesthetic | Drives material + furniture choices | | Time of day | Drives natural light direction + intensity | | Aspect ratio | Composition rules |

Optional inputs

| Input | Use | |---|---| | Reference images / boards | Style calibration | | Brand guidelines | Color + material + branding | | Specific furniture brand requests | Asset sourcing |

Assumptions to confirm

• Room is realizable in a reasonable budget (asset / polycount).
• Style is consistent across architecture + furniture + props.
• Camera is locked.

Output schema

Primary output

A structured interior arch viz plan: Room (type / dims / style), Architecture (walls / floor / ceiling / windows / doors), Furniture + props, Materials (palette + key surfaces), Lighting (natural via windows + artificial fixtures + practicals), Camera (position / lens / target), Mood + time of day.

Secondary output

• asset list flagged for blender-asset-discovery-planner
• branding / palette notes
• handoff list

Evidence / caveat output

Runtime status: Not Run | Attempted | Produced | Verified | Failed | Blocked / Not Run
Artifact status: Not Run | Not Produced | Produced | Verified | Failed
Evidence used: 
Limitations: 

Required laws

• ../../laws/evidence-before-done.md
• ../../laws/non-blender-user-language.md
• ../../laws/no-arbitrary-python-interface.md
• ../../laws/official-runtime-only.md

Official runtime boundary

Planning skill — does not run Blender, model, or render. Hand off to discovery / quality checkers.

Operating procedure

1. Read brief; pin room type + style.
2. Pin architecture basics (see references/interior-architecture-rules.md).
3. Plan furniture layout + props (see references/furniture-layout-rules.md).
4. Pin material palette (per style + brand).
5. Plan lighting: natural (windows + sun direction) + artificial (fixtures + practicals).
6. Pin camera angle + lens (see references/interior-camera-rules.md).
7. Pin mood + time of day.
8. List assets + flag for discovery.
9. Emit handoff.

Decision tree

Room dimensions unrealistic for use case (e.g. 100m² home office)?
  → Warn; verify intent
Style + furniture brand mismatch (modern brief + ornate Victorian sofa)?
  → Fail; pick one
Time of day mid-day but only artificial lighting planned?
  → Warn; window light should dominate
Wide-angle 14mm in a small room?
  → Warn; distortion likely; propose 24mm + camera repositioning

Playbooks

Playbook A: Modern living room hero (16:9 catalog)

24–35mm wide; camera in corner; afternoon natural light through window; sofa + coffee table + rug as primary furniture; minimal palette; soft shadows.

Playbook B: Hospitality lobby (1:1 social)

35mm; camera centered toward focal art / reception; warm artificial lighting + minimal natural; rich materials.

Playbook C: Office showroom (wide 2.39:1)

24mm; camera elevated; mix natural + artificial; clean material palette; depth layered (foreground furniture + midground workstations + background views).

Mode handling

Text-only mode

Plan only.

Runtime-ready mode

Plan + runtime path attribution.

Blocked runtime mode

Plan only; flag what cannot be confirmed.

Validation checklist

• [ ] Room type + dims + style pinned
• [ ] Architecture basics pinned
• [ ] Furniture + props listed
• [ ] Material palette + key surfaces listed
• [ ] Lighting plan (natural + artificial) explicit
• [ ] Camera + lens chosen
• [ ] Mood + time of day pinned
• [ ] Asset list flagged
• [ ] Handoff named

Pass / Warn / Fail rubric

| Verdict | Criteria | |---|---| | Pass | All sections + plausible style consistency + lighting plan + assets flagged. | | Warn | One section ambiguous (palette unclear, time of day vs lighting mismatch). | | Fail | Style + furniture clash; impossible camera (14mm in 4m² room); lighting plan absent. |

Failure handling

• Style unclear → hand off to brief writer.
• Asset budget unknown → hand off to budget skill.
• Camera unrealistic → propose alternative.

Troubleshooting

| Problem | Response | |---|---| | Room feels empty | Add foreground prop + verify camera is in corner (not center). | | Lighting reads flat | Mix natural + artificial; add practicals; verify HDRI not dominating. | | Materials clash | Lock palette early per style-consistency-rules.md (character planner). | | Wide-angle distortion ugly | Use 24–35mm; reposition camera farther. |

Best practices

• Plan natural + artificial lighting together; they form a system.
• Always provide a camera in corner (not center) for room scenes — center loses depth.
• Lock palette early (3–5 colors max).
• Treat windows as light sources, not decorations.

Good examples

• "Room: modern minimalist living room, 4×6m, ceiling 2.7m, light oak floor, white walls, large window south-facing. Architecture: floor-to-ceiling window left wall, fireplace center back. Furniture: 3-seat sofa facing fireplace, low coffee table, area rug, single armchair right. Materials: warm wood + concrete + neutral fabric. Lighting: afternoon natural through window dominant + 2 ceiling spots + 1 floor lamp. Camera: 35mm, near corner, eye-level. Mood: calm, modern, warm. Time: 15:00."

Bad examples

• "Living room scene." — no dims, style, lighting, or camera.

User-facing response template

Room: 
Architecture: 
Furniture + props: 
Material palette: 
Key surfaces: 
Lighting: Natural:  | Artificial:  | HDRI: 
Camera:  |  |  | 
Mood + time of day: 

Assets to discover: 
Limitations: 
Next: blender-asset-discovery-planner / composition-quality-checker / lighting-quality-checker / material-quality-checker

Anti-patterns

• Center-of-room camera for hero shots (loses depth).
• Skipping window light when natural light is available.
• Mixing style eras without intent.
• Inventing room dimensions.

Cross-skill handoff

• Brief writer → ../intent-to-3d-brief-writer/SKILL.md
• Asset discovery → ../blender-asset-discovery-planner/SKILL.md
• Material validation → ../material-quality-checker/SKILL.md
• Lighting validation → ../lighting-quality-checker/SKILL.md
• Composition validation → ../composition-quality-checker/SKILL.md

Non-goals

• Model the room.
• Source furniture.
• Render.
• Run Blender.

References

• references/interior-architecture-rules.md
• references/furniture-layout-rules.md
• references/interior-camera-rules.md
• ../../docs/skill-system.md

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: ThanhNguyxnOrg
• Source: ThanhNguyxnOrg/blendops
• License: MIT
• Homepage: https://github.com/ThanhNguyxnOrg/blendops

Install and usage instructions live in the source repository linked above.