../

City design & planning

Prompting chat assistants and image generators about urban design and planning when you are not a planner: the scales planners work at, zoning and density, streets and transportation, public space, housing, infrastructure, resilience and equity, the planning process, the thinkers worth naming, a four-prompt chain that takes a street or neighborhood redesign from interview to a reviewed plan with an engagement plan, and a prompt library for zoning explainers, housing capacity, walkability audits, heat, tactical pilots, surveys, before-and-after images and network measures. The general method and the prompt skeleton are in Prompting fundamentals; single buildings are in Architectural design; city-builder games are in Game design.

How experts think

  • Scale first. A planner asks which decision is being made at which scale: a regional transit network, a neighborhood plan or one corner lot need different data, people and tools.
  • Land use and transportation are one problem. Where things are decides how people travel, and the transport network decides what gets built where. Widening a road or adding a station changes both.
  • Design for people walking. Most daily life happens within a short walk; experts measure distances in minutes on foot and judge streets at eye level.
  • Long time horizons. Streets and pipes last generations, buildings decades. Plans are judged by what they make possible in 20 years, not next year.
  • Who wins, who pays, who moves. Every choice has distributional effects. Planners ask who benefits, who bears the cost, and who could be displaced.
  • Rules make form. The zoning code shapes what gets built more than any vision document. To change a place, read its rules.
  • Evidence plus lived experience. Data shows patterns; residents know what the data misses. Plans without community support stall.
  • Maintenance is the long bill. Infrastructure has to be maintained by the tax base it serves; spread-out growth can cost more to maintain than it brings in (a central argument of the Strong Towns movement).

Scales

ScaleTypical sizeQuestionsTypical documents
Region / metrotens to hundreds of kmhousing markets, transit networks, watersheds, growth limitsregional plan; US metropolitan transportation plan
Citythe municipalitylong-range vision, land-use pattern, capital spendingcomprehensive or general plan, zoning code, capital improvement program
Districtdowntown, campus, corridor, portcharacter, mix of uses, major public spacesarea, specific or master plan
Neighborhood≈ a 10–20 minute walk acrossdaily needs, schools, parks, local streetsneighborhood plan
Street / corridorone right-of-wayhow space is divided between walking, cycling, transit, cars, treescorridor study, street design
Block≈ 60–250 m on a sideblock size, through-routes, building frontagessubdivision plat, urban design guidelines
Lot / parcelone propertysetbacks, height, floor area, usessite plan, zoning permit

Vocabulary

TermWhat it meansSay it like
Comprehensive (general) plana city's long-range policy document for land use, transportation, housing and more"Summarize the land-use goals in this comprehensive plan"
Zoningthe law that sets what can be built where: uses, height, bulk, parking"Explain what this zoning district allows"
Euclidean zoningzoning by separated use districts (residential, commercial, industrial); named for the 1926 US Supreme Court case Village of Euclid v. Ambler Realty"Compare use-based Euclidean zoning with a form-based code for this corridor"
Form-based coderegulation focused on building form and the street it faces more than on use"Draft form-based standards: build-to line, frontage types, height in stories"
Transecta rural-to-urban gradient of zones (T1 natural to T6 urban core) used in form-based codes such as the SmartCode"Which transect zone fits this main street?"
Overlay districtan extra layer of rules on top of base zoning (historic, flood, transit)"List the overlays affecting this parcel"
By-rightallowed without discretionary approval if the rules are met"Which of these housing types are by-right here?"
Variance / conditional usepermission to deviate from the rules / a use allowed only with review"What would need a variance?"
FAR (floor area ratio)total floor area ÷ lot area"At FAR 2.0 on a 1,000 m² lot, how much floor area?"
Lot coverageshare of the lot covered by buildings"Lot coverage limit 50%"
Setback / build-to lineminimum distance from the lot line / a required line the facade must sit on"Replace front setbacks with a build-to line at 2 m"
Densityhomes or people per unit area: dwelling units per acre or hectare, people per km²"Give density in du/ha and people/km², net and gross"
Net vs gross densitynet counts only residential parcels; gross includes streets, parks and other land"State whether each density figure is net or gross"
Mixed usedifferent uses together: shops below homes (vertical) or side by side (horizontal)"Ground-floor retail with three floors of homes above"
Missing middle housinghouse-scale buildings with several homes: duplexes to small apartment courts (term coined by Daniel Parolek, 2010)"Where could missing middle types fit on these blocks?"
ADU (accessory dwelling unit)a second, smaller home on a house lot: backyard cottage, garage or basement apartment"What would allowing ADUs by-right change here?"
Infill / greenfield / brownfieldbuilding on vacant or underused urban lots / on undeveloped land / on previously used, possibly contaminated land"Rank infill sites by readiness"
Upzoningchanging rules to allow more or denser development"Model the effect of upzoning these corridors"
Right-of-way (ROW)the full public width between property lines: sidewalks, planting, lanes"Allocate a 24 m right-of-way"
Street hierarchyfunctional classes: arterials (through movement), collectors, local streets (access)"Classify these streets and say what each should prioritize"
Complete streetsstreets designed for safe use by all users and modes"Redesign as a complete street"
Road dietremoving travel lanes to add turn lanes, bike lanes, wider sidewalks or transit"Evaluate a road diet from four lanes to two plus a center turn lane"
Level of service (LOS)letter grades A–F of vehicle delay at intersections and roads"Show LOS and VMT effects side by side"
VMTvehicle miles (or km) traveled: total driving generated"Estimate how this plan shifts VMT per resident"
Induced demandadded road capacity tends to generate more driving over time"Account for induced demand in the widening option"
TOD (transit-oriented development)compact, mixed-use, walkable development around transit stations"TOD options within 800 m of the station"
Walkshedthe area reachable on foot in a given time along real streets"Map the 10-minute walkshed from the school"
Connectivity / permeabilityhow many route choices a network offers; intersection density is a common measure"Compare intersection density before and after"
15-minute cityCarlos Moreno's concept of meeting daily needs within a short walk or bike ride"Which daily needs are missing within 15 minutes on foot?"
Public realmstreets, squares, parks and other spaces everyone can use"Audit the public realm along this corridor"
Active frontagebuilding edges with doors, windows and uses facing the street"Require active frontage on 70% of the ground floor"
Placemakingshaping public spaces around how people actually use them, often with residents"Plan a placemaking pilot for this plaza"
Tactical urbanismquick, cheap, temporary changes (paint, planters) to test an idea"Design a tactical pilot to test the plaza for three months"
Green infrastructurevegetation and soil that manage stormwater: bioswales, rain gardens, green roofs, street trees"Add green infrastructure to handle the first 25 mm of rain"
Impervious surfaceroofs and paving that shed water instead of absorbing it"Estimate impervious cover before and after"
Urban heat islandbuilt-up areas staying hotter than surroundings, especially at night"Rank heat-island fixes for this district"
Floodplainland likely to flood; in the US, FEMA's special flood hazard area has a 1% annual chance of flooding"Which parcels are in the special flood hazard area?"
Displacementresidents or businesses forced out directly (eviction, demolition) or by rising costs"Assess displacement risk and anti-displacement measures"
Inclusionary zoningrequiring or incentivizing affordable units in new development"Compare mandatory and voluntary inclusionary options"
Desire linean informal path worn by people taking the route they want"Use desire lines to place crossings"
Vision Zeroroad-safety policy aiming for zero traffic deaths and serious injuries, from Sweden (1997)"Apply Vision Zero principles to this intersection"

Land use and zoning

Euclidean (use-based) zoningForm-based code
Main controlwhich uses are allowed in each districtthe physical form: frontage, height, placement, street relationship
Typical toolsuse tables, minimum lot sizes, setbacks, FAR, parking minimumsregulating plan, building form standards, frontage types, public-space standards
Strengthfamiliar, simple to administer, separates noxious usespredictable streetscape, easier mixed use
Critiqueseparates daily needs, forces driving, can exclude housing typescan be prescriptive; still needs good use rules

FAR fixes the total floor area, not the shape; setbacks and coverage limits decide the shape:

street side 2 floors × 1,000 m² 100% coverage: breaks the setbacks street side 4 floors × 500 m² 50% coverage street side 8 floors × 250 m² 25% coverage, more open ground same lot (25 × 40 m = 1,000 m²), same 2,000 m² of floor: FAR 2.0 each dashed: what the setbacks allow (5 m front and rear, 2.5 m sides)
Ask for the envelope (setbacks, height, coverage) along with FAR, or the floor area means little.

Density conversions you will need: 1 acre ≈ 0.405 ha; 1 dwelling unit per acre ≈ 2.47 per hectare; 1 km² = 100 ha ≈ 247 acres. Worked: 20 du/acre ≈ 49 du/ha; at 2.5 people per home that is 50 people per acre ≈ 12,400 people/km² net (residential land only). Gross density for the same area is lower once streets and parks are counted.

Rough net densities (they vary widely; compute your own from real lots): detached houses on suburban lots ≈ 4–8 du/acre (≈ 10–20 du/ha); townhouses and small multiplexes ≈ 15–30 du/acre (≈ 35–75 du/ha); mid-rise apartments ≈ 50–150 du/acre (≈ 125–370 du/ha).

Streets and transportation

TopicWhat to knowAsk the model to
Street hierarchyarterials move through traffic, collectors gather it, local streets give access; the right design differs for eachclassify streets from a map you describe and propose design priorities per class
Right-of-way allocationa fixed width (say 24 m) split among sidewalks, trees, bike lanes, parking, transit and travel lanesproduce cross-section options that add up exactly to the width, as a table, left to right
Complete streets and road dietssafer design for all users; the classic road diet turns four undivided lanes into two travel lanes, a center turn lane and bike laneslist the conditions under which a road diet works and what to measure before and after
Transitfrequency matters as much as coverage; TOD is usually planned within ≈ 400–800 m (a 5–10 minute walk) of stationscompare station-area options and their walksheds
Walkabilityshort blocks, connected streets, continuous sidewalks, safe crossings, destinations nearbyaudit a route or neighborhood from photos and a map
LOS vs VMTLOS measures driver delay and tends to favor widening; VMT measures how much driving a project generates. California's SB 743 (2013) moved environmental review of transportation impacts from LOS to VMT, statewide from July 2020show both metrics for each option and say which the jurisdiction uses
Induced demandstudies such as Duranton and Turner (2011) found driving in US metros rose roughly in proportion to added interstate highway lane-kilometersaccount for it when comparing widening with alternatives
Parkingminimum parking requirements raise the cost of housing and shops (Donald Shoup, The High Cost of Free Parking, 2005)estimate land used by parking under current rules and alternatives
Safetyspeed is the main driver of injury severity; Vision Zero designs for human erroridentify high-risk design features: wide lanes, long crossings, turning speeds

A 24 m main street before and after a classic road diet, with widths that add up to the right-of-way:

Before: four travel lanes 3.0 + 2.4 + 4 × 3.3 + 2.4 + 3.0 = 24 m sidewalk 3.0 parking 2.4 travel 3.3 travel 3.3 travel 3.3 travel 3.3 parking 2.4 sidewalk 3.0 After: road diet 3.0 + 2.4 + 2.1 + 3 × 3.0 + 2.1 + 2.4 + 3.0 = 24 m sidewalk 3.0 bike 2.4 parking 2.1 travel 3.0 turn 3.0 travel 3.0 parking 2.1 bike 2.4 sidewalk 3.0 24 m, wall to wall
Same width, different priorities; ask for every option as a table that sums to the right-of-way.

The 15-minute city is a planning concept (Carlos Moreno, 2016, adopted as a goal by Paris), not a standard. It works as a lens for "which daily needs are missing nearby"; whether and how it applies in low-density places is debated.

home G S T P C highway one crossing Within 15 minutes on foot? walking ≈ 80 m a minute: 15 min ≈ 1.2 km G grocery 6 min yes S school 10 min yes T station 12 min yes P park 12 min yes C clinic 30 min no The clinic is inside the circle but 30 minutes away: the highway has one crossing. streets reachable in 15 min 5, 10, 15 min as the crow flies On a grid the walkshed is a diamond, about 64% of the circle's area. illustrative grid, 160 m blocks
Ask for walksheds along real streets; a radius flatters every barrier.

Blocks, grids and public space

  • Block size sets walkability. Smaller blocks mean more intersections, more route choices and more corners for shops. Reference points (approximate): Portland, Oregon ≈ 61 m (200 ft) square; Barcelona's Eixample ≈ 113 m with chamfered corners; Manhattan ≈ 61 m deep by 180–280 m long.
  • Network shape. Grids spread traffic and give choices; radial patterns focus on centers; cul-de-sac (tree-like) networks are quiet inside but force all trips onto a few arterials and lengthen walks.
  • Superblocks. Barcelona groups Eixample blocks (typically 3 × 3) and removes through traffic from the interior streets, turning them into shared space.
  • Public space works when people use it. William H. Whyte's The Social Life of Small Urban Spaces (1980) found that sittable space, sun, trees, water, food and a connection to the street draw people. Jan Gehl distinguishes necessary, optional and social activities: good spaces invite the optional and social ones.
  • Edges matter. People linger at edges; active frontages, doors every few meters and ground floors you can see into keep streets lively.
Portland ≈ 61 × 61 m blocks 25 intersections Manhattan ≈ 61 m × 180–280 m 10 intersections Barcelona Eixample ≈ 113 m, cut corners 16 intersections superblock: 3 × 3 blocks, inner streets shared most route choices, corners for shops long blocks: fewer crossings east-west 100 m · each view 420 × 420 m, same scale
Count intersections in the same area: it is the quickest test of how walkable a grid can be.

Housing

TypeWhat it isWhere it fits
Detached houseone home on its own lotlow-density areas; the default in many codes
ADUa small second home on a house lotalmost any house lot, if allowed
Duplex, triplex, fourplextwo to four homes in a house-sized buildingmissing middle; transitions between houses and main streets
Townhouse / rowhouseattached homes, each with its own entryneighborhood edges, near transit
Cottage (bungalow) courtsmall houses around a shared gardenmid-block, larger lots
Courtyard apartmentapartments around a courtyard, house-scalecorners, main streets
Mid-riseroughly 4–8 stories; in the US often wood frame over a concrete podiumcorridors, TOD
High-riseelevator buildings, typically above ≈ 8–12 storiescenters, major stations

Ask the model which types the current zoning actually permits by-right; codes that allow only detached houses on large lots are a common reason missing middle types disappeared.

Infrastructure, environment and resilience

SystemKey ideasPlanning questions
Water supplytreatment, pipes, pressure zones, fire flowis there capacity for the growth this plan allows?
Sanitary sewerwastewater to treatment; older cities often have combined sewers that overflow in storms (CSOs)where are the capacity limits and overflow points?
Stormwaterimpervious cover raises runoff; detention stores and releases slowly, retention holds or infiltrateshow much new impervious surface; where does the water go?
Green infrastructurebioswales, rain gardens, permeable paving, green roofs, street treeswhich streets and lots can host it?
Heatdark surfaces and little shade make urban heat islandswhere are the hottest blocks, and who lives there? Trees, shade, cool roofs and pavements first
FloodingFEMA flood maps in the US; sea-level rise; river and surface-water floodingwhich parcels and critical facilities are exposed; protect, adapt or retreat?
Energy, broadband, wastenetworks and facilities with long lead timescoordinated with the land-use plan?

Equity and displacement

  • History matters. In the US, 1930s "redlining" maps, urban renewal and highway building cut through and displaced many Black and immigrant neighborhoods; their effects persist in today's maps of health, heat and wealth.
  • Displacement is direct or indirect. Direct: eviction, demolition. Indirect: rising rents and taxes push people out over time. Investment that improves a place can do both.
  • Tools. Tenant protections, inclusionary zoning, community land trusts, preservation of existing affordable homes, community benefits agreements and local hiring.
  • Environmental justice. Who lives next to highways, industry, flood risk and heat? Ask the model to break every benefit and burden down by group, using data you supply.

The planning process

  1. Existing conditions

    Land use, zoning, demographics, housing, transport, environment, infrastructure, history; gather data and listen.
  2. Vision and goals

    What the community wants, as measurable objectives.
  3. Alternatives

    Two to four scenarios, deliberately different.
  4. Evaluation

    Compare scenarios against goals: housing, travel, cost, environment, equity.
  5. Preferred plan and adoption

    Public hearings before the planning commission and elected body; environmental review where required.
  6. Implementation and monitoring

    Zoning changes, capital projects, programs; indicators tracked and the plan revisited.

The documents and laws differ by place. In the US, cities adopt a comprehensive plan (California requires a "general plan"), a zoning ordinance, subdivision rules and a capital improvement program. Federal actions trigger review under the National Environmental Policy Act (NEPA), and some states have their own laws (California's CEQA, Washington's SEPA, New York's SEQRA). In England, local plans sit under the National Planning Policy Framework; EU member states apply the Environmental Impact Assessment and Strategic Environmental Assessment directives.

Engagement. Sherry Arnstein's Ladder of Citizen Participation (1969) ranks participation from manipulation to citizen control; the IAP2 Spectrum (inform, consult, involve, collaborate, empower) asks you to promise a level and keep it. Methods include workshops, charrettes (intensive multi-day design sessions), walking audits, surveys, pop-up events, online maps and tactical pilots.

Thinkers and sources to name

WhoWorkCore ideaUse it in a prompt
Jane JacobsThe Death and Life of Great American Cities (1961)diversity needs mixed primary uses, short blocks, buildings of varied age and enough concentration of people; "eyes on the street""Assess this district against Jacobs's four conditions for diversity"
Kevin LynchThe Image of the City (1960)people map cities with paths, edges, districts, nodes and landmarks; imageability"Map the area's paths, edges, districts, nodes and landmarks; where is it hard to read?"
Jan GehlLife Between Buildings (1971, English 1987), Cities for People (2010)design at eye level and walking speed; study public life by observing it"Plan a Gehl-style public life study: counts, stays, times"
William H. WhyteThe Social Life of Small Urban Spaces (1980)observed what makes plazas used: seating, sun, food, water, street connection"Critique this plaza with Whyte's findings"
Christopher Alexander et al.A Pattern Language (1977)253 patterns from region to room, each a problem and a solution"Which patterns apply to this neighborhood center?"
Ebenezer HowardGarden Cities of To-morrow (1902)planned towns of limited size surrounded by greenbeltshistorical context for new towns and greenbelts
Donald ShoupThe High Cost of Free Parking (2005)parking minimums and free curbs carry hidden costs"Estimate what parking minimums cost per home here"
NACTOUrban Street Design Guide (2013) and related guidescity-street design guidance: lane widths, crossings, transit and bike facilities"Follow NACTO guidance; cite the section you rely on"
Sherry Arnstein"A Ladder of Citizen Participation" (1969)participation ranges from token to real power"Where on Arnstein's ladder does this engagement plan sit?"

Maps, diagrams and images

Image generators cannot make accurate maps: they invent streets, garble labels and ignore scale. Use them for illustration; use GIS for anything that must be true.

NeedToolPrompting tip
Accurate maps and measuresQGIS with OpenStreetMap data; Python with GeoPandas and OSMnxask a chat model for QGIS steps or a script, run it yourself, check the numbers
Street sectionsStreetmix or a tableask for a left-to-right cross-section table whose widths sum to the right-of-way
Before/after street viewsimage generator, image-to-image from a real photo"same street, same buildings and camera; replace the right lane with a protected bike lane and trees"
District diagramsimage generator or vector tool"axonometric diagram, flat colors, no text, land use colored: residential yellow, commercial red, civic blue, parks green" (US convention)
Concept planssketch, then image-to-imagekeep the street network fixed in the reference; ask only for texture and mood

A ready before-and-after prompt is in the Prompt library.

Brief the model

Each input has a slot in the prompt skeleton (see Prompting fundamentals); the Slot column says where it goes.

InputWhy it mattersExampleSlot
Place and jurisdictionrules and data are local"Downtown of a 60,000-person city in Oregon"<context>
Scale and boundarysets the analysis"The 1.2 km corridor between the river and the rail station"<context>
Existing conditions datathe model can't see the siteland use, zoning, population, traffic counts, crash data, transit frequency, parcel sizes (paste tables)<materials>
Rules in forcethe legal starting point"Zoning text for C-2 and R-1 attached; comprehensive plan policies on housing"<materials>
Goals and metricslets options be compared"Add 1,500 homes; cut traffic injuries; no net loss of tree canopy"<requirements>
Constraintswhat can't change"Right-of-way 24 m; state highway; floodplain on the east side; budget"<requirements>
Stakeholdersengagement and equityresidents, renters, businesses, schools, transit agency, the state DOT<context>
Decision and audiencesets tone and depth"A memo for the planning commission" or "a one-page flyer for neighbors"<context>, and the decision in <task>
Output formatmakes it checkabletables, scenario matrix, maps described for GIS<output_format>
Your rolewhat the model should explain"Resident and advocate, not a planner"<context>

What to ask for

StageDeliverables to ask for by name
Existing conditionsexisting conditions report outline; data request list with sources; SWOT; Lynch-style legibility map description; walkability audit checklist
Visioninggoals and objectives with indicators; engagement plan; survey questions; workshop agenda
Alternatives2–4 scenarios with land use, density, street network and transit described consistently
Evaluationscenario evaluation matrix; housing capacity estimate; trip-generation and VMT reasoning (flagged as rough); fiscal and equity impact questions; displacement risk assessment
Plan and adoptionplan chapter outline; policy and action table (who, when, cost range); plain-language summary; FAQ for a public meeting; staff-report outline
Implementationzoning amendment checklist; capital project list; monitoring indicators; pilot (tactical) project plan
Streetscross-section options; intersection safety review; before/after image prompts; data to collect before and after

The prompt chain

The main deliverable is a street or neighborhood redesign: existing conditions, measurable goals, two to four scenarios, and a recommended plan with an engagement plan. It follows the planning process above (existing conditions, goals, alternatives, evaluation, preferred plan). Run the four prompts in order and paste each answer into the next.

1. Interview

Use before any proposal: the model asks what a planner asks when scoping a project.

<context>
I want to improve [place, e.g. the 1.2 km main street between the
river and the rail station] in [jurisdiction, e.g. a 60,000-person
city in Oregon].
My role: [role: resident | advocate | business owner | city staff];
I'm not a planner.
</context>
 
<task>
Interview me the way a planner scopes a street or neighborhood
redesign, before any proposals. Don't propose anything yet.
</task>
 
<requirements>
- At most 10 questions, grouped: place and boundary; existing
  conditions data; rules in force (zoning, street classification,
  who owns the right-of-way); goals and metrics; people affected;
  decision, budget and timeline.
- For each question: why it matters, typical answers, and the
  official source where I'd find the data (e.g. the state DOT for
  traffic counts, the city's zoning map).
</requirements>
 
<process>
Ask all the questions in one message, then stop and wait. When I
answer, restate the brief as a list, write [NEEDS SOURCE] for every
figure I don't have and [CHECK LOCAL CODE] for every rule I haven't
pasted, and end with a list of the assumptions you made.
</process>

2. Options

Use once the brief is confirmed: scenarios that differ in ambition and approach, scored before anything is drawn.

<materials>
[paste the brief from stage 1, the data tables, and the zoning and
street-classification text]
</materials>
 
<task>
Propose [number of scenarios: 2 | 3 | 4] materially different
scenarios for this [scale: street | corridor | neighborhood], so
[decision maker, e.g. the city council] can choose one to develop.
</task>
 
<requirements>
- The scenarios differ in ambition and approach, e.g.
  [scenario set, e.g. tactical pilot, road diet, rezoning plus
  street redesign].
- For each: street changes as a cross-section table that sums
  exactly to the right-of-way; land use and zoning changes (FAR,
  form-based standards, missing middle types); transit and walking
  changes; rough cost (low, medium or high) and timeline; who
  benefits, who pays, displacement risk; approvals needed.
- Describe LOS and VMT effects side by side, and say which metric
  the jurisdiction uses for review: [CHECK LOCAL CODE].
- Never invent numbers, names, quotes or sources: write
  [NEEDS SOURCE] where support is missing.
</requirements>
 
<output_format>
A section per scenario; then an evaluation matrix (scenarios × my
goals, scored 1-5 with one-line reasons); then a recommendation and
the assumption that would flip it.
</output_format>
 
<process>
Stop after the recommendation and wait for my choice. End with a
list of the assumptions you made.
</process>

3. Produce

Use after the choice: the full skeleton, filled in for the recommended plan and how the public will shape it.

<materials>
[paste the brief, the chosen scenario, the data tables (counts,
crashes, transit frequency, parcels), the zoning text and the
comprehensive plan policies that apply]
</materials>
 
<context>
Place: [place, e.g. Main Street from 1st to 9th, 24 m right-of-way,
a state route]. Jurisdiction: [jurisdiction, e.g. a US city of
60,000 in Oregon].
Readers: [audience: neighbors | planning commission | city council],
who [readers' knowledge, e.g. know the street well but not planning
terms].
</context>
 
<task>
Develop scenario [chosen scenario, e.g. B, a road diet with
protected bike lanes] into a recommended redesign plan with an
engagement plan, ready for [next step, e.g. a council work
session].
</task>
 
<requirements>
- Existing conditions from my data only.
- Goals as measurable objectives with indicators (baseline, target,
  year).
- Design: cross-sections per segment that sum exactly to the
  right-of-way; intersection treatments; transit stops; curb uses
  (loading, parking); trees and green infrastructure. Apply complete
  streets principles and the NACTO Urban Street Design Guide, naming
  the section relied on; mark every dimension a traffic engineer
  must confirm.
- Land use: zoning changes that would support the design (FAR,
  build-to lines, active frontage, missing middle types), each
  marked [CHECK LOCAL CODE].
- Equity: benefits, burdens and displacement risk by group, with
  anti-displacement measures.
- Implementation: phases, actors, rough cost (low, medium or high),
  approvals (state DOT, utilities, environmental review).
- Engagement plan: the IAP2 level promised at each stage, methods
  per audience, access (languages, times, childcare), how input is
  reported back; flag where it risks tokenism on Arnstein's ladder.
- Never invent numbers, names, quotes or sources: write
  [NEEDS SOURCE] where support is missing.
</requirements>
 
<quality_bar>
Before answering, check your draft against:
- Every figure is from my data or marked [NEEDS SOURCE].
- Every cross-section sums to the right-of-way; every density says
  net or gross.
- Each element says who benefits and who pays; nothing is all
  upside.
- Every action has an actor, a money source and an approval path.
- The engagement plan says what the public can actually change.
</quality_bar>
 
<output_format>
Sections: a one-paragraph summary for the readers named above;
existing conditions; goals and indicators (table); design
(cross-section tables, then intersections); land use; equity;
implementation (table: action, who, when, cost, approval);
engagement plan (table: stage, IAP2 level, methods, audiences);
data to collect before and after.
</output_format>
 
<process>
Ask me up to 3 questions first if anything missing would change
your answer; otherwise go on. End with a list of the assumptions
you made.
</process>

4. Review

Run this in a fresh chat with only the brief and the plan: a model reviewing its own draft shares its blind spots, including the numbers it made up.

<materials>
<brief>
[paste the brief and data tables from stage 1]
</brief>
<draft>
[paste the plan from stage 3]
</draft>
</materials>
 
<task>
Review this redesign plan against the brief, as a pre-hearing staff
review. Critique only: don't rewrite it or add proposals.
</task>
 
<requirements>
- Score each 1-5 with evidence quoted from the draft: grounded in my
  data; arithmetic (cross-sections, densities, capacities); right
  scale; rules (zoning vs. plan policy vs. street standards, quoted);
  trade-offs; equity; implementation; engagement.
- Recompute every cross-section and capacity figure.
- List every number in the draft that is neither in my data nor
  marked [NEEDS SOURCE].
- Mark rules you can't confirm from the pasted text
  [CHECK LOCAL CODE].
</requirements>
 
<quality_bar>
Before answering, check your review against:
- Every score cites the draft.
- Fixes are ranked by how much they would change the decision.
- The review adds no proposals of its own.
</quality_bar>
 
<output_format>
A rubric table; the top 5 fixes, ranked; the questions a planning
commission is likely to ask.
</output_format>
 
<process>
End with a list of the assumptions you made.
</process>

Goals and loops

In an agent that runs commands and checks its own work, such as Claude Code, the Produce stage can run until it measurably passes: /goal keeps starting turns until a condition holds, and /loop repeats a prompt or skill on an interval. The checker reads only the conversation, so every condition below names a check whose output Claude prints, the constraints that must survive, and a bound. How to write your own: Goals and loops.

TaskCompletion condition
Street cross-sections/goal each cross-section's widths sum exactly to the right-of-way (print the sums for before and after), and every lane meets the minimum width stated in the document; or stop after 8 turns
Walkability metrics/goal python network.py (OSMnx) prints intersection density and the share of homes within a 10-minute walk of a school for before and after, and the document's numbers match its output; or stop after 10 turns
Engagement plan/goal every stakeholder group in stakeholders.csv has at least one activity at a stated IAP2 level, with a date and a language need noted (print the table); or stop after 6 turns

Loops that fit: a weekly /schedule to read the city council and planning commission agendas for items in your study area and summarize them.

What a checker can't judge: what the community values and will accept. Only engagement with the people who live there answers that.

Prompt library

One entry per deliverable. Quick is the minimum that still works; Full fills in the skeleton.

Zoning and proposal explainer

Stage: produce · Use when: you need to know what the rules allow, or to explain a proposed change or project to neighbors before a hearing.

Quick

Here is the zoning text [paste district text] and the proposal [paste
amendment or staff report]. In plain language: what current rules
allow by-right on a typical lot, what the proposal changes (before and
after table) and what it would let someone build, with the arithmetic.
Quote the clause for each claim; mark gaps [CHECK LOCAL CODE].

Full

<materials>
[paste the zoning district text and definitions, plus the proposed
amendment or the project's staff report]
</materials>
 
<context>
District: [district, e.g. C-2 downtown commercial]. Typical lot:
[lot, e.g. 15 × 40 m].
Readers: [readers: neighbors | commissioners | a reporter],
who know the area but not zoning terms.
</context>
 
<task>
Write a neutral one-page explainer of what the rules allow now and
what the [change: zoning amendment | development proposal | variance]
would change, ahead of the hearing.
</task>
 
<requirements>
- Current rules: uses, height, setbacks or build-to lines, FAR, lot
  coverage, parking, by-right vs. discretionary review.
- A before-and-after table of what changes.
- What could realistically be built on the typical lot before and
  after, with the arithmetic (floor area = FAR × lot area; homes =
  floor area ÷ a stated average home size).
- For a project: height and number of homes compared with nearby
  buildings; traffic and parking findings quoted from the documents,
  not estimated.
- How and when to comment.
- Quote the clause behind each statement and use only the pasted
  text; write [CHECK LOCAL CODE] where it doesn't settle a rule.
- Never invent numbers, names, quotes or sources: write
  [NEEDS SOURCE] where support is missing.
</requirements>
 
<quality_bar>
Before answering, check your draft against:
- Neutral: no adjective that argues for or against.
- Every rule has a quoted clause; every number is quoted or computed.
- A neighbor finds "how tall, how many homes, how much parking" in
  under a minute.
</quality_bar>
 
<output_format>
One page: a three-sentence summary; a rules table; the
before-and-after table; what could be built; how to comment. Then
an FAQ of 8 questions with neutral answers.
</output_format>
 
<process>
End with a list of the assumptions you made.
</process>

Housing capacity estimate

Stage: produce · Use when: you need to know how many homes a rezoning or a set of sites could hold, with arithmetic anyone can check.

Quick

From this parcel table [paste parcel table], estimate housing capacity
under [scenarios, e.g. FAR 1.5 today vs. FAR 3.0 proposed]: floor area,
homes at a stated average size, realistic redevelopment share, and net
density in du/ha and du/acre. Show every step, label net or gross, and
mark any parcel figure not in my table [NEEDS SOURCE].

Full

<materials>
[paste a parcel table: ID, area, current use, zoning, owner type,
constraints such as floodplain or historic status]
</materials>
 
<context>
Area: [area, e.g. within 800 m of the Main St station].
Purpose: [purpose: comparing rezonings | a housing target | a grant].
</context>
 
<task>
Estimate housing capacity under [scenarios, e.g. current zoning and
the proposed upzoning], so the scenarios compare on homes added.
</task>
 
<requirements>
- Per parcel: allowed floor area (FAR × parcel area, capped by height
  and coverage), residential share, homes at [average home size, e.g.
  70 m² plus 15% circulation], and a realistic redevelopment share
  (not every parcel redevelops: state the rate and why).
- Totals: theoretical vs. realistic capacity over [horizon, e.g. 10
  years].
- Density as net du/ha and du/acre (1 du/acre ≈ 2.47 du/ha), plus
  gross for the whole area.
- Exclude or flag constrained parcels (floodplain, historic, public).
- Never invent numbers, names, quotes or sources: write
  [NEEDS SOURCE] where support is missing and [CHECK LOCAL CODE]
  for zoning limits I didn't paste.
</requirements>
 
<quality_bar>
Before answering, check your draft against:
- Every parcel figure comes from my table.
- The arithmetic chain is shown and redone once.
- Net and gross densities are labeled and plausible for the
  building types implied.
</quality_bar>
 
<output_format>
Parcel table with computed columns; a scenario totals table; a
paragraph on the assumptions that move the result most.
</output_format>
 
<process>
Ask me up to 3 questions first if anything missing would change
your answer; otherwise go on. End with a list of the assumptions
you made.
</process>

Walkability audit

Stage: review · Use when: you want to know why a route or neighborhood is unpleasant to walk and what to fix first.

Quick

Audit this walk along [route, e.g. Elm St from the school to the
grocery] from my photos and notes [paste photos and notes]: sidewalks,
crossings, speeds, block length, shade, active frontage, seating,
destinations within 10 minutes. Score each 1-5 citing a photo, then
give the five cheapest high-impact fixes and who handles each.

Full

<materials>
[paste or attach photos from the walk, in order, each with a note:
where, what time, what you noticed]
</materials>
 
<context>
Route: [route, e.g. Elm St from Lincoln Elementary to the grocery,
about 900 m]. Place: [jurisdiction, e.g. a suburb of Columbus,
Ohio]. Who walks it: [walkers, e.g. kids going to school, older
adults going to the bus stop].
</context>
 
<task>
Audit this route for walkability and rank the fixes, so I can take
a short, credible list to
[recipient: the transportation department | a council member].
</task>
 
<requirements>
- Criteria: sidewalk continuity and width; crossings (spacing,
  signals, sight lines, crossing length); traffic speed and lane
  width; block length; shade; active frontage; places to sit;
  destinations within a 10-minute walk.
- Score each 1-5 with evidence from a named photo.
- Reason about safety the Vision Zero way: design for human error,
  speed first.
- Fixes: cheapest high-impact first, with who in the city handles
  each; mark anything that needs a traffic engineer.
- Never invent numbers, names, quotes or sources: write
  [NEEDS SOURCE] where a photo doesn't show it, and
  [CHECK LOCAL CODE] for street standards.
</requirements>
 
<quality_bar>
Before answering, check your draft against:
- Every score cites a photo.
- The fixes serve the people who actually walk this route.
- No fix is vague ("improve crossings"): each names a place and a
  treatment.
</quality_bar>
 
<output_format>
Score table (criterion, score, evidence); five fixes (where, what,
cost low, medium or high, who handles it); data to collect next
(speeds, crashes, counts).
</output_format>
 
<process>
End with a list of the assumptions you made.
</process>

Heat-island action list

Stage: produce · Use when: a neighborhood runs hot and you need priorities for trees, shade and surfaces.

Quick

District: [land cover, e.g. 12% tree canopy, flat dark roofs, 4 ha of
surface parking]. Rank heat fixes (street trees, shade, cool roofs,
cool or permeable pavement, depaving, cooling centers) by impact,
cost, time to effect and who benefits, favoring the most exposed and
vulnerable blocks. Use only my data; list what to get next.

Full

<materials>
[paste land cover, tree canopy %, roof types, parking area, and
income and age by block; add surface-temperature data if you have
it]
</materials>
 
<context>
District: [district, e.g. the Eastside industrial edge, about 2
km²]. Climate: [climate: hot-dry | hot-humid | temperate with heat waves].
Budget and owner: [budget, e.g. a $2 million city grant over 3
years].
</context>
 
<task>
Rank heat-island interventions for this district and say where to
start, so the grant goes to the blocks that need it most.
</task>
 
<requirements>
- Interventions: street trees, shade structures, cool roofs, cool or
  permeable pavement, depaving parking, green infrastructure,
  cooling centers.
- For each: impact, cost, time to effect (trees take years), upkeep,
  who benefits.
- Prioritize blocks by exposure (heat, canopy) and vulnerability
  (age, income, no air conditioning), using only my data.
- Never invent numbers, names, quotes or sources: write
  [NEEDS SOURCE] where support is missing.
</requirements>
 
<quality_bar>
Before answering, check your draft against:
- The ranking uses my data, not a generic list.
- Quick shade and long-term trees are both in the plan, with timing.
- Benefits are broken down by group, not mentioned in a closing
  line.
</quality_bar>
 
<output_format>
Table: intervention, impact, cost, time to effect, upkeep, who
benefits. Then the top blocks with reasons. Then the data to get
next.
</output_format>
 
<process>
Ask me up to 3 questions first if anything missing would change
your answer; otherwise go on. End with a list of the assumptions
you made.
</process>

Tactical pilot plan

Stage: produce · Use when: you want to test a change (a plaza, a bike lane, a curb extension) cheaply before anyone builds it for good.

Quick

Plan a [length: 3-month | 6-month | 1-year] tactical pilot to test
[change, e.g. a plaza in the Oak St slip lane] with paint, planters
and movable seating: layout, materials and rough cost, permits and
partners, before-and-after measures, and the rule for making it
permanent. Mark permits [CHECK LOCAL CODE]; every measure has a baseline.

Full

<materials>
[paste or attach photos and dimensions of the site, current counts
or speeds if any, and the city's pilot or encroachment rules]
</materials>
 
<context>
Site: [site, e.g. the Oak St slip lane, about 25 × 8 m of asphalt].
Sponsor: [sponsor: residents | a business association | the city].
Budget: [budget, e.g. $15,000 including volunteer time].
</context>
 
<task>
Plan a tactical urbanism pilot that tests [change, e.g. turning the
slip lane into a plaza] and produces the evidence for a decision on
a permanent project.
</task>
 
<requirements>
- Layout with dimensions; materials (paint, planters, posts,
  movable seating) with rough costs; installation day plan.
- Safety: emergency and delivery access, sight lines at crossings;
  mark what a traffic engineer must approve.
- Permits, insurance and maintenance: [CHECK LOCAL CODE].
- Measures with a baseline before installation: people counts,
  stays (Gehl-style public life counts), vehicle speeds, business
  feedback.
- A decision rule set in advance: what result makes it permanent,
  changes it, or removes it.
- Never invent numbers, names, quotes or sources: write
  [NEEDS SOURCE] where support is missing.
</requirements>
 
<quality_bar>
Before answering, check your draft against:
- Every measure has a baseline and a date.
- Access for emergency vehicles and deliveries is solved, not
  assumed.
- The decision rule is written before the pilot starts.
</quality_bar>
 
<output_format>
Layout description with dimensions; a materials and cost table; a
timeline; a measurement plan table (measure, method, before, during,
after); the decision rule.
</output_format>
 
<process>
Ask me up to 3 questions first if anything missing would change
your answer; otherwise go on. End with a list of the assumptions
you made.
</process>

Community survey

Stage: produce · Use when: you need residents' input on a plan and want questions that inform a decision without leading anyone.

Quick

Write a 10-question survey on [plan, e.g. the Main Street redesign]
for [community, e.g. residents, renters and business owners, English
and Spanish]. Neutral wording, no leading or double-barreled
questions, 8th-grade reading level, under 5 minutes. Check each
question against those rules and say which decision it informs.

Full

<materials>
[paste the plan summary or the options residents will react to]
</materials>
 
<context>
Community: [community, e.g. 40% renters, a large Spanish-speaking
population, many older residents].
Format: [format: online | paper | at events | all three].
The results feed [decision, e.g. the council's choice between three
street designs in May].
</context>
 
<task>
Write a community survey whose results can inform that decision and
be reported back honestly.
</task>
 
<requirements>
- At most [length: 8 | 10 | 15] questions, about 5 minutes.
- Each question maps to a decision or to who answered (demographics
  last, optional, with a reason given).
- Neutral wording; no leading, loaded or double-barreled questions;
  balanced answer scales with a "don't know" option.
- Plain language at about an 8th-grade reading level; translation
  notes for [languages, e.g. Spanish and Vietnamese].
- Never invent numbers, names, quotes or sources: write
  [NEEDS SOURCE] where support is missing.
</requirements>
 
<quality_bar>
Before answering, check your draft against:
- No question assumes the answer the city wants.
- Every question's results would change something in the decision.
- Someone who didn't follow the project can answer every question.
</quality_bar>
 
<output_format>
The survey, numbered; then a table: question, decision it informs,
answer type; then how to report results back to respondents.
</output_format>
 
<process>
End with a list of the assumptions you made.
</process>

Before-and-after street image

Stage: produce · Use when: you need an illustration of a street change made from a real photo, for a meeting or a flyer. The quick version goes straight to an image generator in image-to-image or edit mode.

Quick

Same street, same buildings, same camera position and lens as the
reference photo. Change only: [change, e.g. four travel lanes to two
plus a center turn lane], [bike lane: none | painted | protected],
trees every 8 m in the parking lane, wider sidewalk with benches.
Late afternoon, people walking, photoreal, eye level, no text.

Full

<materials>
[paste or attach the street photo, and the cross-section table of
the proposed design]
</materials>
 
<context>
Street: [street, e.g. Main St at 4th, looking north]. The image is
for [use: a public meeting | a flyer | a grant | a council memo],
labeled as an illustration, not a design.
Generator: [generator, e.g. Adobe Firefly or a chat assistant's image
editor], from the photo.
</context>
 
<task>
Write an image-to-image prompt and an edit plan that turn this
photo into an honest illustration of the proposed cross-section.
</task>
 
<requirements>
- Keep the buildings, camera position, lens and light of the photo;
  change only what the cross-section changes, lane by lane, left to
  right.
- The widths in the image match the cross-section table; the number
  of lanes is stated explicitly.
- People, bikes and buses at realistic numbers for this street; no
  festival crowds.
- Put tool-specific parameters at the end, apart from the
  description.
- Never invent numbers, names, quotes or sources: write
  [NEEDS SOURCE] next to any tool parameter you're unsure exists.
</requirements>
 
<quality_bar>
Before answering, check your draft against:
- The prompt describes the scene, not reasons or requests.
- Nothing appears that isn't in the design (no extra plaza, no new
  buildings).
- The prompt keeps the existing signage and storefronts, so the
  place is recognizable.
</quality_bar>
 
<output_format>
The prompt; then an inpainting plan (which regions to mask, in what
order); then three things to check in the result.
</output_format>
 
<process>
End with a list of the assumptions you made.
</process>

Street network measures with code

Stage: produce · Use when: you want real numbers (intersection density, block length, walksheds) instead of guesses.

Quick

Write a Python script with OSMnx and GeoPandas that downloads the
walking network for [place, e.g. "Portland, Oregon, USA"], computes
intersection density per km² and average street segment length, and
maps the 10-minute walkshed (80 m a minute) from [start, e.g. an
address or coordinates]. Use only documented functions; say which version.

Full

<materials>
[paste a boundary polygon (GeoJSON) if the area isn't a named
place]
</materials>
 
<context>
Area: [area, e.g. "Eastside, Columbus, Ohio, USA" or the polygon].
Start point for walksheds: [start, e.g. Lincoln Elementary, or its
coordinates]. Skill: [skill: never used Python | some Python | comfortable].
</context>
 
<task>
Write a Python script that measures this area's walking network, so
I can compare it with other neighborhoods using real numbers.
</task>
 
<requirements>
- OSMnx and GeoPandas; say which OSMnx version you assume and use
  only functions in its documentation.
- Download the walking network; compute intersection count and
  density per km², average street segment length and a block-size
  measure; build walksheds at 5, 10 and 15 minutes (80 m a minute)
  along the network, not as circles.
- Save a GeoPackage of the results and a PNG map.
- Comment each step in one line so I can redo it in QGIS.
- Never invent numbers, names, quotes or sources: write
  [VERIFY] beside any function you're unsure exists in that
  version.
</requirements>
 
<quality_bar>
Before answering, check your draft against:
- Every function and argument exists in the stated OSMnx version.
- Distances are in meters in a projected coordinate system, not
  degrees.
- Walksheds follow streets, so barriers like highways show up.
</quality_bar>
 
<output_format>
The script in one block; then how to install and run it; then what
each output means.
</output_format>
 
<process>
Ask me up to 3 questions first if anything missing would change
your answer; otherwise go on. End with a list of the assumptions
you made.
</process>

Worked example

Weak prompt

How can I make my downtown better?

What's wrong

  • No place, size or data, so the model recites generic best practice (more trees, bike lanes, events).
  • No goals or metrics: "better" for whom, measured how?
  • No rules: the zoning, the street's owner and its classification decide what can change.
  • No audience or decision, so the answer has no shape and no next step.

Strong prompt

<materials>
Main Street, downtown: 4 travel lanes, 24 m building face to
building face, a state route, 15,000 vehicles a day, posted 35 mph.
3 pedestrian injuries in 5 years at 2 crossings (city crash data).
Ground-floor vacancy 40% (downtown association count). Zoning C-2:
FAR 1.5, 2 parking spaces per 1,000 sq ft. One bus route, every 30
minutes. The riverfront park is cut off by a 1.5-acre city-owned
parking lot.
</materials>
 
<context>
A US city of 60,000. I'm a resident on the downtown advisory
committee, not a planner. This goes to a city council work session;
council members know downtown but not planning terms.
</context>
 
<task>
Diagnose downtown's problems and propose three options for council
to choose from: a low-cost pilot, a street redesign, and rezoning
plus a street redesign.
</task>
 
<requirements>
- Diagnosis using Jacobs's four conditions for diversity and
  Whyte's findings on public space.
- Each option: a cross-section table that sums to 24 m, following
  complete streets principles and the NACTO Urban Street Design
  Guide; housing capacity with the arithmetic; rough cost (low,
  medium or high); timeline; what needs state DOT or traffic
  engineer approval.
- Goals: fill storefronts, add 300 homes downtown in 10 years, zero
  serious injuries, connect downtown to the river.
- Never invent numbers, names, quotes or sources: write
  [NEEDS SOURCE] where support is missing; zoning and street
  standards beyond what I gave: [CHECK LOCAL CODE].
</requirements>
 
<quality_bar>
Before answering, check your draft against:
- Every figure is from my data or marked [NEEDS SOURCE].
- Every cross-section sums to 24 m.
- Each option says who benefits and who bears the cost.
- Approvals and actors are named for each option.
</quality_bar>
 
<output_format>
Diagnosis (half a page); one section per option; an evaluation
matrix (options × the four goals, scored 1-5); data to collect next.
</output_format>
 
<process>
End with a list of the assumptions you made.
</process>

What came back

Illustrative, abridged:

DIAGNOSIS
Jacobs: one primary use (offices, 8 to 5), so the street empties
after 6 pm; short blocks and old buildings mixed with 1970s infill
help; too few residents for evening life.
Whyte: the park has no seating toward the street and no direct
route in; the parking lot is its edge.
 
OPTION A, pilot (low cost, 6 months): paint-and-post curb
extensions at the 2 injury crossings; parklets at 3 vacant
storefronts; a weekend market on the river lot.
 
OPTION B, road diet (medium cost, 2-3 years), meters:
sidewalk 3.0 | bike 1.8 | buffer 0.6 | parking 2.1 | lane 3.0 |
turn 3.0 | lane 3.0 | parking 2.1 | buffer 0.6 | bike 1.8 |
sidewalk 3.0 = 24.0
 
OPTION C, rezoning + B (higher cost, 5-10 years): a form-based code
for C-2 (build-to line at the sidewalk, 4-5 stories, active ground
floors, no parking minimums).
Housing capacity: 12 underused parcels averaging 2,000 m² =
24,000 m². At FAR 3.0: 72,000 m² of floor area; 60% residential =
43,200 m²; at 85 m² per home ≈ 508 homes; 40% redevelop in 10
years ≈ 203. The river lot (1.5 acres ≈ 6,070 m²) as a city-led
project at FAR 2.0 ≈ 12,100 m² ≈ 142 homes. Total ≈ 345: meets the
300-home goal.
 
MATRIX (1-5)    Storefronts  Homes  Safety  River
A pilot              2         1      3       3
B road diet          3         1      4       2
C rezoning + B       4         5      4       4
 
APPROVALS: Main Street is a state route, so lane changes need state
DOT approval and a traffic study [CHECK LOCAL CODE].
ASSUMPTIONS: 85 m² average home; 60% residential share; ...

How an expert judged it

  • Diagnosis: pass. It applies Jacobs and Whyte to the facts given (vacancy, the cut-off park) instead of reciting them.
  • Cross-section: pass. Option B sums to 24.0 m, keeps the parked cars as a buffer for the bike lanes, and sends the lane change to the state DOT.
  • Housing capacity: fail on the first <quality_bar> check. "12 underused parcels averaging 2,000 m²" appears nowhere in the materials and isn't marked [NEEDS SOURCE]; even the assumptions list names the 85 m² home size but not the parcels. The arithmetic is right, but the input is invented, and Option C's top score for homes, the "meets the goal" verdict and the matrix all rest on it.
  • What a planner would do: ask for the parcel list, or show capacity per 1,000 m² of redevelopable land so council can plug in the real figure.

The follow-up

The 12 parcels averaging 2,000 m² aren't in my data. Here is the
county assessor's parcel list for downtown: [paste parcel table:
ID, area, use, land value, building value]. Redo Option C's
capacity from this table only: treat a parcel as underused where
its building value is below its land value, show the arithmetic
per parcel, and give totals with and without the river lot. If the
total falls short of 300 homes, say what FAR or redevelopment rate
would reach it, then re-score the matrix.

Judge the output

These checks are the same ones written into every <quality_bar> on this sheet, adapted to each deliverable; use the table to judge what comes back.

CheckThe expert questionRed flag
Grounded in your datais every figure from your input or marked as an assumption?confident populations, traffic counts, parcel areas or code sections you never gave it
Arithmeticdo densities, capacities and cross-sections add up?a 24 m street with 27 m of elements
Right scaledoes the advice match the decision?regional transit fixes for a one-block problem
Rulesdoes it distinguish zoning, plan policy and street standards, and quote the text?"the code requires…" with no clause
Tradeoffsdoes each option say what it costs and who loses?options that are all upside
Equityare benefits, burdens and displacement risks broken down by group?equity mentioned only in a closing sentence
Implementationwho does what, with which money and approvals?a vision with no actors
Specific designdimensions, locations, phases?"add bike lanes and greenery"
Follow-up critique prompts
 
- "List every number you used and where it came from: my data,
  a stated assumption, or general knowledge."
- "Argue against your recommended scenario from a traffic
  engineer's view, then a renter's worried about rent, then a
  small-business owner's."
- "Which parts need state DOT, utility or environmental review
  approval, and roughly how long do those take?"
- "What would we measure in year 1, 3 and 5 to know it worked?"
- "Rewrite the plain-language summary at an 8th-grade reading
  level without changing what it promises."

Pitfalls

  • Generic urbanism. Without data the model recites best practice; give it the place.
  • Invented facts. Populations, counts, parcel areas and code sections appear from nowhere. Demand sources or [NEEDS SOURCE] labels.
  • Map images as evidence. Generated maps are illustrations; use GIS for anything measured.
  • One metric. Judging streets by vehicle delay alone (or any single measure) hides safety, access and cost.
  • Ignoring jurisdiction. State routes, utilities and school districts often control what the city can change.
  • Equity as an afterthought. Ask for distributional effects in every option, not a closing paragraph.
  • Engagement as broadcasting. Informing is not involving; say what the public can actually change.
  • Net vs gross confusion. Density figures mean little unless you know which.
  • Treating concepts as standards. The 15-minute city, superblocks and form-based codes are approaches to adapt, not rules to copy.
  • Reviewing in the same chat. The model defends its own numbers; run the review in a fresh chat.

References