Pular para o conteúdo

Pronto para LLM

/servicos/governanca-ia.md

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.

  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.

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

Agora é só compartilhar.