Runbook de primera tarea en Claude Code: 7 tareas seguras para ganar confianza rápido

La primera tarea decide si confiarás en Claude Code

Después de instalar Claude Code, no conviene pedirle que construya una función completa. La primera tarea debe ser pequeña, local, verificable y fácil de revertir.

Este runbook continúa la guía de inicio. Si también quieres fijar reglas de trabajo, combínalo con las plantillas de CLAUDE.md.

Qué tiene una buena primera tarea

Regla	Por qué importa
Local	No toca producción ni servicios externos
Acotada	No se convierte en todo el proyecto
Verificable	Se valida con diff, build o test
Reversible	Si sale mal, se puede deshacer rápido

7 tareas seguras para empezar

1. Pídele que lea el repo antes de editar

Lee este repo y dime:
1. puntos de entrada principales
2. comandos habituales
3. directorios de riesgo
4. primer archivo pequeño que sería seguro cambiar

Primero compruebas comprensión; después autorizas cambios.

2. Resume un test fallido o un error visible

git status --short
npm.cmd run test

Pide causa probable, punto de fallo y siguiente acción mínima.

3. Solicita un plan de refactor pequeño

Inspecciona este archivo y propone el refactor más pequeño que mejore claridad
sin cambiar comportamiento. Devuelve plan, líneas tocadas, riesgos y verificación.
No edites todavía.

Si el plan es débil, paras antes de romper código.

4. Añade una assertion a un test existente

Es pequeño, medible y revela si Claude Code entiende la intención.

5. Convierte un bug vago en una nota reproducible

Antes de pedir una corrección, usa la plantilla de bug report para escribir condiciones reales.

6. Crea un CLAUDE.md mínimo

# CLAUDE.md
- stack: Astro + TypeScript
- commands: npm.cmd run build
- do not touch: .env, dist, generated exports
- output preference: explicar plan antes de editar varios archivos

Una regla pequeña mejora todas las sesiones posteriores.

7. Deja una nota de handoff

El primer éxito no siempre es un patch. También puede ser una sesión que otra persona pueda continuar sin perder contexto.

Errores que debes evitar

No empieces con deploy a producción, push, envíos externos o una reescritura total. La primera tarea debe terminar localmente y verificarse con un comando.

Siguiente paso

Guarda comandos en el cheatsheet gratuito. Si el bloqueo está en setup, permisos o CLAUDE.md, revisa la Setup Guide. Para diseñar adopción en equipo, ve a consultoría.

Qué revisar al terminar la tarea

La primera tarea sirve para decidir si Claude Code merece más autonomía. Al cerrar, revisa archivos modificados, comando de verificación, riesgos pendientes y la siguiente tarea mínima. Sin esa revisión no sabes si el éxito fue repetible o solo suerte.

Revisa esta tarea:
1. archivos realmente modificados
2. comandos que confirmaron éxito
3. riesgos aún no verificados
4. siguiente tarea mínima segura
5. pasos para revertir si hace falta

Una buena primera sesión no es la que produce el diff más grande. Es la que deja más claro el próximo juicio. Si solo añadió una assertion pero la verificación es sólida, está bien. Si cambió muchos archivos y nadie puede probar el resultado, la siguiente sesión debe volver a un alcance pequeño.