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
| Scale | Typical size | Questions | Typical documents |
|---|---|---|---|
| Region / metro | tens to hundreds of km | housing markets, transit networks, watersheds, growth limits | regional plan; US metropolitan transportation plan |
| City | the municipality | long-range vision, land-use pattern, capital spending | comprehensive or general plan, zoning code, capital improvement program |
| District | downtown, campus, corridor, port | character, mix of uses, major public spaces | area, specific or master plan |
| Neighborhood | ≈ a 10–20 minute walk across | daily needs, schools, parks, local streets | neighborhood plan |
| Street / corridor | one right-of-way | how space is divided between walking, cycling, transit, cars, trees | corridor study, street design |
| Block | ≈ 60–250 m on a side | block size, through-routes, building frontages | subdivision plat, urban design guidelines |
| Lot / parcel | one property | setbacks, height, floor area, uses | site plan, zoning permit |
Vocabulary
| Term | What it means | Say it like |
|---|---|---|
| Comprehensive (general) plan | a city's long-range policy document for land use, transportation, housing and more | "Summarize the land-use goals in this comprehensive plan" |
| Zoning | the law that sets what can be built where: uses, height, bulk, parking | "Explain what this zoning district allows" |
| Euclidean zoning | zoning 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 code | regulation 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" |
| Transect | a 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 district | an extra layer of rules on top of base zoning (historic, flood, transit) | "List the overlays affecting this parcel" |
| By-right | allowed without discretionary approval if the rules are met | "Which of these housing types are by-right here?" |
| Variance / conditional use | permission 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 coverage | share of the lot covered by buildings | "Lot coverage limit 50%" |
| Setback / build-to line | minimum distance from the lot line / a required line the facade must sit on | "Replace front setbacks with a build-to line at 2 m" |
| Density | homes 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 density | net counts only residential parcels; gross includes streets, parks and other land | "State whether each density figure is net or gross" |
| Mixed use | different uses together: shops below homes (vertical) or side by side (horizontal) | "Ground-floor retail with three floors of homes above" |
| Missing middle housing | house-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 / brownfield | building on vacant or underused urban lots / on undeveloped land / on previously used, possibly contaminated land | "Rank infill sites by readiness" |
| Upzoning | changing 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 hierarchy | functional classes: arterials (through movement), collectors, local streets (access) | "Classify these streets and say what each should prioritize" |
| Complete streets | streets designed for safe use by all users and modes | "Redesign as a complete street" |
| Road diet | removing 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" |
| VMT | vehicle miles (or km) traveled: total driving generated | "Estimate how this plan shifts VMT per resident" |
| Induced demand | added 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" |
| Walkshed | the area reachable on foot in a given time along real streets | "Map the 10-minute walkshed from the school" |
| Connectivity / permeability | how many route choices a network offers; intersection density is a common measure | "Compare intersection density before and after" |
| 15-minute city | Carlos 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 realm | streets, squares, parks and other spaces everyone can use | "Audit the public realm along this corridor" |
| Active frontage | building edges with doors, windows and uses facing the street | "Require active frontage on 70% of the ground floor" |
| Placemaking | shaping public spaces around how people actually use them, often with residents | "Plan a placemaking pilot for this plaza" |
| Tactical urbanism | quick, cheap, temporary changes (paint, planters) to test an idea | "Design a tactical pilot to test the plaza for three months" |
| Green infrastructure | vegetation and soil that manage stormwater: bioswales, rain gardens, green roofs, street trees | "Add green infrastructure to handle the first 25 mm of rain" |
| Impervious surface | roofs and paving that shed water instead of absorbing it | "Estimate impervious cover before and after" |
| Urban heat island | built-up areas staying hotter than surroundings, especially at night | "Rank heat-island fixes for this district" |
| Floodplain | land 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?" |
| Displacement | residents or businesses forced out directly (eviction, demolition) or by rising costs | "Assess displacement risk and anti-displacement measures" |
| Inclusionary zoning | requiring or incentivizing affordable units in new development | "Compare mandatory and voluntary inclusionary options" |
| Desire line | an informal path worn by people taking the route they want | "Use desire lines to place crossings" |
| Vision Zero | road-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) zoning | Form-based code | |
|---|---|---|
| Main control | which uses are allowed in each district | the physical form: frontage, height, placement, street relationship |
| Typical tools | use tables, minimum lot sizes, setbacks, FAR, parking minimums | regulating plan, building form standards, frontage types, public-space standards |
| Strength | familiar, simple to administer, separates noxious uses | predictable streetscape, easier mixed use |
| Critique | separates daily needs, forces driving, can exclude housing types | can be prescriptive; still needs good use rules |
FAR fixes the total floor area, not the shape; setbacks and coverage limits decide the shape:
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
| Topic | What to know | Ask the model to |
|---|---|---|
| Street hierarchy | arterials move through traffic, collectors gather it, local streets give access; the right design differs for each | classify streets from a map you describe and propose design priorities per class |
| Right-of-way allocation | a fixed width (say 24 m) split among sidewalks, trees, bike lanes, parking, transit and travel lanes | produce cross-section options that add up exactly to the width, as a table, left to right |
| Complete streets and road diets | safer design for all users; the classic road diet turns four undivided lanes into two travel lanes, a center turn lane and bike lanes | list the conditions under which a road diet works and what to measure before and after |
| Transit | frequency matters as much as coverage; TOD is usually planned within ≈ 400–800 m (a 5–10 minute walk) of stations | compare station-area options and their walksheds |
| Walkability | short blocks, connected streets, continuous sidewalks, safe crossings, destinations nearby | audit a route or neighborhood from photos and a map |
| LOS vs VMT | LOS 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 2020 | show both metrics for each option and say which the jurisdiction uses |
| Induced demand | studies such as Duranton and Turner (2011) found driving in US metros rose roughly in proportion to added interstate highway lane-kilometers | account for it when comparing widening with alternatives |
| Parking | minimum 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 |
| Safety | speed is the main driver of injury severity; Vision Zero designs for human error | identify 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:
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.
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.
Housing
| Type | What it is | Where it fits |
|---|---|---|
| Detached house | one home on its own lot | low-density areas; the default in many codes |
| ADU | a small second home on a house lot | almost any house lot, if allowed |
| Duplex, triplex, fourplex | two to four homes in a house-sized building | missing middle; transitions between houses and main streets |
| Townhouse / rowhouse | attached homes, each with its own entry | neighborhood edges, near transit |
| Cottage (bungalow) court | small houses around a shared garden | mid-block, larger lots |
| Courtyard apartment | apartments around a courtyard, house-scale | corners, main streets |
| Mid-rise | roughly 4–8 stories; in the US often wood frame over a concrete podium | corridors, TOD |
| High-rise | elevator buildings, typically above ≈ 8–12 stories | centers, 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
| System | Key ideas | Planning questions |
|---|---|---|
| Water supply | treatment, pipes, pressure zones, fire flow | is there capacity for the growth this plan allows? |
| Sanitary sewer | wastewater to treatment; older cities often have combined sewers that overflow in storms (CSOs) | where are the capacity limits and overflow points? |
| Stormwater | impervious cover raises runoff; detention stores and releases slowly, retention holds or infiltrates | how much new impervious surface; where does the water go? |
| Green infrastructure | bioswales, rain gardens, permeable paving, green roofs, street trees | which streets and lots can host it? |
| Heat | dark surfaces and little shade make urban heat islands | where are the hottest blocks, and who lives there? Trees, shade, cool roofs and pavements first |
| Flooding | FEMA flood maps in the US; sea-level rise; river and surface-water flooding | which parcels and critical facilities are exposed; protect, adapt or retreat? |
| Energy, broadband, waste | networks and facilities with long lead times | coordinated 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
Existing conditions
Land use, zoning, demographics, housing, transport, environment, infrastructure, history; gather data and listen.Vision and goals
What the community wants, as measurable objectives.Alternatives
Two to four scenarios, deliberately different.Evaluation
Compare scenarios against goals: housing, travel, cost, environment, equity.Preferred plan and adoption
Public hearings before the planning commission and elected body; environmental review where required.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
| Who | Work | Core idea | Use it in a prompt |
|---|---|---|---|
| Jane Jacobs | The 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 Lynch | The 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 Gehl | Life 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. Whyte | The 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 Howard | Garden Cities of To-morrow (1902) | planned towns of limited size surrounded by greenbelts | historical context for new towns and greenbelts |
| Donald Shoup | The High Cost of Free Parking (2005) | parking minimums and free curbs carry hidden costs | "Estimate what parking minimums cost per home here" |
| NACTO | Urban Street Design Guide (2013) and related guides | city-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.
| Need | Tool | Prompting tip |
|---|---|---|
| Accurate maps and measures | QGIS with OpenStreetMap data; Python with GeoPandas and OSMnx | ask a chat model for QGIS steps or a script, run it yourself, check the numbers |
| Street sections | Streetmix or a table | ask for a left-to-right cross-section table whose widths sum to the right-of-way |
| Before/after street views | image 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 diagrams | image generator or vector tool | "axonometric diagram, flat colors, no text, land use colored: residential yellow, commercial red, civic blue, parks green" (US convention) |
| Concept plans | sketch, then image-to-image | keep 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.
| Input | Why it matters | Example | Slot |
|---|---|---|---|
| Place and jurisdiction | rules and data are local | "Downtown of a 60,000-person city in Oregon" | <context> |
| Scale and boundary | sets the analysis | "The 1.2 km corridor between the river and the rail station" | <context> |
| Existing conditions data | the model can't see the site | land use, zoning, population, traffic counts, crash data, transit frequency, parcel sizes (paste tables) | <materials> |
| Rules in force | the legal starting point | "Zoning text for C-2 and R-1 attached; comprehensive plan policies on housing" | <materials> |
| Goals and metrics | lets options be compared | "Add 1,500 homes; cut traffic injuries; no net loss of tree canopy" | <requirements> |
| Constraints | what can't change | "Right-of-way 24 m; state highway; floodplain on the east side; budget" | <requirements> |
| Stakeholders | engagement and equity | residents, renters, businesses, schools, transit agency, the state DOT | <context> |
| Decision and audience | sets tone and depth | "A memo for the planning commission" or "a one-page flyer for neighbors" | <context>, and the decision in <task> |
| Output format | makes it checkable | tables, scenario matrix, maps described for GIS | <output_format> |
| Your role | what the model should explain | "Resident and advocate, not a planner" | <context> |
What to ask for
| Stage | Deliverables to ask for by name |
|---|---|
| Existing conditions | existing conditions report outline; data request list with sources; SWOT; Lynch-style legibility map description; walkability audit checklist |
| Visioning | goals and objectives with indicators; engagement plan; survey questions; workshop agenda |
| Alternatives | 2–4 scenarios with land use, density, street network and transit described consistently |
| Evaluation | scenario evaluation matrix; housing capacity estimate; trip-generation and VMT reasoning (flagged as rough); fiscal and equity impact questions; displacement risk assessment |
| Plan and adoption | plan chapter outline; policy and action table (who, when, cost range); plain-language summary; FAQ for a public meeting; staff-report outline |
| Implementation | zoning amendment checklist; capital project list; monitoring indicators; pilot (tactical) project plan |
| Streets | cross-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.
| Task | Completion 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.
| Check | The expert question | Red flag |
|---|---|---|
| Grounded in your data | is every figure from your input or marked as an assumption? | confident populations, traffic counts, parcel areas or code sections you never gave it |
| Arithmetic | do densities, capacities and cross-sections add up? | a 24 m street with 27 m of elements |
| Right scale | does the advice match the decision? | regional transit fixes for a one-block problem |
| Rules | does it distinguish zoning, plan policy and street standards, and quote the text? | "the code requires…" with no clause |
| Tradeoffs | does each option say what it costs and who loses? | options that are all upside |
| Equity | are benefits, burdens and displacement risks broken down by group? | equity mentioned only in a closing sentence |
| Implementation | who does what, with which money and approvals? | a vision with no actors |
| Specific design | dimensions, 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
- NACTO Urban Street Design Guide (opens in a new tab): design guidance for city streets, endorsed by the US DOT
- Global Street Design Guide (opens in a new tab): international street design guidance from the Global Designing Cities Initiative
- American Planning Association (opens in a new tab): planning practice, guides and the LBCS land-use classification
- Form-Based Codes Institute (opens in a new tab): what form-based codes are and how they work
- Missing Middle Housing (opens in a new tab): Opticos Design's definitions and types
- Smart Growth America: Complete Streets (opens in a new tab): definition and policy elements
- ITDP TOD Standard (opens in a new tab): principles and scoring for transit-oriented development
- California SB 743 (opens in a new tab): the state's shift in transportation impact analysis
- CEQ: National Environmental Policy Act (opens in a new tab): US federal environmental review
- EU Environmental Impact Assessment (opens in a new tab): the EIA directive
- FEMA Flood Map Service Center (opens in a new tab): official US flood hazard maps
- EPA: Heat islands (opens in a new tab) and EPA: Green infrastructure (opens in a new tab): causes, effects and mitigation
- Arnstein, A Ladder of Citizen Participation (opens in a new tab): the 1969 article
- The Image of the City (opens in a new tab): summary of Kevin Lynch's five elements
- The Death and Life of Great American Cities (opens in a new tab): Jane Jacobs's book
- Gehl (opens in a new tab): Jan Gehl's practice, public life studies
- C40 Knowledge Hub: 15-minute city (opens in a new tab): the concept and city examples
- QGIS (opens in a new tab), OSMnx (opens in a new tab), OpenStreetMap (opens in a new tab) and Streetmix (opens in a new tab): mapping, network analysis and street-section tools