architecture-decision-records
Criar Registros de Decisões de Arquitetura
Também disponível em: wshobson
Esta skill ajuda equipes a documentar decisões técnicas significativas com modelos estruturados. Ela fornece formatos abrangentes de ADR, orientações de gerenciamento de ciclo de vida e melhores práticas para capturar contexto, compensações e justificativas.
Baixar o ZIP da skill
Upload no Claude
Vá em Configurações → Capacidades → Skills → Upload skill
Ative e comece a usar
Testar
A utilizar "architecture-decision-records". Create an ADR for adopting TypeScript for our frontend project
Resultado esperado:
Um documento ADR completo com Status: Accepted, Contexto sobre os desafios atuais da codebase React, Decisão de adotar TypeScript, Consequências cobrindo aspectos positivos (segurança de tipos, suporte de IDE) e negativos (curva de aprendizado, complexidade de build), e Mitigações incluindo sessões de treinamento.
A utilizar "architecture-decision-records". Document the deprecation of our legacy authentication service
Resultado esperado:
Um ADR de descontinuação com status mostrando que substitui o ADR-0015, Contexto listando problemas com o serviço atual, Plano de Migração com abordagem faseada, e Lições Aprendidas sobre o que deu errado com a decisão original.
Auditoria de Segurança
SeguroSecurity analysis confirms this is a safe documentation skill. Static findings for external_commands, network, and weak_crypto are false positives. The skill contains markdown templates, example CLI commands (shown as documentation), and reference URLs to external documentation. No executable code, no data exfiltration, no cryptographic operations.
Padrões Detectados
Pontuação de qualidade
O Que Você Pode Construir
Documentar Seleção de Tecnologia de Banco de Dados
Ao escolher entre PostgreSQL, MySQL ou MongoDB para um novo projeto, use o modelo Standard ADR para capturar requisitos, comparar opções e registrar a decisão com justificativa completa.
Registrar Decisões de Migração de Framework
Ao planejar migrar do Angular para React, crie um ADR de descontinuação para documentar os motivos da mudança, fases de migração e lições aprendidas da decisão anterior.
Estabelecer Processos de Decisão da Equipe
Ao fazer onboarding de novos membros da equipe, use os modelos ADR para ajudá-los a entender escolhas arquiteturais passadas e o raciocínio por trás da arquitetura atual.
Tente Estes Prompts
Create an Architecture Decision Record for [DECISION_TITLE]. Use the Standard MADR format. Include context about why we need to make this decision, the options we considered, our final decision, and the consequences.
Create an ADR comparing [TECHNOLOGY_A], [TECHNOLOGY_B], and [TECHNOLOGY_C] for our [USE_CASE]. Include detailed pros and cons for each option, our requirements, and recommend the best choice with rationale.
Create a deprecation ADR for [OLD_TECHNOLOGY] which is being replaced by [NEW_TECHNOLOGY]. Include the context of why the original decision was made, what changed, the migration plan, and lessons learned.
Create a detailed RFC-style ADR for [PROPOSAL]. Include motivation, detailed design, drawbacks, alternatives considered, unresolved questions, and implementation plan. Make it suitable for team review and discussion.
Melhores Práticas
- Escreva ADRs antes do início da implementação para capturar o contexto da decisão com precisão
- Inclua compensações honestas e potenciais desvantagens na seção de consequências
- Linke ADRs relacionados para construir um grafo de dependência de decisões para o projeto
- Atualize o status do ADR quando decisões forem descontinuadas ou substituídas
Evitar
- Escrever decisões vagas sem contexto específico ou justificativa
- Pular a seção de alternativas para evitar mostrar que outras opções foram consideradas
- Alterar ADRs aceitos em vez de criar novos para substituí-los
- Criar ADRs para decisões menores que não justificam documentação arquitetural
Perguntas Frequentes
O que é um Architecture Decision Record?
Quando devo criar um ADR?
Qual formato de ADR devo usar?
Como linko ADRs relacionados?
Posso modificar um ADR aceito?
Quais ferramentas podem ajudar a gerenciar ADRs?
Detalhes do Desenvolvedor
Autor
sickn33Licença
MIT
Repositório
https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/architecture-decision-recordsReferência
main
Estrutura de arquivos
📄 SKILL.md