workspace-v1/orchestration/templates/TEMPLATE-MAP.md

TEMPLATE: Archivo _MAP.md

Version: 1.0.0 Sistema: NEXUS v3.4 + SIMCO Proposito: Template estandar para archivos de indice _MAP.md

---

Instrucciones de Uso

1. Copiar este template al directorio que requiere indice
2. Renombrar a _MAP.md
3. Reemplazar los placeholders {...} con valores reales
4. Actualizar la fecha en cada modificacion
5. Mantener enlaces relativos para portabilidad

---

Template

# {NOMBRE_DEL_DIRECTORIO}

> {Descripcion breve del contenido de este directorio}

## Contenido

| Archivo/Directorio | Descripcion | Estado |
|--------------------|-------------|--------|
| [{nombre.md}]({nombre.md}) | {Descripcion breve} | Activo |
| [{subdirectorio}/]({subdirectorio}/) | {Descripcion del subdirectorio} | Activo |

## Navegacion

- **Padre:** [../](..)
- **Relacionados:** [{nombre-relacionado}]({ruta-relacionado})

---
*Actualizado: {YYYY-MM-DD}*

---

Ejemplo: Directorio de Modulos

# Definicion de Modulos

> Modulos funcionales del proyecto, organizados por dominio

## Contenido

| Archivo/Directorio | Descripcion | Estado |
|--------------------|-------------|--------|
| [AUTH-001-autenticacion/](AUTH-001-autenticacion/) | Sistema de autenticacion y autorizacion | Activo |
| [CORE-002-usuarios/](CORE-002-usuarios/) | Gestion de usuarios y perfiles | Activo |
| [PAY-003-pagos/](PAY-003-pagos/) | Integracion de pagos con Stripe | En Desarrollo |
| [REPORT-004-reportes/](REPORT-004-reportes/) | Sistema de reportes y analytics | Planificado |

## Navegacion

- **Padre:** [../docs/](..)
- **Relacionados:** [arquitectura/](../01-arquitectura/)

---
*Actualizado: 2026-01-03*

---

Ejemplo: Directorio de Arquitectura

# Arquitectura

> Documentacion de arquitectura, diagramas y decisiones tecnicas

## Contenido

| Archivo/Directorio | Descripcion | Estado |
|--------------------|-------------|--------|
| [ARQUITECTURA-GENERAL.md](ARQUITECTURA-GENERAL.md) | Vision general de la arquitectura | Activo |
| [DIAGRAMA-COMPONENTES.md](DIAGRAMA-COMPONENTES.md) | Diagrama de componentes del sistema | Activo |
| [STACK-TECNOLOGICO.md](STACK-TECNOLOGICO.md) | Stack y tecnologias utilizadas | Activo |
| [diagramas/](diagramas/) | Diagramas en formato Mermaid/PlantUML | Activo |

## Navegacion

- **Padre:** [../docs/](..)
- **Relacionados:** [vision-general/](../00-vision-general/)

---
*Actualizado: 2026-01-03*

---

Ejemplo: Raiz de docs/

# Documentacion del Proyecto

> Punto de entrada para toda la documentacion del proyecto {NOMBRE_PROYECTO}

## Contenido

| Directorio | Descripcion | Estado |
|------------|-------------|--------|
| [00-vision-general/](00-vision-general/) | Vision, arquitectura general, stack | Activo |
| [01-arquitectura/](01-arquitectura/) | Diagramas, decisiones tecnicas, ADRs | Activo |
| [02-definicion-modulos/](02-definicion-modulos/) | Modulos funcionales del proyecto | Activo |
| [90-transversal/](90-transversal/) | Inventarios, integraciones, temas transversales | Activo |
| [95-guias-desarrollo/](95-guias-desarrollo/) | Guias para desarrolladores | Activo |
| [96-quick-reference/](96-quick-reference/) | Cheatsheets y referencias rapidas | Activo |
| [97-adr/](97-adr/) | Architecture Decision Records | Activo |
| [98-analisis/](98-analisis/) | Documentos de analisis | Activo |
| [99-finiquito/](99-finiquito/) | Documentacion de entrega | Planificado |

## Navegacion

- **Padre:** [../](..) (raiz del proyecto)
- **Relacionados:** [README.md](README.md)

---
*Actualizado: 2026-01-03*

---

Estados Validos

Estado	Descripcion	Uso
Activo	Documento/directorio en uso activo	Contenido vigente y mantenido
En Desarrollo	Contenido en construccion	Trabajo en progreso
Planificado	Pendiente de crear	Placeholder para futuro contenido
Obsoleto	Ya no se mantiene	Marcar para revision/eliminacion
Draft	Borrador sin aprobar	Requiere revision

---

Convenciones

1. Nombres de archivo: Usar MAYUSCULAS con guiones (ej: ARQUITECTURA-GENERAL.md)
2. Nombres de directorio: Usar minusculas con guiones (ej: 01-arquitectura/)
3. Prefijos numericos: Para ordenar directorios (00-99)
4. Enlaces relativos: Siempre usar rutas relativas para portabilidad
5. Fecha de actualizacion: Actualizar en cada modificacion significativa

---

Validacion

Usar el script validate-docs-structure.sh para verificar:

• Existencia de _MAP.md en directorios con contenido
• Coherencia de enlaces
• Archivos huerfanos (no referenciados)

---

Template generado: 2026-01-03 Sistema: NEXUS v3.4 + SIMCO