No son plantillas de moda. Son objetos del método.
Nacen del temario, de las duplas, de los casos en producción y de los formatos del Parte. Todas viven en esta página: navega por mesas, abre la ficha, úsala hoy en tu equipo. Si quieres llevarlas a tu sistema con tutoría, el programa es el camino largo.
Duplas
La unidad no es la persona: es la pareja que envía un Caso.
Contrato Semana 1 · Notion Contrato de dupla Quién decide el sistema y quién orquesta a los agentes — por escrito, antes del primer commit.
La unidad del Instituto no es la persona suelta: es la dupla. Este contrato no es legalismo de RRHH. Es el acuerdo de oficio: una mitad pone el criterio de diseño (reglas, tokens, límites); la otra orquesta (agentes, CI, traza). Sin ese reparto, el agente se convierte en un tercer compañero confuso.
Las dos sillas (no se mezclan a medias)
| Silla | Decide | No decide sola |
|---|---|---|
| Criterio | Principios ejecutables, vocabulario, qué no se delega | Qué modelo se invoca ni el pipeline |
| Orquestación | Herramientas, MCP, gates de CI, logs | Qué es “correcto” en diseño |
Cláusulas mínimas (rellenar juntos)
- Caso conjunto: nombre del proyecto que enviaréis (aunque sea interno).
- Frecuencia de mesa: cuándo se reúne la dupla sin el agente en la sala.
- Veto: cada silla puede parar un merge del agente; se registra por qué.
- Firma: dos nombres. Si solo firma uno, no es dupla: es freelancing con copiloto.
Ejemplo (sofisticado)
Criterio: Marta · Orquestación: Leo
Caso: Kit de tokens DTCG del design system de pagos
Veto de Marta: ningún color primitivo en componentes generados.
Veto de Leo: ningún agente con write en producción sin PR humana.
En el programa
Se practica desde la semana 01 (auditoría) y se sella en el Caso publicado y el registro de duplas. La empresa no puede “montar” esta química en un proceso de selección: la envía el Instituto.
Captación
Si ya venís en pack o queréis que os emparejemos: solicitar plaza o la clase del 10 sep.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Plantilla Semana 8 · Markdown Ficha de dupla publicable La plantilla del sello: no se autodescribe, enseña el Caso enviado.
Una ficha de LinkedIn la rellena cualquiera. Una ficha de dupla I.D.A. solo existe si hay un Caso publicado con nombre. Este es el esqueleto que usamos en el registro.
Campos obligatorios
- Sello: Dupla certificada · Promoción
- Silla de criterio (nombre + una línea de qué decide)
- Silla de orquestación (nombre + una línea de qué opera)
- Caso enviado (título + enlace): sin esto, la ficha no se publica
- Tres veredictos del panel (por dimensión clave)
Anti-patrón
“Experiencia en design systems + IA” sin proyecto. Eso es perfil, no ficha.
En el programa
El demo day y la carta del Instituto alimentan esta ficha. No se rellena el día 1: se gana.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Ritual Semana 3 · Calendar Protocolo de mesa sin agente La reunión donde la dupla decide solo con criterio humano — y deja acta.
Si todas las reuniones incluyen al agente “en la sala” (pantalla compartida generando), la dupla deja de existir: solo queda un prompt compartido. El protocolo de mesa sin agente fija un hueco semanal donde solo hablan las dos sillas.
Orden del día fijo (30 min)
- Excepciones abiertas (lo que el agente no pudo resolver).
- Un principio en disputa (¿sigue siendo evaluable?).
- Una decisión de no-delegar nueva (o retirada).
- Acta en tres líneas, firmada por ambas sillas.
En el programa
Es la contraparte cultural de la governance técnica (semanas 03–05).
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Playbook Semana 1 · Formulario Emparejamiento por Caso (no por skill matrix) Cómo formamos duplas dentro del programa: el proyecto manda, no el radar de soft skills.
No emparejamos “un diseñador senior con un dev que sabe Claude”. Emparejamos dos sillas alrededor de un Caso que ya duele.
Señales de emparejamiento
- Mismo dominio (pagos, editorial, marketplace…) o misma deuda (tokens sin semántica).
- Una persona ya “sufre” el sistema; la otra ya “sufre” el pipeline.
- Disponibilidad de mesa semanal real (no “ya veremos”).
Señal de no-emparejar
Dos genéricos que “quieren aprender IA”. Sin Caso, la dupla es un club de lectura.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Acta Semana 5 · MCP El tercero en la dupla (rol del agente) El agente no es silla: es herramienta con permiso acotado. Esta ficha lo nombra.
La dupla son dos humanos. El agente es el tercero: no vota, no firma, no tiene veto. Esta acta evita el error cultural de tratar al modelo como “tercer compañero de equipo”.
Campos
- Nombre del agente / pipeline (no el modelo comercial: el rol en tu sistema).
- Permisos: lectura / escritura / solo PR.
- Superficies: tokens, componentes, copy, datos de usuario (casi nunca).
- Condición de apagado: cuándo se desconecta sin debate.
Ejemplo (Bodados-style)
Agente de invitados: write solo con auth.getUser() y ownership de la boda. Sin token de sesión → 401, no “lo siento”.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Checklist entrada · Solicitud Checklist de pack (venís juntos) Si ya sois pareja de oficio, esto decide si el pack entra o se disuelve en el filtro.
Venir en pack es opcional. Cada mitad pasa el filtro igual. Esta checklist evita el “traigo a mi amigo al bootcamp”.
- Cada uno puede articular la silla que ocupa sin mirar al otro.
- Hay un Caso real (aunque sea del trabajo) que ambos tocarán.
- Ninguno necesita al otro para “aprobar” el programa: la plaza es individual.
- El pack no es un escudo: si uno no da el nivel, no entra “por pareja”.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Plantilla oficio · Email Carta a la empresa · por qué contratáis una dupla Texto listo para el hiring manager: la unidad no se ensambla en un proceso de selección.
Las empresas intentan contratar “un unicornio de design systems + IA”. Fracasan porque la química de la dupla se forma enviando un Caso, no en una entrevista de 45 minutos.
Estructura de la carta
- El problema: un perfil no cubre criterio + orquestación.
- La prueba: Caso publicado / demo day.
- El sello: lo que certifica el Instituto (y lo que no).
- La propuesta: contratar la dupla o el pack de dos plazas.
Enlace natural: duplas y solicitud.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Ritual Semana 1 · Mesa Rito de apertura de dupla (día 0) Primera hora juntos: inventario de dolores, no tour de herramientas.
Prohibido abrir Claude “para ver qué sale”. El rito de apertura es solo humanos.
- Cada silla cuenta un fracaso reciente del sistema (5 min).
- Se elige un dolor compartido para las ocho semanas.
- Se nombra el Caso (aunque cambie después).
- Se firma el Contrato de dupla.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Genotipo del sistema
Lo que el sistema sabe como dato, no como captura.
Playbook Semana 3 · Obsidian Bóveda Obsidian para agentes (recolector de oficio) Obsidian no es un second brain de moda: es el genotipo en prosa versionable que el LLM usa para aprender y contrastar ejemplos.
La mayoría usa Obsidian como diario. Aquí lo usamos como recolector de conocimiento del design system agéntico: notas con estructura, enlaces, ejemplos buenos y malos, y una vía de exportación para que un LLM aprenda el criterio del equipo y contraste en lugar de adivinar.
No sustituye tokens ni MCP. Alimenta la capa de criterio (prosa evaluable + corpus de ejemplos) que el código y las tools no capturan solos.
1 · Qué problema resuelve
| Sin bóveda | Con bóveda |
|---|---|
| El criterio vive en Figma comments y Slack | El criterio es Markdown en Git |
| El agente solo ve tokens y adivina el “porqué” | El agente lee reglas + ejemplos ancla |
| Los ejemplos correctos se pierden en PRs viejas | Hay un golden set en prosa y capturas referenciadas |
| Cada persona “recuerda distinto” | La dupla enlaza la misma nota de principio |
2 · Anatomía de la bóveda (carpetas)
Copia esta raíz (nombres en castellano a propósito: el oficio se nombra como se habla):
ds-agentico/
00-indice.md ← mapa maestro (export → llms.txt)
01-no-delegables/ ← lo que el agente no hace nunca
02-principios/ ← un archivo = un principio ejecutable
03-vocabulario/ ← semántica de tokens (prosa + paths)
04-componentes/ ← contrato de cada componente
05-ejemplos/
correctos/ ← golden set
incorrectos/ ← contraejemplos etiquetados
contrastes/ ← pares A/B “por qué este sí / este no”
06-trazas/ ← salidas reales del agente + veredicto
07-casos/ ← casos de producto (contexto)
08-export/ ← generado: llms.txt, pack RAG, manifest.json
plantillas/ ← skeletons de notaRegla dura: nada de carpetas basura tipo “misc”. Si no cabe en una mesa del Instituto, no entra.
3 · Plantilla de nota · principio ejecutable
plantillas/principio.md:
---
tipo: principio
id: R-error-triad
silla: criterio
veredicto_si_falla: rechazado
gates: [a11y-error-triad]
updated: 2026-08-05
---
# Un error nunca va solo en color
## Condición observable
El mensaje de error de formulario expone color + icono + texto.
## Acción del agente
- Si cumple → puede proponer el patrón en PR.
- Si falla → no abre PR; crea item en cola de excepciones.
## Excepción
Ninguna en producto. Ilustraciones editoriales: ver nota [[excepcion-ilustracion-editorial]].
## Ejemplos ancla
- Correcto: [[ejemplos/correctos/form-error-triad]]
- Incorrecto: [[ejemplos/incorrectos/form-error-solo-rojo]]
- Contraste: [[ejemplos/contrastes/error-triad-vs-color]]El frontmatter es genotipo en miniatura: un LLM (o un script) puede filtrar por gates, silla, veredicto_si_falla.
4 · Plantilla de ejemplo (correcto / incorrecto / contraste)
plantillas/ejemplo.md:
---
tipo: ejemplo
clase: correcto | incorrecto | contraste
principio: R-error-triad
superficie: formulario
stack: [React, tokens]
---
# form-error-triad
## Qué se ve
(Descripción en 3 líneas; opcional: ruta a captura en /assets del repo, no blob de Slack.)
## Qué debe hacer el agente
Reutilizar `FormMessage variant="error"`; no inventar un `div` rojo.
## Señal de fallo
Solo cambia el color del borde sin icono ni texto.
## Contraste (solo si clase: contraste)
| | A (sí) | B (no) |
|--|--------|--------|
| Criterio | … | … |
| Por qué gana A | … | |Por qué los tres tipos
| Clase | Función para el LLM |
|---|---|
| correcto | Ancla positiva (golden) |
| incorrecto | Ancla negativa (qué no hacer) |
| contraste | Fuerza la discriminación: aprende el borde, no el promedio |
Sin contrasoles, el modelo “promedia” y devuelve mediocridad elegante.
5 · Flujo diario de la dupla (15 min)
- Criterio pega en
06-trazas/una salida del agente (enlace a PR o diff). - Marca veredicto: apto / condicionado / rechazado (los tres veredictos).
- Si es rechazado: crea o enlaza un incorrecto + actualiza el principio tocado.
- Si es apto y es nuevo: promueve a correcto (golden).
- Cada viernes: un contraste nuevo (aunque sea pequeño).
Obsidian aquí es el cuaderno de la mesa sin agente, no el chat del modelo.
6 · De la bóveda al LLM (export)
El valor no es “tener notas”. Es cerrar el circuito:
Obsidian (Git)
→ script de export
→ 08-export/llms.txt (índice)
→ 08-export/pack/*.md (corpus)
→ 08-export/manifest.json (ids, principios, hashes)
→ consumo
→ system prompt / project knowledge
→ RAG / embeddings (opcional)
→ recurso MCP `get_principle` / `list_examples`manifest.json (mínimo)
{
"system": "payments-ds",
"updated": "2026-08-05",
"principles": [{ "id": "R-error-triad", "path": "02-principios/error-triad.md" }],
"examples": {
"correct": ["05-ejemplos/correctos/form-error-triad.md"],
"incorrect": ["05-ejemplos/incorrectos/form-error-solo-rojo.md"],
"contrast": ["05-ejemplos/contrastes/error-triad-vs-color.md"]
},
"nonDelegables": ["01-no-delegables/merge-main.md"]
}Orden de lectura que debe respetar el agente
El mismo onboarding del agente al DS:
- No-delegables
- Índice (
llms.txt/00-indice.md) - Principios del dominio de la tarea
- Ejemplos correctos + contrastes del mismo principio
- Incorrectos solo como frontera
- Luego tokens/componentes vía MCP
Si inviertes el orden (primero “sé creativo con el UI”), vuelves a la adivinación.
7 · Script de mesa (export esqueleto)
No hace falta un producto. Un script en el repo del DS:
# Pseudocódigo de mesa
# 1) concatenar 01–05 en pack ordenado
# 2) generar llms.txt con enlaces relativos
# 3) escribir manifest.json con frontmatter parseado
# 4) fallar CI si un principio no tiene al menos 1 correcto + 1 incorrectoGate recomendado en CI: cada tipo: principio con gates no vacíos debe tener ≥1 ejemplo correcto y ≥1 incorrecto enlazados. Si no, el genotipo en prosa es teatro.
8 · Bases para construir “esto” en tu design system agéntico
Cinco cimientos (en este orden):
| # | Cimiento | Pregunta que contesta | Herramienta hermana |
|---|---|---|---|
| 1 | Genotipo vs fenotipo | ¿Qué es dato y qué es solo imagen? | Registro de genotipo |
| 2 | Principios ejecutables | ¿Qué se evalúa sin gusto personal? | Plantilla de principio |
| 3 | Corpus de contraste | ¿Qué es el borde entre sí y no? | Contraejemplos, golden set |
| 4 | Exposición | ¿Cómo lo lee el agente sin Slack? | llms.txt del DS, smoke MCP |
| 5 | Governance | ¿Quién firma y qué no se delega? | No-delegables, firma humana |
Obsidian ocupa sobre todo 2 + 3 (y el índice de 4). Los tokens y el MCP son otras capas; la bóveda no los reemplaza.
Qué no hacer
- Convertir la bóveda en wiki infinita sin frontmatter.
- Guardar solo capturas PNG sin principio enlazado.
- Dejar que el LLM “resuma toda la vault” en cada prompt (ruido). Mejor: recuperar por
principio+ 2–3 notas de contraste. - Usar Obsidian Sync como única fuente: Git es la fuente; Obsidian es el editor.
Mínimo viable en una tarde
- Crea las 8 carpetas.
- Escribe 3 principios con la plantilla.
- Por cada uno: 1 correcto, 1 incorrecto, 1 contraste.
- Genera un
llms.txta mano de 40 líneas. - Pon ese pack como knowledge del proyecto (Claude/Cursor) antes de pedir un componente.
- Compara: con pack vs sin pack. Guarda la traza en
06-trazas/.
9 · En el programa
- Semana 01–02: genotipo, principios, no-delegables (empiezas la bóveda).
- Semana 03: exposición (
llms.txt, MCP): la bóveda se exporta de verdad. - Semana 07: golden set y juez: los ejemplos de Obsidian son el material del juez.
- Dupla: criterio escribe principios y contrastes; orquestación automatiza export y gates.
10 · Captación
Si quieres montar esta bóveda sobre tu sistema, con tutoría y Caso:
Mapa Semana 1 · Programa Mapa semanas ↔ herramientas Qué objeto de este catálogo se usa en cada semana del bootcamp.
Cómo usarlo
- Elige la semana del programa.
- Abre 1–2 herramientas, no diez.
- Trabaja en dupla cuando el objeto lo pida (contrato, mesa, veredicto).
- Si aún no estás en la cohorte: diagnóstico o clase.
Mapa Semana 1 · DTCG Registro de genotipo del sistema Lo que el sistema sabe como dato — frente a lo que solo vive en cabezas y capturas.
El genotipo es lo que una máquina puede consultar con la misma fidelidad que un humano. El fenotipo es lo que se ve en pantalla. La mayoría de design systems documentan el fenotipo y esconden el genotipo en Figma, Notion y conversaciones.
Columnas del registro
| Pieza | ¿Es dato? | ¿Dónde vive? | ¿La consulta un agente hoy? |
|---|---|---|---|
| Color primary | sí/no | ||
| Principio “un error no va solo en color” | sí/no | ||
| Cuándo no usar el Button ghost | sí/no |
Si la respuesta es “está en la cabeza de Ana”, es deuda de genotipo.
En el programa
Semana 01 (auditoría) y la guía Genotipo y fenotipo.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Checklist Semana 1 · MCP Inventario de fuentes de verdad Qué puede consultar un agente hoy sin pedir permiso a un humano por Slack.
Un agente no “conoce tu marca”. Conoce URLs, repos y herramientas que le abras. Este inventario es el entregable real de la semana 01.
Lista
- Tokens en formato abierto (DTCG u otro legible).
- API de componentes o Code Connect real.
-
llms.txt/ AGENTS.md del sistema. - Servidor MCP (o equivalente) con herramientas nombradas.
- Reglas de lint / CI que fallen en rojo.
- Corpus de ejemplos correctos (golden set, aunque sea pequeño).
Anti-patrón
“Todo está en el Design System de Figma” sin MCP ni export. Eso es un lienzo, no una fuente de verdad para agentes.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Mapa Semana 1 · Style Dictionary Eje build vs ejecución Qué se hornea al compilar y qué debe operar en directo contra el registro.
No todo token debe “hornearse” en el build. El eje build vs ejecución decide si el agente (o el producto) lee un artefacto estático o consulta el registro en vivo.
Matriz
| Decisión | Build | Ejecución |
|---|---|---|
| Color de marca global | suele ir en build | |
| Tema de tenant / white-label | suele ir en runtime | |
| Flag de experimento de UI | runtime | |
| Espaciado del sistema base | build |
En el programa
Semana 01 técnica y semana 04 (tokens con contexto).
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Contrato Semana 2 · Reglas Tabla por defecto / por excepción Cada decisión del sistema: el agente la aplica solo, o pide tu visto bueno.
Un principio en prosa es decoración. Un principio por defecto es una regla que el agente aplica sin preguntar. Una excepción exige humano.
Plantilla de fila
| Decisión | Defecto (agente) | Excepción (humano) | Señal en CI |
|---|---|---|---|
| Un CTA primario por vista | sí | pantallas de marketing firmadas | lint de densidad |
| Color solo como aviso de error | sí | ilustraciones editoriales | token path |
En el programa
Entregable de la semana 02: la tabla de gobierno de tus principios.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Plantilla Semana 2 · ESLint Plantilla de principio ejecutable De “accesible y claro” a una regla que un agente (y un linter) pueden evaluar.
Formato obligatorio:
- Nombre (verbo + objeto).
- Condición observable (qué se mide).
- Acción del agente si se cumple / si falla.
- Excepción documentada (o “ninguna”).
- Prueba (test, lint, rúbrica).
Mal
“El sistema es accesible y cercano a las personas.”
Bien
“Un error de formulario nunca se comunica solo con color: color + icono + texto. Si falta uno de los tres, el PR no pasa el gate a11y-error-triad.”
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Mapa Semana 1 · MCP Mapa de superficie agéntica Qué puede leer, escribir o solo observar el agente en tu fábrica de interfaces.
Incluye lo que el agente ya puede escribir (p. ej. Figma MCP en canvas) aunque te incomode. El mapa no es aspiracional: es el perímetro real.
Capas
- Lectura de tokens
- Lectura de componentes
- Escritura de variantes
- Escritura de copy
- Escritura de datos de usuario (casi siempre prohibido)
- Merge a main (nunca sin humano en promo 01)
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Checklist Semana 3 · Code Connect Protocolo anti-adivina Si el modelo recompone en vez de reutilizar, el mapeo está roto. Esta es la prueba.
Del oficio de Figma: sin mapeo, el modelo adivina. El protocolo anti-adivina no es “mejores prompts”. Es evidencia de reutilización.
Prueba de 15 minutos
- Pide al agente un botón primario de tu sistema.
- ¿Importa el componente real del repo o inventa un
<button class="btn">? - Si inventa: el genotipo de componentes no está expuesto (Code Connect / API / MCP tools).
En el programa
Semanas 03–04 y la guía de Figma MCP.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Script Semana 4 · Style Dictionary Vocabulario sin primitivos sueltos Auditoría rápida: ningún valor crudo en componentes si existe un token.
Idea
Un script de mesa (rg + lista de allow) que falla si encuentra hex/rgb en carpetas de componentes fuera de tokens/.
Ejemplo de política
# Pseudopolítica de mesa (adaptar a tu lint)
forbid: '#[0-9a-fA-F]{3,8}' in src/components/**
allow: src/tokens/**, *.stories.*No es un producto SaaS: es la higiene que el agente no inventará por ti.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Plantilla Semana 1 · DTCG Prompt-system de componente El primer artefacto de la semana 01: el componente descrito como dato, no como captura.
Un prompt-system no es un prompt de ChatGPT pegado en Notion. Es un paquete:
- Tokens que consume (paths DTCG).
- API de props (enumerada y cerrada).
- Estados y anti-patrones.
- Ejemplo de uso correcto / incorrecto.
- Prueba de aceptación (qué miraría un juez humano o un golden set).
En el programa
Primer entregable técnico de anatomía agéntica.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Playbook Semana 3 · AGENTS.md Onboarding del agente al design system El primer día del agente en tu repo: qué lee, en qué orden, qué no toca.
Orden de lectura: no-delegables → llms.txt → tokens → componentes → golden set. Invertir el orden es invitar a la adivinación.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Mapa Semana 1 · Workshop Radar de deuda agéntica Cuatro cuadrantes: duele / no duele × agente lo empeora / lo mejora.
Prioriza el cuadrante “duele y el agente lo empeora”: ahí va el genotipo primero.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Veredictos
Decisiones discretas, no scores que nadie usa.
Patrón Semana 7 · Evaluación Compresor de tres veredictos Como en Lorsclub: no un 0–100. Tres estados discretos que ya son una decisión.
Un LLM que responde a un humano sobre “¿merece la pena?” quiere una decisión, no un párrafo de matices. Lorsclub cierra con tres veredictos. Este compresor lo aplica a cualquier salida de agente de diseño.
Los tres estados (nómbralos a tu dominio)
| Estado | Significa | Acción |
|---|---|---|
| Apto | Entra a producción / se publica | Seguir |
| Condicionado | Entra solo con X humano | Lista de condiciones |
| Rechazado | No entra | Motivo en una frase |
Prohibido
Scores de 0–100 sin umbral de acción. Son anestesia.
En el programa
Casos vivos + evaluación del output (semana 07).
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Rúbrica Semana 8 · Panel Hoja de veredicto del panel (8 dimensiones) La rúbrica pública del demo day: el mismo juicio que el diagnóstico gratuito, a escala.
El programa no evalúa “bonito”. Evalúa ocho dimensiones (las mismas del diagnóstico). Esta hoja es la que usa el panel.
Uso
- Una fila por dimensión (0–100 o tres veredictos).
- Evidencia observable (enlace a PR, token, traza).
- Firma del panel.
- Carta al alumno: no es un diploma, es un veredicto.
Captación
Quien aún no está en el programa puede medirse en tres minutos: /diagnostico.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Spec Semana 7 · Git Golden set mínimo (12 piezas) Corpus curado de salidas correctas: sin esto, el agente no tiene norte ni el juez tiene vara.
Un golden set no es “ejemplos bonitos”. Es un corpus versionado de producciones que el equipo considera correctas.
Mínimo viable (12)
- 4 componentes generados bien.
- 4 usos de tokens correctos en contexto.
- 2 copys de error con triada a11y.
- 2 PRs que el juez rechazaría (contraejemplos etiquetados).
Relacionado
La prosa y los contrastes pueden vivir en la bóveda Obsidian antes de bajar a fixtures de CI.
Relacionado
La prosa y los contrastes (sí vs no) pueden vivir primero en la bóveda Obsidian para agentes y bajar después a fixtures de CI.
En el programa
Evaluación del output agéntico (Alex Chies).
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Playbook Semana 7 · LLM-as-judge Juez con vara (no con vibes) Cómo escribir la rúbrica que evalúa al agente — y evita el sesgo del juez LLM.
Si el juez es otro modelo sin vara, solo tienes vibes a escala. La vara es:
- Criterios binarios o de tres veredictos.
- Ejemplos ancla del golden set.
- Muestra humana periódica (calibra al juez).
- Log de desacuerdos humano/modelo.
En el programa
Temario de evaluación y sesgo del juez.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Contrato Semana 5 · CI Umbral de merge del agente Qué score o veredicto permite abrir PR — y qué la bloquea sin debate.
| Resultado | Acción |
|---|---|
| Apto en todas las dimensiones críticas | PR automática permitida |
| Condicionado | PR en borrador + checklist humana |
| Rechazado en una crítica | No hay PR; issue con motivo |
Las dimensiones “críticas” las marca la silla de criterio, no el pipeline.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Plantilla Semana 7 · Git Banco de contraejemplos etiquetados Lo incorrecto también se versiona: es el material con el que se entrena el juicio.
Cada contraejemplo lleva:
- Qué hizo el agente.
- Qué regla violó (enlace al principio ejecutable).
- Qué veredicto debió salir.
- Si un humano lo dejó pasar alguna vez (deuda cultural).
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Plantilla Semana 8 · Email Carta del veredicto (post demo day) Plantilla de la carta del Instituto: dimensión a dimensión, sin adjetivos vacíos.
Estructura:
- Una frase de hecho (qué se evaluó).
- Tabla de dimensiones con veredicto.
- Una fortaleza observable.
- Una deuda observable.
- Invitación a la siguiente acción (ventana, publicación del Caso, dupla).
Nunca: “gran trabajo”, “impresionante trayectoria”.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Defunciones
Procesos que se entierran para que no zombifiquen el equipo.
Ritual Semana 3 · Proceso Acta de defunción del handoff El ritual con el que se entierra la entrega diseñador→dev como proceso. No se “mejora”: se declara muerta.
En El Parte, las defunciones no son humor barato: son higiene. El handoff clásico (especificación estática que alguien “implementa después”) es incompatible con un agente que lee el sistema en vivo.
Acta
- Fallecido: el handoff como archivo PDF / página de anotaciones.
- Causa: el sistema no era genotipo; era capturas.
- Herederos: MCP, tokens, principios ejecutables, PR del agente.
- Testigos: silla de criterio + silla de orquestación.
- Fecha de entierro: la del primer merge sin handoff.
En el programa
Cultura de oficio + governance. Relacionado: glosario handoff.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Plantilla oficio · Notion Plantilla de defunción de proceso Cualquier proceso del equipo se puede enterrar con la misma gramática del Parte.
Campos: nombre del rito muerto, por qué sobra con agentes, qué lo sustituye, quién se resiste, fecha de retiro de la wiki.
Si no hay sustituto, no es defunción: es abandono.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Script Semana 4 · Style Dictionary Cementerio de tokens Tokens que ya no se usan: se archivan con fecha de muerte, no se dejan zombie en el tema.
Un token sin referencias no es “por si acaso”: es ruido genotípico. El cementerio lista:
- path del token
- última referencia conocida
- fecha de deprecación
- sustituto
El agente no debe ver zombies en el registro activo.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Acta Semana 5 · Storybook Obituario de componente Cuando un componente muere, se escribe por qué — para que el agente no lo resucite.
El obituario entra en el changelog del sistema:
- Qué problema resolvía.
- Qué lo reemplaza.
- Qué prompts/agentes deben dejar de pedirlo.
- Redirect mental: “si pides X, usa Y”.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Ritual Semana 5 · Rego Retiro de excepción documentada Las excepciones también mueren: si ya no se justifican, se cierran en acta.
Toda excepción del tabla defecto/excepción tiene fecha de revisión. Este ritual la cierra o la renueva con nueva firma humana.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Acta entrada · Cultura Entierro del “pixel perfecto” como KPI Se entierra la métrica que castiga al sistema y premia la captura estática.
El pixel perfecto como KPI empuja a congelar el fenotipo. El Instituto mide fidelidad del genotipo y veredictos de uso. Esta acta cambia el OKR del equipo.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Checklist Semana 3 · AGENTS.md Lista negra de prompts muertos Prompts que generaban deuda: se retiran del wiki del equipo con causa.
Si un prompt pide “hazlo creativo” o “como Airbnb”, y vuestra marca no es Airbnb, muere. La lista negra se versiona junto al AGENTS.md.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Acta entrada · Cultura Protocolo del becario (humor operativo) El agente es el becario brillante y peligroso: esta ficha dice qué no se le deja solo.
Hereda del formato Becario del Parte: con humor, pero con lista de tareas prohibidas. Si da risa y no cambia el guard, es solo meme.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Agentes en producción
DNI, guards, traza: el agente con perímetro.
Patrón Semana 5 · Supabase Agente con DNI (auth server-side) Patrón Bodados: el agente no es un chat anónimo. Cada acción lleva identidad y ownership.
En Bodados, cada llamada a agente pasa por getUser() y ownership. Sin eso, el agente es un vector de ataque con tono amable.
Checklist de DNI
- Identidad del usuario en el servidor (no solo en el cliente).
- Comprobación de ownership del recurso.
- Rate limit por usuario/agente.
- Log de acción + actor + recurso.
- El prompt del sistema no puede saltarse el guard con “el usuario dijo que sí”.
En el programa
Casos vivos + orquestación. No es teoría de seguridad: es diseño del perímetro.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Script Semana 5 · TypeScript Guard de agente (plantilla de borde) La función que envuelve toda tool call: auth, rate, ownership, traza.
// Esqueleto de mesa — adaptar a tu runtime
export async function agentGuard(ctx, tool, input) {
const user = await requireUser(ctx); // o 401
await rateLimit(user.id, tool);
await assertOwns(user.id, input.resourceId);
const result = await runTool(tool, input, { userId: user.id });
await audit({ user: user.id, tool, input, result: summarize(result) });
return result;
}Si una tool se llama fuera del guard, es un bug de arquitectura, no de prompt.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Mapa Semana 3 · MCP Matriz de permisos por tool MCP Cada herramienta del servidor: lectura, escritura, o prohibida con datos PII.
| Tool | Lee | Escribe | PII | Notas |
|---|---|---|---|---|
| get_tokens | sí | no | no | |
| apply_component | sí | PR only | no | |
| update_guest | sí | sí | sí | requiere DNI |
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Patrón Semana 5 · DB Atomic claim de acción irreversible Patrón de checkout/regalo: la acción costosa no se ejecuta dos veces ni a medias.
Cuando el agente puede cobrar, regalar o borrar, necesitas claim atómico: una fila o lock que impide dobles ejecuciones. Es diseño de sistema, no de interfaz.
Campos mentales: idempotency key, estado (pending|done|failed), actor, timestamp.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Spec Semana 3 · CI Traza mínima de salida del agente Qué dejó el agente: regla tocada, diff, humano firmante. Sin traza no hay governance.
Campos mínimos en cada salida:
- input (hash o enlace)
- tools usadas
- diff o artefacto
- reglas evaluadas (pass/fail)
- humano responsable del merge
Si falta el 5, no es producción del Instituto: es demo.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Contrato Semana 2 · AGENTS.md Lista de no-delegables Lo que el agente no hace nunca en tu organización — versionada como el código.
Ejemplos de no-delegables típicos en promo 01:
- Merge a main
- Cambios de tokens de marca core sin PR
- Copy legal / consentimiento
- Acceso a datos de otros usuarios
- Borrar componentes sin obituario
La lista se lee en el system prompt y se fuerza en el guard.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Mapa Semana 5 · Branches Sandbox de escritura del agente Dónde puede escribir antes de tocar el registro sagrado.
Niveles: branch efímera → PR → staging → main. El agente por defecto se queda en el primero. Subir de nivel es decisión humana de la dupla.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Checklist oficio · Flags Kill switch de agente Cómo se apaga en 60 segundos sin apagar el producto.
- Flag global
agents.enabled - Flag por tool
- Revocación de credenciales MCP
- Mensaje de usuario humano (“asistente en pausa”)
- Postmortem en 24 h
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Plantilla oficio · Logs Ficha de transparencia de modelo Qué modelo, qué versión, qué temperatura — en el log, no en el folklore del equipo.
Sin esta ficha, los incidentes no se reproducen. Es aburrida y obligatoria.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Contrato avanzado · Compliance Acuerdo de muestreo y retención de logs Qué logs de agente se guardan, cuánto tiempo, quién accede.
Sin esto, la traza se vuelve pasivo tóxico. Diseñad retención como diseñáis tokens.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Orquestación
Roles, colas, L1–L3: dirigir sin soltar el criterio.
Playbook Semana 5 · MCP Playbook de orquestación agéntica La partitura para dirigir agentes sobre un design system sin perder el control.
La estrella mantiene la traza y la responsabilidad en un punto
Cómo leer la topología
- El orquestador Centro
- Decide qué agente hace qué, en qué orden, y responde del resultado. Es el único que habla con el middleware y con cada agente.
- Los agentes temáticos Radios
- Uno por dominio (UI, copy, accesibilidad, datos). Cada uno se nutre del sistema (vocabulario, reglas) pero no habla con los demás.
- El anti-patrón Tachado
- Agentes que se hablan libremente derivan: se contradicen, se realimentan, y nadie sabe quién decidió qué. Toda coordinación pasa por el orquestador.
- El humano que firma Arriba
- Puedes delegar la ejecución; no la rendición de cuentas. La responsabilidad queda fuera de la máquina.
Un punto de control entre cada paso evita que un fallo se propague
Este playbook es la versión larga de mesa: roles, gates, traza, kill switch y demo. Se apoya en las herramientas de esta misma sección (guard, DNI, L1–L3, cola de excepciones).
Secuencia
- Inventario de fuentes de verdad.
- Matriz de permisos por tool.
- Umbral de merge.
- Mesa sin agente semanal.
- Muestreo de evaluación.
Captación
Versión tutorizada en el programa y el dossier de orquestación.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Mapa Semana 8 · HITL Escalera de autonomía L1–L3 L1 sugiere, L2 prepara PR, L3 opera con guardrails. Subir de peldaño es un acto político.
| Nivel | El agente… | Humano… |
|---|---|---|
| L1 | Propone | Ejecuta |
| L2 | Abre PR / draft | Aprueba |
| L3 | Ejecuta en perímetro | Audita muestreo |
Nadie “llega a L3” por instalar un plugin. Se declara en el contrato de la dupla y en el guard.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Playbook Semana 5 · Multiagente Partitura de roles de agente No un mega-agente: roles con entradas y salidas como en un newsroom (La Vigencia).
En un newsroom agéntico cada rol tiene brief, input y output. Copia el patrón a diseño:
- Inventario: lista deuda de genotipo
- Propuesta: genera diff
- Crítico: aplica rúbrica
- Portero: guard + merge policy
Si un solo agente hace los cuatro, no tienes orquesta: tienes monólogo.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Plantilla Semana 5 · Issues Cola de excepciones del agente Todo lo que el agente no pudo resolver sin violar una regla cae aquí — no en un chat eterno.
Campos: regla tocada, input, intento del agente, por qué falló el gate, silla responsable, plazo.
La mesa sin agente (ver herramienta) vacía esta cola.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Plantilla Semana 3 · MCP Brief del orquestador (no del prompt) Lo que la silla de orquestación debe dejar escrito antes de enchufar modelos.
Incluye: herramientas disponibles, secretos, entornos, SLAs, kill switch, owners. El prompt del modelo es un anexo, no el brief.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Patrón Semana 8 · Cron Patrón cron self-healing De La Vigencia: si el pipeline editorial falla, el sistema se reintenta con triple schedule — diseño de resiliencia, no heroísmo humano.
Diseña tres relojes: intento principal, reintento, alarma humana. El “humano de guardia” es el último eslabón, no el primero.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Spec Semana 8 · Design system Registro cerrado de componentes El agente solo instancia lo que está en el registro. Fuera de catálogo = excepción firmada.
El guardarraíl más simple y más brutal: allowlist de componentes. Si el agente necesita uno nuevo, abre issue a la silla de criterio; no lo inventa.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Mapa Semana 8 · BFF El BFF como sede del orquestador Dónde vive la orquestación: no en el cliente, no en el plugin del diseñador.
El orquestador en el cliente es un juguete. En el BFF/worker: secretos, DNI, rate limit, traza. Esta ficha decide el hosting del “cerebro” operativo.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Checklist Semana 8 · Kit Checklist de release del Agentic DS Kit Qué debe contener el paquete que el alumno enseña el último día.
Tokens · principios ejecutables · MCP o exposición · gates CI · golden set · traza ejemplo · no-delegables · README con firma humana.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Mapa oficio · FinOps Presupuesto de tokens (LLM) por feature Cuánto puede costar una acción de agente antes de que el producto sea absurdo.
Cada tool call tiene coste. Diseña techos y degradación elegante (L1 si se agota el presupuesto).
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Playbook oficio · UX Plan de degradación elegante Si el agente cae, el producto sigue siendo usable — sin teatro de “inteligencia”.
Estados: full · limited · human-only. Copy y UI para cada uno. El empty state también se diseña.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Governance ejecutable
Si no falla en CI, es teatro.
Spec Semana 1 · DTCG Spec de sistema de diseño agéntico La checklist por capas: vocabulario → componentes → reglas → exposición → governance.
Cada capa se apoya en la anterior · sin cimiento, lo de arriba es ruido
Un design system listo para agentes no es uno con más componentes: es uno que una máquina puede leer, aplicar y extender sin adivinar. Marca cada punto por capas (vocabulario, componentes, reglas, exposición, governance). Lo que no puedas marcar es tu deuda agéntica.
Ver el cuerpo completo histórico de esta spec en versiones anteriores del sitio; el orden de capas se mantiene: sin vocabulario no expongas; sin governance no aceleres.
En el programa
Semana 01 y diagnóstico gratuito: /diagnostico.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Script Semana 5 · ESLint Gate de tokens en CI El PR se pone rojo si el agente (o un humano) mete un valor que el vocabulario no conoce.
Governance que no corre en CI es teatro. Este gate es el mínimo:
- lint de uso de tokens
- fallo en CI
- mensaje que apunta al path correcto del vocabulario
Referencia de industria: plugins de design system en ESLint; aquí lo adaptáis a vuestra fuente DTCG.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Patrón Semana 5 · Rego Excepción como código Las excepciones no viven en un hilo de Slack: se versionan junto a la regla.
Cada excepción: id, regla, motivo, caducidad, firmantes. Sin caducidad = no es excepción, es agujero.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Plantilla Semana 8 · Git Changelog como paper El changelog del sistema es el paper del oficio: qué cambió el agente y bajo qué regla.
Formato: fecha · actor (humano|agente+humano) · reglas · diff resumido · veredicto. Es el opuesto al “misc fixes”.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Contrato Semana 5 · GitHub Política de PR agéntica Título, plantilla y checks obligatorios cuando el autor es un pipeline.
La PR del agente declara: tools, golden checks, riesgo, silla que aprueba. Sin eso, se cierra.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Mapa Semana 5 · CI Cobertura de reglas (no de líneas) Qué porcentaje de principios ejecutables tienen prueba automática o rúbrica.
Cobertura de código ≠ cobertura de criterio. Esta tabla cruza principios vs tests.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Checklist Semana 3 · Git Firma humana obligatoria El merge es un acto de persona con nombre. El agente no firma.
- CODEOWNERS en rutas de tokens y componentes
- Al menos un approval humano
- El bot no se aprueba a sí mismo
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Evaluación y panel
La misma vara del demo day y del diagnóstico.
Rúbrica Semana 7 · Review Rúbrica de evaluación agéntica Cómo juzgar lo que produce un agente: criterios observables, no gusto personal.
Dimensiones típicas: fidelidad al token, reutilización de componentes, a11y, traza, no-delegables intactos. Cada una con tres veredictos.
Usar junto al compresor de tres veredictos y el golden set.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Playbook Semana 7 · QA Plan de muestreo humano Qué porcentaje de salidas revisa una persona cuando el sistema ya está en L2/L3.
Ejemplo: 100% al inicio, 20% en estable, 100% en cambios de tokens core. El muestreo se declara; no se improvisa el viernes.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Patrón Semana 7 · Playwright Regresión visual con umbral Snapshots sí, pero con umbral y dueño — no un muro de diffs ignorados.
Todo diff visual tiene: umbral, severidad, silla que puede aceptarlo. Aceptar un diff es un acto de criterio, no un click de fatiga.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Script Semana 6 · axe Prueba de accesibilidad en CI sobre UI generada La a11y no se “revisa a ojo” cuando el agente produce pantallas a diario.
Gate mínimo: contraste, nombres accesibles, foco. La UI generada entra al mismo pipeline que la humana.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Playbook Semana 8 · Demo day Guion del panel de ocho dimensiones Cómo se sienta el jurado del demo day: misma vara, sin monólogos.
Tiempos, orden de dimensiones, prohibición de preguntas de “cuéntame tu journey”. Solo evidencia del Kit.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Plantilla Semana 8 · Kit Autoevaluación pre-demo El alumno se pone el veredicto antes del panel — y adjunta evidencia.
Si tu autoevaluación y el panel divergen en más de dos dimensiones, el problema es de evidencia, no de “nervios”.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Playbook Semana 8 · Demo Guion de demo day (12 minutos) No story de vida: evidencia del Kit contra la rúbrica.
0–2 problema · 2–6 genotipo · 6–9 agente en vivo · 9–11 veredictos · 11–12 pregunta al panel.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Casos vivos
Patrones destilados de productos reales del Instituto.
Patrón oficio · UX writing Patrón de tres estados en producto Del catálogo Lorsclub al design system: comprime inteligencia en decisiones.
Aplica el compresor de veredictos al producto que diseñas, no solo al agente. ¿Dónde hoy tenéis scores que nadie usa?
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Mapa avanzado · SSR Render dual humano / agente Cuando el design system tiene dos consumidores: el humano y el agente (patrón Lorsclub).
No es “dark mode”. Es superficie distinta según consumidor: HTML editorial vs representación legible por máquina. El genotipo es uno; los fenotipos pueden ser dos.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Plantilla avanzado · Colas Canvas de newsroom de agentes 15 roles no son 15 chats: son un proceso con estados y reintentos (La Vigencia).
Dibuja: entrada de fuente → redacción → crítica → validación dura → publicación → log. Marca qué rol es humano inamovible.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Checklist avanzado · Auth Checklist de agente sobre datos privados Bodados: acción real autenticada. Si no hay ownership, no hay feature.
Deriva del agente con DNI. Añade: consentimiento, retención, export, borrado.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Mapa Semana 4 · DTCG Multimarca con resolver (sin copiar carpetas) Temas y modos como datos; el agente no duplica librerías por marca.
Si tu “multimarca” es copiar el DS, el agente multiplicará el caos. El resolver (cuando esté estable en tu stack) o tu capa de temas debe ser dato.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Plantilla oficio · Editorial Estructura de informe de zona (decisión + corpus) Cómo escribir un informe que un agente pueda citar y un humano pueda leer en 90 segundos.
Veredicto → tres pruebas → límites → fuentes. Prohibido el ensayo de 2.000 palabras sin decisión.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Patrón avanzado · Multiagente Dúo crítico + validador duro Un agente que opina y otro que solo pasa/falla reglas — no los fusiones.
El crítico puede ser generativo. El validador es determinista (schema, lint, tests). Separarlos evita el “todo parece bien”.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Checklist Semana 8 · Portfolio Caso mínimo publicable (CMP) Qué debe tener un Caso del programa para poder colgarse en el registro sin vergüenza.
- Problema real
- Genotipo tocado (tokens/reglas/MCP)
- Traza de agente
- Veredicto del panel o autoevaluación con evidencia
- Nombres de la dupla
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Scripts de mesa
Utilidades que corren en tu repo, no en un SaaS.
Script Semana 4 · Node Script de diff de tokens Qué cambió en el vocabulario entre dos commits — legible por humanos y por el Parte.
Genera un markdown: added / removed / changed paths. Entrada del changelog-as-paper.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Script oficio · ripgrep Script de componentes huérfanos Componentes sin referencia en app ni en golden set: candidatos a obituario.
Huérfano ≠ basura siempre. Pero sin dueño ni uso, el agente no debería proponerlo.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Script Semana 3 · Node Generador de llms.txt del design system Índice legible por agentes a partir de tu árbol de tokens y componentes.
No es marketing llms.txt de landing: es índice del sistema. Enlaza specs, tokens entrypoints, MCP tools, no-delegables.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Script Semana 3 · MCP Smoke test del servidor MCP del DS Tres llamadas mínimas: list tools, get token, get component. Si fallan, no hay genotipo expuesto.
Corre en CI nightly. Rojo = el agente está ciego aunque Figma “se vea bien”.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Script Semana 1 · Node Script de puntuación AI-readiness Convierte la spec de capas en un score por dimensión — el mismo espíritu del diagnóstico web.
Salida: JSON de dimensiones + tres veredictos. Entrada al diagnóstico humano.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Script Semana 5 · GitHub Actions Labeler de PRs de agente Etiqueta automática: agent-generated, risk-high, needs-criterion.
Las etiquetas activan CODEOWNERS y revisores. Sin labels, el review es aleatorio.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Script Semana 4 · Style Dictionary Export DTCG de limpieza Normaliza nombres y $type antes de que el agente consuma basura semántica.
Paso previo a cualquier MCP de tokens. Basura dentro = basura fuera, a velocidad de modelo.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Script avanzado · CLI CLI de cola de excepciones Alta y cierre de excepciones desde terminal — para la silla de orquestación.
exception open --rule R12 --why "..." / exception close --id. La mesa semanal lee el JSONL.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Editorial agéntico
La disciplina del Parte aplicada al design system.
Plantilla entrada · Docs Cintillo de oficio Cómo titular una decisión de sistema en 3–5 palabras — el arte del Parte aplicado al DS.
Mal: “Update button styles”. Bien: “El primario deja de competir”. El cintillo es para humanos y para el índice del agente.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Plantilla Semana 8 · Changelog Entradilla de cambio (60–160) La meta description del changelog: una decisión, no un dump de commits.
Misma disciplina que el summary del Parte. Si no cabe en 160 caracteres, no hay decisión clara.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Contrato oficio · AGENTS.md Guía de voz del sistema (para agentes de copy) Restricciones de tono que un agente de microcopy no puede violar.
Incluye: prohibiciones (AI-slop), triada de error, tratamiento de tú/usted, palabras vetadas. El agente de copy carga este contrato como tool resource.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Plantilla entrada · Markdown Plantilla de Parte interno de sistema El boletín del design system: un cambio, una fuente, una firma humana.
Kicker · titular · summary · cuerpo · fuente · firmado por. Publicable en el canal del equipo o en El Parte si es de interés general.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Patrón entrada · Cultura Bloque de firma de responsabilidad Nunca “generado por IA” como autor. Persona, rol, fecha.
La IA puede haber escrito un borrador. Firma un humano. Es la misma regla del Parte y de las PRs.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Spec Semana 3 · Docs Glosario mínimo del Kit (12 términos) Los doce términos que tu agente y tu equipo deben compartir sin ambigüedad.
Empieza por: token primitivo, semántico, principio ejecutable, no-delegable, veredicto, dupla, genotipo, traza, guard, L2, golden set, excepción.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Checklist entrada · Docs Checklist anti-slop para textos del sistema Las mismas prohibiciones del Instituto aplicadas a la documentación que lee el agente.
Prohibido: “revolucionario”, “sin fricciones”, “potencia tu workflow”, em-dash ornamental, promesas sin dueño. El agente que documenta hereda la banlist.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Plantilla oficio · Parte Consultorio de excepciones (formato Parte) Cómo plantear una excepción de sistema en público interno: pregunta, regla, propuesta.
Pregunta · regla afectada · por qué el defecto no basta · propuesta de caducidad · sillas firmantes.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Plantilla oficio · Ventanas Contrato de ventana mensual Cómo se prepara una ventana del programa: tema, entregable, captura, no monólogo.
Las ventanas son producto vivo. Esta plantilla alinea tema, lectura previa, ejercicio y CTA de captación.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Accesibilidad estructural
Reglas que el agente no puede “olvidar”.
Spec Semana 6 · a11y Triada de error (color + icono + texto) Principio ejecutable de a11y que el agente puede comprobar y el linter también.
Un error nunca viaja solo en color. Esta spec se implementa como regla y como test visual/DOM. Es el ejemplo canónico de principio ejecutable del programa.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Contrato Semana 6 · CSS Foco nunca opcional Contrato de foco visible en componentes generados por agente.
Si el agente genera un control sin :focus-visible, el gate falla. No hay “ya lo pondremos”.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Patrón Semana 6 · React Nombres accesibles en la API del componente La prop no se llama "text": se modela el nombre accesible como parte del contrato.
El agente que instancia un icon-button sin nombre produce deuda. La API lo hace difícil o imposible.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Checklist Semana 6 · Legal Checklist EAA / Ley 11/2023 para UI agéntica Lo mínimo legal que un sistema con UI generada no puede “improvisar”.
No sustituye asesoría legal. Ordena: qué ya es obligatorio, qué se prueba en CI, qué firma un humano.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Patrón Semana 4 · DTCG Contraste como dato del token El contraste no se “revisa al final”: viaja en metadatos del color.
Usa $extensions para declarar pares válidos y ratios. El agente consulta el dato; no adivina grises.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Checklist Semana 6 · Teclado Guion de prueba de teclado post-generación Después de que el agente pinta UI: tab order, escape, focus trap.
Cinco minutos humanos que el golden set no sustituye del todo.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Mapa Semana 6 · Inventario Mapa de riesgo a11y por superficie Dónde el agente genera más deuda: modales, tablas, live regions…
Prioriza gates automáticos en las superficies de alto riesgo. El resto, muestreo humano.
Herramienta del catálogo I.D.A. · captación: diagnóstico · clase · solicitud
Estas piezas son la versión corta y portable de lo que se practica en el Programa Anual: auditoría, principios ejecutables, MCP, tokens, governance, evaluación y release del Kit. La tutoría y el Caso en producción viven en la cohorte.