--- type: ARQ asset_id: ARQ-MPX-FlashCards-v01 version: v01 status: Draft owner: Victor Heredia sherpa_owner: AniX operadora: Anahí fecha_creacion: 2026-06-12 fecha_ultima_actualizacion: 2026-06-12 intellbank: IB-MPX-MasterPlaybooks subbank: IB-MPX-Publications/MasterFlashCards proposito: ARQ · FlashCard Factory · Arquitectura Conceptual · IB-MPX-MasterPlaybooks referencias: - ARQ-MPX-BookFactory-Architecture-v01 - PL-FLASHCARDS-EL-v01 --- # ARQ · FlashCard Factory ## Factoría de Decks de Tarjetas · Arquitectura Conceptual --- ## Asset Header | Campo | Valor | |---|---| | **Asset ID** | ARQ-MPX-FlashCards-v01 | | **Título** | FlashCard Factory — Arquitectura Conceptual | | **Versión** | v01 | | **Status** | Draft | | **Owner** | Victor Heredia | | **Operadora** | Anahí + AniX | | **Gate final** | Victor Heredia (QA · aprobación) | | **Layer BMF** | L2 — MetaFactory | | **Proyecto Padre** | Big MetaFactory · P1 — MetaFactory de MasterPlaybooks Inteligentes | | **Fecha** | 2026-06-12 | --- ## 1. Posición en el Ecosistema Big MetaFactory La FlashCard Factory es una **MetaFactory de nivel L2** dentro del ecosistema Big MetaFactory. Sus outputs son derivados editoriales — no contenido original. ``` L0 — Big MetaFactory Kernel (Constitución del ecosistema) L1 — MetaPlaybook Builder (Protocolo para crear MetaFactories) L2 — FlashCard Factory ◄ AQUÍ (Esta MetaFactory: produce Decks de Tarjetas) L3 — FlashCard Factory Operations (Cómo operar una instancia, fuente por fuente) L4 — Production Assets (Decks .md, RunLogs, Briefs de Diseño) ``` **Relación con el resto del ecosistema:** - Hereda las invariantes globales del BMF Kernel (L0) - Sus inputs son activos **ya publicados** en el catálogo MasterPlaybooks (resúmenes, playbooks, masterplaybooks) o libros crudos disponibles - Sus outputs alimentan la plataforma MasterPlaybooks como contenido derivado - La Production Line operativa es `PL-FLASHCARDS-EL-v01` (instancia EmpowerLabs) **Clase de proyecto:** MetaFactory (Template). Cada fuente procesada es una **Factory Instance** (FI-FC-001, FI-FC-002...). --- ## 2. Qué produce esta factoría Una fábrica que transforma activos publicados del catálogo MasterPlaybooks — y libros crudos disponibles — en decks de tarjetas para estudio, referencia rápida y distribución editorial. **Escala objetivo:** 5 decks/semana. **Intervención humana:** 2 checkpoints en este pipeline. **Formato de todos los entregables:** `.md`. --- ## 3. Variantes de Output — Tipos de Fuente y Cantidad de Tarjetas La cantidad de tarjetas por deck varía según la densidad informativa de la fuente. | Tipo de fuente | Ejemplos | Tarjetas por deck | |---|---|---| | **Resumen de libro** | `RES-MPX-*` (Book Factory output) | **10 tarjetas** | | **Mini Playbook** | `Rn-MINIPLAYBOOKS-*` | **10 tarjetas** | | **Playbook completo** | `PB-MPX-*` | **20 tarjetas** | | **MasterPlaybook** | `MPB-MPX-*` | **20 tarjetas** | | **Libro crudo disponible** | Libro completo sin resumen publicado | **20 tarjetas** | **Regla de variante:** el tipo de fuente determina la cantidad en FC2 (extracción). No se ajusta después. - **10 tarjetas:** resúmenes de libro, mini playbooks - **20 tarjetas:** playbooks completos, masterplaybooks, libros crudos ### Formato de cada tarjeta (aplica a todas las variantes) | Campo | Regla | |---|---| | **Frente** | Concepto clave en 1 frase · máximo 15 palabras | | **Reverso** | Acción + consecuencia directa · máximo 3 líneas cortas · VVP (Voz Viva Prescriptiva) | **VVP — Voz Viva Prescriptiva:** segunda persona, presente, orientada a acción. El reverso le dice al lector qué hacer y qué pasa si no lo hace — nada más. Sin explicaciones, sin contexto, sin desarrollo. --- ## 4. Pipeline FC1–FC7 ``` FUENTE PUBLICADA (o libro crudo disponible) │ ▼ FC1 — SELECCIÓN Y CLASIFICACIÓN DE FUENTE (5 min) Anahí selecciona el activo · asigna tipo de fuente → determina variante (10 o 20 tarjetas) │ ▼ FC2 — EXTRACCIÓN DE CONCEPTOS (1 min) AniX identifica los N conceptos clave según variante │ ▼ FC3 — REDACCIÓN FRENTE + REVERSO (2 min) AniX redacta las N tarjetas en VVP │ ▼ FC4 — REVISIÓN ANAHÍ ◄ CHECKPOINT HUMANO #1 (10 min) · ¿Los frentes son memorables y claros (≤ 15 palabras)? · ¿Los reversos son accionables y en VVP? · ¿La tabla está completa (10 o 20 según variante)? │ ▼ FC5 — GATE VICTOR ◄ CHECKPOINT HUMANO #2 (10 min · asíncrono) Victor aprueba en bloque: PASS / FAIL │ ▼ FC6 — BRIEF A DISEÑO Anahí envía BRIEF-DISEÑO-FC-[SLUG]-v01 a Paloma/Ángeles (Diseño no bloquea publicación — regla G-05) │ ▼ FC7 — PUBLICACIÓN Y REGISTRO Publicar deck · Registrar en LOG-PUB-EL-v01 ``` **Regla de secuencia:** Las estaciones no se pueden reordenar. FC3 depende de FC2; FC4 depende de FC3 completo. --- ## 5. Mapa de Estaciones — Definición y DoD --- ### Estación FC1 — SELECCIÓN Y CLASIFICACIÓN DE FUENTE **BMF Station Type:** Transfer Packet (TP) **Propósito:** Capturar el input gobernado que activa la Factory Instance y asignar la variante correcta. **Asset ID pattern:** `TP-FC-[SLUG]-v{N}.yaml` **Formato:** `.yaml` **Campos del Transfer Packet:** | Campo | Tipo | Función | |---|---|---| | `fuente_asset_id` | texto | Asset ID del activo fuente | | `titulo_set` | texto | Nombre descriptivo del deck | | `tipo_fuente` | enum: `resumen / mini-pb / playbook / masterplaybook / libro-crudo` | Determina la variante (10 o 20) | | `variante` | enum: `10 / 20` | Cantidad de tarjetas (derivado del tipo) | | `factory_instance_id` | texto `FI-FC-{NNN}` | ID de la instancia | | `status_global` | enum: `Draft / InProgress / QA / Publicado / Paused` | Estado actual | | `operadora` | texto | Responsable de la corrida | **Regla:** Sin Transfer Packet completo, la Factory Instance no arranca. **DoD — FC1:** - [ ] 7 campos completos y coherentes - [ ] `tipo_fuente` asignado y `variante` derivada correctamente - [ ] Factory Instance registrada con ID asignado - [ ] Activo fuente confirmado como publicado (o libro crudo disponible) --- ### Estación FC2 — EXTRACCIÓN DE CONCEPTOS **BMF Station Type:** Insight Pack (IP) **Propósito:** Identificar los N conceptos más relevantes y accionables del activo fuente. **Asset ID pattern:** (interno · no se guarda como asset independiente; forma parte del draft FC3) **Formato:** lista en borrador **Criterios de selección de conceptos:** - Preferir conceptos que generan una acción concreta sobre conceptos puramente descriptivos - Distribuir los conceptos a lo largo de toda la fuente (no solo la introducción o primeros capítulos) - Cada concepto debe ser distinguible de los demás (sin solapamientos) **DoD — FC2:** - [ ] Lista de N conceptos identificados (N = variante asignada en FC1) - [ ] Conceptos distribuidos a lo largo de la fuente completa - [ ] Sin solapamientos entre conceptos --- ### Estación FC3 — REDACCIÓN FRENTE + REVERSO **BMF Station Type:** Writer OS **Propósito:** Producir el deck completo en formato tabla. **Asset ID pattern:** `FC-[SLUG]-v{N}.md` **Formato:** `.md` **Estructura del output:** ```markdown --- asset_id: FC-[SLUG]-v01 tipo: FC fuente: [Asset ID de la fuente] variante: [10 / 20] owner: Victor Heredia operadora: Anahí sherpa: AniX status: Draft --- # FlashCards · [Título del Set] | # | Frente | Reverso | |---|--------|---------| | 1 | [concepto en 1 frase · máx 15 palabras] | [descripción accionable · 2-4 líneas · VVP] | | 2 | ... | ... | ... | N | ... | ... | ``` **DoD — FC3:** - [ ] Tabla completa con N tarjetas (según variante) - [ ] Todos los frentes ≤ 15 palabras - [ ] Todos los reversos en VVP (segunda persona, presente, acción) - [ ] Todos los reversos en máximo 3 líneas cortas (acción + consecuencia directa · sin desarrollo) - [ ] Frontmatter completo con asset_id, fuente, variante, owner, operadora, sherpa, status --- ### Estación FC4 — REVISIÓN ANAHÍ *(Checkpoint Humano #1)* **BMF Station Type:** Human Gate **Propósito:** Validación editorial por la operadora antes de escalar a Victor. **Checklist de revisión:** | Criterio | Pasa | Falla | |---|---|---| | Frentes memorables y claros | Captura el concepto en una lectura | Ambiguo, genérico o demasiado largo | | Frentes ≤ 15 palabras | Dentro del límite | Excede el límite | | Reversos accionables | Acción + consecuencia directa | Solo describe, define o desarrolla | | Reversos en VVP | Segunda persona, presente | Tercera persona o pasivo | | Reversos ≤ 3 líneas cortas | Digerible de un vistazo | Más de 3 líneas o líneas demasiado largas | | Tabla completa | N tarjetas exactas | Falta alguna tarjeta | **Resultado:** PASS → avanza a FC5. FAIL → regresa a FC3 con comentarios específicos. **DoD — FC4:** - [ ] Todos los criterios del checklist revisados - [ ] PASS confirmado por Anahí, o feedback específico enviado a FC3 --- ### Estación FC5 — GATE VICTOR *(Checkpoint Humano #2)* **BMF Station Type:** Human Gate (asíncrono) **Propósito:** Aprobación editorial final antes de publicar. **Formato de envío a Victor:** deck completo en `.md` + fuente referenciada. **Resultado esperado:** PASS en bloque o FAIL con comentarios. **Threshold:** - **PASS** → avanza a FC6 y FC7 - **FAIL** → regresa a FC3 (o FC2 si los conceptos son el problema) **DoD — FC5:** - [ ] PASS de Victor registrado (o FAIL con comentario documentado) --- ### Estación FC6 — BRIEF A DISEÑO **BMF Station Type:** Dispatch **Propósito:** Entregar el brief visual a diseño para producir la versión gráfica del deck. **Asset ID pattern:** `BRIEF-DISEÑO-FC-[SLUG]-v{N}.md` **Formato:** `.md` **Regla G-05:** El brief a diseño no bloquea la publicación de la tabla `.md`. Son paralelos. **Contenido mínimo del brief:** - Asset ID del deck aprobado - Número de tarjetas y variante - Fuente del contenido - Paleta de colores recomendada (si aplica) - Fecha límite (si aplica) **DoD — FC6:** - [ ] Brief enviado a Paloma/Ángeles - [ ] Confirmación de recepción registrada --- ### Estación FC7 — PUBLICACIÓN Y REGISTRO **BMF Station Type:** Logging / Control Plane **Propósito:** Publicar el deck, registrar la Factory Instance como completada. **Asset ID pattern:** `RL-FC-[SLUG]-v{N}.md` **Formato:** `.md` checklist **Sub-pasos:** **FC7-A — Publicación del deck** - Publicar `FC-[SLUG]-v01.md` en la ubicación canónica: `IB-MPX-MasterPlaybooks/IB-MPX-Publications/MasterFlashCards/` - Confirmar que el frontmatter está completo y `status` → `Publicado` **FC7-B — Cierre de producción** - Actualizar el TP (FC1): `status_global` → `Publicado` - Registrar en `LOG-PUB-EL-v01`: fecha, asset_id, fuente, operadora - Actualizar Registry Master de FlashCards **DoD — FC7:** - [ ] Deck publicado en ubicación canónica con status `Publicado` - [ ] TP actualizado - [ ] Entrada en LOG-PUB-EL-v01 creada - [ ] Registry Master actualizado --- ## 6. Mapa Completo de Artefactos | Asset ID | Nombre | Formato | Estación | |---|---|---|---| | `TP-FC-[SLUG]-v{N}.yaml` | Transfer Packet · Ficha de Producción | `.yaml` | FC1 | | `FC-[SLUG]-v{N}.md` | Deck de FlashCards | `.md` | FC3 | | `BRIEF-DISEÑO-FC-[SLUG]-v{N}.md` | Brief Visual a Diseño | `.md` | FC6 | | `RL-FC-[SLUG]-v{N}.md` | RunLog · Registro de Publicación | `.md` | FC7 | ### Familias de artefactos ``` Familia OPERATIONS (gobernanza y trazabilidad) ├── TP-FC — Transfer Packet · Ficha de Producción └── RL-FC — RunLog · Registro de Publicación Familia CONTENT (artefacto para el lector) └── FC — Deck de FlashCards .md Familia DESIGN (artefacto para producción visual) └── BRIEF-DISEÑO-FC — Brief Visual ``` --- ## 7. Checkpoints Humanos | # | Estación | Qué revisa | ¿Puede bloquear? | |---|---|---|---| | **CP-1** | FC4 — Revisión Anahí | Calidad editorial completa del deck | Sí — regresa a FC3 | | **CP-2** | FC5 — Gate Victor | Aprobación editorial final | Sí — regresa a FC3 o FC2 | --- ## 8. Invariantes de la FlashCard Factory Reglas que nunca se rompen. Si se rompen → **stop-the-line.** 1. **Sin TP, no hay corrida.** La Factory Instance no arranca sin Transfer Packet completo. 2. **La fuente siempre es un activo publicado o libro crudo disponible.** No se producen FlashCards de contenido en borrador. 3. **La variante la determina el tipo de fuente, no el operador.** Resúmenes de libro + Mini Playbooks = 10. Playbooks completos + MasterPlaybooks + libros crudos = 20. 4. **FC3 depende de FC2 completo.** No se redactan tarjetas sin tener primero la lista de conceptos. 5. **El gate de Victor es obligatorio.** Ningún deck se publica sin PASS de FC5. 6. **Diseño no bloquea publicación** (regla G-05). El deck `.md` se publica en paralelo al proceso de diseño. 7. **Todo asset tiene ID + versión + owner + status.** 8. **Todos los entregables en `.md`** salvo indicación explícita en el TP. 9. **Ubicación canónica única:** `IB-MPX-MasterPlaybooks/IB-MPX-Publications/MasterFlashCards/`. --- ## 9. Anti-Patterns | Anti-pattern | Por qué falla | Corrección | |---|---|---| | Producir FlashCards de un borrador | Contenido no estabilizado → tarjetas que quedarán desactualizadas | La fuente debe estar publicada o ser libro crudo disponible | | Usar 20 tarjetas para un resumen de libro o mini playbook | Menor densidad informativa → tarjetas redundantes o superficiales | Resúmenes + Mini Playbooks → 10 tarjetas sin excepción | | Reversos descriptivos en lugar de accionables | No aportan valor de uso al lector | Cada reverso responde "¿qué hago con esto?" y "¿qué pasa si no?" | | Reversos con más de 3 líneas | Pierden digestibilidad — el lector no los retiene | Acción + consecuencia directa · cortar todo lo demás | | Frentes > 15 palabras | Demasiado largo para memorización rápida | Reformular como concepto central en una frase corta | | Conceptos concentrados en el inicio de la fuente | Sesgo hacia introducción → ignora el cuerpo y cierre | Distribuir extracción a lo largo de toda la fuente | | Publicar sin PASS de Victor | Saltarse el gate final | FC5 es invariante — no tiene bypass | | Deck sin frontmatter completo | Imposible trazar ni versionar | Frontmatter completo desde FC3 | --- ## 10. Track A vs Track B | Track | Cuándo se usa | Versionado | |---|---|---| | **Track A (Governed)** | Cambios en variantes, cantidad de tarjetas, criterios de VVP, estructura del pipeline | Versión mayor: v01 → v02 | | **Track B (Fast Lane)** | Formato, claridad, orden — sin alterar significado o estructura | Versión menor: v01 → v01.1 | --- ## 11. Control Plane ### Registry Master de FlashCards | Campo | Tipo | |---|---| | FC ID | `FC-001`, `FC-002`... | | Título del set | texto | | Tipo de fuente | resumen / mini-pb / playbook / masterplaybook / libro-crudo | | Variante | 10 / 20 | | Fuente Asset ID | texto | | Status | Draft / InProgress / QA / Publicado / Paused | | Estación actual | FC1 / FC2 / FC3 / FC4 / FC5 / FC6 / FC7 | | Gate Victor | PASS / FAIL / PENDING | | Operadora | nombre | | Fecha inicio | fecha | | Fecha publicación | fecha o OPEN | | Assets producidos | IDs separados por coma | ### RunLog Una entrada por sesión: Set · Estación ejecutada · Operadora · Input · Output · Incidencias · Fecha. --- ## 12. Estado Actual | Estación | Nombre | Status | |---|---|---| | FC1 | Selección y Clasificación | ✅ Definida | | FC2 | Extracción de Conceptos | ✅ Definida | | FC3 | Redacción Frente + Reverso | ✅ Definida | | FC4 | Revisión Anahí | ✅ Definida | | FC5 | Gate Victor | ✅ Definida | | FC6 | Brief a Diseño | ✅ Definida | | FC7 | Publicación y Registro | ✅ Definida | ### Decks producidos (Factory Instances) | ID | Set | Tipo de fuente | Variante | Status | |---|---|---|---|---| | — | — | — | — | Pendiente primera corrida | --- ## CHANGELOG | Versión | Fecha | Cambio | |---|---|---| | v01 | 2026-06-12 | Creación. Arquitectura formal de la FlashCard Factory: 2 variantes (10/20 tarjetas por tipo de fuente), pipeline FC1-FC7, DoD por estación, invariantes, anti-patterns, mapa de artefactos y control plane. | --- *ARQ-MPX-FlashCards-v01 · Owner: Victor Heredia · Operadora: Anahí + AniX* *Documento vivo · Track A para cambios estructurales · Track B para claridad y formato*