# Token-Hygiene — 3 Ebenen

Jeder Turn schickt die ganze Konversations-History erneut. Kontextakkumulation
ist der größte vermeidbare Kostenfaktor in Multi-Agenten-Setups.

---

## Tier 1 — Session-Schnitt (höchste Wirkung)

- **Eine Session pro Aufgabe.** Nach einer abgeschlossenen Aufgabe `/clear` starten
  statt zum nächsten Thema im selben Thread zu wechseln. Alter Kontext ist totes
  Gewicht in jedem weiteren Turn.
- **Proaktiv kompaktieren** an sauberen Übergabepunkten. `/compact <was wichtig ist>`
  bevor die nächste Aufgabe startet — nicht warten bis auto-compaction einsetzt
  (Zeitpunkt ist nicht kontrollierbar).
- **Lese-intensive Sweeps delegieren.** Ein Explore/Plan-Subagent liest in seinem
  eigenen Kontext und gibt eine kurze Zusammenfassung zurück — das Bulk landet nie
  im Hauptkontext. Nur bei bekannten Pfaden direkt `Read` nutzen.

## Tier 2 — Command-Disziplin (mittlere Wirkung)

- **Scope + Filter gemeinsam.** Pfad-scopede Suchen (`grep -rn "symbol" src/`, nicht
  Repo-weit). Test-Output filtern (`--filter "SuiteX"`, nicht alle Ergebnisse dumpen).
- **Logs nie roh in Kontext.** In Datei umleiten, dann `grep`/`tail`. Bei
  Hintergrund-Jobs Output-Datei selektiv lesen, nicht pauschal.
- **Nicht zurück-lesen nach Edit.** `Edit` schlägt fehl bei inkonsistentem State —
  ein erfolgreicher Edit braucht kein `Read` zur Verifikation.
- **Referenz per Zeilennummer** (`datei.py:147`) statt Code-Blöcke neu einzufügen.

## Tier 3 — Cache-Disziplin (Prompt-Cache, TTL 5 min)

Der stabile Präfix jeder Anfrage (System-Prompt + CLAUDE.md / AGENTS.md) wird
gecacht. Cache-Miss = der ganze Kontext wird uncached neu gelesen.

- **Stabilen Präfix stabil halten.** `AGENTS.md`, `CLAUDE.md` und Projekt-Config
  **nicht mitten in einer Arbeitssession editieren**. Änderungen sammeln und in
  einem eigenen Durchgang machen.
- **Keine Ketten kurzer Pausen.** Einzelne lange Pause (> 5 min) = ein Cache-Miss.
  Viele kurze „warte-mal-kurz"-Turns mit Lücken > 5 min = jedes Mal ein neuer Miss.
  Bei externem Warten (CI, Deploy): **einmal** lang warten statt mehrfach pollen.
- **Eine Session pro Thema** (interagiert direkt mit Cache): frischer Thread = kleiner,
  vollständig gecachter Präfix.

---

## Schnell-Check vor einer langen Session

- [ ] Einzelnes Thema? Wenn nein → splitten.
- [ ] AGENTS.md-Änderungen anstehend? → **vorher** erledigen, dann stabil lassen.
- [ ] Lange Wartezeiten erwartet (CI/Build)? → Hintergrund-Job + **einmal** warten.