davinegreiiros/ai-delivery-kit

Compara alternativas para uma decisão estrutural em aberto - nova dependência, padrão de módulo, armazenamento, comunicação entre serviços, estado, cache - e registra a escolha como ADR. Use quando o plano depende de uma decisão de arquitetura não tomada ou quando pedirem "qual a melhor abordagem para X". Não implementa.

Mapeia o impacto técnico de uma mudança já especificada antes de planejar ou codar - módulos, contratos, dados, testes, docs e riscos afetados. Use dentro do fluxo kit-sdd ou quando pedirem "qual o impacto de mudar X". Somente leitura no código.

Revisão técnica somente leitura do diff atual contra a spec da mudança - correção, escopo, testes, segurança e docs. Use ao final do fluxo kit-sdd ou quando pedirem para revisar a mudança antes do PR. Não altera arquivos.

Define ou evolui contratos compartilhados - APIs REST/GraphQL/gRPC, eventos, schemas de banco expostos, SDKs, formatos de arquivo - antes de implementar, verificando compatibilidade com consumidores. Use quando a mudança cria ou altera uma interface usada por outro sistema, app ou time.

Traz um issue/card de GitHub Issues, GitLab, Jira ou Linear para o fluxo SDD - lê título, descrição, critérios e comentários e gera o rascunho de specs/<ID>/spec.md. Use quando o pedido citar um número de issue, link de card ou "pegue a tarefa X". Publicar algo no tracker exige confirmação.

Prepara um repositório para usar o ai-delivery-kit com qualquer agente (Claude Code, Codex, Gemini, Copilot, Cursor) - cria AGENTS.md, arquivos-ponte por cliente, constituição, config de testes, docs/ e specs/. Use quando pedirem "prepare este repositório para o kit" ou "configure SDD neste projeto". Não implementa features.

Fluxo padrão para qualquer pedido que crie ou altere código, testes, configuração ou comportamento em um repositório que usa o ai-delivery-kit (AGENTS.md cita o kit ou existe .kit/constitution.md). Acione automaticamente, mesmo sem o usuário citar a skill. Conduz spec, impacto, plano, implementação com testes e verificação. Não use para perguntas somente leitura.

Revisão de segurança somente leitura de um diff ou módulo - segredos, injeção, autenticação, autorização, dados pessoais, dependências e configuração. Use quando a mudança toca login, permissões, dados sensíveis, entrada externa, uploads, integrações ou quando pedirem revisão de segurança. Não altera arquivos.

Cria ou atualiza a documentação viva de um sistema existente (brownfield) em docs/ - visão geral, módulos, fluxos, integrações, dados e operação - a partir de evidências do código. Use quando o projeto não tem docs/, quando pedirem "documente/mapeie este sistema" ou antes de uma mudança em área não documentada. Não altera código.

Investiga bugs, falhas de teste, erros em produção e comportamentos inesperados por reprodução, hipóteses e evidência antes de qualquer correção. Use quando algo "não funciona", "quebrou", "dá erro" ou um teste falha sem causa conhecida. Não use para implementar features.

Mede a suíte de testes e a cobertura antes (baseline) e depois (final) de uma implementação e bloqueia a conclusão se testes falharem ou a cobertura cair. Use dentro do kit-sdd imediatamente antes e depois de alterar código, ou quando pedirem para comparar testes antes e depois.