workspace-v1/orchestration/checklists/CHECKLIST-DOCUMENTACION-PROYECTO.md

CHECKLIST: Documentacion de Proyecto

Version: 1.0.0 Proposito: Validar que un proyecto cumple con los estandares de documentacion Referencia: SIMCO-DOCUMENTACION-PROYECTO.md Creado: 2026-01-10

---

Instrucciones de Uso

1. Ejecutar este checklist al inicio de cada proyecto nuevo
2. Re-validar trimestralmente para proyectos activos
3. Marcar cada item como [x] cuando se cumpla
4. Documentar excepciones y razones en seccion de notas

---

1. Estructura de /docs

1.1 Archivos Obligatorios

• Existe /docs/_MAP.md como indice principal
• Existe /docs/README.md con introduccion al proyecto
• _MAP.md tiene tabla de contenido actualizada
• _MAP.md tiene metricas de progreso

1.2 Directorios Obligatorios

• Existe /docs/00-vision-general/
• 00-vision-general/ contiene VISION-*.md o README.md
• Existen directorios de fases numerados (01-, 02-, etc.)
• Cada fase tiene su propio _MAP.md

1.3 Directorios Opcionales (marcar N/A si no aplica)

• Existe /docs/90-transversal/ (si hay contenido compartido)
• Existe /docs/95-guias-desarrollo/ (si hay guias)
• Existe /docs/96-quick-reference/ (si hay referencias rapidas)
• Existe /docs/97-adr/ (si hay decisiones arquitectonicas)
• Existe /docs/99-finiquito/ (si proyecto cerrado)

---

2. Estructura de /orchestration

2.1 Directorio Guidelines

• Existe /orchestration/00-guidelines/
• Existe /orchestration/00-guidelines/CONTEXTO-PROYECTO.md
• Existe /orchestration/00-guidelines/HERENCIA-SIMCO.md
• CONTEXTO-PROYECTO.md tiene variables definidas
• HERENCIA-SIMCO.md lista directivas aplicables

2.2 Inventarios

• Existe /orchestration/inventarios/
• Existe MASTER_INVENTORY.yml
• MASTER_INVENTORY.yml tiene metadata completa
• MASTER_INVENTORY.yml tiene resumen de progreso
• Existe DATABASE_INVENTORY.yml (si aplica)
• Existe BACKEND_INVENTORY.yml (si aplica)
• Existe FRONTEND_INVENTORY.yml (si aplica)

2.3 Archivos de Contexto

• Existe /orchestration/CONTEXT-MAP.yml
• Existe /orchestration/PROJECT-STATUS.md
• Existe /orchestration/README.md
• PROJECT-STATUS.md esta actualizado (< 7 dias)

---

3. Nomenclatura

3.1 Archivos

• Requerimientos siguen patron RF-{MODULO}-{NUM}.md
• Especificaciones siguen patron ET-{TIPO}-{MODULO}.md
• User Stories siguen patron US-{EPICA}-{NUM}-{desc}.md
• ADRs siguen patron ADR-{NNNN}-{descripcion}.md
• Planes siguen patron PLAN-{DESC}-{FECHA}.md
• Todos los indices son _MAP.md

3.2 Directorios

• Directorios de fase usan formato {NN}-{nombre-kebab}/
• Numeracion es secuencial sin saltos
• Nombres usan kebab-case (minusculas con guiones)

3.3 Fechas

• Fechas en nombres usan formato YYYY-MM-DD
• Fechas en metadata usan formato YYYY-MM-DD

---

4. Contenido de Documentos

4.1 Frontmatter/Metadata

• Documentos tienen frontmatter YAML o tabla de metadata
• Campo id es unico en el proyecto
• Campo status usa valores estandar
• Campo priority usa valores P0-P3
• Campos created_date y updated_date estan presentes

4.2 Estructura de Contenido

• Documentos tienen titulo principal (# Titulo)
• Secciones estan organizadas logicamente
• Existe seccion de Referencias o Dependencias
• Footer incluye fecha de actualizacion

4.3 Referencias Cruzadas

• Links internos funcionan (no rotos)
• Referencias a directivas usan formato @DIRECTIVA
• No existen referencias huerfanas

---

5. Consistencia de Estados

• Estados de documentos son consistentes
• Documentos "Published" estan completos
• Documentos "Deprecated" indican reemplazo
• Progress en inventarios coincide con realidad

---

6. Multi-tenancy (si aplica)

• Documentacion menciona consideraciones multi-tenant
• RLS esta documentado en especificaciones de BD
• Variables de tenant estan definidas

---

Resultado de Validacion

Resumen

Seccion	Items	Cumplidos	Porcentaje
Estructura /docs	9		%
Estructura /orchestration	12		%
Nomenclatura	9		%
Contenido	10		%
Consistencia	4		%
TOTAL	44		%

Notas y Excepciones

{Documentar aqui cualquier excepcion justificada}

Fecha de Validacion

• Validado por: {nombre/rol}
• Fecha: {YYYY-MM-DD}
• Proxima revision: {YYYY-MM-DD}

---

Referencia: SIMCO-DOCUMENTACION-PROYECTO.md