ES EN PT

Vibecoding IPIVC

El estándar de coordinación para equipos humanos asistidos por IA.

Descargar v1.1 (Git Only) Descargar v2.0 (LokiVector) Ver Cómo Funciona

El Problema del "Enjambre Caótico"

🌪️

Colisiones Invisibles

5 desarrolladores usando 5 IAs distintas (ChatGPT, Trae, Cursor) tocando los mismos archivos al mismo tiempo sin saberlo.

🧠

Amnesia de Contexto

Tu IA no sabe lo que la IA de tu compañero decidió hace 5 minutos. Resultado: Código incompatible y deuda técnica inmediata.

💥

Infierno de Merges

Cuando todos hacen push de código generado automáticamente, resolver los conflictos se vuelve una tarea humana imposible.

La Solución: IPIVC Protocol

Un sistema ligero que vive dentro de tu repositorio Git y actúa como un semáforo de tráfico para tu equipo distribuido.

# 1. Instala el estándar en tu proyecto existente

$ python install_standard.py


# 2. Antes de codear, coordina con tu equipo

$ python tools/session_manager.py

> [1] Ver Estado del Equipo (Sync)

> [2] Bloquear Archivos (Lock)


# 3. Al terminar, verifica y libera

$ python tools/session_manager.py

> [3] Terminar Sesión (Unlock)

1

Investiga & Planifica

Sincronizas con el equipo y reservas tu zona de trabajo (Lock). El sistema avisa al resto vía Git.

2

Implementa

Alimentas a tu IA con CURRENT_CONTEXT.prompt.md. La IA genera código respetando los límites.

3

Verifica & Corrige

Tú revisas el código. Si pasa los tests, liberas el bloqueo (Unlock) y haces el push final.

El Protocolo I.P.I.V.C.

Un ciclo de vida estricto para garantizar que la velocidad de la IA no comprometa la estabilidad del proyecto.

I

Investiga

Antes de tocar una línea de código, el humano sincroniza el estado del equipo. ¿Quién está tocando qué? ¿Qué arquitectura debo respetar?

P

Planifica

El humano define el alcance y BLOQUEA los archivos necesarios. Se anuncia la intención al resto del equipo remotamente.

I

Implementa

La IA entra en juego. El humano alimenta al agente con el contexto y supervisa la generación de código dentro de los límites seguros.

V

Verifica

El humano actúa como "Gatekeeper". Ejecuta tests, linters y revisa que la IA no haya alucinado dependencias o tocado archivos prohibidos.

C

Corrige

Si la verificación falla, el humano itera con la IA. Solo cuando todo está verde, se libera el bloqueo y se hace el push final.

El Humano: Director de Orquesta

En el estándar IPIVC, la IA no es un reemplazo, es un instrumento. El humano es la única entidad con responsabilidad y autoridad.

✅ Tu Responsabilidad

  • • Sincronizar el estado del equipo antes de empezar.
  • • Bloquear explícitamente los recursos que usarás.
  • • Filtrar el código que tu IA produce.
  • • Liberar los bloqueos al terminar.

❌ Prohibido

  • • Dejar que la IA haga commit directo a main.
  • • Ignorar las alertas de bloqueo de otros compañeros.
  • • Copiar y pegar código sin leerlo (Blind Trust).
  • • Asumir que "la IA sabe lo que hace".

Guía de Implementación Detallada

Paso 1: Inicio de Tarea (Responsabilidad Humana)

1. Verifica el Terreno:

$ python tools/session_manager.py
> Opción [1] Ver Estado del Equipo

El sistema hará un git pull automático. Si ves que alguien está tocando el módulo que necesitas, DETENTE y habla con ese humano.

2. Reserva y Especifica:

$ python tools/session_manager.py
> Opción [2] Iniciar Sesión

Crea tu sesión (ej. @usuario - Feature X). CRÍTICO: Edita el archivo generado y completa las Especificaciones Funcionales antes de continuar.

Paso 2: Orquestación de IAs (La Magia)

Ahora que tienes el "bloqueo", puedes liberar a tus agentes.

  1. Ejecuta python tools/context_generator.py para crear el prompt maestro.
  2. Copia el contenido de CURRENT_CONTEXT.prompt.md.
  3. Pégalo en tu chat con la IA (ChatGPT, Claude, Trae, Cursor).
  4. Tip Pro: Pega también AGENTS.md si tu IA no tiene acceso al sistema de archivos.

Paso 3: Verificación y Cierre (El Filtro)

Tu IA ha generado código. ¿Es seguro? ¿Cumple las specs?

$ python tools/verify_task.py

Este script generará un reporte AI_FEEDBACK_REPORT.md.

  • ❌ Si falla: Entrégale el reporte a la IA para que corrija.
  • ✅ Si pasa: Libera el bloqueo (Opción 3 en Session Manager) y haz push.

🚨 Gestión de Conflictos

Si necesitas tocar un archivo que ya está reservado por otro humano:

  1. NO le pidas a tu IA que lo sobrescriba.
  2. Contacta al humano dueño de la sesión (su usuario está en el archivo de bloqueo).
  3. Acuerden quién hace qué o esperen a que termine.

Características Clave

🤖 IA-Agnóstico

Funciona con ChatGPT, Claude, Trae, Cursor, Copilot o cualquier herramienta futura. El control está en el humano.

🔒 Git-Based Locking

Sin servidores extra. Tu propio repositorio actúa como la base de datos de coordinación en tiempo real.

📄 AGENTS.md Standard

Implementa el estándar abierto para documentación legible por máquinas. Tus agentes sabrán cómo comportarse.