codesteer-atlas: Instructions file for Codex

AGENTS.md

Instruções para agentes neste repositório. O Claude Code recebe o mesmo texto porque CLAUDE.md importa este arquivo.

Busca de código (MCP codesteer-atlas)

Use as tools do MCP antes de grep, rg, find, glob ou leitura em massa.

Objetivo	Tool
Se orientar num projeto desconhecido (chame primeiro, uma vez)	atlas_brief
Pacote da tarefa quando o símbolo/arquivo já é conhecido	atlas_context
Onde algo está implementado	atlas_search
Conectividade, hubs, rationale e impacto (affected)	atlas_graph
Diagnóstico do índice	atlas_status
(Re)indexar	atlas_index

Quando a tarefa já tem um símbolo ou arquivo, chame atlas_context(target, intent) primeiro (edit / debug / review / understand) em vez de encadear atlas_graph + atlas_brief. Use atlas_graph(mode="affected") para o raio de impacto.

atlas_search (2 passos): retorna só metadados por padrão — localize com path_prefix/language/top_k baixo; depois Read nas linhas ou include_content=true nos poucos hits relevantes. Não chame atlas_status antes: se o índice não existir, a própria tool explica como criá-lo.

grep/Read só depois que o Atlas indicar o arquivo: confirmar string ou erro literal, ler caminho que o usuário já deu, editar, diff, commit, git, CI ou testes. Fallback se o MCP estiver indisponível, a autenticação falhar, ou o índice estiver vazio ou desatualizado.

Índice desatualizado: atlas_status com is_stale: true (HEAD indexado diferente do workspace), reindexar com atlas_index, e só então usar grep/Read como recorte do momento — reindexar de novo ao fim da sessão.

1. Descoberta → atlas_search (semântico + BM25; só metadados).
2. Detalhe → Read no intervalo, ou include_content=true nos poucos hits que importam.
3. Literal → grep/Read quando a string exata importa.
4. Edição → ferramentas de arquivo e terminal (git, testes).

Frescor e cobertura do índice