# Convención de Nombres

> **Propósito:** Definir el formato estándar para nombrar archivos, documentos y recursos del proyecto.
> **Cuándo usarlo:** Al iniciar un proyecto o cuando el equipo ya no encuentra sus propios archivos.
> **Cómo usarlo:** Adapta los componentes del formato a tu contexto, publícalo en la wiki/repo del equipo y aplícalo a todo archivo nuevo desde hoy (no renombres lo viejo de golpe).

## Formato Universal

```
[PROYECTO]_[TIPO]_[DESCRIPCION]_[VERSION]_[FECHA]_[AUTOR].[ext]
```

## Componentes

| Componente | Regla | Ejemplo |
|------------|-------|---------|
| **PROYECTO** | Código del proyecto (2-5 caracteres, mayúscula) | `MEDI` (MediTrack), `FRAME` (FrameNote) |
| **TIPO** | Tipo de documento (ver tabla abajo) | `SPEC`, `REQ`, `MEET` |
| **DESCRIPCION** | Descripción breve, snake_case, máx 4 palabras | `login_google`, `dashboard_ventas` |
| **VERSION** | `v` + número mayor + `.` + número menor | `v1.0`, `v1.2`, `v2.0` |
| **FECHA** | Formato `YYYYMMDD` | `20260603` |
| **AUTOR** | Iniciales del autor (2-4 caracteres) | `JPM`, `LVA` |
| **EXT** | Extensión del archivo | `.md`, `.gsheet`, `.drawio` |

## Tipos de Documento

| Tipo | Código | Ejemplo |
|------|--------|---------|
| Spec / PRD | `SPEC` | `FRAME_SPEC_login_google_v1.0_20260603_JPM.md` |
| Plan técnico | `PLAN` | `FRAME_PLAN_login_google_v1.0_20260603_JPM.md` |
| Tasks / Backlog | `TASKS` | `FRAME_TASKS_login_google_v1.0_20260603_JPM.md` |
| Acta de reunión | `MEET` | `FRAME_MEET_kickoff_v1.0_20260603_JPM.md` |
| Investigación | `RESEARCH` | `FRAME_RESEARCH_competidores_v1.0_20260603_JPM.md` |
| Diseño | `DESIGN` | `FRAME_DESIGN_wireframes_v1.0_20260603_JPM.md` |
| Reporte | `RPT` | `FRAME_RPT_sprint_08_v1.0_20260603_JPM.md` |
| Encuesta | `SURVEY` | `FRAME_SURVEY_nps_q2_v1.0_20260603_JPM.md` |

## Reglas

1. NO usar espacios — usar `_` como separador
2. NO usar caracteres especiales (`ñ`, `á`, `ü`, `?`, `!`)
3. La descripción debe ser legible pero corta (máx 4 palabras)
4. La fecha siempre es `YYYYMMDD` (ordenable alfabéticamente)
5. Las versiones se numeran de forma independiente por archivo
6. Archivos congelados NO se renombran — solo se mueven a `archive/`

## Ejemplos

- `MEDI_SPEC_consentimiento_biometrico_v1.0_20260603_LVA.md`
- `FRAME_PLAN_reproductor_video_v2.1_20260603_JPM.md`
- `CONSULT_MEET_sprint_review_08_v1.0_20260603_ABC.md`
- `EDTECH_SURVEY_nps_q2_v1.0_20260603_XYZ.md`