Earlier quoted context omitted.
I use Claude model=fable effort=high to write most of my initial plans, especially the hard things like re-architecture. I recommend putting time into figuring out the "soft infrastructure" of your projects, usually things you've never been arsed to do in your life (like me until this year). Start with a docs/*.md folder that you link to from AGENTS.md where you can document things that would be important for you, an…
Great advice and PoV. One nit: I recommend against the filename "DESIGN.md" for architectural invariants, in light of the emerging use of that filename for UI / design system / CSS tokens (colors, fonts, typography, etc). See https://designmd.ai/ for examples.
The point, of course, is that you need some way to document decisions and pivots and eurekas (including rejected ones) over the lifetime of the project. It's a key part of invariant discovery and then committing to them.