JuliusBrussee/caveman
“Token gasto é token que dava para medir.”
Construiu um modo de compressão de saída que virou uma plataforma de observabilidade de custo de LLM.
- 20
- skills
- 2.043
- linhas
- 8
- automáticas
- MIT
- licença
O ensaio
O caveman começa como piada e termina como planilha. A ideia de entrada é literal: um modo em que o agente fala como homem das cavernas — sem artigos, sem preâmbulo, sem "ótima pergunta!" — cortando saída pela metade sem perder precisão técnica. Funciona, e funciona melhor do que pedir "seja breve", porque o registro comprimido é definido por regra em vez de por gentileza. Mas metade do pacote não é piada nenhuma: é instrumentação. Descobrir quais workflows de LLM existem no repositório, rotear cada requisição por um gateway que mede, ranquear os sumidouros de token, propor corte com consentimento por edição. Essa metade exige configuração de nuvem e não roda sozinha. A divisão é clara e vale saber antes de instalar: o modo de fala é local e imediato; a observabilidade é um produto.
Instalar
CLI skills
No terminal, de qualquer diretório.
npx skills add JuliusBrussee/caveman -g
Alguns adaptadores recusam instalação global e aparecem como falha no log. O Claude Code não é um deles — instalou.
→O que essa instalação faz na sua máquinaFechar
Como o método funciona
O gerenciador da Vercel Labs. Usa o GitHub como registro, copia para ~/.agents/skills e cria symlink para cada agente instalado na máquina.
Precisa ter
- Node 18+
Onde cai no disco
~/.agents/skills/ + symlink em ~/.claude/skills/
O que liga sozinho
- Metade do pacote é local e não liga nada.
- A outra metade fala com o Caveman Cloud e só funciona depois de /caveman-setup no repositório.
Outras formas
- `-g` instala global; sem a flag, vai para ./.agents/skills do projeto.
Sair
npx skills remove JuliusBrussee/cavemanAs 20 skills
Falar como homem das cavernas
Modo de saída comprimida: corta token sem perder precisão técnica.
O CLAUDE.md virou monstro
Comprime arquivo de memória para caveman, guardando backup legível.
A correção mais estreita possível
Conserta bug na camada mínima responsável, com prova de regressão.
Quando delegar
Critério para mandar trabalho aos três subagentes do caveman em vez de fazer inline.
Commit só com a intenção
Mensagem em Conventional Commits, comprimida ao essencial.
Achar os workflows
Encontra e rotula todo workflow de LLM do repositório.
O que o Caveman achou
Revisão somente leitura das evidências: custo, Cave Score, traces, latência, erro, roteamento.
Explorar sem sujar o contexto
Explorador somente leitura que devolve citações path:linha, com as leituras fora do contexto principal.
O cartão de referência
Lista os modos, skills e comandos do caveman.
Agir sobre o relatório
Aplica correções de custo a partir dos sumidouros de token ranqueados, com consentimento por edição.
Ciclo de vida dos experimentos
Inspeciona experimentos do Caveman Cloud e bloqueia execução insegura.
Candidato com baseline
Transforma uma observação de otimização em candidato avaliado contra um baseline pareado.
Uma linha por achado
Revisão de código comprimida: local, problema, correção.
Ligar a medição
Passa as requisições do repositório por um gateway que mede, sem mudar comportamento.
O que a compressão rendeu
Mostra token de saída e de leitura de cache da sessão, atribuídos por modo.
Investigar antes de editar
Diagnostica falha ambígua produzindo hipóteses ranqueadas por evidência.
Construir sem inchar
Trabalho de feature com risco alto de overbuilding: reúso, escopo estrito, condição de parada explícita.
Transição reversível
Migração de schema, dado, API, protocolo, configuração ou dependência com rollback e prova de preservação.
Mexer sem mudar comportamento
Reestrutura código com verificação antes e depois de cada edição estrutural.
Provar e parar
Valida que o trabalho existente atende ao critério, sem expandir escopo.
Outros pacotes