Tu primera tarea real

Esta es la lección práctica del curso. Al terminar habrás cerrado una tarea real sobre un repo tuyo, con su diff revisado y aceptado — el artefacto de la intro. Sigue los pasos con tu proyecto abierto de verdad; leerlo sin hacerlo no cuenta.

Paso 1 · Abre un repo real

Nada de carpetas vacías ni proyectos de ejemplo:

cd ~/proyectos/mi-repo
claude

(En el IDE o la app, abre la carpeta de tu proyecto.) El agente necesita código real donde leer, ejecutar y proponer cambios. Es ahí donde se aprende.

Paso 2 · Pide UNA tarea concreta

El error más común al empezar es pedir algo enorme y vago. Compara:

Mal — el agente no sabe cuándo ha terminado:

"Mejora este proyecto."

Bien — acotado y verificable:

"Añade un script check en package.json que ejecute tsc --noEmit && eslint .. Si alguno falla, debe devolver exit code distinto de cero."

Regla: una tarea con un final claro. Si no sabrías decir "esto ya está", el agente tampoco.

Paso 3 · Observa el agent loop en directo

Recuerda el bucle de la lección 1. Con la tarea del script, probablemente verás:

1. Lee package.json para ver los scripts actuales.
2. Quizá busca tu config de ESLint para no romperla.
3. Propone un diff: la línea nueva en "scripts". Te lo enseña y espera tu OK.
4. Tras aceptar, ejecuta npm run check y te muestra la salida.

Si al principio te pide confirmación hasta para leer ficheros, es lo correcto: aún no le has dado permisos (eso lo configuras en el curso Permisos, settings y seguridad). De momento, apruébalo a mano.

Paso 4 · Lee el diff antes de aceptar

Este es el único paso que no puedes delegar. Cuando te muestre el cambio, pregúntate:

• ¿Toca lo que esperaba (solo package.json)?
• ¿No se ha llevado por delante otro script ni otra cosa?
• ¿El comando es el que pedí?

Un diff típico se ve así:

  "scripts": {
    "dev": "next dev",
    "build": "next build",
+   "check": "tsc --noEmit && eslint ."
  },

Si está bien, aceptas. Si no, lo rechazas o le pides el ajuste ("no, usa eslint . --max-warnings 0"). Tú conduces.

Paso 5 · Confirma que funciona

Deja que ejecute npm run check (o hazlo tú). Cuando el script exista y corra, acabas de cerrar tu primera tarea real. Ese es el artefacto del curso.

Buen hábito desde el minuto uno: si todo está correcto, haz un commit. git commit -m "chore: add check script". Cada cosa que funciona es un checkpoint gratis al que volver.

Tu turno

Antes de seguir, cierra una segunda tarea tú solo, sin guion. Ideas pequeñas y verificables sobre tu repo:

• "Añade un .editorconfig con 2 espacios de indentación."
• "Crea un script format que ejecute Prettier sobre src/."
• "Añade un badge de build al README."

Pídela, lee el diff, acéptala, commitea. Repetir el ciclo es lo que lo vuelve natural.

Qué llevas hasta aquí

• Sabes abrir un repo real y pedir una tarea acotada y verificable.
• Has visto el agent loop en directo y has leído un diff antes de aceptar.
• Tienes el hábito de commitear lo que funciona.

En la siguiente lección afinamos cómo dirigir al agente: comandos, rechazar y ajustar cambios, y deshacer cuando algo no sale.

Fuente oficial: Quickstart · Common workflows