Programação & Web
Cursor / Copilot
Codebase herdado: tour guiado pela arquitetura em 15 min
Tour guiado por repositório desconhecido: mapa de pastas, fluxo de uma request real e pontos perigosos antes de mexer.
0cópias
0joinhas
0favoritos
O prompt
Atue como um engenheiro sênior que conhece este repositório há anos. Me dê um tour guiado por {{repositorio_ou_projeto}}:
1. Visão geral: arquitetura em 5 linhas + mapa das 5-7 pastas principais com uma linha sobre o papel de cada uma.
2. Trace o caminho de {{fluxo_que_vou_trabalhar}} (ex.: POST /checkout) do entry point até o banco, listando cada arquivo do trajeto com arquivo:linha.
3. Aponte os 3 lugares onde eu mexeria para as tarefas mais comuns aqui: adicionar um campo, adicionar uma rota, mudar estilo.
4. Pontos perigosos: o que quebra se eu deletar ou mudar {{helper_ou_modulo_suspeito}}? Liste chamadores e efeitos em cascata.
5. Convenções implícitas: padrões que este projeto segue (nomes, erros, pastas) que não estão em lugar nenhum escrito.
6. Termine com 5 perguntas que só o autor original saberia responder - as que eu devo fazer ao time.
Não sugira refactorações nem mude código: este prompt é só para entender.
Como usar
- Rode num agente com acesso ao repo (Claude Code, Cursor, Copilot) com o projeto aberto; em chat comum, cole antes a saída de 'tree -L 2' e o package.json.
- Comece pelo fluxo que você vai trabalhar AGORA - tour genérico vira curiosidade inútil.
- Antes de deletar qualquer 'código morto óbvio', use o passo 4; helpers pequenos costumam ter 10+ chamadores.
- Salve o resultado em AGENTS.md/CLAUDE.md para o próximo agente (e o próximo dev) não repetir o tour.
- Valide o mapa: se a IA citou arquivo que não existe, desconfie do resto e peça referências com linha.
Exemplo de saída
Mapa de um monorepo Next.js + Fastify: 6 pastas mapeadas; POST /checkout passa por routes/checkout.ts:42 → services/checkout.ts → prisma; warning de que retryWithBackoff é usado em 12 lugares; convenção 'erros sempre via Result type' deduzida de 30 arquivos; 5 perguntas para o tech lead sobre o special case de trial.