SKILL28architecture-engineering
Documentação de Decisões de Arquitetura
Registra escolhas arquiteturalmente significativas em decisões concisas com contexto, drivers, alternativas, consequências e gatilhos de revisão.
Principal benefício
Preserva a justificativa de decisões caras para que mudanças futuras avaliem os trade-offs originais em vez de reabrir a discussão pela memória.Quando usar
Use quando uma decisão de software afeta materialmente estrutura, atributos de qualidade, dependências, interfaces, escolhas tecnológicas ou direção da equipe e sua justificativa precisa continuar revisável ao longo do tempo.
Quando não usar
Não use para detalhes rotineiros de implementação que são baratos de reverter e já ficam evidentes no código ou na documentação local.
Casos de uso
Registrar por que uma equipe escolheu um monólito modular em vez de microsserviços
Substituir uma decisão arquitetural aceita depois que novas evidências de escala ou confiabilidade alteram o trade-off
Prompts de exemplo
Use documenting-architecture-decisions para transformar esta discussão de arquitetura em um ADR focado, com contexto, drivers da decisão, alternativas realistas, consequências e gatilho de revisão.Instalar esta skill
Escolha o comando do seu sistema operacional e execute na raiz do repositório.
Bash
./install.sh --skill documenting-architecture-decisionsPowerShell
./install.ps1 --skill documenting-architecture-decisionsChatGPT
Baixar ZIP da skillCompatibilidade
- Ambientes
- ChatGPT · Codex · Claude Code
- Sistemas operacionais
- Linux · macOS · Windows
- Modos de instalação
- PluginSistema de arquivos
Dependências
Sem dependências externas
Parte de sistemas
Sistemas curados que incluem canonicamente este método.
Usado em evidências
Relatórios que listam explicitamente este método entre os métodos aplicados.