ADR—001 ACCEPTEDA choice. With receipts.Tradeoff: rebuild to publish
Design decisions that leave a paper trail
Record why a choice won, and when it should stop winning.
Open field noteTHE FIELD GUIDES
Guides.
Less magic prompting. More knowing what things are called. Explore examples, compare your options, and give AI a brief worth building.
12 field notes
UI↓ Use case↓ DomainPort ← Adapter
Architecture without acronym worship
Use SOLID and GRASP to reason about change, not to win acronym bingo.
Open field noteArray012Mapkey → ValueSetAB
Array, list, map, set: pick by operation
Order, lookup, and uniqueness are different jobs.
Open field noteHeader● ● ●
Name the layout you are pointing at
Header, sidebar, grid, dialog: give your feedback coordinates.
Open field noteOrder↙ ↘
StockPayment
OOAD: give each object a job
Model behavior and ownership before drawing a forest of classes.
Open field noteCheckout↓ verify
ServerPG / MoR
✓ Payment → Access
Payment channels, PG, and merchant of record
A payment button is the beginning of the paperwork.
Open field note100 × $5 / month$500gross ≠ profit
Subscription, one-time payment, or ads?
Match the bill to the value. The pricing page cannot rescue the product.
Open field noteBrowser ← URLMobile ← StorePC ← DownloadConsole ← Platform
Runtime, distribution, hosting: three questions
‘Deploy it’ is not a complete address.
Open field noteGIVEN → WHEN → THEN
Add the same book twice
✓ One row. Quantity: 2.
SRS: make ‘done’ mean something
Turn a wish into requirements someone can actually test.
Open field noteMarkdown↓ build
HTMLCSSJS
Astro, Hugo, Jekyll: three ways to ship HTML
Pick for authoring and maintenance, not a benchmark trophy.
Open field noteAaLight
AaDark
Themes and fonts without fifty shades of almost
Use shared tokens so one decision stays one decision.
Open field noteTypeScript languageAstro frameworkGodot engine
Language, library, framework, engine
Stop comparing tools that do different jobs.
Open field note