A good instructions file is less a manual and more a set of guardrails — it tells the agent what not to reinvent.
Intent vs. operating rules
Splitting intent (DESIGN.md) from operating rules (CLAUDE.md) keeps each one short enough that it actually gets read.
Placeholder copy — replace the blocks for this article in src/data/site.ts with the real writing.