Primeiro repo map com Claude Code: ler código existente sem gastar contexto

Em um repositório desconhecido, o erro não é apenas código ruim. O erro é pedir implementação antes de entender entradas, comandos, áreas de risco e prova mínima.

Por que este padrão importa

Um repo map economiza contexto e vira nota operacional. Você, reviewer e próxima pessoa passam a falar com a mesma base. Para iniciantes, esse ponto conecta naturalmente PDF grátis, Setup Guide e consultoria.

Leia também: Leia também 1, Leia também 2, Leia também 3.

Fluxo prático

No primeiro prompt, proíba edição. Peça leitura de README, package, rotas, testes e deploy. Antes de comandos, separe comandos seguros de áreas arriscadas. Depois escolha tarefa pequena, com prova rápida, sem auth nem cobrança.

Kit mínimo copiável

Read this repository for orientation only.
Do not edit files yet.
Return:
1. the main app entry points
2. the commands that appear safe to run
3. the files that define content, routes, and tests
4. three small first tasks ranked by verification cost
5. one risk that should block a larger change

repo_map:
  entry_points:
    - package.json
    - src/main.ts
  safe_commands:
    - npm run build
    - npm test
  first_task_rule:
    max_files: 3
    proof_required: true
    avoid_auth_and_billing: true

export function rankFirstTask(task) {
  const risk = task.touchesAuth || task.touchesBilling ? 10 : 0;
  const scope = task.filesChanged * 2;
  const proof = task.hasFastProof ? -3 : 4;
  return risk + scope + proof;
}

Exemplos reais

Em um site Astro, mapeie src/content, src/pages, BlogPostLayout e build antes de mexer em textos.
Em SaaS, marque auth, billing e migrations como risco e comece por README ou testes.
Em equipe, resuma o repo map no CLAUDE.md para a próxima pessoa continuar sem repetir exploração.

Checklist operacional

Este padrão é para repetir durante trabalho real com Claude Code. Ao mexer em artigo, página de produto ou caminho de consulta, use a lista como controle compacto.

Escreva o objetivo em uma frase e nomeie arquivos ou funções fora do escopo.
Separe arquivos que Claude Code deve ler dos que deve evitar.
Deixe pelo menos um comando de prova. Em conteúdo, veja URL pública além do build.
Confira se PDF grátis, Gumroad e consultoria estão consistentes no corpo e na CTA final.
Em posts localizados, confirme title, h1, início do corpo e CTA no idioma correto.
Não faça stage de arquivos sujos sem relação. Divida o diff novamente antes do commit se necessário.
Registre risco restante e próxima métrica para a próxima sessão começar limpa.

Para qual oferta conduzir

Se o leitor ainda não domina comandos, a primeira saída é o cheatsheet gratuito. Se o fluxo se repete toda semana, Prompt Templates padroniza review, debug e edição. Se o gargalo é permissions, CLAUDE.md, hooks, MCP ou CI/CD, Setup Guide é o caminho self-service. Se ownership, verificação pública e receita precisam ser desenhados em equipe, use consultoria.

O que deixar no handoff

O trabalho com Claude Code não termina quando o patch parece pronto. Ele fica útil quando a próxima pessoa entende a decisão sem refazer a sessão. O handoff deve trazer escopo alterado, motivo do escopo, comandos de prova, URL pública, destino das CTAs e risco restante. Em conteúdo, inclua heroImage, links internos, links externos, checagem de idioma e se PDF grátis, Gumroad e consultoria continuam no corpo. Em páginas próximas de produto, separe leitor que precisa só do grátis, leitor que deve comprar guia e leitor que precisa de ajuda.

Números para observar depois

PV sozinho não basta. Após publicar, veja indexação, países, cliques perto da CTA final, cliques Gumroad e visitas ao formulário. Em artigo popular existente, compare rejeição e próxima página antes e depois. Quando a próxima sessão Claude Code recebe esses números primeiro, decide por rota de receita em vez de apenas criar mais texto.

Casos de falha

Começar por feature deixa a mudança atravessar módulos antes de limites claros.
Sem comandos seguros, a prova final fica ambígua.
Sem mapa salvo, a próxima sessão gasta tokens redescobrindo a estrutura.

Caminho para PDF grátis, Gumroad e consultoria

Comece pelo PDF grátis para fixar comandos. Use Gumroad quando o fluxo se repetir e consultoria quando equipe, permissões ou receita exigirem desenho operacional.

Nota de verificação

O artigo aponta para codebase map, context management e first task runbook, além de CTAs para PDF grátis, Gumroad e consultoria.