From 3b56577b2f53a7516def5dbf194e50b67b3fe077 Mon Sep 17 00:00:00 2001
From: Dickson Tsai <dickson@anthropic.com>
Date: Sat, 19 Jul 2025 19:12:15 -0700
Subject: [PATCH] CLAUDE.md

---
 CLAUDE.md | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)
 create mode 100644 CLAUDE.md

diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..69f23fb
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,27 @@
+# Workflow
+
+```bash
+# Lint and style
+# Check for issues and fix automatically
+python -m ruff check src/ test/ --fix
+python -m ruff format src/ test/
+
+# Typecheck (only done for src/)
+python -m mypy src/
+
+# Run all tests
+python -m pytest tests/
+
+# Run specific test file
+python -m pytest tests/test_client.py
+```
+
+# Codebase Structure
+
+- `src/claude_code_sdk/` - Main package
+  - `client.py` - ClaudeSDKClient for interactive sessions
+  - `query.py` - One-shot query function
+  - `types.py` - Type definitions
+  - `_internal/` - Internal implementation details
+    - `transport/subprocess_cli.py` - CLI subprocess management
+    - `message_parser.py` - Message parsing logic