Operaciones de Archivos

Claude Puede Cambiar Tus Archivos

🔄 Repaso rápido: En la lección anterior, aprendimos a orquestar tareas complejas dividiéndolas en pasos verificables. Ahora vamos a aplicar esa orquestación a las operaciones de archivos — donde Claude realmente toca tu código.

Esto es poderoso. También es una responsabilidad.

Claude Code puede crear archivos, editar archivos, borrar archivos. Bien hecho, es un boost brutal de productividad. Hecho sin cuidado, puedes hacer un desastre.

Esta lección te enseña a trabajar con archivos de forma segura y eficiente.

La Red de Seguridad: Git

Antes de cualquier trabajo significativo con Claude, asegúrate de:

1. Directorio de trabajo limpio

   git status  # Debería estar limpio o con commit hecho
   

2. Saber en qué rama estás

   git branch  # Saber dónde estás parado
   

3. Hacer commit seguido Después de buenos cambios, commit. Si algo sale mal, siempre puedes regresar.

Git es tu red de seguridad. Con él, cualquier error de Claude es recuperable.

Patrones de Operaciones de Archivos

Crear Archivos Nuevos

> Crea un archivo de utilidades en src/utils/string-helpers.js
> Incluye funciones para: capitalize, truncate, slugify

Claude crea el archivo con contenido. Revisa antes de continuar.

Para múltiples archivos relacionados:

> Crea los siguientes archivos para una nueva feature de "comentarios":
> - src/models/comment.js (modelo de datos)
> - src/services/comment-service.js (lógica de negocio)
> - src/routes/comments.js (rutas de API)
> - tests/comments.test.js (esqueleto de tests)

Archivos relacionados creados juntos tienden a ser consistentes.

Editar Archivos Existentes

Siempre agrega el archivo primero:

/add src/auth/login.js
> Agrega rate limiting a la función de login. Máximo 5 intentos por minuto.

Claude ve el archivo, entiende el contexto, hace cambios dirigidos.

Sé específico sobre qué cambiar:

> En la función handleSubmit, agrega validación antes de la llamada a la API.
> Verifica que el email tenga formato válido y el password tenga al menos 8 caracteres.

Instrucciones específicas → cambios precisos.

Ediciones Multi-Archivo

Para cambios coordinados entre archivos:

/add src/types/user.ts src/services/user-service.ts src/routes/users.ts
> Agrega un campo opcional "phoneNumber" al tipo User.
> Actualiza el servicio y las rutas para manejarlo.

Todos los archivos relevantes en contexto → cambios consistentes entre ellos.

✅ Revisión Rápida: ¿Por qué es importante agregar TODOS los archivos relacionados al contexto antes de pedir una edición multi-archivo?

Renombrar y Mover

> Renombra src/utils/helpers.js a src/utils/string-utils.js
> Actualiza todos los import statements en todo el codebase.

Claude maneja tanto el rename como las actualizaciones de imports.

Borrar Archivos

> El directorio src/old-auth/ ya no se usa.
> Elimínalo y limpia cualquier referencia.

Sé explícito sobre qué borrar. Claude pedirá confirmación en operaciones destructivas.

Estrategias de Revisión

Revisión Inline

Después de cada cambio, revisa antes de continuar:

> Agrega validación de inputs a la función createUser

# Claude hace los cambios

> Muéstrame el diff

# Revisas los cambios

> Bien. Ahora agrega tests para la validación.

Revisión con Git Diff

Después de que Claude haga cambios:

git diff src/auth/login.js  # Ver exactamente qué cambió

Git diff frecuentemente es más claro que la revisión inline para cambios complejos.

Revisión por Etapas

Para cambios grandes:

> Haz los cambios para implementar la feature X

# Claude hace muchos cambios

git add -p  # Stagear cambios interactivamente
git commit -m "Parte 1: cambios de modelo"

# Continúa stageando
git add -p
git commit -m "Parte 2: capa de servicios"

Revisa y haz commit en chunks lógicos.

Procedimientos de Recuperación

/undo

Deshacer inmediatamente el último cambio de Claude:

/undo

Úsalo cuando veas un cambio no deseado. Funciona mejor antes de que hayas continuado.

Git Reset

Si no has hecho commit:

git checkout -- src/archivo-que-se-arruino.js

Restaura el archivo al último estado commiteado.

Stash y Empezar de Nuevo

Si las cosas están revueltas:

git stash  # Guarda cambios actuales
# Empieza fresco con Claude
git stash pop  # Trae de vuelta los cambios si los necesitas

Reset Completo

Opción nuclear (solo cambios no commiteados):

git reset --hard HEAD

De vuelta al último commit. Úsalo con moderación.

Técnicas de Eficiencia

Agrupar Cambios Relacionados

Lento:

> Agrega campo "createdAt" al modelo User
> Ahora agrega campo "updatedAt" al modelo User
> Ahora agrega campo "lastLoginAt" al modelo User

Rápido:

> Agrega campos de timestamp al modelo User:
> - createdAt: cuándo se creó el usuario
> - updatedAt: cuándo se modificó por última vez
> - lastLoginAt: cuándo hizo login por última vez

Un pedido para cambios relacionados.

Creación Basada en Template

> Crea 5 nuevos archivos de rutas de API siguiendo el patrón
> de src/routes/users.js:
> - products.js
> - orders.js
> - inventory.js
> - categories.js
> - suppliers.js

Claude replica patrones eficientemente.

Operaciones en Lote

> En todos los archivos que matcheen src/services/*.js:
> - Agrega logging de errores a los bloques catch
> - Usa el logger de src/utils/logger.js

Cambios masivos basados en patrones.

Checklist de Operaciones de Archivos

Antes de operaciones de archivos:

• Directorio de trabajo de git limpio (o cambios stasheados)
• Archivos relevantes agregados al contexto
• Tarea suficientemente específica para obtener los cambios correctos

Durante operaciones de archivos:

• Revisar cambios antes de continuar
• Usar /undo inmediatamente si algo anda mal
• Hacer commit de grupos lógicos de cambios

Después de operaciones de archivos:

• Revisar diff completo con git diff
• Correr tests si aplica
• Commit con mensaje claro

Conclusiones Clave

• Git es tu red de seguridad — haz commit seguido, revierte fácilmente
• Siempre agrega archivos al contexto antes de pedir cambios
• Sé específico sobre qué cambiar y dónde
• Revisa los cambios antes de continuar
• Usa /undo y git para recuperación
• Agrupa cambios relacionados para eficiencia

Lo que sigue: integrar comandos Bash para automatización poderosa.

Siguiente: En la próxima lección, nos sumergiremos en la Integración con Bash.