Clean Code And Clean Architecture

Clean code makes intent, behavior, boundaries, and failure modes easy for the next maintainer to understand and safely change. Clean architecture keeps the cost of a change proportional to its scope instead of its shape.

Written for AI coding agents of any vendor, language-agnostic: adapt every rule to the project's language, framework, runtime, and style. Three agent-specific truths shape everything below:

1. You read faster than humans but forget context between sessions. Structure, names, placement, and written-down decisions are how your work survives you.
2. Your most common failures are not syntax errors. They are code in the wrong place, duplicated knowledge, mixed responsibilities, invented APIs, and unverified claims of success.
3. Your instinct is to wire the shortest path between two points — which is how a controller ends up calling a repository directly, skipping the only authorization check in the system.

When To Use