Ir al contenido

Índice Maestro — Prism Dev Operating Model

APP-000 es el primer contenido de la Base de Conocimiento de Prism. Documenta el modelo operativo del área de Tecnología y es la fuente de consulta 1A del equipo y de todo nuevo ingreso. Está sujeta al mismo régimen que el resto de la Base: los agentes de documentación (⑦ Publisher, ⑩ Knowledge Curator) la mantienen, todo archivo lleva fecha y fuente, y su desactualización se trata como falla operativa.

Dónde vive. Todo el contenido navegable —las secciones 00–11 del modelo y los docs por app— vive en docs/internal/, uniforme con todos los repos (lo que se sincroniza es siempre docs/). El tooling accionable que otros repos jalan (skills de agentes, hooks, plantillas) no es documentación del sitio: es código/config y vive en su propia carpeta de herramientas, fuera del flujo de docs. Un programador nuevo se forma leyendo docs/internal/. (Detalle: sección 06.)

Política de onboarding: la comprensión de la arquitectura y del proceso aquí documentados es requisito previo para escribir código en Prism (desarrollo en secciones 03 y 11).

  • Formato: todo documento se produce en Markdown. Word solo para entregables externos que lo exijan.
  • Idioma: la documentación se escribe y se publica en español. Va en inglés la nomenclatura y los identificadores del sistema —artefactos, columnas, campos, estados, nombres de agentes, comandos, rutas de repositorio—, no la prosa que los explica. La consecuencia estructural: los portales publican un solo idioma y sin prefijo de locale en la URL (/internal/modelo-operativo/…, no /internal/es/…), no hay árbol en/ ni carpetas de idioma dentro de un tier, y el gate docs-lint y el sync rechazan las que aparezcan. Abrir un segundo idioma sería una decisión de política, no un pendiente técnico.
  • Front-matter: todo archivo de la Base lleva title, owner, last_verified, sources y version; agent es opcional. El gate docs-lint lo hace cumplir.
  • Versionado: cada documento lleva su versión en el front-matter y un historial de versiones al pie.
  • Mantenimiento: al concluir cada sesión de trabajo sobre esta documentación se verifica la coherencia de los documentos afectados y se actualiza este índice.
# Sección Contenido Documento
00 Índice Maestro Este documento: mapa y reglas permanentes 00_Indice_Maestro.md
01 Visión y Tesis Resumen ejecutivo: tesis, problema, cambio de modelo, principios enunciados, expectativa de resultados 01_Vision_y_Tesis.md
02 Modelo Operativo — Concepto y Principios Por qué existe el modelo, la Base de Conocimiento, el ciclo del contexto y el Plan, los 6 principios, la escalera de autonomía, los antipatrones (incl. A8 independencia de herramienta) 02_Modelo_Operativo.md
03 Estructura Organizacional Composición del equipo, doctrina humano–agente, descriptivos integrados de los tres roles con KPIs extraíbles, ritmo operativo, política de onboarding 03_Estructura_Organizacional.md
04 Roster de Agentes Los 10 agentes (ficha de nueve campos), estándares de construcción (E1–E10), umbrales de calibración, infraestructura de pairing, orden de activación 04_Roster_de_Agentes.md
05 Flujo de Trabajo Los dos pipelines (Definición / Ejecución), puntos de inserción de agentes, la fase Design, Ops Health, Troubleshooting y hotfix 05_Flujo_de_Trabajo.md
06 Arquitectura de Información Capas A/B/C como clasificación por alcance, separación SeaTable/Git, ubicación del contenido y del tooling, el status.md, tres tiers, generación de vistas 06_Arquitectura_de_Informacion.md
06a Mapa de documentación por repo Qué tiers lleva cada repo activo y por qué; la regla de asignación de public/; los repos fuera del mapa 06a_Mapa_de_Documentacion_por_Repo.md
07 Tablero Kanban y Tabla Changelog Columnas, compuertas, campos y sus responsables; la regla “una columna sin lector no es un estado” En desarrollo — ver T0
08 Gobernanza Configuración de agentes como código, rituales de promoción y corrección, enmienda de criterios, independencia de herramienta En desarrollo — ver T0
09 Políticas Vigentes Núcleo normativo: Flujo de Trabajo, Control de Versiones, CI/CD, Design Tokens, npm link (el ensayo en docs/internal; su forma ejecutable como tooling) En desarrollo — ver T0
10 Glosario Términos del modelo 10_Glosario.md
11 Onboarding y Evaluación Sistema de verificación de comprensión (quizzes a la semana, mes y trimestre); instrumento de la política de onboarding Reservada

Nota de transición. Mientras dura la implementación del modelo, el estado de desarrollo de cada sección, las decisiones abiertas y el registro de decisiones se gestionan en T0_Gestion_del_Rediseno.md (Bloque II). Ese documento se archiva al concluir la transición; este índice permanece.


Versión Fecha Cambio
v3.8 2026-09-08 Regla de idioma explícita como política: la documentación se publica en español y el inglés queda acotado a los identificadores del sistema. Se retira la dimensión de idioma de la plataforma: los sitios publican sin prefijo de locale (/internal/…), desaparece el árbol en/ y las carpetas de idioma dentro de un tier pasan a ser un error del gate y del sync. Implementación en la Capa B (plataforma-documentacion/architecture.md §3.1, §4, §5, §7).
v3.7 2026-09-03 Página 06a publicada (06a_Mapa_de_Documentacion_por_Repo.md). El contenido del modelo pasa a docs/internal/modelo-operativo/ como primer módulo de la documentación.
v3.6 2026-09-03 Sección 06 publicada (06_Arquitectura_de_Informacion.md).
v3.5 2026-09-03 Post-reunión: contenido del modelo (00–11) se ubica en docs/internal/ uniforme con todos los repos; dev-standards/ como carpeta de contenido se retira (el tooling accionable —skills, hooks, plantillas— vive como código/config, fuera del flujo de docs). Se elimina el mnemónico docs/internal vs dev-standards.
v3.4 2026-09-01 Reforma 2026-09-01. Conteo de agentes 11 → 10; mantenimiento por ⑦ Publisher y ⑩ Knowledge Curator (antes ⑨/11). Descripciones de 02 (A8), 04 (10 agentes), 05 (dos pipelines, Design), 06 (status.md, docs/internal vs dev-standards), 07 (regla de columna), 09 (dos piezas) actualizadas. Regla de ubicación (docs/internal vs dev-standards) y reglas de idioma/front-matter añadidas. Front-matter YAML.
v3.3 2026-07-03 Sección 04 publicada (04_Roster_de_Agentes.md).
v3.2 2026-07-03 Sección 03 publicada (03_Estructura_Organizacional.md).
v3.1 2026-07-03 Glosario extraído a 10_Glosario.md; el índice queda solo como mapa y reglas.
v3.0 2026-07-03 El índice se vuelve atemporal: solo mapa y reglas permanentes. Todo el rastreo de la transición se consolida en T0_Gestion_del_Rediseno.md.
v2.x 2026-07-03 Dos bloques; renumeración; convención de estados; sección 02 a nivel 🔵.
v1.x 2026-07-02 Versiones iniciales del índice del rediseño.