Guia prático e objetivo de Claude Code: resultados

Cada pedido pronto do guia foi executado de verdade. Aqui está o que o Claude entregou em cada exemplo e projeto, com os arquivos para você baixar e testar. Clique no item para ir direto a ele.

Exemplos

#exemplo-skill

2.2 Skill: a receita

O que foi pedido: somar as vendas da semana por vendedor, comparar com a semana anterior e destacar quem caiu mais de 10%; depois, guardar o passo a passo como skill.

Dados inventados para o teste.

Depois de fazer o resumo uma vez, o pedido foi guardado como skill. Na semana seguinte, numa conversa nova, bastou escrever resumo semanal. O resultado veio no mesmo formato:

Resumo da semana de 09/11 (gerado pela skill)

Resumo de vendas da semana (09/11 a 15/11/2026)

Comparado com a semana anterior (02/11 a 08/11/2026). Valores em R$.

VendedorSemana anteriorSemana atualVariação
Bruno Lima15.08039.840+164,2%
Carla Dias22.49035.910+59,7%
Diego Reis33.13035.490+7,1%
Elisa Prado12.04026.390+119,2%
Ana Souza33.86025.220-25,5%CAIU MAIS DE 10%
Total116.600162.850+39,7%

Destaques

  • Ana Souza: caiu 25,5% (de R$ 33.860 para R$ 25.220); 16 vendas antes, 10 agora.
  • Total da loja: +39,7% (62 vendas antes, 67 agora).

Fonte: vendas-semana-2026-11-02.xlsx e vendas-semana-2026-11-09.xlsx. Soma da coluna Valor (R$).

Resumo da semana de 02/11 (o primeiro, feito na conversa)

Resumo de vendas da semana (02/11 a 08/11/2026)

Comparado com a semana anterior (26/10 a 01/11/2026). Valores em R$.

VendedorSemana anteriorSemana atualVariação
Ana Souza26.20033.860+29,2%
Diego Reis34.10033.130-2,8%
Carla Dias51.64022.490-56,4%CAIU MAIS DE 10%
Bruno Lima42.68015.080-64,7%CAIU MAIS DE 10%
Elisa Prado28.82012.040-58,2%CAIU MAIS DE 10%
Total183.440116.600-36,4%

Destaques

  • Carla Dias: caiu 56,4% (de R$ 51.640 para R$ 22.490); 14 vendas antes, 14 agora.
  • Bruno Lima: caiu 64,7% (de R$ 42.680 para R$ 15.080); 16 vendas antes, 9 agora.
  • Elisa Prado: caiu 58,2% (de R$ 28.820 para R$ 12.040); 15 vendas antes, 8 agora.
  • Total da loja: -36,4% (76 vendas antes, 62 agora).

Fonte: vendas-semana-2026-10-26.xlsx e vendas-semana-2026-11-02.xlsx. Soma da coluna Valor (R$).

Arquivos de exemplo

O que foi colocado na pasta
O que o Claude entregou
A ferramenta criada
  • Skill resumo-semanal (SKILL.md) 1 KB
    ler aqui
    ---
    name: resumo-semanal
    description: Gera o resumo semanal de vendas em uma página (soma por vendedor, comparação com a semana anterior, destaque de quem caiu mais de 10%). Use quando o usuário pedir "resumo semanal" ou "resumo das vendas da semana".
    ---
    
    # Resumo semanal de vendas
    
    1. Planilhas ficam na pasta `vendas/` (nome `vendas-semana-AAAA-MM-DD.xlsx`, aba com colunas Data, Vendedor, Cliente, Produto, Qtd, Valor (R$)). Se o usuário indicar outra pasta, use essa.
    2. Rode: `python3 -I .claude/skills/resumo-semanal/resumo.py vendas`
       - Usa as duas planilhas mais recentes: a última é "esta semana", a penúltima é a anterior.
       - Precisa do `openpyxl` (se faltar, avise o usuário em vez de instalar sem perguntar).
       - Grava `resumo-vendas-AAAA-MM-DD.md` na pasta atual.
    3. Entregue ao usuário no chat o conteúdo do resumo (tabela + destaques), curto, em português.
    4. Termine avisando o que foi assumido: quais duas planilhas foram usadas e que o valor é a soma da coluna "Valor (R$)", sem descontar devoluções. Se o total caiu muito, sugira conferir se a planilha da semana está completa.
    5. Não envie o resumo a ninguém nem apague planilhas; só leia.
    
    Formato fixo: título com datas, tabela (Vendedor | Semana anterior | Semana atual | Variação | alerta), linha de Total, seção "Destaques" com quem caiu mais de 10% (inclusive número de vendas antes/agora).
    

voltar ao índice

#exemplo-agents

2.3 Agent: o funcionário

O que foi pedido: usar agents para ler 8 contratos em paralelo e devolver só os que vencem nos próximos 90 dias; depois, conferir o total mensal com um agent separado.

Dados inventados para o teste.

O Claude abriu um agent para cada contrato, todos ao mesmo tempo, e juntou as respostas numa tabela:

Contratos que vencem nos próximos 90 dias

Hoje é 17/11/2026, então a janela vai até 15/02/2027. Estes são os contratos que vencem dentro dela:

ContratoVencimentoDias restantesValor/mês
01-limpeza (Brilho Total)30/11/202613R$ 3.200
04-seguranca (Guarda Forte)20/01/202764R$ 7.400
02-aluguel-sala (Imobiliária Horizonte)15/02/2027 (calculado)90R$ 5.800

O contrato 02 não traz a data de término escrita. Ele diz "30 meses a partir de 15/08/2024", e a data saiu da minha conta. Ela cai no limite da janela, então vale conferir no PDF.

Os outros cinco ficaram de fora:

  • 06-manutencao-ar: venceu em 31/10/2026, há 17 dias. Está fora da janela porque já passou, mas talvez precise de renovação.
  • 03-software: 12 meses desde 10/03/2026, o que dá 10/03/2027 (calculado). Fica fora, com 113 dias.
  • 08-transporte: 6 meses desde 05/09/2026, o que dá 05/03/2027 (calculado). Fica fora, com 108 dias. O agente errou a conta (escreveu 2032) e se corrigiu. Conferi o 05/03/2027.
  • 05-contabilidade: vigência até 31/12/2027.
  • 07-internet: prazo indeterminado, sem vencimento.

Com a frase do revisor no pedido (quanto pagamos por mês?), um segundo agent refez a soma do zero, sem ver a conta do primeiro:

Total mensal, conferido por um agent separado

Pagamos R$ 24.940,00 por mês hoje, somando os contratos que estão valendo. Os meus números e os do agent de conferência bateram nos dois totais.

#ContratoR$/mêsSituação em 17/11/2026
01Limpeza3.200vigente, vence 30/11/2026
02Sala 4025.800vigente até 14/02/2027
03Software890vigente até 09/03/2027
04Segurança7.400vigente até 20/01/2027
05Contabilidade2.100vigente até 31/12/2027
06Ar-condicionado650vencido em 31/10/2026
07Internet1.250prazo indeterminado
08Transporte4.300vigente até 04/03/2027
  • Só os vigentes: R$ 24.940,00 (7 contratos).
  • Todos os 8, contando o vencido: R$ 25.590,00.

Pontos de atenção

  • Limpeza (01): vence em 13 dias. Se não renovar, o total cai para R$ 21.740,00.
  • Ar-condicionado (06): o contrato venceu e deixei fora da soma. Se o serviço continua sendo cobrado, vale checar se há renovação fora do papel.
  • Segurança (04), contabilidade (05) e internet (07): os PDFs não trazem a data de início. Considerei os três vigentes porque nada indica início futuro. Isso é premissa minha, não dado do documento.
  • Valores: são os do contrato. Não entram reajuste nem impostos.

Arquivos de exemplo

O que foi colocado na pasta
A ferramenta criada
  • Agent revisor-numeros (.md) 2 KB
    ler aqui
    ---
    name: revisor-numeros
    description: Revisor que confere números do zero (somas, totais, percentuais, datas, valores em PDF/planilha/texto), sem confiar no total já escrito. Use quando for preciso validar contas, comparar o que o documento diz com a fonte, ou antes de entregar qualquer número a alguém.
    tools: Read, Grep, Glob, Bash
    model: sonnet
    ---
    
    Você é o revisor de números. Seu trabalho é refazer cada conta do zero a partir da fonte, sem confiar em nenhum total, subtotal ou percentual já escrito.
    
    ## Método
    1. Liste cada número a conferir e onde ele aparece (arquivo, página/linha).
    2. Vá à fonte primária (PDF, planilha, texto original). Extraia os valores brutos você mesmo (ex.: `pdftotext -layout`).
    3. Recalcule com ferramenta (`python3 -c` ou `bc`), nunca de cabeça. Em dinheiro, use Decimal ou centavos inteiros.
    4. Compare com o número declarado. Diferença de qualquer tamanho é achado; arredondamento é anotado como tal.
    5. Se a fonte não permite conferir, diga "não consegui conferir" e por quê. Nunca complete com suposição.
    
    ## Cuidados
    - Procure duplicidade (mesmo item contado duas vezes), item faltando, moeda/unidade misturada, vírgula x ponto decimal, mês/ano trocado.
    - Não use o número do resumo ou do briefing como se fosse fonte.
    - Você só lê e calcula: não edite os arquivos revisados.
    - Dado de cliente fica local: sem web, sem serviço externo.
    
    ## Resposta (curta, para celular)
    Tabela estreita: `item | fonte | declarado | recalculado | status`
    Status: OK, DIVERGE, NÃO CONFERI.
    Depois, em 1 a 3 linhas: o que diverge e a conta que prova. Separe MEDIDO (você calculou) de OPINIÃO.
    

voltar ao índice

#exemplo-regras

3.1 Regras que nunca falham

O que foi pedido: três regras automáticas: tocar um som ao terminar, nunca alterar a pasta Contratos Assinados e registrar tudo com data e hora.

Dados inventados para o teste. Os scripts foram feitos para Linux; no Windows, peça a versão em PowerShell, como diz o guia.

Os três pedidos viraram regras gravadas na pasta do projeto: som ao terminar ou quando precisa de você, trava na pasta Contratos Assinados e registro de tudo o que o Claude faz.

O que o Claude explicou sobre a trava da pasta

A regra está criada e testada. Ela vale só para sessões abertas nesta pasta.

O que ela faz

  • Bloqueia Write, Edit e NotebookEdit em qualquer caminho que tenha "Contratos Assinados" (também aceita Contratos_Assinados e Contratos-Assinados).
  • Bloqueia comandos Bash que citam essa pasta e fazem algo que pode alterar: rm, mv, cp, touch, mkdir, chmod, sed -i, git checkout, git restore, git clean, redirecionamento > e outros. Também bloqueia python, node, unzip e tar -x citando a pasta.
  • Ler continua liberado (ls, cat).
  • Há uma segunda camada, uma regra de permissão Edit(/Contratos Assinados/).

Limites

  • Bash é por palavra-chave, não é à prova de tudo. Se eu entrar na pasta com cd e depois rodar rm * sem citar o nome, o gancho não pega. O mesmo vale para um script que mexa lá por dentro. As ferramentas de arquivo (Write, Edit) são bloqueadas com segurança.
  • Proteção total fica no sistema de arquivos. Rode chmod -R a-w "Contratos Assinados", ou chattr +i nos arquivos. Isso vale para qualquer programa, não só para mim. Posso fazer se você disser o caminho da pasta e autorizar.
O registro com data e hora, gravado sozinho
2026-11-17 20:28:43 [OK] Bash: ls -la; echo; ls -A | wc -l
2026-11-17 20:29:01 [OK] Bash: find . -iname "*Contratos*" 2>&1 | head; ls -la
2026-11-17 20:29:02 [OK] Bash: ls -la "Contratos Assinados"; cat "Contratos Assinados"/*; cat .claude/hooks/proteger-contratos.sh

Arquivos de exemplo

A ferramenta criada
  • As regras (settings.json) 1 KB
    ler aqui
    {
      "hooks": {
        "Stop": [
          {
            "hooks": [
              {
                "type": "command",
                "command": "paplay /usr/share/sounds/freedesktop/stereo/complete.oga 2>/dev/null || true",
                "async": true
              }
            ]
          }
        ],
        "Notification": [
          {
            "hooks": [
              {
                "type": "command",
                "command": "paplay /usr/share/sounds/freedesktop/stereo/message.oga 2>/dev/null || true",
                "async": true
              }
            ]
          }
        ],
        "PreToolUse": [
          {
            "matcher": "Write|Edit|NotebookEdit|Bash",
            "hooks": [
              {
                "type": "command",
                "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/proteger-contratos.sh"
              }
            ]
          }
        ],
        "PostToolUse": [
          {
            "hooks": [
              {
                "type": "command",
                "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/registrar-atividade.sh"
              }
            ]
          }
        ],
        "PostToolUseFailure": [
          {
            "hooks": [
              {
                "type": "command",
                "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/registrar-atividade.sh"
              }
            ]
          }
        ]
      },
      "permissions": {
        "deny": [
          "Edit(**/Contratos Assinados/**)"
        ]
      }
    }
    
  • Script da trava (proteger-contratos.sh) 1 KB
    ler aqui
    #!/usr/bin/env bash
    # Bloqueia alteracoes dentro de qualquer pasta "Contratos Assinados".
    # Leitura continua liberada; escrita, edicao, mover, apagar etc. sao negadas.
    set -euo pipefail
    
    input=$(cat)
    tool=$(jq -r '.tool_name // ""' <<<"$input")
    
    # Nome da pasta, tolerando espaco escapado, underscore e hifen
    pasta='contratos[ _\\-]*assinados'
    
    negar() {
      jq -n --arg r "$1" '{hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"deny",permissionDecisionReason:$r}}'
      exit 0
    }
    
    case "$tool" in
      Write|Edit|NotebookEdit)
        caminho=$(jq -r '.tool_input.file_path // .tool_input.notebook_path // ""' <<<"$input")
        if grep -Eiq "$pasta" <<<"$caminho"; then
          negar "Pasta 'Contratos Assinados' protegida: alteracao bloqueada ($caminho)."
        fi
        ;;
      Bash)
        cmd=$(jq -r '.tool_input.command // ""' <<<"$input")
        if grep -Eiq "$pasta" <<<"$cmd" \
          && grep -Eiq '(^|[^a-z])(rm|rmdir|mv|cp|touch|mkdir|chmod|chown|ln|tee|truncate|dd|install|rsync|shred|unlink|sed +(-[a-z]*i)|perl +-[a-z]*i|git +(checkout|restore|rm|mv|clean|reset))([^a-z]|$)|>|python|node|ruby|unzip|tar +[a-z-]*x' <<<"$cmd"; then
          negar "Pasta 'Contratos Assinados' protegida: comando que pode alterar foi bloqueado."
        fi
        ;;
    esac
    exit 0
    
  • Script do registro (registrar-atividade.sh) 1 KB
    ler aqui
    #!/usr/bin/env bash
    # Registra cada acao do Claude (ferramenta + alvo) em .claude/registro-atividades.log
    set -euo pipefail
    
    log="${CLAUDE_PROJECT_DIR:-.}/.claude/registro-atividades.log"
    input=$(cat)
    
    evento=$(jq -r '.hook_event_name // "PostToolUse"' <<<"$input")
    resumo=$(jq -r '
      .tool_name as $t
      | (.tool_input // {}) as $i
      | ($i.command // $i.file_path // $i.notebook_path // $i.pattern // $i.url // $i.query // $i.description // $i.prompt // ($i | tostring))
      | gsub("[\r\n\t]+"; " ")
      | .[0:300]
      | "\($t): \(.)"
    ' <<<"$input")
    
    status="OK"
    [[ "$evento" == "PostToolUseFailure" ]] && status="FALHOU"
    
    printf '%s [%s] %s\n' "$(date '+%Y-%m-%d %H:%M:%S')" "$status" "$resumo" >> "$log"
    exit 0
    

voltar ao índice

Projetos simples

#projeto-1

Projeto 1. Mensagem para você no WhatsApp

O que foi pedido: transformar as anotações do dia nas três coisas mais importantes para amanhã e abrir o WhatsApp com a mensagem pronta.

Dados inventados para o teste.

O Claude escreveu a lista e montou o link do WhatsApp com a mensagem pronta. É só abrir e apertar enviar.

Lembretes de amanhã:
1. Reunião com o contador às 10h (declaração)
2. Pagar o boleto da luz: R$ 312,40, vence amanhã
3. Ligar para a Dona Conceição sobre o orçamento da cozinha

O número do teste (55 11 90000-0000) não existe; troque pelo seu.

Arquivos de exemplo

O que foi colocado na pasta
O que o Claude entregou
A ferramenta criada
  • Skill zap (SKILL.md) 1 KB
    ler aqui
    ---
    name: zap
    description: Escreve uma mensagem curta sobre o assunto pedido e abre o WhatsApp com ela pronta para o número do usuário. Use quando o usuário escrever "zap" seguido de um assunto.
    ---
    
    # zap
    
    Número do usuário: 5511900000000 (55 + DDD + número, só dígitos, sem +, espaço ou traço).
    
    1. Escreva a mensagem sobre o assunto que veio depois de "zap": curta (até 5 linhas), em português, pronta para ler no celular.
    2. Monte o link: `https://wa.me/5511900000000?text=` + o texto codificado para URL
       (espaço = %20, quebra de linha = %0A, acentos em UTF-8, ex.: ã = %C3%A3).
       Para codificar sem erro, use Python: `urllib.parse.quote(texto, safe="")`.
    3. Antes de abrir, decodifique o link e confira que o texto volta igual.
    4. Abra o link no navegador padrão:
       - Windows (PowerShell): `Start-Process "<link>"`
       - Windows (Git Bash): `start "" "<link>"`
       - Mac: `open "<link>"`
    5. Mostre ao usuário a mensagem e o link. NUNCA envie: o usuário aperta Enviar.
    

voltar ao índice

#projeto-2

Projeto 2. Raio X do extrato

O que foi pedido: classificar os lançamentos do extrato por categoria, separar as entradas, somar e listar os dez maiores gastos numa página.

Dados inventados para o teste.

Página do raio X do extrato com gastos por categoria
A página com os gastos de outubro. ver a imagem inteira
abrir o painel

Com o pedido de melhoria compare com o mês passado:

Comparação de gastos entre setembro e outubro
Setembro contra outubro. ver a imagem inteira
abrir a comparação

Arquivos de exemplo

O que foi colocado na pasta
O que o Claude entregou
A ferramenta criada
  • Skill raio-x (SKILL.md) 1 KB
    ler aqui
    ---
    name: raio-x
    description: Analisa o extrato bancário (CSV, Excel ou PDF) que estiver na pasta, classifica os gastos por categoria, lista os dez maiores e entrega uma página HTML. Use quando o usuário pedir "raio-x" ou para analisar um extrato.
    ---
    
    # raio-x
    
    1. Ache o extrato na pasta (CSV, XLSX ou PDF). Se houver mais de um mês, pergunte qual analisar.
    2. Leia todos os lançamentos. Valores no formato brasileiro (1.234,56). Confira que o número de lançamentos lidos bate com o arquivo.
    3. Separe entradas (valores positivos) de gastos. Entradas não entram nas categorias.
    4. Classifique cada gasto em: moradia, alimentação, transporte, assinaturas, lazer, outros.
       Categorias que o usuário já corrigiu (valem sempre):
       - "PIX ENVIADO MARIA S" -> moradia (diarista)
       - "COMPRA PARC ... MAGAZINE" -> outros
       O que não der para saber pelo nome: PERGUNTE antes de classificar. Não chute.
    5. Some por categoria e confira: soma das categorias = soma de todos os gastos.
    6. Página `raio-x-AAAA-MM.html`: cartões (gastos, entradas, saldo), tabela por categoria com %, os dez maiores gastos. Valores em R$ (R$ 1.234,56; negativo como -R$ 50,62).
    7. Diga ao usuário como abrir (duplo clique no arquivo) e o total conferido.
    

voltar ao índice

#projeto-3

Projeto 3. Planilha bagunçada vira painel

O que foi pedido: dizer o que há de estranho na planilha, arrumar uma cópia e montar um painel com quatro números e três gráficos.

Dados inventados para o teste.

Primeiro, o diagnóstico da planilha em cinco linhas:

1. Vendas de móveis de 01/08/2026 a 31/10/2026: data, vendedor, produto, qtd, valor e região (115 linhas com dados).
2. 9 linhas vazias no meio, título nas linhas 1-2 e uma linha 'TOTAL' no fim com fórmula =SUM(E4:E140) que inclui a própria célula (referência circular: o Excel mostra erro) e que, mesmo corrigida, ignoraria os valores gravados como texto — não use esse total.
3. Datas em 4 formatos: {'datetime': 46, 'dd/mm/aaaa': 23, 'dd/mm/aa': 23, 'dia mês ano': 23}.
4. 76 valores gravados como texto ('R$ 1.234,56' ou '1.234,56'), os outros são número; nomes de vendedor com maiúsculas, espaços e apelidos diferentes.
5. 5 linhas repetidas idênticas (mesma data, vendedor, produto e valor) — tratei como duplicata e tirei; se alguma for venda real repetida, me avise.
Painel de vendas com quatro números e três gráficos
O painel, que abre sem internet. ver a imagem inteira
abrir o painel

Arquivos de exemplo

O que foi colocado na pasta
O que o Claude entregou
A ferramenta criada
  • Skill painel (SKILL.md) 1 KB
    ler aqui
    ---
    name: painel
    description: Transforma uma planilha nova da pasta (vendas, gastos ou estoque) em um painel HTML de arquivo único com 4 números no topo e 3 gráficos. Use quando o usuário colocar uma planilha na pasta e pedir "painel".
    ---
    
    # painel
    
    1. Ache a planilha mais recente da pasta (.xlsx, .xls ou .csv). Se houver mais de uma nova, pergunte qual.
    2. NUNCA altere a original. Trabalhe numa cópia `<nome>-LIMPA.xlsx`.
    3. Diga em cinco linhas o que ela contém e o que está estranho. Tudo que você afirmar sobre a planilha tem que ter sido conferido (ex.: abra a linha de TOTAL e veja se a fórmula funciona; não suponha).
    4. Arrume: ache a linha de cabeçalho (pode não ser a 1ª), tire linhas vazias, títulos e linhas de TOTAL, converta datas de todos os formatos para data, converta "R$ 1.234,56" em número, padronize nomes (maiúsculas, espaços, apelidos). Linhas idênticas: tire e AVISE quantas tirou, perguntando se alguma era venda real repetida. Linha com só observação: avise antes de descartar.
    5. Confira: total do painel = total da cópia limpa, e diga os dois números.
    6. Painel em UM arquivo HTML, sem depender de internet (gráficos desenhados no próprio arquivo): 4 números no topo, 3 gráficos de barras, filtro por mês e uma frase sob cada gráfico dizendo o que ele mostra.
    7. Diga como abrir: duplo clique no arquivo `painel-<nome>.html`.
    

voltar ao índice

#projeto-4

Projeto 4. Foto de recibo vira planilha

O que foi pedido: ler seis fotos de recibos, montar uma planilha Excel com data, loja, valor e categoria, e marcar em amarelo o que estivesse ilegível.

Dados inventados para o teste.

Foto de recibo legível
Uma das fotos. ver a imagem inteira
Foto de recibo borrada
A foto borrada, de propósito. ver a imagem inteira
Planilha de recibos com a linha ilegível em amarelo
Aba Recibos: a ilegível ficou em amarelo. ver a imagem inteira
Aba de total por categoria
Aba Total por categoria. ver a imagem inteira

Arquivos de exemplo

O que foi colocado na pasta
O que o Claude entregou
A ferramenta criada
  • Agent contador-de-recibos (.md) 1 KB
    ler aqui
    ---
    name: contador-de-recibos
    description: Lê fotos de recibos e notas da pasta "fotos", extrai data, estabelecimento, valor total e categoria, e atualiza a planilha recibos.xlsx com a aba de total por categoria. Use quando o usuário disser que colocou fotos novas de recibo na pasta.
    tools: Read, Write, Edit, Bash, Glob
    ---
    
    Você é o contador de recibos do usuário.
    
    1. Liste as fotos (.jpg, .jpeg, .png, .heic) da pasta `fotos`. Compare com a coluna "Foto" de `recibos.xlsx` e processe só as que ainda não estão lá.
       Foto .heic (iPhone): converta para .jpg antes de ler; se não conseguir, avise.
    2. Olhe cada foto. Extraia: data (dd/mm/aaaa), estabelecimento, valor TOTAL (não o de um item), categoria
       (Alimentação, Transporte, Saúde, Material de escritório, Moradia, Lazer, Outros).
    3. Se qualquer um desses campos não estiver legível com certeza: deixe a célula vazia, pinte a linha de amarelo
       (FFFF00) e escreva na Observação o que faltou. NUNCA chute valor, nem tire a data do nome do arquivo.
    4. Aba "Total por categoria": fórmulas SOMASE sobre a aba Recibos, linha "Total lido" e a contagem de ilegíveis.
    5. Confira: soma da aba de totais = soma da coluna Valor. Abra o arquivo (ou converta para PDF) para ver se abre.
    6. Devolva: quantas fotos novas, o total lido, e a lista das ilegíveis para o usuário refotografar.
    

voltar ao índice

#projeto-5

Projeto 5. Site de uma página

O que foi pedido: um site de uma página para uma padaria, com chamada principal, produtos, depoimentos a preencher e botão de WhatsApp.

Dados inventados para o teste. Nesta versão o logo e as fotos ficam ao lado do arquivo, na mesma pasta.

Site da padaria no computador
No computador. ver a imagem inteira
Site da padaria no celular
No celular. ver a imagem inteira
abrir o site

Arquivos de exemplo

O que foi colocado na pasta
O que o Claude entregou
A ferramenta criada
  • Skill site (SKILL.md) 2 KB
    ler aqui
    ---
    name: site
    description: Cria uma página de campanha de uma página no padrão visual aprovado da Padaria Trigo Bom (marrom #8B4513, trigo #F5DEB3, cartões arredondados, botão verde de WhatsApp). Use quando o usuário pedir "site", "página de campanha" ou "landing" para um produto ou promoção.
    ---
    
    # Página de campanha no padrão aprovado
    
    Use `index.html` desta pasta como modelo de referência (é o site aprovado).
    
    ## Padrão visual (não mudar sem o usuário pedir)
    - Cores: marrom `#8B4513` (títulos, cabeçalho, rodapé), trigo `#F5DEB3` (fundo da chamada e dos destaques), creme `#FFF9F0` (fundo geral), verde `#25D366` só no botão de WhatsApp.
    - Fonte do sistema (system-ui). Títulos em marrom, cantos arredondados de 16px, sombra leve nos cartões.
    - Cabeçalho marrom fixo com `logo.png`. Rodapé marrom com contato.
    - Celular primeiro: abaixo de 760px tudo vira uma coluna, botões ocupam a largura toda, menu some.
    
    ## Passo a passo
    1. Pergunte só o que faltar: produto/promoção, público, prazo da oferta, chamada para ação.
    2. Seções: chamada principal (uma frase direta + botão de WhatsApp), o que é a oferta, por que agora, contato.
    3. Botão de WhatsApp: `https://wa.me/<numero>?text=<mensagem codificada>` com o número do site aprovado, salvo se o usuário der outro.
    4. Espaço que o usuário precisa preencher: marque `[PREENCHER: ...]` com fundo amarelo.
    5. Salve como `campanha-<assunto>.html` na mesma pasta do logo e das fotos (as imagens são arquivos separados: avise que a pasta inteira vai junto).
    6. Gere print de computador e de celular (largura 390px) e mostre antes de dizer que terminou.
    

voltar ao índice

#projeto-6

Projeto 6. Apresentação a partir de um PDF

O que foi pedido: transformar um relatório de 12 páginas em dez slides de PowerPoint para os sócios, com notas do apresentador e a página de origem de cada ponto.

Dados inventados para o teste.

Os dez slides da apresentação
Os dez slides. ver a imagem inteira

Com o pedido de melhoria transforme a tabela da página 12 em gráfico:

Slide com gráfico de colunas
O gráfico, editável no PowerPoint. ver a imagem inteira

Arquivos de exemplo

O que foi colocado na pasta
O que o Claude entregou
A ferramenta criada
  • Skill apresentacao (SKILL.md) 1 KB
    ler aqui
    ---
    name: apresentacao
    description: Transforma um documento (PDF ou Word) desta pasta em apresentação PowerPoint de 10 slides na estrutura aprovada, com notas do apresentador e página de origem de cada ponto. Use quando o usuário pedir "apresentacao", "slides" ou "PowerPoint" a partir de um documento.
    ---
    
    # Apresentação a partir de documento
    
    ## Estrutura aprovada (10 slides)
    1. Abertura: logo, título do documento, público e ocasião.
    2. Mensagem principal: os 3 números que resumem tudo.
    3 a 9. Sete slides de pontos: no máximo 4 linhas, cada linha com número quando houver e "(p. N)" no fim.
    10. Próximos passos: o que se pede ao público.
    Gráfico (se o usuário pedir): slide extra antes dos próximos passos, montado a partir da tabela lida do documento.
    
    ## Regras
    - Ler o documento inteiro antes; anotar para cada número a página em que ele aparece. Número sem página encontrada não entra.
    - Antes de entregar, conferir cada "(p. N)" buscando o número no texto daquela página. Divergência: corrigir ou avisar.
    - Notas do apresentador em todo slide: 2 a 4 frases faladas, em linguagem simples, terminando com "(Documento, p. N)".
    - Visual: barra de título na cor principal da empresa, fundo claro, texto grande (26 pt ou mais).
    - Entregar o .pptx e um PDF de visualização; mostrar um mosaico dos slides antes de dizer que terminou.
    - Ferramenta: python-pptx (precisa de Python). Se não houver Python no computador, dizer o que instalar e pedir permissão.
    

voltar ao índice

#projeto-7

Projeto 7. PDF com a cara da sua empresa

O que foi pedido: extrair cores, fontes e estilo de um documento antigo da empresa e usar esse padrão para transformar um texto em PDF.

Dados inventados para o teste.

Orçamento e comunicado com o mesmo padrão visual
Dois documentos diferentes, com a mesma cara: o orçamento e, depois, um comunicado feito pela skill. ver a imagem inteira

Arquivos de exemplo

O que foi colocado na pasta
O que o Claude entregou
A ferramenta criada
  • Skill documento-da-empresa (SKILL.md) 2 KB
    ler aqui
    ---
    name: documento-da-empresa
    description: Gera qualquer documento da Padaria Trigo Bom (proposta, orçamento, relatório, comunicado) em PDF com o padrão visual aprovado - logo, marrom #8B4513 e trigo #F5DEB3, títulos em serif, rodapé com contato e "Página N de T". Use sempre que o usuário pedir um documento, PDF, proposta, orçamento, relatório ou comunicado da empresa.
    ---
    
    # Documento com a cara da Padaria Trigo Bom
    
    O padrão aprovado está em `padrao-visual.md` (nesta pasta da skill). Não mude cor, fonte, cabeçalho ou rodapé sem o usuário pedir.
    
    ## Passo a passo
    1. Pegue o texto que o usuário mandou e reescreva só a marcação, sem mudar o conteúdo:
       `# Título`, `Sub: linha de cliente/data` logo abaixo, `## Seção`, `- item`, `> destaque`, tabelas com `| a | b |` (uma linha `|---|` depois do cabeçalho; linha que começa com "Total" sai em negrito).
    2. Se houver valores em tabela, refaça as contas. Divergência com o texto do usuário: avise antes de gerar, não corrija calado.
    3. Salve o texto em `<tipo>-<assunto>.txt` na pasta de trabalho e rode:
       `python "<pasta desta skill>/gera_documento.py" <tipo>-<assunto>.txt <tipo>-<assunto>.pdf`
    4. Converta a 1ª página em imagem (pdftoppm) e olhe antes de entregar: cabeçalho com logo, título marrom, rodapé com "Página N de T", nada cortado.
    5. Entregue o caminho do PDF e diga quantas páginas tem.
    
    ## Requisitos
    - Python com a biblioteca `reportlab` (se faltar: diga o que é e peça permissão para instalar).
    - Fontes DejaVu (Serif Bold, Sans, Sans Bold). No Windows elas não vêm instaladas: coloque os 3 arquivos .ttf numa pasta `fontes/` ao lado do `gera_documento.py`.
    
  • Padrão visual guardado pela skill (padrao-visual.md) 1 KB
    ler aqui
    # Padrão visual da Padaria Trigo Bom (extraído de logo.png e referencia-proposta-2024.pdf)
    
    | Elemento | Valor |
    |---|---|
    | Cor principal | #8B4513 (marrom) - cabeçalho, títulos, linhas, rodapé |
    | Cor secundária | #F5DEB3 (trigo) - cabeçalho de tabela, caixa de destaque, nome no cabeçalho |
    | Fundo de linha alternada | #FFF9F0 (creme) |
    | Fonte de títulos | DejaVu Serif Bold (achada embutida no PDF de referência) |
    | Fonte do corpo | DejaVu Sans 10,5 pt, entrelinha 15 pt |
    | Página | A4, margens 2 cm laterais, 3,4 cm topo, 2,5 cm base |
    | Cabeçalho | faixa marrom de 2,6 cm, logo 2x2 cm à esquerda, "Padaria Trigo Bom" à direita em trigo |
    | Rodapé | linha marrom; endereço, WhatsApp e e-mail à esquerda; "Página N de T" à direita |
    | Título | serif 18 pt marrom (ajuste do usuário: 22 pt da referência ficou grande); subtítulo de seção serif 14 pt marrom |
    | Tabela | cabeçalho trigo com texto marrom em negrito, linhas finas marrons, valores à direita, última linha (total) em negrito, colunas de número alinhadas à direita, 1ª coluna com 40% da largura |
    | Destaque | caixa trigo com barra marrom de 4 pt à esquerda |
    
    Formato do texto de entrada (o gerador entende):
    `# Título` · `## Seção` · `- item` · `> destaque` · linhas `| a | b |` viram tabela · `Sub: ...` na 2ª linha vira subtítulo · resto é parágrafo.
    

voltar ao índice

#projeto-8

Projeto 8. Vídeo de marketing

O que foi pedido: um vídeo vertical de 15 segundos anunciando o pão de fermentação natural, com animação feita em código nas cores do logo.

Dados inventados para o teste.

Antes de gerar, o Claude mostrou o roteiro cena a cena:

O roteiro

Roteiro cena a cena (mostrado ao usuário ANTES de gerar; ok simulado)

Formato: 1080x1920, 30 quadros/s, 15 s, sem som. Cores do logo: marrom #8B4513 e trigo #F5DEB3.

CenaTempoNa telaMovimento
1 Gancho0,0-3,0 s"NOVIDADE NA TRIGO BOM"círculo trigo cresce do centro; texto sobe e aparece
2 Produto3,0-6,5 s"Pão de fermentação natural"faixa marrom entra pela esquerda; texto entra linha a linha
3 Oferta6,5-10,0 s"Leve 2" / "pague R$ 25"selo circular gira e cresce; preço pulsa uma vez
4 Urgência10,0-12,5 s"Só nesta semana" / "Vila Esperança"texto desliza da direita; três espigas (formas do logo) sobem
5 Fecho12,5-15,0 slogo + "Peça pelo WhatsApp" + "(11) 99999-0000"logo cresce com leve quique; chamada aparece embaixo

Ferramentas: Python + Pillow para desenhar cada quadro e ffmpeg para juntar em MP4 (H.264). Nada a instalar NESTE computador (já existem). No Windows do cliente seria preciso pedir permissão para instalar Python, Pillow e ffmpeg.

O vídeo, 15 segundos, 1080 x 1920, sem som.

Com o pedido de melhoria faça três variações de chamada (a primeira é a do vídeo acima):

Variação 2: Reserve o seu hoje.
Variação 3: Passe aqui às 16h.

Arquivos de exemplo

O que foi colocado na pasta
O que o Claude entregou
A ferramenta criada
  • Ferramenta video-de-marketing (.md) 2 KB
    ler aqui
    ---
    name: video-de-marketing
    description: Cria vídeo vertical de marketing (1080x1920, 15 s, Instagram/TikTok/status) da Padaria Trigo Bom com animação em código nas cores do logo. Use quando o usuário pedir um vídeo de divulgação passando produto e público. Mostra o roteiro e espera o ok antes de gerar.
    tools: Read, Write, Edit, Bash, Glob
    ---
    
    Você cria vídeos curtos de marketing por animação em código. Sem pessoas, sem imagem gerada por IA.
    
    ## Entrada
    Produto ou promoção, e público. Se faltar a chamada final, use "Peça pelo WhatsApp" + telefone do vídeo anterior.
    
    ## Passo 1: roteiro (sempre antes de gerar)
    Escreva `roteiro-<assunto>.md` com 5 cenas no padrão de `roteiro.md` desta pasta (gancho 0-3 s, produto 3-6,5 s, oferta 6,5-10 s, urgência 10-12,5 s, fecho com logo 12,5-15 s), textos de no máximo 4 palavras por linha.
    Devolva o roteiro como sua resposta final e PARE. Quem chamou você mostra ao usuário e só volta a chamar com o ok dele.
    (Um agent não conversa com o usuário no meio do trabalho: o "espera meu ok" acontece entre duas chamadas.)
    
    ## Passo 2: gerar (só com o ok)
    1. Grave `config-<assunto>.json` com as chaves `gancho`, `produto` (lista), `oferta` (lista de 2), `urgencia` (lista de 2), `cta` (lista de 2).
    2. Rode `python gera_video.py video-<assunto>.mp4 config-<assunto>.json` nesta pasta.
    3. Confira com ffprobe: 1080x1920, 15 s, H.264. Tamanho acima de 5 MB: avise.
    4. Extraia 3 quadros (2 s, 8,5 s, 14,5 s) para uma pasta temporária, olhe se algum texto saiu cortado, e APAGUE os quadros.
    5. Responda com o caminho do MP4, duração, resolução, tamanho e o que viu nos quadros.
    
    ## Requisitos
    Python com Pillow e ffmpeg. Se algum faltar, NÃO instale: diga o que é, para que serve e peça permissão.
    

voltar ao índice

Projetos intermediários

#projeto-9

Projeto 9. Painel financeiro pessoal

O que foi pedido: com seis meses de extratos, um painel com receitas e despesas por mês, gastos por categoria, evolução do saldo e os meses de maior gasto.

Dados inventados para o teste. O extrato de novembro, parcial, testou a skill de atualização.

Painel financeiro com receitas, despesas e saldo por mês
O painel, já com os pedidos de melhoria. ver a imagem inteira
abrir o painel

Arquivos de exemplo

O que foi colocado na pasta
O que o Claude entregou
A ferramenta criada
  • Skill atualizar-painel (SKILL.md) 3 KB
    ler aqui
    ---
    name: atualizar-painel
    description: Atualiza o painel financeiro (painel.html) quando o usuário coloca um extrato novo na pasta. Use quando ele disser que colocou/baixou um extrato novo, pedir para atualizar o painel, ou mencionar um mês que ainda não aparece no painel.
    ---
    
    # Atualizar o painel financeiro
    
    O painel (`painel.html`) é gerado pelo script `gerar_painel.py` a partir de
    TODOS os arquivos `extrato-*.csv` desta pasta. O visual fica em
    `modelo_painel.html`. Não edite `painel.html` à mão: ele é sobrescrito.
    
    ## Passos
    
    1. **Ache o extrato novo.** Liste os `extrato-*.csv` da pasta. O nome tem que
       seguir o padrão `extrato-<mes>-<ano>.csv` (ex.: `extrato-nov-2026.csv`).
       Se o usuário salvou com outro nome (ex.: `Extrato (3).csv`), pergunte de
       que mês é e renomeie para o padrão.
    
    2. **Confira o formato** abrindo as primeiras linhas do arquivo novo. Tem que
       ser igual aos outros: separador `;`, colunas
       `Data;Lançamento;Detalhes;Valor;Saldo`, datas `dd/mm/aaaa`, valores no
       formato `1.234,56`, uma linha `Saldo Anterior` no começo e uma
       `S A L D O` no fim (mês fechado). Se faltar a linha `S A L D O` (extrato
       parcial, mês em andamento), acrescente ao final uma linha
       `<data do último lançamento>;S A L D O;;;<saldo do último lançamento>`
       e avise o usuário que o mês ainda está aberto. Se o formato for outro
       (outro banco, Excel, PDF), PARE e explique ao usuário; não adivinhe.
    
    3. **Faça uma cópia de segurança** do painel atual:
       `cp painel.html painel-anterior.html`.
    
    4. **Gere o painel:** `python3 gerar_painel.py` na pasta.
       - `OK: N lançamentos de M meses (...)` = deu certo. Confira se o mês novo
         aparece no intervalo.
       - `ERRO ... saldo não bate` = o arquivo veio cortado ou com linha
         duplicada. Não force; mostre a linha ao usuário.
       - `AVISO: saldo final de X difere do inicial de Y` = falta um mês no meio
         ou o extrato novo não continua do anterior. Conte ao usuário.
       - `AVISO: sem categoria` = estabelecimento novo. Pergunte ao usuário a
         categoria, acrescente a palavra-chave na lista `CATEGORIAS` do
         `gerar_painel.py` e rode de novo. Até lá, ele aparece como "Outros".
    
    5. **Confira o resultado** procurando o mês novo no arquivo gerado, por
       exemplo `grep -o '"mes": "2026-11"' painel.html`. Se houver Chrome,
       tire um print:
       `google-chrome --headless=new --screenshot=prints/painel-atual.png --window-size=1280,2400 file://$PWD/painel.html`
       e olhe a imagem.
    
    6. **Diga ao usuário**, em linguagem simples: qual mês entrou, receitas,
       despesas e saldo final desse mês, se alguma categoria ficou em vermelho
       (cresceu mais de 20% contra o mês anterior), e que basta abrir de novo o
       `painel.html` (ou apertar F5 se já estiver aberto).
    
    ## Regras
    
    - Nunca apague nem altere os extratos originais, exceto renomear (passo 1) ou
      acrescentar a linha `S A L D O` em extrato parcial (passo 2).
    - Não envie os extratos para nenhum serviço da internet.
    - Se o extrato novo for de um mês que já existe, pergunte se é para
      substituir o antigo antes de fazer qualquer coisa.
    

voltar ao índice

#projeto-10

Projeto 10. Contas a pagar e a receber

O que foi pedido: um calendário de vencimentos do mês, separando o que é a pagar do que é a receber, com saldo previsto dia a dia e destaque para os próximos sete dias.

Dados inventados para o teste.

Calendário de vencimentos de novembro
O calendário com o saldo previsto dia a dia. ver a imagem inteira
abrir o calendário

Arquivos de exemplo

O que foi colocado na pasta
O que o Claude entregou

voltar ao índice

#projeto-11

Projeto 11. Revisor de contratos (jurídico)

O que foi pedido: ler um contrato de prestação de serviços do lado de quem presta o serviço e entregar resumo, tabela de prazos e valores, cláusulas desfavoráveis, o que falta e perguntas para o advogado.

Dados inventados para o teste. O parecer não substitui o advogado.

Primeira página do parecer do contrato
O começo do parecer. ver a imagem inteira
abrir o parecer inteiro

Um agent separado conferiu cada cláusula citada no parecer contra o contrato:

A conferência do agent separado

Conferência do parecer contra o contrato

Conferido: parecer.md contra contrato-prestacao-servicos.docx (texto extraído com python-docx, parágrafo por parágrafo; o contrato não tem tabelas). Data: 17/11/2026. Conferidor: agent separado, sem web, sem fonte de lei.

Legenda: CORRETO = existe e diz o que o parecer afirma. IMPRECISO = existe, mas o parecer simplifica de um jeito que pode enganar. ERRADO = não existe ou diz outra coisa.

Placar

Qtde
Citações/afirmações conferidas66
Corretas63
Imprecisas3
Erradas0
Artigos de leinão conferidos (ver seção 7)

Imprecisas: (a) exemplo da multa "sair ao fim do 6º mês"; (b) "saindo logo no início, a multa chega a R$ 57.600"; (c) "não há consequência se o cliente atrasar a aprovação" (cl. 5.2 com 6.1). Detalhes abaixo.

1. Seção 1 do parecer (resumo) — 12 citações

Cl.Existe?O que o contrato diz (trecho)Veredito
1.1Sim"até 20 (vinte) peças gráficas por mês para Instagram e Facebook; (b) redação das legendas; (c) agendamento; (d) resposta ... em dias úteis, das 9h às 18h; (e) relatório mensal"CORRETO
2.1Sim"24 (vinte e quatro) meses, contados de 1º de dezembro de 2026, encerrando-se em 30 de novembro de 2028"CORRETO
1.2Sim"produção de vídeos, fotografia, gestão de anúncios pagos e criação de identidade visual, não estão incluídos"CORRETO
3.1Sim"valor fixo mensal de R$ 4.800,00 ... durante toda a vigência"CORRETO
3.2Sim"inclui todos os tributos e encargos"CORRETO
3.3Sim"solicitadas por escrito ... valor unitário de R$ 180,00"CORRETO
4.2 a 4.4Sim4.2 "a critério exclusivo da CONTRATANTE, sem prazo determinado"; 4.3 "em até 60 (sessenta) dias contados da aprovação"; 4.4 "não ensejará ... multa, juros de mora ou correção monetária, em nenhuma hipótese"CORRETO
10.1Sim"a qualquer tempo, sem necessidade de aviso prévio e sem qualquer ônus, multa ou indenização, bastando comunicação por escrito"CORRETO
10.2Sim"aviso prévio por escrito de 90 (noventa) dias ... multa compensatória equivalente a 50% ... das mensalidades restantes até o término do prazo previsto no item 2.1"CORRETO
12.2Sim"poderá prestar serviços a outras empresas, inclusive do mesmo ramo, desde que respeitada a Cláusula 8"CORRETO (o parecer omite a condição "respeitada a Cláusula 8", irrelevante para o ponto)
7.2Sim"poderá exibir as peças publicadas em seu portfólio profissional, após a sua publicação pela CONTRATANTE"CORRETO
11.2Sim"não se responsabiliza por resultados comerciais, número de seguidores, alcance ou vendas"CORRETO

Menções sem número (sigilo = cl. 8, dados = cl. 9, direitos = cl. 7, vínculo = cl. 12, foro = cl. 15): todas existem.

2. Seção 2 do parecer (tabela de prazos e valores) — 18 linhas

Item / Cl.O que o contrato diz (trecho)Veredito
Vigência / 2.101/12/2026 a 30/11/2028, 24 mesesCORRETO
Renovação / 2.2"poderá ser renovado mediante termo aditivo assinado por ambas as partes"CORRETO
Mensalidade / 3.1, 3.2R$ 4.800,00 fixos, tributos incluídosCORRETO
Arte excedente / 3.3R$ 180,00, "solicitadas por escrito"CORRETO
Reajuste / 3.1"durante toda a vigência"; não há cláusula de reajuste em nenhum lugar do contratoCORRETO
NF e relatório / 4.1"até o 5º (quinto) dia útil de cada mês ... a nota fiscal referente ao mês anterior"CORRETO (mesmo sentido)
Aprovação do mês / 4.2"a critério exclusivo ... sem prazo determinado"CORRETO
Pagamento / 4.3"até 60 (sessenta) dias contados da aprovação"CORRETO
Atraso / 4.4sem multa, juros ou correção, "em nenhuma hipótese"CORRETO
Envio das artes / 5.2"antecedência mínima de 3 (três) dias úteis"CORRETO (o parecer omite "mínima")
Material do cliente / 6.1"até o dia 20 de cada mês ... calendário do mês seguinte"CORRETO
Aprovação de cada arte / 6.3"2 (dois) dias úteis ... sob pena de as peças serem consideradas aprovadas"CORRETO
Sigilo / 8.1"durante a sua vigência e por 2 (dois) anos após o seu término"CORRETO
Saída do cliente / 10.1ver acimaCORRETO
Saída sua / 10.2ver acimaCORRETO
Teto / 11.1"Cada parte ... limitada a indenização ao valor equivalente a 12 (doze) mensalidades"CORRETO
Mudança de e-mail / 13.2"antecedência mínima de 5 (cinco) dias"CORRETO
Foro / 15.1"Comarca de Curitiba, Estado do Paraná"CORRETO

3. Contas — 4 conferidas

Conta do parecerRefeitaVeredito
24 x R$ 4.800 = R$ 115.200,00115.200CORRETO
Teto 12 x R$ 4.800 = R$ 57.600,0057.600CORRETO
"Sair ao fim do 6º mês: 50% de 18 x R$ 4.800 = R$ 43.200,00"A conta 0,5 x 18 x 4.800 = 43.200 está certa. MAS a 10.2 não diz a partir de quando se contam as "mensalidades restantes": do aviso ou da saída efetiva. Com 90 dias de aviso, quem avisa no fim do 6º mês sai no fim do 9º; se contar da saída, restam 15 meses e a multa é R$ 36.000,00.IMPRECISO
"Saindo logo no início, a multa chega a R$ 57.600,00"0,5 x 24 x 4.800 = 57.600 só se a contagem for da data do aviso. Como o aviso é de 90 dias, ninguém "sai" antes do 3º mês; contando da saída efetiva, o máximo é 0,5 x 21 x 4.800 = R$ 50.400,00.IMPRECISO

Observação: a frase da seção 3 "a multa pode passar de R$ 50 mil" vale nas duas leituras (57.600 ou 50.400).

4. Seção 3 do parecer (cláusulas que desfavorecem) — 10 linhas

Cl.ConferênciaVeredito
4.2 (+ 6.3)Trechos literais batem. A contradição com a 6.3 existe: arte aprovada por silêncio "para publicação", mês sem prazo de aprovação.CORRETO
4.360 dias após aprovação; NF até o 5º dia útil do mês seguinte (4.1). "3 meses ou mais" contando do início do mês trabalhado é coerente.CORRETO
4.4Bate.CORRETO
3.1 (+ 14.3)Sem reajuste; 14.3: "alteração ... somente terá validade se formalizada por termo aditivo assinado pelas partes".CORRETO
3.2Bate.CORRETO
10.1Bate.CORRETO
10.2Bate. Não há exceção para inadimplência do cliente: a única rescisão "de pleno direito" (10.3) é para falência, recuperação judicial ou encerramento de atividades.CORRETO
7.1 e 7.37.1 "cedidos ... de forma definitiva, para uso em quaisquer meios de comunicação" (só peças "efetivamente pagas"); 7.3 arquivos-fonte "ao término do contrato, desde que não haja valores em aberto". Não há preço extra pela cessão.CORRETO
11.1Bate (vale para as duas partes).CORRETO
5.2 com 6.1 (+ 5.1)Os prazos batem (3 dias úteis; dia 20). Mas "não há consequência se o cliente atrasar ... a aprovação" não é exato: a 6.3 dá consequência ao silêncio do cliente na aprovação de cada arte (fica aprovada em 2 dias úteis). Para atraso do MATERIAL (6.1) a afirmação é verdadeira: não há consequência.IMPRECISO

5. Seção 4 do parecer ("está faltando") — 14 itens

Procurei cada um no contrato inteiro.

#Item dito ausenteRealmente falta?Veredito
1Reajuste anualFalta.CORRETO
2Prazo para aprovar o mês, com aprovação automáticaFalta (4.2 diz o oposto: "sem prazo").CORRETO
3Prazo de pagamento curto e fixoFalta (4.3: até 60 dias após aprovação sem prazo).CORRETO
4Multa, juros e correção por atrasoFalta; e mais: a 4.4 exclui expressamente.CORRETO
5Direito de suspender o serviçoFalta.CORRETO
6Saída simétricaFalta (10.1 x 10.2).CORRETO
7Rescisão por culpa do cliente sem multaFalta (10.3 só cobre falência/recuperação/encerramento).CORRETO
8Pagamento proporcional na rescisãoFalta.CORRETO
9Prorrogação dos prazos por atraso do cliente (6.1)A prorrogação falta. Nota: para a aprovação de arte, a 6.3 já dá solução parcial (aprovação tácita).CORRETO
10Limite de rodadas de alteração (cita 5.4)Falta; 5.4 de fato só trata de "erro de digitação, de informação ou de marca imputável à CONTRATADA".CORRETO
11Cliente te defender/reembolsar por conteúdo dele (cita 6.4)Falta; 6.4 só diz "Responsabilizar-se pela veracidade das informações, preços e condições comerciais". Nota que o parecer não fez: a 7.4 diz que a CONTRATADA declara que imagens e fontes "são de sua autoria ou devidamente licenciados", o que piora o risco de "imagem sem licença enviada por ele".CORRETO
12Devolução dos acessos ao fimFalta (9.3 fala de eliminar dados pessoais, não de senhas/acessos).CORRETO
13Força maiorFalta cláusula geral. Nota: a 11.3 cobre em parte (indisponibilidade/bloqueio das plataformas).CORRETO
14Papel na LGPD (operadora/controlador; cita cl. 9)Falta; a cl. 9 não usa esses termos.CORRETO

6. Seção 5 do parecer (perguntas ao advogado) — 8 referências a cláusula

PerguntaCl. citadaExiste e o parecer descreve certo?Veredito
14.2SimCORRETO
24.4SimCORRETO
310.2SimCORRETO
410.1 e 10.2SimCORRETO
67.1Sim ("definitiva", "quaisquer meios")CORRETO
711.1SimCORRETO
95.3Sim: "não as compartilhar com terceiros". Nota: a 12.1 menciona "eventuais colaboradores" da CONTRATADA, útil para a pergunta.CORRETO
1014.3SimCORRETO

(Perguntas 5 e 8 não citam número de cláusula.)

7. Afirmações sobre LEI e sobre mercado — NÃO conferidas

Não tenho fonte de lei aqui; nada disto foi verificado:

  • Código Civil, arts. 412 e 413 (redução de multa excessiva) — o próprio parecer marca "a confirmar".
  • Conceitos da LGPD "operadora" e "controlador" e "regras de LGPD como operadora". (O contrato cita a Lei nº 13.709/2018 na 9.1; o parecer não cita número de lei.)
  • "Assinatura eletrônica nos termos da legislação" (14.4) — o parecer não comenta.
  • Afirmações de mercado, também sem fonte: reajuste por IPCA/IGP-M "comum em contrato acima de 12 meses"; "30 dias é o usual nesse serviço"; exemplos de multa de 2%, juros de 1% ao mês; "segue o padrão de mercado".
  • Pergunta 1 e 2 ("pode ser considerada abusiva", "consegue afastar juros") são perguntas, não afirmações — corretamente deixadas ao advogado.

8. Fora do escopo

Na pasta há também redacao-alternativa-multa.md. Não foi conferido (o pedido foi conferir o parecer).

Com o pedido de melhoria sugira uma redação alternativa para a cláusula de multa:

A redação alternativa

Redação alternativa: cláusula de multa

Contrato: contrato-prestacao-servicos.docx. Texto sugerido como ponto de partida para negociar. Leve ao advogado antes de mandar ao cliente.

Qual cláusula é "a de multa"

O contrato só tem uma multa: a da cl. 10.2, que você paga se sair (90 dias de aviso + 50% das mensalidades restantes). A cl. 4.4 faz o contrário: proíbe qualquer multa para o cliente quando ele atrasa o pagamento. Entendi o pedido como a cl. 10.2, que é a principal. Como as duas andam juntas, deixei também uma versão da 4.4 (opção B), caso queira mexer nas duas.

Opção A: trocar a cl. 10.1 e a cl. 10.2

A 10.2 só fica justa se a 10.1 mudar junto. Por isso a proposta substitui as duas.

Texto atual

10.1. A CONTRATANTE poderá rescindir o presente contrato a qualquer tempo, sem necessidade de aviso prévio e sem qualquer ônus, multa ou indenização, bastando comunicação por escrito.

10.2. A CONTRATADA somente poderá rescindir o presente contrato mediante aviso prévio por escrito de 90 (noventa) dias, ficando obrigada, ainda, ao pagamento de multa compensatória equivalente a 50% (cinquenta por cento) do valor total das mensalidades restantes até o término do prazo previsto no item 2.1.

Texto sugerido

10.1. Qualquer das partes poderá rescindir o presente contrato, sem justo motivo, mediante aviso prévio por escrito de 30 (trinta) dias, durante os quais os serviços continuarão a ser prestados e remunerados normalmente.

10.2. A parte que rescindir sem justo motivo e sem cumprir o aviso prévio do item 10.1 pagará à outra multa compensatória equivalente a 1 (uma) mensalidade vigente, proporcional aos dias de aviso não cumpridos.

10.2.1. Não haverá multa quando a rescisão decorrer de descumprimento da outra parte, inclusive atraso de pagamento superior a 30 (trinta) dias ou falta de fornecimento das informações previstas no item 6.1 por 2 (dois) meses consecutivos, desde que a parte inocente tenha notificado a outra por escrito e o descumprimento não tenha sido sanado em 10 (dez) dias.

10.2.2. Em qualquer hipótese de rescisão, a CONTRATANTE pagará à CONTRATADA os serviços prestados até a data do encerramento, de forma proporcional, no prazo de 10 (dez) dias.

O que muda para você

HojeCom a sugestão
Cliente sai sem aviso; você, com 90 dias30 dias de aviso para os dois
Sua multa: até R$ 57.600,00Máximo de 1 mensalidade (R$ 4.800,00), e só se não cumprir o aviso; vale para os dois
Multa mesmo se o cliente não pagarSem multa se você sair por culpa dele
Sem regra para o mês em cursoRecebe o proporcional em 10 dias

Opção B (complemento): trocar a cl. 4.4

Texto atual

4.4. Eventual atraso no pagamento não ensejará a incidência de multa, juros de mora ou correção monetária, em nenhuma hipótese.

Texto sugerido

4.4. O atraso no pagamento sujeitará a CONTRATANTE à multa de 2% (dois por cento) sobre o valor devido, acrescida de juros de mora de 1% (um por cento) ao mês, calculados pro rata die, e de correção monetária pelo IPCA/IBGE, desde o vencimento até o efetivo pagamento.

4.5. Havendo atraso superior a 15 (quinze) dias, a CONTRATADA poderá suspender a prestação dos serviços, mediante aviso por escrito, até a regularização, sem que a suspensão caracterize descumprimento contratual.

Observações

  • Os números (30 dias, 1 mensalidade, 2%, 1% ao mês, IPCA) são os mais comuns no mercado, não obrigatórios. São pontos de negociação.
  • A opção A não resolve o pagamento condicionado à aprovação "a critério exclusivo" (cl. 4.2) nem o prazo de 60 dias (cl. 4.3). Sem mexer nelas, o cliente ainda pode segurar o pagamento sem estar "atrasado". Recomendo negociar as três juntas.
  • Qualquer mudança só vale por termo aditivo assinado (cl. 14.3), ou, melhor, já na versão que for assinada.

Arquivos de exemplo

O que foi colocado na pasta
O que o Claude entregou

voltar ao índice

#projeto-12

Projeto 12. Comparador de investimentos

O que foi pedido: comparar R$ 10.000 por 2 anos em poupança, Tesouro Selic, CDB a 110% do CDI e fundo DI com taxa de 1%, já com imposto, com as taxas do dia e a fonte de cada uma.

Dados inventados para o teste. As taxas são as públicas de 17/11/2026. É simulação, não recomendação de investimento.

Comparador com tabela e gráfico das aplicações
A comparação de R$ 10.000 por 2 anos. ver a imagem inteira
abrir o comparador

O gráfico desta página precisa de internet para aparecer.

De onde saiu cada taxa e cada conta

Memória de cálculo: R$ 10.000 por 2 anos

Feito em 17/11/2026. Os números saem do script calcula.py (nesta pasta), que grava resultados.json e dados.js; o comparador.html lê o dados.js. Para refazer com taxas novas, troque as constantes no topo do calcula.py e rode:

python calcula.py

1. Datas e prazos

ItemValor
Aplicação17/11/2026
Resgate em 2 anos17/11/2028 = 731 dias corridos (2028 é bissexto), 501 dias úteis
Saque na metade17/11/2027 = 365 dias corridos, 249 dias úteis
Dias úteissegunda a sexta, sem feriados nacionais (lista no calcula.py); cada dia útil em (início, fim] rende um dia

2. Taxas usadas e fontes

DadoValorData do dadoFonte
Selic meta13,75% a.a.Copom de 04/11/2026 (série consultada em 17/11/2026)https://api.bcb.gov.br/dados/serie/bcdata.sgs.432/dados/ultimos/5?formato=json
Selic over13,65% a.a.17/11/2026https://api.bcb.gov.br/dados/serie/bcdata.sgs.1178/dados/ultimos/5?formato=json
CDI13,65% a.a.16/11/2026https://api.bcb.gov.br/dados/serie/bcdata.sgs.4389/dados/ultimos/5?formato=json
Poupança0,6501% a.m. (média de 28 valores, de 0,5964% a 0,6707%)aniversários de 17/10 a 16/11/2026https://api.bcb.gov.br/dados/serie/bcdata.sgs.195/dados?formato=json&dataInicial=17/10/2026&dataFinal=17/11/2026
Tesouro Selic 2031Selic + 0,1072% a.a.10/11/2026 (taxa do Tesouro Nacional, publicada pela InvestNews)https://investnews.com.br/investimentos/tesouro-direto-taxas-rendimento-hoje-prefixado-2029-recua-renda-longo-sobe-10112026/
Custódia B30,20% a.a.; Tesouro Selic isento até R$ 10.000 por CPF, cobra só o excedentepágina sem data, lida em 17/11/2026https://b3.com.br/pt_br/produtos-e-servicos/tarifas/tarifas-de-tesouro-direto/
CDB110% do CDIdado pelo usuário-
Fundotaxa de administração 1% a.a.dado pelo usuário-
LCA/LCI 2 anos90% do CDI (suposição dentro da faixa observada)média LCA 12 m em 2026 = 86,6% do CDI (24/09/2026); média 90% a 93% (abr/2026)https://seudinheiro.com/2026/renda-fixa/cade-as-lcis-e-lcas-que-pagavam-de-95-a-100-do-cdi-titulos-isentos-estao-sumindo-das-prateleiras-e-oferecendo-taxas-menores-mlim/ e https://investidor10.com.br/noticias/lcas-e-lcis-pagam-media-de-90-a-93-do-cdi-em-2026-veja-retorno-119717/
LCA/LCI com liquidez diária80% do CDI05/02/2026https://investnews.com.br/investimentos/isencao-de-ir-nas-lci-e-lca-o-que-realmente-esta-valendo-nas-regras-dos-titulos-bancarios/
Focus (cenário B)Selic fim de 2026 = 13,75%; 2027 = 12,75%; 2028 = 11,00%13/11/2026https://olinda.bcb.gov.br/olinda/servico/Expectativas/versao/v1/odata/ExpectativasMercadoAnuais (filtro Indicador = Selic)

Observação: a taxa do Tesouro não pôde ser lida direto no site do Tesouro Direto (mercado fechado na hora da consulta, 17/11/2026 às 18h), por isso a fonte é a InvestNews de 10/11/2026.

3. Tabela de IR aplicada (renda fixa e fundos de longo prazo, pessoa física)

PrazoAlíquota
até 180 dias22,5%
181 a 360 dias20%
361 a 720 dias17,5% (saque em 1 ano: 365 dias)
acima de 720 dias15% (2 anos: 731 dias)
poupança, LCI, LCAisento

IOF: zero (todos os resgates passam de 30 dias). A MP 1.303/2025, que trocaria a tabela por 17,5% único, perdeu a validade em 08/10/2025; não achei mudança posterior aprovada.

4. Fórmulas

Notação: CDI = 13,65%, cdi_d = (1 + CDI)^(1/252) - 1 = 0,000507880 por dia útil.

Poupança
p = 0,6501% ao mês
V = 10.000 x (1 + p)^meses        (24 meses ou 12 meses)
IR = 0
  • 2 anos: 10.000 x 1,006501^24 = 11.682,77
  • 1 ano: 10.000 x 1,006501^12 = 10.808,69 (equivale a 8,09% a.a.)
Tesouro Selic 2031
fator_d = (1 + 13,65%)^(1/252) x (1 + 0,1072%)^(1/252)     -> 13,77% a.a.
V       = 10.000 x fator_d ^ dias_úteis
custódia = soma, em cada dia corrido, de max(V_dia - 10.000; 0) x 0,20% / 365
IR      = (V - 10.000 - custódia) x alíquota
Líquido = V - custódia - IR
  • 2 anos: V = 12.924,16; custódia = 5,61; IR = (12.924,16 - 10.000 - 5,61) x 15% = 437,78; líquido = 12.480,77
  • 1 ano: V = 11.359,72; custódia = 1,33; IR = 17,5% = 237,72; líquido = 11.120,67
CDB 110% do CDI
taxa_d = cdi_d x 1,10 = 0,000558668     -> 15,11% a.a. equivalente
V      = 10.000 x (1 + taxa_d) ^ dias_úteis
IR     = (V - 10.000) x alíquota
  • 2 anos: V = 13.228,85; IR 15% = 484,33; líquido = 12.744,52
  • 1 ano: V = 11.492,04; IR 17,5% = 261,11; líquido = 11.230,93
Fundo DI com taxa de 1% a.a.
cota_d = cota x (1 + cdi_d - 1%/252)        -> 12,52% a.a. equivalente
come-cotas (último dia útil de maio e nov.):
  imposto = cotas x (cota - base) x 15%;  cotas -= imposto / cota;  base = cota
no resgate:
  IR_final = cotas x [ (alíquota - 15%) x (base - 1) + alíquota x (cota - base) ]
Líquido = cotas x cota - IR_final
Bruto (na tabela) = Líquido + IR total pago (come-cotas + IR_final)

Come-cotas no caminho (cenário principal):

DataCotaCome-cotas (R$)
30/11/20261,0037525,63
31/05/20271,06323989,18
30/11/20271,12836296,81
31/05/20281,196913101,02
  • 2 anos: cota final 1,264292; 9.740,32 cotas; IR final 98,45; IR total 391,09; líquido = 12.216,16
  • 1 ano: cota final 1,123618; 9.910,52 cotas; IR final 120,38 (completa de 15% para 17,5%); IR total 215,19; líquido = 11.015,25

O "bruto" do fundo (12.607,25) é menor do que seria sem come-cotas (cerca de 12.643), porque o imposto antecipado deixa de render.

LCA 90% do CDI (isenta, 2 anos)
taxa_d = cdi_d x 0,90     -> 12,21% a.a. equivalente
V = 10.000 x (1 + taxa_d)^501;  IR = 0
  • 2 anos: 12.572,80
  • 1 ano: não tem (LCA de 2 anos costuma não ter liquidez antes do vencimento)
LCA 80% do CDI com liquidez diária (isenta)
taxa_d = cdi_d x 0,80     -> 10,78% a.a. equivalente
  • 2 anos: 12.257,06
  • 1 ano: 11.064,42

5. Resultado (cenário A: Selic constante)

Opção2 anos: brutoIRcustoslíquido1 ano: brutoIRcustoslíquido
Poupança11.682,770,000,0011.682,7710.808,690,000,0010.808,69
Tesouro Selic 203112.924,16437,785,6112.480,7711.359,72237,721,3311.120,67
CDB 110% do CDI13.228,85484,330,0012.744,5211.492,04261,110,0011.230,93
Fundo DI 1% a.a.12.607,25391,090,0012.216,1611.230,45215,190,0011.015,25
LCA 90% CDI (2 anos)12.572,800,000,0012.572,80---sem liquidez
LCA 80% CDI (liquidez)12.257,060,000,0012.257,0611.064,420,000,0011.064,42

6. Cenário B (Selic caindo pelo Focus de 13/11/2026)

Selic meta interpolada em linha reta: 13,75% em 17/11/2026, 13,75% em 31/12/2026, 12,75% em 31/12/2027, 11,00% em 31/12/2028. CDI = Selic meta - 0,10 p.p. (a diferença de hoje). Poupança mantida igual ao cenário A (simplificação: a TR também cairia).

Opção2 anos líquido1 ano líquido
Poupança11.682,7710.808,69
Tesouro Selic 203112.283,0011.088,95
CDB 110% do CDI12.521,8011.195,62
Fundo DI 1% a.a.12.027,2810.984,12
LCA 90% CDI (2 anos)12.368,67sem liquidez
LCA 80% CDI (liquidez)12.079,9911.034,42

7. Suposições

  1. Selic e CDI constantes no cenário principal; cenário B mostra a queda esperada pelo mercado.
  2. Poupança: média do rendimento do último mês repetida; aplicação no dia 17, sem saque fora do aniversário.
  3. Tesouro Selic 2031 vendido antes do vencimento com o mesmo ágio de 0,1072% (risco pequeno de variação para mais ou para menos). Corretora com taxa zero. Custódia B3 só sobre o excedente de R$ 10 mil, base 365 dias corridos. IR calculado sobre o ganho já descontada a custódia.
  4. CDB 110% do CDI com liquidez diária pelo valor da curva. Se o CDB não tiver liquidez, o saque em 1 ano não é possível (ou sai com deságio no mercado secundário).
  5. "Fundo com taxa de 1% ao ano" = fundo de renda fixa DI, longo prazo, 100% do CDI antes das taxas, 1% a.a. de administração descontada por dia útil (1%/252), sem taxa de performance, come-cotas de 15% em maio e novembro. Sem FGC.
  6. Opção isenta: poupança já é isenta; acrescentei LCA/LCI (isenta de IR para pessoa física pela Lei 11.033/2004, art. 3º, IV). Prazo mínimo hoje de 6 meses (Res. CMN 5.215/2025). Há proposta de tributar; não achei lei aprovada até 17/11/2026.
  7. Valores nominais (sem descontar inflação). FGC cobre poupança, CDB e LCA até R$ 250 mil por CPF por instituição.

Arquivos de exemplo

O que o Claude entregou

voltar ao índice

Projetos avançados

#projeto-13

Projeto 13. Carteira de investimentos viva

O que foi pedido: um painel da carteira com a cotação mais recente de cada ativo, conferida em duas fontes, lucro ou prejuízo e quanto o mesmo dinheiro teria rendido no CDI e no Ibovespa.

Dados inventados para o teste. As cotações são públicas, de 17/11/2026.

Painel da carteira com posições, lucro e comparação com CDI e Ibovespa
O painel da carteira. ver a imagem inteira
abrir o painel

Arquivos de exemplo

O que foi colocado na pasta
O que o Claude entregou
A ferramenta criada
  • Skill atualizar-carteira (SKILL.md) 1 KB
    ler aqui
    ---
    name: atualizar-carteira
    description: Atualiza o painel da carteira (painel.html) com as cotações de hoje. Use quando o usuário pedir "atualiza a carteira", "atualizar painel" ou colocar uma planilha nova da carteira na pasta.
    ---
    
    # Atualizar a carteira
    
    1. Leia `minha-carteira.xlsx` (ativo, tipo, quantidade, preço de compra, data).
    2. Busque a cotação de hoje de cada ativo em DUAS fontes públicas, sem conta e sem chave:
       - Ações e FIIs: Yahoo Finance (`query1.finance.yahoo.com/v8/finance/chart/<TICKER>.SA`) e Investidor10 (`investidor10.com.br/acoes/<ticker>/` ou `/fiis/<ticker>/`).
       - Tesouro: Investidor10 (`/tesouro-direto/<titulo>/`) e o CSV oficial do Tesouro Transparente (PU de venda, data-base D-1).
       - CDI: API do Banco Central, série SGS 12. Ibovespa: Yahoo `^BVSP`.
    3. Grave em `cotacoes.json` o valor, a fonte e o horário de cada cotação.
    4. Rode `python montar_painel.py` e confira: diferença entre fontes acima de 0,5% vira alerta; ativo acima de 20% da carteira vira alerta.
    5. Diga ao usuário: valor hoje, lucro, comparação com CDI e Ibovespa e os alertas. Se uma fonte falhar, diga qual e NÃO invente número.
    

voltar ao índice

#projeto-14

Projeto 14. Fluxo de caixa da empresa com projeção

O que foi pedido: o fluxo de caixa dos últimos 12 meses de uma padaria e a projeção dos próximos 12 em três cenários, num painel e numa planilha Excel com fórmulas.

Dados inventados para o teste.

Painel de fluxo de caixa com histórico e três cenários
O painel com o histórico e os três cenários. ver a imagem inteira
abrir o painel

Com o pedido de melhoria e se eu contratar duas pessoas em março?:

abrir o painel com as contratações

voltar ao índice

#projeto-15

Projeto 15. Leitor de notas fiscais

O que foi pedido: ler dez notas fiscais com agents em paralelo, montar a planilha, marcar CNPJs inválidos e conferir a amostra com outro agent.

Dados inventados para o teste. As notas são marcadas "sem valor fiscal" e os CNPJs são inválidos de propósito.

Planilha com os dados das notas fiscais
A planilha montada pelos agents. ver a imagem inteira
Nota fiscal fictícia legível
Uma das notas. ver a imagem inteira
Nota fiscal escaneada e borrada
A nota escaneada e borrada: ficou em Não lidas, sem chute. ver a imagem inteira

Um agent que não viu a extração abriu as notas e conferiu campo a campo:

A conferência por amostra

Conferência por amostra: notas-fiscais.xlsx x PDFs

Data: 17/11/2026 20:27. Dados fictícios.

Escolha da amostra

  • A pasta notas/ tem exatamente 10 PDFs (nf-01 a nf-10). Então a amostra de 10 é a pasta inteira.
  • A nf-08 está na aba "Não lidas", sem linha na aba "Notas". Abri o PDF: é imagem escaneada (JPEG 409x553, 45 ppi), borrada e inclinada, sem camada de texto. Nem renderizada a 200 dpi dá para ler um campo com segurança. Resultado: não conferível (não é acerto nem erro). A justificativa da planilha está correta.
  • Sobram 9 notas comparáveis.

Método

  • Cada PDF lido duas vezes: texto (pdftotext -layout) e imagem renderizada (pdftoppm), conferida a olho. Texto e imagem coincidem nas 9 notas.
  • Planilha lida com openpyxl. Valores comparados ao centavo.
  • Extra: conferi a soma dos itens (+ IPI) contra o total em cada nota. Todas fecham.

Tabela nota x campo

OK = planilha igual ao PDF.

NotaNúmeroDataFornecedorCNPJTotalICMSIPIPISCOFINSResultado
nf-01OKOKOKOKOKOKOKOKOKbateu
nf-02OKOKOKOKOKOKOKOKOKbateu
nf-03OKOKOKOKOKOKOKOKOKbateu
nf-04OKOKOKOKOKOKOKOKOKbateu
nf-05OKOKOKOKOKOKOKOKOKbateu
nf-06OKOKOKOKOKOKOKOKOKbateu
nf-07OKOKOKOKOKOKOKOKOKbateu
nf-08---------não conferível (escaneada ilegível; está em "Não lidas")
nf-09OKOKOKOKOKOKOKOKOKbateu
nf-10OKOKOKOKOKOKOKOKOKbateu

Valores lidos no PDF (iguais aos da planilha):

NotaNúmeroDataFornecedorCNPJTotalICMSIPIPISCOFINS
nf-01000.001.03708/08/2026Moinho Ficticio Alfa Ltda00.000.000/0001-00323,0658,150,005,3324,55
nf-02000.001.07412/08/2026Laticinios Teste Beta S.A.11.111.111/0001-111.705,33306,960,0028,14129,61
nf-03000.001.11112/09/2026Embalagens Exemplo Gama ME22.222.222/0001-222.091,63358,5799,6032,87151,39
nf-04000.001.14819/09/2026Distribuidora Modelo Delta Ltda99.999.999/0001-997.186,981.293,660,00118,59546,21
nf-05000.001.18528/08/2026Moinho Ficticio Alfa Ltda00.000.000/0001-0011.541,702.077,510,00190,44877,17
nf-06000.001.22228/08/2026Laticinios Teste Beta S.A.11.111.111/0001-112.718,51466,03129,4542,72196,77
nf-07000.001.25915/10/2026Embalagens Exemplo Gama ME22.222.222/0001-22359,1064,640,005,9327,29
nf-09000.001.33315/08/2026Moinho Ficticio Alfa Ltda00.000.000/0001-005.706,23978,21271,7389,67413,02
nf-10000.001.37024/08/2026Laticinios Teste Beta S.A.11.111.111/0001-113.676,09661,700,0060,66279,38

Placar

9 de 9 notas conferíveis bateram (81 de 81 campos). Na amostra de 10: 9 bateram, 0 divergiram, 1 não conferível (nf-08).

Divergências

Nenhuma nos 9 campos pedidos.

Fora da conferência (só registro, não conta no placar):

  • Os CNPJs dos emitentes são de teste e falham no dígito verificador. A planilha copiou como impresso e marcou "NÃO". Está coerente.
  • A linha TOTAL soma F2:F10, as 9 notas lidas. Não inclui a nf-08, porque ela não tem valor.

Arquivos de exemplo

O que foi colocado na pasta
O que o Claude entregou

voltar ao índice

#projeto-16

Projeto 16. Sua equipe de mercado financeiro, todo dia às 7h

O que foi pedido: criar cinco agents (ações, macroeconomia, notícias, revisor e editor) e uma skill que entrega o relatório do mercado em PDF de duas páginas.

Dados inventados para o teste. A lista de ativos é inventada; cotações e notícias são públicas, de 17/11/2026. Não é recomendação de investimento.

Arquivos de exemplo

O que foi colocado na pasta
O que o Claude entregou
A ferramenta criada
  • Skill relatorio-do-mercado (SKILL.md) 1 KB
    ler aqui
    ---
    name: relatorio-do-mercado
    description: Gera o relatório diário do mercado financeiro em PDF de até 2 páginas, com a equipe de 5 agents. Use quando o usuário pedir "relatório do mercado" ou numa tarefa agendada.
    ---
    
    # Relatório do mercado
    
    1. Leia `config.md` (ativos e temas). Confira a data e a hora de agora com `date`. Se for sábado, domingo ou depois das 12h, avise no topo do relatório que os dados são do último fechamento.
    2. Em paralelo, chame os agents `analista-de-acoes`, `analista-de-macro` e `analista-de-noticias`.
    3. Chame o `revisor`. Nada vai para o PDF sem passar por ele.
    4. Chame o `editor`. O PDF sai em `Relatorios/relatorio-AAAA-MM-DD.pdf`.
    5. Confira: o PDF abre, tem no máximo 2 páginas, todo número tem fonte e horário. Diga ao usuário quantos números foram conferidos, divergentes e cortados.
    
  • Agent analista-de-acoes (.md) 1 KB
    ler aqui
    ---
    name: analista-de-acoes
    description: Busca cotação, variação do dia e notícias de cada ativo da lista do usuário. Use na etapa 1 do relatório do mercado.
    tools: WebSearch, WebFetch, Bash, Read, Write
    ---
    Você é o analista de ações. Para cada ativo da lista em `config.md`:
    - cotação de fechamento (ou a última), variação do dia em %, variação em 5 dias;
    - até 2 notícias das últimas 24 h que citem o ativo.
    Toda linha leva FONTE (site + URL) e HORÁRIO (do dado, não da busca). Sem fonte, não escreva o número.
    Grave em `trabalho/acoes.json`. Fontes públicas sem conta funcionam: Yahoo Finance (query1.finance.yahoo.com/v8/finance/chart/<TICKER>.SA) e Investidor10.
    
  • Agent analista-de-macro (.md) 1 KB
    ler aqui
    ---
    name: analista-de-macro
    description: Levanta juros (Selic, CDI), dólar, inflação (IPCA e expectativa Focus), bolsas de fora e a agenda do dia. Use na etapa 1 do relatório do mercado.
    tools: WebSearch, WebFetch, Bash, Read, Write
    ---
    Você é o analista de macroeconomia. Levante: Selic meta e CDI (API do Banco Central, SGS 432 e 12), dólar comercial (PTAX, SGS 1, e cotação de mercado), IPCA 12 meses, Ibovespa, S&P 500, petróleo Brent, e a agenda de indicadores e eventos de hoje.
    Todo número com FONTE (site + URL) e HORÁRIO/DATA do dado. Grave em `trabalho/macro.json`.
    
  • Agent analista-de-noticias (.md) 1 KB
    ler aqui
    ---
    name: analista-de-noticias
    description: Separa as notícias relevantes do dia para os ativos e temas do usuário e explica o que pode mexer com eles. Use na etapa 1 do relatório do mercado.
    tools: WebSearch, WebFetch, Read, Write
    ---
    Você é o analista de notícias. Com base em `config.md` (ativos e temas), escolha no máximo 5 notícias das últimas 24 h que importam.
    Para cada uma: título, veículo, URL, horário de publicação e UMA frase sobre o efeito possível nos ativos do usuário. Opinião vai marcada como opinião.
    Grave em `trabalho/noticias.json`.
    
  • Agent revisor (.md) 1 KB
    ler aqui
    ---
    name: revisor
    description: Confere cada número dos analistas em uma segunda fonte e corta o que não tem fonte. Use na etapa 2 do relatório do mercado, antes do editor.
    tools: WebSearch, WebFetch, Bash, Read, Write
    ---
    Você é o revisor. Leia `trabalho/acoes.json`, `trabalho/macro.json` e `trabalho/noticias.json`.
    Para CADA número, busque o mesmo dado em uma segunda fonte independente. Tolerância: 0,5% para preços, mesma casa decimal para taxas.
    - Bateu: marque "conferido" com a segunda fonte e o horário.
    - Divergiu: mantenha o da fonte primária e marque "divergente" com os dois valores.
    - Sem fonte ou sem horário: CORTE.
    Notícia: confira que o link abre e que a data é das últimas 24 h.
    Grave `trabalho/revisado.json` e um resumo de quantos números conferiu, divergiu e cortou.
    
  • Agent editor (.md) 1 KB
    ler aqui
    ---
    name: editor
    description: Junta o material revisado em um PDF de até duas páginas com visual profissional. Use na etapa final do relatório do mercado.
    tools: Bash, Read, Write
    ---
    Você é o editor. Use só `trabalho/revisado.json` (nunca os arquivos dos analistas direto).
    Monte um PDF A4 de no máximo 2 páginas: (1) destaques do dia no topo, em até 3 linhas; (2) tabela dos ativos (cotação, variação, fonte, horário); (3) cenário macro; (4) notícias que importam; (5) agenda do dia; rodapé "não é recomendação de investimento".
    Todo número com fonte e horário (em nota pequena). Salve em `Relatorios/relatorio-AAAA-MM-DD.pdf` e confira o número de páginas antes de entregar.
    

voltar ao índice

Casos de uso

#caso-aprender

6.1 Aprender qualquer assunto, com medidor de progresso

O que foi pedido: um curso de noções de contabilidade para o dono de uma loja de roupas, 20 minutos por dia, com cartões de revisão e medidor de visto, absorvido e dominado.

Dados inventados para o teste. As duas sessões e as respostas do aluno foram simuladas.

Painel de progresso com visto, absorvido e dominado
O medidor de progresso depois de duas sessões. ver a imagem inteira
abrir o painel
O arquivo de progresso

Progresso: contabilidade para pequenos negócios

Atualizado em 2026-11-18.

Visto: 50% (4 de 8 tópicos) · Absorvido: 25% (2 de 8) · Dominado: 0% (0 de 8)

Revisões que vencem em 2026-11-19: C3, C5. Prova semanal: 2026-11-21 (nenhuma feita).

TópicoVistoAbsorvidoDominadoRevisões com acerto depois da aula
T1 Separar contas2026-11-172026-11-18—1 de 3
T2 Pró-labore2026-11-172026-11-18—1 de 3
T3 Caixa x competência2026-11-17——0 de 3 (errou C3 em 11-18)
T4 Fluxo de caixa2026-11-18——0 de 3
T5 DRE————
T6 Margem de contribuição————
T7 Ponto de equilíbrio————
T8 Capital de giro————

Notas das provas semanais

(nenhuma ainda)

Os cartões de revisão, escritos pelo aluno

Cartões de revisão (escritos pelo aluno, conferidos pelo Claude)

IDTópicoFrente (pergunta)Verso (resposta, palavras do aluno)AutorCorreção do ClaudeCriadoIntervalo atualPróxima revisãoHistórico
C1T1Por que separar a conta da loja da minha?Porque o dinheiro da loja é da loja; misturando eu não sei se ela dá lucro.alunonenhuma2026-11-1732026-11-2111-18 acerto
C2T2O que é pró-labore?O salário fixo que eu me pago todo mês, tirado da loja.alunonenhuma2026-11-1732026-11-2111-18 acerto
C3T3O que é regime de competência?A venda conta no mês em que aconteceu, mesmo se eu receber depois.alunotrocou "quando paga" por "quando aconteceu" (p. 2)2026-11-1712026-11-1911-18 erro → volta para 1
C4T3Vendi em março, recebo em abril: em que mês entra na competência? E no caixa?Competência: março. Caixa: abril.aluno (tema sugerido pelo Claude)nenhuma2026-11-1732026-11-2111-18 acerto
C5T4Para que serve o fluxo de caixa?Para ver entradas e saídas por data e prever quando vai faltar dinheiro.alunonenhuma2026-11-1812026-11-19—
Como foi a segunda sessão

Sessão 2 — 2026-11-18 ("um dia depois"; data fingida para o teste)

Revisões do dia (regra 1: antes de conteúdo novo)

Vencem hoje: C1, C2, C3, C4. Atrasados: nenhum.

  • C1 (T1): aluno responde de memória → ACERTO sem ajuda. Intervalo 1 → 3. Próxima: 2026-11-21.
  • C2 (T2): aluno diz "esse eu já sei, pula". Claude (regra 7): "Não pulo: responde rapidinho." → ACERTO sem ajuda. 1 → 3. Próxima: 2026-11-21.
  • C3 (T3): aluno responde "competência é quando o dinheiro entra" → ERRO. Volta para 1. Próxima: 2026-11-19. Claude mostra o próprio cartão do aluno e a p. 2.
  • C4 (T3): ACERTO sem ajuda. 1 → 3. Próxima: 2026-11-21.

Marcações: T1 e T2 viram ABSORVIDO (acerto de memória, sem ajuda, 1 dia depois da aula). T3 NÃO vira absorvido: errou um dos dois cartões do tópico hoje.

T4. Fluxo de caixa (apostila, p. 3)

Antes: "Se começo o mês com R$ 2 mil, vendo R$ 8 mil e gasto R$ 9,5 mil, quanto tenho no fim?" → aluno: "R$ 500." ACERTO. / "Para que serve o fluxo de caixa?" → "Para pagar imposto." ERRO. Explicação com a loja (coleção de verão comprada antes de vender). Explicar de volta: OK. Pergunta de memória: "Para que serve o fluxo de caixa?"

  • Aluno: "Me dá a resposta." Claude (regra 4): dica 1: "Pense no que você quer saber ANTES do dinheiro acabar."
  • 1a tentativa: "Para saber o saldo." → incompleto.
  • Dica 2: "E para o futuro?" 2a tentativa: "Para prever quando vai faltar dinheiro." → ACERTO COM DICA.

Cartões

  • C5 (T4) escrito pelo aluno; Claude conferiu com a p. 3, sem correção. Próxima: 2026-11-19.

Medidor ao fim

Visto 4 de 8 (50%). Absorvido 2 de 8 (25%). Dominado 0 de 8 (0%). Prova semanal: ainda não (primeira será em 2026-11-21, sexta).

Arquivos de exemplo

O que foi colocado na pasta
O que o Claude entregou
A ferramenta criada
  • Skill aula (SKILL.md) 3 KB
    ler aqui
    ---
    name: aula
    description: Sessão diária do curso "Noções de contabilidade para pequenos negócios". Use quando o aluno escrever "aula", "vamos estudar", "revisão" ou pedir para continuar o curso.
    ---
    
    # Aula: contabilidade para pequenos negócios
    
    Aluno: dono de loja de roupas, parte de quase nada, 20 minutos por dia.
    Material: `material/apostila.pdf` (6 páginas). Cite sempre a página ("apostila, p. 3").
    
    ## Arquivos que você lê e atualiza em toda sessão
    - `plano.md`: os tópicos, em ordem.
    - `progresso.md`: medidor no topo e tabela visto/absorvido/dominado por tópico.
    - `cartoes.md`: os cartões ESCRITOS PELO ALUNO, com intervalo e próxima revisão.
    - `registro.csv`: uma linha por resposta do aluno (data, cartão ou tópico, tipo, resultado, ajuda). É a prova de cada marcação.
    - `sessoes/AAAA-MM-DD.md`: resumo da sessão do dia.
    
    Antes de tudo, rode `date +%F` para saber a data de hoje. Não confie na memória da conversa para a data.
    
    ## Roteiro da sessão
    1. Revisões primeiro: todos os cartões com próxima revisão em hoje OU antes de hoje (atrasados). Pergunte a frente do cartão; o aluno responde de memória, sem consultar e sem dica. Não aceite "pular porque já sei".
    2. Conteúdo novo (o próximo tópico do plano, um por vez):
       a. duas perguntas sobre o tópico ANTES de explicar, para o aluno tentar sozinho (vale errar);
       b. explique com exemplo da loja de roupas, citando a página;
       c. peça que ele explique de volta com as palavras dele;
       d. perguntas de resposta escrita, de memória; corrija dizendo o que faltou.
       Se ele travar ou pedir a resposta: uma dica por vez. A resposta só depois de duas tentativas dele.
    3. Cartões: sugira o que vale virar cartão; o ALUNO escreve; você confere com a apostila e corrige. Registre no `cartoes.md` com autor "aluno" e a correção, se houve.
    4. Atualize `registro.csv`, `cartoes.md`, `progresso.md` e grave `sessoes/<data>.md`.
    
    ## Agenda dos cartões
    - Intervalos ENTRE revisões: 1, 3, 7, 14, 30 dias. Cartão novo: primeira revisão 1 dia depois de criado.
    - Acerto sem ajuda: passa para o próximo intervalo (depois de 30, continua 30).
    - Erro, ou acerto só com dica: volta para 1 dia.
    
    ## Marcações por tópico
    - Visto: o tópico foi explicado e o aluno respondeu às primeiras perguntas.
    - Absorvido: em uma revisão feita pelo menos 1 dia depois da aula, o aluno acertou TODOS os cartões do tópico revisados naquele dia, de memória e sem ajuda. Acerto no mesmo dia da aula não conta.
    - Dominado: três revisões com acerto, em três dias diferentes, todas depois do dia da aula (o acerto do dia da aula não conta).
    - Erro numa revisão posterior NÃO apaga o "absorvido" (a marcação diz que já ficou uma vez), mas zera a contagem de "dominado".
    
    ## Medidor (topo do progresso.md)
    Sempre porcentagem com a contagem: "Absorvido: 25% (2 de 8 tópicos)".
    
    ## Prova semanal
    Às sextas (ou na primeira sessão após 7 dias da última prova): prova sem ajuda, perguntas NOVAS de aplicação. Registre a nota no `progresso.md`.
    

voltar ao índice

#caso-mercado

6.2 Estudo de mercado

O que foi pedido: um estudo de mercado para uma cafeteria de especialidade em Curitiba, público de 25 a 40 anos, com fonte e data em cada número.

Dados inventados para o teste. O negócio é inventado; os números vêm de fontes públicas, lidas em 17/11/2026.

Página 1 do estudo de mercado
Página 1 de 5. ver a imagem inteira
Página 2 do estudo de mercado
Página 2 de 5. ver a imagem inteira

Arquivos de exemplo

O que o Claude entregou

voltar ao índice

#caso-saude

6.3 Diário de saúde

O que foi pedido: um diário com sono, passos e batimentos do relógio, refeições com estimativa de calorias, remédios e humor, e um resumo da semana.

Dados inventados para o teste. O remédio "Remediol" não existe. O diário não faz diagnóstico.

Resumo de uma página para levar à consulta
O resumo de uma página para a consulta (pedido de melhoria). ver a imagem inteira
O resumo da semana

Resumo da semana: 09/11 (seg) a 15/11 (dom)

Médias

MedidaMédia da semanaDias com dado
Sono6,9 h por noite7
Passos7.457 por dia7
Batimentos (média do dia)68 bpm7
Calorias1.547 kcal por dia, estimativa (feita pela descrição das refeições)3 (13 a 15/11)
Proteína78 g por dia, estimativa3 (13 a 15/11)

O que mudou

Primeira semana do diário: ainda não há semana anterior para comparar.

  • Remédio: tomado nos 3 dias registrados; em 14/11 às 08:40, 40 minutos depois do horário de costume.
  • Álcool: 13/11 (2 latas de cerveja), 14/11 (1 taça de vinho), 15/11 (cerveja, quantidade não informada).
  • Café registrado só em 13/11.

Coincidências que apareceram

Coincidência não é causa: isto é só o que apareceu junto nos registros, numa semana só, e não serve para conclusão.

  1. As duas noites mais curtas (5,1 h antes de 11/11 e 6,0 h antes de 13/11) caíram nos dois dias de batimento médio mais alto (74 e 73 bpm; nos outros dias, 64 a 68).
  2. Em 13/11, sono curto, "ansioso com a entrega" e o dia de mais calorias estimadas (1.820 kcal) apareceram juntos.
  3. Em 14/11, o dia de mais passos (12.100, com caminhada no parque) foi o dia em que você escreveu "Leve... me senti bem".
  4. Depois das 2 cervejas de 13/11, a noite seguinte foi a mais longa da semana (8,1 h). Uma noite só não diz nada.

Lacunas

  • Refeições, remédio e humor só foram contados de 13 a 15/11.
  • Quantidade de cerveja de 15/11 não informada.

Este resumo organiza informação; não é diagnóstico. Não mude dose nem horário de remédio por causa dele: leve ao seu médico.

Um dia do diário

Diário 2026-11-14

Relógio (do arquivo exportado do app Saúde)

  • Sono da noite anterior: 8.1 h
  • Passos: 12100
  • Batimentos: média 68, mínimo 62, máximo 72 bpm

Refeições

  • 09:00 Ovos mexidos (2 ovos) e meio mamão. Estimativa: 260 kcal, 14 g de proteína.
  • 13:00 Feijoada, 1 prato, com arroz e couve. Estimativa: 900 kcal, 45 g de proteína.
  • 19:30 Sanduíche de queijo e peito de peru. Estimativa: 380 kcal, 22 g de proteína.

Total do dia (estimativa): 1.540 kcal, 81 g de proteína.

Remédios e substâncias

  • 08:40 Remediol 50 mg (tomado 40 min depois do horário de costume, 08:00).
  • 22:00 Vinho tinto, 1 taça.

Exercício

  • 10:30 Caminhada no parque, cerca de 1 h (contado pelo usuário).

Como estou

"Leve. Andei muito no parque e me senti bem, a ansiedade de ontem passou."

Arquivos de exemplo

O que foi colocado na pasta
O que o Claude entregou
A ferramenta criada
  • Skill diario (SKILL.md) 2 KB
    ler aqui
    ---
    name: diario
    description: Diário de saúde pessoal. Use quando a mensagem começar com "Diário:", quando o usuário contar uma refeição, remédio, substância, sono, exercício ou como está se sentindo, quando colocar um arquivo exportado do relógio na pasta, ou quando pedir o resumo da semana.
    ---
    
    # Diário de saúde
    
    Pasta: esta. Um arquivo por dia em `dias/AAAA-MM-DD.md`. Resumos em `semanas/AAAA-MM-DD-resumo.md` (data do domingo).
    Antes de registrar, rode `date '+%F %H:%M'`: o horário vem do relógio, a menos que o usuário diga outro.
    
    ## O que registrar (sempre com horário)
    1. Refeições: o que comeu + estimativa de calorias (kcal) e de proteína (g), escrito "estimativa" ao lado de cada número. Foto de prato ou rótulo: estime a partir dela e diga que é estimativa.
    2. Remédios, suplementos e substâncias (café, álcool, o que mais ele contar): nome, dose, hora.
    3. Sono, passos, exercício e batimentos: do arquivo do relógio (`apple_health_export/export.xml` ou outro exportado). Use `python3 ler_relogio.py <arquivo>`; não leia o XML inteiro na conversa.
    4. Como está se sentindo e os pensamentos: com as palavras DELE, entre aspas, sem resumir.
    
    Faltou informação (quantidade, dose, horário)? PERGUNTE antes de registrar. Não invente; se ele não souber, registre "não informado".
    
    ## Resumo de domingo
    Médias da semana, o que mudou em relação à semana anterior (se houver), coincidências entre sono, alimentação, substâncias e humor, com a frase: "Coincidência não é causa: isto é só o que apareceu junto nos registros." Calorias aparecem como estimativa. Nada de diagnóstico nem sugestão de mudar remédio.
    

voltar ao índice