---
title: Governança de IA
url: https://nandomoreira.dev/servicos/governanca-ia
---

# Seu time já programa com IA. Falta provar que o código está certo.

Defino com o seu time o que o agente faz sozinho, o que exige revisão e quais verificações barram uma entrega errada, com especificação e testes.

Funciona com os agentes que seu time já usa: Claude Code, Codex, Cursor, GitHub Copilot, Grok, Agy.

## Usar IA é diferente de ter um processo com IA

Sem regras combinadas, cada pessoa usa o agente de um jeito e ninguém consegue provar o que foi entregue.

### IA sem regras

- Cada pessoa configura o agente de um jeito
- O agente muda o teste até ele passar
- Mudanças grandes entram sem revisão
- Ninguém sabe o que o agente leu ou alterou
- Segredos e dados sensíveis vão parar no prompt

### IA com governança

- Regras do repositório valem para todos os agentes
- Teste existente não se afrouxa
- Revisão obrigatória nos pontos combinados
- Cada entrega traz evidência do que foi feito
- Segredos fora do alcance dos agentes

## O que costuma dar errado quando o time programa com agentes

É isso que as regras e as verificações precisam barrar.

- **Segredos expostos** (Crítico): Chaves e dados de clientes copiados para o contexto do agente.
- **Testes afrouxados** (Crítico): O agente apaga ou relaxa um teste para a entrega passar.
- **Mudança sem revisão** (Alto): Alterações grandes entram direto, sem ninguém ler.
- **Dependências sem auditoria** (Alto): O agente instala bibliotecas que ninguém avaliou.
- **Uso desigual** (Médio): Cada pessoa tem um jeito, e o resultado muda conforme quem pediu.
- **Sem evidência** (Médio): O time não consegue mostrar o que foi verificado em cada entrega.

## O que o agente faz sozinho, o que exige revisão e o que fica bloqueado

Um exemplo de como as regras ficam. Na imersão, o time define os próprios limites.

### Faz sozinho

- Ler o código e propor um plano
- Escrever testes novos
- Corrigir lint e formatação
- Rodar a suíte de testes

### Exige revisão

- Mudar regras de negócio
- Alterar o schema do banco
- Adicionar dependências
- Mexer em autenticação e permissões

### Bloqueado

- Apagar ou afrouxar teste existente
- Ler segredos e variáveis de ambiente
- Publicar em produção
- Reescrever o histórico do git


## Da imersão às regras no repositório

Três fases. As regras nascem com o time, não prontas de fora.

1. **Imersão:** Entendemos o fluxo e definimos as regras com o time.
   - Mapa do fluxo atual
   - Regras propostas
2. **Implantação no repositório:** Quando contratada, levo as regras e verificações ao repositório.
   - Regras para agentes
   - Verificações de entrega
3. **Acompanhamento:** O time recebe instruções para aplicar o método.
   - Documento de regras
   - Checklist de revisão

## Como começa

Você sabe o que será avaliado no fluxo do time antes de aprovar a imersão.

1. **Primeira conversa:** Você conta como a equipe usa IA hoje.
   - 30 minutos, sem custo.
2. **Imersão:** Revisamos o fluxo e os pontos de controle.
   - Mapa do fluxo atual
   - Regras propostas
3. **Oficina:** O time pratica o método.
   - Prática com as regras propostas
   - Exemplos de testes e evidências
4. **Entrega:** Entrego o método e, se contratada, faço a implantação no repositório.
   - Documento de regras
   - Checklist de revisão
   - Implantação no repositório se contratada

## O que você recebe

- Fluxo com especificação e testes
- Regras e limites para os agentes
- Memória e contexto compartilhados
- Revisão independente antes da entrega
- Documento de regras e checklist
- Instruções para provar cada entrega

## Veja o potencial antes de investir

A imersão ajuda o time a combinar como revisar e verificar o trabalho dos agentes.

- **Conversa sem custo:** Mostre onde a revisão falha hoje.
- **Regras compartilhadas:** A equipe combina o que o agente pode fazer.
- **Evidência por entrega:** O time registra o que verificou antes de entregar.

## O que a governança não inclui

- **Licenças de ferramentas:** As licenças de IA ficam com sua equipe.
- **Treinamento de modelos:** O trabalho cobre como a equipe usa seus agentes.
- **Auditoria de segurança:** A auditoria de segurança do produto é um serviço separado.

## Quem faz o trabalho

Eu conduzo a imersão e a oficina. Trabalho com especificações, testes e revisão independente para registrar como cada entrega foi verificada.

Agentes do meu fluxo: Claude Code, Codex, Grok, Agy, Cursor.

## Se uma dessas frases soa familiar, é hora de combinar as regras

- “Cada dev usa o agente de um jeito.”
- “O agente fez o teste passar, mas o bug continuou.”
- “Ninguém revisou aquele pull request gigante.”
- “Não sei o que o agente leu do nosso código.”
- “Precisamos mostrar ao cliente como garantimos a qualidade.”

## Dúvidas frequentes

### Precisamos trocar de ferramenta?

Começamos pelas ferramentas e pelo fluxo que o time já usa.

### A implantação está incluída?

Ela pode ser contratada depois da imersão.

### O que acontece na imersão?

Alinhamos os riscos, as regras de revisão e as verificações que o time vai usar.

### O time participa da configuração?

Sim. A oficina ajuda a equipe a praticar e ajustar as regras.

