Módulo 2 · Projeto prático
Projeto: Verificação de fichas técnicas
Cada ficha correta e completa — verificada com a sua própria checklist
Uma pilha de fichas técnicas em PDF — especificações de produtos, datasheets de equipamentos, fichas de segurança — e tem de dizer, para cada uma, se está correta e completa. O truque não está em perguntar ao Claude «isto está bem?» (ele não tem como saber o que «bem» significa para si). O truque está em dar-lhe a checklist do que uma ficha correta tem de conter e deixá-lo verificar cada ficheiro em relação a ela.
É o mais perto que um utilizador de escritório chega das «evals». Uma eval é apenas uma verificação estruturada de se o resultado cumpre um padrão conhecido (e um eval harness é a maquinaria que os engenheiros constroem para correr milhares delas automaticamente). Aqui não precisa de nada disso: entrega-lhe a verdade de referência (os campos obrigatórios) e fá-lo reportar as lacunas. A qualidade da verificação é apenas tão boa quanto a checklist que escrever, e é aí que investe o seu esforço.
Do que precisa na pasta
- As fichas técnicas a verificar (PDF ou Word), cada uma nomeada de forma a que o seu tipo seja reconhecível (ex.: valvula-DN50.pdf, bomba-X.pdf).
- Um ficheiro de checklist — required-fields.md — que liste os campos obrigatórios por tipo de ficha. Este é o coração do projeto.