06Prompt 2: o Trabalhador
É quem escreve cada tela, API, migration e seed. Cada execução monta duas peças: o system (fixo, igual para todas as tarefas) e o texto da tarefa (gerado a partir do contrato). Mais o GUIA.md, que o system manda ler inteiro.
Peso de cada peça numa tarefa de tela
System do trabalhador2,0 KB
Texto da tarefa (T16 carrinho)2,7 KB
GUIA.md (lido pelo agente)30,2 KB
O GUIA ensina estrutura de arquivos, manifesto, rotas, SQL, i18n e data-testid. Das 365 linhas, as que tocam em aparência são o parágrafo de “Tema, cores e tamanhos” (só tokens, nunca hex) e a regra de imagens (WebP leve).
6.1 System prompt completo
Texto literal de trabalhador-prompt.js. Tudo que não está aqui, o agente não sabe.
Você é engenheiro(a) sênior num time que constrói SaaS. Você trabalha numa cópia isolada do projeto (a pasta atual) e faz UMA tarefa por vez.
Primeiro leia GUIA.md inteiro: ele manda sobre como o projeto é organizado. O projeto de referência fica descrito nele; copie os padrões.
Regras duras:
- Altere SOMENTE os arquivos permitidos da tarefa. O que estiver fora é desfeito automaticamente e a tentativa perde.
- O manifesto (pixios.manifesto.json) é o contrato: você pode ACRESCENTAR detalhes (ações, formulários, estados, amostras), nunca remover nem afrouxar o que já existe (rotas, papéis, campos sensíveis, limites, fluxos).
- Não instale pacotes (npm/pnpm). Precisa de uma biblioteca? Rode ./pedir-dependencia <pacote> "<motivo>" e siga sem ela; a resposta chega na próxima tentativa.
- Nada de rede externa, eval, escrita fora do projeto, segredos no código. SQL sempre parametrizado.
- Todo texto visível sai de chave i18n nos 3 idiomas (pt-BR, en, es), sem emoji. Interface mobile-first, claro e escuro, estados vazio/carregando/erro.
- Rode ./verificar antes de terminar e corrija tudo o que ele apontar. Ele é uma checagem rápida; a conferência completa (API, telas, cliques, segurança) acontece depois que você terminar.
- Se o resultado de uma tentativa anterior citar um fluxo ou formulário que falhou, rode ./reproduzir <id> para ver a falha acontecer de verdade (passos, erro, log do servidor e print) antes de mexer no código. ./reproduzir sem argumento lista os ids. Se responder que ainda está rodando, espere com ./reproduzir --resultado.
- Precisa renomear um arquivo (ex.: migration com número errado)? Use ./renomear <de> <para>; funciona só entre caminhos permitidos da tarefa. mv e rm não existem aqui.
- CRUD simples (listar, ler, criar, atualizar, excluir de um recurso) usa `ctx.crud` (GUIA.md 4.1) em vez de rotas escritas à mão; escreva a mão só a regra de negócio própria.
- Faça o mínimo que a tarefa pede, bem feito. Não invente funcionalidades.
- Ao terminar escreva relatorio.json com { "feito": [..], "pendente": [..] } e encerre.
Papel“engenheiro(a) sênior”. A palavra design, estética ou criatividade não aparece nenhuma vez.
Referência“copie os padrões” do projeto de referência (a loja de exemplo da base).
Escopo“Faça o mínimo que a tarefa pede, bem feito. Não invente funcionalidades.”
Visual“Interface mobile-first, claro e escuro, estados vazio/carregando/erro”. É a única frase de interface.
AusenteIdentidade da marca, fotos, ilustração, logo, tom de voz, referência de demo, revisão olhando a própria tela.
6.2 Texto de uma tarefa de tela (T16: carrinho)
Montado por tarefaTexto() a partir do contrato. Abaixo, a mensagem exata que o Claude recebeu para escrever a tela do carrinho (gerada agora com o plano real do build).
# Tarefa T16 (pagina): pagina: carrinho
Tela "carrinho" do módulo "Vitrine e carrinho": Experiência do cliente: catálogo com busca e filtros, detalhe do produto, carrinho persistido no banco, validação de cupom, conta e página Mais.
## Projeto
Nome: Peixaria do Batata. E-commerce de peixes e frutos do mar com venda por kg, unidade e embalagem, entrega por bairro, pedido por WhatsApp, pagamento Pix registrado no banco e painel administrativo.
Cores: {"fundo":"#FFF8F0","texto":"#2E2A24","primaria":"#1F7A63"}. Idiomas: pt-BR, en, es.
## Módulo
Vitrine e carrinho: Experiência do cliente: catálogo com busca e filtros, detalhe do produto, carrinho persistido no banco, validação de cupom, conta e página Mais.
## Prefixo desta tarefa
Use o prefixo `016` nos arquivos de migration e seed (veja os arquivos permitidos).
## Critérios de pronto
- a página abre em `/carrinho` para cliente e usa exatamente os data-testid do manifesto
- estados vazio, carregando e erro renderizados; formulários validam e mostram a mensagem do servidor; ação destrutiva pede confirmação
- mobile-first, claro e escuro, alvo de toque >= 44px, sem emoji, ícones do conjunto da base
- nada fica atrás do menu inferior
- `./verificar` termina sem problemas graves
- nenhum texto fixo na tela: tudo por chave nos 3 idiomas (pt-BR, en, es)
## Arquivos permitidos
- pixios.manifesto.json
- src/paginas/Carrinho.jsx
- src/paginas/carrinho-*.jsx
- src/paginas/carrinho/**
- src/i18n/*.json
- ativos/**
## Página do contrato (já no manifesto)
```json
[
{
"id": "carrinho",
"menu": {
"icone": "bag",
"ordem": 2,
"rotulo": "menu.carrinho"
},
"rota": "/carrinho",
"acoes": [
{
"id": "abrir-item",
"tipo": "navegar",
"testid": "carrinho-item",
"destino": "/catalogo/:id"
},
{
"id": "alterar-quantidade",
"tipo": "enviar",
"testid": "carrinho-quantidade",
"endpoint": "carrinho-atualizar"
},
{
"id": "remover-item",
"tipo": "excluir",
"testid": "carrinho-remover",
"endpoint": "carrinho-remover",
"destrutiva": true
},
{
"id": "ir-checkout",
"tipo": "navegar",
"testid": "carrinho-checkout",
"destino": "/checkout"
},
{
"id": "continuar-comprando",
"tipo": "navegar",
"testid": "carrinho-continuar",
"destino": "/catalogo"
}
],
"dados": [
"carrinho-obter"
],
"papeis": [
"cliente"
],
"titulo": "pagina.carrinho.titulo",
"estados": {
"erro": "carrinho-erro",
"vazio": "carrinho-vazio",
"carregando": "carrinho-carregando"
}
}
]
```
ProjetoNome, descrição de 1 frase, 3 cores e idiomas. Nada mais sobre a marca.
CritériosTodos técnicos: testids, estados, alvo de toque, sem emoji, ícones “do conjunto da base”.
Arquivosativos/** está permitido, mas nenhuma instrução diz o que colocar ali, e o agente não tem como gerar imagem.
AusenteA demo, os prints dela, a paleta completa, as fontes, a direção “Acolhedor”, as fotos e a frase “Visual fiel à demo aprovada” que existe na spec.
