El flujo de trabajo de Claude Code que puedes copiar
Este es el flujo de trabajo que uso cuando quiero código útil rápido sin crear un desastre del que me arrepentiré después. Es opinado, repetible y está construido alrededor de las fortalezas de Claude Code (agentes, bucles de retroalimentación cortos, diffs limpios).
¿No eres miembro de Medium? Sigue leyendo gratis haciendo clic aquí.
0) Configuración única
/docs/01-scope.md # fuente única de verdad para objetivos y restricciones
/docs/02-decisions.md # registro de decisiones de arquitectura (estilo ADR, <10 puntos)
/docs/03-tasks.md # lista de tareas en ejecución con casillas de verificación
/PLAYBOOK.md # “cómo funciona este proyecto” para yo-futuro / equipo
/CONTEXT.md # resumen comprimido que Claude lee primero
/src/ # código
/tests/ # pruebas (incluso si son básicas)
/scripts/ # utilidades puntuales (seed, migrate, import)
Mantén CONTEXT.md pequeño (≤ 200 líneas). Describe módulos, formas de datos, APIs y no negociables. Actualízalo después de cada hito.
1) Crea cinco agentes enfocados
En Claude Code: claude update → /agents.
Crea estos una vez; reutilízalos en todas partes:
mvp-planner
Rol: Convierte un objetivo vago en un MVP con un alcance claro.
Siempre genera:
- Lista “NO construiremos”
- Riesgos con mitigaciones
- Backlog JSON [{id, title, acceptance}]
ui-stylist
Rol: Rediseña componentes a un conjunto de tokens de diseño (tipografía, espaciado, color).
Restricciones: sin cambios de biblioteca sin aprobación; devuelve solo un diff de parche.
bug-fixer
Rol: Reproduce, escribe una prueba fallida, corrige y devuelve un parche mínimo.
Siempre incluye la causa raíz en 1–2 oraciones.
modular-architect
Rol: Propone estructura de directorios, límites e interfaces.
Genera un mapa de módulos ASCII + razones para cada límite.
reviewer-readonly
Rol: Revisión de código SIN ediciones.
Devuelve: comentarios en línea, clasificación de riesgo (Alto/Medio/Bajo) y una decisión “merge/no-merge”.
Claude enrutará automáticamente a estos cuando tu prompt coincida. Si no, llama al agente explícitamente.
El bucle de construcción de 35 minutos
Ejecuta este bucle hasta que envíes. No lo extiendas. La restricción mantiene la calidad alta.
Minuto 0–5 — Encuadre
- Edita
/docs/01-scope.md(qué hacemos a continuación, aceptación). - Actualiza
/CONTEXT.mdsi la estructura cambió.
Minuto 5–20 — Construcción
- Solicita a Claude una tarea atómica (ver plantillas abajo).
- Pide diff de parche, no prosa.
- Si obtienes ruido, pide el mismo parche pero más pequeño (“toca máximo 3 archivos”).
Minuto 20–30 — Prueba
- Solicita primero una prueba fallida, luego una corrección.
- Ejecuta localmente, mantén registros, reduce el alcance si es necesario.
Minuto 30–35 — Commit y comprime
- Commit:
feat: add invoice export (csv) - Añade una línea a
/docs/02-decisions.mdsi ocurrió una decisión. - Reescribe deltas de
/CONTEXT.md(mantenlo bajo 200 líneas).
Repite.
3) Plantillas de prompt que realmente funcionan
A. Nueva característica (atómica)
Objetivo: [una oración]
Restricciones: [stack, bibliotecas, patrones que deben permanecer]
Presupuesto de toque: máximo 3 archivos
Devuelve: DIFF DE PARCHE unificado solo + breve justificación (≤3 puntos)
Usa CONTEXT.md para preservar la arquitectura.
B. Pase de estilo (sin cambios de lógica)
Aplica tokens de diseño (escala de fuente, espaciado, radio).
Sin ediciones de comportamiento JS.
Devuelve diff de parche solo para .tsx/.css.
Si faltan tokens, crea tokens.ts y refactoriza para usarlo.
C. Corrección de bug con barandillas de seguridad
Reproduce el bug: [pasos]
Escribe la prueba fallida primero en /tests/[name].spec.ts.
Luego propón la corrección más pequeña.
Devuelve: diff de prueba + diff de código.
Explica la causa raíz en 2 oraciones.
D. Recuperación de respuesta “demasiado grande”
Tu parche es demasiado grande. Divídelo en parches secuenciales de ≤50 líneas cada uno.
Devuelve solo PARCHE 1 ahora. Aplicaré y pediré PARCHE 2.
4) Cuando te atascas, usa la Escalera de Atasco (en orden)
- Estrecha la pregunta (un archivo, una función).
- Añade un ejemplo concreto (JSON entrada/salida).
- Duplica la página y reformula el prompt (un contexto fresco a menudo enruta el agente correcto).
- Cambia la persona (llama a
modular-architectpara remodelar antes de codificar). - Reduce el área de superficie (feature flag, envía un corte más pequeño).
Si aún estás atascado después de 20 minutos, estás resolviendo el problema equivocado. Vuelve a /docs/01-scope.md.
5) Escalado a bases de código grandes
- Comprime primero. Mantén
/CONTEXT.mdactualizado; pide a Claude que lo regenere cuando los módulos cambien: Resumir repo por módulos, interfaces públicas, contratos de datos. ≤ 180 líneas. Destaca puntos de acoplamiento. Salida a CONTEXT.md (sobrescribir).- Trabaja en cortes. “Solo toca /src/billing/*.” Claude respeta límites cuando los declaras.
- Refactores por lotes. Bloquea la lógica, ejecuta cambios del ui-stylist o linting como parches separados para evitar diffs ruidosos.
- Indexa puntos calientes. Mantén una lista corta en la parte superior de
/CONTEXT.md: “Aquí hay dragones” con rutas de archivo.
6) Ritual de envío
- El agente reviewer-readonly debe decir “merge” (sin ediciones).
- Las pruebas se ejecutan localmente (incluso si son mínimas).
- Docs actualizado (una línea en decisiones + cualquier cambio de forma de API).
- Nota de lanzamiento (3 puntos: qué cambió, riesgo, reversión).
7) Ejemplo: característica desde cero
Breve: “Exportar facturas a CSV con filtros.”
Inicio
- Alcance: añadir botón “Exportar CSV”, filtrar por fecha/estado, trabajo finaliza.
- modular-architect: añade módulo
/src/exportcon interfaz. - Prompt de característica (atómica): devuelve parche para servicio + controlador + botón stub.
- bug-fixer: escribe prueba fallida para caso extremo de zona horaria, luego parche.
- Commit, línea de decisiones: “CSV usa UTC; la pantalla convierte a local.”
8) FAQ en una línea
- ¿Por qué diffs de parche? Anclan a Claude para cambiar menos, así obtienes ediciones más seguras. Aquí hay un ejemplo. Esta es también la razón por la que una herramienta como v0 o ChatGPT es más lenta para codificar con IA ya que siempre regeneran el archivo completo.
- ¿Por qué CONTEXT.md? Es la barandilla. Claude lo lee; tú lo mantienes.
- ¿Por qué 35 minutos? Tiempo suficiente para terminar un corte, tiempo suficiente para evitar expansión de alcance. Si no puedes enviar características a un ritmo regular, tu alcance es demasiado grande.
- ¿Por qué cinco agentes? Más agentes no equivale a más velocidad. Estos cinco cubren el 95% del trabajo. Descubrí que si tienes demasiados no enrutaba al correcto.
9) Paquete de inicio copiar-pegar
Añade esto al inicio de cada sesión de Claude:
Reglas de la casa:
- Devuelve diffs de parche, no prosa.
- Respeta restricciones de /CONTEXT.md.
- Si no estás seguro, propón 2 opciones con compensaciones (≤80 palabras).
- Mantén cambios quirúrgicos: máximo 3 archivos a menos que expanda el alcance.
- Si más de 3 archivos, dime por qué y qué
Primer mensaje en un nuevo proyecto:
Lee CONTEXT.md y 01-scope.md.
Propón un plan MVP claro con un backlog JSON.
Lista qué NO construiremos.
Luego espera.
Me gusta decir lista qué no construiremos.
Esto es todo. Mantén los docs pequeños, mantén las tareas atómicas, exige diffs de parche y deja que los agentes hagan los trabajos para los que los contrataste.
Antes de irte
- Ahora tengo un Substack y es una excelente manera de conectar. Publico una pieza única a la semana allí cada domingo, hora de Nueva Zelanda. ¡Únete!
[
Publicado en Realworld AI Use Cases
Última publicación hace 1 díaQuería tener una publicación que ayudara a compartir consejos y trucos de mi consultoría donde implementamos IA para empresas como el equipo olímpico, la Bolsa de Valores y otras empresas B2C.
[
Escrito por Chris Dunlop
Te ayudaré a programar con IA. Consejos de Cursor y Estrategia Empresarial. Dirijo una empresa que hace IA para los All Blacks, el Equipo Olímpico y la Bolsa de Valores www.cubdigital.co.nz