Sample article

I write a nine-file .docs/ folder before I write any code.

AI engineering · Practice

Placeholder. Replace before this site goes live — see .docs/decisions.md, D-014.

Coding agents lose context between sessions. The usual answer is a longer prompt. A better answer is a small, structured set of files that live in the repository and are read at the start of every session.

What this piece will cover

  • The nine files, and the job each one does
  • Why decisions belong in an append-only log with statuses
  • How a working agreement at the top of the task list changes agent behaviour
  • The failure modes it does not solve

← All writing