Add migration section to README linking to changelog

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Author: ashwin-ant

CHANGELOG.md

@@ -1,8 +1,6 @@
 # Changelog
 
-All notable changes to the Claude Agent SDK will be documented in this file.
-
-## 0.1.0 - 2025-09-29
+## 0.1.0
 
 Introducing the Claude Agent SDK! The Claude Code SDK has been renamed to better reflect its capabilities for building AI agents across all domains, not just coding.
 
@@ -45,8 +43,6 @@ For full migration instructions, see our [migration guide](https://docs.claude.c
 - New guides for [Custom Tools](https://docs.claude.com/en/api/agent-sdk/custom-tools), [Permissions](https://docs.claude.com/en/api/agent-sdk/permissions), [Session Management](https://docs.claude.com/en/api/agent-sdk/sessions), and more
 - Complete [Python API reference](https://docs.claude.com/en/api/agent-sdk/python)
 
----
-
 ## 0.0.22
 
 - Introduce custom tools, implemented as in-process MCP servers.

README.md

@@ -10,7 +10,7 @@ pip install claude-agent-sdk
 
 **Prerequisites:**
 - Python 3.10+
-- Node.js 
+- Node.js
 - Claude Code: `npm install -g @anthropic-ai/claude-code`
 
 ## Quick Start
@@ -59,7 +59,7 @@ options = ClaudeAgentOptions(
 )
 
 async for message in query(
-    prompt="Create a hello.py file", 
+    prompt="Create a hello.py file",
     options=options
 ):
     # Process tool use and results
@@ -271,6 +271,15 @@ See [examples/quick_start.py](examples/quick_start.py) for a complete working ex
 
 See [examples/streaming_mode.py](examples/streaming_mode.py) for comprehensive examples involving `ClaudeSDKClient`. You can even run interactive examples in IPython from [examples/streaming_mode_ipython.py](examples/streaming_mode_ipython.py).
 
+## Migrating from Claude Code SDK
+
+If you're upgrading from the Claude Code SDK (versions < 0.1.0), please see the [CHANGELOG.md](CHANGELOG.md#010) for details on breaking changes and new features, including:
+
+- `ClaudeCodeOptions` → `ClaudeAgentOptions` rename
+- Merged system prompt configuration
+- Settings isolation and explicit control
+- New programmatic subagents and session forking features
+
 ## License
 
 MIT