Sua primeira ferramenta pequena

Parte 01

Construa algo cujo resultado você sabe conferir

Uma primeira ferramenta precisa resolver uma tarefa delimitada. Neste exercício, crie uma calculadora de duração: quantidade de encontros multiplicada pelos minutos de cada encontro. O resultado deve aparecer em minutos e em horas com minutos restantes.

A conta é determinística: para as mesmas entradas, o resultado deve ser o mesmo. Claude ajuda a construir o código; a ferramenta usa a regra matemática para calcular. Isso permite conferir o funcionamento sem depender da interpretação de uma nova resposta a cada uso.

Parte 02

Descreva entradas, regra e erros

Você pode experimentar como Artifact ou usar Claude Code em uma pasta de projeto destinada ao exercício. A disponibilidade e a execução variam conforme o ambiente. Peça que Claude explique onde o resultado pode ser aberto e teste a versão real.

Construa uma calculadora local de duração total.
Entradas: quantidade de encontros e minutos por encontro, ambos inteiros positivos.
Regra: total = quantidade × minutos.
Mostre o total em minutos e em horas com minutos restantes.
Campos vazios, zero, negativos e valores fracionários devem gerar uma mensagem clara, sem resultado enganoso.
Use rótulos visíveis e navegação por teclado.
Não use cadastro, API, banco ou envio de dados.
Não altere arquivos fora da pasta do exercício e não publique.
Explique como abrir e testar a ferramenta.

Parte 03

Teste o que costuma escapar

Comece com três encontros de quarenta e cinco minutos: o resultado esperado é cento e trinta e cinco minutos, ou duas horas e quinze minutos. Depois teste um encontro de sessenta minutos. Confira se a apresentação mantém a equivalência entre os formatos.

Apague um campo, informe zero, um número negativo e uma fração. A ferramenta deve explicar o problema e não manter um resultado antigo como se fosse válido. Corrija qualquer falha e repita o caso. Conclua quando as contas e os estados de erro funcionarem no arquivo ou endereço que você realmente vai usar.