Agent skill

Building Programming

by Abhinavbwj in Abhinavbwj/Skills-Architects

Guides architectural programming work: space needs, adjacency matrices, area schedules and net-to-gross checks for project briefs across common building types.

MITAuto-check passedProduct & Project Management

Install Building Programming

skills CLI
$ npx skills add Abhinavbwj/Skills-Architects --skill building-programming -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Abhinavbwj/Skills-Architects building-programming --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Abhinavbwj/Skills-Architects.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/building-programming .claude/skills/building-programming && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
building-programming
GitHub stars
295
Token cost
~7.4k tokens
SKILL.md length
3,613 words
Files
4 (incl. references)
Skills in repo
17
Repo updated
First seen
Licence
MIT

At a glance

Guides architectural programming work: space needs, adjacency matrices, area schedules and net-to-gross checks for project briefs across common building types.

  • Works in 5 steps: Architectural Programming Methodology → Space Standards by Building Type → Adjacency Matrix Method → …
  • Building a space program and area schedule for a new project
  • SKILL.md covers 1. Architectural Programming…, 2. Space Standards by Building…, 3. Adjacency Matrix Method and 4. Area Schedule Construction, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Architectural programming defines and quantifies a building's spatial requirements before any design starts. The skill casts the agent as a practitioner following the Problem Seeking method of Pena and Parshall, with five steps (goals, facts, concepts, needs, problem statement) applied across five information categories, and it insists that every number traces to a published source.

It covers area tables for residential, office, healthcare, education, hospitality, retail and cultural buildings, adjacency matrices and stacking diagrams, and checks of a program against site capacity and budget. Standards named include NDSS, Neufert, NHS HBN, BB103 and ASHRAE. Reference files hold adjacency methods and area standards, and a program brief template is included. The excerpt is truncated, so later sections are not described here.

When your agent uses it

  • Building a space program and area schedule for a new project
  • Sizing rooms and checking net-to-gross ratios against benchmarks
  • Drawing up an adjacency matrix or a stacking diagram
  • Checking a space program against site capacity and budget

Example prompts

  • “Draft an area schedule for a small primary school with eight classrooms.”
  • “Build an adjacency matrix for a medical outpatient clinic.”
  • “Check this office program's net-to-gross ratio against typical benchmarks.”
  • “Fill in the program brief template for a boutique hotel.”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Architectural Programming Methodology
  2. Space Standards by Building Type
  3. Adjacency Matrix Method
  4. Area Schedule Construction
  5. Brief Validation

What it can do on your machine

Read from SKILL.md and the folder at commit 30a0845. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Building Programming loads about 7.4k tokens when it runs, and up to ~20k if it reads all its reference files. Until then it costs about 176 tokens; SKILL.md has 3,613 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~176
When it runs · the whole SKILL.md, loaded when a task matches
~7.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~20k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Abhinavbwj/Skills-Architects at commit 30a0845, republished under its MIT licence (© Abhinavbwj). 3,613 words, ~7,365 tokens.

Download SKILL.mdSave it as .claude/skills/building-programming/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
building-programming
description
Develop architectural programs, space needs analyses, adjacency matrices, area schedules, and project briefs. Use when the user asks about programming a building, sizing spaces, determining area requirements, creating adjacency diagrams, building a space program, developing a brief, calculating net-to-gross ratios, analyzing space standards, comparing area benchmarks, constructing stacking diagrams, or validating a program against site capacity and budget. Also use when the user needs area tables for residential, office, healthcare, education, hospitality, retail, or cultural building types, or when checking compliance with NDSS, Neufert, NHS HBN, BB103, or ASHRAE standards.

Building Programming Skill

You are an expert in architectural programming -- the systematic process of defining, quantifying, and organizing the spatial requirements of a building before design begins. You work with the rigour of Pena & Parshall's Problem Seeking methodology, the area benchmarks of Neufert Architects' Data, and the space standards of national codes. Every number you produce is traceable to a published source.


1. Architectural Programming Methodology

1.1 Definition and Purpose

Architectural programming is the research and decision-making process that identifies the client's needs and translates them into a quantified spatial brief. It precedes design: no sketch, no massing, no plan should be drawn until the program is validated. Programming answers "what and how much" so that design can answer "how."

The program document becomes the contract between client and architect -- a measurable standard against which every design iteration can be evaluated.

1.2 Pena & Parshall's Problem Seeking Framework

William Pena and Steven Parshall (Problem Seeking: An Architectural Programming Primer, 5th ed., Wiley, 2012) established the dominant methodology used in North American and international practice. The framework has five steps and five information categories.

Five Steps:

StepActionOutput
1. Establish GoalsDefine the client's mission, aspirations, and prioritiesGoal statements ranked by importance
2. Collect FactsGather quantitative data: user counts, existing areas, equipment lists, growth projectionsFact sheets, user surveys, existing-condition plans
3. Uncover ConceptsIdentify the organizational ideas, relationships, and performance criteria that will govern the designConcept diagrams, adjacency priorities, circulation concepts
4. Determine NeedsQuantify every space: area, occupancy, environmental requirements, special conditionsArea schedule, room data sheets, equipment lists
5. State the ProblemSynthesize goals, facts, concepts, and needs into a clear problem statement that guides designProgram summary document, design directives

Five Information Categories (The Information Index):

Every piece of programming data is classified into one of five categories. Each step is applied to each category, creating a 5x5 matrix:

CategoryWhat It AddressesTypical Data
FunctionActivities, relationships, user groupsNumber of staff, patients, students; adjacency needs; workflow diagrams
FormSite, environment, physical context, qualitySite area, orientation, views, urban context, image aspirations
EconomyBudget, life-cycle cost, operationsConstruction budget per m2, O&M costs, value engineering targets
TimeSchedule, phasing, growth, changeProject timeline, phased delivery, expansion capacity, flexibility needs
EnergySustainability, environmental performance, resourcesEnergy use intensity targets, carbon budget, water targets, renewables
1.3 Programming Process in Practice

Phase 1: Kickoff and Data Gathering (1-3 weeks)

  • Stakeholder interviews (minimum: client leadership, facility managers, department heads, end users)
  • Existing facility audit: measure actual utilization, not just nominal allocation
  • Benchmarking: compare to published standards and peer institutions
  • User surveys for occupancy patterns, satisfaction, future needs

Phase 2: Analysis and Synthesis (2-4 weeks)

  • Draft area schedule with preliminary allocations
  • Adjacency matrix construction (see Section 3)
  • Stacking and blocking diagrams
  • Site capacity testing: can the site accommodate the program?
  • Budget alignment: does the program fit the budget at benchmark cost/m2?

Phase 3: Validation and Documentation (1-2 weeks)

  • Red-flag review (see Section 5)
  • Client sign-off on final program
  • Room data sheets for specialty spaces
  • Program summary document with design directives
1.4 Key Programming Ratios
MetricDefinitionTypical Range
Net-to-Gross Ratio (NTG)Net Usable Area / Gross Floor Area0.55 - 0.85 depending on building type
Circulation FactorCirculation Area / Net Usable Area0.20 - 0.40
Space per PersonTotal program area / peak occupancyVaries by type (see Section 2)
Support RatioSupport area / primary function area0.15 - 0.35
Parking RatioParking spaces / 1000 m2 GFA or per unitCode-dependent

2. Space Standards by Building Type

All areas are Net Internal Area (NIA) per space unless noted. Sources abbreviated: NEU = Neufert Architects' Data (5th ed.); NDSS = Nationally Described Space Standard (UK MHCLG, 2015); HBN = NHS Health Building Notes; BB = Building Bulletin (DfE, UK); ASHRAE = ASHRAE Handbook; ADA = Americans with Disabilities Act; BCIS = Building Cost Information Service; IBC = International Building Code.

2.1 Residential

Unit Sizes (Net Internal Area):

Unit TypeMin NIA (m2)Recommended NIA (m2)NDSS Min (m2)Source
Studio (1p)303737NDSS Table 1
Studio (2p)355050NDSS Table 1
1-Bed (2p)4550-5550NDSS Table 1
2-Bed 3p586561NDSS Table 1
2-Bed 4p6570-8070NDSS Table 1
3-Bed 4p7485-9574NDSS Table 1
3-Bed 5p8590-10086NDSS Table 1
3-Bed 6p95100-11095NDSS Table 1
4-Bed 5p90110-12090NDSS Table 1
4-Bed 6p99120-13099NDSS Table 1
4-Bed 7p108130-140108NDSS Table 1

Individual Room Standards (NDSS):

RoomMin Area (m2)Min DimensionNotes
Single Bedroom7.52.15m widthMust accommodate single bed (2000x900mm)
Double/Twin Bedroom11.52.75m widthMust accommodate double bed (2000x1500mm)
Living/Kitchen/Dining (studio)23--Combined space for 1-person studio
Storage (1-2 person)1.5--Built-in, dedicated, accessible
Storage (3 person)2.0--Scales with occupancy
Storage (4 person)2.5--
Storage (5 person)3.0--
Storage (6+ person)3.5--

Amenity and Common Spaces:

SpaceArea per UnitNotes
Private Balcony/Terrace5 - 8 m2London Plan min 5m2 for 1-2 person, +1m2 per additional person
Communal Amenity2 - 5 m2/unitLobby, lounge, co-working, gym, rooftop
Cycle Storage1.0 - 1.5 m2/space1 space per 1-bed, 2 spaces per 2-bed+ (London Plan)
Bin Store0.3 - 0.5 m2/unitSized to local authority waste collection
Pram/Mobility Scooter0.8 - 1.2 m2/unitGround floor, accessible
2.2 Office

Workspace Standards:

Workspace TypeArea per Person (NIA)NotesSource
Open Plan (hot-desking)6 - 8 m2Desk sharing ratio 0.6-0.8:1BCO Guide 2019
Open Plan (assigned)8 - 12 m2Including primary circulationBCO Guide 2019
Team Neighbourhood10 - 14 m2Activity-based workingBCO Guide 2019
Private Office (small)12 - 15 m21 personNEU
Private Office (large)15 - 20 m2Director / partnerNEU
Executive Suite25 - 40 m2CEO / ChairmanPractice benchmarks
Touchdown / Hot Desk4 - 6 m2Short-duration unassignedBCO Guide 2019

Support Spaces:

SpaceSizing BasisTypical AreaSource
Meeting Room (small, 4-6p)2.0 - 2.5 m2/seat10 - 15 m2BCO
Meeting Room (medium, 8-12p)2.0 - 2.5 m2/seat18 - 30 m2BCO
Boardroom (14-20p)2.5 - 3.0 m2/seat40 - 60 m2BCO
Meeting rooms total1 room per 20-25 staff--BCO benchmark
Breakout / Informal5% - 10% of workspace NIAVariesBCO
Kitchen / Tea Point1 per 40-60 staff8 - 15 m2Practice benchmarks
Staff Restaurant1.2 - 1.5 m2/seatVariesNEU
Print/Copy1 per floor or zone6 - 10 m2--
Server/Comms Room1 per 2-3 floors10 - 20 m2--
Reception / Lobby0.3 - 0.5 m2 per 100 m2 NLA30 - 80 m2 typicalBCO
WC ProvisionIBC: 1 per 25 (M), 1 per 20 (F)Per codeIBC Table 2902.1
2.3 Healthcare

Patient Accommodation:

SpaceMin Area (m2)Recommended (m2)Source
Single Patient Room (standard)2022-25HBN 04-01
Single Patient Room (en-suite)2226HBN 04-01
Double Patient Room2830-32HBN 04-01
ICU / Critical Care Bay2224-26HBN 04-02
ICU Single Room (isolation)2628-30HBN 04-02
Operating Theatre (standard)3642-50HBN 26
Operating Theatre (orthopaedic/cardiac)5055HBN 26
Anaesthetic Room1720HBN 26
Recovery Bay910-12HBN 26
Consultation Room1214-16HBN 00-03
Examination Room1416HBN 00-03
Treatment Room1618-20HBN 00-03
Nurse Station--12-16 per stationHBN 04-01
Clean Utility--10-14 per wardHBN 04-01
Dirty Utility--10-12 per wardHBN 04-01

Departmental Benchmarks (m2/bed for an entire department):

Departmentm2 per BedNotes
Inpatient Ward50 - 65Including en-suites, nursing, support
ICU/HDU35 - 45Per ICU bed, higher acuity = more space
Emergency Department50 - 70Per treatment space
Operating Suite80 - 120Per operating room, including prep/recovery
Outpatient Clinic25 - 35Per consulting room
2.4 Education

Primary and Secondary Schools (BB103 / BB104 Guidance):

SpaceAreaNotesSource
General Teaching Classroom50 - 56 m225-30 pupils, 2.0 m2/pupil minBB103
Secondary Classroom55 - 65 m230 pupils, specialist furnitureBB103
Science Laboratory80 - 90 m230 students, fume cupboard, servicesBB103
Art/DT Workshop80 - 100 m2Wet and dry areas, tool storageBB103
Music Room55 - 65 m2Acoustic isolation requiredBB103
Drama Studio80 - 100 m2Flexible, blackout, sprung floorBB103
School Library (primary)40 - 60 m21 class + browsersBB103
School Library (secondary)80 - 120 m240+ readersBB103
Sports Hall (4 court)594 m2 (33x18m)Standard 4-badminton courtSport England
Assembly/Dining Hall1.0 - 1.2 m2/seated pupilDual-use with PE in primaryBB103

Higher Education:

SpaceAreaNotesSource
Lecture Hall1.2 - 1.5 m2/seatTiered, fixed seats, AV provisionNEU / AUDE
Seminar Room (20 seats)35 - 45 m21.8 - 2.2 m2/seatAUDE
Teaching Laboratory2.5 - 3.5 m2/studentWet science, benches, fume hoodsAUDE
Research Laboratory10 - 20 m2/researcherEquipment-dependentAUDE
Library Reading Space4 - 5 m2/readerShelving at 5-7 m2 per 1000 volumesNEU
Student Commons0.5 - 1.0 m2/FTE studentSocial learning, informalAUDE
Office (academic)10 - 14 m2/personShared increasingly commonAUDE
2.5 Hospitality

Hotel Room Sizes:

CategoryRoom NIA (m2)Bathroom (m2)Total (m2)Source
Budget / Economy14 - 183 - 416 - 20NEU / operator standards
Standard (3-star)18 - 244 - 522 - 28NEU / operator standards
Superior (4-star)24 - 325 - 728 - 38NEU / operator standards
Deluxe (5-star)32 - 387 - 1038 - 48NEU / operator standards
Junior Suite38 - 508 - 1246 - 62Operator standards
Suite50 - 7510 - 1560 - 80Operator standards
Presidential Suite80 - 200+15 - 30100 - 250+Operator standards

Hotel Back-of-House Ratios:

ComponentRatio to Total Room CountNotes
Lobby / Reception1.0 - 2.0 m2/roomHigher for luxury
Restaurant Seating0.7 - 1.2 seats/roomFull-service hotel
Kitchen50 - 70% of dining areaFull production kitchen
Ballroom/Conference0.5 - 1.5 m2/roomConvention hotels higher
BOH (total)50 - 70% of FOH areaIncludes housekeeping, laundry, MEP
Fitness/Spa0.5 - 2.0 m2/roomBudget: none; 5-star: full spa
2.6 Retail
SpaceSizing BasisAreaSource
Convenience StorePer unit200 - 500 m2Practice benchmarks
Supermarket (small)Per unit1,000 - 2,500 m2NEU
Supermarket (large)Per unit2,500 - 6,000 m2NEU
HypermarketPer unit6,000 - 15,000+ m2NEU
Back of House / Storage% of sales floor15 - 25%NEU
Staff FacilitiesPer unit20 - 60 m2Practice benchmarks
Loading / ReceivingPer unit30 - 80 m2Practice benchmarks
Retail Shell (spec)Floor depth12 - 18m preferred, 20m maxNEU
Floor-to-ceiling (retail)Clear height3.5 - 5.0m ground floorNEU
2.7 Cultural
SpaceSizing BasisAreaSource
Gallery (major works)Per major piece30 - 50 m2Museum planning literature
Gallery (general)Linear wall4 - 6 m per work, 3m hanging heightBest practice
Temporary ExhibitionPer gallery200 - 800 m2Flexible, column-free
Auditorium SeatingPer seat0.7 - 1.0 m2NEU
Auditorium (with stage)Per seat total1.5 - 2.5 m2Including stage, wings
BOH (museum)% of public area40 - 60%Conservation, storage, workshops
Library Stack AreaPer 1000 volumes5 - 7 m2Open shelving, 2.1m high
Library Study CarrelsPer reader2.5 - 3.5 m2Individual, wired
Performance Venue BOH% of auditorium70 - 100%Dressing rooms, workshops, storage

3. Adjacency Matrix Method

3.1 Purpose

The adjacency matrix is the fundamental tool for translating functional relationships into spatial organization. It answers: which spaces must be near each other, which should be separated, and which have no strong relationship?

3.2 Constructing the Matrix

Step 1: List all departments or major space groups. Typically 8-20 for a building-level matrix. Too few loses resolution; too many becomes unworkable.

Step 2: Assign relationship scores between every pair.

ScoreRelationshipMeaning
4EssentialMust be directly adjacent or connected (shared wall, direct door)
3DesirableShould be nearby (same floor, short corridor)
2NeutralNo strong preference
1UndesirableShould be separated (noise, odour, security, incompatible use)

Some practitioners add a fifth level (0 = must not be adjacent) for hard separations like sterile vs. dirty zones.

Step 3: Score based on specific criteria:

  • Shared users (patients, staff, students moving between spaces)
  • Shared equipment or services
  • Workflow sequences
  • Environmental compatibility (noise, vibration, fumes)
  • Security and access control
  • Servicing and logistics

Step 4: Populate the half-matrix. The matrix is symmetric (A-to-B = B-to-A), so only the upper or lower triangle is needed.

3.3 From Matrix to Diagram

Bubble Diagram: Translate scores into a spatial diagram:

  • Score 4: circles touching or overlapping
  • Score 3: circles close with a connecting line
  • Score 2: circles at moderate distance, no line
  • Score 1: circles distant, dashed line indicating separation

Stacking Diagram: For multi-storey buildings, overlay the adjacency logic onto a vertical section showing which departments go on which floors. Ground floor adjacencies (public entry, loading, emergency) drive the stacking.

Affinity Mapping: Group spaces into clusters based on shared characteristics (public/private, clean/dirty, quiet/noisy, served/servant). These clusters become zones in the plan.

3.4 Worked Example: 5-Department Hospital

Departments: Emergency (ED), Surgery, Inpatient Wards, Outpatient Clinics, Diagnostic Imaging

Adjacency Matrix:

EDSurgeryInpatientOutpatientImaging
ED--4324
Surgery----423
Inpatient------23
Outpatient--------4
Imaging----------

Reading the Matrix:

  • ED-Surgery = 4 (essential): Trauma patients move directly from ED to operating theatres. Direct connection required.
  • ED-Imaging = 4 (essential): Emergency patients need immediate CT/X-ray. Many EDs co-locate a dedicated CT scanner.
  • Surgery-Inpatient = 4 (essential): Post-operative patients transfer directly to wards. Same floor or direct lift connection.
  • Outpatient-Imaging = 4 (essential): Outpatients are the highest-volume imaging users. Direct adjacency reduces travel and wait times.
  • ED-Outpatient = 2 (neutral): Different patient populations, different access points, different hours of operation.
  • Surgery-Outpatient = 2 (neutral): Day-surgery patients use a separate admissions path.

Resulting Stacking Logic:

  • Ground Floor: ED + Imaging (shared CT) + Main Entrance + Outpatient Clinics
  • First Floor: Surgery (directly above ED for vertical connection) + Day Surgery Admissions
  • Upper Floors: Inpatient Wards (above Surgery for post-op transfer, quiet environment)
Show full SKILL.md (1,376 more words)Show less
3.5 Common Adjacency Patterns by Building Type

Office Building:

  • Reception must be adjacent to main entrance (score 4)
  • Meeting rooms should be near reception for visitors (score 3)
  • Kitchen/breakout near workspace clusters (score 3)
  • Server rooms away from water sources (score 1)
  • Executive suites can be separate from general workspace (score 2)

School:

  • Administration must be adjacent to main entrance for safeguarding (score 4)
  • Hall adjacent to kitchen for meal service (score 4)
  • Quiet classrooms separated from music/PE (score 1)
  • Science labs near prep rooms (score 4)
  • Library central to teaching zones (score 3)

Mixed-Use:

  • Retail at ground with direct street access (score 4 to street)
  • Office entrance separate from residential (score 1 for lobbies)
  • Residential above office for noise separation (score varies)
  • Car park access separated from pedestrian entry (score 1)
  • Plant rooms at basement or roof, not adjacent to hotel rooms (score 1)

4. Area Schedule Construction

4.1 Definitions
TermDefinitionMeasurement Standard
Gross External Area (GEA)Total area measured to outer face of external wallsRICS Code of Measuring Practice
Gross Internal Area (GIA)Total area measured to inner face of external wallsRICS
Net Internal Area (NIA)Usable floor area excluding structure, core, risers, plant, primary circulationRICS
Net Usable Area (NUA)NIA minus secondary circulation within tenanciesBOMA / IFMA
Construction AreaArea taken by structure (columns, walls, shear walls)Typically 5-10% of GIA
Core AreaLifts, stairs, lobbies, risers, WCsTypically 15-25% of GIA
Primary CirculationCorridors, lobbies connecting departmentsTypically 10-20% of GIA
Secondary CirculationCirculation within departments/tenanciesPart of NIA allocation
Plant/Services AreaMechanical rooms, electrical rooms, risersTypically 5-10% of GIA
4.2 Net-to-Gross Ratios by Building Type
Building TypeTypical NTG RatioNotes
Office (speculative)0.80 - 0.85BCO target: 82.5%
Office (owner-occupied)0.75 - 0.82More generous circulation
Residential (apartments)0.75 - 0.82Core-dependent; point tower lower
Hotel0.62 - 0.72Long double-loaded corridors
Hospital0.55 - 0.65Complex servicing, wide corridors, interstitial floors
School0.70 - 0.78Wide corridors for circulation/social
University0.60 - 0.72Lab buildings lower than teaching
Retail (department store)0.80 - 0.88Minimal core, open floor plates
Museum/Gallery0.55 - 0.65Massive BOH, environmental plant
Performing Arts0.45 - 0.55Stage house, fly tower, BOH dominant
4.3 Area Schedule Template

Every program should produce an area schedule in this format:

#Space NameQtyUnit NIA (m2)Total NIA (m2)OccupantsSpecial Requirements
1.0DEPARTMENT A
1.1Space Type 14251006 eachDaylight required, acoustic STC 45
1.2Space Type 22408012 eachAV provision, blackout blinds
1.3Support Space11515--Adjacent to 1.1
Dept A Subtotal195
2.0DEPARTMENT B
.....................
TOTAL NIAX,XXX
Circulation (20%)X,XXX
Structure (8%)XXX
Core & Services (15%)X,XXX
TOTAL GIAX,XXX
Wall Thickness (3%)XXX
TOTAL GEAX,XXX
4.4 Building the Schedule Step by Step
  1. List every space from the program, grouped by department or function
  2. Assign unit areas from standards (Section 2) or client brief
  3. Assign quantities from occupancy data and operational requirements
  4. Calculate total NIA = sum of all (unit area x quantity)
  5. Add circulation factor based on building type (see NTG ratios)
  6. Add structural area (columns, walls): typically 5-10%
  7. Add core and services (lifts, stairs, risers, plant): typically 12-20%
  8. Sum to GIA = NIA + circulation + structure + core/services
  9. Add wall thickness (GIA to GEA conversion): typically 2-5%
  10. Cross-check NTG ratio against benchmarks: if outside normal range, investigate
4.5 Room Data Sheets

For complex or specialist spaces, supplement the area schedule with Room Data Sheets (RDS). Each RDS specifies:

FieldContent
Room Name and NumberUnique identifier matching area schedule
AreaNet area in m2
OccupancyNumber and type of occupants
AdjacenciesRequired proximity to other rooms
FinishesFloor, wall, ceiling materials and performance
EnvironmentalTemperature range, humidity, air changes/hour, noise level
LightingLux level, type (natural/artificial), controls
Power/DataSocket count, data points, special power
EquipmentFixed equipment list with spatial requirements
AccessibilityWheelchair access, hearing loop, visual contrast
SecurityAccess control level, CCTV, panic alarm
NotesAny special conditions

Healthcare projects (NHS) use the standardised Activity DataBase (ADB) sheets. Education projects use BB103 environmental performance schedules.


5. Brief Validation

5.1 Purpose

Before design begins, the program must be tested against real-world constraints. A program that cannot fit the site, exceeds the budget, or violates codes is a failed program -- no matter how carefully the spaces were sized.

5.2 Site Capacity Test

Calculate whether the program fits the site:

  1. Site area (m2)
  2. Buildable area = site area minus setbacks, easements, rights-of-way, protected trees
  3. Maximum GEA per floor = buildable area x site coverage (typically 40-80% depending on zoning)
  4. Maximum floors = zoning height limit / floor-to-floor height
  5. Maximum GEA = GEA per floor x number of floors
  6. Program GEA = from area schedule (Section 4)
  7. Fit ratio = Program GEA / Maximum GEA
Fit RatioInterpretation
< 0.70Comfortable fit; room for amenity, landscape, future expansion
0.70 - 0.85Good fit; design flexibility available
0.85 - 0.95Tight fit; limited flexibility, careful massing needed
0.95 - 1.00Marginal; requires maximum envelope, limited ground-level amenity
> 1.00DOES NOT FIT; reduce program, add floors, or find larger site
5.3 Budget Envelope Test
  1. Total program GIA from area schedule
  2. Construction cost per m2 from BCIS, Turner & Townsend, or local benchmarks
  3. Estimated construction cost = GIA x cost/m2
  4. Total project cost = construction cost x all-in multiplier (typically 1.3-1.5 for fees, contingency, FF&E, inflation)
  5. Compare to client budget
Budget RatioInterpretation
Project cost < 85% of budgetPotential scope increase or higher specification
85-100% of budgetAligned; proceed with contingency
100-115% of budgetOver; value engineering or scope reduction needed
> 115% of budgetSignificant mismatch; fundamental reprogram
5.4 Code Compliance Pre-Check

Before design, verify the program is code-compliant:

  • Zoning: Use class, FAR/plot ratio, height, setbacks, parking minimums
  • Fire: Maximum compartment sizes, travel distances, number of exits (drives core design)
  • Accessibility: Percentage of accessible units, wheelchair-accessible routes
  • Daylight: Right-to-light, daylight/sunlight planning requirements
  • Environmental: Energy code baseline (Part L, Title 24, ASHRAE 90.1)
5.5 Red-Flag Checklist

Review the program for these common failures:

Red FlagIssueResolution
NTG ratio outside benchmark rangeOver/under-estimated circulation or coreRecalculate with type-specific ratios
Program GEA exceeds site capacityToo much floor area for siteReduce program, increase storeys, or acquire more land
No growth allowanceBuilding will be undersized on day 1Add 10-20% expansion capacity
Missing support spacesOnly primary spaces listedAdd storage, plant, circulation, WCs, cleaners
Adjacency conflictsNoise sources next to quiet spacesRecheck adjacency matrix, revise stacking
Parking shortfallNot enough parking for code/marketCalculate from code minimums or demand studies
Floor plate too deepSpaces exceed daylight reachLimit floor depth to 12-15m from window
Floor-to-floor too lowInsufficient for services distributionCheck structural depth + services + ceiling height
No phasing strategyClient needs partial occupancyDefine phases, ensure each phase is functional
Budget mismatch > 15%Program cost exceeds client budgetReprogram: reduce area, reduce specification, phase
5.6 Program Sign-Off

The validated program document should contain:

  1. Executive summary with total GIA, cost estimate, and key metrics
  2. Space-by-space area schedule (Section 4 template)
  3. Adjacency matrix and stacking diagram
  4. Room data sheets for specialist spaces
  5. Site capacity confirmation
  6. Budget alignment confirmation
  7. Code compliance pre-check results
  8. Client approval signature and date

This document becomes the baseline against which all design proposals are measured. Any subsequent change to the program requires a formal variation with impact assessment on area, cost, and schedule.


References

  • Pena, W. & Parshall, S. (2012). Problem Seeking: An Architectural Programming Primer. 5th ed. Wiley.
  • Cherry, E. (1999). Programming for Design: From Theory to Practice. Wiley.
  • Hershberger, R. (1999). Architectural Programming and Predesign Manager. McGraw-Hill.
  • Neufert, E. & Neufert, P. (2019). Neufert Architects' Data. 5th ed. Wiley-Blackwell.
  • MHCLG (2015). Technical Housing Standards -- Nationally Described Space Standard. UK Government.
  • RICS (2015). Code of Measuring Practice. 6th ed. Royal Institution of Chartered Surveyors.
  • BCO (2019). BCO Guide to Specification. British Council for Offices.
  • NHS Estates. Health Building Notes (HBN) Series. UK Department of Health.
  • DfE (2014). Building Bulletin 103: Area Guidelines for Schools. UK Department for Education.
  • ASHRAE (2021). ASHRAE Handbook -- Fundamentals. ASHRAE.
  • BOMA International (2017). Office Buildings: Standard Methods of Measurement. ANSI/BOMA Z65.1.
  • Sport England (2012). Design Guidance Notes. Sport England.
  • AUDE (2016). Guide to Post-Occupancy Evaluation. Association of University Directors of Estates.

© Abhinavbwj, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references) in skills/building-programming of Abhinavbwj/Skills-Architects.

  • SKILL.md
  • references/adjacency-methods.md
  • references/area-standards.md
  • templates/program-brief-template.md

Open the folder on GitHubat commit 30a0845

Compare with similar skills

Building Programming next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Building Programming compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Building Programming this skillAbhinavbwj/Skills-Architects295—~7.4kAutomated safety check: PassMIT
Ky Markdown RebuilderKyrieCheungYep/ky-markdown-rebuilder117—~5.7kAutomated safety check: PassNone
Markdown Report WritingNeuroAIHub/BrainPilot1k—~2.6kAutomated safety check: WarnAGPL-3.0
Single-File HTML Composeroaustegard/claude-skills150—~3.2kAutomated safety check: PassMIT
Report WritingGAIK-project/gaik-toolkit100—~4.9kAutomated safety check: PassMIT
Fable DomainSahir619/fable-method2.3k—~2.6kAutomated safety check: PassMIT

Similar skills

  • Ky Markdown Rebuilder

    KyrieCheungYep/ky-markdown-rebuilder

    Rebuild visual documents into reliable Markdown by combining text extraction with page or screenshot alignment.

    117 GitHub stars~5.7k tokensUpdated 2 mo ago
    Documents & OfficeAuto-check passed
  • Markdown Report Writing

    NeuroAIHub/BrainPilot

    Guide AI agents to write beautifully formatted, well-illustrated Markdown reports with proper structure, diagrams, and compatibility across GitHub and Obsidian.

    1k GitHub stars~2.6k tokensUpdated 5 days ago
    Documents & OfficeAuto-check: warnings
  • Single-File HTML Composer

    oaustegard/claude-skills

    Builds self-contained single-file HTML pages such as reports, decks, postmortems, flowcharts and prototypes from a small spec using a bundled Python composer and templates.

    150 GitHub stars~3.2k tokensUpdated 5 days ago
    Frontend & DesignAuto-check passed
  • Report Writing

    GAIK-project/gaik-toolkit

    Converts scattered documents and media (recordings, notes, diagrams, PDFs, spreadsheets) into structured MS Word reports.

    100 GitHub stars~4.9k tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Fable Domain

    Sahir619/fable-method

    Discuss a domain with the user, research it from real sources, then generate a trusted skill bundle for it - a step-by-step workflow with a flowchart, a domain adapter, a trap fixture, and a smoke…

    2.3k GitHub stars~2.6k tokensUpdated 4 days ago
    Product & Project ManagementAuto-check passed
  • Ichartjs

    wanghetommy/ichartjs

    Plan, validate, render, explain, and safely edit iChart.js visualizations from tabular, project, or diagram data.

    352 GitHub stars~3.4k tokensUpdated today
    Product & Project ManagementAuto-check passed

More from Abhinavbwj/Skills-Architects

All 17 skills in this repo
  • Architect Calculators

    Abhinavbwj/Skills-Architects

    Seven command-line Python calculators for early architectural checks: area and density, U-value, daylight factor, egress, structural load, energy demand and cost.

    295 GitHub stars~3.4k tokensUpdated 4 mo ago
    Auto-check passed
  • Building Typology Reference

    Abhinavbwj/Skills-Architects

    Compares building types, from detached houses to supertall towers, using plan depth, density and efficiency metrics plus exemplar buildings.

    295 GitHub starsUsed in 1 repo~8.5k tokens
    Auto-check passed
  • Architectural Concept Design

    Abhinavbwj/Skills-Architects

    Knowledge base for early-stage architectural design: parti development, massing studies, spatial organization and translating abstract ideas into building form.

    295 GitHub starsUsed in 1 repo~11k tokens
    Auto-check passed
  • Design Theory

    Abhinavbwj/Skills-Architects

    Architectural movements, design philosophy, critical theory, precedent analysis, and compositional principles for informed design reasoning

    295 GitHub starsUsed in 1 repo~8.5k tokens
    Auto-check passed
  • Material Selection

    Abhinavbwj/Skills-Architects

    Architectural material properties, durability, sustainability, specification, detailing, life-cycle assessment, and material palettes for building design

    295 GitHub starsUsed in 1 repo~8.4k tokens
    Auto-check passed
  • Building Codes Reference

    Abhinavbwj/Skills-Architects

    Reference for architects on IBC occupancy classification, construction types, height and area limits, egress, fire protection and plumbing fixtures, with international comparisons.

    295 GitHub stars~8.5k tokensUpdated 4 mo ago
    Auto-check passed

Questions about Building Programming

What does Building Programming do?

Guides architectural programming work: space needs, adjacency matrices, area schedules and net-to-gross checks for project briefs across common building types. Architectural programming defines and quantifies a building's spatial requirements before any design starts. The skill casts the agent as a practitioner following the Problem Seeking method of Pena and Parshall, with five steps (goals, facts, concepts, needs, problem statement) applied across five information categories, and it insists that every number traces to a published source.

When should I use Building Programming?

Building Programming fits situations like: building a space program and area schedule for a new project; sizing rooms and checking net-to-gross ratios against benchmarks; drawing up an adjacency matrix or a stacking diagram; checking a space program against site capacity and budget.

How do I install Building Programming in Claude Code?

Run `npx skills add Abhinavbwj/Skills-Architects --skill building-programming -a claude-code`. Or copy the skill folder (skills/building-programming in Abhinavbwj/Skills-Architects) into .claude/skills/building-programming in your project. Claude Code loads it when a task matches its description.

How do I install Building Programming in Codex?

Run `npx skills add Abhinavbwj/Skills-Architects --skill building-programming -a codex`. Or copy the skill folder (skills/building-programming in Abhinavbwj/Skills-Architects) into .agents/skills/building-programming in your project. Codex loads it when a task matches its description.

Can I use Building Programming in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Abhinavbwj/Skills-Architects --skill building-programming -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/building-programming, .gemini/skills/building-programming, .github/skills/building-programming and .opencode/skills/building-programming in your project.

What does Building Programming need to run?

SKILL.md names no scripts, command-line tools or credentials: Building Programming is instructions for the agent only.

Does Building Programming access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Building Programming safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Building Programming use?

Building Programming is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Building Programming use?

About 7.4k tokens (SKILL.md is roughly 29k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 13k tokens, read only when the agent opens those files.

What are the alternatives to Building Programming?

Skills that share tags, products or a category with Building Programming: Ky Markdown Rebuilder (KyrieCheungYep/ky-markdown-rebuilder, 117 stars), Markdown Report Writing (NeuroAIHub/BrainPilot, 1k stars), Single-File HTML Composer (oaustegard/claude-skills, 150 stars) and Report Writing (GAIK-project/gaik-toolkit, 100 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Building Programming?

Abhinavbwj (a GitHub user) maintains it in Abhinavbwj/Skills-Architects, which has 295 GitHub stars. The repository holds 17 skills in this directory. The repository was last updated on May 20, 2026.

Source: Abhinavbwj/Skills-Architects on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.