/references/

Notes on “Strategies and Tactics for working with Coding Agents”

Raindrop annotations

Annotations made with Raindrop.io.

Information Architecture should be handwritten
Strategies and Tactics for working with Coding Agents
The reason I say these should be handwritten is not because AI is incapable of thinking about these things. It can, in fact, contribute to the development of the IA, and if you can answer the above questions in plain English, AI can even translate this into the appropriate database models/APIs/etc.. But in the end, you must have answered the above questions, because the IA is the nucleus of the software, the DNA from which the rest of the app derives.
Strategies and Tactics for working with Coding Agents
In practice, “handwriting an IA” to me, means sitting down and writing the Pydantic/SQLAlchemy models by hand. It usually takes just 10-50 lines of code, and this is precisely the 2% of my codebase that is handwritten.

If you do not design your IA, AI will intentionlessly design it for you.
Strategies and Tactics for working with Coding Agents