ai-governance

Orquestra regras de governanca, DDD, tratamento de erros, seguranca e testes para tarefas com agentes de IA. Use quando a tarefa exigir aplicar padroes obrigatorios antes de analisar, editar ou validar codigo. Nao use para tarefas casuais sem alteracao de codigo nem para substituir skills especificas de linguagem.

Analisa a arquitetura de um projeto (monolito, monolito modular, monorepo, microservico), detecta stack e ferramentas de IA instaladas, e gera arquivos de governanca (CLAUDE.md, AGENTS.md, GEMINI.md, etc.) personalizados. Use quando precisar configurar ou atualizar a governanca orientada a IA em um projeto existente. Nao use para criar codigo de aplicacao ou alterar logica de negocio.

Corrige bugs pela causa raiz com testes de regressao obrigatorios e evidencia de validacao. Use quando o usuario pedir para corrigir bugs ou referenciar bugs.md, especialmente a partir de achados emitidos pela skill review. Nao use para review ou auditoria sem alteracao, nem para refatoracao sem defeito confirmado.

Executa uma tarefa de implementação aprovada por meio de codificação, validação, revisão e captura de evidências. Use quando um arquivo de tarefa estiver pronto para implementação e fechamento com testes, lint e evidência de revisão. Não use para planejamento, refatorações amplas sem tarefa ou exploração especulativa de código.

Implementa alteracoes em codigo Go usando governanca base, arquitetura, estilo, testes e padroes recorrentes. Use quando a tarefa exigir adicionar, corrigir, refatorar ou validar codigo Go, incluindo interfaces, generics, concorrencia e validacao da stack. Nao use para tarefas sem codigo Go, documentacao geral ou triagem sem alteracao.

Implementa alteracoes em codigo Node/TypeScript usando governanca base, convencoes de projeto e validacao proporcional. Use quando a tarefa exigir adicionar, corrigir, refatorar ou validar codigo Node.js ou TypeScript. Nao use para tarefas sem codigo Node/TypeScript.

Implementa alteracoes em codigo Python usando governanca base, convencoes de projeto e validacao proporcional. Use quando a tarefa exigir adicionar, corrigir, refatorar ou validar codigo Python. Nao use para tarefas sem codigo Python.

Planeja ou executa refatorações incrementais seguras preservando comportamento e coletando evidências de não regressão. Use quando uma refatoração delimitada precisar de orientação consultiva ou execução com validação e revisão. Não use para entrega de nova funcionalidade, definição de escopo de produto ou reescritas cosméticas sem alvo verificado.

Revisa um diff de código quanto a correção, segurança, regressões e testes faltantes usando regras específicas do repositório. Use quando uma branch ou diff local precisar de revisão no estilo dono do código antes de merge ou fechamento de tarefa. Não use para implementação, planejamento de produto ou limpeza apenas de estilo.

Cria tarefas incrementais de implementação a partir de um PRD e de uma especificação técnica. Use quando documentos de produto e técnicos aprovados precisarem ser decompostos em itens de trabalho ordenados e testáveis. Não use para mudanças diretas de código, descoberta de funcionalidade ou revisão de branch.

Executa tarefas aprovadas em sequência até esgotar todas as tasks elegíveis de um tasks/prd-<feature-slug>/tasks.md. Para cada task, executa o fluxo completo de execute-task (elegibilidade, contexto, implementação, validação, review, bugfix quando aplicável, evidências e encerramento). Não use para execução de uma única tarefa isolada nem para planejamento.

Cria documentos de requisitos do produto a partir de solicitações de funcionalidade. Use quando uma funcionalidade precisar de escopo, objetivos, restrições e requisitos funcionais numerados antes do desenho técnico. Não use para planejamento de implementação, mudanças de código ou decisões de arquitetura técnica.

Publica changelogs no Confluence a partir de CHANGELOG.md ou de git log estruturado. Use quando precisar sincronizar notas de release com o Confluence. Nao use para gerar o changelog — use github-diff-changelog-publisher para isso.

Gera e publica CHANGELOG.md a partir de git log entre dois refs (tags, branches, commits). Use quando precisar de notas de release estruturadas antes de publicar uma release no GitHub. Nao use para publicar a release em si — use github-release-publication-flow para isso.

Organiza, prioriza e responde comentarios de revisao em Pull Requests do GitHub. Use quando um PR tiver multiplos comentarios de revisores e precisar de triagem estruturada. Nao use para implementar as correcoes solicitadas — use execute-task ou bugfix para isso.

Publica uma release no GitHub com tag, notas de release e assets. Use apos gerar o changelog com github-diff-changelog-publisher e ter o codigo pronto para release. Nao use para gerar changelog ou criar PRs — use as skills dedicadas para isso.

Cria, atualiza e consulta tickets Jira a partir de tasks.md ou de solicitacoes diretas. Use quando precisar sincronizar tarefas de implementacao com o Jira. Nao use para planejamento de produto — use create-prd e create-tasks primeiro.

Gera e atualiza dashboards Grafana para servicos instrumentados com OpenTelemetry. Use quando precisar criar paineis de metricas, logs e traces para servicos Go, Node ou Python. Nao use para configurar a instrumentacao OTel no codigo — use as skills de linguagem para isso.

Gera colecoes Postman a partir de specs OpenAPI/Swagger, codigo de handler ou documentacao de API. Use quando precisar de colecao testavel para endpoints REST. Nao use para testar endpoints diretamente — gera apenas o artefato de colecao.

Enriquece e melhora prompts de usuario com contexto, restricoes e criterios de saida para uso com agentes de IA. Use quando um prompt for vago, incompleto ou precisar de estrutura para obter resultados determinísticos. Nao use para executar o prompt enriquecido — apenas para produzi-lo.

Cria e gerencia pull requests no GitHub com titulo, descricao estruturada e checklist de teste. Use quando precisar abrir, atualizar ou revisar um PR com base em diff ou branch. Nao use para revisao de codigo — use a skill review para isso.

Cria commits semanticos no padrao Conventional Commits (feat, fix, chore, docs, refactor, test, ci). Use quando precisar commitar mudancas com mensagem estruturada e rastreavel. Nao use para revisar ou implementar codigo — apenas para a acao de commit.

Converte User Stories brutas em um PRD estruturado com objetivo, escopo, restricoes e requisitos funcionais numerados. Use como etapa anterior ao create-prd quando a entrada for historias de usuario (formato "Como <persona>, quero <acao>, para <valor>"). Nao use para criar PRDs a partir do zero sem historias de usuario.

Cria especificações técnicas prontas para implementação a partir de um PRD aprovado e do contexto do repositório. Use quando arquitetura, interfaces, riscos, ADRs e estratégia de testes precisarem ser definidos antes da codificação. Não use para descoberta de produto, execução de tarefa ou revisão de código.

Aplica heuristicas de object calisthenics em codigo Go por meio de refatoracoes pequenas com preservacao de comportamento, criterios de revisao e passos de validacao adaptados a packages, structs, interfaces, metodos e tratamento de erro. Use quando o codigo Go precisar de melhoria incremental de desenho, menor complexidade, responsabilidades mais estreitas ou orientacao de revisao baseada em regras. Nao use para definicao de escopo de funcionalidade, migracao de framework, reescritas amplas ou mudancas que exijam quebra de API publica sem aprovacao explicita.