Versión para niños

Ordenar un proyecto con Claude Code

Revisada el 2026-10-12

Pasada de orden sobre un proyecto con dos resultados: carpetas limpias con git al día y un resumen ejecutivo de su estado real.

Se empaqueta como una skill de Claude Code que se invoca a demanda.1 Su principio es que no decide por el usuario: presenta un informe, pregunta por grupos de ficheros y aplica solo lo confirmado. Lo que sobra se archiva, no se borra.

Requisitos

  • Un proyecto con una estructura reconocible (por ejemplo, carpetas de contexto, documentación, entregables y entradas) y un archivo de instrucciones que explique de qué va.
  • Git, si se quiere comprobar el estado del repositorio. Sin repositorio o sin remoto, esos pasos se omiten con aviso.
  • Una carpeta de archivo dentro del propio proyecto, con subcarpeta por fecha, para lo que se retira.

Pasos

  1. Identifica el proyecto y lee sus instrucciones y su objetivo. Si falta el objetivo, se pregunta antes de seguir.
  2. Resume en tres a cinco líneas qué es el proyecto y dónde están sus entregables. Así se detecta pronto un fichero que no encaja.
  3. Haz el inventario de ficheros (ruta, tamaño, fecha, si está en git) y recoge el estado de git: rama, remoto, cambios sin confirmar y commits pendientes de envío.
  4. Clasifica los hallazgos:
    • notas de traspaso (handoffs) obsoletas, cuando su contenido ya figura en el registro de decisiones;
    • borradores superados por una versión final;
    • duplicados exactos o copias con sufijo;
    • cachés y ficheros regenerables;
    • ficheros sin tocar en más de 30 días y sin referencias, solo como candidatos;
    • ficheros ajenos al objetivo del proyecto.
  5. Guarda un informe con los hallazgos y las propuestas. En el chat, solo el resumen y los totales por categoría.
  6. Pregunta una categoría cada vez, no fichero a fichero. Las opciones son archivar, borrar (solo cachés y duplicados idénticos), dejar o revisar uno a uno. Lo que no se responde no se toca.
  7. Aplica lo confirmado. Archivar es mover conservando la ruta relativa, sin sobrescribir; un destino existente recibe un sufijo numérico.
  8. Deja git al día: revisa que no entra nada sensible (credenciales, .env, claves), propone el mensaje de commit y pide confirmación. El envío al remoto se pregunta aparte, nunca se fuerza y un fallo se comunica tal cual.
  9. Verifica que lo archivado coincide con lo movido y anota creados, movidos, borrados y pendientes.
  10. Cierra con una foto del proyecto de una pantalla: veredicto en una línea, antigüedad y última actividad, tamaño con y sin el historial de git, carpetas con más ficheros, estado de git, sesiones y notas de traspaso, y pendientes.

Errores frecuentes

  • Borrar en lugar de archivar. Lo que está en git se recupera; lo que no, se pierde.
  • Incluir en la limpieza las carpetas de credenciales, el archivo de instrucciones o los entregables finales. La skill solo señala lo que parezca sobrar ahí y pregunta.
  • Estimar cifras que no se han medido. En la foto final, lo que no se puede medir se marca «n/d».
  • Tocar la configuración global de Claude Code (~/.claude) desde una limpieza de proyecto: solo se informa.
  • Hacer commit o push sin confirmación.

Véase también

Referencias

Footnotes

  1. Extend Claude with skills. Anthropic, documentación de Claude Code. Consultado el 2026-10-10. ↩

Backlinks