SIMCO-NOMENCLATURA
Version: 1.0.0
Tipo: Directiva Operacional
Prioridad: P0
Alias: @NOMENCLATURA
Creado: 2026-01-10
Depende de: SIMCO-DOCUMENTACION-PROYECTO.md
1. Proposito
Estandarizar la nomenclatura de archivos y directorios en todos los proyectos del workspace para garantizar consistencia, predictibilidad y facilidad de navegacion.
2. Principios de Nomenclatura
2.1 Principios Generales
- Consistencia: Mismo patron en todo el proyecto
- Descriptivo: El nombre indica el contenido
- Predecible: Facilita busqueda automatizada
- Sin espacios: Usar guiones o guiones bajos
- Case-sensitive: Respetar mayusculas/minusculas
2.2 Convenciones Base
| Elemento |
Convencion |
Ejemplo |
| Archivos MD |
UPPER-CASE con guiones |
RF-AUTH-001.md |
| Directorios |
kebab-case numerado |
01-fase-alcance/ |
| Inventarios |
UPPER_SNAKE_CASE |
MASTER_INVENTORY.yml |
| Indices |
_MAP.md fijo |
_MAP.md |
3. Patrones por Tipo de Archivo
3.1 Requerimientos
RF-{MODULO}-{NUM}.md
Ejemplos:
RF-AUTH-001.md
RF-CATALOG-002.md
RF-PAYMENTS-003.md
3.2 Especificaciones Tecnicas
ET-{TIPO}-{MODULO}.md
ET-{TIPO}-{MODULO}-{NUM}.md
Ejemplos:
ET-BACKEND-AUTH.md
ET-DATABASE-USERS.md
ET-FRONTEND-DASHBOARD-001.md
3.3 User Stories
US-{EPICA}-{NUM}-{descripcion-corta}.md
Ejemplos:
US-AUTH-001-login-basico.md
US-CATALOG-002-busqueda-productos.md
3.4 Epicas por Proyecto
| Proyecto |
Patron |
Ejemplo |
| gamilit |
EAI-{NUM}-{nombre}/ |
EAI-001-fundamentos/ |
| gamilit ext |
EXT-{NUM}-{nombre}/ |
EXT-005-reportes/ |
| erp-core |
MGN-{NUM}-{nombre}/ |
MGN-001-auth/ |
| michangarrito |
MCH-{NUM}-{nombre}.md |
MCH-001-infraestructura.md |
| template-saas |
SAAS-{NUM}-{nombre}.md |
SAAS-014-whatsapp.md |
3.5 ADRs (Architecture Decision Records)
ADR-{NNNN}-{descripcion-kebab}.md
Ejemplos:
ADR-0001-monorepo-structure.md
ADR-0002-authentication-strategy.md
3.6 Documentos Temporales (Fechados)
{TIPO}-{DESCRIPCION}-{FECHA}.md
Tipos validos:
- PLAN-
- ANALISIS-
- VALIDACION-
- REPORTE-
- EJECUCION-
- REFINAMIENTO-
- DEPENDENCIAS-
Ejemplos:
PLAN-CONSOLIDACION-BD-2026-01-07.md
ANALISIS-ERRORES-ADMIN-2026-01-07.md
VALIDACION-PLAN-ADMIN-2026-01-07.md
REPORTE-SPRINT-3-2026-01-10.md
3.7 Trazas
TRAZA-{TIPO}-{DESCRIPCION}.md
Ejemplos:
TRAZA-TAREAS-DATABASE.md
TRAZA-TAREAS-BACKEND.md
TRAZA-DEPENDENCIAS-AUTH.md
3.8 Inventarios
{TIPO}_INVENTORY.yml
Tipos estandar:
- MASTER_INVENTORY.yml
- DATABASE_INVENTORY.yml
- BACKEND_INVENTORY.yml
- FRONTEND_INVENTORY.yml
- DEVENV-MASTER-INVENTORY.yml
- DEVENV-PORTS-INVENTORY.yml
3.9 Indices
_MAP.md (fijo, siempre este nombre)
Ubicacion: Raiz de cada directorio principal
Proposito: Indice navegable del contenido
4. Patrones de Directorios
4.1 Numeracion por Tipo
| Rango |
Tipo |
Ejemplo |
| 00-09 |
Vision/Estrategia |
00-vision-general/ |
| 01-89 |
Fases del proyecto |
01-fase-alcance/, 02-fase-desarrollo/ |
| 90-94 |
Transversal |
90-transversal/ |
| 95 |
Guias desarrollo |
95-guias-desarrollo/ |
| 96 |
Quick reference |
96-quick-reference/ |
| 97 |
ADRs |
97-adr/ |
| 98 |
Reservado |
- |
| 99 |
Finiquito/Cierre |
99-finiquito/ |
4.2 Formato de Nombre
{NN}-{nombre-en-kebab-case}/
Ejemplos:
00-vision-general/
01-fase-alcance/
02-fase-desarrollo/
90-transversal/
97-adr/
5. Formato de Fechas
5.1 En Nombres de Archivo
{YYYY}-{MM}-{DD}
Ejemplo: 2026-01-10
5.2 En Metadata
created_date: "2026-01-10"
updated_date: "2026-01-10"
5.3 En Contenido
**Fecha:** 2026-01-10
**Ultima actualizacion:** 2026-01-10
6. Prefijos por Contexto
6.1 Tipos de Documento
| Prefijo |
Tipo |
Uso |
| RF- |
Requerimiento Funcional |
Que debe hacer |
| RN- |
Regla de Negocio |
Como se comporta |
| RNF- |
Requerimiento No Funcional |
Constraints |
| ET- |
Especificacion Tecnica |
Como implementar |
| US- |
User Story |
Perspectiva usuario |
| ADR- |
Decision Arquitectonica |
Porque elegimos X |
| INT- |
Integracion |
APIs externas |
6.2 Prefijos de Epica por Proyecto
| Proyecto |
Prefijo |
Significado |
| gamilit |
EAI- |
Epica Academica Interna |
| gamilit |
EXT- |
Epica Extension |
| erp-core |
MGN- |
Modulo General Negocio |
| michangarrito |
MCH- |
Modulo Changarrito |
| template-saas |
SAAS- |
Servicio SAAS |
7. Anti-patrones a Evitar
7.1 Nombres Incorrectos
| Incorrecto |
Correcto |
Razon |
rf auth 001.md |
RF-AUTH-001.md |
Sin espacios, uppercase |
Plan-Auth.md |
PLAN-AUTH-2026-01-10.md |
Falta fecha |
especificacion.md |
ET-BACKEND-AUTH.md |
Muy generico |
MAPA.md |
_MAP.md |
Nombre fijo |
2026-01-10-plan.md |
PLAN-DESCRIPCION-2026-01-10.md |
Fecha al final |
7.2 Directorios Incorrectos
| Incorrecto |
Correcto |
Razon |
fase1/ |
01-fase-alcance/ |
Falta numero, nombre |
Transversal/ |
90-transversal/ |
Minusculas, numero |
docs-old/ |
(eliminar) |
No usar legacy dirs |
8. Validacion
Para validar nomenclatura, usar:
Ver: CHECKLIST-NOMENCLATURA.md
Comandos de Verificacion
# Verificar archivos RF
find docs -name "RF-*.md" | head
# Verificar directorios numerados
ls -d docs/[0-9][0-9]-*/
# Verificar _MAP.md existen
find docs -name "_MAP.md"
9. Referencias
| Directiva |
Proposito |
| SIMCO-DOCUMENTACION-PROYECTO.md |
Estructura general |
| SIMCO-ESTRUCTURA-DOCS.md |
Contenido interno |
| CHECKLIST-NOMENCLATURA.md |
Validacion |
Ultima actualizacion: 2026-01-10
Mantenido por: Orchestration Team
3a8a459d91