Saltar al contenido

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.txtEspañolEl í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.txtInglésEl í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.txtEspañolTodo lo del índice más la ficha de cada componente, con un ejemplo, y la tabla de utilidades.
https://taisho.design/llms-full.txtInglésTodo lo del índice más la ficha de cada componente, con un ejemplo, y la tabla de utilidades.
https://taisho.design/docs/<slug>.mdEspañolLa 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>.mdInglésLa 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.

pedido

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.

terminal
instrucciones del asistente

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.

terminal
salida

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

El servidor corre en tu máquina y habla con el cliente por la entrada y la salida estándar. Lee el 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

VS Code usa otra clave y pide el tipo, en .vscode/mcp.json:

.vscode/mcp.json

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.

configuración global

--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_componentsLista los componentes del Core con el total, y de cada uno su nombre, sus clases raíz, si necesita JavaScript y un resumen.
get_componentDevuelve la ficha de un componente: cuándo usarlo, sus clases, el teclado y los ejemplos en HTML para copiar.
search_utilitiesBusca utilidades por nombre o por CSS en el vocabulario del proyecto, incluidas las propias, e indica cuántas coincidieron y cuántas devolvió.
validate_markupRevisa un fragmento de marcado como lo hace taisho check y dice si es válido.
get_themeDevuelve 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
get_component
search_utilities
validate_markup
get_theme

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

Cualquier ficha se abre también en el navegador, por ejemplo en /docs/button.md. Es el mismo contenido que lee el asistente, sin el diseño de la página.