Plugin de Claude Code · código abiertoClaude Code plugin · open source

token-economy

Cuatro agentes de revisión dejan de pagar cuatro veces por leer los mismos ficheros. Mismos hallazgos, una fracción del gasto en tokens — y la segunda pasada sobre el mismo objetivo sale casi gratis. Four review agents stop paying four times to read the same files. Same findings, a fraction of the token bill — and a second pass on the same target comes out almost free.

2,6×menos tokens por lentefewer tokens per lens
×7en la segunda pasadaon the second pass
12tests del scriptscript test cases
0comandos que aprendercommands to learn

Qué haceWhat it does

Cuando una tarea abre varios agentes a la vez —una revisión de código, una auditoría, una migración— cada uno suele re-escanear el mismo repo y redescubrir los mismos hechos. Ese re-escaneo repetido, no las respuestas, es el coste dominante en tokens del trabajo multiagente.When a task fans out several agents at once — a code review, an audit, a migration — each one usually re-scans the same repo and re-discovers the same facts. That repeated re-scanning, not the answers, is the dominant token cost of multi-agent work.

token-economy hace que ese descubrimiento pase una sola vez: un script determinista escribe un context-pack compartido, cada agente lo lee en vez de volver a escanear, y cada lente responde en formato corto. Opcionalmente, el output-style frugal (lo activas tú con /output-style) corta la narración del hilo principal. No hay comando que ejecutar — el skill se dispara solo cuando el trabajo lo pide.token-economy makes that discovery happen once: a deterministic script writes a shared context-pack, each agent reads it instead of re-scanning, and every lens answers in short form. Optionally, the frugal output-style (you turn it on with /output-style) cuts narration from the main thread. There's no command to run — the skill triggers itself when the work calls for it.

Ejemplo realReal example

Un design-review de 4 lentes (impeccable, taste, motion, a11y) sobre un mismo componente. Medido en una pasada real: ~108k tokens por lente si cada una re-lee el repo, ~42k con el pack compartido — el pack en sí cuesta ~74k una vez, amortizado entre las cuatro.A 4-lens design-review run (impeccable, taste, motion, a11y) on one component. Measured on a real pass: ~108k tokens per lens if each re-reads the repo, ~42k with the shared pack — the pack itself costs ~74k once, amortized across all four.

Cómo funciona, en diagramasHow it works, in diagrams

Diagramas interactivos hechos con Archify, sacados del propio repo: recorre los caminos, haz zoom o ábrelos a pantalla completa.Interactive diagrams built with Archify, taken from the repo itself: trace the paths, zoom in, or open them full screen.

Diagrama del gate de token-economy: antes del segundo agente, si los agentes abrirán algún fichero en común el context-pack es obligatorio; si trabajan en módulos disjuntos, se omite.Diagram of the token-economy gate: before the second agent, if the agents will open any of the same files the context-pack is mandatory; for disjoint modules it is skipped.
fig. 1El gate: binario, por fan-outThe gate: binary, per fan-outAbrir interactivo ↗ (pestaña nueva)Open interactive ↗ (new tab)

Por qué importaWhy it matters

Cómo se usaHow it's used

Lo instalas una vez y ya está — no hay flags que aprender. En cualquier tarea que abra varios agentes sobre el mismo código, Claude construye el pack, se lo pasa a cada agente, y responde en formato corto en vez de narrar paso a paso.You install it once and that's it — no flags to learn. On any task that fans out several agents over the same code, Claude builds the pack, hands it to each agent, and answers in short form instead of narrating step by step.

Compone conComposes with

Es el hogar independiente del mecanismo — el resto de la familia ya usa el mismo patrón por dentro, sin depender de este plugin para hacerlo.It's the standalone home of the mechanism — the rest of the family already uses the same pattern internally, without depending on this plugin to do it.

cavemancompresión de estilo — apila, sin colisiónstyle compression — stacks, no collision
claude-membackend de memoria preferidopreferred memory backend
design-reviewsus lentes ya corren read-only + terseits lenses already run read-only + terse
working-methodssu grill ya usa un pack compartidoits grill already uses a shared pack

Preguntas frecuentesFrequently asked questions

¿Qué hace token-economy?What does token-economy do?

Cuando varios agentes de Claude Code trabajan sobre el mismo código a la vez, hace que el descubrimiento del repo pase una sola vez: un script determinista escribe un context-pack compartido y cada agente lo lee en vez de volver a escanear el repo entero.When several Claude Code agents work on the same code at once, it makes repo discovery happen once: a deterministic script writes a shared context-pack and each agent reads it instead of re-scanning the whole repo.

¿Cuánto ahorra?How much does it save?

Medido en una revisión real de 4 lentes: ~2,6× menos tokens por lente, y hasta ×7 en una segunda pasada sobre el mismo objetivo, porque el pack se reutiliza entre ejecuciones.Measured on a real 4-lens review: ~2.6× fewer tokens per lens, and up to ×7 on a second pass over the same target, because the pack is reused across runs.

¿Cómo se instala?How do I install it?

Con /plugin marketplace add davidgarciagordo/claude-plugins y luego /plugin install token-economy@davidgarciagordo-plugins dentro de Claude Code. Sin paso de build ni comando adicional que aprender.With /plugin marketplace add davidgarciagordo/claude-plugins then /plugin install token-economy@davidgarciagordo-plugins inside Claude Code. No build step, no extra command to learn.

¿Es gratis y de código abierto?Is it free and open source?

Sí — licencia MIT, publicado en GitHub.Yes — MIT license, published on GitHub.

InstalaciónInstall

Un plugin, cero comandos que aprender.One plugin, zero commands to learn.

$ /plugin marketplace add davidgarciagordo/claude-plugins
$ /plugin install token-economy@davidgarciagordo-plugins