diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..b9b244b
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,26 @@
+# CrateDocs MCP Development Guide
+
+## Build Commands
+- Build project: `cargo build`
+- Run STDIN/STDOUT server: `cargo run --bin doc-server`
+- Run HTTP/SSE server: `cargo run --bin axum-docs`
+- Run tests: `cargo test`
+- Run specific test: `cargo test test_name`
+- Format code: `cargo fmt`
+- Check code: `cargo clippy`
+
+## Code Style Guidelines
+- **Naming**: Use snake_case for functions/variables, CamelCase for types/structs
+- **Error Handling**: Use `Result<T, ToolError>` for functions that can fail
+- **Imports**: Organize imports by external crates first, then internal modules
+- **Async**: Use async/await with proper error propagation using `?` operator
+- **Documentation**: Include doc comments for public functions and structs
+- **Error Messages**: Be specific and descriptive in error messages
+- **Caching**: Implement caching for repeated operations when appropriate
+- **Responses**: Return structured responses via `Content::text()`
+
+## Project Architecture
+- Implements MCP protocol for Rust documentation tools
+- `DocRouter` is the core component for handling tool requests
+- Uses reqwest for API requests, tokio for async runtime
+- Async handlers for all tool implementations
\ No newline at end of file