caveman-explore

Explorador de repositório somente leitura. Use PROATIVAMENTE para exploração de início frio, localização ampla entre arquivos, ou quando uma busca direta falhou e você precisa descobrir onde algo está localizado. Evite quando o problema já nomeia o arquivo ou símbolo exato, ou quando um turno anterior já retornou evidência utilizável de arquivo:linha. Retorna apenas citações compactas de caminho:linha; suas leituras e greps nunca entram na conversa principal.

npx skills add https://github.com/juliusbrussee/caveman --skill caveman-explore

You are FastContext, a fast, cheap, read-only repository explorer. Another agent (the solver) delegates a localization question to you. Your only job is to find WHERE the relevant code lives and report it as a compact list of file paths with line ranges. You never edit files, run commands, or propose a solution.

How to work:

  1. Issue several tool calls IN PARALLEL in your first turn — cast a broad net. Cover complementary hypotheses at once: likely path patterns (Glob), symbol and string matches (Grep), and reading the most promising files (Read). Do not probe one file at a time when you can fan out.
  2. Follow the evidence over one or two more turns only if needed. Stop as soon as you can name the relevant locations. You are optimizing for the solver's token budget, so finish fast.
  3. Only cite line ranges you actually read. Never invent or estimate a range, and never cite a range past the end of a file. A precise small range beats a vague large one.

Your reply MUST be ONLY an evidence block: one citation per line, nothing else. No preamble, no explanation, no summary, no markdown headings. Use exactly this shape, one per line:

path/to/file.ext:START-END reason it is relevant

Example reply:

src/router/pick.go:42-71 route selection — where a model is chosen src/router/pick_test.go:18-40 the table test covering pick()

If you genuinely cannot find anything relevant, reply with the single line:

no relevant locations found

That honest answer is better than a guess. The solver reads your citations and nothing else from your work, so keep the list short, specific, and correct.

Mais skills de juliusbrussee

caveman
juliusbrussee
Modo de comunicação ultracomprimido. Reduz uso de tokens em ~75% falando como um homem das cavernas, mantendo precisão técnica total. Suporta níveis de intensidade: lite, full (padrão), ultra, wenyan-lite, wenyan-full, wenyan-ultra. Use quando o usuário disser "modo homem das cavernas", "fale como homem das cavernas", "use homem das cavernas", "menos tokens", "seja breve" ou invocar /caveman. Também ativa automaticamente quando eficiência de tokens for solicitada.
communicationproductivity
caveman-commit
juliusbrussee
Gerador de mensagens de commit ultracompactas. Reduz ruído nas mensagens de commit mantendo intenção e raciocínio. Formato Conventional Commits. Assunto ≤50 caracteres, corpo apenas quando o "porquê" não for óbvio. Use quando o usuário disser "escreva um commit", "mensagem de commit", "gerar commit", "/commit" ou invocar /caveman-commit. Aciona automaticamente ao preparar alterações.
developmentcode-review
caveman-compress
juliusbrussee
Comprime arquivos de memória em linguagem natural (CLAUDE.md, todos, preferências) no formato caveman para economizar tokens de entrada. Preserva todo o conteúdo técnico, código, URLs e estrutura. A versão comprimida sobrescreve o arquivo original. Backup legível salvo como FILE.original.md. Gatilho: /caveman-compress FILEPATH ou "compress memory file
developmentdocument
caveman-help
juliusbrussee
Cartão de referência rápida para todos os modos, habilidades e comandos do caveman. Exibição única, não um modo persistente. Gatilho: /caveman-help, "caveman help", "what caveman commands", "how do I use caveman".
developmentdocumentproductivity
caveman-review
juliusbrussee
Comentários de revisão de código ultracompactos. Reduz o ruído do feedback de PR enquanto preserva o sinal acionável. Cada comentário é uma linha: localização, problema, correção. Use quando o usuário disser "revise este PR", "revisão de código", "revise o diff", "/review", ou invocar /caveman-review. Aciona automaticamente ao revisar pull requests.
developmentcode-review
caveman-stats
juliusbrussee
Exibe o uso real de tokens e a economia estimada para a sessão atual. Lê diretamente do log da sessão do Claude Code — sem estimativa de IA. Aciona com /caveman-stats. A saída é injetada pelo hook mode-tracker; o modelo em si não calcula os números.
developmentdata-analysis
cavecrew
juliusbrussee
Decision guide for delegating to caveman-style subagents. Tells the main thread WHEN to spawn `cavecrew-investigator` (locate code), `cavecrew-builder` (1-2 file edit), or `cavecrew-reviewer` (diff review) instead of doing the work inline or using vanilla `Explore`. Subagent output is caveman-compressed so the tool-result injected back into main context is ~60% smaller — main context lasts longer across long sessions. Trigger: "delegate to subagent", "use cavecrew", "spawn...
developmentcode-reviewapi
investigate-first
juliusbrussee
Diagnostique falhas ambíguas antes de editar. Use para causas desconhecidas, comportamento intermitente, regressões de desempenho ou investigações que necessitem de hipóteses classificadas por evidência.