The craftsman's notes

Your architecture decisions vanish. ADRs fix that.

A decision made without a written trace is a context debt. Architecture Decision Records are the most useful document nobody writes until it costs you.

ADRs in practice: 3 templates, one Symfony project, one Git workflow

Which template to use? Where do the files go? How do you integrate them into PRs? A complete setup guide for a real Symfony project, with 3 formats compared on the same use case.

Your ADRs mean nothing if the code ignores them fitness functions and CI/CD

20 ADRs in /adr, and the code has drifted. ADR-0005 banned coupling between Billing and Catalog there are now 7 cross-imports. Here is how to make the machine enforce your decisions.