24. Boas práticas

Como dar bons prompts

❌ Vago:

fix auth

✅ Específico:

no /login, quando o user clica "Sign in" sem preencher email, não aparece erro nenhum.
deve aparecer "Email é obrigatório" debaixo do campo, em vermelho.
@LoginScreen.tsx

❌ Múltiplos escopos misturados:

arranja o bug do logout, refactoriza o useAuth, e adiciona testes

✅ Um escopo de cada vez:

arranja o bug do logout: ao clicar, o user fica em loop infinite redirect entre /login e /

(Depois pedes refactor, depois testes — cada um numa mensagem.)

> O agente está orientado para detectar pedidos com múltiplos escopos e propor split antes de avançar. Se vires uma resposta a propor "vou dividir isto em 3 tarefas", aprova ou ajusta.

Quando usar cada comando

Pedido simples ("muda esta cor", "adiciona um botão") → chat normal
Feature nova com várias partes → /plan
Erro / bug → /debug
Auditar código (antes de PR / antes de shipar) → /review
Validar feature em runtime (browser real) → /te2e
Primeiro contacto com o projecto → /init
Adicionar pagamentos → /payments

> /review vs /te2e: /review analisa código estático (bugs latentes, anti-patterns, workarounds frágeis); /te2e valida comportamento runtime (UI funciona, fluxos não partem). São complementares — antes de um deploy importante, faz ambos.

Aproveitar checkpoints

Não tenhas medo de pedir coisas ousadas — se o agente fizer algo que não querias, click em "Undo" ao lado da tool call
Antes de mudanças grandes, faz /plan para teres um snapshot mental do que vai acontecer

Skills + hashtags

Usa #auth-google em vez de copiar instruções de auth a cada projecto
Cria skills pessoais para patterns que repetes
Para o teu projecto, cria skills em .toquemedia/skills/ e versiona em git

Eficiência de consumo

Não cubras o agente em ficheiros desnecessários — usa @filename para focar
Skills > pasting de docs (skills são compactos, docs ocupam contexto)
Se o agente repete trabalho, é sinal de que perdeu contexto após compaction — diz-lhe directamente o que precisa lembrar

Permission fatigue

Activa "Auto-approve diffs" quando confias na sessão (sempre podes desfazer com checkpoints)
Para /te2e: o browser_snapshot é auto-aprovado; só os cliques/types pedem permissão
Se queres pausa, diz "stop" — o agente pára na próxima oportunidade

← Toda a documentação · versão markdown