# Para agentes

Los archivos que un agente de IA lee para construir con Feitio: qué contiene cada uno y dónde reside.

## Por qué

Una buena parte de quienes construyen con Feitio son agentes de IA. No miran la página: leen archivos. Por lo tanto, cada regla de Feitio también existe como texto, en un lugar que el agente encuentra por su cuenta.

## Los archivos

### `AGENTS.md`

Las reglas para quienes cambian el repositorio de Feitio, personas y agentes.

-   lo que nunca hacer (editar archivos generados, colores manuscritos, componentes en el núcleo); cómo cambiar tokens, iconos e ilustraciones; las pruebas

[Abrir en GitHub](https://github.com/Made-by-MAID/feitio/blob/main/AGENTS.md)

### `skills/feitio/SKILL.md`

Cómo construir una interfaz con Feitio: la versión breve de las directrices, para que el agente use el sistema en lugar de inventar estilo.

-   el setup (CSS, fuentes, iconos), las reglas para color, tipo, forma, movimiento y escritura, y lo que nunca hacer

[Open on GitHub](https://github.com/Made-by-MAID/feitio/blob/main/skills/feitio/SKILL.md)

### `tokens/`

Los valores de Feitio en JSON abierto (DTCG), legibles por cualquier herramienta.

-   la base y cada tema, de día y de noche

[Open on GitHub](https://github.com/Made-by-MAID/feitio/tree/main/tokens)

### `docs/guidelines/`

Las directrices completas en Markdown, una por fundación.

-   color, tipo, espacio, forma, movimiento, iconografía y voz

[Open on GitHub](https://github.com/Made-by-MAID/feitio/tree/main/docs/guidelines)

### `llms.txt`soon

El mapa del sitio para agentes, en la dirección que buscan primero: qué existe y dónde, en texto.

-   la lista de páginas con una línea cada una, y un `llms-full.txt` con todo en una página

### `*.md`soon

Cada página del sitio también en Markdown, en la misma dirección terminando en `.md`.

-   el mismo contenido que la página, sin el marco

Hoy `SKILL.md` aún no tiene las reglas de esta fase (primero móvil, solo JavaScript necesario, pantallas grandes, feedback en su lugar, dónde residen las acciones). Se actualiza con el paso final de Feitio.

## Cómo usar con un agente

-   Los agentes que leen habilidades (como Claude Code) encuentran Feitio cuando la carpeta `skills/feitio/` se encuentra en su carpeta de habilidades, dentro del proyecto o en tu máquina.
-   Los agentes que leen `AGENTS.md` (como Codex) leen el repositorio cuando trabajan dentro de él.
-   Para un agente que solo tiene la web, apúntalo al `llms.txt` del sitio: `https://feitio.bymaid.com/es/llms.txt`, o al `llms-full.txt` con todo.

```shell
npx degit Made-by-MAID/feitio/skills/feitio .claude/skills/feitio
```