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

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

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

docs/guidelines/

As diretrizes completas em Markdown, uma por fundamento.

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

Abrir no GitHub

llms.txtem 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ó

*.mdem 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.

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