GARCIA_OS

Em uma frase: é o cérebro da Garcia Baterias fora da loja.

Uma pasta no computador da loja onde mora, em arquivos de texto, tudo que a empresa sabe sobre si mesma — mais um assistente de inteligência artificial que lê esses arquivos, entende o negócio e trabalha em cima deles.

Não é um programa que alguém instalou e usa clicando em botão. É mais parecido com um arquivo vivo com um funcionário dentro: você conversa em português, e ele lê, calcula, escreve, confere e guarda.

O problema que ele resolve

A Garcia tem mais de 65 anos, 4 pessoas e roda bem. O que faltava não era faturamento — era método. Quase tudo que a empresa sabe estava na cabeça de uma pessoa só:

• quanto cada bateria custa e quanto se ganha nela
• quais empresas compram no boleto
• como fechava o mês passado, e se isso é bom ou ruim
• por que a dívida com a Moura cresce
• o que responder no WhatsApp e por qual preço
• quando o estoque bate e quando não bate

Cabeça não escala, não faz conta e não passa pra outra pessoa. O sistema existe pra que cada uma dessas coisas vire arquivo — e, virando arquivo, possa ser conferida, comparada e melhorada.

A regra que define o sistema

Tudo que hoje está na cabeça da equipe vai virando arquivo aqui.

E o corolário: nada é decidido no achismo quando existe número. O sistema não inventa dado. Se o dado falta, ele diz que falta.

O que já saiu disso, em numeros

O que e o Claude

Claude é um modelo de inteligência artificial feito pela Anthropic. Na prática é um programa que leu uma quantidade absurda de texto e aprendeu a entender e escrever em linguagem humana — em português inclusive. Ele conversa, resume, calcula, escreve, revisa e programa.

Existem versões diferentes do Claude, das mais rápidas e baratas às mais capazes. A que roda neste workspace é a mais capaz da linha. Isso importa porque as tarefas da Garcia não são "escreve um textinho": são ler uma planilha de 14 abas com mais de 400 fórmulas, achar o erro e explicar o que ele significa em dinheiro.

O que o Claude sozinho NAO faz

Um modelo de IA puro, sozinho, faz uma coisa só: recebe texto e devolve texto. Ele não abre arquivo, não navega na internet, não mexe em planilha, não roda conta. É como um consultor extremamente bem informado trancado numa sala sem janela — você conversa com ele, mas ele não alcança nada.

O que e o Claude Code

Claude Code é o que dá braços e pernas ao Claude. É um programa da Anthropic que roda no computador e entrega ao Claude um conjunto de ferramentas:

É essa diferença que faz o sistema existir. Sem as ferramentas, o Claude conversaria sobre baterias. Com elas, ele abre a planilha de agosto no Drive, soma a coluna, compara com julho, acha a divergência e escreve o diagnóstico no arquivo certo da pasta certa.

Como o Claude "sabe" da Garcia Baterias

Ele não sabe. Ele lê — toda vez, do zero.

O Claude não tem memória própria entre conversas. Quando se abre uma conversa nova, ele começa sem saber quem é o dono, o que a Garcia vende ou quanto custa uma M60GD. A memória do sistema é feita de arquivos: no começo de cada conversa, o Claude Code entrega a ele o AGENTS.md e os arquivos de _contexto/, e é isso que o traz de volta pro caso.

Por isso a disciplina de escrever tudo em arquivo não é burocracia: arquivo é literalmente a memória do sistema. O que não estiver escrito, o Claude não sabe na conversa seguinte.

O ciclo de trabalho, por dentro

Quando se digita "confere as notas", acontece o seguinte, em segundos:

1. 01 O Claude Code lê as instruções permanentes (AGENTS.md) e o contexto do negócio (_contexto/)
2. 02 Ele vê que existe uma skill chamada conferir-notas cuja descrição casa com o pedido
3. 03 Carrega o passo a passo dessa skill
4. 04 Executa: acha o PDF, lê a planilha no Drive, roda o script Python de comparação
5. 05 Confere o resultado e escreve o arquivo .txt na pasta certa
6. 06 Responde em português, resumindo só o que importa

Ninguém precisou dizer onde está a planilha, qual coluna olhar, quais modelos têm nome diferente nas duas fontes, nem onde salvar. Tudo isso está escrito na skill — foi decidido uma vez e vale pra sempre.

Por que as vezes ele erra, e o que o sistema faz contra isso

Modelo de IA erra. Os erros típicos são: inventar um número plausível quando o dado falta, ler um dígito borrado como o número que "faz sentido", e confiar demais numa conta feita de cabeça. O sistema foi construído com defesas específicas contra cada um:

Essas defesas não vieram de manual: vieram de erro cometido. Toda vez que algo deu errado, virou uma linha de regra.

Hoje: VS Code, no computador da loja

O VS Code é um editor de texto gratuito da Microsoft, feito originalmente pra programador. Aqui ele serve como a casa do sistema: de um lado a lista de pastas e arquivos, do outro a conversa com o Claude.

Por que VS Code e não outro lugar:

• mostra as pastas e o texto dos arquivos ao lado da conversa — dá pra ver o que está sendo feito
• guarda o histórico das conversas do projeto
• deixa arrastar foto e PDF direto pra conversa
• é onde o Claude Code tem acesso completo à pasta e pode rodar scripts

O jeito de usar é sempre o mesmo: abrir o VS Code na pasta do workspace, abrir o Claude Code, digitar /iniciar e conversar em português.

Os outros lugares onde o mesmo Claude Code roda

O "por enquanto" do VS Code é real: o mesmo Claude Code existe em outros formatos, e o workspace funcionaria igual em qualquer um deles.

E o claude.ai (site e celular)?

São dois lugares diferentes, e vale não confundir:

O ponto que confunde: os conectores (Drive, Gmail) se ligam no claude.ai, mas quem usa é o Claude Code. Foi assim que o Drive entrou.

E o Codex?

O workspace foi montado pra funcionar também com o Codex (o assistente equivalente da OpenAI). Por isso as instruções ficam no AGENTS.md (padrão que os dois entendem) e o CLAUDE.md tem só uma linha apontando pra ele. Existe ainda uma "ponte" que faz o Codex enxergar as mesmas skills.

Na prática, quem trabalha aqui é o Claude Code. A compatibilidade existe pra não ficar preso a um fornecedor só — se um dia o outro ficar melhor ou mais barato, o workspace muda de assistente sem precisar ser refeito.

Peca 1 — AGENTS.md: as instrucoes permanentes

O arquivo mais importante do workspace. É lido automaticamente no começo de toda conversa, sem ninguém pedir. Contém:

• o que é o workspace e a tabela de pastas (onde salvar cada coisa)
• o resumo do negócio: endereço, telefone, marcas, garantias, equipe, condições comerciais
• o tom de voz e o que evitar na escrita
• as ferramentas conectadas e a lista de comandos
• as 8 regras da casa
• o fluxo de trabalho: verificar se existe skill antes de fazer qualquer coisa
• quando perguntar "quer que eu salve isso?"

Pense nele como o contrato de trabalho do assistente. É o único arquivo que ele nunca deixa de ler. O CLAUDE.md ao lado tem uma linha só e serve pra apontar pra ele — não se escreve conteúdo no CLAUDE.md, nunca.

Peca 2 — _contexto/: a memoria do negocio

O agora.md é o que dá continuidade ao sistema. É lá que estão as 15 pendências abertas, as decisões dos últimos 30 dias e os pontos quentes (a dívida Moura, novembro ser o mês fraco, a margem que caiu com a tabela nova). Sem ele, cada conversa recomeçaria do zero.

Regra de higiene: o que passa de uns 30 dias sai do agora.md. Ele tem que continuar curto pra continuar sendo lido.

Peca 3 — As skills: os comandos automatizados

Uma skill é um passo a passo escrito em português, guardado em .claude/skills/<nome>/SKILL.md, que o Claude segue quando o assunto aparece. Duas coisas importantes sobre elas:

1. 01 Não precisa digitar o comando. Cada skill tem uma descrição com as frases que a acionam. Dá pra digitar /conferir-notas ou simplesmente "confere as notas" — dá no mesmo. O sistema reconhece a intenção.
2. 02 São arquivos de texto comuns. Dá pra abrir, ler e corrigir uma linha. Não tem código escondido. Quando se descobre algo novo ("comparar por quantidade, não por valor"), essa frase entra na skill e passa a valer pra sempre.

As skills são a diferença entre "pedir pra IA fazer" e "ter um processo". Sem skill, todo mês seria preciso explicar de novo qual célula tem o faturamento. Com skill, basta dizer "fecha o mês".

Peca 4 — As pastas por area

Cada tipo de arquivo tem um lugar definido (a tabela completa está na seção 6). O sistema não cria pasta nova sem perguntar. Isso evita o destino natural de toda pasta de empresa: virar um monte de arquivo solto com nome parecido.

Peca 5 — Git e GitHub: o historico e o backup

Git é um sistema que guarda todas as versões de todos os arquivos. GitHub é o site onde essas versões ficam guardadas fora do computador. O workspace está em repositório privado, hoje com 8 versões salvas. O que isso dá na prática:

• Backup. Se o computador da loja morrer, o sistema inteiro volta em minutos
• Histórico. Dá pra ver como um arquivo estava mês passado e o que mudou
• Reversão. Se algo for apagado ou escrito errado, dá pra voltar atrás

Salvar é uma frase: "synca". O que não vai pro GitHub: a pasta midia/ (vídeo pesado), a pasta dados/ (rascunho) e qualquer arquivo .env (senhas e chaves). Existe também um segundo endereço configurado apontando pro kit original do curso — se o kit receber melhoria, dá pra trazer sem perder o que é da Garcia.

Peca 6 — Os conectores: as pontes pros sistemas de fora

Um conector (ou MCP) é uma ponte que dá ao Claude acesso a um serviço externo. Hoje o mais importante é o Google Drive, que permite ler a planilha viva direto de onde ela mora, sem baixar nada. Detalhe completo na seção 11.

Peca 7 — O scratchpad e os scripts

• Scratchpad — uma pasta temporária fora do workspace onde o Claude joga arquivo de trabalho (a planilha baixada pra processar, um teste). Não polui a pasta da Garcia
• Scripts — pedaços de código Python que fazem trabalho pesado com precisão. São quatro famílias hoje: o comparador de notas, o gerador de cards de produto, o gerador do catálogo impresso e a ponte de skills pro Codex. Conta feita por script é conta que não erra

Vale detalhar, porque é a parte que mais confunde quem nunca usou.

Os tres tipos de memoria

1. 01 Memória da conversa (curta). Enquanto uma conversa está aberta, o Claude lembra de tudo que foi dito nela. Fechou a conversa, acabou.
2. 02 Memória de arquivo (permanente). É o _contexto/, o AGENTS.md, as skills e todos os documentos do workspace. Essa é a memória de verdade — a que sobrevive.
3. 03 Memória pessoal do Claude Code. Um espaço de anotações do próprio assistente, fora do workspace, pra preferências que valem entre sessões. É complementar; não substitui o _contexto/.

O ciclo: /iniciar no comeco, /atualizar no fim

   Abre a conversa
        |
        v
   /iniciar  ----- le _contexto/ e AGENTS.md, e responde:
        |          "Onde paramos: ... Pendencias: ... O que quer fazer hoje?"
        v
   Trabalho da sessao (fechar mes, conferir estoque, escrever post...)
        |
        v
   /atualizar ---- varre o que mudou e escreve de volta no _contexto/
        |
        v
   /syncar ------- salva tudo no GitHub

Fechar a sessão com /atualizar e /syncar é o que faz a próxima conversa começar sabendo de tudo. Pular esse passo não quebra nada — só faz o sistema envelhecer.

O aprendizado por correcao

Além do ciclo, o sistema tem uma regra de aprendizado contínua. Quando alguém corrige algo ou dá uma instrução que parece permanente — "na verdade é assim", "prefiro assim", "sempre que…", "evita…" — o assistente pergunta:

"Quer que eu salve isso pra nao precisar repetir?"

E, se sim, escreve no lugar certo: preço e condição vão pro empresa.md; tom de voz vai pro preferencias.md; prioridade vai pro estrategia.md; regra de organização vai pro AGENTS.md.

É assim que o sistema fica mais afiado com o uso. Vários dos detalhes mais valiosos que ele sabe hoje — que o nome do arquivo da planilha não diz o mês, que a nota sai por tabela e não bate com o preço cobrado, que casco sem troca é custo daquela venda — entraram exatamente por essa porta.

Regra: arquivo novo vai na pasta correspondente. Se nenhuma servir, o assistente pergunta antes de criar pasta nova.

As duas pastas vazias de marketing/ não são esquecimento — são a área que ainda não foi trabalhada. É a maior lacuna atual do sistema, e a seção 12 explica o que já dá pra fazer nelas.

São 10 skills instaladas. Todas podem ser chamadas por /nome ou por frase solta em português.

/iniciar — abrir a sessao

Quando: no começo de toda conversa nova.

O que faz: lê os quatro arquivos de _contexto/ e o AGENTS.md e devolve um resumo curto (até 6 linhas): o negócio, o foco atual, onde paramos, até duas pendências mais relevantes e os lembretes de estilo. Se houver tarefas em tarefas.md, menciona até três. Depois pergunta o que fazer hoje.

Por que existe: é o que carrega o contexto. Sem ele, o Claude começa sabendo pouco e acaba sendo preciso explicar coisa já escrita.

/analisar-planilha — fechar o mes

Quando: no começo de cada mês, pro mês que acabou. Ou dizendo "fecha o mês", "como foi agosto", "olha a planilha nova".

O que entra: a planilha do mês. De preferência lida direto do Google Drive; se não, o .xlsx exportado, jogado em dados/.

O que ele faz, em 7 passos:

1. 01 Acha o arquivo — caminho informado → dados/ → controle/ → downloads recentes → Drive
2. 02 Lê duas vezes — uma pros valores, outra pra conferir as fórmulas
3. 03 Extrai os números do mês — faturamento, custo Moura, custo Starke, despesas por categoria, resultado, crédito Moura gerado, peças, canais, cidades, estoque
4. 04 Compara — com o mês anterior e com o mesmo mês do ano passado, usando a série histórica. Destaca tudo que variou mais de 15%
5. 05 Confere as armadilhas conhecidas — a lista de erros que já apareceram antes (custo da S50PFD, desconto da M50JD, modelo com margem negativa, crédito Moura sobrando, reposição descalibrada, marketing dividido em duas categorias, lançamento sem categoria, preço muito abaixo da tabela)
6. 06 Calcula o retorno do Google Ads — sempre em lucro bruto, nunca em receita. Receita infla o número e engana. Abaixo de 1,5x é alerta
7. 07 Escreve o diagnóstico em controle/<ano>/diagnosticos/ e acrescenta a linha do mês na série histórica

O que sai: um documento com o resultado do mês em tabela, de onde veio o dinheiro (pagamento e canal), um item numerado por achado — do mais caro pro menos — e uma tabela de recomendações com ganho e esforço. O diagnóstico de julho/2026 tem 321 linhas e é o modelo.

As três armadilhas técnicas que ele já conhece:

1. 01 A última linha das abas de estoque é TOTAL — somar a coluna inteira dobra o valor
2. 02 A planilha é export do Google Sheets: a aba 12 tem uma função que o Excel não calcula, então o ranking de produtos fica congelado. Não confiar nele — recalcular pelo Caixa
3. 03 Valor negativo nas colunas de pagamento é despesa, não estorno

A regra de ouro: conferir a conta antes de reportar. Se faturamento − custos − despesas nao bater com o resultado da planilha, achar a diferenca primeiro. No fechamento de julho a conta bateu na virgula, e e assim que todo mes precisa fechar antes de virar diagnostico.

/conferir-estoque — contagem fisica x planilha

Quando: toda manhã, na abertura. Ou dizendo "confere o estoque", "contei o estoque", "bateu?".

Como funciona na loja: cedo, antes de vender, a equipe conta as baterias na prateleira e anota na folha impressa. Como não houve movimento ainda no dia, a contagem da manhã confere contra o fechamento de ontem.

O que entra: 2 ou 3 fotos da folha, cobrindo os 88 modelos em 4 blocos — Starke (22), Moura (25), Moura Ativa/Free + Zetta + moto (28) e estacionárias (13). Pode vir foto na conversa ou da pasta de contagem no Drive.

A ordem dos passos importa, e não é preciosismo: ele lê a foto antes de abrir a planilha. Sabendo o número esperado, um dígito borrado é lido como o número esperado — e a conferência vira teatro, confirmando a planilha com a planilha.

Cuidados escritos na skill:

• alinhar número com rótulo pela altura na folha — número escrito entre duas linhas é o erro mais comum
• dígito ambíguo escreve ilegível, nunca chuta (0/6, 1/7, 5/6 e 3/8 são os que confundem)
• célula em branco não é zero automático: pode ser "tem zero" ou "não contei"
• ignorar marca de lápis apagada atrás da caneta
• caneta, nunca lápis — foto de lápis não é legível o bastante pra certificar estoque
• mostrar a transcrição antes de comparar, pra uma pessoa corrigir

O que sai: só as divergências, em tabela, com modelo, contado, planilha, diferença e qual aba e qual célula. Mais a leitura do que cada tipo de divergência significa: sobra (+) é entrada não lançada ou venda que não saiu; falta (−) é venda não lançada, garantia ou peça que saiu sem registro. Tudo guardado em controle/conferencias-estoque/AAAA-MM-DD.md.

Por que guardar todo dia: é o histórico que faz o padrão aparecer. Modelo que diverge toda semana não é ruído de contagem — é processo furado no lançamento.

Resultado da primeira rodada (18/08/2026): 84 dos 88 bateram; 4 divergiram (M60GD +1, S60FD +1, M48FD −1, MMGE 6 −1), todas confirmadas na folha.

/conferir-notas — notas emitidas x vendas do caixa

Quando: toda segunda-feira. Ou dizendo "confere as notas", "o que falta notar".

A regra do negócio: tudo que foi vendido leva nota, menos o que foi pago em dinheiro.

O que entra: o Relatório de Vendas por Produto (PDF do sistema da loja), pedido sempre do dia 1º do mês até hoje — não só da semana. O período cumulativo faz a pendência antiga continuar aparecendo até ser resolvida; quando a nota atrasada sai, ela some sozinha da lista.

As 5 regras da comparação:

1. 01 Só Tipo = Venda — entrada de nota, pagamento, garantia e compra de sucata ficam fora
2. 02 Fora tudo que é fabricante Garcia (usada, serviço, terminal) — não leva nota
3. 03 Fora as vendas 100% em dinheiro. Venda mista (parte Pix, parte dinheiro) leva nota
4. 04 Comparar quantidade, nunca valor — a nota sai por tabela e quase nunca é igual ao preço cobrado. Num mesmo modelo, o total das notas não fecha com nenhuma combinação possível das vendas do período
5. 05 Normalizar os nomes: as duas fontes escrevem diferente (MOURA M180D × M180BD, MOURA MA10-E I × MA10 - EI, Zetta que a planilha marca como fabricante Moura)

O trabalho pesado é feito por um script Python (comparar.py, 140 linhas) — conta feita por programa não erra.

O que sai: um .txt simples em controle/conferencias-notas/, só com o que falta tirar. Sem coluna de dinheiro, sem o que já está certo. A coluna de identificação da venda só aparece quando dá pra identificar; nos modelos de giro alto fica em branco — sabe-se quantas faltam, não quais.

E, por fora do arquivo, três avisos:

• Nota sem venda correspondente — pior que nota faltando: ou a venda não foi lançada, ou a nota saiu no modelo errado
• Venda sem valor lançado e célula mesclada na planilha
• Venda com observação de garantia — conferir se é venda mesmo

O que a primeira rodada (18/08/2026) achou: uma lista de notas pendentes de emissão no período, concentrada em dois modelos de giro alto, mais algumas notas sem venda correspondente na planilha — todas resolvidas na emissão seguinte, que é exatamente o que a rotina existe pra provocar.

O aprendizado que virou regra: nota emitida não quer dizer venda não-dinheiro. Houve nota com o valor exato de uma venda paga em dinheiro, enquanto a venda no Pix do mesmo modelo ficou sem nota. Por isso a conta é por modelo, e não "o que sobrou é o que faltou".

/roteiro-post — conteudo pro Instagram

Quando: "faz um post", "roteiro de vídeo", "ideia de conteúdo", "o que posto hoje".

O que ele sabe antes de escrever: os 5 ativos que a Garcia tem e quase não usa, e todo roteiro tem que puxar pelo menos um:

1. 01 4,9 estrelas com 748 avaliações no Google — prova social que concorrente nenhum de Pelotas tem
2. 02 Mais de 65 anos, desde o Zé Garcia
3. 03 Entrega e instalação em até 49 minutos, de graça
4. 04 Teste no local antes de vender
5. 05 10x sem juros de verdade — a parceria Moura zera a taxa

Os 5 tipos de post que funcionam pra loja de bateria: Ensina (quem pesquisa "bateria arriando" está a poucos dias de comprar), Prova (as avaliações), Bastidor (a saída com a bateria, os 49 minutos cronometrados), História (os 65 anos, o Zé Garcia) e Oferta — que só funciona misturada com as outras.

Formatos prontos: post de feed (as 2 primeiras linhas seguram o scroll antes do "ver mais"), Reels de até 45s com a estrutura por segundo (0–3s a dor, 4–15s o porquê, 16–35s o que a Garcia faz, 36–45s a chamada) e story de 3 a 5 telas.

As travas: preço, garantia ou condição que não estiver documentada, ele pergunta em vez de inventar. Não promete prazo diferente dos 49 minutos em horário comercial. Não generaliza garantia (24 Moura, 18 Zetta, 12 Starke). Ao comparar marcas, leva em conta a diferença de margem entre elas e respeita o teto mensal combinado com o fornecedor.

Onde salva: marketing/redes-sociais/roteiro-<assunto>-<data>.md. Depois pergunta se quer virar imagem ou carrossel.

/atualizar — guardar o que mudou

Quando: no fim de uma sessão com trabalho de verdade. Ou "atualiza o contexto", "sincroniza a memória".

O que faz: compara o estado real do projeto (pastas, skills, conectores, últimos commits, mudanças não salvas) com o que está escrito nos arquivos de contexto, e mostra um diagnóstico em três blocos: em dia / desatualizado / não configurado. Depois pede aprovação antes de aplicar.

Também escreve o agora.md a partir da conversa da sessão: onde paramos, decisões novas com data, pendências que entraram e que saíram, e o que está quente. E faz higiene — tira o que passou de 30 dias.

Regras: nunca reformatar arquivo inteiro, só a linha relevante. Não inventar. Sessão trivial não mexe no agora.md.

/syncar — salvar no GitHub

Quando: ao fim de qualquer sessão produtiva. Ou "salva no github", "synca", "backup".

O que faz: lista o que mudou, faz o commit com uma descrição curta do que foi feito e envia pro repositório. Se ainda não houvesse repositório, ele guiaria a criação. Se o envio falhar, mostra o erro em português e o que fazer.

Trava de segurança: nunca commita .env nem arquivo com chave secreta.

/mapear — criar skills novas

Quando: quando existe um processo repetitivo que ainda não virou comando. Esta é a próxima ação sugerida no agora.md e ainda não foi rodada.

O que faz: entrevista sobre o que se faz toda semana e todo mês, monta um mapa de 3 a 6 processos e organiza um por vez. Pra cada processo escolhido, verifica se já existe template pronto em templates/skills/, adapta ao contexto da Garcia e instala a skill.

É a ferramenta que faz o sistema crescer sozinho. /conferir-estoque e /conferir-notas são exatamente o tipo de coisa que sai daqui.

/novo-projeto — abrir um projeto com contexto proprio

Quando: cliente novo grande, site novo, produto novo — qualquer trabalho que mereça pasta e contexto separados.

O que faz: entrevista rápida (nome, tipo, escopo, prazo/orçamento/ferramentas), sugere onde criar a pasta, gera o AGENTS.md do projeto e registra na estrutura do AGENTS.md principal.

/setup — a configuracao inicial

Rodou uma vez, em 30/07/2026, e foi o que criou o workspace: a entrevista inicial, o AGENTS.md, os arquivos de _contexto/, a estrutura de pastas e a lista de conectores recomendados. Fica no sistema como registro e pra caso de reconfiguração.

As skills de reserva

Em templates/skills/ existem 9 skills prontas que ainda não foram instaladas, esperando o /mapear adaptar: carrossel, publicar-instagram, publicar-site, slide, proposta-comercial, email-profissional, analisar-dados, roteiro-post (a versão genérica) e o catálogo de skills externas.

E existem skills que já vêm de fábrica no Claude Code e funcionam aqui sem instalar nada — trabalhar com PDF, Word, Excel e PowerPoint, design de interface, criação de gráficos, canvas de design.

O sistema hoje tem quatro ritmos:

Fora isso, por demanda: conteúdo (/roteiro-post), projeto novo (/novo-projeto), skill nova (/mapear) e qualquer pergunta sobre o negócio — que o sistema responde lendo os arquivos, sem precisar abrir planilha.

Esta é a parte que mais vale, e a que ninguém vê de fora. Não são só arquivos: é a empresa entendida.

9.1 A planilha, decifrada

controle/mapa-da-planilha.md documenta as 14 abas integradas por mais de 400 fórmulas SUMIFS, a arquitetura (tudo nasce da aba 01 - Caixa, o resto é leitura), a estrutura de cada coluna do Caixa e onde nasce cada número do Resumo.

Três coisas que só se sabe porque foram descobertas na marra:

1. 01 O nome do arquivo não diz o mês. 08 - JULHO .xlsx tem dados de agosto/2025
2. 02 A planilha mudou de formato 4 vezes em 29 meses. Cada geração pede leitura diferente
3. 03 Nas gerações antigas, FATURAMENTO BRUTO quer dizer lucro bruto e FATURAMENTO LIQUIDO quer dizer resultado. Quem ler o rótulo literal erra por 3x

A conclusão registrada em 29/07/2026: não trocar a planilha. Ela é boa. O problema é dado faltando e erro de cadastro.

9.2 A serie historica

controle/historico-mensal.md + .csv: fev/2024 a jul/2026, mês a mês, com peças, ticket, faturamento, custo, lucro bruto, margem bruta, despesas, resultado e margem líquida. Cada linha saiu da planilha daquele mês, não de estimativa. Faturamento e custo batem na vírgula com os totais das próprias planilhas nos 12 arquivos de 2025/26.

Nenhum dos três é ano cheio, então os totais não se comparam de forma direta. O que compara é a média mensal — e é ela que está na tabela acima, cada ano medido contra 2024.

O que ela mostra:

• 2026 é o melhor ano da história recente — margem líquida em torno de 2,5× a de 2024, com faturamento médio mensal 27% maior
• E não é por volume. A loja vende menos peças e ganha mais: o ticket médio subiu 65% em dois anos
• Despesa é o que derruba a loja, não preço. Nos 7 meses negativos da série a margem bruta estava dentro da faixa normal. O que estourou foi despesa
• Novembro é o mês fraco do ano — fechou no vermelho em 2024 e de novo em 2025. Dá pra preparar com 3 meses de antecedência

Três meses não existem, e está explicado: janeiro/2024 (o registro começa em fevereiro), julho/2025 (arquivo perdido) e dezembro/2024 (caixa incompleto, fora dos totais).

9.3 A conta corrente com a Moura

controle/divida-moura.md reconstrói a conta corrente com o fornecedor desde set/2023 — 368 notas de compra, 91 pagamentos, mês a mês.

Por que cresce: mês após mês a loja compra mais do que o cartão gera de crédito, e a diferença é constante. Não é problema de venda — é de compra.

E uma descoberta que virou pendência: a planilha não tem célula de saldo devedor. A dívida não aparece em lugar nenhum. Basta criar =E489-F489 na aba 05 - Controle Moura.

9.4 O catalogo e os precos

Dois arquivos, um interno e um pro cliente, montados a partir dos PDFs de custo exportados em 04/08/2026:

• empresa/catalogo-de-produtos.md — interno, 88 modelos com preço, custo, margem, estoque, peso e venda do mês. Não vai pro cliente
• atendimento/tabela-de-precos.md — só preços, pode ser consultado na frente do cliente
• atendimento/catalogo-impresso/ — o catálogo de balcão plastificado, gerado por script, pronto pra imprimir em A4 frente e verso

O que a tabela nova de agosto significou, calculado e registrado: o preço de venda caiu em várias linhas enquanto o custo de compra subia, e o efeito combinado derrubou a margem das duas marcas principais. No volume do mês anterior isso é uma queda de dois dígitos no lucro bruto mensal — pra empatar seria preciso vender uns 17% mais peças. É uma decisão de preço legítima, mas agora com o custo dela na mesa.

9.5 A identidade visual

marca/design-guide.md foi reescrito a partir do arquivo do logo, com todas as cores medidas e todos os contrastes calculados — nenhum número é chute. Define paleta (Azul Garcia #041B94, Vermelho Garcia #DC231D, fundo carvão #0E1114), tipografia (Archivo, com a configuração de cada uso), os quatro elementos gráficos assinatura, a anatomia da peça 4:5 e uma lista firme do que nunca fazer.

Duas descobertas técnicas que evitam erro: uma cor não faz dois papéis (o vermelho da marca reprova em contraste como texto, mas passa como preenchimento — por isso existem dois vermelhos), e o PDF do logo não é vetor: serve pra Instagram e site, não serve pra fachada nem adesivo de carro.

Existe também um gerador de cards em Python que produz card de produto 1080×1080 na identidade da marca, com o recorte da foto da bateria — pronto pro WhatsApp.

9.6 O plano de CRM

clientes/cadastro-de-clientes.md é um plano completo e ainda não executado: 3 colunas novas na aba Caixa (N=Cliente, O=Telefone, P=Veículo) mais uma coluna Q que calcula sozinha a data da próxima troca, somando 30 meses à venda.

O detalhe que mostra o cuidado: as colunas vão à direita da M, e não no meio, porque a planilha tem mais de 400 fórmulas que apontam pra colunas por letra — inserir no meio mexeria em tudo. Depois da M, o risco é zero.

Inclui o roteiro do balcão (a frase da garantia, que é verdadeira e o cliente ganha com ela), o momento certo de perguntar (enquanto a maquininha processa), as regras pra equipe (nunca deixar de fechar a venda por causa do cadastro) e a conta que justifica tudo: toda venda vinda do Google carrega um custo de anúncio; a mensagem pro cliente antigo custa zero.

9.7 O caminho das integracoes

operacao/conectar-sistemas-ao-claude.md avaliou 7 sistemas, um por um, com esforço e recomendação honesta. Inclusive as respostas negativas: Nubank PJ não tem API e não vai ter — esqueça. E Meta Ads não agora: conectar ferramenta antes de ter o que anunciar é resolver o problema errado.

As 8 regras do AGENTS.md valem em toda conversa. Nenhuma é decorativa — cada uma nasceu de um risco real.

A regra 4 merece nota. A planilha viva está no Drive, compartilhada pelo contador. Nenhuma alteração nela sem confirmação — nem uma célula, nem pelo conector. Qualquer cópia local em controle/ é foto de um momento, nunca a fonte.

E existe uma regra de estilo que evita o pior defeito de assistente de IA:

Se um achado contradisser algo que ja escrevemos, dizer isso na cara e corrigir o arquivo antigo.

O diagnóstico de julho tem uma correção pública dentro dele: uma venda de Z100E foi lançada como Starke sendo Zetta, e a divisão de margem por marca publicada antes estava errada. Está lá, escrito, com a correção. Sistema que esconde erro próprio não serve pra decidir nada.

Ligado hoje

Avaliado e nao ligado

A pendencia que trava o fluxo mais bonito

O conector do Drive está ligado numa conta, e a planilha do contador não aparece nela. Enquanto isso, o fechamento do mês depende de exportar o .xlsx na mão. Resolver isso é compartilhar a planilha com esse e-mail — está em tarefas.md e é a tarefa de maior retorno por minuto gasto no sistema inteiro.

Isto não é futuro. É capacidade instalada, esperando ser pedida.

Sobre numeros e controle

• Responder qualquer pergunta de histórico sem abrir planilha: "quanto vendemos em março do ano passado?", "novembro sempre é ruim?", "qual foi o melhor mês de todos?"
• Projetar o fechamento do mês em andamento a partir do que já foi lançado
• Comparar dois meses ou dois anos quaisquer, com o porquê da diferença
• Calcular o impacto em dinheiro de qualquer mudança de preço, antes de aplicar
• Varrer as abas de custo inteiras procurando modelo com margem negativa
• Simular a migração Moura → Starke e dizer quantas peças/mês faltam
• Acompanhar mês a mês o crédito Moura gerado contra o custo Moura consumido
• Montar a lista das empresas que compram no boleto a partir dos lançamentos dos últimos 6 meses

Sobre marketing e conteudo

• Roteiro de post, Reels e story, na voz certa e com preço conferido
• Card de produto 1080×1080 na identidade da marca, pronto pro WhatsApp
• Página na internet com link compartilhável (é o que já foi feito com o painel histórico e a referência visual da marca)
• Calendário de conteúdo do mês
• Texto de anúncio do Google, usando os ativos que a loja não usa
• Roteiro de pedido de avaliação no Google logo após a instalação

Sobre atendimento e operacao

• Scripts de WhatsApp pra cada situação: pedido de modelo, orçamento, garantia, follow-up
• Respostas padrão pras dúvidas que se repetem
• Checklist de abertura e fechamento da loja
• Atualizar o catálogo impresso quando o preço mudar (mexe num arquivo, roda um comando, sai o PDF)
• Documentar qualquer processo que hoje só existe na cabeça de alguém

Sobre o proprio sistema

• Criar skill nova pra qualquer rotina que se repita (/mapear)
• Ler qualquer arquivo jogado em dados/ — planilha, PDF, foto, texto — e analisar

A lacuna mais visível hoje: as duas pastas de marketing/ estão vazias. É a área com mais capacidade instalada e menos uso.

Igualmente importante. Um sistema honesto sobre os próprios limites é um sistema em que dá pra confiar.

E um limite técnico que aparece na prática: a planilha é grande demais pra ser lida de uma vez (cerca de 72 mil caracteres). Por isso as skills de conferência têm um passo específico de salvar o conteúdo em arquivo e processar com Python.

Organizado por horizonte, do mais fácil e mais próximo ao mais ambicioso. Nada aqui é promessa — é mapa de possibilidade, com o esforço honesto de cada um.

Horizonte 1 — semanas, sem depender de ninguem de fora

Horizonte 2 — meses, ainda dentro do que ja existe

• O CRM ligado de verdade. Com as colunas N/O/P/Q preenchidas, a coluna Q começa a apontar datas e nasce uma rotina nova: toda semana, filtrar quem está fazendo 30 meses e mandar mensagem. Uma skill de "clientes pra chamar esta semana" sai direto disso
• Painel do mês que se atualiza. Uma página na internet com os números do mês, republicada a cada fechamento. O painel histórico já provou que funciona
• Alerta de reposição inteligente. Cruzar estoque com a média de venda de cada modelo e dizer o que vai faltar em 15 dias — em vez do estoque desejado descalibrado, que chega a pedir quase vinte vezes o giro mensal de um item
• Skill de preparação do novembro. O mês fraco é previsível: fechou no vermelho em 2024 e em 2025. Em agosto já dá pra preparar
• Acompanhamento do Google Ads mês a mês, com o retorno calculado em lucro bruto, não em receita
• Biblioteca de conteúdo. 30 roteiros de post prontos, organizados por tipo, pra nunca mais parar por falta de ideia
• Rotinas agendadas. O Claude Code sabe rodar tarefa em horário marcado. Dá pra deixar a conferência de notas nascer sozinha toda segunda de manhã, com a lista esperando

Horizonte 3 — projetos maiores, cada um com sua condicao

Horizonte 4 — o que o sistema pode virar

Vale dizer em voz alta onde isso pode chegar, porque a trajetória já está desenhada:

O que era só planilha virou histórico. O histórico virou diagnóstico. O diagnóstico está virando rotina. O próximo salto natural é a rotina virar antecipação: em vez de descobrir em dezembro que novembro foi ruim, saber em agosto que novembro vem e preparar. Em vez de descobrir o saldo com a Moura quando ele já está grande, ver ele crescer todo mês.

E o salto depois desse é passar de um usuário pra quatro. Hoje o sistema é uma conversa entre uma pessoa e o Claude. Quando a equipe puder perguntar o preço da M70KD pelo celular e lançar o cadastro do cliente sem abrir planilha, o sistema deixa de ser a memória de uma pessoa e passa a ser a memória da empresa — que é onde ele foi feito pra chegar.

Custo

O sistema custa a assinatura do Claude. VS Code é gratuito, Git e GitHub são gratuitos (o repositório privado não custa nada), Python é gratuito e os scripts rodam local.

O que custaria mais, se fosse ligado: serviços de terceiros com API paga (Cora Pro, geração de imagem por IA em volume, publicação automática em rede social). Nenhum deles é necessário pro que o sistema faz hoje.

Comparação que vale registrar: o sistema inteiro custa, por mês, menos do que a loja gasta em anúncio pra trazer um punhado de vendas.

Seguranca

Três princípios registrados no documento de conectores, que vale repetir:

1. 01 Conecte só o que você usa. Não conecte "por via das dúvidas"
2. 02 Desconectar é fácil. Se ficar desconfortável, desconecte
3. 03 Nada de banco por serviço terceiro. Conector oficial, tudo bem. Empresa desconhecida pedindo a senha do banco, não

Privacidade do cliente

O plano de cadastro já traz as regras: usar o contato só pra garantia e aviso de troca; nunca vender ou repassar lista; se o cliente pedir pra sair, apaga; e manter o compartilhamento da planilha restrito à equipe, sem link público.

A manutenção de fundo é uma só: manter o agora.md curto e verdadeiro, e não deixar sessão de trabalho terminar sem /atualizar e /syncar.