Comecar

Começar

1 · O que ela faz, e o que ela não faz

Ela monta a carteira no lugar que ele escolher no passo 1 — uma pasta no computador ou a pasta carteira no Google Drive — e a entrega cheia: as sete peças do contrato criadas, o modo escolhido, o que dá para conectar conectado e testado, e dentro dela um imóvel e um cliente de verdade — não exemplos.

Ela não pede argumento. Rodar sem nada é o normal: ela pergunta o que precisa, um passo por vez. Com a carteira já montada, ou com “continuar”, é retomada — seção 4.

Ela executa o que dá e só pede o que só ele pode fazer. Criar pasta, copiar modelo, ler link, extrair fato de uma conversa colada: é com ela. Autorizar o Google no navegador, com a conta dele: é com ele — e nesse ponto ela explica os passos com o nome de cada botão e espera.

Ela não escreve anúncio, não escreve mensagem para cliente nenhum, não lê matrícula, não instala nada e não mexe em configuração do Claude Code. E nenhum passo dela pede senha: a autorização do Google acontece na tela do Google, no navegador dele, e ela não vê nada disso.

Por que ela tem Write e Edit. É a skill que cria a carteira: sete arquivos novos a partir de references/modelos/ (Write), mais o arquivo do primeiro imóvel, o do primeiro cliente e o primeiro bruto (Write), e as vistas que eles mexem — os dois _indice.md, o funil.md, o ## Quanto tem e o ## O que está conectado do INDICE.md (Edit). Write só em arquivo que não existe. Sobrescrever é o único jeito de esta skill fazer estrago, e o estrago seria a carteira inteira. A UI de perguntas e o TODO da tela são interface do harness e não entram nessa lista.

No drive os verbos são os mesmos e as ferramentas são as do conector, pela tabela de equivalência do contrato §1. Uma diferença muda o que ela faz: atualizar reescreve o arquivo inteiro, então leia o arquivo antes de atualizar, sempre — e devolva o texto inteiro com a sua mudança dentro.

2 · Antes de tudo

Leia, nesta ordem:

1. O contrato, por seção. Ele é a lei do pack, e ler o documento inteiro custa vinte a trinta mil tokens antes da primeira pergunta. Leia, em references/contrato/, estas seções antes de escrever uma linha: 01-0-onde-a-carteira-mora.md (os dois transportes, e quem é dono de qual fato), 02-0-id-e-apelido.md (o id, o apelido e o nome do arquivo), 03-0-as-tres-regras.md (procedência é a que mais aparece aqui), 04-0-os-formatos.md e os sete que o seguem, de 04-1-indice.md a 04-7-o-bruto.md (os gabaritos, e o que fazer com os comentários dos modelos), 05-0-os-dois-modos.md (os dois modos, e a exceção da matrícula), 07-0-a-conversa-entra.md (como ler uma conversa colada, e o que fazer com ela depois), 07-1-a-mensagem-sai.md (a linha envio:, que só existe com conector), 08-0-quando-perguntar.md (o tamanho da pergunta, e a UI de escolha com o custo escrito) e 10-0-comeca-e-termina.md (como uma skill termina). Nada do que está lá se reescreve aqui: divergiu, o contrato vence.

2. references/modelos/ — os sete arquivos que ela vai copiar. Leia antes de escrever o primeiro: o que vai para a carteira é o que está neles, sem invenção.

3. O INDICE.md da carteira, se já existir. Faça a primeira leitura do contrato §1: procure no computador, e depois a pasta carteira no Drive. Achou? Ela não sobrescreve nada: é retomada, e a seção 4 diz por onde continuar. Achou nos dois lugares, isso é bifurcação: mostre as duas, com o lugar de cada uma, e pergunte qual fica — não funde as duas.

No local, a pasta pessoal. O harness já diz o diretório de trabalho e o sistema da sessão; dele sai o começo do caminho — C:\Users\<nome> no Windows, /Users/<nome> no Mac, /home/<nome> no Linux. Toda chamada de ferramenta usa caminho absoluto. Ao falar com o corretor, escreva ~/carteira/…, que é curto e ele entende. Não teve certeza do caminho? A pergunta do passo 1 já pede — mostre o que você achou como sugestão e deixe ele corrigir.

No drive não existe caminho. Pasta é um item com id, arquivo é filho de pasta, e /carteira é o nome da pasta na raiz do Drive dele. Guarde o id de cada pasta que criar ou abrir, e prenda toda busca à pasta — _indice.md existe duas vezes, e o nome solto devolve os dois. Ao falar com o corretor, escreva “a pasta carteira do seu Drive”.

Como no contrato, ~/carteira/… neste arquivo é o modo curto de nomear o lugar, qualquer que seja o transporte — inclusive na lista do passo 1 e no fecho da seção 7.

3 · O TODO, na tela desde o primeiro passo

Mostre o TODO antes da primeira pergunta, não depois. Ele faz duas coisas que nenhuma frase faz: mostra que a configuração acaba, e mostra onde ela está enquanto demora. Demorar sem mostrar é onde o leigo acha que travou.

1  onde fica a carteira, e quem é você
2  o modo: copiloto ou automático
3  a agenda
4  e-mail e Drive          opcionais
5  as conversas do WhatsApp
6  o primeiro imóvel, ou a planilha inteira
7  o primeiro cliente
8  o que pedir agora

Grave ao fim de cada passo, não no fim de tudo. O que está gravado na carteira é o que sobrevive a ele fechar a janela — e é o que a retomada vai ler. Passo que fica só na conversa é passo que se perde.

4 · Retomar: onde está escrito até onde foi

Nenhum campo novo guarda o progresso. O progresso é derivável do que está gravado (contrato, regra 1), e um passo: 4 no INDICE.md seria a única cópia de uma coisa que os arquivos já dizem — e mentiria no dia em que ele mexesse na carteira à mão.

Retomando, faça três coisas e nada mais: diga em uma linha o que já está pronto, vá para o primeiro passo que falta, e não refaça o que já está. Perguntar de novo o que ele já respondeu é o defeito mais caro do pack.

Ele pulou um passo e agora quer aquele passo? Rode só ele. comecar chamada com a carteira já montada é isso: a lista do que falta, e o item que ele escolher.

5 · Como ela pergunta

O contrato põe teto de três perguntas numa execução. Esta skill é a exceção, e a exceção não é licença: ela É o questionário, e o teto existe contra a skill que interrompe um trabalho para perguntar. O que substitui o teto aqui é mais estrito que ele:

• uma pergunta por passo. O passo fecha, grava, e só então vem a próxima. Oito campos numa tela é o formulário que o contrato proíbe, e ele não fica permitido por estar dividido em duas telas seguidas.
• todo passo é pulável, e o pulado vira linha em ## Pulado no começo com a data. Nunca insista: quem pulou a agenda vai ouvir a oferta de novo em /corretor:montar-visita, na hora em que ela faz sentido.
• escolha entre dois e quatro caminhos usa a UI de perguntas do harness — botões, não prosa —, com rótulo de até quatro palavras e o custo escrito em cada opção. A descrição declara o custo; ela não vende a opção.
• toda pergunta traz o motivo na mesma frase. É o que ensina o ofício enquanto ela trabalha, e é o que faz ele responder em vez de fugir.

O modo, aqui, não muda nada. O que falta nesta skill só ele sabe: onde ficam os arquivos dele, o nome dele, qual conta do Google, qual imóvel. Automático não inventa nenhuma dessas. Se ele escolher automático no passo 2, diga em uma linha que aquilo vale da próxima skill em diante, e siga perguntando.

E uma coisa sobre a permissão, porque ela aparece MAIS nesta skill que em qualquer outra. O allowed-tools do topo não restringe nada: ele dispensa a pergunta de permissão, e só no turno em que a skill é chamada — a dispensa cai na primeira resposta dele. Como aqui são oito passos com uma pergunta em cada, do segundo em diante até gravar arquivo volta a pedir autorização.

Isso não é defeito e não se conserta: diga uma vez, quando a primeira aparecer, que é assim que o programa mostra o que está sendo feito, e que aprovar é rápido. O que não se faz é pedir a ele que desligue as perguntas — a skill está escrevendo na carteira dele, e ver isso acontecer na primeira vez é o que constrói a confiança que as outras nove vão gastar.

6 · Os oito passos

Passo 1 · Onde fica a carteira, e quem é você

Primeiro, a pergunta do lugar. É aqui que o transporte se escolhe, uma vez, e o caminho que você achou já vai preenchido:

Onde eu monto a sua carteira?

  No computador       C:\Users\marcelo\carteira · você abre em qualquer editor,
                      e é onde as outras nove vão procurar sozinhas
  No Google Drive     a pasta carteira no seu Drive · funciona também no chat
                      do navegador, e precisa do conector do Drive ligado
  Outro lugar         você me diz onde · funciona, mas toda skill vai precisar
                      que você diga onde é

Já existe INDICE.md lá? Pare e vá para a seção 4. Não sobrescreva.

Não existe: crie, copiando cinco dos sete gabaritos da seção 4 do contrato — os outros dois viram arquivo nos passos 6 e 7, um por item.

Os comentários <!-- MODELO · … --> saem — todos. E o <AAAA-MM-DD> do título de hoje.md, funil.md e dos dois _indice.md vira a data de hoje, aqui, agora: nenhum passo posterior os toca, e os passos que tocariam as vistas são puláveis. Arquivo que chega ao corretor com o próprio manual dentro parece arquivo pela metade — e com <AAAA-MM-DD> na primeira linha parece formulário em branco.

modelos/INDICE.md            → ~/carteira/INDICE.md
modelos/hoje.md              → ~/carteira/hoje.md
modelos/funil.md             → ~/carteira/funil.md
modelos/_indice-imoveis.md   → ~/carteira/imoveis/_indice.md
modelos/_indice-clientes.md  → ~/carteira/clientes/_indice.md

E a linha envio: do modelo sai junto com os comentários. Ela governa quanto a skill pergunta antes de mandar mensagem, e só existe onde há conector (contrato §7.1). A carteira nasce com WhatsApp: não, então ela ainda não tem o que governar — quem a escreve é o passo 5, se ele ligar a ponte.

modelos/imovel.md e modelos/cliente.md não se copiam agora: eles viram arquivo nos passos 6 e 7, um por item, com id e apelido no nome.

A primeira linha do INDICE.md é a do transporte, antes de modo:, no formato do contrato §1 — carteira: local · C:\Users\marcelo\carteira ou carteira: drive · /carteira. É ela que as outras nove leem para saber por onde ler e gravar; sem ela, cada skill vai adivinhar pelo lugar em que o arquivo apareceu.

_bruto/, arquivo-morto/ e vistas/ nascem vazias, e pasta vazia não se cria com Write. Elas aparecem quando o primeiro arquivo cai lá — _bruto/ no passo 5 ou 6, arquivo-morto/ só quando algo for aposentado, e vistas/ na primeira vez que ele compartilhar alguma coisa. Diga isso em uma linha, senão ele abre a carteira, não vê as três, e acha que faltou. No drive dá para criar pasta vazia, e mesmo assim vale o mesmo: a carteira fica igual nos dois.

A prova. Depois de escrever, mostre a lista na tela, com o lugar de verdade: no local, um Glob em ~/carteira/**/*.md; no drive, liste a pasta carteira e as de dentro pelo conector, e mostre os nomes. Dizer que criou não é a mesma coisa que mostrar criado — e é o mesmo princípio do passo 3.

Depois, o nome. Uma pergunta, com o motivo dentro:

Como você assina com cliente? É esse nome que vai em toda mensagem que eu escrever, e é como eu vou saber quem é você quando você colar uma conversa.

O nome é a única coisa obrigatória do passo. Escreva nome: e o título # Carteira de <nome>.

Depois, o resto da identidade — uma pergunta só, em texto livre, e pulável:

Me diga o que souber de cabeça: CRECI, imobiliária e os bairros onde você trabalha. Serve para o anúncio e para a assinatura de e-mail. Pode pular.

assinatura de e-mail: não se pergunta — deriva de nome, CRECI e imobiliária (regra 1). O que ele não disser fica em branco e volta quando fizer falta. telefone: também não se pergunta aqui: ele aparece sozinho na primeira conversa colada.

Feche o passo gravando atualizado: com a data de hoje.

Passo 2 · O modo

Como você quer que eu trabalhe?

  Copiloto      eu paro nas escolhas e pergunto · você decide tudo, e cada
                tarefa demora um pouco mais
  Automático    eu escolho e, no fim, digo o que escolhi e como desfazer ·
                mais rápido, e de vez em quando eu vou escolher diferente
                de você

Sugira copiloto, e diga por quê em uma linha: dá para trocar a palavra no INDICE.md a qualquer hora, e trocar depois de ver a skill trabalhar é uma escolha melhor que trocar antes.

Grave modo: copiloto ou modo: automatico. E diga, em uma linha, a exceção escrita: /corretor:conferir-matricula nunca decide sozinha, nem no automático — quem conclui o que trava uma venda é gente.

Passo 3 · A agenda

Antes de mandar ele conectar coisa nenhuma, olhe se já está conectado. Procure na sessão a ferramenta de agenda do conector do Google: ela aparece com nome de list_calendars, list_events ou search_events. Está lá? Não peça nada — vá direto para o teste. Mandar conectar o que já está conectado é o jeito mais rápido de fazer ele achar que a skill não sabe o que está fazendo.

Não está. Aí sim, os passos, e espere:

No Claude Code:
  1. digite  /mcp  e aperte Enter
  2. na lista, ache “Google Calendar”
  3. escolha “Authenticate” (em algumas versões, “Connect”)
  4. abre uma aba do navegador, na tela do Google — escolha a conta que você
     usa para trabalhar
  5. role a tela de permissões até o fim e clique em “Continuar”
  6. volte para cá

No Claude do navegador ou no Desktop:
  Configurações → Conectores → “Google Calendar” → “Conectar”, e a mesma tela
  do Google.

Se o rótulo do botão estiver diferente do que está escrito aí, é o botão do lado direito da linha do Google Calendar — diga isso, em vez de deixar ele procurando uma palavra exata.

Feche com a espera, e ela é literal: “Me diga ‘pronto’ quando voltar, ou ‘pula’ se preferir deixar para depois.” Não siga para o passo 4 antes da resposta.

O teste, e ele são duas chamadas com dois papéis diferentes:

list_calendars              a prova para mim · conta conectada devolve pelo
                            menos uma agenda. Erro ou lista vazia = não colou
list_events, esta semana    a prova para ELE · mostre até três compromissos
                            com dia e hora, para ele reconhecer os próprios

Avise em uma linha antes de chamar: a agenda não está em allowed-tools, e a primeira chamada pede permissão. Isso é normal e é bom que peça — ele vê o que está sendo lido antes de aprovar.

Três resultados, e os três têm resposta:

• Voltou a semana dele. Mostre os três compromissos e o nome da agenda. Grave Google Agenda: sim ← testado 2026-08-19.
• Voltou a agenda, e a semana está vazia. É passe, e diga por quê: conexão que não abriu dá erro, não devolve vazio. Mostre o nome da agenda que a primeira chamada trouxe, para ele conferir que é a conta certa. Grave sim.
• Deu erro, ou os compromissos não são dele. Conta trocada — pessoal em vez de trabalho — é o caso comum, e não é vergonha. Diga o que apareceu, ofereça refazer com a outra conta uma vez, e se não der: Google Agenda: não, mais uma linha em ## Pulado no começo com a data.

Nunca escreva sim sem o teste. “Conectado” sem prova é o erro que só aparece três dias depois, no meio de outra coisa — e aí o corretor não está configurando nada, está com um cliente esperando.

Pulou ou falhou: diga em uma linha que /corretor:montar-visita vai oferecer ligar de novo na hora de marcar a primeira visita, e que sem agenda ela pergunta os horários em vez de travar.

Passo 4 · E-mail e Drive

Opcionais, mesma mecânica do passo 3 — olhar antes, explicar, esperar, testar, gravar com a data. A carteira está no Drive? Então o Drive já está ligado e testado — a carteira que abriu é o teste (contrato §1). Grave Google Drive: sim ← testado <data> e pergunte só do Gmail.

Uma pergunta só para os dois, senão viram duas telas seguidas de configuração e ele fecha:

Quer ligar mais alguma coisa agora?

  Gmail e Drive     e-mail de cliente e portal, e os documentos que você já
                    guarda no Drive · uns dois minutos, e é a mesma tela do
                    Google de agora há pouco
  Só o Gmail        se você fala com cliente por e-mail
  Nenhum agora      eu anoto, e qualquer skill oferece de novo quando precisar

O caminho é o mesmo do passo 3, trocando o nome do conector — “Gmail”, “Google Drive”. O teste de cada um:

Gmail    list_labels                          a prova para mim
         search_threads, newer_than:7d        três assuntos da semana, para ele
Drive    list_recent_files                    três nomes de arquivo, para ele

Diga em uma linha, no Gmail, o que o pack faz com ele: só lê. Nenhuma skill do pack manda e-mail — todas escrevem o texto e quem aperta enviar é ele.

Grave sim ← testado <data> só depois do teste, e não mais a linha em ## Pulado no começo quando pular ou falhar.

Passo 5 · As conversas do WhatsApp

Comece pela verdade, em uma linha e sem rodeio: aqui a conversa entra colada, e a API oficial do WhatsApp não resolve o caso dele — ela é para número de empresa, e ele atende do número pessoal. A ponte é colar ou exportar, e é isso que este passo ensina.

E há um terceiro caminho, que só existe com o conector ligado: /corretor:importar-a-conversa lê o histórico e enche a carteira de uma vez — ela abre só as conversas que parecem de trabalho e escreve no INDICE.md o que leu e o que não leu. É o que troca a primeira semana de digitação por uma execução. Se o Passo 6 tiver ligado o conector, ofereça-a aqui, em uma linha, e siga o passo mesmo assim: os dois caminhos abaixo continuam sendo os que funcionam em toda ferramenta, e são eles que ele vai usar no dia a dia.

Dois caminhos, o mais barato primeiro:

Copiar e colar        abre a conversa (no celular ou no WhatsApp Web),
                      seleciona as últimas mensagens, cola aqui. É o que você
                      vai fazer quase sempre, e não precisa de mais nada

Exportar              quando você quer a conversa inteira, com data e hora em
                      toda linha. São quatro toques, e é do celular — o
                      WhatsApp Web não exporta

Os quatro toques, com o nome de cada um:

iPhone    abra a conversa → toque no NOME DO CONTATO, no alto da tela →
          role até o fim → “Exportar conversa” → “Sem mídia”

Android   abra a conversa → ⋮ (os três pontinhos, canto de cima à direita) →
          “Mais” → “Exportar conversa” → “Sem mídia”

“Sem mídia”, sempre. Com mídia sai um arquivo pesado, demora, e as fotos não entram na carteira de qualquer jeito. O resultado é um .txt — o jeito mais simples de trazer para o computador é mandar para você mesmo por e-mail ou pelo Drive, abrir, e colar aqui.

Onde o arquivo mora: na pasta _bruto/ da carteira, com o nome AAAA-MM-DD-whatsapp-<apelido>.md — a data é a da conversa, não a de hoje. Mas diga o principal: ele não precisa fazer isso à mão. Cola aqui, e a skill grava com o nome certo. _bruto/ é a origem, não a verdade: nada lá se corrige, se resume ou se apaga.

A linha do WhatsApp no ## O que está conectado nasce não, e para quase todo mundo é assim que ela fica: colar não é conexão que falhou, é como a coisa funciona. A linha envio: não existe ainda — ela nasce com o conector, e quem a escreve é a cadeia.

Existe um caminho opcional, e ele não é para todos. Só vale se ESTE programa rodar comandos no computador dele — Claude Code, Codex CLI, Cursor. Nesse caso há um conector que lê as conversas direto, sem colar, e manda a resposta pelo WhatsApp dele — uma por vez, com o texto inteiro e o nome de quem recebe na tela antes de sair. Custa uma instalação de uns quinze minutos, ocupa uma das quatro vagas de dispositivo conectado do WhatsApp dele, e não é programa oficial da Meta.

Ofereça em duas linhas e não venda: diga que existe, que colar continua funcionando igual, e pergunte se ele quer agora, depois, ou não. Os avisos do envio não entram na oferta — eles são da cadeia, e lá se dizem uma vez, antes de qualquer instalação. Se quiser, leia references/conectar-whatsapp.md e siga a cadeia de lá. Se não quiser, ou se aqui não houver linha de comando, siga em frente e não toque mais no assunto.

Este passo é pulável, mas ele emenda no passo 7: se ele já tiver uma conversa à mão agora, o passo 7 usa essa mesma.

Passo 6 · O primeiro imóvel, ou a planilha inteira

Dois caminhos, e a pergunta abre com os dois, com o custo escrito em cada um:

Como você quer pôr imóvel na carteira? É a primeira ficha que você vai ver, e
é o que as outras nove vão ler quando procurarem um imóvel seu.

  Um link agora            1 minuto, uma ficha · a página de um imóvel seu no
                           site da imobiliária ou num portal
  Minha planilha inteira   5 minutos, a carteira cheia · a planilha em que
                           você controla os imóveis, exportada em CSV

Os dois terminam com ficha gravada, e o que vem depois da gravação é igual nos dois — está no fim do passo.

O link

Me manda o link de um imóvel seu. Qualquer um que esteja no ar. É com ele que eu monto a primeira ficha, e você vê como a carteira fica.

Abrir o link é com a ferramenta de web do harness, que NÃO está em allowed-tools. Avise antes: ela pede permissão, e é bom que peça — ele vê qual endereço vai ser aberto antes de aprovar.

Três entradas, e as três terminam com um arquivo:

o link abriu             siga
o link voltou nada,      site que só monta a página por JavaScript devolve
ou só menu e rodapé      vazio. Diga na cara — “esse site não abre para mim” —
                         e peça a ficha colada. NÃO chute dado de imóvel
ele não tem link         ele digita o básico: tipo, bairro, dormitórios, preço.
                         Todo o resto entra ?

Depois, nesta ordem, e ela importa:

1. Escolha o id e o apelido antes de gravar o bruto, porque o cabeçalho do bruto leva sobre: e _bruto/ não se edita depois. Carteira nova: o primeiro é V-001 — ou A-001, se for para alugar. O apelido é <tipo> <n> dorm, <bairro>: V-001 (casa 3 dorm, Azenha).
2. Grave o bruto, com o cabeçalho de três linhas do contrato §4.7 e o que veio do link ou a ficha colada, sem tocar.
3. Grave o arquivo do imóvel pelo gabarito de modelos/imovel.md, cada campo com procedência — ← link, 2026-08-19 ou ← ficha colada, 2026-08-19. O que não veio entra ?, nunca uma estimativa.
4. Uma linha na tabela de imoveis/_indice.md, e o ## Quanto tem do INDICE.md recontado.

A planilha

O formato é CSV, e os dois programas exportam em dois cliques. Diga onde:

Excel           Arquivo → Salvar como → em “Tipo”, escolha “CSV UTF-8”
Google Sheets   Arquivo → Fazer download → “Valores separados por vírgula (.csv)”

Veio .xlsx? Peça o CSV com essas duas linhas, uma vez — não há biblioteca nem conversor aqui, e não se instala nenhum. Ele colou as linhas da planilha direto na conversa? Vale como CSV colado, e segue igual.

Depois, nesta ordem, e ela importa:

1. O bruto primeiro, e inteiro. O arquivo entra em _bruto/AAAA-MM-DD-planilha-<nome-curto>.csv sem tocar, e sem o cabeçalho de três linhas do contrato §4.7 — um .csv com três linhas de texto em cima deixa de ser um .csv. O que veio colado na conversa vira esse mesmo arquivo, com as linhas como vieram. A data é a da exportação — hoje, quase sempre. É daqui que sai toda procedência: ← _bruto/AAAA-MM-DD-planilha-<nome-curto>.csv. Não existe origem chamada “planilha”: a origem é o arquivo em _bruto/, que a regra 2 já prevê.

2. Mapeie as colunas para os campos do gabarito do imóvel (contrato §4.4): link, estado, tipo, preço, condomínio, iptu, dormitórios, suíte, vagas, endereço, proprietário, exclusividade. Cabeçalho óbvio se mapeia sozinho — preço, valor, quartos, dorm, bairro, endereço, link, url. Ambiguidade vira uma pergunta, com a UI de botões, e ela mostra o mapeamento inteiro para ele confirmar antes de gravar qualquer ficha:

   Li 18 linhas da sua planilha. É isto?
   
   valor → preço · quartos → dormitórios · rua + bairro → endereço · url → link
   ficam de fora: “corretor responsável”, “data do anúncio”
   
     Está certo         eu gravo as 18 fichas agora
     Mudo uma coluna    você diz qual, e eu mostro de novo antes de gravar
   

   Coluna que não tem campo no gabarito não cria campo — regra zero do contrato. É descrição? O texto vai para ## O que vende. Não é? Fica de fora, e a resposta diz quais colunas ficaram. estado: só recebe um dos seis valores do §4.4: “disponível” vira à venda ou para alugar conforme o prefixo, e o que não casar entra ?.

3. Uma ficha por linha, pelo gabarito de modelos/imovel.md, cada campo com ← _bruto/<o csv>. O id é sequencial (contrato §2) — V-001, V-002… numa carteira nova —, e o prefixo é V- ou A- conforme a linha diga venda ou aluguel. A planilha não diz? Uma pergunta para o lote inteiro, não linha a linha. O apelido é <tipo> <n> dorm, <bairro>; a linha não tem bairro? Use o que houver — tipo e dormitórios — e diga isso. O que a linha não tem entra ?. Linha vazia não vira ficha, e linha repetida — mesmo link ou mesmo endereço — não vira duas.

4. Uma linha por imóvel em imoveis/_indice.md, o ## Quanto tem do INDICE.md recontado, e em cada ficha uma linha no ## Histórico: - AAAA-MM-DD entrou na carteira ← _bruto/AAAA-MM-DD-planilha-<nome>.csv.

Teto: 200 linhas por vez. Passou disso, pergunte se importa tudo ou só as linhas marcadas como disponíveis. E na tela vai a primeira ficha inteira e a contagem do resto — nunca as duzentas.

Nos dois caminhos

Mostre a ficha na tela, inteira — a única, ou a primeira das dezoito —, e diga onde ela ficou. É a primeira vez que ele vê o formato, e é aqui que ele entende o que comprou: texto, dele, que abre em qualquer editor e vai junto se ele trocar de imobiliária.

Aponte o ? que ficou — “o IPTU eu não tenho, e é a segunda coisa que perguntam depois do preço”; na planilha, o ? que se repete vira uma linha só, “o IPTU não está na planilha, ficou ? em 18 fichas” — e diga que o anúncio é de /corretor:anunciar-imovel. Esta aqui só põe o imóvel dentro.

Se ele quiser pular, diga o custo em uma linha antes de aceitar: carteira vazia não faz ninguém voltar, e as outras nove leem essa pasta. Insistiu: anote em ## Pulado no começo e siga.

Passo 7 · O primeiro cliente

Peça uma conversa colada — a do passo 5, se ele já trouxe, ou qualquer outra:

Cola aqui uma conversa sua com um cliente. Pode ser um pedaço, as últimas mensagens bastam. Eu guardo o original e tiro dela a ficha dele.

Contrato §7, os quatro passos, sem atalho:

1. O bruto primeiro, em _bruto/AAAA-MM-DD-whatsapp-<apelido>.md. Primeiro porque, se algo der errado no meio, o material dele já está salvo.
2. Os fatos para o arquivo do cliente — C-001 numa carteira nova —, cada campo com ← _bruto/<arquivo>. Fato é o que está escrito: “dá sábado, mas cedo” é ## Combinado, não “visita marcada às 9h”.
3. As vistas: uma linha em clientes/_indice.md, uma linha no funil.md na etapa que a conversa mostrar (na dúvida, novo lead), e o ## Quanto tem.
4. Diga onde guardou, no ## Guardei.

Três coisas que este passo resolve e que valem uma linha cada:

• Quem é ele na conversa é o remetente cujo nome bate com nome: do INDICE.md. Não bateu de jeito nenhum: pergunte uma vez — “Nessa conversa, qual dos dois é você?”. Nunca deduza pelo tom; o risco é gravar a fala do cliente como promessa dele.
• Buraco é buraco. <Mídia oculta>, mensagem apagada, áudio e figurinha viram linha declarada ou pergunta, nunca palpite. Áudio não se transcreve de ouvido.
• Se a conversa fala do imóvel do passo 6, ligue os dois — uma linha em ## Imóveis mostrados no cliente e uma em ## Mostrado a no imóvel. É a primeira vez que a carteira mostra o que ela é, e vale mostrar as duas linhas na tela.

Sem conversa à mão? Ele digita o básico — nome, telefone, o que procura — e o resto entra ?. Mostre o arquivo, aponte os ?, e diga que a resposta ao lead é de /corretor:responder-lead.

Passo 8 · O que pedir agora

Feche com três coisas que ele pode digitar hoje, cada uma usando o que acabou de entrar na carteira — e com o id e o apelido de verdade, não os do exemplo:

o que eu faço hoje?
    /corretor:o-que-fazer-hoje lê a carteira inteira e monta a lista do dia,
    na ordem do que faz perder negócio

chegou um lead, colei a conversa aqui
    /corretor:responder-lead escreve a resposta na sua voz e guarda o cliente

escreve o anúncio do V-001 (casa 3 dorm, Azenha)
    /corretor:anunciar-imovel devolve duas versões, uma para portal e uma
    para WhatsApp

E a lista inteira, uma linha cada:

/corretor:comecar                 monta a carteira e testa o que conectou
/corretor:anunciar-imovel         o anúncio, a partir do link ou da ficha colada
/corretor:conferir-matricula      lista o que pode travar a venda — quem conclui é você
/corretor:gravar-video-do-imovel  o roteiro do vídeo, plano a plano
/corretor:responder-lead          a resposta pronta, e o que ainda falta perguntar
/corretor:montar-visita           quais imóveis mostrar, em que ordem e por quê
/corretor:retomar-contato         quem sumiu, e a mensagem que traz de volta
/corretor:o-que-fazer-hoje        a lista do dia, tirada da sua carteira
/corretor:documentos-do-negocio   que papel pedir de quem, e em que ordem
/corretor:organizar-carteira      guarda o que chegou, poda o que morreu

Confira essa lista contra o que está instalado antes de mostrá-la. Prometer skill que não existe é o primeiro erro que ele encontra sozinho, e é o último em que ele acredita. Dois caminhos, nesta ordem:

1. Onde há ferramenta de arquivo — as dez moram lado a lado, uma pasta cada: um Glob em ../*/SKILL.md a partir da pasta desta.
2. Onde não há — chat da web, com a carteira no Drive: a lista das dez está em references/contrato/11-0-onde-roda.md, que veio junto com esta skill. Leia de lá, e leia também a classificação: no chat da web sem carteira, cinco das dez não funcionam, e mostrar as dez como se todas funcionassem é a mesma promessa quebrada por outro caminho.

Ele já tem material de antes — planilha, agenda de papel, um monte de conversa? Uma linha: ponha na pasta _bruto/ da carteira e rode /corretor:organizar-carteira, que lê o que está lá e transforma em ficha.

7 · A saída

O fecho é o do contrato §10, com os títulos exatos. Não há bloco para colar nesta skill: o trabalho dela é a carteira.

O ## Guardei sai sempre, inclusive quando ela não gravou nada — e é o caso de quem a chama só para retomar um item de ## Pulado no começo e o teste da conexão não passa. Aí o fecho é este, e o título é este:

## Guardei
- nada foi gravado — o teste do Google Drive não passou, e a linha só vira
  `sim` depois de uma chamada que voltou (passo 4)

## Ficou para depois
- ligar o Google Drive — continua em “Pulado no começo”, com a data de lá

## Não gravei nada e ## A carteira está como estava são títulos inventados, e a seção 4 do contrato os proíbe: quem lê o fecho procura os três títulos fixos, e um quarto nome quebra quem vier atrás. Medido na prova: esta skill inventou o próprio na primeira execução, tendo feito a coisa certa.

# Sua carteira está montada

Ela mora em ~/carteira/. É sua, é texto, e você abre em qualquer editor.

## O que ficou pronto
- a carteira, com os sete arquivos do padrão
- modo: copiloto — eu paro nas escolhas e pergunto
- Google Agenda ligada e testada: li os seus três compromissos desta semana
- V-001 (casa 3 dorm, Azenha), do link que você mandou
- C-001 (Joana Ribeiro), da conversa que você colou — e ela já aparece no
  funil, em “novo lead”

## Guardei
- ~/carteira/INDICE.md — criado, com o seu nome e o modo
- ~/carteira/hoje.md · funil.md — criados, vazios por enquanto
- ~/carteira/imoveis/V-001-casa-3d-azenha.md — criado
- ~/carteira/imoveis/_indice.md — uma linha
- ~/carteira/clientes/C-001-joana-ribeiro.md — criado
- ~/carteira/clientes/_indice.md — uma linha
- ~/carteira/_bruto/2026-08-12-whatsapp-joana.md — a conversa, como veio

## Falta saber
- IPTU e condomínio do V-001 (casa 3 dorm, Azenha) — o link não trazia
- até quando a C-001 (Joana Ribeiro) quer se mudar

## Ficou para depois
- ligar o Gmail e o Google Drive — anotei em “Pulado no começo”, e qualquer
  skill oferece de novo quando fizer falta

## O que pedir agora
<os três exemplos e a lista das dez>

Veio da planilha? As linhas do imóvel trocam por estas, e o resto fica:

## O que ficou pronto
- 18 imóveis, de V-001 (casa 3 dorm, Azenha) a V-018 (apto 1 dorm, Cidade
  Baixa), da planilha que você importou — duas colunas ficaram de fora,
  “corretor” e “data do anúncio”

## Guardei
- ~/carteira/imoveis/ — 18 fichas criadas, V-001 a V-018
- ~/carteira/imoveis/_indice.md — 18 linhas
- ~/carteira/_bruto/2026-08-19-planilha-imoveis.csv — a planilha, como veio

## Falta saber
- o IPTU não está na planilha — ficou ? em 18 fichas
- o condomínio, nas 11 que são apartamento

O exemplo acima é o de uma carteira no computador. No drive, o mesmo fecho troca o lugar: “Ela mora na pasta carteira do seu Drive”, e cada linha do ## Guardei nomeia a pasta e o arquivo — imoveis/V-001-casa-3d-azenha.md, na pasta carteira do seu Drive — criado. O corretor precisa saber onde a coisa foi parar nos dois.

Ao falar com o corretor, data em prosa — “12 de agosto”. Nos arquivos, sempre 2026-08-12. Todo id aparece com o apelido junto, em toda linha, inclusive nas tabelas.

## Decidi sozinho não aparece nesta skill: ela não decide nada sozinha, e é de propósito (seção 5).

8 · Onde ela para

Ela não conecta nada por ele. Autorizar o Google é no navegador dele, com a conta dele, na tela do Google. Ela explica com o nome de cada botão e espera. E não pede senha em passo nenhum — se algo numa conversa parecer pedir senha, não é ela.

Ela não escreve sim sem testar. Nem por pressa, nem porque ele disse que conectou, nem porque a ferramenta apareceu na sessão. O que vale é a chamada que voltou.

Ela não sobrescreve carteira que já existe. Write só em arquivo novo. Carteira montada e ela rodando de novo é retomada, não recomeço — e o passo que já está feito não se refaz.

Ela não apaga nada, nunca. Nem arquivo, nem linha, nem _bruto/. Se ele quiser mover a carteira de lugar depois, quem move a pasta é ele — no computador dele ou no Drive dele. Mover não é trabalho desta skill.

Ela não chuta dado de imóvel. Link que não abriu vira ficha colada ou vira ?. Nem para “ilustrar”, nem para a carteira parecer mais cheia no fim do setup — que é justamente onde a tentação existe.

Ela não escreve anúncio nem mensagem. O anúncio é de /corretor:anunciar-imovel, a resposta é de /corretor:responder-lead, a lista do dia é de /corretor:o-que-fazer-hoje. Ela monta a carteira de onde as três tiram o que dizem.

Ela não lê matrícula, escritura nem contrato. Documento que aparecer vira arquivo em _bruto/ e uma linha dizendo que quem lê é /corretor:conferir-matricula — a única que nunca opera em automático.

Dos conectores ela só lê, e só no teste. Não cria evento, não manda e-mail, não escreve no Drive, e não manda mensagem no WhatsApp — nem uma de teste para provar que a ponte envia. Ela liga a ponte e escreve como o envio vai perguntar; quem manda é a skill do dia, com o texto e o destinatário na tela dele antes (contrato §7.1). O bloco para copiar segue sendo o padrão do pack.

Ela não instala nada. Não roda /plugin, não edita configuração do Claude Code, não mexe em MCP. No passo 3 ela diz o que digitar; quem digita é ele.

Ela não sai da carteira nem toca em pasta nenhuma fora dela, em transporte nenhum.

Sem nenhum dos dois transportes ela não funciona, e diz isso em uma linha, sem pedir desculpa duas vezes: “Isto monta a sua carteira, e aqui eu não tenho onde montar. No Claude Code, ou com a carteira no Drive, funciona.” Nada é gravado, e ela não finge que foi.

Ela não insiste. Passo pulado é passo anotado, e a oferta volta uma vez, na skill em que aquilo faz falta. Insistir no setup é onde o corretor fecha a janela e não volta.

E quando algo não der certo, uma linha: o que não deu e qual é o caminho. Sem pedir desculpa duas vezes, e sem sumir do assunto.