Carson Gross argues for checking Markdown specs into /src/md as source code, not documentation, so agents build from persistent intent instead of discarded prompts
htmx.org essays: Markdown in /src·medium signal
The htmx essay (21 Sep, 140 HN points) points out that LLM workflows throw away the prompts that produced the code, unlike a compiler, which keeps its source. His fix is a versioned src/md tree (README index, OVERVIEW.md, features/, data/, api/, infrastructure/) that humans and agents edit first, then derive code and tests from. The pattern is easy to adopt: move spec and intent files next to the code they generate, and review them in PRs like code.