O painel do projeto
Mapa do código
O Mapa do código é um índice do projeto: os arquivos, as funções e quem usa quem. Ele é montado pelo motor do Faundr, no seu computador e sem IA, a partir do código e dos documentos.
Ele serve para duas coisas:
- Para o agente: em vez de abrir dezenas de arquivos para entender uma parte do código, ele pergunta ao mapa e recebe só o trecho que importa. Isso gasta menos tokens e dá respostas mais certas. O Insights mostra quanto isso economizou.
- Para você: ver como o projeto se organiza, que partes conversam entre si e o que pode quebrar se uma delas mudar.
Gerar o mapa
O mapa é gerado sozinho, em segundo plano, na primeira conversa do agente na pasta ligada. Para gerar ou refazer na hora, rode:
/faundr:map
Depois disso, o mapa se atualiza sozinho: quando o agente edita arquivos, ele é refeito no fim da resposta. As consultas também atualizam, antes de responder, os arquivos que mudaram.
O que fica de fora
O mapa lê só o código e os documentos do projeto. Ficam de fora:
- o que o
.gitignorejá ignora, e pastas comonode_modules,diste.venv; - as cópias do projeto que o agente cria para os subagentes (
.claude/worktrees); - bibliotecas compactadas e código gerado (
*.min.js, pacotes do build, arquivos de linhas enormes); - arquivos com senhas e chaves, como o
.env; - o que estiver no
.faundrignore(veja abaixo).
Num projeto com mais de 5.000 arquivos, o código entra primeiro e o Faundr avisa o que ficou de fora.
Tirar pastas do Faundr com o .faundrignore
Para tirar uma pasta de propósito (código de terceiros, um repositório clonado só para consulta, arquivos gerados), crie um arquivo .faundrignore na raiz do projeto, no mesmo formato do .gitignore: uma pasta ou um arquivo por linha. Exemplo:
refs/ vendor/
O .faundrignore não vale só para o mapa. A pasta também sai do Fora do plano da Arquitetura, das regras de design e das checagens que procuram as partes do projeto (as subpastas com dependências próprias, como frontend/ ou apps/web/).
Linguagens
O mapa entende o código de JavaScript e TypeScript (inclusive React Native, Vue, Angular, Svelte e Astro), Python, Flutter e Dart, PHP, Go, Java, Kotlin, C#, Rust, C e C++. Em HTML, CSS, Tailwind e Docker não há funções para mapear, então eles ficam fora do mapa (as outras checagens do Faundr continuam valendo para eles). Os documentos em Markdown entram em qualquer projeto.
Para ver o que o Faundr faz em cada linguagem, abra Stack → O que o Faundr cobre no painel, ou a página Linguagens suportadas.
Abas
| Aba | O que mostra |
|---|---|
| Visão geral | O projeto em áreas, organizadas em colunas: telas, peças visuais, entradas (APIs e plugins), lógica, dados, documentação e técnico. Clique numa área para ver o que tem nela e com quais outras ela conversa. Clique de novo para abrir. |
| Arquivos | Os arquivos, com o ícone do tipo. Clique num arquivo para ver o que ele usa e por quem é usado, e para ir ao código dele. |
| Código | O mapa técnico completo: cada função e arquivo como um ponto, agrupados em comunidades. Para quem quer ver o detalhe. |
| Relatório | O relatório em texto gerado pelo motor, com as comunidades e as peças centrais. |
Ver como duas partes conversam
Na Visão geral e em Arquivos, cada ligação tem Ver como conversam, que explica em duas frases, sem IA, como uma parte usa a outra. O botão Entender copia um pedido pronto para a IA explicar em detalhe (/faundr:map).
Opções no topo
- Detalhes técnicos: na Visão geral e em Arquivos, mostra também configuração, testes e pacotes externos, que ficam escondidos por padrão.
- Ocultar nomes: na aba Código, esconde os nomes e o painel lateral. Serve para mostrar o mapa (num pitch, num post) sem expor o código.
Perguntar ao mapa
Pergunte com /faundr:map <pergunta>, ou deixe que o agente use sozinho: o Faundr orienta o agente, e os subagentes que ele abre, a consultar o mapa antes de ler arquivos.
Exemplos de perguntas úteis:
/faundr:map como o login funciona? explique em português simples/faundr:map o que quebra se eu mudar o AuthGate?/faundr:map como a tela de projetos chega no banco?
.faundr/mapa/, dentro do projeto.Comandos
O Mapa do código é montado pelo motor do Faundr, sem IA, a partir do código e dos documentos. Use estes comandos no seu agente de IA, na pasta ligada ao projeto.
Depois da primeira vez, o mapa se atualiza sozinho sempre que o agente edita arquivos.
/faundr:mapGera o mapa do código pela primeira vez (ou refaz agora) e envia para o painel.
/faundr:map <pergunta>Faz uma pergunta sobre o código; o mapa devolve as partes mais relevantes já com o código e quem as usa, e a IA responde citando arquivo e linha. Serve também para "o que quebra se eu mudar X?" e "como A chega em B?".
ex.: /faundr:map o que quebra se eu mudar o AuthGate?
!faundr graph-query "<pergunta>"A mesma pergunta, direto no terminal e sem IA: o mapa devolve as partes mais relevantes já com o código.
ex.: !faundr graph-query "como funciona o login"
!faundr graph-path "A" "B"Mostra como duas peças do projeto se conectam.
ex.: !faundr graph-path "LoginPage" "supabase"
!faundr graph-callers "X" [--out | --both] [--depth 2]Quem usa X. --out mostra o contrário (o que X usa); --both, os dois. --depth 2 mostra o efeito em cadeia.
ex.: !faundr graph-callers "AuthGate" --depth 2
!faundr graph-skeleton <arquivo>O resumo de um arquivo: cada função com o cabeçalho, sem o corpo.
ex.: !faundr graph-skeleton src/lib/auth.ts
!faundr graph-grep "<texto>" [--in <pasta>] [-i]Procura um texto e agrupa os resultados pela função onde aparecem, as mais usadas primeiro. -i ignora maiúsculas.
ex.: !faundr graph-grep "session" --in src