🗂 Estructura del Repositorio¶

Sistema de Decisión Asistida (SDA) — BKM¶

1. Propósito de este documento¶

Este documento describe la estructura de carpetas del repositorio del Sistema de Decisión Asistida (SDA) de BKM y explica:

para qué sirve cada carpeta,
qué tipo de documentos deben vivir en cada una,
y cómo utilizar el repositorio de forma coherente y ordenada.

Su objetivo es facilitar el trabajo diario, la comprensión del sistema y su evolución, sin redefinir reglas de gobierno.

Las normas sobre: - qué debe vivir en el Repo, - qué debe vivir en Storage, - y cómo se gobierna esa separación,

se definen en el documento:

/00_gobierno/gobierno_repo_y_storage.md

2. Principios de organización del repositorio¶

La estructura del repositorio se rige por estos principios:

Separación clara entre gobierno, decisiones y ejecución.
El Repo contiene diseño y reglas, no outputs operativos.
Una decisión es una carpeta, no un único archivo.
Los documentos canónicos viven aquí; las instancias vivas, en Storage.
La estructura prioriza la lectura humana frente a la optimización técnica.

3. Estructura general del repositorio¶

/ia-bkm │ ├── README.md │ ├── 00_gobierno/ ├── 01_marco_decisiones/ ├── 02_decisiones/ ├── 03_agentes/ ├── 04_prompts/ ├── 05_ecosistema_ia/ └── _templates/

Esta estructura puede evolucionar, pero cualquier cambio debe: - ser consciente, - estar documentado, - y respetar los principios de gobierno.

4. Descripción de carpetas¶

README.md¶

Documento raíz del proyecto.

Explica: - qué es el SDA de BKM, - por qué existe, - cómo se está construyendo, - el estado actual del sistema, - y cómo navegar el repositorio.

Es el punto de entrada principal para cualquier persona que acceda al sistema.

00_gobierno/¶

Contiene los documentos de gobierno y control del sistema.

Aquí viven las reglas que: - definen límites, - establecen precedencias, - y no deberían cambiar con frecuencia.

Incluye, entre otros:

Visión y principios del SDA.
Manual de Gobierno del Sistema.
Gobierno Repo ↔ Storage.
Gobierno de datos estructurados.
Reglas de acceso (conceptuales).
Este documento (gobierno_estructura_repo.md).

01_marco_decisiones/¶

Contiene la documentación del Marco de Decisiones asistidas por IA.

Aquí se define: - cómo se formulan decisiones, - cómo se analizan y facilitan, - qué reglas deben seguirse, - y qué plantillas oficiales se utilizan.

No contiene decisiones concretas, sino las reglas para tomarlas.

02_decisiones/¶

Contiene las decisiones reales del negocio,
una carpeta por decisión.

Ejemplo¶

02_decisiones/ └── decision_01_cobertura_visitas/ ├── ficha_decision.md ├── proceso_decision.md ├── esquema_visual.md └── decision_log.md

Reglas clave¶

Cada decisión es una unidad lógica completa.
Los archivos ofrecen vistas complementarias de la misma decisión.
Los outputs operativos recurrentes no viven aquí, sino en Storage.

03_agentes/¶

Define los agentes de IA como actores funcionales del sistema.

Aquí se documenta: - el propósito de cada agente, - sus responsabilidades y límites, - sus inputs y outputs esperados, - y su rol dentro del SDA.

No contiene ejecuciones ni resultados.

04_prompts/¶

Contiene los prompts versionados del sistema.

Incluye: - prompts de sistema, - prompts de usuario, - fragmentos reutilizables.

Los prompts aquí son: - diseñados, - revisados, - y aprobados.

Los inputs reales y outputs generados se registran siempre en Storage.

05_ecosistema_ia/¶

Describe el ecosistema de soporte del SDA.

Aquí se documenta: - las capas del sistema, - el rol de cada componente, - criterios de elección, - y límites de uso.

No es documentación técnica de implementación, sino diseño estructural del ecosistema.

_templates/¶

Contiene las plantillas oficiales del sistema.

Incluye: - plantillas de ficha de decisión, - plantillas de decision log, - plantillas de outputs, - y otros formatos reutilizables.

Reglas¶

Las plantillas se copian, no se editan directamente.
Las instancias viven en otras carpetas o en Storage.

5. Qué NO debe vivir en el repositorio¶

Para mantener el repositorio limpio y gobernado, no deben vivir aquí:

outputs semanales o periódicos,
resultados generados por IA en ejecución,
logs operativos,
históricos crecientes,
archivos grandes o binarios,
documentos “vivos” que cambian constantemente.

Estos elementos pertenecen al Storage.

6. Relación con Storage (recordatorio)¶

El Repo define el sistema.
El Storage registra su uso real.
La estructura del Storage refleja de forma operativa lo que aquí se define a nivel conceptual.

7. Idea clave final¶

El repositorio del Sistema de Decisión Asistida de BKM
no es un archivo ni un Drive,
sino la fuente de verdad del diseño, las reglas y la coherencia del sistema.

Este documento existe para que esa estructura sea: - clara, - compartida, - y sostenible en el tiempo.

✅ Estado del documento¶

Con este documento:

queda documentada la estructura del Repo,
se refuerza la separación Repo ↔ Storage,
y el SDA dispone de una base organizativa profesional, clara y escalable.