# ferramentas/

Esta pasta é a fonte da verdade do estúdio. O servidor lê estes arquivos e os
entrega juntos em `GET /api/manual` — não existe spec duplicada em outro lugar.
Editar um `.md` aqui muda o que a IA sabe, na hora, sem reiniciar nada.

| Arquivo | Conteúdo |
|---|---|
| `00-protocolo.md` | como o agente se comporta, a frase de abertura, a tabela de equivalência e a API |
| `01-modelos.md` | os três modelos de documento — `cena`, `documento`, `planilha` |
| `prisma.md` | apresentações |
| `tela.md` | design gráfico |
| `prosa.md` | documentos |
| `grade.md` | planilhas |
| `corte.md` | vídeo |
| `traco.md` | diagramas |

## Ordem de leitura para um agente

1. `00-protocolo.md` — decide **o quê** e **como responder**
2. `01-modelos.md` — aprende **o formato**
3. o `.md` da ferramenta escolhida — pega o **exemplo pronto** e adapta

Um agente com pressa pode buscar tudo de uma vez em `GET /api/manual`.

## Endpoints

```
GET /api/manual                 tudo isto, concatenado
GET /api/ferramentas            as seis, em JSON
GET /api/ferramentas/<slug>     um destes arquivos, em texto
```