ADR para decisão arquitetural
Documente contexto, alternativas, decisão, consequências e reversibilidade.
Reputação
Avalie a utilidade deste prompt
O ranking combina reações positivas, visualizações únicas e volume mínimo de avaliações para evitar que um prompt suba só por tráfego.
Quando usar
Registrar decisões técnicas sem texto genérico.
Guia de uso profissional
Este prompt foi pensado para profissionais de desenvolvedor que precisam executar escrita e comunicação no contexto de tecnologia. Ele transforma a tarefa "ADR para decisão arquitetural" em um roteiro de trabalho com contexto, restrições e formato de saída definidos.
Registrar decisões técnicas sem texto genérico. Para evitar respostas superficiais, a estrutura força a IA a explicar premissas, organizar prioridades e entregar algo que possa ser revisado por uma pessoa antes do uso final.
A versão principal foi escrita para Claude em nível avançado. É uma boa escolha para materiais longos, revisão cuidadosa e respostas que precisam separar evidência, risco e recomendação. O nível avançado exige mais contexto e costuma gerar uma saída melhor quando você inclui restrições, exemplos e critérios de decisão.
Antes de enviar para a IA
- Inclua linguagem, framework, trecho de código, erro observado, versão das bibliotecas e restrições de arquitetura.
- Informe quem vai ler, qual decisão precisa tomar e qual tom deve ser evitado.
- Cole referências de estilo, mensagens antigas e termos obrigatórios.
- Peça versões com objetivos diferentes: clareza, concisão, autoridade ou conversão.
Como avaliar a resposta
- O texto tem promessa específica, ordem lógica e chamada para ação compatível com o contexto.
- A linguagem é direta e não esconde pontos importantes em frases vagas.
- A saída elimina exageros, jargões vazios e claims sem prova.
Erros comuns ao usar
- Aceitar uma versão bonita que não responde à dúvida do leitor.
- Usar a mesma copy para públicos e canais diferentes.
- Remover detalhes operacionais que davam credibilidade ao texto.
Ajustes recomendados
- No Claude, organize entradas longas com seções nomeadas e peça que ele cite quais partes do contexto sustentam cada conclusão.
- Confira se a resposta tratou riscos, exceções e alternativas antes de transformar a sugestão em plano de trabalho.
- Troque exemplos genéricos por dados do seu caso real e mantenha nomes, números e limitações em campos separados.
Prompt-base
Atue como especialista em Desenvolvedor no setor de Tecnologia. Sua função é ajudar em "ADR para decisão arquitetural".
Contexto:
{{descreva_o_contexto}}
Dados disponíveis:
{{cole_os_dados_ou_texto_aqui}}
Objetivo:
Registrar decisões técnicas sem texto genérico.
Regras:
- Não invente dados, leis, métricas, documentos ou resultados.
- Quando faltar informação, marque como [PENDENTE].
- Priorize recomendações aplicáveis ao trabalho real.
- Separe diagnóstico, execução sugerida, riscos e próximos passos.
- Use linguagem objetiva em português do Brasil.
Entregue:
1. Resumo do problema.
2. Pontos críticos.
3. Sugestão estruturada.
4. Checklist de validação.
5. Próxima ação recomendada.Exemplo de entrada
Contexto de Desenvolvedor para adr para decisão arquitetural, com dados reais colados pelo usuário e restrições do projeto.
Exemplo de saída esperada
Saída esperada: análise estruturada para escrita e comunicação, com pendências explícitas, riscos priorizados e próximos passos práticos.
Tags
Cuidados e limites
Não cole secrets, tokens, chaves privadas, dados de clientes ou logs com informação sensível. Revise qualquer sugestão antes de aplicar em produção.