# Para agentes

Os arquivos que um agente de IA lê para construir com o Feitio: o que cada um tem e onde está.

## Por que

Boa parte de quem vai construir com o Feitio é um agente de IA. Ele não olha a página: lê arquivos. Por isso cada regra do Feitio também existe em texto, num lugar que o agente acha sozinho.

## Os arquivos

### `AGENTS.md`

As regras para quem mexe no repositório do Feitio, pessoas e agentes.

-   o que nunca fazer (editar arquivo gerado, escrever cor à mão, componente no núcleo); como mudar tokens, ícones e ilustrações; os testes

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

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

Como construir uma interface com o Feitio: a versão curta das diretrizes, para o agente usar o sistema em vez de inventar estilo.

-   a montagem (CSS, fontes, ícones), as regras de cor, letra, forma, movimento e escrita, e o que nunca fazer

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

### `tokens/`

Os valores do Feitio em JSON aberto (DTCG), que qualquer ferramenta lê.

-   a base e cada tema, de dia e à noite

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

### `docs/guidelines/`

As diretrizes completas em Markdown, uma por fundamento.

-   cor, letra, espaço, forma, movimento, iconografia e voz

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

### `llms.txt`em breve

O mapa do site para agentes, no endereço que eles procuram primeiro: o que existe e onde está, em texto.

-   a lista de páginas com uma linha de cada, e um `llms-full.txt` com tudo numa página só

### `*.md`em breve

Cada página do site também em Markdown, no mesmo endereço terminado em `.md`.

-   o mesmo conteúdo da página, sem a moldura

O `SKILL.md` de hoje ainda não tem as regras desta fase (mobile first, JavaScript na medida, telas grandes, retorno no lugar, onde moram as ações). Ele é atualizado junto com o acabamento do Feitio.

## Como usar com um agente

-   Agentes que leem skills (como o Claude Code) acham a do Feitio quando a pasta `skills/feitio/` está na pasta de skills deles, no projeto ou na sua máquina.
-   Agentes que leem `AGENTS.md` (como o Codex) leem o do repositório quando trabalham dentro dele.
-   Para um agente que só tem a web, aponte para o `llms.txt` do site: `https://feitio.bymaid.com/pt/llms.txt`, ou o `llms-full.txt` com tudo.

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