doc-organizer

Organiza y categoriza documentos técnicos existentes en la estructura correcta del proyecto.

Triggers

Frases que activan el skill
“organizar docs”
“ordenar documentación”
“mover documentos a carpetas”
“categorizar archivos”

¿Qué hace?

  1. Inspecciona estado actual de docs/
  2. Pregunta por categorías a usar
  3. Analiza cada documento y sugiere categoría
  4. Ejecuta reorganización con git mv
  5. Renombra al formato estándar si es necesario

Detección automática

El skill detecta tipo de documento por keywords:

Keywords detectados Categoría sugerida
“ADR”, “Decision”, “Status: Accepted”, “Context”, “Consequences” architecture/
“Specification”, “Requirements”, “Spec”, “Technical Approach” specs/
“Plan”, “Implementation”, “Steps”, “Timeline”, “Goal” plans/
“Reference”, “Guide”, “How to”, “Examples”, “Usage” reference/

Categorías disponibles

Categoría Uso
specs/ Especificaciones de features/sistemas
plans/ Planes de implementación
architecture/ ADRs, decisiones arquitectónicas
reference/ Documentación técnica de referencia

Proceso de reorganización

Análisis 

Análisis de documentos:

authentication-notes.md
   Detectado: Menciona "requirements" y "technical approach"
   Sugerencia: specs/
   ¿Mover a specs/? [Y/n/otra categoría]

db-migration-decision.md
   Detectado: Contiene "Status: Accepted", "Context", "Decision"
   Sugerencia: architecture/ (es un ADR)
   ¿Mover a architecture/? [Y/n/otra categoría]

Ejecución 

# Crear carpeta si no existe
mkdir -p docs/specs/

# Mover preservando historial git
git mv docs/authentication-notes.md docs/specs/authentication-notes.md

Renombrado

Si el archivo no tiene el formato estándar, se renombra:

authentication-notes.md
→ 2025-12-25-15-30-authentication-notes.md

Output final 

Organización completada:
- 3 archivos movidos a specs/
- 2 archivos movidos a architecture/
- 1 archivo movido a plans/
- 0 archivos sin categorizar

Archivos reorganizados:
- docs/specs/2025-12-25-15-30-authentication-notes.md
- docs/architecture/2025-12-25-15-31-db-migration-decision.md
- ...

Ejemplo de uso 

Usuario: "Organiza los documentos en docs/"

1. Inspeccionar: Encuentra 3 archivos .md sueltos en docs/
2. Preguntar categorías: Usuario selecciona specs/, plans/, architecture/
3. Analizar cada archivo y sugerir categoría
4. Usuario confirma movimientos
5. Ejecutar: git mv para cada archivo
6. Mostrar resumen: "3 archivos reorganizados"

Herramientas disponibles

  • Read - Leer contenido de documentos
  • Bash - Ejecutar git mv
  • Glob - Buscar archivos
  • LS - Listar contenido