Communitygithub.com

andresnator/agents-orchestrator

Cria 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.

O que é agents-orchestrator?

O ADR Creator é uma skill especializada em gerar Architecture Decision Records (ADRs) — registros formais de decisões técnicas ou arquiteturais. Ele é útil para equipes de desenvolvimento que precisam documentar decisões de forma estruturada, garantindo que o contexto, as alternativas consideradas, os prós e contras, e as consequências sejam registrados de maneira clara. Suporta plataformas como Claude Code, Cursor e Codex. A skill opera em modo de entrevista, fazendo perguntas uma de cada vez para coletar informações necessárias, e só gera o documento final quando o usuário fornece detalhes suficientes. Ela segue regras rigorosas, como evitar inventar alternativas ou justificativas, e permite que o usuário pule perguntas ou interrompa a entrevista a qualquer momento. O ADR resultante é fornecido como um bloco de código Markdown, exceto quando o usuário solicita explicitamente a criação de um arquivo.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add andresnator/agents-orchestrator

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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:

  1. Título e status da decisão.
  2. Contexto: problema, restrições, forças e por que a decisão é importante agora.
  3. Opção ou proposta escolhida.
  4. Opções consideradas, com prós e contras para cada uma.
  5. Consequências: benefícios, desvantagens, riscos e compensações.
  6. 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

Habilidades Relacionadas