Engineering notes

What it means to build software in the AI era.

Notes on the shift — and the decisions behind Doric — written in plain language, for the people who care how the machine works.

✦ New — we open-sourced four tools from our own stack →  ·  Twenty things Doric does →

Point of view

Product is the bottleneck now

When code is cheap and a whole R&D operation fits behind one person, the scarce thing isn't engineering — it's deciding what to build. Decision-making is suddenly unbound.

7 min read · the AI era
Open source · new

We pulled four tools out of Doric's own stack

Each one was a real, recurring failure we had to fix to run an AI product on a flash-tier model — so we open-sourced the fix. The line family: keep the plot, prove it's wired, ship what changed, and measure the whole thing. Zero dependencies, MIT (benchmark CC-BY).

All four on GitHub →

More engineering notes

Architecture

A validator with standing to veto

Why rebuild a chat engine when Claude and Gemini ship brilliant ones? Because self-grading doesn't work — and separation of powers is structural, not something a prompt hands you.

8 min · architecture
Agent behavior

Expansive in the thinking lane, disciplined in the commit lane

Brainstorms should pull the internet and propose structure. Edits should touch one slide and nothing else. Most tools run both through one dial — we built two lanes.

6 min · agent design
Interaction design

Threads are carved, not entered

The doc is the conclusion, stripped of the path. The card is the path — dead ends included. Provenance is why the conclusion deserves your trust.

7 min · interaction design
Point of view

Sledgehammers and nuts

Spec-driven tools now turn a small bug into 4 user stories and 16 acceptance criteria. The unsolved gap in the category is triage — and it's where Doric aims to be better, not equal.

7 min · spec-driven development
Dependability

A payment button shouldn't drop your database

You add one button to a tool that worked — and the AI rewrites your schema and takes it all down. Why that happens, and the four things that make it a non-event in Doric.

9 min · dependability
Positioning

The day after the demo

Every AI builder is brilliant for 47 minutes. The real problem starts the next morning — and the whole industry has a name for it but no product.

9 min · positioning
Architecture

Why our agents run on real git branches

Parallel AI work corrupts state quietly. We fixed it the boring way: branches, a merge queue, and three-way merges that escalate instead of clobber.

11 min · parallel R&D
Architecture

The map never lies: coherence as a projection

How we made "done" something the system computes from evidence — instead of something an agent can claim. No more phantom verification.

10 min · coherence gate
Ownership

It's still yours in five years

The data seam that lets you preview on our cloud and deploy to your own Supabase — and why platform abandonment made this non-negotiable.

8 min · the data gateway