🏷 Nomenclaturas del Sistema de IA¶

BKM¶

1. Propósito de este documento¶

Este documento define las convenciones oficiales de nomenclatura del Sistema de IA de BKM.

Su objetivo es:

asegurar consistencia entre decisiones, agentes y outputs,
evitar ambigüedad y confusión a lo largo del tiempo,
facilitar trazabilidad y auditoría,
permitir que humanos y agentes compartan un lenguaje común,
y proteger la coherencia del sistema a medida que escala.

Este documento forma parte del gobierno del sistema de IA y es de cumplimiento obligatorio.

2. Principio rector¶

Todo lo que no se nombra de forma consistente,
termina comportándose de forma inconsistente.

Las nomenclaturas no son un detalle técnico,
son una herramienta de gobierno.

3. Convenciones generales¶

3.1 Idioma¶

Idioma principal: español.
Uso de minúsculas salvo acrónimos o siglas.
Sin acentos ni caracteres especiales en nombres técnicos.
Separador estándar: guion bajo (_).

Ejemplo correcto: decision_01_cobertura_visitas

Ejemplo incorrecto: Decisión 1 – Cobertura Visitas

3.2 Fechas y tiempo¶

Formato estándar de fecha: YYYY-MM-DD

Ejemplo: 2026-01-15

No se utilizan: - formatos locales (15/01/2026), - nombres de meses, - timestamps salvo necesidad explícita.

4. Nomenclatura de decisiones¶

4.1 Identificador de decisión¶

Formato obligatorio: decision_XX_nombre_corto

Donde: - XX es un número secuencial con dos dígitos, - nombre_corto describe la decisión de forma clara y concisa.

Ejemplo: decision_01_cobertura_visitas

Este identificador se utiliza: - en carpetas, - en Storage, - en referencias cruzadas, - en logs y outputs.

4.2 Documentos dentro de una decisión (Repo)¶

Archivos estándar dentro de la carpeta de una decisión:

ficha_decision.md
proceso_completo.md
implementacion.md
esquema_visual.md
decision_log.md

No se inventan nombres alternativos sin justificación.

5. Nomenclatura de agentes de IA¶

5.1 Identificador de agente¶

Formato obligatorio: agent_nombre_funcional

Ejemplo: agent_facilitacion_decisiones

Reglas: - un agente = una responsabilidad principal, - nombres funcionales, no creativos, - sin referencias a tecnología concreta.

5.2 Documentación de agentes (Repo)¶

Archivos: agent_nombre_funcional.md

Ejemplo: agent_facilitacion_decisiones.md

6. Nomenclatura de prompts¶

6.1 Prompts de sistema¶

Formato: system_agent_nombre_funcional.md

Ejemplo: system_agent_facilitacion_decisiones.md

6.2 Prompts de usuario¶

Formato: user_decision_XX_contexto.md

Ejemplo: user_decision_01_contexto_semanal.md

6.3 Fragmentos reutilizables¶

Formato: fragment_nombre_descriptivo.md

Ejemplo: fragment_validacion_humana.md

7. Nomenclatura en Storage¶

7.1 Estructura base por decisión¶

decisiones/ └── decision_01_cobertura_visitas/ ├── inputs/ ├── outputs/ ├── logs/ ├── evidencias/ └── archive/

7.2 Outputs generados¶

Formato estándar: YYYY-MM-DD_output.md

Ejemplo: 2026-01-15_output.md

Archivo especial: latest.md

Apunta siempre al último output válido.

7.3 Inputs y snapshots¶

Formato: YYYY-MM-DD_input.md YYYY-MM-DD_snapshot.md

7.4 Logs de decisión humana¶

Formato: YYYY-MM-DD_decision_log.md

8. Convenciones para humanos vs IA¶

Los documentos creados por IA deben indicarlo explícitamente en el contenido.
Los documentos validados o modificados por humanos deben reflejarlo.
El nombre del archivo no cambia, cambia el contenido.

Ejemplo en contenido: Generado por IA — pendiente de validación humana

9. Nombres prohibidos o desaconsejados¶

No se utilizan:

final.md
nuevo.md
prueba.md
v2.md, v3.md
definitivo.md

El versionado se gestiona por: - fecha, - estructura, - y contexto, no por nombres ambiguos.

10. Relación con otros documentos de gobierno¶

Este documento complementa:

gobierno_repo_y_storage.md
estructura_repo.md
estrategia_storage.md

En caso de conflicto: - este documento gobierna cómo se nombran las cosas, - los otros gobiernan dónde viven y cómo se usan.

11. Idea clave final¶

Un sistema de IA bien gobernado
no solo decide bien,
se nombra bien.

Estas nomenclaturas existen para que el Sistema de IA de BKM sea coherente, trazable y sostenible en el tiempo.