En pocas palabras: Organizá Claude Code por velocidad de cambio, no por tema: un archivo CLAUDE.md como mapa central que se carga en cada sesión, tres capas (Context estable, Projects activo, Operations fechado) y cada tarea repetida convertida en un skill reutilizable. Eso elimina prompts correctivos por sesión.
¿Cómo organizar Claude Code para trabajo de producto? La respuesta corta: dejá de ordenar por tema y ordená por velocidad de cambio. Poné un archivo CLAUDE.md como mapa central, separá lo estable de lo activo y lo fechado, y convertí cada tarea repetida en un skill. Eso te ahorra horas de prompts correctivos por sesión.
Claude Code es la herramienta de línea de comandos de Anthropic que corre en tu terminal y trabaja directo sobre tu repositorio: lee archivos, edita código, ejecuta comandos y mantiene contexto del proyecto entre sesiones. Para trabajo de producto (no solo código), lo clave no es el modelo sino cómo estructurás el conocimiento que le das. Un workspace ordenado hace que el asistente arranque cada sesión sabiendo dónde está parado.
En 30 segundos
- CLAUDE.md es el mapa: se carga en cada sesión y documenta las reglas que siempre aplican, así no repetís instrucciones.
- Ordená por velocidad de cambio: Context (estable), Projects (activo), Operations (fechado). No por temática.
- Los verbos son skills: revisar, sintetizar, dar feedback van como skills ejecutables; los sustantivos (archivos, hechos) van como contexto.
- MCPs para lo que cambia cada hora: Jira, Slack o Confluence conectados en vivo evitan que el contexto quede viejo.
- Archivá al final de cada sesión: dos minutos de “filing” convierten una corrección puntual en conocimiento permanente.
¿Qué es CLAUDE.md y por qué es el mapa central de tu proyecto?
CLAUDE.md es un archivo de texto que Claude Code carga en cada sesión antes de hacer nada. Ahí van las reglas que siempre aplican: qué hace el producto, cómo está armado el workspace, qué convenciones seguir, qué evitar. Actúa como el mapa de navegación del proyecto.
La gracia es simple. Todo lo que ponés ahí, no lo tenés que volver a explicar. Si cada vez que abrís una sesión repetís “el producto es un SaaS de facturación, el tono es formal, no toques la carpeta de legacy”, estás perdiendo tiempo (y tokens). Eso va una sola vez en el CLAUDE.md y listo. Más contexto en la guía completa de Claude.
Según las mejores prácticas oficiales de Claude Code, conviene que este archivo sea chico y quirúrgico. No es un manual de 40 páginas. Es un índice: qué hay, dónde está, qué reglas mandan. Si le metés todo el detalle adentro, se vuelve ruido y el asistente lo lee peor. Un buen CLAUDE.md apunta a los archivos de contexto, no los reemplaza.
¿Cómo organizar Claude Code por velocidad de cambio y no por tema?
La metodología central es organizar el workspace por tasa de cambio, en tres velocidades. Ponele que arrancás un proyecto de producto: en vez de carpetas por temática (marketing, ingeniería, diseño), hacés tres grupos según cada cuánto cambia la información. Lo que casi nunca cambia va junto. Lo que cambia todos los días, aparte.
¿Por qué la velocidad y no el tema? Porque el tema mezcla cosas estables con cosas que caducan. Una carpeta “producto” termina teniendo la definición del producto (que dura meses) al lado de la nota de la reunión del martes (que caduca el miércoles). Cuando el asistente lee eso, no sabe qué sigue vigente.
| Capa | Velocidad de cambio | Qué guardás acá |
|---|---|---|
| Context | Estable (meses) | Hechos del producto, segmentos de usuarios, documentación de referencia |
| Projects | Media (semanas) | Trabajo activo, specs, entregables en curso |
| Operations | Fechada (días/horas) | Notas de reuniones, status con timestamp, decisiones del día |
Eso sí: la capa Operations siempre lleva fecha en el nombre. Las otras dos, nunca. Si le ponés timestamp a la definición del producto, en tres meses vas a tener cinco versiones fechadas y ninguna que parezca “la buena”. El truco es que la fecha señala “esto es de un momento”, y los hechos estables no son de un momento.
¿Cuáles son las 6 prácticas para mantener Claude Code ordenado?
Son seis hábitos que sostienen el sistema en el tiempo. Ninguno es complicado. El problema es que se abandonan la primera semana ocupada, y ahí el workspace empieza a pudrirse. Cubrimos ese tema en detalle en nuestra guía sobre cuál modelo elegir.
- Usá un solo workspace para todo: un directorio raíz donde vive el proyecto entero, no diez carpetas sueltas por el disco.
- Clasificá por velocidad de cambio: Context, Projects, Operations. La regla de oro de todo el sistema.
- Mantené un archivo mapa chico: el CLAUDE.md apunta a dónde está cada cosa, sin duplicar el contenido.
- Convertí trabajo repetido en skills: si hiciste tres veces lo mismo, la cuarta ya debería ser un skill.
- Archivá las correcciones para siempre: cuando corregís al asistente, esa corrección va a un archivo, no se pierde al cerrar la sesión.
- Testeá antes de asumir límites: antes de decir “esto no lo puede hacer”, probalo. Muchas limitaciones son imaginarias.
Fijate que ninguna habla de prompts ingeniosos. Todas hablan de dónde vive la información. Ese es el punto: el 80% del resultado sale de la organización, no de cómo pedís las cosas.
¿Cómo convertir trabajo repetido en skills reutilizables?
La regla mental más útil que vi para esto: los sustantivos son contexto, los verbos son skills. Un archivo con la definición del producto es un sustantivo (una cosa, va en Context). “Revisar una spec” es un verbo (una acción, va como skill ejecutable). Cada vez que te encontrás repitiendo instrucciones para una misma acción, esa acción pide a gritos ser un skill.
Ponele que cada semana le pedís a Claude Code que revise specs con el mismo criterio: chequear casos borde, verificar que haya métricas de éxito, marcar dependencias no declaradas. En vez de tipear ese checklist cada vez, lo empaquetás en un skill llamado revisar-spec. La próxima vez decís “usá revisar-spec sobre este doc” y ejecuta el proceso completo.
Casos concretos que conviene volver skill: revisión de specs, generación de feedback estructurado sobre un draft, y síntesis de varios documentos en un resumen. La guía oficial de Agent Skills recomienda que cada skill haga una cosa bien y tenga instrucciones claras de cuándo usarse. Un skill que “hace de todo” termina sin usarse porque nadie sabe qué esperar de él.
¿Cómo integrar MCPs y herramientas en tu flujo de trabajo?
Los MCPs (Model Context Protocol) sirven para lo que cambia demasiado rápido como para guardarlo en un archivo. Un ticket de Jira que se mueve cada hora, un canal de Slack, una página de Confluence que edita medio equipo. Si eso lo copiás a un archivo de contexto, queda viejo antes del almuerzo. Con un MCP, el asistente lo consulta en vivo cuando lo necesita. Tema relacionado: integrar Claude en Make.
La lógica encaja con las tres velocidades. Context guarda lo estable, Operations lo fechado, y los MCPs cubren lo que directamente no tiene sentido guardar porque muta todo el tiempo. Conectás la fuente viva y dejás que el asistente lea el estado actual, no una foto de ayer.
Sobre herramientas de edición, dos que aparecen recomendadas: VS Code por la visibilidad que te da sobre lo que el asistente toca, y el propio Claude Code, que requiere un plan pago de Anthropic para uso serio. Si vas a mover infraestructura web, dominios o servidores como parte del producto, tené a mano un proveedor confiable en la región (en Argentina, donweb.com resuelve hosting y dominios sin vueltas).
¿Cómo armar el hábito de archivar al final de cada sesión?
El “filing” es un protocolo de dos minutos al cerrar cada sesión que decide qué del trabajo de hoy merece quedarse para siempre. Sin esto, cada sesión arranca de cero y volvés a corregir los mismos errores. Con esto, el sistema mejora solo con el uso.
Son tres preguntas. ¿Esto fue un error de una sola vez, o va a volver a pasar? ¿Faltó contexto que el asistente debería haber tenido? ¿Se repitió un proceso que ya podría ser un skill? Según la respuesta, la corrección va al archivo de contexto que corresponda, o se transforma en skill, o se descarta si de verdad fue algo único.
Algunos setups tienen un skill tipo /file-feedback que automatiza justo esto: te hace las preguntas y guarda la respuesta donde va. ¿Vale la pena el ritual? Cualquiera que haya perdido media hora reexplicando lo mismo por tercera vez sabe que sí. Dos minutos hoy, media hora ahorrada mañana. Complementá con capacidades reales de la API.
Errores comunes al organizar Claude Code
- Organizar por tema en lugar de velocidad: mezclás lo estable con lo que caduca y el asistente no sabe qué sigue vigente. Corrección: tres capas por tasa de cambio.
- Ponerle timestamp a todo: si la definición del producto lleva fecha, en meses tenés cinco versiones y ninguna clara. Solo Operations lleva fecha.
- No convertir procesos en skills: repetís el mismo checklist cada sesión a mano. Si lo hiciste tres veces, empaquetalo.
- No tener un CLAUDE.md central: sin mapa, cada sesión reexplica el proyecto desde cero. Un archivo chico resuelve el 80%.
- Meter todo el detalle dentro del CLAUDE.md: se vuelve un ladrillo ilegible. El mapa apunta a los archivos, no los reemplaza.
Preguntas Frecuentes
¿Qué es Claude Code?
Claude Code es la herramienta de línea de comandos de Anthropic que corre en la terminal y trabaja directo sobre tu repositorio: lee y edita archivos, ejecuta comandos y mantiene contexto del proyecto entre sesiones. Se usa tanto para programar como para trabajo de producto (specs, síntesis, revisiones).
¿Qué es CLAUDE.md y cómo creo uno?
CLAUDE.md es un archivo de texto que Claude Code carga automáticamente en cada sesión con las reglas que siempre aplican. Lo creás en la raíz del workspace con ese nombre exacto y adentro ponés qué hace el producto, cómo está organizado y qué convenciones seguir. Mantenelo corto y usalo como índice hacia los archivos de contexto.
¿Cuál es la estructura ideal de carpetas en Claude Code?
La estructura recomendada organiza por velocidad de cambio en tres capas: Context para lo estable (hechos del producto, usuarios), Projects para el trabajo activo (specs, entregables) y Operations para lo fechado (notas de reunión, status). Solo la capa Operations lleva fecha en los nombres de archivo.
¿Cómo uso skills para automatizar trabajo repetido?
Convertís en skill toda acción que repetís con el mismo criterio: revisar specs, dar feedback, sintetizar documentos. La regla es que los verbos (acciones) van como skills ejecutables y los sustantivos (archivos, hechos) van como contexto. Cada skill debe hacer una cosa bien y aclarar cuándo se usa.
¿Cómo mantengo el conocimiento consistente entre sesiones?
Con el hábito de archivar al cerrar cada sesión: preguntás si una corrección va a repetirse, si faltó contexto o si un proceso ya es un skill, y guardás lo que corresponda en su lugar. Así una corrección puntual se vuelve permanente y el asistente no repite el mismo error la próxima vez.
Conclusión
Saber cómo organizar Claude Code para producto se reduce a una idea que va contra la intuición: no ordenes por tema, ordená por cada cuánto cambia la información. Un CLAUDE.md chico como mapa, tres capas por velocidad de cambio, los verbos vueltos skills y dos minutos de archivado al final de cada sesión. Eso es el sistema entero.
Lo que cambia con esto es concreto. Dejás de reexplicar el proyecto en cada arranque, dejás de mezclar lo vigente con lo caduco, y el asistente mejora con el uso en vez de olvidarse todo al cerrar. Empezá hoy por lo más barato: creá el CLAUDE.md, meté las tres carpetas y la próxima vez que corrijas algo dos veces, hacelo skill. El resto se acomoda solo.
