AGENTS.md is the new README
The README was written for a human who would skim it once. This file is read in full, every run.
Notes
Thinking out loud. Unfinished, exploratory, often wrong.
Building in public without a megaphone
Wondering whether it is possible to build something of your own quietly, and whether that defeats the point.
The context window is a budget, not a container
Half-formed thought on why "just paste more" stops working past a certain repo size.
I stopped drawing sequence diagrams first
Trying to articulate why starting with the failure modes produces a better design than starting with the happy path.
Kafka consumers I have regretted
A catalogue of my own mistakes, kept partly as penance and partly as a checklist.
p99 is a team boundary, not a metric
Whoever owns the p99 owns the on-call pager. Everything else follows from that.
The cost of a half-finished abstraction
Unfinished abstractions are worse than none, and agents make them cheaper to create and harder to spot.
What I want from an agent harness
A running wishlist. Mostly about observability and being able to stop the thing mid-flight.