Modulo 08: IA para desarrollo

IA para desarrollo: de asistente a companero de equipo

La IA para desarrollo ha evolucionado en tres generaciones. La primera fue autocompletado inteligente (GitHub Copilot): predice la siguiente linea. La segunda fue chat integrado (ChatGPT, Cursor): preguntas y obtienes respuestas. La tercera es agentes de desarrollo (Claude Code): leen tu proyecto completo, ejecutan comandos, editan ficheros, corren tests y hacen commits.

• Copilot (autocomplete): rapido, util para boilerplate. No entiende el contexto completo del proyecto.
• Chat (Cursor, ChatGPT): bueno para preguntas puntuales. Requiere copiar/pegar contexto manualmente.
• Agente (Claude Code): lee tu CLAUDE.md, navega el codebase, ejecuta bash, edita multiples ficheros, corre tests. Trabaja como un junior developer con acceso al proyecto.

Setup: Claude Code de cero a productivo

Instalacion en 3 comandos:

# Instalacion global
npm install -g @anthropic-ai/claude-code

# Verificar
claude --version

# Iniciar en tu proyecto
cd mi-proyecto
claude

El fichero clave es CLAUDE.md en la raiz del proyecto. Es el cerebro: define stack, reglas, contexto y comandos disponibles. Claude Code lo lee automaticamente al iniciar.

# CLAUDE.md - ejemplo real
## Stack
- Backend: FastAPI, Python 3.11
- Frontend: Next.js 14, React
- DB: Supabase PostgreSQL con RLS
- Deploy: Hetzner via Dokploy

## Reglas
- Tests obligatorios antes de commit
- Nunca exponer API keys en codigo
- Usar TypeScript strict en frontend
- Endpoints siempre con /api/v1/ prefix

## Comandos utiles
- `npm run dev` - desarrollo local frontend
- `uvicorn main:app --reload` - desarrollo local backend
- `pytest -v` - correr tests

El sistema de permisos controla que puede hacer Claude Code:

• Read: leer ficheros del proyecto. Siempre permitido.
• Edit: modificar ficheros existentes. Pide confirmacion por defecto.
• Write: crear ficheros nuevos.
• Bash: ejecutar comandos en terminal. Configurable con allowlist.
• MCP: conectar con herramientas externas (Supabase, n8n, GitHub).

Hooks: automatizar el flujo de desarrollo

Los hooks ejecutan acciones automaticas antes o despues de que Claude Code use una herramienta. Se configuran en .claude/settings.json:

// .claude/settings.json
{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "command": "npx eslint --fix $FILE_PATH"
      },
      {
        "matcher": "Edit",
        "command": "pytest tests/ -x --tb=short 2>&1 | tail -20"
      }
    ],
    "PreToolUse": [
      {
        "matcher": "Bash",
        "command": "echo 'Ejecutando: $TOOL_INPUT' >> .claude/audit.log"
      }
    ]
  }
}

Casos de uso practicos:

• Post-Edit: ejecutar eslint/ruff automaticamente despues de cada edicion.
• Post-Edit: correr tests relacionados con el fichero modificado.
• Pre-Bash: loggear cada comando que Claude Code intenta ejecutar.
• Post-Write: formatear ficheros nuevos con prettier/black.

Los hooks convierten a Claude Code en un developer que sigue tus convenciones automaticamente: formatea, testea y loggea sin que tengas que pedirlo.

Subagentes: dividir para conquistar

Claude Code puede lanzar subagentes, cada uno con contexto aislado y un rol especifico. Hay 5 tipos principales:

• Explore: analiza el codebase, entiende la arquitectura, identifica patrones. No modifica nada.
• Plan: recibe el analisis de Explore y genera un plan de accion detallado con pasos numerados.
• Builder: ejecuta el plan. Edita ficheros, crea nuevos, corre tests.
• Investigator: busca en documentacion, APIs, logs. Responde preguntas especificas.
• General-purpose: tareas que no encajan en los anteriores.

# Pipeline tipico de subagentes
# 1. Explore: "Analiza la estructura de autenticacion del proyecto"
#    Output: diagrama de flujo, ficheros relevantes, dependencias

# 2. Plan: "Dado este analisis, planifica migrar de JWT custom a Auth.js"
#    Output: 8 pasos, ficheros a modificar, orden de ejecucion

# 3. Builder: "Ejecuta los pasos 1-3 del plan"
#    Output: ficheros editados, tests corriendo

# 4. Builder: "Ejecuta los pasos 4-8"
#    Output: migracion completa, tests pasando

# Cada subagente tiene su propio contexto:
# - No ve el historial de los otros
# - Recibe solo la informacion que necesita
# - Devuelve un resultado estructurado

Worktrees y aislamiento

Un worktree es una copia de trabajo independiente del mismo repositorio Git. Permite que un agente trabaje en una rama sin afectar tu rama actual.

# Crear worktree para refactoring
git worktree add ../mi-proyecto-refactor feature/auth-migration

# Claude Code trabaja en el worktree
cd ../mi-proyecto-refactor
claude "Ejecuta el plan de migracion de auth"

# Si funciona: merge
git checkout main
git merge feature/auth-migration

# Si no funciona: descartar sin riesgo
git worktree remove ../mi-proyecto-refactor
git branch -D feature/auth-migration

Cuando usar worktrees:

• Si: refactors grandes, cambios de arquitectura, experimentos, migraciones.
• No: fixes rapidos, cambios de 1-2 ficheros, hotfixes urgentes.

La ventaja principal: si el agente se equivoca en un refactoring grande, solo descartas el worktree. Tu rama principal no se ha tocado.

CI/CD headless y pipelines multi-agente

Claude Code funciona sin interaccion humana, ideal para CI/CD. Los flags clave:

# Ejecucion headless en GitHub Actions
- name: Code review automatizado
  run: |
    claude --print \
      --allowedTools "Read,Grep,Glob" \
      --output-format json \
      "Revisa los cambios en este PR. Busca bugs, security issues, y
       violaciones de estilo. Output JSON con severity y fichero."
  env:
    ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

# Pipeline de 4 agentes secuenciales
# Paso 1: Analisis de impacto
claude --print --allowedTools "Read,Grep,Glob" \
  "Analiza que ficheros se ven afectados por el cambio en src/auth/"

# Paso 2: Generacion de tests
claude --print --allowedTools "Read,Write" \
  "Genera tests para los cambios detectados en el paso anterior"

# Paso 3: Ejecucion de tests
claude --print --allowedTools "Bash" \
  "Ejecuta pytest y reporta resultados"

# Paso 4: Documentacion
claude --print --allowedTools "Read,Write" \
  "Actualiza CHANGELOG.md con los cambios de este PR"

Skills custom permiten definir comandos reutilizables:

# .claude/skills/deploy.md
## /deploy
Pasos:
1. Correr tests: `pytest -v`
2. Build: `npm run build`
3. Deploy: `./scripts/deploy.sh`
4. Verificar: `curl -f https://mi-app.com/health`
5. Notificar: "Deploy completado" via webhook

Si algun paso falla, detener y reportar el error.

Un pipeline de agentes bien configurado convierte cada PR en una revision automatica completa: analisis, tests, documentacion. El developer humano solo revisa y aprueba.