---
type: DC
asset_id: DC-EL-LoopX-XDocMaestro-HubSpoke-v01
version: v01
status: Active — ratificación implícita en uso (Victor define el patrón, 2026-06-11)
owner: Victor Heredia
sherpa_owner: Jay
ratificador: Victor Heredia
fecha_creacion: 2026-06-11
intellbank: IB-EL-EmpowerLabs
subbank: PB-EL-Project-Bank/PB-LoopX
proposito: Spec del patrón Hub-and-Spoke de XDocs Maestros (clientes y productos) + regla de fractalidad del MacroLoopX. Base de la arquitectura de factorías
relacionados: "PP-EL-LoopX-MacroLoopX-Arquitectura-v01 · BRD-EL-MacroLoopX-Dashboard-v02 · BRD-EL-MacroLoopX-Clientes-v01 · XD-EL-Loop-HiOrg-Posta-v01"
tags: [xdoc, maestro, hub-spoke, fractal, macroloopx, arquitectura]
---

# XDoc Maestro — patrón Hub-and-Spoke
## La página central de cada entidad + la regla fractal del MacroLoopX

## 1. El patrón

| Pieza | Qué es | Ciclo de vida |
|-------|--------|----------------|
| **XDoc Maestro (hub)** | LA página central de una entidad (cliente o producto): identidad, estado actual en cada loop, historial de transiciones, links a todos sus spokes y activos | UNO por entidad. Permanente — vive mientras viva la relación/producto. Nunca se reemplaza; se actualiza con bitácora |
| **XDoc de Loop (spoke)** | El documento de trabajo de la entidad DENTRO de un loop específico (ej. XD-EL-Loop-HiOrg-Posta = spoke de ventas de Posta) | Se abre solo cuando el loop exige gestión propia. Se sella al cerrar el loop; el resumen sube al Maestro |

**Regla de apertura de spoke:** si la entrada a un loop solo cambia la FASE → se actualiza el estado en el Maestro (una línea + bitácora). Si el loop tiene **equipo + entregables + tablero propios** (una operación de delivery, un proyecto, una negociación compleja) → se abre XDoc de loop, enlazado bidireccionalmente al Maestro.

## 2. Naming

- **Maestro de cliente:** `XD-[ENT]-CLI-[Cliente]-Master-v01` (ej. XD-EL-CLI-Posta-Master-v01)
- **Maestro de producto:** `XD-[ENT]-PRD-[Producto]-Master-v01` (ej. XD-EL-PRD-EScan-Master-v01)
- **Spoke de loop:** `XD-[ENT]-[Loop]-[Entidad]-vNN` (ej. XD-EL-LoopXOP-Posta-EScan-v01 cuando arranque el delivery) — el patrón existente XD-EL-Loop-HiOrg-Posta se respeta como spoke de LoopXSA
- Ubicación: el Maestro vive en el PB de su dominio (clientes → PB-LoopX o el PB del cliente si existe; productos → su PB de producto)

## 3. Estructura mínima del Maestro (plantilla)

1. **Header**: identidad + tripleta + estado macro (en qué loop(s) está HOY)
2. **Tablero de loops**: tabla loop × estado × spoke (link) × última transición
3. **Mapa de activos**: links a todo lo que existe de la entidad (dossiers, ofertas, propuestas, contratos, casos)
4. **Bitácora de transiciones**: cada cruce de gate con fecha (la fuente de verdad del historial)
5. **NEXTs vivos**

## 4. Integración con tableros

Los tableros (BRD-MacroLoopX-Dashboard y BRD-MacroLoopX-Clientes) enlazan cada tarjeta a su XDoc Maestro vía URI de Obsidian (`obsidian://open?vault=Intellibanks&file=...`). **El tablero visualiza; el Maestro es la fuente de verdad.** Toda tarjeta sin Maestro se marca "por crear" — deuda visible.

## 5. La regla fractal (caso MONEX)

El MacroLoopX es **recursivo**. Cuando un producto madura a Operación y se convierte en un negocio/línea propia:

```
MacroLoopX(EL)                         ← desarrolla el producto MONEX
   └── PRD-MONEX llega a LoopXOP
        └── instancia MacroLoopX(MONEX)   ← su propia fábrica completa
              ├── productos de MONEX (su LoopXPR→OP)
              ├── clientes de MONEX (su tablero de clientes)
              └── su LoopXKZ propio
```

- Cada instancia hereda la arquitectura (5 loops, Loop Contracts, gates, tableros A/B) pero opera con su equipo y gobernanza.
- Los clientes de MONEX viven en el tablero de clientes de MONEX — **no** en el de EL. En el tablero EL, MONEX aparece una sola vez como producto (y/o cliente) con link a su instancia.
- Esto ES la arquitectura de factorías: **una factoría = la instancia del MacroLoopX de un dominio**, con sus XDocs Maestros como columna vertebral.

## 6. Primeros maestros creados

- [[XD-EL-CLI-Posta-Master-v01]] — cliente (enlaza el spoke de ventas existente)
- [[XD-EL-PRD-EScan-Master-v01]] — producto (enlaza todos los activos del kit)
- Resto de entidades: se crean al tocarlas (regla: ninguna entidad entra a un tablero sin Maestro o marca "por crear")

## CHANGELOG

| Versión | Fecha | Cambio |
|---------|-------|--------|
| v01 | 2026-06-11 | Creación. Patrón hub-and-spoke (Maestro permanente + spokes por loop con regla de apertura), naming, plantilla, integración obsidian:// en tableros y regla fractal (caso MONEX) |