Gather site context, exterior conditions, and interior design intent for AI rendering. Trigger phrases include "site context", "visual context", "gather context", "rendering context". Dependencies: project-config, plans-spatial, specs-quality, schedule, directory.
The project-visual-context skill guides you through a structured interview to gather comprehensive visual context about your construction project. This context enables the rendering-generator skill to produce accurate, photorealistic AI renderings at any project phase.
Visual context includes:
Trigger: /site-context command
Timing:
/render for best resultsBest Results: Run after project kick-off, before major design/construction phases
The skill operates in 3 phases over a single session:
At the end, the skill generates visual-context.json saved to AI - Project Brain/ folder.
When you trigger /site-context:
The skill checks if visual-context.json already exists
The skill auto-populates data from existing project files:
project_code, building type, address, occupancyPre-populated data is shown to the user for confirmation/correction.
Display pre-populated data:
Project: [project_code]
Address: [address]
Building Type: [type] ([occupancy] occupants)
Building Size: [SF]
Current Phase: [phase from schedule]
Ask: "Are these details correct? (yes/no/edit)"
If user edits, update the displayed values.
Ask: "What best describes the site setting?"
Capture response.
Ask: "Describe the terrain around the building:"
Ask for any additional details (e.g., "hillside with rock outcrops," "flat cleared site in forest").
Capture response.
Ask: "Describe buildings/structures adjacent to this site in each direction:"
For each cardinal direction (North, South, East, West):
Capture responses for each direction.
Ask: "Describe existing vegetation on or near the site:"
Ask: "Is landscaping planned for this project? (yes/no/unknown)"
If yes: "Describe the landscaping intent" (e.g., "native plantings, bioswale screening to south, street trees along entry drive")
Capture responses.
Ask: "Select the climate zone for this location:"
Display options based on address (or ask user):
Capture response.
Ask: "What is the region/zone?" (e.g., "USDA Zone 6a," "Sonoran Desert," "Pacific Northwest")
Ask: "For rendering purposes, which season best represents this project?"
Capture response.
Ask: "What is the prevailing weather you expect to show in renderings?" (e.g., "clear skies," "partly cloudy," "dramatic storm clouds," "morning fog")
Capture response.
Ask: "Which direction does the main entry face?" (N, NE, E, SE, S, SW, W, NW)
Ask: "Which elevation faces north?" (e.g., "long side," "short side," "corner")
Ask: "Where is parking located?" (e.g., "south and east," "detached lot to north," "below building")
Ask: "Describe the sun path in your region during the default season you selected" (e.g., "low southern sun, dramatic shadows," "high overhead sun, minimal shadows," "strong western afternoon glare")
Capture responses.
Auto-populate from schedule if available:
Current Phase: [phase]
Expected Visible Work: [construction activities in progress]
Equipment on Site: [cranes, formwork, trailers, etc.]
Ask: "Are these details accurate? Anything to add or correct about the current construction status?"
Capture any corrections.
Ask: "Would you like to upload site photos for reference? (yes/no)"
If yes:
For each uploaded photo:
Ask: "Any other details about the exterior/site context we should capture?" (free-form text)
Capture response.
Summarize exterior context to user:
EXTERIOR CONTEXT SUMMARY
Setting: [type]
Terrain: [description]
Adjacent (N/S/E/W): [cardinal descriptions]
Vegetation: [description]
Climate: [zone/region/seasons]
Building Faces: [direction] | Entry: [direction]
Parking: [location]
Photos Uploaded: [count]
Ask: "Ready to proceed to Interior Design Intent?" (yes/continue)
Ask: "What is the design character of this project?"
Display options and explain:
Capture response.
Ask: "Describe the primary color for the interior" (e.g., "warm gray," "soft white," "warm beige," "sage green," "charcoal blue")
Ask: "What is the secondary color?" (e.g., "light gray," "warm cream," "natural wood tone," "accent blue")
Ask: "What is the accent color for highlights and features?" (e.g., "warm copper," "deep teal," "warm orange," "muted sage")
Ask: "Do you have inspiration photos or color references? (yes/no)"
If yes:
Capture all color responses.
Load room types from plans-spatial.json (e.g., "Bedroom," "Common Area," "Kitchen," "Restroom," "Corridor," "Mechanical," etc.)
For each major room type, ask:
"For [Room Type] spaces, please provide:"
Ask: "What flooring material?" (e.g., "polished concrete," "ceramic tile," "luxury vinyl plank," "natural wood," "rubber")
Ask: "What finish/color?" (e.g., "light gray," "warm oak," "matte," "polished")
Ask: "How are walls finished?" (e.g., "painted gypsum board," "tile wainscot + paint," "wood paneling," "exposed CMU," "vinyl wallcovering")
Ask: "What color/material?" (e.g., "soft white," "warm gray," "natural wood tone")
Ask: "What is the ceiling type?" (e.g., "gypsum board," "suspended acoustic tile," "exposed structure," "open beam," "coffered," "drop ceiling")
Ask: "What color/finish?" (e.g., "bright white," "light gray," "natural wood," "black exposed steel")
Ask: "What base/trim material and finish?" (e.g., "painted wood base," "cove base rubber," "natural wood trim," "anodized aluminum")
Only ask if applicable for room type (e.g., yes for kitchens, bathrooms, offices; no for open corridors)
Ask: "Describe casework, cabinets, built-ins" (e.g., "natural wood cabinetry, soft-close drawers, open shelving in entry," "stainless steel shelving in prep area")
Only ask if applicable (kitchens, bathrooms, nursing stations)
Ask: "What countertop material and finish?" (e.g., "quartz counters, white," "solid surface, warm gray," "stainless steel," "sealed wood")
Ask: "What is the hardware finish?" (e.g., "polished chrome," "brushed nickel," "bronze," "oil-rubbed bronze," "stainless steel")
Ask: "Describe the furniture style for [Room Type]" (e.g., "modern minimalist," "warm residential," "clinical institutional," "hospitality-grade")
Ask: "Any special features or equipment?" (e.g., "picture rails," "display niches," "accent lighting," "accent wall," "window seat," "fireplace")
Ask: "Are there brand standards, owner preferences, or design guidelines we should know about?" (yes/no/text)
If yes: "Please describe" (e.g., "Must use warm wood tones," "Specific furniture brand," "Accessible/universal design priorities," "Sustainable materials preference")
Capture response.
Ask: "Any special design notes or unique features to capture?" (free-form text)
Examples:
Capture response.
Summarize interior design to user:
INTERIOR DESIGN SUMMARY
Character: [type]
Color Palette: [primary] / [secondary] / [accent]
Room Types Documented: [count]
Brand/Owner Notes: [yes/no]
Special Features: [summary]
Ask: "Ready to proceed to Photo Documentation?" (yes/continue)
Extended reference: Detailed examples, templates, scoring rubrics, and best practices are in
references/skill-detail.md.