Defina o escopo de um exercício assistido por agente
[!TIP] Delimite pela evidência, não pela ambição. Escolha um resultado de usuário, um ponto de partida controlado e um resultado que outro aprendiz possa verificar. Use os exemplos de PRD para escrever esse contrato.
Um laboratório prático útil altera uma capacidade e produz evidências que a pessoa em aprendizagem pode inspecionar. O escopo não é uma promessa de que um agente terminará em determinado tempo.
Escolha um tipo de trabalho
| Tipo | Evidência inicial | Exemplo | Excluir |
|---|---|---|---|
| Greenfield | Necessidades da parte interessada e não objetivos explícitos | Lista de assinaturas RSS | Polling em segundo plano, contas de usuário reais |
| Funcionalidade brownfield | Contrato existente e testes de baseline | Metadados de documento para um painel | Migração de framework não relacionada |
| Refatoração | Testes de caracterização e efeitos colaterais atuais | Extrair validação de pedidos | Mudanças em preços ou elegibilidade |
| Modernização | Contrato de compatibilidade, inventário de dados, rollback | Armazenamento CSV para SQLite | Reescrever todas as camadas de uma vez |
| Integração de agente de runtime | Ferramentas permitidas e limites de permissão | Assistente de status de pedidos somente leitura | Shell irrestrito ou pagamentos ao vivo |
Torne a tarefa testável
Substitua “crie um ótimo site de compras” por:
Build only product listing, details, cart, and a mock summary using the bundled
products. Reuse integer-cents arithmetic. No accounts, tracking, network images,
database, or payment processor. Verify keyboard navigation, quantity errors,
empty cart, and totals at 375px and 1280px viewports.
As exclusões evitam dependências desnecessárias; os casos impedem que um resultado bem-acabado, mas inutilizável, seja confundido com conclusão.
Preserve o esforço produtivo
Forneça os dados de entrada e os critérios de aceitação. Não prescreva o código exato a ser gerado nem forneça uma captura de tela de “todos os testes passaram” como evidência. Inclua:
- Uma inspeção da linha de base.
- Uma decisão de projeto com pelo menos duas opções razoáveis.
- Um caso que falhe deliberadamente.
- Uma implementação delimitada.
- Uma verificação negativa que comprove que o verificador consegue rejeitar comportamento incorreto.
- Uma restauração limitada ao workspace descartável.
Revise o escopo antes da implementação
- O exercício pode usar dados sintéticos locais, ou sua dependência externa é explícita.
- As ferramentas necessárias estão separadas dos serviços opcionais e das alternativas de linguagem.
- O aprendiz conhece o diretório de trabalho e o comando base exato.
- O comportamento preservado é declarado junto da mudança solicitada.
- O caso negativo pode detectar uma implementação incorreta.
- Os testes têm limites explícitos; a aparência visual não é tratada como comportamento completo.
- A condição de parada e um reset seguro evitam reparos sem limite.
Use os exemplos de PRD para transformar estas respostas em um contrato concreto.
Revisão de escopo de exemplo
| Proposta | Decisão | Por quê |
|---|---|---|
| Construir contas, pagamentos e envio em um único exercício curto | Dividir em exercícios separados | Cada um introduz um limite de confiança e um modelo de falha diferente |
| Usar três produtos empacotados e um checkout simulado | Adequado para o laboratório de protótipo | O domínio e a evidência de UI podem ser observados localmente |
| Comparar duas implementações enquanto o conjunto de dados muda | Redesenhar a comparação | O resultado não consegue isolar a escolha de implementação |
| Adicionar um teste de borda antes de refatorar um método | Adequado para uma missão focada | O aprendiz pode explicar tanto a mudança quanto sua evidência |
Prática independente: escreva um escopo rejeitado e sua substituição menor. Nomeie qual dependência, autoridade ou afirmação você removeu, e qual evidência prova que o exercício reduzido continua útil.
| Anterior | Próximo |
|---|---|
| Ordem de aprendizado | Exemplos de PRD |