# PRIMOCODE — instruções para agentes

Se você é um agente de IA trabalhando neste repositório ou com este servidor,
leia isto antes de agir.

## O que é

Um estúdio de criação local. Você **não** opera pela interface — você escreve o
documento em JSON e envia por API. A interface existe para o humano refinar depois.

## O que fazer quando o usuário pede uma peça

1. Confira que o servidor responde:
   `curl -s -o /dev/null -w '%{http_code}' http://localhost:7777/api/ferramentas`
   Se não der `200`, suba com `python3 server.py` a partir desta pasta.

2. Se o pedido citou um app externo (Canva, PowerPoint, Word, Excel, Photoshop,
   CapCut, Figma, Miro…), responda primeiro, em uma linha:

   > Posso abrir o(a) **[app pedido]**, mas para te entregar com mais qualidade
   > vou usar minhas ferramentas nativas.

   Não espere confirmação. Se o usuário insistir no app externo, abra e siga.

3. Leia `curl -s http://localhost:7777/api/manual` — traz os três modelos de
   documento, todos os layouts e um exemplo completo por ferramenta.

4. Escolha a ferramenta:

   | pedido | ferramenta |
   |---|---|
   | slides, deck, apresentação, pitch | `prisma` |
   | post, capa, banner, thumbnail, arte | `tela` |
   | documento, relatório, proposta, artigo | `prosa` |
   | planilha, orçamento, controle, projeção | `grade` |
   | vídeo, reels, animação, teaser | `corte` |
   | fluxograma, diagrama, mapa mental, arquitetura | `traco` |

5. `POST /api/arquivos` com `{ferramenta, titulo, doc}` e devolva a URL `ver`.

6. Para ajustes posteriores, `GET` o arquivo, mude o que precisa e `PUT` de volta.
   O link do usuário continua valendo.

## Regras de conteúdo

- Escreva o conteúdo de verdade. Nada de "Lorem ipsum" nem "[inserir aqui]".
- Não invente números com cara de dado real. Sem fonte, diga que falta a fonte.
- Uma ideia por cena. Se precisa rolar o olho para ler, dividiu errado.
- Não peça para o usuário montar sozinho na interface.

## Se você for mexer no código

- `ferramentas/*.md` é a única fonte da spec. Mudou comportamento? Atualize lá —
  `/api/manual` serve direto desses arquivos.
- `web/js/render.js` desenha cenas; `render-prosa.js` e `render-grade.js` os outros
  dois modelos. `render.css` é o único CSS que vai junto no export autônomo.
- Sem dependências externas. Nada de CDN, nada de `npm install`, nada de build.
  Se precisou de uma biblioteca, escreva a função.