Usar Claude Code como editor principal es un skill
Hay dos tipos de personas que usan Claude Code: las que lo usan como un buscador glorificado ("¿cómo hago un forEach en JavaScript?") y las que lo usan como un copiloto de verdad que entiende su proyecto completo y trabaja con autonomía. La diferencia está en los workflows.
1. El workflow de "nueva feature completa"
En lugar de pedir código pieza por pieza, dale a Claude Code el contexto completo y déjalo implementar la feature entera:
Implementa la funcionalidad de "exportar facturas a PDF".
Los requisitos son:
- Botón en la vista de detalle de factura
- Genera un PDF con el diseño de la empresa (ver src/templates/invoice.html)
- El nombre del archivo debe ser: factura-{numero}-{fecha}.pdf
- Debe funcionar en móvil también
Asegúrate de que los tests pasan después.
Claude Code explorará los archivos relevantes, entenderá el contexto y te entregará la implementación completa.
2. El workflow de debugging con contexto de producción
Cuando tienes un bug en producción, pégale los logs directamente:
Tengo este error en producción desde hace 2 horas:
[PEGA LOS LOGS COMPLETOS]
El problema ocurre solo con usuarios que tienen más de 1000 facturas.
Analiza el código y encuentra la causa raíz.
3. El workflow de "hazme la PR"
Claude Code puede gestionar el ciclo completo: implementar, testear, hacer commit con mensaje descriptivo y preparar el branch:
Implementa el validador de IVA español para el formulario de facturas.
Cuando termines:
1. Ejecuta los tests para confirmar que todo pasa
2. Haz commit con un mensaje descriptivo siguiendo nuestro formato
3. Dime exactamente qué cambios se hicieron y por qué
4. El workflow de exploración de codebase desconocido
Cuando entras a un proyecto nuevo o un repo que no conoces:
Eres nuevo en este proyecto. Explora la estructura completa y explícame:
1. Qué hace esta aplicación
2. Cómo está organizado el código
3. Cuáles son las partes más complejas o críticas
4. Qué stack tecnológico usa y por qué parece que se eligió ese stack
5. Qué debería saber alguien que va a trabajar en este proyecto
5. El workflow de refactoring seguro
Antes de tocar código legacy, establece el contrato:
Necesito refactorizar src/lib/payments.ts.
IMPORTANTE: No cambies los tests existentes ni las interfaces públicas.
El objetivo es solo mejorar la legibilidad interna.
Haz los cambios de forma incremental y verifica después de cada paso que los tests siguen en verde.
6. El workflow de revisión de código antes de PR
Úsalo como reviewer antes de pedir review a tus compañeros:
Revisa todos los archivos que modifiqué en esta sesión como si fueras a hacer code review.
Busca: bugs, problemas de seguridad, mejoras de performance y violaciones de las convenciones del proyecto.
Sé crítico.
7. El workflow de "explícame este código"
Para entender código complejo antes de modificarlo:
Lee src/lib/cache/invalidation.ts y explícame:
1. Qué problema resuelve
2. Cómo funciona paso a paso
3. Qué pasa si el Redis está caído
4. Dónde podría romperse bajo carga alta
8. El workflow de migración tecnológica
Para actualizar dependencias mayores o cambiar de tecnología:
Necesito migrar de React Router v5 a v6.
Antes de tocar nada:
1. Analiza todos los archivos afectados
2. Lista los breaking changes que impactan nuestro código específicamente
3. Propón un plan de migración archivo por archivo
4. Identifica qué puede romperse y cómo probarlo
9. El workflow de generación de contenido técnico
Para documentación y READMEs:
Genera el README.md completo del proyecto.
Incluye: descripción, prerequisitos, instalación, configuración de variables de entorno,
cómo correr en desarrollo, cómo hacer deploy, y guía de contribución.
Usa ejemplos reales del código del proyecto, no genéricos.
10. El workflow de "Claude Code como tutor"
Para aprender mientras construyes:
Implementa la autenticación con JWT, pero explícame cada decisión mientras lo haces:
- Por qué guardas el token donde lo guardas
- Por qué usas esa librería y no otra
- Qué vulnerabilidades resuelve este approach y cuáles no
Quiero entender el "por qué", no solo el "cómo".
El factor común de todos estos workflows
¿Ves el patrón? En todos los casos le das contexto suficiente y un objetivo claro. Claude Code es increíblemente capaz, pero funciona mejor cuando sabe exactamente qué quieres conseguir y cuáles son las restricciones. Cuanto más específico seas, menos correcciones tendrás que hacer.