Spec, schema and decisions for a service with a database and a background worker.

HTTP surface first — contracts, errors, and the reasons behind each one.

For a docs folder that already exists and needs a shape imposed on it.

Many packages, one intent — a shape that survives four workspaces.

Experiments, results, and what was concluded from them.

Privacy-first analytics — ingest path, queue, and the decisions behind both.

On-call, incidents, and what was learned from each one.