Architecture Decision Records (ADR)
Code tells you how a system works. ADRs tell you why it works that way, preventing future maintainers (and AI agents) from suggesting "improvements" that were already tried and discarded.
ADR Protocol
When finalizing a major design decision (e.g., "Choosing Postgres over MongoDB", "Using custom event bus over Redis"):
- Create
docs/adr/YYYY-MM-DD-<short-title>.md. - Include the Context (what is the problem?).
- Include the Decision (wh
[Description truncada. Veja o README completo no GitHub.]