Apoio escrito: uma spec útil reduz decisões escondidas
Esta aula complementar retira princípios transferíveis de um vídeo que demonstra ferramentas e modelos específicos. A stack apresentada pode mudar; o problema de fundo permanece: um agente precisa saber o que deve entregar, quais limites respeitar e como verificar o resultado.
Abrir diagrama em tamanho original
Considere o pedido “adicione busca de cursos”. Antes de delegar, transforme-o em critérios que possam ser verificados:
- A pessoa consegue buscar por parte do título.
- Resultados vazios mostram uma mensagem clara.
- A busca não altera nem exclui cursos.
- A tela funciona em largura móvel.
- Há uma verificação para correspondências, ausência de resultados e entrada vazia.
Em seguida, decomponha o trabalho. Identificar a fonte dos dados pode ser necessário antes de escrever a busca. O componente visual e uma função pura de filtragem talvez possam ser construídos em paralelo, desde que a interface entre ambos esteja combinada. A revisão e os testes dependem da implementação.
Uma sequência explícita ajuda a distinguir tarefas independentes das dependentes. Em paralelo, tarefas precisam ter limites claros e não editar o mesmo trecho sem coordenação. Por fim, verifique cada critério com evidência: teste, diff revisado ou comportamento observado.
O vídeo usa ferramentas particulares para especificar, orquestrar e rotear tarefas. Trate-as como exemplos. A prática duradoura é escrever critérios de aceitação, indicar dependências e verificar o resultado, seja o trabalho feito por uma pessoa, por um agente ou pelos dois.
Pergunta de recuperação: qual parte do pedido “adicione busca de cursos” ainda está ambígua? Escreva dois critérios observáveis antes de propor a implementação.
Para aprofundar
- OpenAI: Harness engineering — planos executáveis, requisitos verificáveis e feedback durante o trabalho.
- Anthropic: Building effective agents — prompt chaining e decomposição por orquestrador.
- OpenAI Academy: Skills — transformar instruções e documentos em trabalho estruturado.
Material complementar da Fernanda
-
Guia de Claude Code: planejamento e execução — Compare um pedido vago com um objetivo que possui critérios verificáveis. Antes da implementação, escreva quais arquivos podem mudar e que evidências mostrarão que a tarefa terminou.
-
Exemplo de instruções de projeto — Observe como regras de execução, testes e organização são registradas. O exemplo é de um projeto Python específico: adapte as regras ao seu repositório em vez de copiá-las como universais.
Pratique com /aprender
Copie o comando e cole no chat para iniciar uma prática guiada:
/aprender Quero praticar especificações para agentes. Use o pedido vago “adicione busca de cursos” e me ajude a produzir critérios de aceitação observáveis, dividir o trabalho em tarefas, marcar dependências e escolher verificações. Não proponha a solução por mim: faça uma pergunta de cada vez, espere minha tentativa e aponte ambiguidades para eu corrigir.