ES EN PT

Vibecoding IPIVC

O padrão de coordenação para equipes humanas assistidas por IA.

Baixar v1.1 (Git Only) Baixar v2.0 (LokiVector) Ver Como Funciona

O Problema do "Enxame Caótico"

🌪️

Colisões Invisíveis

5 desenvolvedores usando 5 IAs diferentes (ChatGPT, Trae, Cursor) tocando os mesmos arquivos ao mesmo tempo sem saber.

🧠

Amnésia de Contexto

Sua IA não sabe o que a IA do seu colega decidiu há 5 minutos. Resultado: Código incompatível e dívida técnica imediata.

💥

Inferno de Merges

Quando todos fazem push de código gerado automaticamente, resolver conflitos torna-se uma tarefa humana impossível.

A Solução: Protocolo IPIVC

Um sistema leve que vive dentro do seu repositório Git e atua como um semáforo de tráfego para sua equipe distribuída.

# 1. Instale o padrão em seu projeto existente

$ python install_standard.py


# 2. Antes de codar, coordene com sua equipe

$ python tools/session_manager.py

> [1] Ver Status da Equipe (Sync)

> [2] Bloquear Arquivos (Lock)


# 3. Ao terminar, verifique e libere

$ python tools/session_manager.py

> [3] Encerrar Sessão (Unlock)

1

Investigar & Planejar

Sincronize com a equipe e reserve sua zona de trabalho (Lock). O sistema avisa o resto via Git/LokiVector.

2

Implementar

Alimente sua IA com CURRENT_CONTEXT.prompt.md. A IA gera código respeitando os limites.

3

Verificar & Corrigir

Você revisa o código usando verify_task.py. Se passar nos testes, libere o bloqueio (Unlock) e faça push.

O Protocolo I.P.I.V.C.

Um ciclo de vida estrito para garantir que a velocidade da IA não comprometa a estabilidade do projeto.

I

Investigar

Antes de tocar em uma linha de código, o humano sincroniza o estado da equipe. Quem está tocando o quê? Qual arquitetura devo respeitar?

P

Planejar

O humano define o escopo e BLOQUEIA os arquivos necessários. A intenção é anunciada à equipe remotamente.

I

Implementar

A IA entra em jogo. O humano alimenta o agente com contexto e supervisiona a geração de código dentro dos limites seguros.

V

Verificar

O humano atua como "Gatekeeper". Executa testes, linters e verifica se a IA não alucinou dependências ou tocou arquivos proibidos.

C

Corrigir

Se a verificação falhar, o humano itera com a IA. Somente quando tudo estiver verde, o bloqueio é liberado e o push final é feito.

O Humano: Maestro da Orquestra

No padrão IPIVC, a IA não é um substituto, é um instrumento. O humano é a única entidade com responsabilidade e autoridade.

✅ Sua Responsabilidade

  • • Sincronizar o estado da equipe antes de começar.
  • • Bloquear explicitamente os recursos que você usará.
  • • Filtrar o código que sua IA produz.
  • • Liberar bloqueios ao terminar.

❌ Proibido

  • • Deixar a IA fazer commit direto na main.
  • • Ignorar alertas de bloqueio de outros colegas.
  • • Copiar e colar código sem ler (Confiança Cega).
  • • Assumir que "a IA sabe o que está fazendo".

Guia de Implementação Detalhado

Passo 1: Início da Tarefa (Responsabilidade Humana)

1. Verifique o Terreno:

$ python tools/session_manager.py
> Opção [1] Ver Status da Equipe

O sistema fará um git pull automático. Se você vir alguém tocando o módulo que precisa, PARE e fale com esse humano.

2. Reserve e Especifique:

$ python tools/session_manager.py
> Opção [2] Iniciar Sessão

Crie sua sessão (ex: @usuario - Feature X). CRÍTICO: Edite o arquivo gerado e complete as Especificações Funcionais antes de continuar.

Passo 2: Orquestração de IAs (A Mágica)

Agora que você tem o "bloqueio", pode liberar seus agentes.

  1. Execute python tools/context_generator.py para criar o prompt mestre.
  2. Copie o conteúdo de CURRENT_CONTEXT.prompt.md.
  3. Cole no chat da sua IA (ChatGPT, Claude, Trae, Cursor).
  4. Dica Pro: Cole também AGENTS.md se sua IA não tiver acesso ao sistema de arquivos.

Passo 3: Verificação e Encerramento (O Filtro)

Sua IA gerou código. É seguro? Atende às specs?

$ python tools/verify_task.py

Este script gerará um relatório AI_FEEDBACK_REPORT.md.

  • ❌ Se falhar: Entregue o relatório à IA para corrigir.
  • ✅ Se passar: Libere o bloqueio (Opção 3 no Session Manager) e faça push.

🚨 Gestão de Conflitos

Se você precisar tocar em um arquivo já reservado por outro humano:

  1. NÃO peça à sua IA para sobrescrevê-lo.
  2. Contate o humano dono da sessão (o usuário está no arquivo de bloqueio).
  3. Entrem em acordo sobre quem faz o quê ou aguarde o término.

Principais Características

🤖 Agnóstico à IA

Funciona com ChatGPT, Claude, Trae, Cursor, Copilot ou qualquer ferramenta futura. O controle permanece com o humano.

🔒 Bloqueio Híbrido

Usa Git para persistência e LokiVector para detecção de conflitos semânticos em tempo real.

📄 Padrão AGENTS.md

Implementa o padrão aberto para documentação legível por máquinas. Seus agentes saberão como se comportar.