- Título:
- Governança de 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.
- Imersão: Entendemos o fluxo e definimos as regras com o time.
- Mapa do fluxo atual
- Regras propostas
- Implantação no repositório: Quando contratada, levo as regras e verificações ao repositório.
- Regras para agentes
- Verificações de entrega
- 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.
- Primeira conversa: Você conta como a equipe usa IA hoje.
- 30 minutos, sem custo.
- Imersão: Revisamos o fluxo e os pontos de controle.
- Mapa do fluxo atual
- Regras propostas
- Oficina: O time pratica o método.
- Prática com as regras propostas
- Exemplos de testes e evidências
- 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.
---
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.