# Portabilität: UNIVERSAL
# Version: 1.0.0
# Zuletzt validiert: 2026-02-08 (Help-Forensik)
# Nächste Prüfung: 2026-08-08

COOKBOOKS - Anthropic Referenz-Material
========================================

STAND: 2026-02-06

BESCHREIBUNG
------------
Ausgewaehlte Notebooks und Scripts aus dem offiziellen Anthropic
claude-cookbooks Repository. Dienen als Referenz und Inspiration
für BACH-Weiterentwicklungen -- nicht als direkt ausführbarer Code.

SPEICHERORT
-----------
docs/reference/anthropic_cookbooks/

VERFÜGBARE COOKBOOKS
---------------------

  memory/
    memory_tool.py                        Tool-basiertes LLM-Memory
    BACH-Vergleich: bach --memory ist deutlich ausgereifter
                    (SQLite, Sessions, Confidence, 10 Ops)
    Nützlich für: Tool-Definition-Pattern, Prompt-Engineering

  compaction/
    session_memory_compaction.ipynb        Session-Zusammenfassung
    automatic-context-compaction.ipynb     Token-basiertes Auto-Compact
    BACH-Vergleich: prompt_manager.py mit Kontext-Kompression
    Nützlich für: Token-Zaehlung, Komprimierungs-Prompts

  text_to_sql/
    guide.ipynb                           Natural Language → SQL
    BACH-Relevanz: Integrationsplan für "bach --db query"
    Nützlich für: Schema-Kontext, SQL-Validierung, Retry-Loop

  orchestrator/
    orchestrator_workers.ipynb            Orchestrator-Worker Pattern
    prompts/                              3 Agent-Prompt-Templates
      citations_agent.md                  Quellenverweise
      research_lead_agent.md              Recherche-Steuerung
      research_subagent.md                Recherche-Ausführung
    BACH-Vergleich: agents/_experts/ + hub/_services/
    Nützlich für: Agent-Prompt-Vorlagen, Ergebnis-Synthese

  tool_search/
    tool_search_with_embeddings.ipynb     Semantische Tool-Suche
    BACH-Vergleich: _try_run_tool() nutzt Prefix-Match
    Nützlich für: Embedding-basierte Tool-Discovery

INTEGRATION IN BACH
-------------------

  Priorität 1 (kurzfristig):
    - text_to_sql → neuer "bach --db query" Handler
    - compaction → Token-Zaehlung in prompt_manager.py

  Priorität 2 (mittelfristig):
    - orchestrator → Refactoring der Agent-Orchestrierung
    - tool_search → Upgrade für tool_discovery.py

  Priorität 3 (langfristig):
    - memory → Vergleich für Quality-Checks

QUELLEN
-------

  Repository:  github.com/anthropics/claude-cookbooks
  Commit:      7cb72a9
  Datum:       2026-02-06
  Lizenz:      Apache 2.0

WEITERE REFERENZEN
------------------

  docs/reference/mcp-builder/             MCP Server Best Practices
    SKILL.md                              Skill-Definition
    reference/mcp_best_practices.md       MCP Patterns
    reference/python_mcp_server.md        Python MCP Server
    reference/node_mcp_server.md          Node MCP Server
    reference/evaluation.md               MCP Evaluation

  tools/testing/playwright/               Browser-Test-Referenz
    with_server.py                        Server-Management
    examples/                             3 Beispiel-Scripts

SIEHE AUCH
----------
bach --help vendor              Vendor-Code (anthropic_docx/pdf/xlsx)
bach --help tools               Tool-Übersicht
docs/reference/analyse_anthropic_skills_cookbooks.md   Vollständige Analyse
