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.
In this repository12 other files it gives its agents.
- docs-context7Skill
- graphifySkill
- grillingSkill
- licao-aprendidaSkill
- prSkill
- rememberSkill
- sem-cara-de-iaSkill
- skill-smithSkill
- spec-primeiroSkill
- veracidade-de-numeroSkill
- verifySkill
- wizardSkill
The file
Files
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
rgabaixo. - 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)
- Existe / onde? →
files_with_matches(só caminhos), não leia conteúdo ainda.rg -l "termo"· tool Grepoutput_mode:"files_with_matches". - Quantos / vale a pena? →
rg -c "termo"(contagem por arquivo). - Ver a fatia →
rg -n -C 3 "termo" arquivo(3 linhas de contexto, com nº de linha). Só entãoReadcomoffset/limitna 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).-wpalavra inteira,-Fliteral (regex off),-icase-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 cjspor extensão.
Conhecimento curado (markdown grepável, NUNCA RAG)
Escada do mais barato/relevante pro mais caro:
- Ranqueado (método Akita, FTS5) — comece por aqui p/ "onde decidimos X":
node "$HOME/.kit-memoria-ia/kit.mjs" buscar "<consulta>" -n 8Full-text BM25 sobredocs/knowledge/**, acento-insensível, siglas de linha (G/H/D) OK. Devolve caminho + título + snippet ranqueado → aí leia só a fatia comrg -n. Zero rede, zero deps, zero embedding (FTS5 é lexical, não vetor). Auto-reindexa quando os.mdmudam. (akita.mjs statusmostra o índice;--root <dir>busca em outra árvore;--rebuildforça.) - Exato/literal:
rg "<termo>" docs/knowledge/· handoffs emsessions/, decisões emdecisions/.
Anti-padrões (não fazer)
cat/Readde arquivo inteiro pra "dar uma olhada" → userg -nna fatia.rgsem filtro de pasta no repo todo (varrenode_modules/,dist/ebuild/).- 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).
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
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.

