By name: glossary description: "Crear y mantener un glosario de términos del proyecto para evitar ambigüedades. Activar ante: glosario, definir terminos, vocabulario del proyecto, que significa"
Corpus lingüístico / Glosario del proyecto
Resumen
Este skill crea y mantiene un glosario de términos del proyecto: un documento de referencia donde cada concepto tiene una definición única, consensuada y sin ambigüedades. El objetivo es que todo el equipo hable el mismo idioma: cuando alguien dice "usuario", todos entienden lo mismo.
Las malas interpretaciones entre miembros del equipo son una de las fuentes más frecuentes de bugs y retrabajos. Un glosario bien mantenido previene estos problemas de raíz.
Proceso
Paso 1: identificar términos clave
- Revisar el código fuente: nombres de entidades, modelos, servicios, tipos.
- Revisar la documentación existente: README, PRDs, historias de usuario.
- Identificar términos que se usan de forma inconsistente o ambigua.
- Preguntar al usuario si hay términos que generen confusión en el equipo.
Paso 2: crear el fichero de glosario
Crear docs/glossary.md con la siguiente estructura:
# Glosario del proyecto
| Término | Definición | Contexto | No confundir con |
|---------|-----------|----------|------------------|
| Usuario | Persona registrada con cuenta activa | Backend, API | Visitante (no registrado) |
| Sesión | Período de actividad autenticada | Auth | Conexión (socket) |
Cada entrada incluye:
- Término: la palabra o expresión exacta.
- Definición: qué significa en el contexto de este proyecto. Una frase, precisa.
- Contexto: dónde se usa (módulo, capa, dominio).
- No confundir con: términos similares que significan otra cosa.
Paso 3: vincular con el código
- Verificar que los nombres en el código (variables, clases, funciones) son coherentes con el glosario.
- Si hay inconsistencias, proponer renombramientos o documentar la discrepancia.
Paso 4: mantener actualizado
- Cada vez que se introduce un concepto nuevo en el proyecto, añadirlo al glosario.
- Si un término cambia de significado, actualizar la definición y notificar al equipo.
Qué NO hacer
- No incluir términos genéricos de programación (API, endpoint, función). Solo términos específicos del dominio del proyecto.
- No escribir definiciones largas. Una frase por término, dos como máximo.
- No crear el glosario y olvidarlo. Un glosario desactualizado es peor que no tener ninguno.