Inicio / Gestos cotidianos

Tomar el control, documentar y migrar una base de código

En un repositorio desconocido, una visión de conjunto solicitada antes de cualquier modificación orienta las preguntas siguientes, y el comando /init lee realmente el contenido del proyecto para escribir un primer CLAUDE.md en lugar de partir de una página en blanco.

En un repositorio desconocido, abrir el primer archivo que se encuentre casi no enseña nada sobre cómo se ensamblan las piezas. Una pregunta amplia, del tipo dame una visión general de este repositorio, orienta útilmente lo que sigue: Claude Code detecta los puntos de entrada, las dependencias declaradas y la organización de las carpetas antes de bajar al detalle de una función precisa.

Cartografiar antes de tocar el código

La respuesta a esta primera pregunta sirve de mapa para elegir la pregunta siguiente. Preguntar de inmediato cómo funciona un módulo aislado, sin haber pasado por esta visión general, equivale a corregir una pieza sin saber para qué sirve en la máquina completa. En un proyecto voluminoso, dos o tres preguntas sucesivas, cada una más estrecha que la anterior, reemplazan una exploración archivo por archivo que llevaría horas.

Escribir una primera memoria con /init

El comando /init lee realmente el contenido del repositorio para producir un primer CLAUDE.md: comandos de build y de test detectados, convenciones visibles en el código existente, estructura de las carpetas principales. Si ya existe un CLAUDE.md, /init no lo sobrescribe, propone mejoras a partir de lo que ya está escrito. El archivo generado sigue siendo un primer borrador: se relee y se recorta para conservar solo lo que es corto y verificado, como detalla CLAUDE.md, la memoria del proyecto.

mkdir -p demo-migration/src && cd demo-migration
git init -q
printf 'def total(a, b):\n    return a + b\n' > src/calcul.py
printf 'lodash==4.17.21\n' > requirements.txt
git add -A && git commit -q -m "primera versión"
claude
> dame una visión general de este repositorio, y luego genera un CLAUDE.md con /init

Tratar la documentación como código fuente

Una documentación desactualizada cuesta más cara que la ausencia de documentación, porque induce a error en lugar de simplemente no decir nada. Pedir una generación precisando el estilo esperado, JSDoc o docstrings según el lenguaje del proyecto, evita un formato que nadie usa después en el equipo. El mismo principio vale para una actualización de dependencia: pedir la lista de cambios incompatibles antes de modificar el archivo de bloqueo da una base de decisión, aunque ningún comando dedicado produzca esa lista automáticamente. Es una formulación de la solicitud, no una herramienta separada.

El gesto siempre concluye con una relectura del diff final producido por la migración o por la generación de documentación, nunca con una confianza depositada solo en el mensaje de éxito mostrado al final de la tarea.