# Cavecrew

> Guía de decisión para delegar a subagentes estilo caveman: cuándo lanzar cavecrew-investigator, cavecrew-builder o cavecrew-reviewer en vez de hacerlo inline. Su salida viene comprimida, así el contexto principal dura más.

Fuente: https://skillsagentes.com/skills/juliusbrussee/caveman/cavecrew
Markdown: https://skillsagentes.com/skills/juliusbrussee/caveman/cavecrew.md

Repositorio: https://github.com/JuliusBrussee/caveman
Autor: JuliusBrussee
Licencia: MIT
Actualizado: hace 3 meses
Coste de contexto: 139 tok instalada, 984 tok al activarse, 1.7k tok con todos los archivos del bundle
Bundle: 2 archivos, 7 KB
Permisos que pide: ninguno declarado

## Instalación

Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina.

```bash
# Claude Code
npx -y skills add JuliusBrussee/caveman --skill cavecrew --agent claude-code
# Cursor
npx -y skills add JuliusBrussee/caveman --skill cavecrew --agent cursor
# Codex
npx -y skills add JuliusBrussee/caveman --skill cavecrew --agent codex
# Gemini CLI
npx -y skills add JuliusBrussee/caveman --skill cavecrew --agent gemini
# Windsurf
npx -y skills add JuliusBrussee/caveman --skill cavecrew --agent windsurf
# Cline
npx -y skills add JuliusBrussee/caveman --skill cavecrew --agent cline
```

## Qué hace

- Guía de decisión para delegar a subagentes estilo caveman: cuándo lanzar cavecrew-investigator (localizar código), cavecrew-builder (editar 1-2 archivos) o cavecrew-reviewer (revisar un diff) en vez de hacerlo inline.
- La salida de estos subagentes viene comprimida en estilo caveman, así el resultado inyectado de vuelta al contexto principal es ~60% más pequeño.
- Define contratos de salida exactos por agente: formato path:line, símbolos entre backticks, tokens terminales como "too-big." o "needs-confirm.".
- Describe patrones de encadenamiento: localizar → arreglar → verificar, scouting en paralelo, o edición directa cuando el sitio ya se conoce.

## Cuándo usarla

- Decidir si delegar una tarea a un subagente en vez de hacerla inline.
- Localizar código, hacer una edición quirúrgica de 1-2 archivos, o revisar un diff/rama/archivo.
- Sesiones largas donde conservar contexto principal importa (resultado comprimido).

## Cuándo no

- cavecrew-builder si el archivo aún no se conoce: primero investigator, o se gastan tokens innecesarios.
- Refactor de 3+ archivos o cross-cutting: usa el hilo principal o un code-architect, cavecrew-builder devuelve "too-big.".
- Pedir feedback general a cavecrew-reviewer: solo devuelve hallazgos, no opiniones de arquitectura.

## Qué la activa

- "usa cavecrew para encontrar dónde se define X"
- "delega esta edición de 2 archivos a cavecrew-builder"
- "revisa este diff con cavecrew-reviewer"

## Antes de instalar

- Ninguno explícito: es una guía de decisión sobre cuándo invocar los subagentes cavecrew-investigator/builder/reviewer ya empaquetados en el repo.

## Archivos

- README.md — 3 KB
- SKILL.md — 4 KB

## SKILL.md

Reproducido tal cual desde JuliusBrussee/caveman bajo MIT. Esta sección es el documento original y está en inglés.

Cavecrew = three subagent presets that emit caveman output. Same job as Anthropic defaults (`Explore`, edit-style agents, reviewer); difference is the tool-result they return is compressed, so main context shrinks per delegation.

## When to use cavecrew vs alternatives

| Task | Use |
|---|---|
| "Where is X defined / what calls Y / list uses of Z" | `cavecrew-investigator` |
| Same but you also want suggestions/architecture commentary | `Explore` (vanilla) |
| Surgical edit, ≤2 files, scope obvious | `cavecrew-builder` |
| New feature / 3+ files / cross-cutting refactor | Main thread or `feature-dev:code-architect` |
| Review diff, branch, or file for bugs | `cavecrew-reviewer` |
| Deep code review with rationale + alternatives | `Code Reviewer` (vanilla) |
| One-line answer you already know | Main thread, no subagent |

Rule of thumb: **if you'd want the subagent's output in 1/3 the tokens, pick cavecrew. If you'd want prose, pick vanilla.**

## Why this exists (the real win)

Subagent tool results get injected into main context verbatim. A vanilla `Explore` that returns 2k tokens of prose costs 2k tokens of main-context budget every time. The same finding from `cavecrew-investigator` returns ~700 tokens. Across 20 delegations in one session that's the difference between context exhaustion and finishing the task.

## Output contracts

What main thread can rely on per agent:

**`cavecrew-investigator`**
```
<Header>:
- path:line — `symbol` — short note
totals: <counts>.
```
Or `No match.` Always file-path-first, line-number-attached, backticked symbols. Safe to grep with `path:\d+`.

**`cavecrew-builder`**
```
<path:line-range> — <change ≤10 words>.
verified: <re-read OK | mismatch @ path:line>.
```
Or one of: `too-big.` / `needs-confirm.` / `ambiguous.` / `regressed.` (terminal first token).

**`cavecrew-reviewer`**
```
path:line: <emoji> <severity>: <problem>. <fix>.
totals: N🔴 N🟡 N🔵 N❓
```
Or `No issues.` Findings sorted file → line ascending.

## Chaining patterns

**Locate → fix → verify** (most common):
1. `cavecrew-investigator` returns site list.
2. Main thread picks 1-2 sites, hands paths to `cavecrew-builder`.
3. `cavecrew-reviewer` audits the diff.

**Parallel scout** (when investigation is broad):
Spawn 2-3 `cavecrew-investigator` calls in one message (different angles: defs vs callers vs tests). Aggregate in main thread.

**Single-shot edit** (when site is already known):
Skip investigator. Hand exact path:line to `cavecrew-builder` directly.

## What NOT to do

- Don't use `cavecrew-builder` when you don't already know the file. Spawn investigator first or main thread will eat tokens passing context.
- Don't chain `cavecrew-investigator → cavecrew-builder` for a 5-file refactor. Builder will return `too-big.` and you'll have wasted a turn.
- Don't ask `cavecrew-reviewer` for "general feedback" — it returns findings only, no architecture opinions. Use `Code Reviewer` for that.
- Don't expect prose. Cavecrew output is structured, sometimes terse to the point of cryptic. If a human will read it directly, paraphrase.

## Auto-clarity (inherited)

Subagents drop caveman → normal English for security warnings, irreversible-action confirmations, and any output where fragment ambiguity could be misread. Resume caveman after.

## Dónde encaja

- Categoría: [Herramientas para desarrolladores](https://skillsagentes.com/categorias/herramientas-desarrollo.md) — Skills que cambian cómo tu agente escribe, revisa y despliega código.
- Creador: [JuliusBrussee](https://skillsagentes.com/creators/juliusbrussee.md) — 7 skills en el directorio
- [Todas las skills](https://skillsagentes.com/skills.md)
- [Ranking de instalaciones](https://skillsagentes.com/ranking.md)

## Otras skills del mismo repositorio

- [Caveman](https://skillsagentes.com/skills/juliusbrussee/caveman/caveman.md): Modo de comunicación ultra-comprimido: corta ~65% de los tokens de salida (medido) manteniendo toda la precisión técnica. Soporta niveles lite, full (por defecto), ultra y variantes wenyan.
- [Caveman Compress](https://skillsagentes.com/skills/juliusbrussee/caveman/caveman-compress.md): Comprime archivos de lenguaje natural (CLAUDE.md, todos, preferencias) a formato caveman para ahorrar tokens de entrada. Preserva todo el contenido técnico, código, URLs y estructura.
- [Caveman Help](https://skillsagentes.com/skills/juliusbrussee/caveman/caveman-help.md): Tarjeta de referencia rápida con todos los modos, skills y comandos de caveman. Despliegue de una sola vez, no es un modo persistente.
- [Caveman Stats](https://skillsagentes.com/skills/juliusbrussee/caveman/caveman-stats.md): Muestra el uso real de tokens y el ahorro estimado de la sesión actual, leído directamente del log de sesión de Claude Code, sin estimación del modelo.
- [Caveman Commit](https://skillsagentes.com/skills/juliusbrussee/caveman/caveman-commit.md): Generador de mensajes de commit ultra-comprimidos: recorta el ruido preservando la intención y el porqué. Formato Conventional Commits, asunto ≤50 caracteres, cuerpo solo cuando el porqué no es obvio.

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)