Orçamentos e diários de obra na construção: rascunhe com Claude Code

A obra termina e você volta para o escritório. O relógio marca 19h. O orçamento que precisa entregar amanhã cedo para o cliente ainda está em branco.

Você abre a planilha de um serviço parecido do ano passado, sobrescreve os números, corrige os nomes dos itens e recalcula os impostos. No meio do caminho o telefone toca e, quando você volta, já não sabe onde tinha parado. Quando percebe, são 21h. E o diário de obra continua zerado.

Se você é dono de uma construtora pequena ou mestre de obras, aposto que conhece essa cena. Em uma construtora que acompanho de perto, só o rascunho do orçamento e do diário consumia duas horas toda noite.

Esse trabalho não precisa ser feito inteiro à mão. Você deixa o rascunho com a IA e fica só com o que importa: o valor final e as decisões. Só com isso, o serviço administrativo da noite fica bem mais leve. Hoje eu mostro o passo a passo concreto.

Pontos principais

• Orçamento e diário de obra podem ser delegados ao Claude Code, mas só até o rascunho. A decisão final fica com você.
• Entregando os orçamentos antigos e as anotações do dia, sai um rascunho com o formato padronizado em poucos segundos.
• Valor, custo, margem e nome do cliente precisam ser conferidos a olho nu. Automatizar isso é onde mora o acidente.
• Dados pessoais como nome e endereço do cliente só entram depois de você definir uma regra interna.
• As duas horas de escritório por noite tendem a cair para cerca de 30 minutos. Embaixo deixei o prompt para copiar e o script de verificação.

Por que o administrativo na construção pesa tanto

Primeiro vamos deixar claro o leitor. Este artigo serve para construtoras de até uns 10 funcionários, em que o próprio dono ou mestre de obras escreve o orçamento e o diário. Penso em quem não tem alguém só para o administrativo, ou em quem está sozinho e não dá conta.

O fluxo da construção, do orçamento à entrega, costuma ser assim:

1. Contato inicial e vistoria no local
2. Orçamento estimado
3. Orçamento detalhado e contrato
4. Início da obra, gestão diária e diário de obra
5. Vistorias intermediária e final
6. Entrega e pós-obra

A papelada se concentra nas etapas 2 a 4. O orçamento detalhado pode ter dezenas de linhas, e o diário se acumula todo dia. Com a cabeça cheia de agendar pedreiros e comprar material, você ainda monta os documentos de noite, tudo de uma vez. É isso que cansa.

E o retrabalho é constante. Os clássicos são estes:

• Reaproveitou um orçamento antigo e o nome do cliente anterior ficou em um canto só.
• Esqueceu de atualizar um preço unitário e o custo do material ficou fora do valor de mercado atual.
• Acumulou três dias de diário e não lembra mais o que fez em cada dia.
• O formato varia de obra para obra e, toda vez que entrega ao cliente, precisa ajeitar a aparência de novo.

Nada disso é “trabalho que exige cabeça”. É cópia e transcrição. Justamente por isso o rascunho da IA funciona bem aqui.

O que delegar à IA e o que você decide sozinho

Essa é a parte mais importante, então traço a linha antes de tudo. Errar no que delegar transforma a ferramenta de útil em fonte de acidente.

Etapa	Delegar ao Claude Code	Você sempre decide
Levantar itens do orçamento	Montar um esboço dos itens a partir de obras antigas	Faltas e serviços especiais a acrescentar
Preço unitário e quantidade	Sugerir um valor provisório com base em dados antigos	Mercado atual, valor final e margem
Texto do orçamento	Rascunhar observações e premissas	Correção dos termos que afetam o contrato
Diário de obra	Formatar a anotação do dia no modelo padrão	Corrigir qualquer descrição que fuja do fato
Mensagem ao cliente	Ajustar o tom formal e a aparência	Conferir se não há erro ou mal-entendido

Resumindo: a IA é o “setor que ajeita a forma” e você é o “setor que responde pelos números”. Valor, custo, margem, texto de contrato e nomes próprios do cliente. Tudo isso passa pelo olho humano, sempre. Mesmo que o rascunho saia pronto, não envie do jeito que está. Seguindo só isso, nenhuma falha grave acontece.

Se ainda não tem clareza do que é o Claude Code em si, vale ler antes como começar com Claude Code mesmo sem ser engenheiro para visualizar melhor o trabalho descrito aqui. O uso oficial da ferramenta está na documentação oficial da Anthropic, que é a fonte primária.

Caso 1: gerar o esboço do orçamento a partir de obras antigas

É aqui que o ganho é maior. Entregando o orçamento de uma obra parecida do passado mais as condições de agora, sai um esboço já com itens e quantidades.

O jeito é simples. Junte os orçamentos antigos em um único arquivo CSV ou texto e mande o Claude Code ler. Em seguida, descreva as condições de hoje.

Deixo um modelo de prompt. Copie do jeito que está e troque o conteúdo entre colchetes pela sua obra.

Você é o responsável por orçamentos de uma construtora. Use os dados de orçamentos
antigos em anexo (past-estimates.csv) como referência e monte um "esboço" do
orçamento detalhado desta obra. O valor final quem decide sou eu.

Condições desta obra:
- Tipo de serviço: [reforma interna de sobrado de madeira]
- Área construída: [cerca de 90 m²]
- Principais serviços: [troca de papel de parede, piso laminado, troca da cozinha]
- Prazo desejado: [cerca de 3 semanas]

Regras de saída:
- Entregue em tabela com item / quantidade / unidade / preço provisório / subtotal
- Use a mediana dos dados antigos como preço provisório e escreva (conferir) onde houver estimativa
- Liste no fim, em tópicos, os itens que parecem precisar de serviço especial ou adicional
- Mostre também a fórmula usada no total e nos impostos

O ponto é declarar logo no começo “esboço” e “o valor final quem decide sou eu”. Não jogue a responsabilidade do valor na IA. Faça-a marcar (conferir) nos preços provisórios. Assim, fica óbvio à primeira vista onde a pessoa precisa checar depois.

Quem quer subir mais um nível na precisão do prompt pode ler junto técnicas avançadas de engenharia de prompt no Claude Code, que ajudam a reduzir a variação da saída.

Caso 2: transformar a anotação do dia em diário de obra

No diário, o problema não é “o que escrever”, é “o ânimo de escrever”. Pegar aquelas anotações soltas que você digitou no celular na obra e ajeitar no modelo padrão é tarefa de sobra para a IA.

Por exemplo, suponha que você deixou esta anotação na obra:

07/06 sol casa Silva
manhã continua demolição arrancada do piso do corredor concluída
de tarde 2 pedreiros área do banheiro contrapiso
veio o eletricista posição da tomada conferida com o cliente
amanhã impermeabilização se chover adia

Entregando isso, volta um rascunho de diário assim:

[Diário de Obra] 7 de junho de 2026 (sábado) - Clima: ensolarado
Obra: casa Silva

Atividades:
- Manhã: continuidade da demolição. Arrancada do piso do corredor concluída.
- Tarde: 2 pedreiros executando o contrapiso na área do banheiro.
- Visita do eletricista. Posição da tomada definida após confirmação com o cliente.

Programação de amanhã:
- Impermeabilização prevista. Em caso de chuva, adiada.

Observações:
- Posição da tomada com aval do cliente.

Escrever isso do zero todo dia ou colar a anotação e pedir para ajeitar: o tempo gasto é de outra ordem de grandeza.

Um cuidado. A IA, na vontade de escrever bonito, às vezes inventa serviços que não estavam na anotação. Acrescente uma frase: “Não adicione serviço que não esteja na anotação. Onde não souber, escreva (indefinido)”. Isso evita a invenção.

Caso 3: conferir o formato do orçamento e do diário de forma mecânica

Saiu o rascunho, mas não acredite nele às cegas. No orçamento, em especial, costumam aparecer erro na soma do total e item duplicado. Aqui a máquina é melhor que o olho humano.

Deixo a lista de pontos de checagem. Só colar isto no fim do prompt toda vez já estabiliza a qualidade da saída:

• A soma dos subtotais bate com o total exibido?
• O cálculo do imposto está correto (sem imposto x 0,1)?
• O mesmo item aparece duplicado em duas linhas?
• Sobrou nome ou endereço do cliente anterior?
• Quantas linhas estão marcadas com (conferir)?

Dessas, a consistência dos valores dá para confirmar com código em um passo. Na próxima seção deixo um script que realmente roda.

Script de verificação pronto para copiar

É um script Node.js que confere se o total do orçamento fecha. Entregando um CSV (item, quantidade, preço), ele calcula a soma dos subtotais, o imposto e o total com imposto, e avisa se há diferença em relação ao total que a IA apresentou. Se você tem Node.js instalado, roda sem instalar mais nada.

Salve como check-estimate.mjs.

import { readFile } from "node:fs/promises";

// Argumentos: caminho do CSV, total sem imposto apresentado pela IA
const [csvPath, claimedRaw] = process.argv.slice(2);
if (!csvPath) {
  console.error("Uso: node check-estimate.mjs estimate.csv 350000");
  process.exit(1);
}

const text = await readFile(csvPath, "utf8");
const rows = text
  .trim()
  .split(/\r?\n/)
  .slice(1) // pula a linha de cabeçalho
  .map((line) => line.split(","));

let subtotal = 0;
const seen = new Set();
const warnings = [];

for (const [name, qtyRaw, priceRaw] of rows) {
  const qty = Number(qtyRaw);
  const price = Number(priceRaw);
  if (Number.isNaN(qty) || Number.isNaN(price)) {
    warnings.push(`Linha com número ilegível: ${name}`);
    continue;
  }
  if (seen.has(name)) warnings.push(`Item duplicado: ${name}`);
  seen.add(name);
  subtotal += qty * price;
}

const tax = Math.round(subtotal * 0.1);
const total = subtotal + tax;

console.log(`Subtotal (sem imposto): ${subtotal.toLocaleString()}`);
console.log(`Imposto (10%): ${tax.toLocaleString()}`);
console.log(`Total (com imposto): ${total.toLocaleString()}`);

if (claimedRaw) {
  const claimed = Number(claimedRaw);
  const ok = claimed === subtotal;
  console.log(ok ? "OK: bate com o total da IA" : `ERRO: difere do total da IA (${claimed.toLocaleString()})`);
}

if (warnings.length) {
  console.log("--- Conferir ---");
  for (const w of warnings) console.log(w);
}

Para executar, é só isto:

node check-estimate.mjs estimate.csv 350000

O estimate.csv deve ter este formato:

item,quantidade,preco
Troca de papel de parede,90,1200
Piso laminado,30,8000
Descarte de entulho,1,30000

O bom desse script é não precisar fazer a conta de cabeça. Se o total da IA vier como ERRO, aquele orçamento ainda não pode ir para o cliente. Se houver item duplicado, ele aparece em Conferir. Quem decide o valor no fim é você, mas o erro de descuido a máquina derruba antes.

O que muda entre o antes e o depois

É mais rápido ver em números. É só uma referência, mas pelo que acompanhei a mudança foi mais ou menos esta:

Item	Antes	Depois
Rascunho de 1 orçamento detalhado	60 a 90 min	15 a 25 min (com conferência)
Diário de 1 dia	15 a 20 min	3 a 5 min
Variação de formato	Diferente em cada obra	Unificada por modelo
Quando o erro de conta aparece	Depois de entregar ao cliente	Antes de entregar, pelo script

Deixo também um ROI simples. Suponha 3 orçamentos por semana e diário em 5 dias. Se a automação do rascunho poupa 50 minutos por orçamento e 12 minutos por diário, são cerca de 3 horas na semana. Considerando o valor da hora do dono em torno de R$ 80, são cerca de R$ 240 por semana, perto de R$ 1.000 por mês de tempo recuperado.

É claro que isso sobe e desce conforme as premissas, mas dá tranquilamente para mirar em “as duas horas da noite caírem para menos de uma”. Poder devolver esse tempo à precisão do orçamento e à obra é, para mim, o efeito de verdade.

Cuidados com segurança e dados pessoais

Aqui é justamente onde uma construtora não pode escorregar. Orçamento e diário são um amontoado de dados pessoais: nome, endereço e telefone do cliente.

No mínimo, defina estas três coisas dentro da empresa antes de começar:

• Até onde os dados vão para a IA, defina antes. Operar com nome e endereço mascarados (algo como “casa do cliente A”) já joga para o lado seguro.
• Mande só dados dentro do que a empresa pode manusear. Não coloque, sem autorização, projetos ou contratos recebidos do cliente em ferramentas externas.
• O rascunho que sair só é salvo ou enviado depois de uma pessoa ler. Não jogue a saída da IA direto para fora.

Mascarar parece trabalhoso, mas com o costume leva segundos. Os itens e quantidades do orçamento não precisam dos dados pessoais do cliente, então basta encaixar os nomes próprios depois.

Se for usar como empresa, com mais de uma pessoa, é preciso estruturar até a criação dessas regras e o treinamento. Quando passar do nível de testar sozinho, desenhar as regras de operação junto no treinamento e consultoria acaba sendo o caminho mais curto. Se ainda está na fase de testar sozinho, começar pelos materiais em produtos já basta.

Perguntas frequentes

P. Dá para ler direto um orçamento feito em Excel ou em sistema de gestão? R. O Excel é lido se você exportar em CSV. A maioria dos sistemas contábeis também tem exportação em CSV, então passar para CSV antes é o mais seguro. Em vez de entregar o arquivo direto, extrair só as colunas necessárias melhora a precisão.

P. Posso entregar ao cliente o valor que a IA gerou? R. Não. O preço provisório é uma colcha de retalhos de dados antigos e não reflete o mercado atual nem o caso específico. O valor precisa ser conferido e decidido por uma pessoa, sempre. O seguro é assumir que a IA cuida só do levantamento de itens e do formato.

P. Funciona mesmo para quem tem dificuldade com computador? R. O ato de colar o prompt não é diferente de escrever um e-mail. O difícil é só a configuração inicial. Monte uma vez seguindo como começar com Claude Code mesmo sem ser engenheiro e, depois, é repetir a mesma operação todos os dias.

P. Meus orçamentos antigos só existem no papel. R. Comece digitando à mão em CSV só os 10 mais usados do período recente. Não precisa digitalizar tudo. Bastam alguns casos representativos para virar modelo e a precisão do esboço já sobe bastante.

P. Há truques para aumentar ainda mais a produtividade? R. Salvar os prompts mais usados como modelos prontos faz diferença. Em dicas de produtividade no Claude Code reuni o uso do dia a dia.

O que aconteceu quando testei de verdade

Com a ajuda de uma construtora que conheço, testei com 3 orçamentos antigos e 5 dias de anotações reais.

No esboço do orçamento, 80% dos itens já vieram preenchidos pelos dados antigos. Os 20% restantes eram serviço especial, e isso o dono acrescenta à mão. Mesmo assim, é muito mais rápido que escrever do zero. Ao passar pelo script de verificação, peguei um erro de transcrição de preço em um orçamento. Notar antes de entregar foi um ganho enorme.

No diário, o que mais funcionou foi formatar de noite as anotações do celular feitas na obra. Mesmo acumulando três dias, basta ter as anotações para sair o rascunho dos três em poucos minutos. Para montar a base do uso, vale ler antes o guia de primeiros passos com Claude Code e as boas práticas de CLAUDE.md, que ajudam a colocar as regras internas no papel.

Por outro lado, no começo eu economizei na máscara dos dados e o nome do cliente entrou na saída: levei um susto. A linha dos dados pessoais tem mesmo que ser definida primeiro. No geral, o administrativo da noite caiu para menos da metade na sensação. Mais do que caçar uma IA mais esperta, decidir antes o que delegar e como conferir é o que faz efeito. Essa é a conclusão desta vez.