Guia do ambiente TCP

Apresentação

Como usar a pasta de um cliente para perguntar sobre a empresa e receber o número real, tirado direto do sistema dela — sem saber SQL e sem conhecer o ERP.

Este guia vale para qualquer cliente. O que é específico do seu cliente está em dois arquivos da própria pasta: o GUIA-DO-TIME.md (por onde começar, quem procurar, o que é particular daquela empresa) e o docs\empresa-<nome-do-cliente>.md (a empresa, os números de referência e as armadilhas).

Com pressa? Leia as partes 2 (o aplicativo), 4 (primeira vez) e 5 (um dia de trabalho) e guarde o cartão da última página. O resto você consulta quando precisar.

Como ler este guia:

• <nome-do-cliente> é o nome do cliente como aparece nos nomes de arquivo: minúsculas, sem acento e sem espaço. Exemplo: cliente-exemplo, e o documento da empresa fica docs\empresa-cliente-exemplo.md.
• "A pasta" é a pasta do cliente, a mesma para todo o time. Você a abre sempre pelo Google Drive — Drive compartilhado TCP - Ambiente Claude > Clientes > <cliente>, em que <cliente> é o nome da pasta do cliente — e sempre pelo mesmo caminho.
• <seu-slug> é o começo do seu e-mail da TCP, em minúsculas (ex.: ac). É o nome das suas subpastas na pasta do time; <slug> é o de qualquer analista.
• Os nomes de botões e menus do aplicativo mudam de uma versão para outra. Quando o nome em inglês ajuda, ele vem entre parênteses.

As pessoas citadas no guia:

Precisa falar com alguém da TCP? Fale com o Alfredo. Quem responde pelo trabalho em cada cliente está na seção "Quem procurar" do GUIA-DO-TIME.md da pasta; dúvida de negócio e contatos no cliente ficam no CLAUDE.md, seção "Escopo".

1. O que é isto — e o que não é

É uma pasta de trabalho por cliente, a mesma para todo o time, que junta quatro coisas:

1. O Claude, um assistente de inteligência artificial que conversa em português e sabe usar a pasta.
2. Uma conexão somente leitura com o banco de dados do ERP do cliente. ERP é o sistema de gestão da empresa; nos nossos clientes, em geral o Protheus, da TOTVS. O Claude escreve a consulta, roda no banco e traz o número.
3. Tudo o que já se sabe sobre o cliente: quem é a empresa, como ela opera, onde cada informação mora no sistema, os números de referência e as armadilhas que fazem um número parecer certo e estar errado.
4. Regras e comandos iguais para todos os clientes (os comandos /tcp-...): começar e terminar o trabalho, conferir um número antes de ele sair, gerar planilhas, salvar um relatório que você repete.

Como uma pergunta vira resposta:

1. Você pergunta em português: "quanto a empresa faturou em agosto, por categoria?".
2. O Claude lê as regras e as armadilhas daquele cliente.
3. Ele escreve a consulta ao banco (em SQL — você não precisa ler) e roda, só lendo.
4. Confere a ordem de grandeza com os números de referência do cliente.
5. Responde com o número e as premissas: o que entrou, o que ficou de fora, o período e qual data.
6. Grava a consulta na pasta e registra o que aprendeu, para a próxima vez. A consulta só é gravada em sql\ depois de rodar no banco: o programa que grava roda de novo e anota no cabeçalho quando rodou e quantas linhas trouxe.

Somente leitura quer dizer: dá para consultar tudo e não se altera nada no sistema do cliente. O login do banco deve ser só de leitura (o teste de conexão confirma com leitura apenas: SIM). E mesmo quando o login permite mais, o Claude só lê: é regra do ambiente. Você não corre o risco de apagar ou mudar dado da empresa.

A pasta do time. A pasta de cada cliente fica no Drive compartilhado TCP - Ambiente Claude, do Google Workspace da TCP, e é uma só para o time inteiro (4 a 6 pessoas, cada uma no seu computador, pelo Google Drive). Não existe cópia por pessoa: nada a copiar, nada a entregar. O que um grava, os outros leem — e todos da TCP enxergam o Drive do ambiente (política da casa). Para isso funcionar, cada um grava no que é seu (os seus checkpoints, as suas planilhas e a cópia da sua memória ficam em subpastas com o seu slug), e o que é de todos (docs\, CLAUDE.md) o Claude altera por trecho, relendo antes — as consultas de sql\ só entram pelo programa que as grava depois de rodar no banco (parte 17). Você abre a pasta sempre pelo Google Drive, e sempre pelo mesmo caminho (parte 2).

O que isto não é

2. Antes de tudo: o aplicativo

Você usa o Claude para desktop, no Windows. O aplicativo tem três abas no alto: Chat, Cowork e Code. Aqui se usa só a Code — o Claude Code. É ela que abre a pasta, lê os documentos e roda os programas que consultam o banco. O Chat e o Cowork não servem para este trabalho.

• Baixe só do site oficial: claude.com/download. Desconfie de qualquer outro endereço.
• Precisa de um plano pago que inclua o Claude Code (Pro, Max, Team ou Enterprise). O plano gratuito não serve. Qual conta e qual plano usar, combine com o Alfredo.
• Cada pessoa usa a própria conta. Não entre com a conta de outra pessoa e não empreste a sua.

Os nomes dos botões mudam entre versões do aplicativo. Se não achar exatamente o nome citado aqui, procure o botão que faz a mesma coisa.

Abrir uma conversa na pasta do cliente

1. Abra o Claude (menu Iniciar > Claude).
2. Clique na aba Code, no alto. Se o aplicativo pedir para assinar um plano, pare e fale com o Alfredo.
3. Comece uma conversa (sessão) nova. Antes de escrever, perto da caixa de texto:
   • onde rodar: escolha Local (no seu computador). Não use Cloud nem SSH: eles rodam em outro computador, sem a pasta e sem a VPN;
   • clique em Selecionar pasta (Select folder) e escolha a pasta do cliente no Google Drive: a unidade do Google Drive (geralmente G:) > Drives compartilhados (Shared drives) > TCP - Ambiente Claude > Clientes > a pasta do cliente — a principal, que tem CLAUDE.md, docs, sql, scripts e relatorios dentro. Não escolha uma subpasta (como docs) nem as de cima (TCP - Ambiente Claude ou Clientes). Abra sempre pelo mesmo caminho: o Claude guarda a memória e a lista de conversas pelo caminho da pasta. Na primeira vez, o Claude pergunta se você confia na pasta: confie.
4. Confira a pasta (abaixo) e digite /tcp-comecar-trabalho.

Como conferir em que pasta a conversa está

• O nome da pasta aparece na própria conversa: no topo ou perto da caixa de texto, conforme a versão.
• Digite /tcp na caixa de texto, sem apertar Enter, e olhe a lista que aparece. Tem que haver comandos /tcp-.... Se não houver nenhum, a conversa está na pasta errada. Depois apague o que digitou (o Enter executaria o item destacado da lista).
• Na dúvida, pergunte: "em que pasta você está trabalhando?".

Parar ou corrigir o Claude no meio

• Parar na hora: clique no botão de parar, perto do botão de enviar, ou aperte Esc. O que já foi gravado na pasta fica.
• Corrigir o rumo sem parar: escreva a correção e aperte Enter. Ele lê e ajusta.

Uma conversa de trabalho por pasta

Trabalhe sempre na mesma conversa desta pasta — de um dia para o outro, de um assunto para o outro, e também depois de uma atualização do ambiente. Ela fica na lista lateral do aplicativo: é só clicar nela para continuar.

Duas conversas suas ao mesmo tempo, na mesma pasta, dão problema: uma pode desfazer o que a outra gravou, e cada uma pode estar numa versão diferente do ambiente. Já os colegas, cada um com a sua conversa no computador dele, não atrapalham: cada um grava no que é seu (parte 1).

Fechar a janela não fecha o Claude. Ele continua rodando perto do relógio do Windows (na bandeja), e as conversas seguem trabalhando.

Quando uma mudança passa a valer

Se algo novo não aparecer, siga esta escada, nesta ordem — e em nenhum degrau troque de conversa:

1. Peça ao Claude: "relê as regras do ambiente". Ele relê ali mesmo.
2. Se ainda não funcionar, saia do Claude pelo ícone perto do relógio (bandeja do Windows; se o ícone não estiver visível, clique na setinha ^): botão direito > Sair. Abra o Claude de novo e continue na mesma conversa (clique nela na lista lateral). Sair interrompe as conversas que estiverem trabalhando.
3. Último recurso: reiniciar o computador e continuar na mesma conversa.

3. O que a máquina precisa

O /tcp-ambiente confere quase tudo desta lista e avisa o que falta — só avisa, não instala nada. Os instaladores e o passo a passo ficam numa pasta só do Drive: _app\ (no Drive compartilhado TCP - Ambiente Claude, ao lado de Clientes), com o arquivo LEIA-ME.md. Dois cliques no instalador e pronto; o que precisa de administrador (ODBC, Excel, o próprio Google Drive), peça ao Alfredo.

Instalar programa é com você (se o seu computador permitir) ou com o Alfredo, nunca com o Claude. Se o Claude propuser instalar algo (por exemplo, pip install ou um instalador), negue (parte 14).

No Mac

Desde a v2.1.0 o ambiente roda no Mac, com o PowerShell 7 (os mesmos scripts do Windows). O passo a passo está no _app\LEIA-ME.md, parte "No Mac". Em resumo:

• Precisa: Google Drive (as pastas ficam no Finder, em Google Drive > Drives compartilhados), PowerShell 7.4+, o atalho powershell (um comando no Terminal — é o nome que os automáticos chamam; sem ele, nada automático roda) e Python 3 + openpyxl (python3).
• Funciona igual: o registro automático, a memória espelhada no Drive, os avisos de versão, consultar o banco (somente leitura), gravar SQL com cabeçalho, registrar melhoria, a planilha estática e todos os comandos /tcp-....
• Não funciona no Mac: a planilha conectada (gerar e atualizar usam o Excel do Windows por automação), o PDF do relatório (gerar-pdf) e o OCR de contrato escaneado (usa o OCR do Windows) — os programas recusam com uma mensagem clara. No Mac, use a estática; a conectada e o PDF, um colega gera no Windows; o contrato escaneado, o Claude lê pela imagem das páginas na conversa (mais devagar; o que for lido assim entra no quadro com confiança "baixa" — o Claude confere cada valor na imagem antes de registrar). Com o pacote pypdfium2 no Python do Mac (parte 3), a imagem é a página inteira, como o leitor de PDF mostra; sem ele, só a imagem guardada dentro do PDF, que às vezes vem sem o texto.
• Credenciais: o credenciais.ps1 se edita no TextEdit, com Editar > Substituições > Aspas Inteligentes desligado (senão as aspas viram curvas e o arquivo quebra).

4. Primeira vez nesta máquina

A pasta do cliente já está no Drive do ambiente: não há nada a receber nem a copiar. E não há cadastro nem instalação do ambiente: na primeira conversa, o Claude reconhece você pela sua conta.

1. Tenha o Google Drive com o Drive do ambiente.

   O Google Drive para computador tem de estar instalado, aberto e conectado na sua conta @tcp-partners.com, com acesso ao Drive compartilhado TCP - Ambiente Claude (para pedir o acesso, ou ajuda para instalar o programa, fale com o Alfredo).

2. Entre no Claude com a sua conta da TCP (nome@tcp-partners.com).

   É por ela que o ambiente sabe quem você é. Na primeira conversa numa pasta de cliente, o Claude guarda neste computador (em %LOCALAPPDATA%\tcp\, fora da pasta do time) o seu slug — o começo do seu e-mail, que dá nome às suas subpastas — e avisa em uma linha que registrou você. Não há lista nem cadastro: ninguém precisa incluir você. Se a conta do Claude neste computador não for a da TCP, o Claude avisa: saia e entre com a da TCP.

   Quer conferir se o computador tem o que as planilhas precisam (Python, openpyxl, Excel, ODBC Driver 17 — parte 3)? Numa conversa aberta, digite /tcp-ambiente. Não é obrigatório: ele só avisa o que falta, nunca instala.

3. Deixe as pastas do ambiente disponíveis off-line. No Google Drive, botão direito > Acesso off-line > Disponível off-line (no Windows 11, clique antes em "Mostrar mais opções"; o nome pode variar com a versão do Drive) em: a pasta do cliente; em Clientes, a pasta .claude e o arquivo CLAUDE.md (são o padrão do ambiente — sem eles a conversa não tem as regras nem os comandos); e a pasta _padrao, na raiz do Drive compartilhado (marca, fotos e modelos de apresentação). Assim os arquivos abrem mesmo com o Drive lento ou fora do ar, e nada fica "só on-line" atrasando os programas e o Excel. O Google Drive não deixa nenhum programa fazer isso por você: o /tcp-ambiente (ou escreva conferir o ambiente) confere e ajuda. O Claude em si precisa de internet.

4. Confira os requisitos da parte 3 — principalmente a VPN, se o cliente exigir.

5. Abra uma conversa na pasta do cliente, pelo Google Drive, e digite /tcp-comecar-trabalho.

   Escolha a pasta do cliente no Google Drive (parte 2) e, quando o Claude perguntar se você confia na pasta, confie — sem isso, os automáticos da pasta não rodam. No começo da conversa, a memória que você já tinha sobre o cliente (de outro computador) volta sozinha. O /tcp-comecar-trabalho confere o ambiente deste computador, relê a memória e o que o time registrou e testa o banco.

   Se o banco não conectar, o Claude diz o motivo: NAO FOI POSSIVEL CONECTAR AO BANCO. é quase sempre a VPN desligada (normal na primeira vez); uma mensagem sobre o scripts\credenciais.ps1 é campo sem preencher ou erro de digitação no arquivo (passo 6); RECUSOU O LOGIN é usuário ou senha não aceitos (parte 19).

6. Se faltar a senha do banco, preencha no Bloco de Notas — nunca no chat.

   O scripts\credenciais.ps1 é um só para todo o time: se já está preenchido e conectando, ninguém precisa mexer (se ele nem existir, avise o Alfredo: a pasta nasce com ele — a não ser a pasta sem ERP, de diagnóstico só com documentos, que não tem banco nem credenciais). O Claude avisa quando ele não está preenchido. Nesse caso:

   1. No Explorador de Arquivos, abra a pasta do cliente no Google Drive (TCP - Ambiente Claude > Clientes > <cliente>) e depois a pasta scripts. Há dois arquivos parecidos: credenciais e credenciais.exemplo (o Windows costuma esconder o final .ps1). Use o que se chama só credenciais — o outro é o modelo e não se preenche.

   2. Botão direito em credenciais > Abrir com > Bloco de Notas. No Windows 11 pode ser preciso clicar antes em "Mostrar mais opções". Não dê dois cliques no arquivo.

   3. As linhas que começam com # são explicações: leia se quiser, mas não mexa nelas. No fim está o bloco que importa, com quatro campos:

      $TcpDb = @{
          Server   = '<host,porta>'
          Database = '<nome do banco>'
          User     = '<usuario de leitura>'
          Password = '<senha>'
      }

   4. Em cada campo, troque só o que está entre as aspas simples — inclusive os sinais < e > — pelos dados de acesso que te passaram. Mantenha as aspas. Exemplo com dados inventados:

      No modelo	Preenchido
      Server = '<host,porta>'	Server = '192.0.2.10,1433' (endereço e porta, separados por vírgula)
      Database = '<nome do banco>'	Database = 'ERP_PRODUCAO'
      User = '<usuario de leitura>'	User = 'leitura_tcp'
      Password = '<senha>'	a senha, entre as mesmas aspas. Se ela tiver apóstrofo ('), escreva-o duas vezes: a senha ab'cd fica 'ab''cd'

   5. Salve (Ctrl+S), feche o Bloco de Notas e volte à conversa.

   6. Digite pronto. O Claude testa a conexão (sem abrir o arquivo) e diz se deu certo.

   7. Se a resposta for scripts\credenciais.ps1 tem erro de digitacao (linha N), volte ao Bloco de Notas e corrija essa linha: quase sempre é uma aspa que falta ou sobra. O número da linha aparece no rodapé do Bloco de Notas (Ln); se o rodapé não aparecer, ative em Exibir > Barra de status. Salve e diga "pronto" de novo.

   Formato antigo. Em arquivos mais antigos, o bloco começa só com @{, sem o $TcpDb = na frente. Funciona, mas tem um defeito: se o arquivo for executado por engano (por exemplo, com "Executar com PowerShell"), ele mostra a senha na tela. Por isso, o teste de conexão avisa com AVISO: scripts\credenciais.ps1 esta no formato antigo. A correção é uma linha só: no Bloco de Notas, escreva $TcpDb = na frente do @{ (a linha fica $TcpDb = @{), salve e diga "pronto". Não mexa em mais nada. No formato novo, o arquivo executado por engano não mostra nada na tela — nem a senha.

   Nunca digite nem cole a senha na conversa. No arquivo, a senha fica num lugar só, conhecido. Na conversa, ela se espalha: fica no histórico do Claude neste computador e pode acabar em resumos, na memória e nos checkpoints, que vão para o Drive. O Claude também não abre esse arquivo (as permissões da pasta bloqueiam): os programas da pasta leem a senha sozinhos. Se ele pedir a senha no chat, não passe: diga que vai preencher no Bloco de Notas. Colou sem querer? Veja "Errei, e agora?" na parte 18.

   Se o teste falhar, a mensagem diz o motivo (senha recusada, erro de digitação no arquivo, VPN): veja a tabela da parte 19.

7. Leia o resumo — e continue nesta mesma conversa.

   O Claude responde em poucos tópicos, como neste exemplo (valores inventados):

   Analista desta máquina: ac. Pasta na versão publicada do
   ambiente; automáticos funcionando. É a sua primeira vez nesta
   pasta: li o documento da empresa e os checkpoints do time (dois
   colegas trabalharam em estoque e faturamento esta semana).
   Banco: conectou (leitura apenas: SIM). Falta nesta máquina: o
   ODBC Driver 17. O que fazemos hoje?

   Por trás, toda conversa começa com uma linha de estado que o Claude lê sozinho: AMBIENTE TCP v… | cliente: … | analista desta maquina: <seu-slug> … (para quem mantém o ambiente, o nome termina com - mantenedor do ambiente), seguida dos fatos do time — o que cada colega registrou para os outros. Na primeira conversa do computador, ela diz que registrou você. Se ela faltar, ou disser que você não foi registrado, o Claude avisa o que fazer (parte 19).

   Essa passa a ser a sua conversa de trabalho nesta pasta. Se algo do ambiente não aparecer, siga a escada da parte 2 — sem trocar de conversa.

Outro computador? Faça nele os passos 1 a 3 e abra uma conversa na mesma pasta, pelo Google Drive daquele computador. A memória que o Claude tinha sobre o cliente volta sozinha no começo da conversa, a partir da cópia dela na pasta do time (memory\Analistas\<seu-slug>\). A conversa em si não vai junto: fica no computador em que foi aberta.

5. Um dia de trabalho

A rotina tem seis passos:

1. Abra a sua conversa de trabalho desta pasta (na lista lateral do aplicativo — é sempre a mesma; na primeira vez, abra uma na pasta do cliente).
2. Digite /tcp-comecar-trabalho. O Claude confere o ambiente deste computador, relê a memória, o documento da empresa, os seus três últimos registros de sessão (checkpoints) e o mais recente de cada colega, e testa o banco. Responde em até seis tópicos — onde o seu trabalho parou, o que o time fez desde então, o que está pendente, se o banco respondeu, se há aviso do ambiente — e pergunta o que você quer fazer.
3. Faça o pedido (parte 7).
4. Confira as premissas da resposta (parte 8). Faltou alguma? Peça.
5. Vai sair da pasta (reunião, e-mail, diretoria, cliente)? Peça "roda o checklist nisso" (parte 11).
6. Ao encerrar, digite /tcp-terminar-trabalho. Ele atualiza a memória e os documentos, confirma a cópia da memória na pasta do time e grava, na sua subpasta, um checkpoint com o que foi feito, os números entregues com as premissas e o que ficou pendente. É esse registro que o /tcp-comecar-trabalho lê da próxima vez — o seu e o dos colegas. No resumo final, ele também mostra:
   • os rascunhos locais (consultas de teste, CSV de conferência) que ficaram fora do Drive, em %TEMP%\tcp\<nome-do-cliente>\: apague você as pastas de assuntos encerrados, porque costumam ter dado do cliente (no Explorador de Arquivos, cole %TEMP%\tcp\<nome-do-cliente> na barra de endereço). O Claude não apaga arquivos;
   • os 📤 candidatos ao padrão, se houver: já registrados sozinhos no Drive (_melhorias\, na raiz) para quem mantém o ambiente — você não repassa nada (parte 16).

Um assunto por vez, na mesma conversa. Conversa que mistura tudo fica lenta, e o Claude começa a confundir as premissas de um assunto com as do outro. Ao trocar de assunto: /tcp-limpar-contexto e depois /clear (a conversa recomeça limpa, continua sendo a mesma), e /tcp-comecar-trabalho.

Quando a conversa fica longa

Os sinais: respostas demoradas, o Claude esquecendo o que foi combinado no começo, ou ele mesmo sugerindo limpar. Faça assim:

1. Digite /tcp-limpar-contexto. Ele grava tudo — memória, documentos, arquivos e um checkpoint com "onde paramos" — e mostra um bloco curto para retomar.
2. Depois escolha:
   • /compact — resume a conversa e continua nela. Use se vai seguir no mesmo assunto.
   • /clear — zera o histórico e recomeça limpa, na mesma conversa; em seguida, /tcp-comecar-trabalho. Use para mudar de assunto.

/compact e /clear são comandos do próprio aplicativo. Ele também pode compactar sozinho quando a conversa enche; nesse caso, um checkpoint automático é gravado antes (parte 16). Mesmo assim, rodar o /tcp-limpar-contexto antes é mais seguro: o resumo automático pode perder detalhes.

Levar o assunto para outra conversa (exceção)

O normal é ficar sempre na mesma conversa. Só se ela ficar longa demais mesmo depois do /compact, /tcp-prompt-nova-conversa <assunto> (ex.: /tcp-prompt-nova-conversa estoque) gera um bloco de texto para colar numa conversa nova, já com o contexto do assunto. A partir daí, a conversa nova passa a ser a sua única conversa de trabalho nesta pasta — não volte a trabalhar na antiga, nem use as duas ao mesmo tempo. Nunca faça isso por causa de uma atualização do ambiente.

6. Os comandos

Para ver a lista, digite /tcp na caixa de texto sem apertar Enter e olhe o que aparece (o Enter executa o item destacado). Para rodar um comando, digite o nome inteiro e aperte Enter. Só os três primeiros são do dia a dia. Também dá para escrever a frase, sem a barra: "começar trabalho", "terminar trabalho", "limpar contexto" ou "conferir o ambiente" fazem o Claude rodar o mesmo comando — ele só roda quando você pede.

Para ver as rotinas (do time inteiro), digite /tcp-rotina (sem Enter): aparecem as /tcp-rotina-... desta pasta. Se não aparecer nenhuma, ainda não há rotinas.

A lista do /tcp também mostra os recursos automáticos (tcp-checklist-relatorio, tcp-consultar-dados-..., tcp-gerar-planilha, tcp-planilha-conectada, tcp-registrar-aprendizado). Você não precisa chamá-los: eles entram sozinhos (tabela no fim desta parte).

O que cada um faz e o que você vê:

• /tcp-comecar-trabalho — confere o ambiente deste computador (quem é você, os automáticos, a versão da pasta, cópias de conflito do Drive); relê memória, documento da empresa e checkpoints, os seus e os dos colegas; testa o banco. Você vê até seis tópicos, inclusive o que o time fez desde a sua última sessão, e a pergunta "o que fazemos hoje?". Em pasta de cliente novo, ele avisa que o levantamento ainda não foi feito. Se você não foi registrado neste computador (conta do Claude que não é da TCP), ele para e diz o que fazer — nesta mesma conversa.
• /tcp-terminar-trabalho — grava o que foi aprendido (inclusive o que os colegas precisam saber), confirma a cópia da memória na pasta do time e cria o checkpoint da sessão na sua subpasta. Você vê a lista do que foi gravado, dos arquivos gerados, do que ficou pendente, dos rascunhos para você apagar e, se houver, os pedidos de melhoria do ambiente já registrados no Drive (_melhorias\, na raiz) — você não repassa nada (parte 16).
• /tcp-limpar-contexto — o mesmo que o terminar, mas pensando em continuar: termina com "onde paramos" e as opções /compact e /clear.
• /tcp-ambiente — confere este computador (Python, Excel, ODBC) e se tudo está funcionando: os automáticos, a versão da pasta, cópias de conflito do Drive, o banco. Registra você só se o registro automático da primeira conversa não tiver dado. Não baixa nem atualiza nada: quem atualiza a pasta é quem mantém o ambiente (partes 4 e 15).
• /tcp-nova-rotina <nome> — o Claude combina com você os recortes, escreve e testa a consulta e cria o comando /tcp-rotina-<nome>, que vale para todo o time (parte 12).
• /tcp-prompt-nova-conversa <assunto> — exceção, para conversa longa demais: você recebe um bloco pronto para copiar e colar noutra conversa, que passa a ser a única de trabalho (parte 5).
• /tcp-atualizacao-360 — o levantamento completo do cliente, de 30 a 90 minutos; normalmente quem roda é um mantenedor do ambiente, e o resultado vale para o time inteiro (parte 13).

Recursos que funcionam sozinhos, sem comando — entram quando o assunto aparece:

7. Como pedir bem

Escreva como falaria com um analista. Um bom pedido tem até seis partes:

Não sabe um dos itens? Diga "use o padrão da pasta e me diga qual usou".

Pedido fraco × pedido bom:

O pedido fraco não está errado: o Claude responde, mas escolhe as premissas por você. O bom economiza idas e vindas.

Exemplos por área

Vendas e clientes

• "Faturamento mês a mês dos últimos 3 anos, e me explica as quedas."
• "Quem são os 20 maiores clientes e quanto cada um pesa?"
• "Quanto a gente devolve, em % das vendas, mês a mês?"

Margem e custo

• "Margem por categoria nos últimos 12 meses."
• "Quanto custa o frete de verdade, e bate com o percentual usado no cálculo de margem?"

Financeiro

• "Aging do contas a receber e os maiores devedores."
• "Quanto temos a pagar e quando vence? Tem imposto parcelado?"
• "Prazo médio de recebimento e de pagamento nos últimos 12 meses."

Estoque, compras e importação

• "Quanto de estoque está parado há mais de um ano?"
• "O que está em trânsito hoje, pedido a pedido?"
• "Quais os maiores fornecedores e quanto dependemos de cada um?"

Impostos

• "Carga tributária efetiva sobre o faturamento, por imposto."
• "ICMS e substituição tributária por estado de destino."

Produção e qualidade

• "Ordens de produção por mês e o que foi produzido × revendido."
• "Taxa de reprovação no recebimento, por fornecedor."

Recuperação judicial (só se o cliente estiver em RJ)

• "Separa o contas a pagar em concursal e extraconcursal pela data do pedido."
• "Monta o quadro de credores por classe."

Entender a empresa

• "Me resume o que você já sabe sobre o cliente."
• "Quais são as perguntas em aberto?"

Chamar um especialista pelo nome

Para perguntas que exigem várias consultas, o Claude chama sozinho um agente especialista: um analista que investiga, cruza as informações e devolve a conclusão (não uma tabela gigante). Você também pode pedir pelo nome:

• "usa o tcp-financeiro para montar o aging por faixa de atraso"
• "pede para o tcp-revisor-numeros conferir esse faturamento"

Os agentes levam alguns minutos e gastam tokens por conta própria (leem o mapa do ERP e rodam várias consultas); os de área rodam num modelo mais barato que o da conversa — só o revisor de números e o de recuperação judicial usam o mesmo modelo da conversa. Para pergunta simples, não precisa.

8. Como ler a resposta

Uma boa resposta tem cinco partes. Se faltar alguma, peça.

1. O número, com a unidade (R$, R$ mil, R$ mi, quantidade).
2. As premissas: empresa e filial, o que contou como venda (ou como título, ou como estoque), período e qual data, devolução e bonificação dentro ou fora, e qual valor (mercadoria, total da nota, líquido).
3. As ressalvas: o que pode enganar naquele número.
4. De onde veio: o arquivo .sql gravado em sql\ e a data da extração. No topo de cada .sql há um cabeçalho com a pergunta, o período, os filtros e a linha Rodada em, que prova que a consulta rodou no banco.
5. O que foi registrado, quando houver algo novo.

Um exemplo, com valores inventados:

Faturamento de agosto/2026: R$ 8,2 mi

Premissas
- Empresa 01, todas as filiais
- Universo: régua oficial da pasta (só notas de venda; sem remessa nem transferência)
- Data: emissão da nota, de 01/08 a 31/08/2026 (mês fechado)
- Devolução: fora (não descontada); bonificação: fora
- Valor: mercadoria, sem IPI e sem ST

Ressalva: 3% do valor é venda para empresa do mesmo grupo.
Consulta: sql\faturamento_mensal_categoria.sql (extraído em 18/09/2026)
📝 Registrado: faturamento de ago/2026 nos números de referência

As marcas que você vai ver

As marcas [M], [I], [A], [D] e [NA] aparecem no documento da empresa. Nas respostas, o Claude e os agentes dizem por extenso o que foi medido e o que é inferência.

O resultado do checklist

O checklist confere 14 itens em cinco grupos: recorte (empresa, universo, operações que não são venda, base de valor e data, cortes do cliente), conteúdo (consulta rodada, ordem de grandeza, ressalvas, comentário que é insight e não descrição, domínio dos números por quem apresenta), sigilo (dado pessoal, faixa de confidencial com o destinatário confirmado, nenhuma senha, só a planilha estática sai do time), rastro (arquivo salvo, reprodutível) e aprendizado (registrado).

• ✅ item conforme · ❌ item pendente, com o que corrigir.
• 🔴 item obrigatório: se estiver ❌, o número não sai.
• 🟡 item importante: pode sair, com a limitação escrita.

O veredito é um de dois: PODE CIRCULAR ou CORRIGIR ANTES DE CIRCULAR. Não existe "entrega com pendência vermelha".

O resultado do revisor

O revisor refaz o cálculo do zero, com consulta própria, e tenta derrubar o número. Ele devolve uma tabela (valor original × valor que encontrou × bate?) e um veredito:

9. As armadilhas dos números

Todo ERP tem particularidades que fazem um número parecer certo e estar errado. O ambiente já trata essas armadilhas, mas vale você conhecer o princípio — é o que permite desconfiar.

Exemplo (valores inventados): o mesmo mês pode dar R$ 10,0 mi (mercadoria), R$ 11,8 mi (total das notas, com IPI e ST) e R$ 9,4 mi (mercadoria menos devoluções). Os três estão corretos — cada um com a sua premissa.

Por isso todo número que sai daqui vem com as premissas escritas. Se você receber um número sem elas, peça. As armadilhas específicas do seu cliente estão no docs\empresa-<nome-do-cliente>.md e no GUIA-DO-TIME.md.

10. Planilhas

Os três tipos

Como pedir:

• "quero uma planilha que eu mesmo atualizo" — conectada;
• "quero a versão sem senha dentro, eu tenho o acesso" — conectada sem senha. Só peça esta se você recebeu o usuário e a senha (por exemplo, porque você mesmo preencheu o credenciais.ps1). Se a senha já estava no credenciais.ps1 da pasta e ninguém te passou, use a conectada padrão: sem a senha, a planilha não atualiza;
• "manda em planilha para eu enviar ao cliente" ou "a versão estática" — estática.

Como a planilha conectada é montada

As planilhas ficam na sua subpasta, relatorios\<seu-slug>\, com nomes terminados em _conectada.xlsx. Cada analista tem as suas: duas pessoas nunca atualizam o mesmo .xlsx (o Excel não trava o arquivo de um computador para o outro, e uma delas perde o trabalho sem aviso).

Atualizar não apaga nada; regerar cria uma planilha nova. Às vezes a solução é o Claude gerar a planilha de novo (visão nova, CONFERENCIA diferente de zero, #REF!, senha que mudou). Regerar cria o arquivo do zero, igual ao anterior graças à linha "Gerada com", e guarda a planilha que estava lá como <nome>.anterior.xlsx, na mesma pasta. A nova não traz as premissas que você preencheu nem as abas que você criou à mão: se a anterior tinha alguma dessas coisas, o Claude avisa, e você copia da .anterior.xlsx o que quiser manter (ou pede ao Claude).

Nenhuma cópia com o seu trabalho é apagada, nem se a planilha for gerada várias vezes. Se já existia uma .anterior.xlsx com coisas suas, ela ganha a data e a hora no nome — <nome>.anterior-AAAAMMDD-HHMM.xlsx (a data e a hora da última vez que ela foi gravada) — e o Claude avisa. Quando não precisar mais dessas cópias, apague você mesmo. As que foram geradas com a senha dentro continuam com ela e também não saem do time: se você pedir a versão sem senha por cima de uma planilha com senha, o Claude avisa com ATENCAO: a copia anterior <arquivo> TEM a senha do banco gravada.

Como atualizar

1. Abra a planilha no Excel para desktop (não no navegador). Se ela estiver no Google Drive como "só on-line", espere baixar ou deixe a pasta disponível off-line.
2. Se aparecer uma barra amarela:
   • "Modo de Exibição Protegido" (Protected View): clique em Habilitar Edição (Enable Editing);
   • "Conexões de dados externos foram desabilitadas" (Security Warning): clique em Habilitar Conteúdo (Enable Content).
3. Guia Dados > Atualizar Tudo (em inglês: Data > Refresh All). Atalho: Ctrl+Alt+F5.
4. Planilha sem senha: o Excel abre uma janela pedindo usuário e senha do banco, às vezes uma vez para cada aba de base. Digite e confirme. Se aparecer uma opção de salvar a senha, deixe desmarcada. Não anote a senha na planilha.
5. Espere terminar (a barra de status, embaixo, mostra o andamento). As bases recarregam e as visões recalculam sozinhas.
6. Confira a linha CONFERENCIA de cada visão: tem que dar zero.
7. Na aba Premissas, anote a data e a hora em "Atualizada em" (quando o Claude atualiza por você, ele mesmo grava).
8. Salve.

A linha CONFERENCIA compara o total da base com o total da visão. Se não der zero, apareceu na base um valor novo (uma categoria nova, por exemplo) que não está na lista da visão. Peça ao Claude: "regera a visão dessa planilha" — e lembre do aviso acima: o que você preencheu ou criou à mão fica na .anterior.xlsx.

O que não fazer na aba Base

• Não digite nem cole nada: o próximo "Atualizar" apaga.
• Não apague linhas nem colunas: as fórmulas das visões apontam para elas (é assim que nasce o #REF!).
• Não renomeie a aba.
• Quer outro recorte? Crie uma aba nova com fórmulas (SOMASES, ou SUMIFS em inglês) sobre a base — ou peça ao Claude. Não dê à aba nova um nome começado por Base_: esse começo é reservado às abas ligadas ao banco, e quem abrir a planilha acharia que a sua aba também atualiza sozinha.

Erros comuns

Quando é o Claude que gera ou atualiza, ele lê a última linha do programa e traduz para você:

Às vezes o programa leva uns segundos a mais no fim: ele espera o Excel que ele mesmo abriu fechar sozinho e, se não fechar em 5 segundos, encerra só esse (a planilha já está salva). As janelas do Excel que você tem abertas não são tocadas.

Pedir uma visão nova ou atualizar tudo

• Visão nova: "cria na planilha de faturamento uma visão por estado". O Claude gera a planilha de novo com a visão a mais. O que você tinha preenchido ou criado à mão fica na .anterior.xlsx (aviso acima); se quiser, peça ao Claude para trazer de lá.
• Atualizar todas de uma vez: "atualiza todas as planilhas conectadas". O Claude atualiza, uma por uma, as *_conectada.xlsx da sua subpasta relatorios\<seu-slug>\ (as cópias .anterior e as planilhas dos colegas ficam de fora), grava o "Atualizada em", mostra quantas linhas vieram em cada base e confere a CONFERENCIA de cada visão. Isso só atualiza: as abas feitas à mão ficam. Feche antes as planilhas que vão ser atualizadas. As planilhas sem senha são puladas (aparece PULADA) — essas você atualiza no Excel. Se aparecer AVISO com CONFERENCIA diferente de zero, a solução é regerar aquela planilha.

11. Antes de mandar para fora

Se o número vai para reunião, e-mail, apresentação, diretoria ou cliente, peça:

roda o checklist nisso

É a conferência dos 14 itens da parte 8 — inclusive dado pessoal e sigilo. Leva pouco tempo e responde PODE CIRCULAR ou CORRIGIR ANTES DE CIRCULAR, com o que falta. Se o material é confidencial, o checklist pergunta quem vai receber: tenha a resposta pronta.

Para um número importante, peça também uma segunda opinião, chamando o revisor pelo nome:

pede para o tcp-revisor-numeros conferir esse número

O revisor independente refaz o cálculo do zero, com consulta própria, e tenta derrubar o resultado (veredito na parte 8). Use quando o número vai decidir alguma coisa ou quando dois números não batem. Diga o nome dele, para não haver dúvida: o checklist confere se o que vai sair está completo e declarado; quem refaz a conta é o revisor.

O que pode sair da pasta

E no sentido contrário:

• Documento externo (contrato, PDF de processo, planilha que o cliente mandou) não é copiado para a pasta. Deixe o arquivo onde está (em Downloads ou numa pasta sua, fora da pasta do cliente) e diga ao Claude o caminho. Ele vai pedir permissão para ler fora da pasta: aprove, porque foi você que indicou (parte 14). Ele extrai o que importa para o documento do cliente e anota a fonte. Só quando o time decide guardar um arquivo que todos vão consultar (ex.: a peça do processo), ele vai para recebidos\, com a data e a origem no nome — peça ao Claude.
• Não peça ao Claude para mandar e-mail, subir arquivo em site ou compartilhar link. Quem envia é você, pelo seu e-mail, depois do checklist.

12. Rotinas

Uma rotina é um pedido que você repete (todo mês o faturamento por categoria, toda semana o aging), salvo como um comando da pasta, que vale para todo o time. Da próxima vez, basta digitar o comando.

Criar:

1. Faça o pedido normalmente e confira o resultado.
2. Digite /tcp-nova-rotina <nome> — nome curto, sem acento e sem espaço, com hífen (ex.: /tcp-nova-rotina faturamento-mensal).
3. O Claude combina com você os recortes fixos (empresa, período, o que conta como venda, devolução), escreve e testa a consulta no banco (ela só é gravada em sql\ depois de rodar), gera a planilha conectada (se for relatório) e registra a rotina no catálogo docs\relatorios-prontos.md.
4. Pronto: a rotina vale na hora, nesta conversa. Se ela não aparecer na lista do /, digite o nome inteiro (/tcp-rotina-<nome>); se ainda assim não vier, siga a escada da parte 2 — sem trocar de conversa.

O Claude também oferece criar uma rotina quando percebe que você pediu a mesma coisa pela segunda vez.

O que é criado (exemplo para faturamento-mensal):

Usar: digite /tcp-rotina-faturamento-mensal. O Claude roda a consulta e responde com a tabela e as premissas. A planilha você atualiza no Excel, sem o Claude (parte 10). A rotina é do time; a planilha é de cada um: na primeira vez que um colega roda a rotina, o Claude gera a dele, na subpasta dele.

Se a rotina gera a planilha de novo todo mês e você tinha preenchido a aba Premissas do mês anterior, a resposta termina em OK COM AVISOS. É normal: o preenchimento do mês passado está na .anterior.xlsx, e o Claude diz o caminho.

Ver a lista: digite /tcp-rotina na caixa de texto, sem apertar Enter, e olhe as /tcp-rotina-... que aparecem. Se não aparecer nenhuma, ainda não há rotinas nesta pasta.

Mudar: peça em português — "muda a rotina faturamento-mensal para incluir a devolução". O Claude altera e testa de novo.

Remover: a rotina é de todos, então combine antes com o time. Depois, peça "quero remover a rotina faturamento-mensal". O Claude não apaga arquivos (é bloqueado de propósito): ele tira a linha do catálogo e mostra os caminhos para você apagar no Explorador de Arquivos. É a única vez em que você apaga algo dentro de .claude\: só a pasta da rotina que ele indicar.

Rotina não sobrescreve rotina: se já existe uma com o mesmo nome, o Claude pergunta se é para atualizar a existente ou usar outro nome. Uma rotina criada por qualquer um vale na hora para todo o time: os colegas também a veem no /tcp-rotina.

13. O levantamento 360

É a varredura completa do cliente: o Claude percorre o banco do ERP e as fontes públicas (site, notícias, cadastros) e monta a base de conhecimento da empresa — quem é, como opera, faturamento, clientes, produtos, impostos, compras, importação, estoque, produção, financeiro, contabilidade, logística, pessoas, processos e as armadilhas de consulta.

Quando rodar:

• em cliente novo — normalmente um mantenedor do ambiente roda logo que a pasta do time nasce;
• para atualizar, quando os números de referência estiverem velhos (mais de uns três meses);
• quando o /tcp-comecar-trabalho avisar que o levantamento ainda não foi feito.

Antes de começar, saiba:

• Leva de 30 a 90 minutos e consome bastante do seu plano: roda vários analistas, em lotes de 4 a 6.
• Permissões: o 360 roda melhor no modo Automático (parte 14). Confira o seletor antes de começar: o aplicativo pode lembrar o modo que você usou da última vez nesta pasta, e ele pode não ser o Automático. Sem ele, cada analista pede permissão para gravar arquivo e pesquisar na internet, e alguém precisa ficar aprovando. Mesmo no Automático, fique por perto.
• O resultado vale para o time inteiro, na hora. Por isso, normalmente quem roda é um mantenedor do ambiente: é ele quem grava a verdade da casa (consolidado\). Se você não é mantenedor do ambiente (o Claude confere isso sozinho e avisa), combine antes com o Alfredo. Em qualquer caso, avise os colegas: o 360 reescreve os documentos do cliente, e quem mexer neles ao mesmo tempo pode perder o que escreveu. Só um 360 por vez nesta pasta — também entre os mantenedores.
• Não feche nem interrompa a conversa enquanto ele trabalha: isso encerra os analistas em andamento. O que já foi gravado fica.
• Não use outra conversa nesta pasta enquanto ele roda.
• O Claude avisa tudo isso e espera o seu "pode seguir".

O que ele produz:

• docs\empresa-<nome-do-cliente>.md, com os números de referência e um resumo por área;
• um documento por área em docs\levantamento\;
• as consultas em sql\, o catálogo docs\relatorios-prontos.md e as regras de consulta do cliente;
• o resumo do cliente no CLAUDE.md e a trilha por área e as particularidades do cliente no GUIA-DO-TIME.md;
• a memória atualizada, a "verdade da casa" que todo o time lê (memory\Global-Cliente\consolidado\) e um checkpoint, com a seção "Decidi sem te perguntar": as escolhas que o Claude e os analistas fizeram sozinhos, inclusive toda inferência ou corte de data que mexe num número de referência, com o valor afetado. Leia essa lista e diga se alguma escolha está errada;
• antes de terminar, uma conferência cruzada: o mesmo número de referência precisa ter o mesmo valor no CLAUDE.md, no documento da empresa, na memória e nos documentos de cada área;
• no fim, um resumo com as 3 a 5 descobertas mais relevantes para o negócio, a lista "Decidi sem te perguntar" inteira e as pastas de rascunho para você apagar.

Quando terminar, continue na mesma conversa: o Claude relê ali mesmo o CLAUDE.md que o 360 atualizou.

Se parar no meio (limite do plano, queda, conversa fechada): é só rodar /tcp-atualizacao-360 de novo. Ele vê o que já está pronto, pula essas áreas e continua de onde parou.

14. Quando o Claude pede permissão

Antes de gravar um arquivo, rodar um programa ou acessar a internet, o Claude pode pedir sua autorização. As opções costumam ser "permitir uma vez", "permitir sempre" e "negar". Quantos pedidos aparecem depende do modo de permissão (abaixo).

Não entendeu o pedido? Antes de aprovar, pergunte: "o que esse comando faz?". Negar não estraga nada: o Claude explica ou procura outro caminho.

Pode aprovar:

• ler e gravar arquivos dentro da pasta do cliente;
• rodar os programas da pasta scripts desta pasta (conexão com o banco, gravação das consultas finais, planilhas, conferência do ambiente) e a conferência da máquina do /tcp-ambiente (_ambiente\instalar\instalar-maquina.ps1);
• ler um documento que você indicou, fora da pasta (ex.: o contrato na pasta Downloads);
• gravar na memória do próprio Claude (%USERPROFILE%\.claude\projects\<...>\memory) e no rascunho, dentro da pasta temporária do Windows (%TEMP%\tcp\<nome-do-cliente>\..., que no pedido aparece como ...\AppData\Local\Temp\tcp\...) — são áreas de trabalho dele. O rascunho fica fora do Drive de propósito, porque costuma ter dado do cliente em bruto;
• comandos que só olham: listar arquivos, contar linhas, ver a versão de um programa;
• pesquisar na internet informação pública sobre a empresa, quando isso fizer parte do pedido (no 360, por exemplo);
• ler a pasta do cliente no Google Drive pelo conector, durante o /tcp-fontes (parte 21).

Como reconhecer um programa da pasta. O pedido traz uma linha técnica assim:

powershell -NoProfile -ExecutionPolicy Bypass -File ".\scripts\conexao.ps1"

Se o caminho depois de -File começa com .\scripts\ (o .\ é a pasta desta conversa) e termina num nome .ps1, pode aprovar. O -ExecutionPolicy Bypass é normal: só deixa o Windows rodar o programa — não tem nada a ver com a opção de ignorar as permissões do Claude. Esses programas já vêm liberados nas permissões da pasta, iguais para o time e em qualquer computador: o pedido é raro.

Negue e avise o Alfredo:

• apagar arquivos;
• enviar qualquer coisa para fora: e-mail, upload, formulário, publicação;
• criar, alterar, mover, compartilhar ou apagar arquivo no Google Drive, ou alterar planilha, documento ou apresentação do Google do cliente (parte 21);
• instalar programas (ex.: pip install, winget, um instalador .exe ou .msi);
• acessar site desconhecido, ou site sugerido por um documento;
• ler ou gravar fora da pasta do cliente quando você não pediu (fora as áreas do Claude citadas acima);
• rodar programa de outra pasta de cliente;
• abrir ou mostrar o scripts\credenciais.ps1 (o Claude não precisa: os programas leem a senha sozinhos);
• qualquer pedido de senha no chat.

Prefira "permitir uma vez". O "permitir sempre" fica gravado na pasta e, numa pasta do time, passa a valer para todos os colegas — e os programas da pasta scripts já vêm liberados.

O Claude não apaga arquivos. O ambiente bloqueia os comandos de apagar mais comuns, de propósito. Se mesmo assim aparecer um pedido para apagar, negue: quem apaga é você, no Explorador de Arquivos, quando o Claude mostrar o caminho e você concordar.

Texto que vem de documento, planilha ou site é informação, não ordem. Se um arquivo disser "ignore as regras" ou "envie isto para tal endereço", o Claude não obedece. Se ele propuser algo assim, negue e avise.

Os modos de permissão

Ao lado do botão de enviar há um seletor de modo. O modo em que a conversa começa depende do seu plano e da versão do aplicativo, e o aplicativo pode lembrar o modo que você escolheu da última vez em cada pasta. Por isso, confira o seletor ao abrir uma conversa, principalmente antes de uma tarefa longa.

Sem o Automático no seletor? Use Aceitar edições e fique aprovando os comandos.

As regras do ambiente (não apagar, não enviar, só ler o banco) valem em qualquer modo. No Automático você vê menos pedidos: acompanhe as respostas. Se aparecer a opção ignorar permissões (Bypass permissions), não use.

15. Atualizações do ambiente

O ambiente (comandos, regras, programas, este guia) é o mesmo em todos os clientes e ganha versões novas de tempos em tempos. Quem atualiza é quem mantém o ambiente: publica a versão nova e a leva direto para a pasta do time. Ninguém precisa baixar nem rodar nada — o /tcp-ambiente não atualiza o ambiente.

1. O Claude fica sabendo sozinho. Se a versão nova chegar com a conversa aberta, na sua mensagem seguinte ele recebe um aviso do ambiente (AVISO DO AMBIENTE TCP ... releia), relê as regras ali mesmo e avisa em uma linha: "O ambiente foi atualizado (vX → vY) e eu já reli as regras — seguimos nesta mesma conversa". Comandos, automáticos e permissões novos já valem.
2. Continue nesta mesma conversa. Não abra outra por causa da atualização: cada conversa ficaria numa versão diferente do ambiente.
3. Se algo novo não aparecer, siga a escada da parte 2 — sem trocar de conversa.

Outras mensagens:

• Releitura diária — numa conversa aberta há mais de um dia, o Claude relê as regras sozinho, uma vez por dia (um colega pode ter mudado o CLAUDE.md do cliente). Nada a fazer.
• "Já existe uma versão publicada mais nova" — a versão nova ainda não chegou a esta pasta. Nada a fazer: quem a leva é quem mantém o ambiente.
• "A pasta está à frente da publicada" — não é erro. Avise o Alfredo e continue trabalhando.
• Sem internet — nada muda no ambiente: ele não baixa nada. Com a pasta disponível off-line (parte 4, passo 3), os arquivos abrem; o que você e os colegas gravarem sincroniza quando a conexão voltar.

16. O ambiente aprende

O conhecimento sobre o cliente fica em dois lugares, sempre juntos:

Cópias automáticas, na pasta do time (cada um na sua subpasta; as dos colegas são só para ler):

• memory\Analistas\<seu-slug>\ — ao fim de cada resposta, a memória do Claude é copiada para esta pasta (só acrescenta e atualiza; nunca apaga). Num computador novo, ela volta sozinha para a memória do Claude no começo da conversa.
• checkpoints\<seu-slug>\ — o registro das suas sessões. Há dois tipos:
  • manual: gravado pelo /tcp-terminar-trabalho e pelo /tcp-limpar-contexto, com nome <nome-do-cliente>_<Assunto>_<AAAA-MM-DD>_<HHMM>.md. É o que o /tcp-comecar-trabalho lê — os seus e os dos colegas;
  • automático: pastas _auto\checkpoint-<data-hora>, gravadas antes de a conversa ser compactada, com um retrato da memória. Uma pasta por dia: a primeira compactação do dia a cria (o nome leva a hora dela) e as seguintes do mesmo dia atualizam essa mesma pasta — ela não cresce sem limite. Servem só para recuperação.

A conversa em si não é copiada para a pasta. Ela fica só no histórico do Claude neste computador. O que precisa sobreviver — números, decisões, o que foi feito — vai para a memória e para os checkpoints escritos. Por isso o 📝 Registrado e o /tcp-terminar-trabalho importam tanto.

O 📝 Registrado. Sempre que o Claude descobre algo relevante (um número de referência, uma regra de negócio, uma armadilha, o significado de um campo), ele grava na hora, na memória e no documento, e avisa com uma linha 📝 Registrado: .... Você não precisa pedir.

Quando o Claude disser algo errado, corrija — e diga o porquê. Por exemplo: "isso está errado: a filial 02 é outra empresa, não some com a 01". Ele grava a correção, com a data, e não repete o erro. Quando é um número que mudou, o antigo e o novo ficam na tabela "Divergências resolvidas" do documento da empresa, com a consulta que resolveu. Correção é o aprendizado mais valioso de todos.

Você também ensina: conte uma regra de negócio que não está escrita, uma sigla do cliente, um relatório que o cliente usa. Vira conhecimento permanente da pasta.

Preferência sua é diferente de regra do cliente. O jeito como você gosta de receber as respostas (mais curto, sem jargão, sempre em tabela) fica só no seu computador, no %USERPROFILE%\.claude\CLAUDE.md — peça "guarda essa preferência só para mim". Ela não vai para a memória nem para a pasta: as duas são lidas pelo time inteiro, e um CLAUDE.local.md na pasta valeria para todos. Já uma regra combinada para o cliente, que vale para quem usar a pasta (ex.: "neste cliente, venda para empresa do grupo fica sempre fora do faturamento"), vai para a memória e para o CLAUDE.md.

O que você aprende chega aos colegas sozinho. Documentos e consultas já são da pasta do time. O que os outros precisam saber — um número de referência, uma correção, um alerta — o Claude registra numa linha do seu arquivo do time (memory\Global-Cliente\analistas\<seu-slug>.md), e as armadilhas de consulta no seu armadilhas\<seu-slug>.md, dentro das regras de consulta do cliente. Os dois entram em toda conversa de todo colega. A "verdade da casa", o que foi consolidado para todos (memory\Global-Cliente\consolidado\), só quem consolida escreve: um mantenedor do ambiente.

Quer mudar algo no ambiente? O pedido se registra sozinho no Drive. O ambiente (comandos, agentes, programas, regras, este guia) é o mesmo para todos, e é cuidado pelos mantenedores do ambiente (o contato é o Alfredo). O Claude não altera o ambiente na pasta: as permissões bloqueiam, e a próxima atualização desfaria a mudança. Como o Drive é compartilhado, você não precisa repassar nada:

1. Achou um defeito, ou tem uma ideia de melhoria (um comando que falhou, um agente que devia fazer diferente, uma regra que atrapalha)? O Claude registra o pedido na hora, sozinho, numa pasta do Drive que quem mantém o ambiente lê (_melhorias\, na raiz do Drive). Ele monta o bloco 📤 Pedido para o ambiente TCP — o que aconteceu, o que se espera, a instrução técnica — e grava. Você vê 📤 Registrei um pedido de melhoria.... Também pode pedir de propósito: "registra um pedido de melhoria do ambiente".
2. Não precisa copiar nem enviar nada. O pedido já está no Drive; quem mantém o ambiente faz a triagem e aplica com o comando de manutenção (/tcp-melhorias). O item também fica no checkpoint da sessão, como histórico.
3. O bloco nunca leva senha nem dado pessoal — é sobre o ambiente, não sobre o cliente.

Quem mantém o ambiente leva a melhoria para todos numa versão nova. Quando ela chegar à pasta, o Claude relê as regras sozinho, na mesma conversa (parte 15).

17. Onde fica cada coisa

A pasta é do time inteiro e tem quatro partes, cada uma com o seu dono:

• a do ambiente (comandos, programas, CLAUDE.padrao.md, CONVENCOES.md, este guia): trocada a cada atualização, só por quem mantém o ambiente;
• a do cliente (documentos, consultas, CLAUDE.md, GUIA-DO-TIME.md, rotinas): de todos — o Claude altera por trecho, relendo antes (as consultas de sql\, só pelo programa que as grava depois de rodar no banco), e a atualização nunca toca;
• a da casa (memory\Global-Cliente\consolidado\): o que foi consolidado para todos; só quem consolida escreve (um mantenedor do ambiente);
• a sua (tudo o que leva o seu slug no nome, como checkpoints\<seu-slug>\ e relatorios\<seu-slug>\): só você grava, e o Claude nunca mexe na de um colega.

O que é deste computador (quem você é, o estado dos automáticos) fica em %LOCALAPPDATA%\tcp\, e as suas preferências pessoais em %USERPROFILE%\.claude\CLAUDE.md — os dois fora da pasta.

Você não precisa decorar nomes: o Claude grava cada coisa no lugar certo, seguindo o CONVENCOES.md. Não guarde informação do cliente nos arquivos do ambiente — ela sumiria na próxima atualização. Peça ao Claude para registrar; ele sabe onde.

18. Segurança e sigilo

• Somente leitura. O Claude só consulta; nunca altera o banco. É regra do ambiente, mesmo que o login permita mais. O teste de conexão mostra leitura apenas: SIM quando o login é mesmo só de leitura — e mostra só o nome do banco: nunca o usuário, o servidor nem a senha.
• A senha do banco fica só no scripts\credenciais.ps1, preenchida no Bloco de Notas. Nunca no chat, em e-mail, WhatsApp, planilha ou documento. No arquivo, ela fica num lugar só; na conversa, ela se espalha pelo histórico, pelos resumos e pela memória. No formato novo, o arquivo não mostra nada na tela se for executado por engano; o formato antigo mostra a senha — o teste de conexão avisa com AVISO: ... formato antigo, e a correção é uma linha no Bloco de Notas (parte 4, passo 6).
• O Claude nunca precisa da senha na conversa e não abre o credenciais.ps1 (as permissões da pasta bloqueiam a leitura): os programas da pasta leem sozinhos. Se ele pedir a senha ou quiser abrir o arquivo, não deixe.
• A pasta tem a senha dentro. Ela fica no Drive do ambiente, que toda a TCP enxerga (política da casa): o cuidado é com o que sai para fora da TCP. Não mande a pasta nem arquivos dela por e-mail, link público ou pen drive, e não a copie para outro lugar. Acesso ao Drive do ambiente se pede ao Alfredo.
• Planilha conectada tem a senha dentro (ou, na versão sem senha, o endereço do banco e o usuário). Só entre colegas do time; nunca para fora.
• Os dados são confidenciais e pertencem ao cliente. Número só sai depois do checklist, e só para quem deve recebê-lo.
• Só este ambiente, com a sua conta. Não cole dados do cliente no chat comum, em outra ferramenta de IA nem numa conta pessoal. Na dúvida se um uso é permitido, pergunte ao Alfredo.
• Processo sigiloso (ex.: recuperação judicial em segredo de justiça, credores): todo documento sobre isso começa com a faixa > 🔒 Confidencial — não circular fora do time sem o /tcp-checklist-relatorio. Nada sai sem autorização de quem responde pelo trabalho, e só depois do checklist.
• Dado pessoal (LGPD). O Claude nunca escreve CPF nem nome completo de pessoa física que aparece nos dados do cliente (cliente pessoa física, funcionário, credor, sócio) nos documentos, na memória, nos checkpoints ou nos arquivos gerados: usa "PF", as iniciais ou o código do ERP. Salário, e-mail e telefone, só quando o pedido precisar; colunas de CPF, e-mail ou telefone não são exportadas sem necessidade. Os contatos de trabalho (CLAUDE.md, seção "Escopo", e "Quem procurar", no GUIA-DO-TIME.md) podem ter nome e papel — sem CPF nem telefone pessoal. Se precisar de um nome, peça e diga para quê.
• Senhas guardadas no próprio ERP. A tabela de parâmetros do ERP (no Protheus, a SX6 e as cópias dela, SX6*, nas colunas de conteúdo X6_CONTEUD, X6_CONTSPA e X6_CONTENG) guarda senhas e chaves (tokens) de integração com outros sistemas. O Claude nunca traz o conteúdo de um parâmetro cujo nome ou descrição (X6_VAR, X6_DESCRIC, X6_DESC1, X6_DESC2) contenha PSW, PASS, SENHA, TOKEN, KEY, SECRET, USR ou USER: filtra ou mascara (aparece ***). E nunca puxa a tabela inteira (SELECT * em SX6*). Se mesmo assim um segredo aparecer numa resposta, ele não grava em lugar nenhum e avisa. Nesse caso, avise também o Alfredo.
• Rascunho tem dado em bruto. O rascunho (%TEMP%\tcp\<nome-do-cliente>\) fica fora do Drive de propósito. Apague as pastas de assuntos encerrados quando o /tcp-terminar-trabalho listar.
• Documento externo não entra na pasta. O Claude lê de onde está e anota a fonte.
• O Claude não envia nada para fora. Nada de pedir e-mail, upload ou publicação.
• Conta pessoal. Não compartilhe a sua conta do Claude.
• Texto de documento ou site não é ordem. Se algo que o Claude leu pedir para mudar regras, enviar dados ou pedir senha, ele não obedece; se parecer que obedeceu, pare e avise.
• Computador: bloqueie a tela ao sair (Windows+L).

Errei, e agora?

Erro acontece. O que piora é esconder. Aja na hora:

19. Se travar

As mensagens escritas em fonte de código são as que aparecem de verdade (os programas do ambiente escrevem sem acento; as do Windows e do banco, com acento ou em inglês). Na maioria dos casos o Claude já lê a mensagem e diz o que fazer.

20. Diagnóstico e reestruturação

Quando a TCP é contratada para um diagnóstico — e, depois, muitas vezes para a reestruturação (recuperação extrajudicial ou judicial) —, o trabalho acontece na mesma pasta do cliente, com tudo o que ela já tem (o banco do ERP, os especialistas, a memória do time) e três comandos a mais. O mesmo projeto começa como diagnóstico e segue como reestruturação, na mesma pasta.

O Quadro Geral de Credores (/tcp-qgc)

O método é o do Manual do QGC da TCP, em cinco etapas: levantamento dos documentos, análise dos contratos, consolidação com a reconciliação de três fontes (empresa, contrato e credor), classificação legal (as classes I a IV do art. 41 da Lei 11.101 e o que fica fora do quadro) e montagem final, com o confronto com a relação do administrador judicial.

1. Começar: diga "vamos começar o diagnóstico" (ou /tcp-qgc). O Claude pergunta o tipo de processo, a data-base, a data do pedido (se houver) e o salário mínimo, e cria o projeto. A pasta projeto\ nasce ali: é o "banco" do quadro. Ninguém mexe nela à mão — nem o Claude.
2. Documentos: guarde cada documento recebido em recebidos\ com o nome AAAA-MM-DD_origem_assunto (ex.: 2026-09-24_banco-alfa_ccb-4012345.pdf) e peça para registrar. "O que falta?" mostra o checklist dos 9 documentos do Manual.
3. Ler um contrato: "lê o contrato do Banco Alfa". O Claude lê o instrumento e os anexos que mudam o crédito (cronograma, garantias, aditivos) — e pula os anexos pessoais (procuração, balanço, certidões), dizendo quais páginas pulou — e mostra uma tabela: cada campo (saldo, data-base, garantias, cláusulas) com o trecho e a página de onde saiu e a confiança, que o programa calcula conferindo o trecho no PDF. Você confere e responde: "confirma os de confiança alta", "o saldo certo é 1.234.567,89", "a garantia é penhor". Só entra no quadro o que você confirmou. Aging de fornecedores e relatórios do ERP entram do mesmo jeito, linha a linha. Contrato digitalizado (escaneado, sem texto) também: no Windows o Claude passa o OCR do próprio Windows e vê a imagem de cada página; a confiança fica no máximo "média" e os números que decidem (valor, data, taxa) você confere na imagem. No Mac, sem OCR, o Claude lê a imagem da página (inteira, com o pacote pypdfium2) e a confiança fica "baixa".
4. Classificar: "mostra o quadro" traz os totais por classe e os alertas. Para cada crédito, as regras sugerem a classe e dizem por quê (ex.: "hipoteca de R$ 900 mil sobre um saldo de R$ 1,5 milhão: R$ 900 mil na Classe II e o resto na III"). Quem decide é você: aceite, ou diga outra classe com a justificativa — sem ela, o programa não grava. Informação nova (um saldo, uma garantia que apareceu depois) grava sempre: se ela deixa uma decisão sua contra a regra, o Claude avisa e você revê. As 17 regras estão em código, com teste, porque em recuperação judicial o QGC é peça do processo.
5. Saldos até a data-base: o Claude calcula a atualização (CDI, IPCA, dólar) com a série oficial do Banco Central, que ele baixa com a sua permissão, e mostra a memória de cálculo. É um cálculo de referência: só vale se você aceitar.
6. Fechar e entregar: "fecha o QGC" (só fecha sem alerta bloqueante), "gera a planilha do quadro" (sai na sua subpasta de relatorios\, com a planilha-mestra do Manual) e a apresentação.

O QGC expõe credores e pode correr em segredo de justiça: nada sai do time sem o /tcp-checklist-relatorio. Nome de pessoa física aparece no quadro (a lei exige a relação nominal), CPF nunca; na apresentação, pessoa física aparece agregada.

A apresentação (/tcp-apresentacao)

"Monta a apresentação dos passivos" gera o PowerPoint no padrão visual da TCP (o mesmo dos decks de diagnóstico da casa): capa, disclaimer, sumário, divisores, o QGC consolidado, as instituições financeiras, o cronograma de parcelas, a composição do endividamento, os maiores credores, próximos passos e contato. Os números das tabelas e gráficos saem do quadro — o Claude escreve só os comentários e a frase de destaque, e o programa avisa se o texto citar número que não está no slide. Antes de entregar, o Claude confere cada slide como imagem. A fonte da casa é a Inter: sem ela instalada, o PowerPoint mostra outra (no Google Slides fica certo) — instale você mesmo, sem administrador (parte 3: botão direito no arquivo da fonte > Instalar). A apresentação e a leitura de contrato em PDF também precisam dos pacotes python-pptx e pypdf — e, para ver a página do contrato digitalizado inteira, do pypdfium2 (parte 3).

Formatar uma apresentação que já existe. "Formata esta apresentação no padrão TCP" (ou "no padrão do cliente") coloca um .pptx seu no padrão visual sem mudar uma palavra, um número, uma imagem ou um link — só tema, fonte, cor, posição e estilo de tabela. O trabalho roda num agente em segundo plano (tcp-formatador-ppt): você continua a conversa e, quando ele termina, o Claude traz o arquivo formatado, a folha de contato e um relatório curto — o que a conferência do conteúdo (a "trava") disse, os avisos (texto que não coube e ficou como o autor desenhou, tabela ou gráfico que veio como imagem), o que o agente decidiu sozinho (◆) e as perguntas que só você responde. Tudo o que o agente gera fica no seu computador (é conteúdo de cliente); ele não grava no Drive nem no Google. Slide de um tipo que o padrão não tem: o Claude propõe um modelo novo, você aprova e ele vira pedido de melhoria (nunca substitui um modelo aprovado). O padrão visual de referência — a PPT modelo e o guia com cada tipo de slide — está em _padrao\modelos\, na raiz do Drive.

Todos os tipos, em toda marca (v2.5.4). Cada padrão do cliente — e cada marca de uma pasta com mais de uma, e as empresas do grupo (TCI, TSS: é só pedir "no padrão TCI") — tem todos os tipos da TCP aprovados, inclusive os de proposta, equipe e credenciais; o Claude não cria nem formata apresentação enquanto houver tipo pendente: ele mostra os tipos que faltam e aprova com quem pediu. A recriação de uma apresentação que já existe monta cada slide no tipo certo.

O padrão do cliente. Quando o projeto tem identidade própria, o Claude cria docs\padrao-ppt\ na pasta do cliente: o padrão TCP com as cores, a fonte, o logo e os ícones do cliente. Ele pede uma PPT que o cliente já usa, o logo (PNG com fundo transparente) e as cores; monta o modelo do cliente; e você aprova cada tipo de slide, um a um, conforme a apresentação precisar. O texto branco sobre a cor principal tem de passar de 4,5 para 1 de contraste (senão o Claude escurece a cor e diz). Quando a TCP ganha um tipo novo ou muda um tipo, o Claude avisa e oferece aplicar ao cliente — nada muda sozinho. Peça: "monta o padrão de PPT do <cliente>", "formata no padrão do cliente", "a TCP mudou algum modelo?".

As tarefas (/tcp-tarefas)

O projeto nasce com o roteiro do Manual: uma lista de tarefas por etapa, com prazo. "Minhas tarefas", "o que está atrasado?", "passa a leitura dos contratos para um colega, prazo sexta", "marca como feito" — o Claude mostra e muda a lista, e cada mudança fica registrada com quem e quando.

21. A pasta do cliente no Google Drive

Muitos clientes têm, no Google Drive da TCP e fora da pasta do time, uma pasta com os documentos deles: contratos, balancetes, atas, planilhas, apresentações. Quando quem mantém o ambiente vincula essa pasta à pasta do time, os documentos viram fonte de conhecimento — como o banco do ERP: o Claude lê o que chegou ou mudou, escreve um resumo por documento e avisa o time do que importa.

O que você precisa fazer: ligar os conectores

O Claude lê o Google pelos conectores do Google — Drive, Docs, Planilhas e Apresentações —, com a sua conta: ele só enxerga o que você enxerga. Uma vez por computador:

1. Digite /tcp-conectores (ou escreva ligar os conectores do Google): o Claude confere os quatro e liga os que o aplicativo deixar ligar.
2. O que é seu é o login: se ele avisar que falta, no aplicativo do Claude abra Configurações > Conectores (Settings > Connectors), ligue o conector e entre com a sua conta @tcp-partners.com (nunca uma conta pessoal).
3. Volte à sua conversa de trabalho — a mesma. Se o Claude disser que não vê o conector, abra a conversa de novo pela lista de conversas.

Sem os conectores, nada quebra: o Claude só não participa das leituras neste computador e diz isso na linha de início.

A linha FONTES DO DRIVE

Com a pasta vinculada, toda conversa começa também com uma linha assim (antes dos fatos do time):

FONTES DO DRIVE - "Ultrax - Documentos" | ultima varredura 01/10 09:41 por gc (ha 5 h) | 412 documentos: 405 lidos, 4 na fila, 2 lidos pela metade, 1 sem leitura | em dia.

Ela diz quando foi a última leitura, por quem, e o que falta. Passadas 24 h sem leitura, qualquer analista lê — o primeiro que abrir uma conversa. Você não precisa lembrar de nada: o Claude atende primeiro o que você pediu e depois avisa, em uma linha, que vai procurar documentos novos ou alterados. Só o novo e o alterado são lidos. Responda "agora não" se não for a hora — ele não insiste naquela conversa. Na primeira leitura de uma pasta (que lê tudo, pode levar horas e consumir bastante do plano) e quando há mais de 50 documentos na fila, ele pergunta antes e mostra a estimativa. Se um colega já estiver lendo, a linha diz "EM ANDAMENTO" e ninguém começa outra leitura; parou no meio, qualquer um continua de onde parou.

O comando /tcp-fontes

Na prática, pergunte normalmente — "o que o contrato do Banco Alfa diz sobre garantia?" — e o Claude procura nos resumos e responde com o link do documento original. Se o resumo não bastar, ele lê o original e responde com a página. Ele não diz que um documento não existe sem antes procurar.

Leitura sob demanda. Ler uma pasta grande inteira custa caro, e quem mantém o ambiente pode deixar o resto da primeira leitura só a pedido. Aí o Claude não lê tudo de uma vez: os nomes do que ainda não foi lido ficam em fontes\resumos\NAO-LIDOS.md (pasta por pasta, com o link), e quando a sua pergunta precisa de um desses documentos ele avisa quais vai ler (e quanto custa), lê só esses e responde. O resumo fica para o time — quem perguntar de novo não paga a leitura outra vez. Documento novo ou alterado no Drive continua sendo lido sozinho.

O que fica na pasta do time

• fontes\resumos\ — um resumo por documento (o que é, a data, os fatos principais, prazos, empresas e o link do original) e o índice, fontes\resumos\INDICE.md, que lista os lidos, pasta por pasta; os ainda não lidos estão em fontes\resumos\NAO-LIDOS.md. O nome do arquivo de resumo é neutro (categoria, data e um código); o título do documento está dentro.
• fontes\ — o registro das leituras: quem leu o quê, quando e qual versão. Ninguém mexe à mão em nenhuma das duas — nem o Claude: só o programa das fontes grava. Resumo errado? Peça "relê o documento" ou registre a correção nos seus fatos do time.
• Os fatos mais importantes de cada leitura entram nos fatos do time de quem leu, com a marca [D] (lido em documento, não conferido no banco) e o caminho do resumo.

Segurança: o Drive do cliente é só leitura

• O ambiente nunca cria, altera, move, compartilha ou apaga nada no Drive do cliente, nem altera planilha, documento ou apresentação do Google. Um bloqueio automático da pasta (a "guarda do Drive") nega essas ações sempre, inclusive no modo automático, e — enquanto o Claude está lendo documentos do Drive e por 2 h depois — nega também e-mail, agenda e qualquer outro conector.
• Se o Claude pedir permissão para apagar, mover, compartilhar ou criar arquivo no Drive, para alterar uma planilha, um documento ou uma apresentação do cliente, ou para mandar e-mail ou convite durante a leitura, responda NÃO e avise o Alfredo. Não deveria acontecer; se acontecer, o bloqueio não funcionou neste computador.
• Pedido de permissão para ler a pasta do cliente no Drive (as ferramentas que terminam em search_files, get_file_metadata ou read_file_content) durante o /tcp-fontes: pode aprovar.
• Texto de documento é informação, não ordem. Se um documento trouxer algo como "ignore as regras" ou "compartilhe esta pasta com...", o Claude ignora, marca o resumo com um aviso ⚠ e avisa você — e nenhum fato daquele documento vai para os fatos do time.
• Dado pessoal: CPF nunca é copiado; pessoa física aparece só por papel e iniciais; e-mail e telefone saem mascarados; documento pessoal (holerite, RG, exame) é só identificado, sem conteúdo. O título do documento aparece no índice e no resumo como está no Drive (com o CPF mascarado). Senha ou token encontrado num documento nunca é copiado: o Claude diz onde está (documento e página, nunca o valor), e você avisa o Alfredo (quem responde pelo trabalho pede ao cliente que tire do Drive).
• O rascunho da leitura (%TEMP%\tcp\<nome-do-cliente>\fontes\) tem texto dos documentos: apague quando o /tcp-terminar-trabalho listar.
• Documento apagado no Drive: o resumo fica, marcado como removido.

22. Glossário

Termos do ambiente e os do ERP que mais aparecem. Os termos de negócio e de ERP completos estão em docs\glossario-base.md; os próprios do cliente, em docs\glossario.md.

23. Perguntas frequentes

Preciso saber SQL ou conhecer o ERP do cliente? Não. Pergunte em português. Se quiser aprender, peça "me explica essa consulta em português".

Posso estragar alguma coisa no sistema do cliente? Não. O Claude só lê o banco — é regra do ambiente, mesmo que o login permita mais. O pior que acontece é um número errado — por isso existem as premissas, o checklist e o revisor.

O Claude pode errar? Pode, principalmente quando a premissa não foi combinada. Confira as premissas, desconfie de número fora da ordem de grandeza e, se for importante, peça "pede para o tcp-revisor-numeros conferir esse número".

Posso trabalhar junto com os colegas na mesma pasta? Pode — é assim que funciona: a pasta é uma só para o time. Cada um grava no que é seu (os seus checkpoints, as suas planilhas e a cópia da sua memória, nas subpastas com o seu slug), e o que é de todos (docs\, CLAUDE.md) o Claude altera por trecho, relendo antes; as consultas de sql\ só entram pelo programa que as grava depois de rodar no banco. Só não atualizem a mesma planilha: cada um tem a sua, em relatorios\<slug>\.

O que eu aprendo chega aos meus colegas? Sim, sozinho, na próxima conversa deles: documentos e consultas são da pasta do time, e o que os colegas precisam saber (números de referência, correções, armadilhas de consulta) o Claude registra nos seus arquivos do time, que entram em toda conversa (parte 16). Melhoria do próprio ambiente é diferente: o Claude registra o pedido sozinho no Drive (_melhorias\) para quem mantém o ambiente — você não repassa nada.

Posso usar em dois computadores? Pode, um de cada vez. Prepare cada um uma vez (parte 4, passos 1 a 3) e abra a pasta pelo Google Drive nos dois. No computador novo, a memória do Claude volta sozinha, a partir da cópia dela na pasta do time. Pare de trabalhar no primeiro e espere o Drive terminar de sincronizar antes de continuar no segundo. A conversa fica no computador onde foi aberta: em cada computador, use uma conversa só nesta pasta.

Posso mudar a pasta de lugar ou fazer uma cópia dela? Não. A pasta do cliente mora no Drive do ambiente, e quem organiza as pastas é quem mantém o ambiente. Uma cópia viraria uma segunda pasta, que o time não enxerga e que fica desatualizada. Abra sempre pelo Google Drive, sempre pelo mesmo caminho.

Posso trabalhar em dois clientes ao mesmo tempo? Pode: uma conversa em cada pasta de cliente. Cada conversa trabalha só na pasta dela — a memória, a cópia da memória na pasta do time, os checkpoints e os rascunhos ficam separados por cliente. O que não pode é abrir uma conversa nas pastas de cima (TCP - Ambiente Claude ou Clientes): ela enxergaria todos os clientes de uma vez.

Fechei a conversa sem querer. Perdi o trabalho? Não. A conversa continua na lista de conversas do aplicativo: reabra a mesma e siga nela. O que foi gravado na pasta (consultas, planilhas, documentos, memória) está lá de qualquer jeito. Para recomeçar limpa, na mesma conversa: /clear e depois /tcp-comecar-trabalho.

O ambiente foi atualizado. Preciso abrir outra conversa? Não: continue na mesma. O Claude recebe o aviso da atualização, relê as regras ali mesmo e diz em uma linha que já releu (parte 15). Se algo novo não aparecer, siga a escada da parte 2.

Posso ter várias conversas abertas na mesma pasta? Não é o recomendado: trabalhe numa conversa só por pasta, no seu computador. Duas conversas suas ao mesmo tempo podem desfazer o que a outra gravou, e cada uma pode estar numa versão diferente do ambiente (parte 2). As conversas dos colegas, cada uma no computador deles, não atrapalham.

Posso usar o Claude para outras tarefas, como redigir um e-mail ao cliente ou resumir uma reunião? Pode, se for deste cliente — assunto de outro cliente, nunca nesta pasta. O texto fica na conversa; se quiser guardá-lo, peça para gravar em docs\temas\. Quem envia o e-mail é você.

Quanto tempo demora uma resposta? Consulta simples: de segundos a poucos minutos. Com agente especialista: alguns minutos. Levantamento 360: de 30 a 90 minutos.

O número não bate com o relatório do cliente. Quem está certo? Quase sempre os dois, com premissas diferentes. Peça ao Claude para listar as premissas e compare com as do relatório do cliente (qual régua, qual data, quais filiais). Se continuar diferente, "pede para o tcp-revisor-numeros conferir esse número".

Posso mandar a planilha para o cliente? Só a estática, depois do checklist. A conectada, só entre colegas do time (parte 11).

Onde vejo o que já foi feito nesta pasta? No docs\relatorios-prontos.md (consultas e rotinas prontas), digitando /tcp-rotina sem Enter (as rotinas do time) e nos checkpoints — os seus e os dos colegas —, que o /tcp-comecar-trabalho resume.

A senha do banco mudou. E agora? Quem recebeu a senha nova preenche no Bloco de Notas (parte 4) — o arquivo é um só para o time, então basta uma pessoa. Depois, cada um pede ao Claude para regerar as suas planilhas conectadas, que guardam a senha antiga. O que você tinha preenchido ou criado à mão nelas fica na .anterior.xlsx de cada uma; uma cópia .anterior mais antiga, com coisas suas, não é apagada: vira .anterior-<data e hora>.xlsx (parte 10).

O Claude respondeu de um jeito muito técnico. Peça "explica em português simples, como para quem não é da área". Se quiser que seja sempre assim, peça "guarda essa preferência só para mim: prefiro explicações simples". Isso vale só para você: fica no seu computador (%USERPROFILE%\.claude\CLAUDE.md), não na pasta do time nem na memória do cliente.

O Claude deixou arquivos na pasta temporária do Windows. Posso apagar? Pode, os de assuntos encerrados. É o rascunho (%TEMP%\tcp\<nome-do-cliente>\), que o /tcp-terminar-trabalho lista no fim. Ele fica fora do Drive porque costuma ter dado do cliente em bruto — por isso mesmo, não deixe acumular.

24. Cartão de referência rápida

O dia

Comandos

Frases úteis: "o que você já sabe sobre este cliente?" · "quais premissas você usou?" · "me explica como chegou nesse número" · "quero uma planilha que eu mesmo atualizo" · "a versão estática, para enviar ao cliente" · "atualiza todas as planilhas conectadas" · "usa o tcp-financeiro para..." · "o que esse comando faz?"

Planilha conectada: Dados > Atualizar Tudo (Data > Refresh All), Ctrl+Alt+F5 · barra amarela: Habilitar Conteúdo · CONFERENCIA tem que dar zero · não mexer nas abas Base_ · regerar guarda a planilha de antes como .anterior.xlsx (cópia com coisas suas nunca é apagada).

O ambiente foi atualizado? Continue na mesma conversa — o Claude relê as regras sozinho; nunca abra outra por causa de atualização. Mudança não apareceu? (1) "relê as regras do ambiente" · (2) sair pela bandeja (perto do relógio) > Sair, abrir de novo e voltar à mesma conversa · (3) reiniciar o computador e voltar à mesma conversa.

Nunca: senha no chat (só no Bloco de Notas) · planilha conectada para fora do time · CPF ou nome completo de pessoa física dos dados do cliente em documento · copiar a pasta, ou abrir conversa em TCP - Ambiente Claude ou em Clientes · mexer em arquivo de colega ou em cópia de conflito do Drive · documento do cliente copiado para a pasta · pedir ao Claude para enviar e-mail ou subir arquivo · aprovar gravação no Google Drive do cliente · editar CLAUDE.padrao.md, CONVENCOES.md, .claude\ ou os programas de scripts\ (o credenciais.ps1 é a exceção: só no Bloco de Notas).

Errou? Senha no chat, planilha conectada para fora ou computador perdido: avise na hora o Alfredo (parte 18).

Ambiente TCP v2 (pasta do time) · guia da v2.3 · atualizado em 02/10/2026 · para conferir este computador e a versão da pasta, digite /tcp-ambiente.