# ADR-[NNN] — [Decision title] > Template from Jorel del Portal's method (joreldelportal.com/metodo-en.html). > One ADR per decision that shapes the architecture. Short, honest, dated. - **Date:** [YYYY-MM-DD] - **Status:** Proposed | Accepted | Superseded by ADR-[NNN] ## Context [What problem or force requires a decision. Real constraints: deadline, team, platform, cost.] ## Decision [What was decided, in one or two affirmative sentences.] ## Alternatives considered - **[Alternative A]:** [why it was discarded] - **[Alternative B]:** [why it was discarded] ## Accepted trade-off [What you lose in exchange for what you gain. If there is no trade-off, the decision isn't understood.] ## Consequences - [What becomes easier] - [What becomes harder or is now forbidden] - [What should be revisited if the context changes]