| # Prior Art Research — Sidecar Context Window Management |
| Erstellt: 2026-03-05 | Query: "Sidecar Kontext Window" |
|
|
| ## Top Repos |
|
|
| | Repo | Stars | Kernidee | Link | |
| |------|-------|----------|------| |
| | hesreallyhim/awesome-claude-code | 26.358 | Kuratierte Liste: Skills, Hooks, Plugins, Agent-Orchestrators | https://github.com/hesreallyhim/awesome-claude-code | |
| | trailofbits/claude-code-config | 1.484 | Opinionated Defaults + Workflows fuer Claude Code (Security-Fokus) | https://github.com/trailofbits/claude-code-config | |
| | disler/claude-code-hooks-mastery | ~500+ | Alle 13 Hook-Events dokumentiert + Meta-Agent + Team-Validation | https://github.com/disler/claude-code-hooks-mastery | |
| | ovachiever/total-recall | neu | Tmux-Scrollback Capture bei Compaction → Re-Injection via additionalContext | https://github.com/ovachiever/total-recall | |
| | MacroMan5/macromanatlas | neu | Auto-Codebase-Index + per-Module READMEs, auto-synced via Hooks | https://github.com/MacroMan5/macromanatlas | |
| | nightshift2k/claude-code-hooks | neu | Safety Guardrails + Standard Enforcement + Context Injection | https://github.com/nightshift2k/claude-code-hooks | |
| | jcmrs/thinking-tools-framework | - | Session Handoff, Context Preservation, Process Memory | https://github.com/jcmrs/thinking-tools-framework | |
|
|
| ## Architektur-Patterns |
|
|
| ### Pattern 1: PreCompact + SessionStart Re-Injection (total-recall) |
| - PreCompact Hook → `tmux capture-pane` → speichert Scrollback in `~/.claude/compact-snapshots/{session_id}.txt` |
| - SessionStart Hook (matcher: "compact") → liest Snapshot → injiziert als `additionalContext` |
| - Terminal-Output ist natuerlich komprimiert (Tool-Calls collapsed) → nur 3-5% des Context Windows |
| - **Relevanz fuer uns:** Unser Sidecar macht das bereits aehnlich, aber gezielter (Rules statt Scrollback) |
|
|
| ### Pattern 2: UserPromptSubmit Context Injection (unser Sidecar v1) |
| - Hook feuert bei jedem User-Prompt → Daemon entscheidet was relevant ist → injiziert |
| - Vorteil: Situativ, phasenabhaengig, regelbasiert |
| - Nachteil: Sieht nur den aktuellen Prompt, nicht die Session-History |
| - **Unser session_watcher.py loest genau diesen Nachteil** |
| |
| ### Pattern 3: Meta-Agent / Team-Based Validation (disler) |
| - Hooks orchestrieren SubAgents fuer Validation |
| - PreToolUse → Agent prueft ob Tool-Call sinnvoll ist |
| - PostToolUse → Agent validiert Output |
| - **Relevanz:** Unsere PreToolUse Gates sind eine leichtere Version davon |
| |
| ### Pattern 4: Codebase Auto-Index (macromanatlas) |
| - Hooks nach File-Edits → automatisch Module-READMEs updaten |
| - Claude bekommt immer aktuelle Codebase-Uebersicht |
| - **Relevanz:** Unser context_selector.py koennte aehnlich arbeiten — aber fuer Memory-Files statt Code |
| |
| ### Pattern 5: Context Distillation (Anthropic Engineering Blog) |
| - "Context Rot": Mehr Tokens → schlechtere Recall-Qualitaet |
| - LLMs haben ein "Attention Budget" — jeder Token verbraucht davon |
| - Loesung: Weniger, dafuer relevantere Tokens injizieren |
| - **Kern-Validierung fuer unseren Ansatz:** Situatives Laden > Bulk-Loading |
|
|
| ## Bekannte Probleme & Loesungen |
|
|
| | Problem | Quelle | Loesung | |
| |---------|--------|---------| |
| | additionalContext wird mehrfach injiziert | [#14281](https://github.com/anthropics/claude-code/issues/14281) | Bug in Claude Code — workaround: Deduplizierung im Hook | |
| | SessionStart hooks feuern nicht bei neuen Conversations | [#10373](https://github.com/anthropics/claude-code/issues/10373) | Bekannter Bug, Workaround: UserPromptSubmit statt SessionStart | |
| | PreToolUse hat KEIN additionalContext | [#15345](https://github.com/anthropics/claude-code/issues/15345) | Design-Limitation — nur Block/Allow, kein Context-Inject | |
| | Context Buffer frisst 33-45K Tokens | [claudefa.st](https://claudefa.st/blog/guide/mechanics/context-buffer-management) | System-Overhead, nicht beeinflussbar — umso wichtiger: eigenen Context minimieren | |
| | Compaction verliert spezifische Details | total-recall README | Scrollback-Capture + Re-Injection nach Compaction | |
|
|
| ## Vergleich: Ansaetze fuer Context-Management |
|
|
| | Aspekt | Sidecar-Daemon (unser Weg) | total-recall (Scrollback) | RAG-Pipeline | Groesseres Context Window | |
| |--------|---------------------------|--------------------------|--------------|--------------------------| |
| | Praezision | Hoch (regelbasiert) | Mittel (alles oder nichts) | Hoch (semantic search) | Niedrig (Context Rot) | |
| | Kosten | ~0 (lokal) | ~0 (lokal) | Embedding-Kosten | Hoehere Token-Kosten | |
| | Komplexitaet | Mittel (Daemon + Hooks) | Niedrig (2 Shell-Scripts) | Hoch (Vector DB + Embedding) | Keine (aber Problem nicht geloest) | |
| | Session-Awareness | Voll (JSONL-Tailing) | Partial (nur bei Compaction) | Keine | Keine | |
| | Phase-Awareness | Ja (phase_tracker) | Nein | Moeglich aber aufwaendig | Nein | |
| | Skaliert mit Regeln | Ja (Plugin-System) | Nein | Nein | Nein | |
| |
| ## Kern-Insights aus der Recherche |
| |
| ### 1. "Context Rot" validiert unseren Ansatz |
| Anthropics eigener Engineering-Blog bestaetigt: Mehr Context ≠ besser. LLMs haben ein Attention Budget. Unser Sidecar-Ansatz (wenig, aber relevant) ist der richtige Weg. |
| |
| ### 2. total-recall ist clever aber grob |
| Scrollback-Capture ist ein guter Trick fuer Compaction-Recovery, aber nicht fuer situatives Context-Management. Unser Ansatz ist praeziser. |
| |
| ### 3. Session-JSONL-Tailing ist ein Alleinstellungsmerkmal |
| Kein anderes Projekt tailed die Session-JSONL in Echtzeit. Die meisten arbeiten mit Hooks (reaktiv auf einzelne Events). Unser session_watcher waere der erste der die gesamte Session versteht. |
|
|
| ### 4. Hook-Oekosystem waechst schnell |
| awesome-claude-code hat 26K Stars. Das Oekosystem explodiert. Aber die meisten Hooks sind einfach (Format, Lint, Block). Komplexe Context-Management-Daemonen wie unser Sidecar sind selten. |
|
|
| ### 5. 33K Token System-Buffer ist fix |
| Claude Code reserviert 33-45K Tokens fuer System-Overhead. Das ist nicht beeinflussbar. Umso wichtiger: eigenen injizierten Context minimal halten. |
|
|
| ## Empfehlung fuer unser Projekt |
|
|
| **Unser Sidecar v2.0 mit session_watcher ist der richtige Weg.** Kein bestehendes Tool macht das was wir brauchen: |
| - total-recall loest nur Compaction-Recovery (nicht situatives Loading) |
| - macromanatlas indexiert Code (nicht Memory/Rules) |
| - disler's Hooks sind Demos (nicht produktiver Daemon) |
| |
| **Konkret uebernehmen:** |
| 1. Von **total-recall**: PreCompact Hook fuer Scrollback-Capture als Fallback (2 Shell-Scripts, trivial) |
| 2. Von **disler**: Hook-Lifecycle-Diagramm als Referenz fuer unsere Architektur-Docs |
| 3. Von **Anthropic Blog**: "Context Rot" als Argument fuer minimale Injections |
| |
| **Vermeiden:** |
| - RAG-Pipeline (Overkill fuer unser Use-Case, zu komplex) |
| - Auf groessere Context Windows warten (loest das Problem nicht — Context Rot) |
| |
| ## Quellen |
| |
| - [Effective Context Engineering for AI Agents — Anthropic](https://www.anthropic.com/engineering/effective-context-engineering-for-ai-agents) |
| - [Claude Code Hooks Reference](https://code.claude.com/docs/en/hooks) |
| - [Claude Code Hooks Guide](https://code.claude.com/docs/en/hooks-guide) |
| - [Context Engineering for Multi-Agent LLM Code Assistants — arXiv](https://arxiv.org/html/2508.08322v1) |
| - [Claude Code Context Buffer: 33K-45K Token Problem](https://claudefa.st/blog/guide/mechanics/context-buffer-management) |
| - [Claude Code Session Hooks: Auto-Load Context](https://claudefa.st/blog/tools/hooks/session-lifecycle-hooks) |
| - [Hook-driven dev workflows — Nick Tune](https://nick-tune.me/blog/2026-02-28-hook-driven-dev-workflows-with-claude-code/) |
| - [Context Management Optimization — SFEIR](https://institute.sfeir.com/en/claude-code/claude-code-context-management/optimization/) |
| - [Auto-Refresh Context Every N Prompts — Gist](https://gist.github.com/johnlindquist/23fac87f6bc589ddf354582837ec4ecc) |
| - [54% Context Reduction — Gist](https://gist.github.com/johnlindquist/849b813e76039a908d962b2f0923dc9a) |
| |
