Aulas relacionadas: Aula 01. Modelos robustos não garantem execução confiável. · Aula 02. O que significa, de fato, arnês. Arquivos de template: templates/
Projeto 01. Apenas Prompt vs. Regras Primeiro: Quanta Diferença Isso Faz
O Que Você Vai Fazer
Construa um shell mínimo de aplicativo Electron para base de conhecimento — uma janela com uma lista de documentos à esquerda, um painel de perguntas e respostas à direita e um diretório local de dados. A tarefa em si não é complexa. O que é complexo é como você faz o agente concluí-la.
Você executará isso duas vezes. Na primeira vez: apenas um prompt, sem preparação. Na segunda vez: AGENTS.md, init.sh e feature_list.json previamente adicionados ao repositório. Depois, compare os resultados.
O cenário deste curso utiliza um curto intervalo de redescoberta/preparação como exemplo, não como um resultado fixo e mensurável.
Ferramentas
- Claude Code ou Codex (escolha um e utilize o mesmo nas duas execuções)
- Git (para gerenciar branches e comparar resultados)
- Node.js + Electron (stack do projeto)
- Um cronômetro (registre a duração de cada execução)
Mecanismo do Harness
Harness mínimo: AGENTS.md + init.sh + feature_list.json
Utilize o Projeto Versionado
Caminho do repositório: projects/project-01/
| Diretório | O que contém | Como utilizar |
|---|---|---|
starter/ | A execução com harness fraco. Contém apenas task-prompt.md como descrição da tarefa e não possui AGENTS.md nem feature_list.json. | Entregue o prompt ao seu agente de programação e meça o que ele consegue concluir sem estrutura adicional. |
solution/ | O mesmo recorte de produto com artefatos explícitos de harness: AGENTS.md, CLAUDE.md, init.sh, feature_list.json e claude-progress.md. | Compare como a mesma tarefa se torna concreta através de regras e evidências de verificação. |
As quatro funcionalidades concretas são: abertura da janela, lista de documentos, painel de perguntas e respostas, e criação do diretório local de dados. Inspecione solution/feature_list.json para entender as evidências esperadas para cada funcionalidade.