AI pair programming

---

name: ai-pair-programming description: Orquestra um loop de engenharia com dois AIs, onde um AI Primário planeja e implementa, enquanto um AI de Revisão valida e revisa, com feedback contínuo para qualidade de código ideal. Suporta combinações personalizadas de AIs (Claude, Codex, Gemini, etc.)

Habilidade de Programação em Par com IA

Visão Geral

Um fluxo de trabalho flexível de programação em par que permite combinar dois assistentes de IA para desenvolvimento colaborativo. Configure seu par de IAs preferido com base em seus pontos fortes.

Configuração de IAs

Antes de usar esta habilidade, configure seu par de IAs definindo os seguintes papéis:

Papel	Descrição	Exemplos
IA Primária	Lida com arquitetura, planejamento e implementação de código	Claude, Gemini, GPT-4
IA de Revisão	Valida planos e revisa código para garantia de qualidade	Codex, Claude, Gemini

Exemplos de Configuração

Configuração	IA Primária	IA de Revisão	Caso de Uso
Claude + Codex	Claude	Codex	Planejamento forte + Validação rápida
Claude + Gemini	Claude	Gemini	Perspectiva multi-modelo
Gemini + Claude	Gemini	Claude	Aproveitar o contexto do Gemini + revisão do Claude
GPT-4 + Codex	GPT-4	Codex	Planejamento GPT + validação Codex

Configurando Seu Par de IAs

Substitua os placeholders {{PRIMARY_AI}} e {{REVIEW_AI}} ao longo desta habilidade pelos nomes dos seus IAs escolhidos.

Exemplo:

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

Para ferramentas de linha de comando, substitua {{REVIEW_AI_CLI}} pelo comando CLI apropriado:

• Codex: codex exec --sandbox read-only
• Claude: claude --print
• Gemini: gemini
• Outro: Use a ferramenta CLI do seu IA

Nota: Os comandos CLI são exemplos. Verifique a sintaxe CLI correta para suas ferramentas de IA específicas e suas versões atuais.

Filosofia Central do Fluxo de Trabalho

Esta habilidade implementa um loop de engenharia equilibrado:

• {{PRIMARY_AI}}: Arquitetura, planejamento e execução
• {{REVIEW_AI}}: Validação e revisão de código
• Revisão Contínua: Cada IA revisa o trabalho do outro
• Transferência de Contexto: Sempre continue com quem fez a última limpeza

Nota: Configurações de modelo + raciocínio são assumidas como sendo tratadas pela configuração existente de cada IA. Os comandos abaixo usam placeholders genéricos.

Fase 1: Planejamento com {{PRIMARY_AI}}

1. Comece criando um plano detalhado para a tarefa
2. Divida a implementação em etapas claras
3. Documente suposições e possíveis problemas
4. Produza o plano em um formato estruturado

Fase 2: Validação do Plano com {{REVIEW_AI}}

1. Envie o plano para {{REVIEW_AI}} para validação:

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. Capture o feedback de {{REVIEW_AI}}

Fase 3: Loop de Feedback

Se {{REVIEW_AI}} encontrar problemas:

1. Resuma as preocupações de {{REVIEW_AI}} para o usuário
2. Refine o plano com base no feedback
3. Pergunte ao usuário (via AskUserQuestion): "Devo revisar o plano e revalidar, ou prosseguir com correções?"
4. Repita a Fase 2 se necessário

Fase 4: Execução

Uma vez que o plano é validado:

1. {{PRIMARY_AI}} implementa o código usando as ferramentas disponíveis (Editar, Escrever, Ler, etc.)
2. Divida a implementação em etapas gerenciáveis
3. Execute cada etapa cuidadosamente com tratamento de erros adequado
4. Documente o que foi implementado

Fase 5: Revisão Cruzada Após Mudanças

Após cada mudança:

1. Envie a implementação de {{PRIMARY_AI}} para {{REVIEW_AI}} revisar:
   • Detecção de bugs
   • Problemas de desempenho
   • Validação de melhores práticas
   • Vulnerabilidades de segurança
2. {{PRIMARY_AI}} analisa o feedback de {{REVIEW_AI}} e decide:
   • Aplicar correções imediatamente se os problemas forem críticos
   • Discutir com o usuário se mudanças arquiteturais forem necessárias
   • Documentar decisões tomadas

Fase 6: Melhoria Iterativa

1. Após a revisão de {{REVIEW_AI}}, {{PRIMARY_AI}} aplica as correções necessárias
2. Para mudanças significativas, envie de volta para {{REVIEW_AI}} para revalidação
3. Continue o loop até que os padrões de qualidade de código sejam atendidos
4. Para ferramentas de IA que suportam continuação de sessão, use o sinalizador de retomada:

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

Nota: O suporte à retomada de sessão varia conforme a ferramenta de IA. Para ferramentas sem suporte a retomada, inicie uma nova sessão com contexto completo.

Recuperação Quando Problemas São Encontrados

Quando {{REVIEW_AI}} identifica problemas:

1. {{PRIMARY_AI}} analisa a causa raiz
2. Implementa correções usando as ferramentas disponíveis
3. Envia o código atualizado de volta para {{REVIEW_AI}} para verificação
4. Repete até que a validação passe

Quando ocorrem erros de implementação:

1. {{PRIMARY_AI}} revisa o erro/problema
2. Ajusta a estratégia de implementação
3. Revalida com {{REVIEW_AI}} antes de prosseguir

Melhores Práticas

• Sempre valide planos antes da execução
• Nunca pule a revisão cruzada após mudanças
• Mantenha transferência clara entre IAs
• Documente quem fez o quê para contexto
• Use retomada para preservar o estado da sessão (verifique a documentação da sua ferramenta de IA para suporte)

Referência de Comandos

Fase	Padrão de Comando	Propósito
Validar plano	echo "plan" | {{REVIEW_AI_CLI}}	Verificar lógica antes de codificar
Implementar	{{PRIMARY_AI}} usa ferramentas Editar/Escrever/Ler	{{PRIMARY_AI}} implementa o plano validado
Revisar código	echo "review changes" | {{REVIEW_AI_CLI}}	{{REVIEW_AI}} valida a implementação de {{PRIMARY_AI}}
Continuar revisão	echo "next step" | {{REVIEW_AI_CLI}} --resume	Continuar sessão de validação (se suportado)
Aplicar correções	{{PRIMARY_AI}} usa ferramentas Editar/Escrever	{{PRIMARY_AI}} corrige problemas encontrados por {{REVIEW_AI}}
Revalidar	echo "verify fixes" | {{REVIEW_AI_CLI}}	{{REVIEW_AI}} verifica novamente após correções

Nota: O sinalizador --resume é suportado por algumas ferramentas de IA (ex.: Codex). Para ferramentas sem suporte a retomada, inicie uma nova sessão com o contexto necessário.

Tratamento de Erros

1. Pare em códigos de saída diferentes de zero de {{REVIEW_AI}}
2. Resuma o feedback de {{REVIEW_AI}} e peça orientação via AskUserQuestion
3. Antes de implementar mudanças, confirme a abordagem com o usuário se:
   • Mudanças arquiteturais significativas forem necessárias
   • Múltiplos arquivos forem afetados
   • Mudanças que quebram compatibilidade forem necessárias
4. Quando avisos de {{REVIEW_AI}} aparecerem, {{PRIMARY_AI}} avalia a gravidade e decide os próximos passos

O Loop Perfeito

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

Isso cria um sistema de engenharia autocorretivo e de alta qualidade onde:

• {{PRIMARY_AI}} lida com toda implementação e modificação de código
• {{REVIEW_AI}} fornece validação, revisão e garantia de qualidade

---

Exemplos de Início Rápido

Exemplo 1: Claude + Codex (Configuração Original)

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

Exemplo 2: Claude + Gemini

PRIMARY_AI = Claude
REVIEW_AI = Gemini
REVIEW_AI_CLI = gemini

Exemplo 3: Gemini + Claude

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