# Architect Skill File v3.0
# Building Type: Simple House
# Update this file to upgrade the entire system. Zero code changes needed.

## 1. PLOT_AND_SETBACKS

front_setback: 3.0
rear_setback: 2.0
left_setback: 1.5
right_setback: 1.5

PLOT_TYPES:
- square: standard, building centered inside setbacks
- rectangle: standard, building centered inside setbacks
- irregular: building must still be rectangular, positioned within tightest fitting rectangle inside plot boundary
- L_shaped: treat as rectangle using longest arm, flag extra open space to user
- triangular: use widest rectangular portion, never build into acute corner

PLOT_KNOWLEDGE:
- User provides full plot area. House is built inside it after setbacks.
- Plot always has one side facing the road (front).
- Front setback = legal gap between road and house. Never reduce it.
- Buildable area = plot minus all setbacks.
- House footprint will NOT fill entire buildable area. Only uses what rooms need.
- Remaining area = open space, garden, parking, future extension.


## 2. BUILDING_HIERARCHY

GROUND_FLOOR_RULE:
- Ground floor footprint is ALWAYS the largest floor.
- Upper floors must be equal or smaller than floor below. Never larger.
- Ground floor defines outer boundary of entire building.
- This is both structural (foundation carries load) and legal (FAR).

BUILDING_FORM:
building_shape: rectangular
all_rooms_must_form_single_rectangle: true
no_floating_rooms: true
no_gaps_between_rooms: true
rooms_share_walls: true

FOOTPRINT_RULES:
- All rooms packed tightly into one solid rectangle. No disconnected blocks.
- Rooms arranged in rows. Each row spans full building width.
- Rows stack front to back.
- Room widths proportionally fill full building width.
- Building width derived from total room area for proportional shape.
- Target aspect ratio: 1:0.7 to 1:1.5. Not a tower. Not a slab.


## 3. ZONES (CRITICAL - DO NOT CHANGE)

THREE_ZONE_SYSTEM:
- FRONT ZONE: Faces road. Public area. Living room, entrance, dining, garage go here.
- MIDDLE ZONE: Semi-private. Kitchen, corridor, study, stairs go here.
- REAR ZONE: Private. All bedrooms, bathrooms, store room, master suite go here.

ZONE_PLACEMENT_RULES:
- Front zone rooms must be accessible from entrance
- Middle zone connects front to rear via corridor
- Rear zone must be accessed through corridor, never directly from front
- No bedroom should ever be in front zone
- No bathroom should ever be in front zone
- No kitchen should ever be in front zone

ZONE_DEPTH_DISTRIBUTION:
- Front zone: top 33% of buildable depth
- Middle zone: middle 33% of buildable depth
- Rear zone: bottom 33% of buildable depth
- Rooms placed within their assigned zone


## 4. ROOM_ZONE_MAPPING

ROOM_TO_ZONE:
- living_room: front
- dining_room: front
- entrance: front
- garage: front
- kitchen: middle (never front)
- corridor: middle
- study_room: middle or rear
- stairs: middle
- bedroom: rear (absolute)
- master_bedroom: rear (absolute)
- bathroom: rear (absolute)
- toilet: rear (absolute)
- store_room: rear
- utility: rear


## 5. ROOM_ADJACENCY

MUST_BE_ADJACENT:
- bathroom must be adjacent to at least one bedroom
- attached_bathroom must share wall with master_bedroom
- kitchen must be adjacent to dining_room if dining exists
- corridor connects living zone to bedroom zone
- store_room adjacent to kitchen
- garage adjacent to main entrance or living room
- living_room must be adjacent to corridor (the start of the Highway)
- corridor must be adjacent to ALL bedrooms (the end of the Highway)
- corridor must be adjacent to common_bathroom
- corridor must be adjacent to kitchen (service access without crossing living)

MUST_NOT_BE_ADJACENT:
- bathroom must NEVER share wall with kitchen. Hygiene and plumbing rule.
- bathroom must NEVER open directly into kitchen or living room
- bedroom must not be adjacent to living room. Noise and privacy.
- master_bedroom should be furthest from main entrance. Most private.
- garage must not be adjacent to kitchen or bedroom. Fumes.

PREFERRED_ADJACENCY:
- living_room to dining_room to kitchen. Public to service flow.
- master_bedroom to attached_bathroom. Private suite.
- bedroom_1 and bedroom_2 to common_bathroom. Shared access.
- corridor to all bedrooms. Access without crossing living room.
- kitchen to store_room. Storage access.

PRIVACY_ZONES:
public: main_entrance, living_room, dining_room, garage
service: kitchen, store_room, utility
private: bedroom, master_bedroom, bathroom, study_room

PRIVACY_RULE:
- Never place private zone rooms directly accessible from public zone.
- Always use corridor between living and bedrooms.
- Guest should never walk through bedroom zone to reach kitchen.


## 6. PLUMBING_CORE

PLUMBING_EFFICIENCY_RULES:
- Group all bathrooms and kitchen along shared walls
- Create a "wet wall" where plumbing stacks are concentrated
- Back-to-back bathrooms share plumbing
- Kitchen should be adjacent to at least one bathroom if possible
- Stack bathrooms vertically on multiple floors for cost efficiency

PLUMBING_ROOMS:
- kitchen: plumbing_required: true
- bathroom: plumbing_required: true
- toilet: plumbing_required: true
- utility: plumbing_required: true
- all other rooms: plumbing_required: false

PLUMBING_CORE_PLACEMENT:
- Place plumbing core in middle or rear zone
- Never place plumbing core on front wall (road-facing)
- Avoid placing plumbing core on external walls in cold climates (freezing risk)


## 7. ORIENTATION

ROAD_FACING_RULES:
- Front wall ALWAYS faces road.
- Main entrance door ALWAYS on front wall.
- Living room ALWAYS at front zone. Faces road. Gets light. Welcomes guests.
- Kitchen at middle or rear zone. Never at front facing road.
- Bedrooms ALWAYS in rear private zone. Away from road noise.
- Bathrooms are interior. Never on road-facing wall.
- Garage at front if present. Direct road access.

FRONT_ZONE: living_room, dining_room, main_entrance
MIDDLE_ZONE: kitchen, corridor, study_room
REAR_ZONE: bedroom, master_bedroom, bathroom, store_room

WALL_TYPES:
- FRONT_WALL: faces road. Main door here. Living room windows here.
- REAR_WALL: faces garden. Bedroom windows here. Kitchen window possible.
- SIDE_WALLS: left and right. Bedroom windows possible. No main doors.
- INTERNAL_WALLS: between rooms. Doors only. Never windows.


## 8. DOOR_RULES

MAIN_ENTRANCE_DOOR:
- ALWAYS on front wall of building facing road.
- Opens into living room or entrance lobby.
- Width 1.0m to 1.2m.

INTERNAL_ROOM_DOORS:
- ALWAYS on internal walls shared with another room or corridor.
- NEVER on external walls except main entrance.
- Width 0.8m to 0.9m.
- Door opens INTO the room not into corridor.

BATHROOM_DOOR:
- Opens into bedroom or corridor.
- NEVER into kitchen or living room.
- Width 0.8m minimum.

DOOR_PLACEMENT_LOGIC:
- Each room has 4 walls: top, bottom, left, right.
- External wall = that wall edge aligns with the outer house boundary.
- Internal wall = another room is on the other side.
- Place door on internal wall closest to corridor or adjacent room.
- Exception: living room gets main entrance door on its top wall (front/road facing).

main_door_min_width: 1.0
main_door_max_width: 1.2
room_door_min_width: 0.8
room_door_max_width: 0.9


## 9. WINDOW_RULES

FUNDAMENTAL_RULE:
- Windows ONLY on EXTERNAL walls. Walls facing outside the building.
- Windows NEVER on internal walls shared between rooms.
- Room with no external wall cannot have a window.

WINDOW_BY_ROOM:
- living_room: window on top wall (front external). Mandatory.
- bedroom: window on bottom or side external wall. Mandatory.
- master_bedroom: window on bottom or side external wall. Mandatory.
- kitchen: window on bottom or side external wall if available. Ventilation.
- bathroom: no window required. Mechanical ventilation acceptable.
- corridor: no window required.
- dining_room: window on side external wall if available.

EXTERNAL_WALL_DETECTION:
- Top wall of room is external if room is in the top (front) row of building.
- Bottom wall of room is external if room is in the bottom (rear) row of building.
- Left wall of room is external if room is the leftmost room in its row.
- Right wall of room is external if room is the rightmost room in its row.
- All other walls are internal.

window_min_width: 1.0
window_max_width: 1.5
window_height: 1.2
window_sill_height: 0.9


## 10. ROOMS (with zones and plumbing)

required:
  living_room:
    min_width: 4.0
    min_depth: 4.0
    max_width: 6.0
    max_depth: 7.0
    zone: front
    must_have_window: true
    window_wall: top
    door_wall: internal
    plumbing: false
  kitchen:
    min_width: 2.5
    min_depth: 3.0
    max_width: 4.0
    max_depth: 5.0
    zone: middle
    must_have_window: false
    window_wall: bottom_or_side_external
    door_wall: internal
    plumbing: true
  bedroom:
    min_width: 3.0
    min_depth: 3.5
    max_width: 5.0
    max_depth: 6.0
    zone: rear
    must_have_window: true
    window_wall: bottom_or_side_external
    door_wall: internal
    plumbing: false
  bathroom:
    min_width: 1.5
    min_depth: 2.0
    max_width: 2.5
    max_depth: 3.0
    zone: rear
    must_have_window: false
    door_wall: internal_facing_bedroom_or_corridor
    plumbing: true

optional:
  corridor:
    min_width: 1.2
    max_width: 1.8
    zone: middle
    must_have_window: false
    plumbing: false
  dining_room:
    min_width: 3.0
    min_depth: 3.5
    zone: front
    must_have_window: false
    plumbing: false
  study_room:
    min_width: 2.5
    min_depth: 3.0
    zone: middle_or_rear
    must_have_window: false
    plumbing: false
  garage:
    min_width: 3.0
    min_depth: 5.5
    zone: front
    must_have_window: false
    plumbing: false
  store_room:
    min_width: 1.5
    min_depth: 2.0
    zone: rear
    must_have_window: false
    plumbing: false
  master_bedroom:
    min_width: 4.0
    min_depth: 4.0
    max_width: 6.0
    max_depth: 6.0
    zone: rear
    must_have_window: true
    window_wall: bottom_or_side_external
    door_wall: internal
    plumbing: false
  attached_bathroom:
    min_width: 1.5
    min_depth: 2.0
    max_width: 2.5
    max_depth: 3.0
    zone: rear
    must_have_window: false
    door_wall: internal_facing_master_bedroom
    plumbing: true


## 11. WALLS

external_wall_thickness: 0.23
internal_wall_thickness: 0.115

WALL_TYPE_DEFINITION:
- external_wall: wall on outer boundary of building footprint
- internal_wall: wall shared between two rooms inside building
- Room walls are external if they align with building outer rectangle boundary
- Room walls are internal if another room is on the other side


## 12. FAR

default_far: 1.5

FAR_KNOWLEDGE:
- FAR = Floor Area Ratio = total built area divided by plot area
- Max built-up area = FAR x plot area
- Legal limit. Never exceed.
- Applies to ALL floors combined.
- Open areas not counted in FAR.


## 13. CIRCULATION

min_corridor_width: 1.2
max_corridor_width: 1.8

FLOW_LOGIC:
- The house has a strict flow hierarchy: Entrance -> Living Room -> Corridor -> All Rooms.
- Living Room is the "Hub". It is the public anchor of the house.
- Corridor is the "Highway Spine". It starts at the Living Room and ends at the furthest bedroom.
- The Corridor MUST start at (share a wall with) the Living Room.
- The Corridor MUST reach the door of EVERY bedroom, bathroom, and kitchen.
- No private room is ever entered directly from the Living Room.

CIRCULATION_RULES:
- Connectivity chain: Living_Room -> Corridor -> [Master Bedroom, Bedroom 1, Bedroom 2, Bathroom, Kitchen]
- No Dead Ends: Corridor must provide direct door access to every private room.
- No Daisy Chaining: NEVER walk through Bedroom 1 to reach Bedroom 2.
- No Service Cutting: NEVER walk through Kitchen to reach a Bedroom or vice versa.
- No Living Room Bypass: NEVER place a bedroom door on the Living Room wall.
- Privacy Barrier: The Corridor is the mandatory buffer between Living (public) and Bedrooms (private).
- The Corridor runs center of the building. Rooms stack on its LEFT and RIGHT sides.
- The Living Room connects to the Corridor at the front end of the Corridor.

CORRIDOR_SIZING:
- Width fixed between 1.2m and 1.8m. Never wider.
- Length = full depth of the house (spans all zones: front to rear).
- The math engine will calculate the exact corridor length automatically.
- AI must NOT set corridor depth/length. Only set width between 1.2 and 1.8.


## 14. AI_GENERATION_RULES

WHAT_AI_MUST_DO:
1. Read plot dimensions from user input.
2. Front of plot always faces road unless user specifies otherwise.
3. Apply setbacks to get buildable area.
4. Calculate max built-up area from FAR.
5. Assign each room to its correct ZONE (front/middle/rear).
6. Arrange rooms following zone rules: front=public, rear=private.
7. Ensure no bathroom is adjacent to kitchen. Ever.
8. Ensure all bedrooms in private zone.
9. Ensure living room in front zone.
10. Place corridor between public and private zone — corridor is MANDATORY for 2+ bedrooms.
11. Living Room MUST share a wall with the Corridor (Highway rule).
12. Corridor MUST provide door access to ALL bedrooms, ALL bathrooms, and Kitchen.
13. Group plumbing rooms (kitchen, bathrooms) along shared walls.
14. Output structured JSON with zone and adjacency fields.
15. Do NOT include x y coordinates. Math engine calculates those.
16. Validate all room sizes against min max in section 10.
17. Generate 3 layout options with different room arrangements.
18. Each option must form a valid solid rectangle when assembled.
19. On user modification change only what was asked. Keep rest intact.
20. Flag any violations clearly in violations array.
21. Every room's adjacent_to list must include "Corridor" unless it IS the corridor.
22. Corridor's adjacent_to list must include Living Room AND every bedroom AND every bathroom.

WHAT_AI_MUST_NEVER_DO:
- Never place bathroom adjacent to kitchen.
- Never place bedroom at front road-facing zone.
- Never put main door on rear or side wall.
- Never generate rooms that cannot form a rectangle.
- Never exceed FAR limits.
- Never skip required rooms.
- Never place windows on internal walls.
- Never put plumbing rooms on front wall.
- Never place a bedroom door directly into the Living Room (must go via Corridor).
- Never allow any room to be accessible ONLY through another room (no daisy chaining).
- Never place the Corridor disconnected from the Living Room.
- Never omit the Corridor when there are 2 or more bedrooms.


## 15. FUTURE_EXTENSIONS

Apartment:
- floor_rules, staircase_required_if_floors_gt_1
- lift_required_if_floors_gt_4
- each floor same or smaller footprint than ground
- common corridor on each floor

Villa:
- larger setbacks: 5m front, 3m rear, 2m sides
- garden area mandatory: min 20 percent of plot
- double height living room option
- servant quarters near kitchen

Commercial:
- parking_ratio: 1 space per 50sqm built area
- accessibility: ramp and lift mandatory
- fire exit: second staircase if floor area gt 500sqm
- no residential rooms

# END OF SKILL FILE
# This file is the single source of truth.
# Update here and the whole system updates.
# No hardcoding. No rule engine. Just knowledge.`