Doc Organizer
Skill para organizar y categorizar documentos tecnicos existentes en la estructura correcta del proyecto.
Proceso de Organizacion
Paso 1: Inspeccionar estado actual
Usar Glob para encontrar archivos markdown:
docs/*.mdpara archivos sueltos en raiz de docsdocs/**/*.mdpara todos los archivos incluyendo subcarpetas
Verificar carpetas existentes con ls docs/*/.
Paso 2: Preguntar por categorias
Presentar al usuario las categorias existentes detectadas, mas estas sugeridas si no existen:
| Categoria | Uso |
|---|---|
specs/ | Especificaciones de features/sistemas |
planning/ | Planes de implementacion activos |
archive/ | Documentos completados o superseded |
architecture/ | ADRs, decisiones arquitectonicas |
reference/ | Documentacion tecnica de referencia |
Preguntar al usuario cuales quiere usar.
Paso 3: Analizar documentos y sugerir categorizacion
Para cada documento encontrado:
- Leer contenido (primeras ~50 lineas)
- Detectar tipo por keywords:
| Keywords detectados | Categoria sugerida |
|---|---|
| "ADR", "Decision", "Status: Accepted/Proposed", "Context", "Consequences" | architecture/ |
| "Specification", "Requirements", "Spec", "Technical Approach" | specs/ |
| "Plan", "Implementation", "Steps", "Timeline", "Goal" | planning/ |
| "Reference", "Guide", "How to", "Examples", "Usage" | reference/ |
- Presentar analisis al usuario: para cada archivo, mostrar keywords detectados, categoria sugerida, y pedir confirmacion antes de mover. El usuario puede aprobar, rechazar, o elegir otra categoria para cada archivo.
Paso 4: Ejecutar reorganizacion
Para cada documento confirmado:
- Crear carpeta destino si no existe:
mkdir -p docs/<categoria>/ - Mover archivo preservando historial git:
git mv docs/<archivo>.md docs/<categoria>/<archivo>.md - Opcionalmente renombrar al formato estandar (preguntar al usuario primero):
- Formato: YYYY-MM-DD-<name>.md - Excepcion: ADRs usan NNNN-<name>.md
Paso 5: Resumen final
Mostrar resultado: cuantos archivos por categoria, lista de archivos reorganizados, y archivos que quedaron sin categorizar (si los hay).