diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..5c447b0
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,35 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project
+
+**CodeFlow VS Code Extension** — AI-powered code quality and automation extension for VS Code. Integrates with the CodeFlow Engine.
+
+## Tech Stack
+
+- **Extension**: TypeScript (VS Code Extension API)
+- **Bundling**: Likely esbuild or webpack (standard for VS Code extensions)
+
+## Key Commands
+
+```bash
+npm install               # Install dependencies
+npm run compile           # Compile TypeScript
+npm run watch             # Watch mode for development
+npm run lint              # ESLint
+npm run test              # Run extension tests
+code --extensionDevelopmentPath=.  # Launch extension in dev mode
+```
+
+## Development
+
+Press F5 in VS Code to launch an Extension Development Host for testing.
+
+## AgentKit Forge
+
+This project has not yet been onboarded to [AgentKit Forge](https://github.com/phoenixvc/agentkit-forge). To request onboarding, [create a ticket](https://github.com/phoenixvc/agentkit-forge/issues/new?title=Onboard+codeflow-vscode-extension&labels=onboarding).
+
+## Baton Integration
+
+Baton is the shared task graph for cross-repo work. When the `baton` MCP server is available, agents should check for existing work with `task_check` at the start of meaningful tasks, create or claim visible work with `task_notify`/`log_agent_message`, update the task when significant new information becomes available, and log completion or blockers before handing off.