Blog
Product notes that stay close to the contract.
Canonical Markdown posts are validated at build time and rendered as static pages, so the site stays easy to write and cheap to serve.
Field note2026-05-23
Why README-Driven Infrastructure Breaks for AI Agents
A README is supposed to be the front door of a software project. It tells people what the repo does,...
Field note2026-05-18
Repo Readiness for AI Agents: The Complete Guide
Software repositories were already difficult to onboard into before AI agents entered the...
Field note2026-05-16
Why Working Repos Still Fail New Contributors
Maintaining a software project is not only about keeping the code working. It is also about keeping...
Field note2026-05-11
The Conditions That Make a Repo Work
The hardest part of onboarding into a repo usually is not understanding the code. It is discovering the hidden setup, execution, and readiness conditions that made the repo work in the first place.
Field note2026-05-09
How Do You Know A Repo Is Actually “Ready”?
Why does getting a repo running still feel so fragile? You clone a project, follow the setup steps,...