AI pair programming

---

name: ai-pair-programming description: Orquesta un bucle de ingeniería dual de IA donde una IA Primaria planifica e implementa, mientras que una IA de Revisión valida y revisa, con retroalimentación continua para una calidad de código óptima. Soporta emparejamiento de IA personalizado (Claude, Codex, Gemini, etc.)

Habilidad de Programación en Pareja con IA

Descripción General

Un flujo de trabajo flexible de programación en pareja que te permite combinar dos asistentes de IA para el desarrollo colaborativo. Configura tu par de IA preferido según sus fortalezas.

Configuración de IA

Antes de usar esta habilidad, configura tu par de IA estableciendo los siguientes roles:

Rol	Descripción	Ejemplos
IA Primaria	Maneja arquitectura, planificación e implementación de código	Claude, Gemini, GPT-4
IA de Revisión	Valida planes y revisa código para aseguramiento de calidad	Codex, Claude, Gemini

Configuraciones de Ejemplo

Configuración	IA Primaria	IA de Revisión	Caso de Uso
Claude + Codex	Claude	Codex	Planificación sólida + Validación rápida
Claude + Gemini	Claude	Gemini	Perspectiva multi-modelo
Gemini + Claude	Gemini	Claude	Aprovechar el contexto de Gemini + la revisión de Claude
GPT-4 + Codex	GPT-4	Codex	Planificación GPT + Validación Codex

Configurando Tu Par de IA

Reemplaza los marcadores de posición {{PRIMARY_AI}} y {{REVIEW_AI}} a lo largo de esta habilidad con los nombres de IA que elijas.

Ejemplo:

• {{PRIMARY_AI}} → Claude
• {{REVIEW_AI}} → Codex

Para herramientas de línea de comandos, reemplaza {{REVIEW_AI_CLI}} con el comando CLI apropiado:

• Codex: codex exec --sandbox read-only
• Claude: claude --print
• Gemini: gemini
• Otro: Usa la herramienta CLI de tu IA

Nota: Los comandos CLI son ejemplos. Por favor verifica la sintaxis CLI correcta para tus herramientas de IA específicas y sus versiones actuales.

Filosofía Central del Flujo de Trabajo

Esta habilidad implementa un bucle de ingeniería equilibrado:

• {{PRIMARY_AI}}: Arquitectura, planificación y ejecución
• {{REVIEW_AI}}: Validación y revisión de código
• Revisión Continua: Cada IA revisa el trabajo de la otra
• Transferencia de Contexto: Siempre continúa con quien haya limpiado por última vez

Nota: Se asume que la configuración de modelo + razonamiento es manejada por la configuración existente de cada IA. Los comandos a continuación usan marcadores de posición genéricos.

Fase 1: Planificación con {{PRIMARY_AI}}

1. Comienza creando un plan detallado para la tarea
2. Divide la implementación en pasos claros
3. Documenta suposiciones y problemas potenciales
4. Genera el plan en un formato estructurado

Fase 2: Validación del Plan con {{REVIEW_AI}}

1. Envía el plan a {{REVIEW_AI}} para validación:

echo "Review this implementation plan and identify any issues:
[{{PRIMARY_AI}}'s plan here]

Check for:
- Logic errors
- Missing edge cases
- Architecture flaws
- Security concerns" | {{REVIEW_AI_CLI}}

2. Captura la retroalimentación de {{REVIEW_AI}}

Fase 3: Bucle de Retroalimentación

Si {{REVIEW_AI}} encuentra problemas:

1. Resume las preocupaciones de {{REVIEW_AI}} al usuario
2. Refina el plan según la retroalimentación
3. Pregunta al usuario (vía AskUserQuestion): "¿Debo revisar el plan y revalidar, o proceder con correcciones?"
4. Repite la Fase 2 si es necesario

Fase 4: Ejecución

Una vez que el plan está validado:

1. {{PRIMARY_AI}} implementa el código usando las herramientas disponibles (Editar, Escribir, Leer, etc.)
2. Divide la implementación en pasos manejables
3. Ejecuta cada paso cuidadosamente con manejo de errores adecuado
4. Documenta lo que se implementó

Fase 5: Revisión Cruzada Después de Cambios

Después de cada cambio:

1. Envía la implementación de {{PRIMARY_AI}} a {{REVIEW_AI}} para revisión:
   • Detección de errores
   • Problemas de rendimiento
   • Validación de mejores prácticas
   • Vulnerabilidades de seguridad
2. {{PRIMARY_AI}} analiza la retroalimentación de {{REVIEW_AI}} y decide:
   • Aplicar correcciones inmediatamente si los problemas son críticos
   • Discutir con el usuario si se necesitan cambios arquitectónicos
   • Documentar las decisiones tomadas

Fase 6: Mejora Iterativa

1. Después de la revisión de {{REVIEW_AI}}, {{PRIMARY_AI}} aplica las correcciones necesarias
2. Para cambios significativos, envía de vuelta a {{REVIEW_AI}} para revalidación
3. Continúa el bucle hasta que se cumplan los estándares de calidad del código
4. Para herramientas de IA que soportan continuación de sesión, usa la bandera de reanudación:

echo "Review the updated implementation" | {{REVIEW_AI_CLI}} --resume

Nota: El soporte de reanudación de sesión varía según la herramienta de IA. Para herramientas sin soporte de reanudación, inicia una nueva sesión con contexto completo.

Recuperación Cuando Se Encuentran Problemas

Cuando {{REVIEW_AI}} identifica problemas:

1. {{PRIMARY_AI}} analiza la causa raíz
2. Implementa correcciones usando las herramientas disponibles
3. Envía el código actualizado de vuelta a {{REVIEW_AI}} para verificación
4. Repite hasta que la validación pase

Cuando ocurren errores de implementación:

1. {{PRIMARY_AI}} revisa el error/problema
2. Ajusta la estrategia de implementación
3. Revalida con {{REVIEW_AI}} antes de continuar

Mejores Prácticas

• Siempre valida los planes antes de la ejecución
• Nunca omitas la revisión cruzada después de cambios
• Mantén una transferencia clara entre IAs
• Documenta quién hizo qué para el contexto
• Usa reanudación para preservar el estado de la sesión (consulta la documentación de tu herramienta de IA para soporte)

Referencia de Comandos

Fase	Patrón de Comando	Propósito
Validar plan	echo "plan" | {{REVIEW_AI_CLI}}	Verificar lógica antes de codificar
Implementar	{{PRIMARY_AI}} usa herramientas Editar/Escribir/Leer	{{PRIMARY_AI}} implementa el plan validado
Revisar código	echo "review changes" | {{REVIEW_AI_CLI}}	{{REVIEW_AI}} valida la implementación de {{PRIMARY_AI}}
Continuar revisión	echo "next step" | {{REVIEW_AI_CLI}} --resume	Continuar sesión de validación (si es compatible)
Aplicar correcciones	{{PRIMARY_AI}} usa herramientas Editar/Escribir	{{PRIMARY_AI}} corrige problemas encontrados por {{REVIEW_AI}}
Revalidar	echo "verify fixes" | {{REVIEW_AI_CLI}}	{{REVIEW_AI}} vuelve a verificar después de correcciones

Nota: La bandera --resume es compatible con algunas herramientas de IA (por ejemplo, Codex). Para herramientas sin soporte de reanudación, inicia una nueva sesión con el contexto necesario.

Manejo de Errores

1. Detente en códigos de salida distintos de cero de {{REVIEW_AI}}
2. Resume la retroalimentación de {{REVIEW_AI}} y pide dirección vía AskUserQuestion
3. Antes de implementar cambios, confirma el enfoque con el usuario si:
   • Se necesitan cambios arquitectónicos significativos
   • Se verán afectados múltiples archivos
   • Se requieren cambios disruptivos
4. Cuando aparezcan advertencias de {{REVIEW_AI}}, {{PRIMARY_AI}} evalúa la gravedad y decide los siguientes pasos

El Bucle Perfecto

Plan ({{PRIMARY_AI}}) → Validate Plan ({{REVIEW_AI}}) → Feedback →
Implement ({{PRIMARY_AI}}) → Review Code ({{REVIEW_AI}}) →
Fix Issues ({{PRIMARY_AI}}) → Re-validate ({{REVIEW_AI}}) → Repeat until perfect

Esto crea un sistema de ingeniería autocorrectivo y de alta calidad donde:

• {{PRIMARY_AI}} maneja toda la implementación y modificaciones de código
• {{REVIEW_AI}} proporciona validación, revisión y aseguramiento de calidad

---

Ejemplos de Inicio Rápido

Ejemplo 1: Claude + Codex (Configuración Original)

PRIMARY_AI = Claude
REVIEW_AI = Codex
REVIEW_AI_CLI = codex exec --sandbox read-only

Ejemplo 2: Claude + Gemini

PRIMARY_AI = Claude
REVIEW_AI = Gemini
REVIEW_AI_CLI = gemini

Ejemplo 3: Gemini + Claude

PRIMARY_AI = Gemini
REVIEW_AI = Claude
REVIEW_AI_CLI = claude --print