Pular para o conteúdo

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

  • Crítico

    Segredos expostos

    Chaves e dados de clientes copiados para o contexto do agente.

  • Crítico

    Testes afrouxados

    O agente apaga ou relaxa um teste para a entrega passar.

  • Alto

    Mudança sem revisão

    Alterações grandes entram direto, sem ninguém ler.

  • Alto

    Dependências sem auditoria

    O agente instala bibliotecas que ninguém avaliou.

  • Médio

    Uso desigual

    Cada pessoa tem um jeito, e o resultado muda conforme quem pediu.

  • Médio

    Sem evidência

    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.

Fases do trabalho

Entendemos o fluxo e definimos as regras com o time.

O que entra nesta fase

  • Mapa do fluxo atual
  • Regras propostas

Quando contratada, levo as regras e verificações ao repositório.

O que entra nesta fase

  • Regras para agentes
  • Verificações de entrega

O time recebe instruções para aplicar o método.

O que entra nesta fase

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

    Você sai da conversa sabendo qual é o próximo passo.

  2. Imersão

    Revisamos o fluxo e os pontos de controle.

    • Mapa do fluxo atual
    • Regras propostas

    Entendemos o fluxo e definimos as regras com o time.

  3. Oficina

    O time pratica o método.

    • Prática com as regras propostas
    • Exemplos de testes e evidências

    A equipe usa a oficina para ajustar as regras.

  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

    A equipe recebe instruções para aplicar o método.

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

  • Fora do escopo

    Licenças de ferramentas

    As licenças de IA ficam com sua equipe.

  • Fora do escopo

    Treinamento de modelos

    O trabalho cobre como a equipe usa seus agentes.

  • Fora do escopo

    Auditoria de segurança

    A auditoria de segurança do produto é um serviço separado.

Cases

  • Trabalho profissional e de clienteConfidencial

    Framework de desenvolvimento com IA

    Framework interno da Liquid AI sobre o Claude Code, com teste antes do código e portões de lint, tipos, testes e build. Três modelos têm papéis separados: um implementa, outro revisa e o orquestrador valida e versiona.

  • Ferramental de AI coding

    Forja

    Cliente desktop que reúne Claude Code, Codex e Gemini numa só interface, para não perder contexto alternando entre três terminais. Feito em Electron, React e TypeScript, com xterm.js para o terminal e uma camada de adaptação por CLI em vez de impor um protocolo comum às três. É o meu cliente principal no dia a dia.

    Workspace do Forja com árvore de arquivos, CLAUDE.md aberto, sessão do Claude Code, navegador embutido, timer Pomodoro e tarefas em Markdown

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
Leia sobre meu processo com RPI
Foto de Fernando Moreira, de óculos e barba, sorrindo

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.

Próximo passo

Quer definir como seu time usa agentes de IA?

Na primeira conversa, de 30 minutos e sem custo, você me conta como o time trabalha hoje.

Agora é só compartilhar.

Vamos conversar sobre o seu projeto?

Quem atende é quem constrói, sem intermediário. Você conta o que precisa e eu te digo o caminho mais simples.

Prefiro conversar pelo WhatsApp
ou