Asistentes de IA
Un asistente escribe mejor marcado de TaishoDS Core cuando lee el sistema en lugar de adivinarlo. Esta guía explica qué publica el sitio para eso, cómo dárselo y cómo conectar el servidor MCP que viene en el paquete.
El llms.txt
llms.txt es una convención: un archivo de texto en Markdown, en una dirección fija, que resume un
sitio para modelos de lenguaje. El de TaishoDS Core dice qué es el sistema, trae las reglas para escribir marcado
(la llave ts, el vocabulario cerrado, el espaciado, los colores, las variantes), la instalación
y la lista de componentes y guías, cada una con su enlace. Una ficha por componente trae el HTML listo para copiar.
| Dirección | Idioma | Qué trae |
|---|---|---|
| https://taisho.design/es/llms.txt | Español | El índice: qué es el Core, las reglas para escribir marcado, la instalación y la lista de componentes y guías, con un enlace a cada una. |
| https://taisho.design/llms.txt | Inglés | El índice: qué es el Core, las reglas para escribir marcado, la instalación y la lista de componentes y guías, con un enlace a cada una. |
| https://taisho.design/es/llms-full.txt | Español | Todo lo del índice más la ficha de cada componente, con un ejemplo, y la tabla de utilidades. |
| https://taisho.design/llms-full.txt | Inglés | Todo lo del índice más la ficha de cada componente, con un ejemplo, y la tabla de utilidades. |
| https://taisho.design/docs/<slug>.md | Español | La ficha de un componente: cuándo usarlo y cuándo no, sus clases, el JavaScript que necesita, el teclado y todos sus ejemplos en HTML. |
| https://taisho.design/en/docs/<slug>.md | Inglés | La ficha de un componente: cuándo usarlo y cuándo no, sus clases, el JavaScript que necesita, el teclado y todos sus ejemplos en HTML. |
El índice es corto y se lee entero sin problema. El archivo completo es mucho más largo y sólo conviene si el
asistente tiene contexto de sobra; si no, alcanza con el índice y las fichas de los componentes que se van a usar.
Cada ficha está también en inglés, bajo /en/docs/.
Cómo dárselo a un asistente
Por dirección
Si el asistente puede abrir enlaces, alcanza con nombrar el archivo en el pedido.
Con https://taisho.design/es/llms.txt como referencia, armar una pantalla de inicio de sesión con TaishoDS Core.Dentro del proyecto
Para que cada sesión parta del mismo punto, se guardan el índice y las fichas que se usan en una carpeta del
proyecto, y el archivo de instrucciones del asistente (el que lea: AGENTS.md, CLAUDE.md, las reglas de Cursor) apunta a ellos.
mkdir -p docs
curl -o docs/taisho-llms.txt https://taisho.design/es/llms.txt
curl -o docs/taisho-button.md https://taisho.design/docs/button.mdPara escribir marcado de TaishoDS Core, seguir las reglas de docs/taisho-llms.txt
y copiar los componentes de su ficha (docs/taisho-<componente>.md).
Al terminar, correr `npx taisho check` y corregir hasta que dé 0 avisos.Los archivos guardados quedan como estaban ese día: para tomar los cambios del sistema, se vuelven a descargar.
Revisar lo que escribe
El vocabulario es cerrado: una clase que no existe no hace nada y tampoco da error en el navegador. Por eso
el índice le pide al asistente correr npx taisho check al terminar. Con --format json, cada aviso trae la regla, el lugar y, cuando hay un reemplazo claro, la
sugerencia, y un asistente puede leerlo y corregir solo.
npx taisho check --format json src{
"version": 1,
"files": 1,
"warnings": [
{
"file": "src/login.html",
"line": 1,
"column": 23,
"rule": "unknown-class",
"severity": "error",
"code": "unknown-class",
"params": { "class": "bg-brnad-500", "suggestion": "bg-brand-500" },
"message": "\"bg-brnad-500\" no existe en el DS y no se emite. ¿Se quiso decir \"bg-brand-500\"?",
"suggestion": "bg-brand-500"
}
]
}Los códigos de salida y el resto de las reglas están en Línea de comandos.
El servidor MCP
El llms.txt es un texto que el asistente lee. El servidor MCP (Model Context Protocol) es un
programa al que el asistente le pregunta mientras trabaja: qué componentes hay, cómo es uno, si una clase existe, qué
colores tiene el proyecto. Viene en el paquete y se arranca con npx taisho mcp; el cliente (Claude
Code, Claude Desktop, Cursor, VS Code y otros que hablan MCP) lo lanza solo.
Local y de sólo lectura
taisho.config.ts y los datos que vienen en el paquete: no escribe archivos, no usa la red y no
envía telemetría.Configurarlo en un cliente
Con @taishods/core instalado en el proyecto, el servidor se declara en la configuración del
cliente, en la raíz del proyecto (Claude Code lee .mcp.json; Cursor, .cursor/mcp.json; cada cliente documenta su archivo).
{
"mcpServers": {
"taisho": { "command": "npx", "args": ["taisho", "mcp"] }
}
}VS Code usa otra clave y pide el tipo, en .vscode/mcp.json:
{
"servers": {
"taisho": { "type": "stdio", "command": "npx", "args": ["taisho", "mcp"] }
}
}VS Code sólo ofrece el servidor en una carpeta de confianza. Si el archivo no muestra la acción para iniciarlo, se
inicia desde la paleta de comandos: «MCP: List Servers», el servidor taisho y «Start
Server».
Un cliente con configuración global no sabe en qué proyecto está. Se le indica con --config, y se usa la ruta absoluta al comando instalado para que no dependa de la carpeta
desde la que arranque. La carpeta de ese config pasa a ser la raíz del proyecto.
{
"mcpServers": {
"taisho": {
"command": "node",
"args": [
"/ruta/al/proyecto/node_modules/@taishods/core/bin/taisho",
"mcp",
"--config",
"/ruta/al/proyecto/taisho.config.ts"
]
}
}
}--lang es o --lang en elige el idioma de las fichas y los mensajes; sin
él se usa el lang del config y, si no hay, el del sistema. Si el config cambia, el servidor
lo vuelve a leer solo. Sin taisho.config.ts usa el tema de fábrica, y get_theme lo avisa.
Qué ofrece
Al conectarse, el servidor entrega al asistente las mismas reglas del llms.txt como
instrucciones, y ofrece seis herramientas. Cinco se explican acá; la sexta pasa código de otro sistema al de TaishoDS y
está en la guía de migración, en Fundamentos.
| Herramienta | Para qué sirve |
|---|---|
| list_components | Lista los componentes del Core con el total, y de cada uno su nombre, sus clases raíz, si necesita JavaScript y un resumen. |
| get_component | Devuelve la ficha de un componente: cuándo usarlo, sus clases, el teclado y los ejemplos en HTML para copiar. |
| search_utilities | Busca utilidades por nombre o por CSS en el vocabulario del proyecto, incluidas las propias, e indica cuántas coincidieron y cuántas devolvió. |
| validate_markup | Revisa un fragmento de marcado como lo hace taisho check y dice si es válido. |
| get_theme | Devuelve los colores, los tonos, el espaciado, el modo oscuro y las variables CSS del tema del proyecto. |
Los ejemplos que siguen son respuestas reales, recortadas con …. Cada línea → es lo que pide el asistente y ←, lo que recibe.
→ list_components
← {
"count": 56,
"components": [
{ "slug": "accordion", "name": "Accordion", "blocks": ["accordion", "accordion-item"], "needsJs": true,
"summary": "Lista de secciones colapsables coordinadas entre sí." },
{ "slug": "alert-dialog", "name": "AlertDialog", "blocks": [], "needsJs": true,
"summary": "Diálogo que fuerza una decisión antes de seguir: bloquea, y a diferencia de Modal el fondo NO lo descarta." },
…
]
}→ get_component { "slug": "badge" }
← # Badge
Etiqueta compacta para estados, categorías o conteos. …
## Cuándo usarlo
- Mostrar el estado de algo en una palabra: “Activo”, “Beta”, “Vencido”.
…
## Clases
- Raíz: `ts badge`
- Modificadores: `size-md`, `fill-subtle`, `variant-default`, `variant-success`, …
…
## Ejemplos
### Estado de un despliegue: listo
```html
<span class="ts badge size-md fill-subtle variant-success"> Listo </span>
```→ search_utilities { "query": "gap base", "limit": 3 }
← {
"total": 5, "returned": 3,
"results": [
{ "class": "gap-base", "css": "gap: var(--ts-gap-base);" },
{ "class": "gap-x-base", "css": "column-gap: var(--ts-gap-base);" },
{ "class": "gap-y-base", "css": "row-gap: var(--ts-gap-base);" }
]
}→ validate_markup { "markup": "<div class=\"flex gap-base bg-brnad-500\">Hola</div>", "filename": "login.html" }
← {
"version": 1, "files": 1, "valid": false,
"warnings": [
{ "file": "login.html", "line": 1, "column": 6, "rule": "missing-ts", "severity": "error",
"message": "<div> usa clases del DS (\"gap-base\") pero no lleva la clase `ts`, y sin ella no recibe estilo." },
{ "file": "login.html", "line": 1, "column": 27, "rule": "unknown-class", "severity": "error",
"message": "\"bg-brnad-500\" no existe en el DS y no se emite. ¿Se quiso decir \"bg-brand-500\"?",
"suggestion": "bg-brand-500" }
]
}→ get_theme
← {
"configFile": "taisho.config.ts",
"language": "es",
"themes": ["main"],
"colors": { "gray": "neutral", "brand": "#4F46E5", "success": "#16A34A", "warning": "#D97706", "info": "#2563EB", "danger": "#D42424" },
"shades": ["100", "200", "300", "400", "500", "600", "700", "800", "900", "1000"],
"rhythm": ["none", "quarter", "half", "base", "section", "double"],
"darkMode": "class",
"cssVars": ["--_card-pad-lg", "--_card-pad-md", "--_card-pad-sm", …]
}validate_markup hace lo mismo que taisho check sobre un fragmento, y
suma valid. A diferencia del comando, siempre incluye los avisos de other-scale (p-4 son 4 px aquí), que son recordatorios: no vuelven inválido el marcado. Una herramienta que
falla, por ejemplo un slug que no existe, responde con el error y la lista de los
que sí.
Lo que el llms.txt no sabe
Describe el tema de fábrica del Core. Los colores propios de un proyecto, sus utilidades propias y su taisho.config.ts no están ahí; npx taisho check sí los conoce, porque
lee la configuración del proyecto, y por eso es el paso que cierra el trabajo; el servidor MCP también los conoce. Seguir las reglas tampoco garantiza que un
asistente no se equivoque: la revisión sigue siendo de quien lo usa.
Ficha de un componente
/docs/button.md.
Es el mismo contenido que lee el asistente, sin el diseño de la página.