---
name: token-economy-meta
description: Используй, когда нужно снизить полный расход токенов AI-агента, найти крупнейший token tax, выбрать один готовый open-source рычаг и доказать экономию paired benchmark.
---

# token economy meta-skill

## цель

уменьшить полный расход токенов и стоимость одной задачи, прошедшей фиксированный acceptance gate. качество — ограничение эксперимента, а не целевая функция.

## вход

- target repo или agent workflow;
- 3–10 репрезентативных задач;
- текущий model/provider/tool stack;
- доступные traces или provider usage;
- bundle с `open-source-market-map.tsv`, benchmark manifest и ledger schema.

## progressive disclosure

1. сначала прочитай только этот файл и строку target category в `open-source-market-map.tsv`;
2. прочитай `token-economy-benchmark-manifest.yaml`, когда определён acceptance gate;
3. прочитай `accepted-token-ledger.csv`, когда доступны traces;
4. открывай README/code только у двух shortlisted repositories;
5. обновляй market research, только если snapshot старше 30 дней, repo недоступен или нужный механизм не подтверждён.

## основной metric

```text
tokens_per_accepted_task =
  sum(all model + router + compressor + embedding + failed-run tokens)
  / accepted_tasks
```

`cost_per_accepted_task` считается вторым metric. качество фиксируется до оптимизации. reported token reduction без gate не считается успехом.

## workflow

### 1. зафиксируй gate

запиши exact command или machine-checkable verifier. перечисли условия, которые нельзя ухудшать: success rate, safety, integrity, latency.

### 2. сними baseline

для каждого run сохрани:

- task id и commit;
- uncached, cached, cache-write, output и reasoning tokens;
- tool schema, tool result и context shares;
- attempts, retry reason и state fingerprint;
- router/compressor/embedding cost;
- gate result и wall time.

### 3. найди главный tax

классифицируй его в один слой:

- `task_slice`
- `repo_retrieval`
- `skills_tools`
- `cache_layout`
- `model_routing`
- `compression_serialization`
- `retry_output`

назови один discriminating measurement. не меняй несколько слоёв одновременно в первом trial.

### 4. выбери один минимальный рычаг

используй market map:

- repo context: Aider или OpenHands;
- gateway/routing: LiteLLM, Portkey или RouteLLM reference;
- progressive tools: Agent Skills, FastMCP, Composio или Cloudflare Code Mode;
- observability: Langfuse, Phoenix или Opik;
- eval: native tests, Promptfoo или SWE-bench;
- compression: LLMLingua/TOON только как отдельный ablation.

для каждого кандидата запиши: mechanism, integration cost, license, maintenance, escape hatch и raw usage export.

### 5. проведи paired trial

одинаковые tasks, commits, permissions, verifier и primary implementation model. treatment меняет один слой. randomize order; включи все failed runs в numerator.

### 6. реши

`adopt`, если качество прошло заранее заданную non-inferiority границу, tokens per accepted task снизился и новый слой не создал скрытый operational burden. стоимость должна быть показана отдельно.

`hold`, если сигнал положительный, но выборка мала или accounting неполный.

`reject`, если savings исчезают после учёта retries/router/compressor или gate ухудшается.

## рабочие дефолты

- маленький старт: `Aider -> LiteLLM -> Langfuse -> native tests/Promptfoo`;
- platform-first: `OpenHands -> LiteLLM -> Phoenix -> SWE-bench subset`;
- tool tax: `Agent Skills -> tool search/Code Mode -> trace backend`;
- long prose/logs: LLMLingua ablation;
- large JSON-like output: TOON ablation.

## границы

- semantic cache не используется для mutable actions, permissions и verification;
- code identifiers, paths, diffs, policies, commands и exact errors не сжимаются lossy-методом;
- tool schema counters являются частью input tokens, а не дополнительной суммой;
- звёзды GitHub не заменяют fit и license review;
- внешние writes, billing и production changes остаются за явным approval.

## формат результата

```markdown
## thesis
## acceptance gate
## baseline ledger
## largest tax
## two-candidate shortlist
## chosen savings lever
## paired experiment
## adoption rule
## first executable step
```