Construir uma ferramenta pequena para o seu consultório: por onde começar

E se, em vez de procurar um sistema que faça tudo, você construísse uma ferramenta pequena, que faz uma coisa só? A ideia parecia coisa de programador até pouco tempo atrás. Hoje, com assistentes de código, ela está ao alcance de quem sabe descrever bem o próprio problema, e médico sabe descrever problema.

Comece pelo incômodo, não pela tecnologia

O erro mais comum é abrir a ferramenta e perguntar "o que eu posso criar?". A pergunta certa é "qual tarefa me irrita todo dia?". Pode ser uma planilha de retornos pendentes que ninguém atualiza, um modelo de texto de orientação pré-procedimento que você reescreve toda semana, um checklist de materiais para a sala de procedimentos, uma lista de pacientes a recontatar.

Nossa regra é que a ferramenta pequena nasce de uma dor repetida, que você sente pelo menos algumas vezes por semana. Se o incômodo é raro, o esforço de construir e manter nunca se paga.

Descreva a ferramenta pequena em uma frase

Antes de escrever qualquer linha, escreva: "entra isso, sai aquilo". Por exemplo: "entra a lista de pacientes operados no mês, sai uma lista de quem precisa de retorno nos próximos quinze dias". Se a frase não cabe numa linha, a ferramenta ainda é grande demais. Divida até caber.

Essa frase vira o primeiro pedido para o assistente de código. Você não precisa saber programar de saída, mas precisa saber o que quer, e precisa ler as respostas com atenção para entender o que foi feito. Peça explicações em português simples sobre cada parte. Ferramentas como o Claude Code conseguem montar uma primeira versão a partir dessa descrição, e depois você vai ajustando em conversa.

Teste com dados fictícios

Aqui está a regra que mais importa. Enquanto estiver testando, use apenas dados inventados: pacientes que não existem, datas aleatórias. O código gerado por IA pode ter falhas que você não vê, e dado real em teste mal feito é vazamento esperando para acontecer. A LGPD (Lei 13.709/2018) vale para o seu projetinho de fim de semana tanto quanto para um sistema de hospital.

Teste também os casos incômodos: campo vazio, data errada, nome com acento, dois pacientes com o mesmo nome. Pergunte ao assistente quais situações podem quebrar a ferramenta e tente quebrá-la de propósito. Guarde cópia de cada versão que funciona, para poder voltar atrás.

Onde parar e quando desistir

Existe uma fronteira que a gente não recomenda cruzar sem ajuda especializada: ferramenta que sugere diagnóstico, dose ou conduta clínica. Isso é outro patamar, com exigências regulatórias, validação e responsabilidade que vão muito além de um projeto caseiro. Organizar agenda, gerar textos administrativos, controlar pendências: tudo bem. Apoiar decisão clínica: procure orientação adequada antes.

Lembre ainda que o que você construiu é seu para manter, e manutenção é um custo que ninguém coloca na conta no começo. Se o único que sabe mexer nela é você, e você viaja, a recepção fica na mão. Documente em meia página o que a ferramenta faz e onde estão os arquivos.

Quando a ferramenta já existe, dê duas semanas de uso real. Se ninguém da equipe abriu, se você mesmo voltou para o jeito antigo, aposente a ferramenta sem drama. Ela cumpriu o papel de ensinar o que você realmente precisa, e o aprendizado vale para a próxima tentativa.

Para esta semana

Escreva num papel três incômodos do seu dia e escolha o mais repetido. Redija a frase "entra isso, sai aquilo" e guarde-a. Só isso. A construção pode esperar a semana que vem, mas a frase já mostra se a ideia é pequena o bastante.

No Med+IA Hands On, workshop presencial de 8 horas em Caxias do Sul, com 30 vagas, no sábado 28 de novembro, a gente trabalha exercícios desse tipo.