CLAUDE CODE: Curso Avanzado para DEV e Ingenieros

El README del laboratorio tiene tres líneas (“Sistema interno de gestión de incidentes. Preguntar a Marcos antes de tocar el deploy.”) y va a seguir así a propósito: es el repo con el que llegas un lunes a una empresa nueva, y es el punto de partida del Nivel 1. Por eso esta guía vive acá y no en el repo: si estuviera en el README, el agente la leería y el Nivel 1 dejaría de ser “un sistema que no conoce”. Esta guía dice qué se hace en cada nivel, con qué prompts, qué ejecutar y qué tiene que quedar funcionando para darlo por cumplido.

El laboratorio

No es una app de juguete. Es un repo como los de verdad: una API (FastAPI), un worker que procesa cola, Postgres, Docker, tests, CI en GitHub Actions y la infraestructura en Terraform (GCP + Cloudflare). Tiene deuda técnica, bugs plantados y una bandeja de issues abiertos, porque los repos de verdad también los tienen.

El curso sigue un solo hilo: el agente entra sin conocer nada (Nivel 1) y termina resolviendo el issue #27 de punta a punta, en producción, sin nadie en el teclado (Capstone). Cada nivel le suelta más la correa y sube el control en la misma proporción. Más autonomía sin más control no es ingeniería.

Cómo usar esta guía: pausa el video en cada nivel, copia el prompt desde acá y córrelo en tu clon. Los prompts son los mismos del video, sin cambios. Lo que te salga va a variar un poco corrida a corrida; lo que se repite en cada corrida está anotado como “resultado esperado”.

Antes de empezar

Requisitos:

• Claude Code en su última versión. Todo el curso corre en el modelo Sonnet (el del plan Pro). Se sube de modelo solo en dos momentos marcados, y es opcional.
• Python 3.11 o superior.
• Docker (stack local: API, worker y Postgres).
• Terraform, gcloud y una cuenta de Cloudflare solo si vas a hacer la parte de infraestructura (Nivel 4 en adelante). Esas partes crean recursos reales en la nube y tienen costo. El runbook explica qué crear y qué destruir.
• Un fork de este repo si quieres ver correr el camino automático (Nivel 6 y Capstone): los workflows necesitan secretos y permisos tuyos.

Arranque:

# instalación de Claude Code (oficial, verificado 24-sep-2026 en code.claude.com/docs/en/setup)
# macOS, Linux y WSL:
curl -fsSL https://claude.ai/install.sh | bash
# Windows PowerShell:  irm https://claude.ai/install.ps1 | iex
claude --version
git clone https://github.com/agentic-engineers/incident-system.git
cd incident-system
claude

Lo primero que aparece es la pregunta de confianza sobre la carpeta. Responde que sí: este repo lo bajaste tú y sabes qué es. Graba el reflejo, igual: un agente que puede leer, editar y ejecutar en tu máquina, y lo primero que hace es preguntar. Después, /model y elige Sonnet.

Stack local y tests. No hay venv commiteado, así que pytest a secas falla. Eso es a propósito: es la lección del Nivel 3.

docker compose -f deploy/compose/docker-compose.yml up -d
python3 -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
PYTHONPATH=. pytest tests/unit -q          # lo que gatea el PR en CI
PYTHONPATH=. pytest tests/concurrency -v   # requiere Postgres arriba

El curso completo se hace en modo manual: cada acción que toca tu sistema te pregunta, y tú apruebas. Si tu Claude Code arranca en auto mode, cambia con Shift+Tab hasta ver “manual”. El auto mode se explica en el Nivel 7.

Qué hay en el repo

app/            API (FastAPI), worker, dominio (dedup), adaptadores GCP y Cloudflare, CLI
tests/          suite unitaria y de concurrencia
deploy/         Dockerfile y docker-compose del stack local
infra/          Terraform: staging y producción de laboratorio (Cloud Run, Cloud SQL, VM, DNS)
.github/        workflows: pr, clasificador, deploy-staging, promote-production
runbooks/       deploy.md y worker.md (así están escritos "hace cuatro años", a propósito)
docs/issues/    los issues del curso en texto: #12, #15 y #27
scripts/        legacy_import.py (el importador que nadie toca sin hablar con Marcos)

Los issues del curso viven en la pestaña Issues:

El label agente es el disparador del camino automático. En tu fork, etiquetar un issue con agente corre el clasificador y, si el issue es elegible, la implementación. Sin secretos configurados, el workflow falla; está documentado en runbooks/deploy.md.