Code isn't enough context anymore
As coding agents improve, repositories need to communicate architectural context, constraints and intent in addition to source code.
Code explains implementation details, but agents now act on partial understanding of broader system intent.
Repositories increasingly need explicit constraints, architecture boundaries and decision context that humans once shared informally.
The practical challenge is to make this context concise, maintainable and machine-usable without turning every project into process overhead.
architecture
documentation
AI-native development