Fluxo de Programação em Par: Do Requisito à Validação com IA

Fluxo de Programação em Par: Do Requisito à Validação com IA — aula do módulo OpenCode & Assistentes no Editor, na trilha Provedores e Modelos Gratuitos com…

Leitura de aproximadamente 5 minutos.

Módulo: OpenCode & Assistentes no Editor · Curso: Provedores e Modelos Gratuitos com OpenRouter & OpenCode · Formação: Formação Nível Zero: Ferramentas Essenciais e Gratuitas de IA e Código

Fluxo de Programação em Par: Do Requisito à Validação com IA

O que você vai aprender

1. Dois Erros Comuns ao Trabalhar com IA

Quando profissionais começam a utilizar Inteligência Artificial para construir sistemas, é comum caírem em um de dois extremos improdutivos:

1. A Ilusão do Piloto Automático: O usuário pede à IA: "Crie um sistema completo de gestão de estoque com banco de dados, login e relatórios em PDF". A IA gera centenas de linhas de código desconexas. O sistema não roda, gera dezenas de erros e o usuário não faz ideia de como consertar porque não participou de nenhuma decisão intermediária. 2. A Resistência Manual: O usuário desconfia da IA e continua digitando cada caractere de sintaxe repetitiva manualmente, perdendo a oportunidade de multiplicar sua velocidade de entrega.

O caminho profissional sustentável e de alto nível é a Programação em Par com IA (AI Pair Programming).

Nesse modelo, você e a IA atuam como uma dupla coordenada:


+-------------------------------------------------------------------------------+
|                       O CICLO PROFISSIONAL DE DESENVOLVIMENTO COM IA          |
+-------------------------------------------------------------------------------+
|                                                                               |
|   ┌───────────────────────────┐                                               |
|   │ 1. DECOMPOSIÇÃO           │  <-- Você quebra o problema em 3 passos       |
|   └─────────────┬─────────────┘                                               |
|                 │                                                             |
|                 ▼                                                             |
|   ┌───────────────────────────┐                                               |
|   │ 2. GERAÇÃO ASSISTIDA      │  <-- IA escreve apenas o Passo 1              |
|   └─────────────┬─────────────┘                                               |
|                 │                                                             |
|                 ▼                                                             |
|   ┌───────────────────────────┐                                               |
|   │ 3. VALIDAÇÃO & TESTE      │  <-- Você testa no navegador / terminal       |
|   └─────────────┬─────────────┘                                               |
|                 │                                                             |
|                 ▼                                                             |
|   ┌───────────────────────────┐                                               |
|   │ 4. COMMIT ATÔMICO         │  <-- Salva o estado funcionando no Git       |
|   └─────────────┬─────────────┘                                               |
|                 │ (Repete para o Passo 2...)                                  |
|                 └─────────────────────────────────────────────────────────►   |
|                                                                               |
+-------------------------------------------------------------------------------+

2. O Ciclo de 4 Etapas na Prática

Para construir qualquer funcionalidade com estabilidade e confiança, siga rigorosamente este ciclo:

Etapa 1: Decomposição de Requisitos

Nunca peça uma aplicação inteira de uma só vez. Quebre a tarefa em pequenas partes independentes que possam ser testadas em menos de cinco minutos cada.

Etapa 2: Geração Assistida com Contexto

Envie apenas a instrução do primeiro passo para o assistente, informando os arquivos existentes.

Etapa 3: Revisão de Diffs e Validação

Antes de aceitar o código sugerido, examine a tela de comparação (Diff):

Se a alteração estiver correta, aceite as mudanças e teste imediatamente (abra o arquivo no navegador ou rode o comando no terminal).

Etapa 4: Commit Atômico no Git

Assim que a etapa estiver funcionando perfeitamente, registre esse ponto de restauração no Git:


git add .
git commit -m "Adiciona estrutura inicial da calculadora com campos numericos"

Esse hábito garante que, se você cometer um erro na etapa seguinte, poderá retornar ao estado estável anterior com um único comando.

3. Matriz de Responsabilidades

| Atividade no Projeto | Responsabilidade Humana | Responsabilidade da IA | |---|---|---| | Regra de Negócio | 100% (Decisão) | 0% (Executa conforme instruído) | | Quebra de Tarefas | Principal (Planeja) | Suporte (Sugere divisão) | | Escrita de Sintaxe | 10% (Revisa) | 90% (Gera boilerplate e funções) | | Teste e Validação | 100% (Valida na prática) | 0% (Não enxerga o mundo real) | | Histórico Git | 100% (Commita e publica) | 0% (Auxilia na mensagem de commit) |

4. Princípios de Governança

[!IMPORTANT]
O Princípio "Slow is Fast" (Devagar é Rápido): Avançar etapa por etapa, testando e commitando a cada pequeno passo concluído, pode parecer mais lento à primeira vista do que pedir um bloco gigante de código para a IA. Na prática, é dez vezes mais rápido: você elimina retrabalho, evita alucinações e nunca perde tempo tentando consertar centenas de linhas de código que não compreende.

Exercício Prático

Vamos executar um ciclo completo de 2 etapas assistidas:

1. Crie um arquivo de script: Crie um arquivo chamado calculadora.js. 2. Passo 1 (Geração e Teste): No chat do assistente, envie o prompt:


   No arquivo @calculadora.js, crie uma função simples chamada calcularDesconto(valorTotal, porcentagem) que retorne o valor com desconto aplicado. Inclua um console.log de exemplo testando um valor de 100 com 15% de desconto.

3. Execute no terminal: Teste a execução do arquivo com o Node.js:


   node calculadora.js

(Confirme que o console imprimiu o resultado esperado: 85). 4. Passo 2 (Commit da Etapa): Salve a alteração no histórico:


   git add calculadora.js
   git commit -m "Cria funcao de calculo de desconto em JavaScript"

Outras aulas do módulo