agentleFS
adeiltonpessiniadeiltonpessini/kit-memoria-ia/.claude/skills/busca-eficiente/SKILL.md

busca-eficiente

Skill0 starsChanged 6 days agoApache-2.0View on GitHub

Use sempre que for procurar algo no repo ("onde está X", "como usamos Y", "o que quebra se mudar Z") antes de ler arquivo inteiro. Playbook econômico: ripgrep + leitura da fatia mínima, ast-grep para padrão de código, fd para arquivo, akita para o acervo.

The file

Files
SKILL.md

busca-eficiente: grep antes de ler tudo (método Akita)

Princípio: grepe a fatia → leia só ela. Nunca despeje arquivo/repo inteiro no contexto. Cada linha trazida custa token; busca afiada é a maior economia que existe.

Antes de tudo: a pergunta é de TEXTO ou de ESTRUTURA?

  • Texto (string, valor literal, config, nome de evento) → escada de rg abaixo.
  • Estrutura de código ("toda função que publica em cmd", "todo handler sem o middleware de auth") → ast-grep: sg -p 'publish($$$)' -l go (ex.: sg -p '$C.Publish($$$)' -l go).
  • Regra prática: se o plano é abrir 3+ arquivos "para entender", pare e grepe a fatia. O grafo graphify não está instalado neste repo.

Escada de busca (do mais barato pro mais caro)

  1. Existe / onde? → files_with_matches (só caminhos), não leia conteúdo ainda. rg -l "termo" · tool Grep output_mode:"files_with_matches".
  2. Quantos / vale a pena? → rg -c "termo" (contagem por arquivo).
  3. Ver a fatia → rg -n -C 3 "termo" arquivo (3 linhas de contexto, com nº de linha). Só então Read com offset/limit na linha que o grep apontou — nunca o arquivo todo.

Flags que mais economizam

  • -l (só nomes) / -c (contagem) — triagem antes de puxar conteúdo.
  • -g '!{node_modules,dist,.git,build,.dart_tool,__pycache__}' — corte ruído (build gera MB).
  • -t go / -t js / --type sql — restrinja a linguagem em vez de varrer tudo.
  • -o — só o trecho casado (ex.: extrair nomes de função/rota sem a linha inteira).
  • -w palavra inteira, -F literal (regex off), -i case-insensitive só quando preciso.
  • -m 5 — pare após N matches por arquivo (amostra, não exaustivo).
  • multiline (rg -U) só quando o padrão cruza linha — caro, use por último.

Arquivos (não conteúdo)

  • fd <padrão> ou o tool Glob (**/*.go). fd -e sql -e cjs por extensão.

Conhecimento curado (markdown grepável, NUNCA RAG)

Escada do mais barato/relevante pro mais caro:

  1. Ranqueado (método Akita, FTS5) — comece por aqui p/ "onde decidimos X": node "$HOME/.kit-memoria-ia/kit.mjs" buscar "<consulta>" -n 8 Full-text BM25 sobre docs/knowledge/**, acento-insensível, siglas de linha (G/H/D) OK. Devolve caminho + título + snippet ranqueado → aí leia só a fatia com rg -n. Zero rede, zero deps, zero embedding (FTS5 é lexical, não vetor). Auto-reindexa quando os .md mudam. (akita.mjs status mostra o índice; --root <dir> busca em outra árvore; --rebuild força.)
  2. Exato/literal: rg "<termo>" docs/knowledge/ · handoffs em sessions/, decisões em decisions/.

Anti-padrões (não fazer)

  • cat/Read de arquivo inteiro pra "dar uma olhada" → use rg -n na fatia.
  • rg sem filtro de pasta no repo todo (varre node_modules/, dist/ e build/).
  • Re-ler arquivo/saída já vista nesta sessão.
  • Varredura ampla no braço → delegue ao subagente Explore (devolve só a conclusão).

Ver também: CLAUDE.md, docs-context7 (docs de lib), remember (anotar achado).

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.