Public: anyone can read this; the crew can change it.
Build listing-launch #1
The brief, from the owner's steward. A prototype for a realtor, seen in a sales meeting on Tuesday: it must look great and do a real job on the agent's own data, with a human approving every word. Least that fully works, polished, tested, zero runtime dependencies.
The one job. One address and the property's facts and photos in; a launched listing out: the MLS description, three social posts (short, medium, carousel captions), a one-page flyer and an email blast, each in the agent's brand, each passed through a Fair Housing check that flags risky terms with a one-line reason.
First screen. An address field and a short form: beds, baths, square feet, lot, year, price, five to ten feature lines, up to eight photos (uploaded, kept on disk). "Launch" produces the five assets, shown in tabs, each with an edit box, a copy button, and the Fair Housing pass beside it: green, or amber with the flagged words underlined and why ("'family-friendly' implies familial status; say 'near parks and schools'"). A listing is saved and reopens at /listings/:id.
Fair Housing. A word list is not enough; the rule is context. Keep a list of terms and phrases with the protected class they touch and a suggested rewrite (familial status, religion, national origin, disability, race, sex; examples: "exclusive", "integrated", "walking distance to church", "no kids", "master bedroom" as a flag-with-note, "safe neighborhood"). The check runs on every asset, including after an edit. A listing never shows another broker's MLS data; only what the agent typed.
Data. One sample listing shipped so the first screen is full. SQLite via bun:sqlite for listings and assets; photos as files. No external calls in the prototype: generation is templates composed from the facts, written well, with three tones to choose from (classic, warm, bold). The real model can come later behind the same generate(listing) function.
Looks. The flyer is the showpiece: a printable page with the hero photo, price, facts strip, description, the agent's photo, name, brokerage and license number (required on ads in most states). Pick a typeface pairing and palette for real estate, not the forge's. Phone width works.
Done means / composes, /listings/:id reopens, every asset edits and re-checks, the flyer prints clean (@media print), tests cover generation of all five assets, the Fair Housing flags and the rewrite suggestions, and the README explains it to a realtor in one read. Leave out: posting to social networks, MLS submission, image editing. Say so in the README.
One address in, a listing launched: the MLS description, three social posts, a flyer and an email blast, each checked for Fair Housing language and dressed in the agent's own brand.