Mapa de onboarding de repositório para Claude Code: escolher a primeira tarefa segura

O primeiro dia em um repositório existente decide se Claude Code ajuda ou gera ruído. Pedir “olhe tudo e melhore” parece eficiente, mas esconde escopo, risco e critério de pronto.

Este guia transforma os primeiros 30 minutos em um mapa de onboarding. Não é um documento de arquitetura enorme; é o mapa mínimo para escolher uma primeira tarefa segura.

Leituras relacionadas: claude-code-getting-started-complete, claude-code-existing-codebase-map, claude-code-first-30-minutes-checklist. A base oficial de instalação está em Anthropic Claude Code getting started.

Por que isso vem antes do primeiro comando

O centro deste tema é ordem de leitura, áreas protegidas, primeira edição e comandos de prova. Claude Code pode avançar rápido, mas quando a primeira entrada é ampla demais, diffs de baixo valor, hipóteses antigas e formatação sem impacto em receita recebem o mesmo peso do trabalho importante.

Para desenvolvedores iniciantes a intermediários entrando em uma base existente, a meta não é fazer a tarefa parecer grande. A meta é dizer o que ler, o que não tocar, o que tentar primeiro e para onde voltar se falhar. Isso vale para operação de conteúdo e desenvolvimento de produto.

Fluxo prático

1. Ler primeiro apenas README, package.json e uma rota principal
2. Escrever áreas protegidas antes de sugerir mudanças
3. Escolher tarefa reversível como texto, CTA ou nome de teste
4. Definir prova com build, diff e URL pública

Essa ordem muda o pedido de “pense livremente” para “trabalhe dentro deste limite e deixe prova”. Claude Code ainda pode raciocinar, mas as áreas perigosas ficam fechadas antes da primeira edição.

Situação	Movimento seguro	Prova a guardar
Site de conteúdo	Melhorar só o CTA final de um artigo popular e conferir Gumroad	build, diff, URL
SaaS	Clarear texto de settings sem tocar billing	build, diff, URL
Ferramenta interna	Renomear uma coluna CSV e testar com dados de exemplo	build, diff, URL

Com essa prova, Claude Code é avaliado pelo trabalho visível, não por uma frase confiante.

Prompt e código para copiar

Faça onboarding deste repositório para uma primeira tarefa Claude Code. Leia só README, package.json e rotas principais. Retorne tabela com áreas protegidas, menor tarefa útil e comandos de prova. Não edite ainda.

const repoMap = {
  goal: "find one safe first task",
  readFirst: ["README.md", "package.json", "src/routes/"],
  protectedAreas: [".env", "billing/", "migrations/", "wrangler.toml"],
  firstTask: "improve one article CTA without touching payment code",
  proofCommands: ["npm.cmd run build", "git diff --stat"],
};

function readyForClaudeCode(map) {
  return map.readFirst.length >= 2 &&
    map.protectedAreas.length > 0 &&
    map.proofCommands.some((command) => command.includes("build"));
}

console.log({ ready: readyForClaudeCode(repoMap), firstTask: repoMap.firstTask });

O código é uma checagem pequena. Em um projeto real, cole a saída em CLAUDE.md, issue ou nota de handoff para reutilizar a mesma decisão na próxima sessão.

Exemplos reais e falhas

Situação	Movimento seguro	Prova a guardar
Site de conteúdo	Melhorar só o CTA final de um artigo popular e conferir Gumroad	build, diff, URL
SaaS	Clarear texto de settings sem tocar billing	build, diff, URL
Ferramenta interna	Renomear uma coluna CSV e testar com dados de exemplo	build, diff, URL

• Ler tudo no começo gasta tempo com formatação de baixo sinal.
• Sem áreas protegidas, billing, auth e deploy viram alvos comuns.
• Sem comando de prova, a pessoa precisa adivinhar se o fechamento é verdadeiro.

A falha comum não é falta de capacidade do Claude Code. A fronteira de entrada era fina demais. Quando a fronteira é fina, o assistente amplia a tarefa para ajudar. Em artigos monetizados, escolher entre PDF gratuito, Gumroad e consultoria também faz parte dessa fronteira.

Levar o leitor ao PDF, Gumroad e consultoria

Se os comandos básicos ainda parecem confusos, comece pelo cheatsheet gratuito. Se o gargalo está em setup, permissões, CLAUDE.md, MCP ou CI, o próximo passo pago é o Setup Guide. Se você reescreve prompts de review, debugging ou refactor, use 50 Prompt Templates. Se houver adoção por equipe ou desenho de receita, avance para consultoria. A comparação de produtos começa em products.

Um CTA não precisa aparecer só no final. Perto da introdução, o PDF gratuito reduz atrito. Depois dos exemplos, Gumroad faz sentido. Quando o tema entra em equipe ou produção, consultoria vira o próximo passo natural.

Métricas para observar depois da publicação

Depois observe cliques no PDF gratuito, Setup Guide e visitas a /en/training/ vindas deste slug.

Depois de publicar, separe PV, leitura do início, cliques internos, cadastros no PDF gratuito, cliques Gumroad e visitas à consultoria. HTTP 200 não basta. h1, canonical, heroImage, CTA e corpo localizado precisam apontar para a mesma ação.