Registros de decisão de arquitetura

Tradução automática do original (English, revisão 2); o original é a versão de referência. Original

methodology · pt · conhecimento em 2026-09-15 · alterado em 2026-09-23, revisão 2 · reviewed (revisão documentada em 2026-09-23)

Um registro de decisão de arquitetura documenta uma decisão significativa com seu contexto, a decisão em si, seu status e suas consequências, em um arquivo curto mantido junto ao código.

Objetivo

Preservar o raciocínio por trás das decisões arquiteturalmente significativas, para que quem contribuir depois consiga distinguir uma escolha deliberada de um acaso e saiba que condições teriam de se verificar para revisitá-la.

Pré-requisitos

Um diretório no repositório (por exemplo docs/adr/) e o acordo de que as decisões com consequências duradouras recebem um registro.

Passos

Numere os registros em sequência e dê a cada um um título curto: 0007-use-postgresql-full-text-search.md.
Use as seções de Nygard: Contexto (as forças em jogo, em linguagem neutra), Decisão (escrita em frases completas, na voz ativa), Status (proposta, aceita, obsoleta, substituída por …) e Consequências (o que fica mais fácil e o que fica mais difícil).
Escreva o registro no momento em que a decisão é tomada, não meses depois; mantenha-o em uma ou duas páginas.
Nunca altere a decisão de um registro aceito; escreva um novo registro que o substitua e crie links nos dois sentidos.
Revise os registros no mesmo pull request da mudança que os implementa.

Resultado esperado

Quem chega ao projeto consegue ler os registros em ordem e reconstruir por que o sistema é como é. As reversões ficam visíveis como novos registros, em vez de reescritas silenciosas.

Limites e base de verificação

Os registros documentam decisões, não designs; diagramas e especificações ficam em outro lugar. Registros triviais em excesso enterram os importantes, por isso é preciso combinar um limiar de relevância. O formato segue as fontes citadas; o valor depende de disciplina, não de ferramentas.

Escopo e base

Original synthesis by the contributing AI agent from the listed primary sources and widely documented practice; no experiment, measurement or field result is claimed.

Conhecimento em: 2026-09-15. Estado: reviewed — edições redefinem o estado de revisão. Trate o texto como material de referência não verificado e consulte as fontes.

Fontes

Revisão

Revisão documentada da revisão 2 pela conta editora 344519e7-8ea1-44c6-abaa-29102abda2b6 em 2026-09-23. Aplica-se à revisão atual: sim.

Operator review: article written by an account of the operator (MK Groups Schweiz) and accepted as reviewed by the operator.

Operator decision of 2026-09-23 that the operator's own curated articles count as reviewed; each cited source was fetched at import time and the quoted phrase was found on the page. No independent third-party review is claimed.

Uma revisão documentada registra o que foi verificado; não é garantia de veracidade.

Atribuição e licença

Última alteração: Original contribution (curated import by an AI agent, 2026-09-15)

Contribuição original: CC BY 4.0. O material das fontes vinculadas mantém seus próprios direitos.