Criador de ADR
Crie Registros de Decisão de Arquitetura (ADRs) concisos que explicam uma decisão, o contexto que a exigiu, as opções consideradas e as consequências aceitas.
Contrato de Ativação
Use esta skill quando o usuário solicitar um ADR, registro de decisão de arquitetura, registro de decisão técnica ou qualquer registro formal do motivo pelo qual uma escolha técnica ou arquitetural foi feita.
Por padrão, entre no modo de entrevista, a menos que o usuário já tenha fornecido informações suficientes para redigir um ADR completo. Faça perguntas da entrevista no idioma do usuário. O artefato do ADR deve estar em inglês, a menos que o usuário solicite explicitamente outro idioma.
Regras Rígidas
- Faça uma pergunta por vez no modo de entrevista.
- Informe uma vez no início da entrevista que o usuário pode pular perguntas ou interromper a entrevista a qualquer momento.
- Mantenha um contador dinâmico de perguntas restantes estimadas; atualize-o quando dependências aparecerem ou desaparecerem.
- Recomende exemplos de respostas curtos quando eles ajudarem o usuário a responder.
- Formate as perguntas da entrevista como Markdown legível, não como texto simples.
- Desafie construtivamente respostas vagas, contraditórias ou sem justificativa antes de redigir; prossiga se o usuário disser explicitamente para continuar mesmo assim.
- Não invente alternativas, prós, contras ou justificativas. Pergunte quando alternativas estiverem faltando.
- Use "Aceito" quando a decisão já tiver sido tomada; use "Proposto" para propostas, avaliações ou status indefinido.
- Escreva ou modifique arquivos somente quando o usuário solicitar explicitamente um arquivo/caminho.
Fluxo da Entrevista
Colete apenas o que for necessário, priorizando dependências:
- Título e status da decisão.
- Contexto: problema, restrições, forças e por que a decisão é importante agora.
- Opção ou proposta escolhida.
- Opções consideradas, com prós e contras para cada uma.
- Consequências: benefícios, desvantagens, riscos e compensações.
- Acompanhamento apenas quando houver ações em aberto ou perguntas não resolvidas úteis.
Formato da pergunta:
### Pergunta N — [pergunta focada]
**Resposta recomendada:** [exemplo curto quando útil]
**Por que isso é importante:** [motivo breve]
**Perguntas restantes estimadas:** ~M
Mini exemplo:
### Pergunta 1 — Esta decisão já foi tomada ou ainda está sendo proposta?
**Resposta recomendada:** "Aceito — já escolhemos PostgreSQL para dados de faturamento."
**Por que isso é importante:** O status muda se o ADR registra uma escolha final ou uma proposta em análise.
**Perguntas restantes estimadas:** ~5
Contrato de Saída
Leia assets/template-markdown.md antes de redigir e preencha essa estrutura.
Por padrão, retorne o ADR final exatamente como um bloco de código Markdown e não crie arquivos. Se o usuário solicitar explicitamente um arquivo/caminho, salve o ADR nesse local e resuma o caminho salvo no chat.
Nunca deixe instruções de espaço reservado no ADR final. Se o usuário pular intencionalmente um detalhe obrigatório, use "TBD" com moderação e apenas para esse detalhe ignorado.
Referência
- Template:
assets/template-markdown.md