docs: fix dangling per-library CLAUDE.md references to point at AGENTS.md / CONTRIBUTING.md (#128)

* docs: point per-library CLAUDE.md to committed AGENTS.md / CONTRIBUTING.md

The two tracked per-library agent quickstarts referenced the root
CLAUDE.md and .claude/rules/, both gitignored — a dead link for anyone
who clones the repo. Point them at the committed AGENTS.md and
CONTRIBUTING.md instead. Also fix AGENTS.md, which described the
per-library CLAUDE.md files as "local, not published" when they are
in fact tracked.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* docs(claude): correct + complete the per-library agent quickstarts

Audit against the real SDK tree found inaccuracies/gaps in the two
published per-library CLAUDE.md files:
- Python: logger namespace was documented as getLogger("patter") but the
  SDK uses getLogger("getpatter") everywhere — corrected. Added Plivo to
  the telephony adapters, plus the carriers/, cli.py, local_config.py,
  evals/engines/integrations entries, and llm/ to the public-namespace line.
- TypeScript: added Plivo to the telephony adapters, carrier-config.ts, and
  llm/ to the public-namespace line.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: nicolotognoni

AGENTS.md

@@ -59,9 +59,9 @@ docs/                         Mintlify docs site
 scripts/pr-validate.sh        Local mirror of PR-blocking CI
 ```
 
-Per-library quickstarts: `libraries/python/CLAUDE.md` and
-`libraries/typescript/CLAUDE.md` (local, not published — but worth reading if
-present in your checkout).
+Per-library quickstarts (committed alongside each SDK):
+`libraries/python/CLAUDE.md` and `libraries/typescript/CLAUDE.md` — read the one
+for the SDK you're touching.
 
 ## Commits & PRs
 

libraries/python/CLAUDE.md

@@ -1,6 +1,6 @@
 # Python SDK — agent quickstart
 
-This file is the per-library guide for AI agents working in `libraries/python/`. For repo-wide rules, see the root `CLAUDE.md` and `.claude/rules/`.
+This file is the per-library guide for AI agents working in `libraries/python/`. For repo-wide rules, see [`AGENTS.md`](../../AGENTS.md) and [`CONTRIBUTING.md`](../../CONTRIBUTING.md).
 
 ## Layout
 
@@ -14,19 +14,23 @@ libraries/python/
 └── getpatter/              # the published package (`pip install getpatter`)
     ├── __init__.py
     ├── client.py           # Patter entry point
+    ├── cli.py              # `getpatter` console-script entry point
+    ├── local_config.py     # LocalOptions + local-mode config
     ├── models.py           # public dataclasses (frozen=True)
     ├── exceptions.py       # PatterError + ErrorCode enum
     ├── pricing.py          # PricingUnit enum + provider price tables
     ├── server.py           # FastAPI app
     ├── stream_handler.py   # per-call orchestrator
-    ├── telephony/          # Twilio + Telnyx adapters (twilio.py / telnyx.py / common.py)
+    ├── telephony/          # Twilio + Telnyx + Plivo adapters (twilio.py / telnyx.py / plivo.py / common.py)
+    ├── carriers/           # carrier classes (twilio.py / telnyx.py / plivo.py)
     ├── audio/              # transcoding, pcm_mixer, background_audio
     ├── tools/              # tool_decorator, tool_executor
-    ├── providers/          # voice / LLM / STT / TTS providers
+    ├── providers/          # voice / LLM / STT / TTS provider adapters
     ├── services/           # llm_loop, metrics, sentence_chunker, text_transforms, ivr, ...
     ├── observability/      # event_bus + OTel tracing
+    ├── evals/ engines/ integrations/   # eval runner, engines, external integrations
     ├── dashboard/
-    ├── tts/ stt/           # public namespaces (env-var auto-resolve)
+    ├── llm/ tts/ stt/      # public provider namespaces (env-var auto-resolve)
     └── ...
 ```
 
@@ -45,7 +49,7 @@ pip install -e ".[dev]"                # editable install for development
 - pytest with `asyncio_mode = "auto"` — write `async def test_*`, no decorator needed.
 - Public dataclasses are `@dataclass(frozen=True)`. Tuples, not lists.
 - Async I/O everywhere. `httpx.AsyncClient`, `websockets.connect`. No `time.sleep`.
-- Logger: `logging.getLogger("patter")` — never `print()`.
+- Logger: `logging.getLogger("getpatter")` — never `print()`. Sub-namespaces like `getpatter.providers.deepgram_stt` are used per-module.
 - New config fields are optional with safe defaults (backward compat).
 - Authentic tests: mock only at paid/external boundary, tag `@pytest.mark.mocked`.
 

libraries/typescript/CLAUDE.md

@@ -1,6 +1,6 @@
 # TypeScript SDK — agent quickstart
 
-This file is the per-library guide for AI agents working in `libraries/typescript/`. For repo-wide rules, see the root `CLAUDE.md` and `.claude/rules/`.
+This file is the per-library guide for AI agents working in `libraries/typescript/`. For repo-wide rules, see [`AGENTS.md`](../../AGENTS.md) and [`CONTRIBUTING.md`](../../CONTRIBUTING.md).
 
 ## Layout
 
@@ -22,14 +22,15 @@ libraries/typescript/
     ├── pricing.ts          # PricingUnit + provider price tables
     ├── server.ts           # Express app
     ├── stream-handler.ts   # per-call lifecycle
-    ├── telephony/          # Twilio + Telnyx adapters (twilio.ts / telnyx.ts)
+    ├── telephony/          # Twilio + Telnyx + Plivo adapters (twilio.ts / telnyx.ts / plivo.ts)
+    ├── carrier-config.ts   # carrier audio/format config
     ├── audio/              # transcoding, background-audio
     ├── tools/              # tool-decorator
-    ├── providers/          # voice / LLM / STT / TTS providers
+    ├── providers/          # voice / LLM / STT / TTS provider adapters
     ├── services/           # call-log, ivr (mostly top-level files in src/)
     ├── observability/
     ├── dashboard/
-    ├── tts/ stt/           # public namespaces (env-var auto-resolve)
+    ├── llm/ tts/ stt/      # public provider namespaces (env-var auto-resolve)
     └── ...
 ```