diff --git a/README.md b/README.md
new file mode 100644
index 00000000..00f5b4b9
--- /dev/null
+++ b/README.md
@@ -0,0 +1,27 @@
+# Super Multica
+
+A multi-component architecture for distributed agent systems.
+
+## Project Structure
+
+```
+src/
+├── agent/      # Agent module
+├── gateway/    # Gateway module
+├── client/     # Client module
+└── shared/     # Shared types and utilities
+```
+
+## Getting Started
+
+```bash
+pnpm install
+pnpm dev
+```
+
+## Scripts
+
+- `pnpm dev` - Run in development mode
+- `pnpm build` - Build for production
+- `pnpm start` - Run production build
+- `pnpm typecheck` - Type check without emitting