Guía de ClaudeNivel 2 · OrdenarLevel 2 · Getting organized
Un archivo por proyectoOne file per project
Estado, traspaso, historial y versiones: para que cada sesión arranque donde terminó la anterior.Status, handoff, history and versions: so each session starts where the last one ended.
Además del archivo general, cada proyecto tiene el suyo: un CLAUDE.md en su carpeta o, en claude.ai, las instrucciones de un Project. Dice qué es el proyecto, cómo se trabaja ahí, sus reglas propias y una sección que se llama Estado.
El Estado y el traspaso
El Estado tiene fecha y tres cosas: qué decidí, qué hice y qué sigue. Al cerrar una sesión en la que avancé, le pido a Claude que lo actualice. Es el traspaso: la próxima conversación arranca donde quedó esta, y no de cero.
Parece poco. Es lo que más rinde de toda la guía. Un proyecto sin estado anotado sale caro, porque Claude tiene que reconstruir lo que pasó leyendo todo, archivo por archivo, como un detective con mucho tiempo libre y mi tarjeta de crédito.
Dos cosas aprendí por las malas. La primera es que los estados envejecen rápido: si un archivo dice “pendiente” y en realidad ya lo terminé, Claude me va a recomendar hacer algo hecho, así que conviene que lo cruce con algo más confiable, como el historial de cambios del repositorio. La segunda es que el estado dice lo que yo creo, no lo que es. El mío afirmaba que dos computadoras estaban sincronizadas al cien por ciento. Una de las dos no tenía nada. Ahora lo que se puede verificar se verifica (más en Calidad sin burocracia).
Lo viejo, a otro archivo
Si el Estado acumula todo, el archivo crece y se paga en cada sesión del proyecto. El de mi sitio llegó a casi 9 KB, con el detalle de cinco versiones que ya nadie necesitaba (ni yo). Lo arreglé con un HISTORIAL.md al lado, que no se carga: en el Estado quedan solo los pendientes vivos y lo demás se muda. Desde entonces, cada archivo de proyecto pesa menos de 3 KB.
Versiones
Cada proyecto lleva también un CHANGELOG.md mínimo: versión 1, 2, 3, con una a tres líneas sobre qué cambió, escritas para quien lo usa y no para quien lo programó. Sube cuando algo se entrega o se publica, no por cada edición. Nos sirve a los dos (a Claude y a mí) para saber qué está listo. En los proyectos con repositorio, además, cada versión lleva su etiqueta.
El prompt
Cerramos acá. Actualizá la sección Estado del archivo de este proyecto con la fecha de hoy: qué decidimos, qué se hizo y qué sigue, en cinco líneas como máximo. Lo que ya no está vivo pasalo a HISTORIAL.md. Si algo se entregó o se publicó, sumá una versión al CHANGELOG.md. Mostrame el diff antes de guardar.
Besides the general file, each project has its own: a CLAUDE.md in its folder or, on claude.ai, the instructions of a Project. It says what the project is, how you work there, its own rules and a section called Status.
Status and handoff
The Status has a date and three things: what I decided, what I did and what's next. When I close a session where I made progress, I ask Claude to update it. That's the handoff: the next conversation starts where this one left off, not from zero.
It doesn't look like much. It's what pays off the most in this whole guide. A project without a written status is expensive, because Claude has to reconstruct what happened by reading everything, file by file, like a detective with a lot of free time and my credit card.
I learned two things the hard way. The first is that statuses get old fast: if a file says “pending” and I actually finished it already, Claude is going to recommend I do something that's done, so it helps to have it cross-check against something more reliable, like the repository's change history. The second is that the status says what I believe, not what is. Mine claimed two computers were one hundred percent in sync. One of the two had nothing. Now whatever can be verified gets verified (more in Quality without bureaucracy).
The old stuff, to another file
If the Status accumulates everything, the file grows and gets paid for in every session of the project. The one for my site reached almost 9 KB, with the detail of five versions nobody needed anymore (not even me). I fixed it with a HISTORY.md next to it, which doesn't get loaded: only the live pending items stay in the Status and the rest moves out. Since then, every project file weighs under 3 KB.
Versions
Each project also carries a minimal CHANGELOG.md: version 1, 2, 3, with one to three lines on what changed, written for whoever uses it and not for whoever coded it. It goes up when something is delivered or published, not with every edit. It helps both of us (Claude and me) know what's ready. In projects with a repository, each version also gets a tag.
The prompt
We're done here. Update the Status section of this project's file with today's date: what we decided, what was done and what's next, in five lines at most. Move whatever is no longer live to HISTORY.md. If something was delivered or published, add a version to the CHANGELOG.md. Show me the diff before saving.