diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..d79dff4
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,48 @@
+# AGENTS.md - Fengling.Console.Web.Vben
+
+**Parent:** `/AGENTS.md`
+
+## Overview
+
+Vue 3 + Vben Admin multi-UI monorepo with 5+ UI variants.
+
+## Structure
+
+```
+src/Fengling.Console.Web.Vben/
+├── apps/                    # UI variants
+│   ├── web-ele/            # Element Plus
+│   ├── web-tdesign/        # Tdesign
+│   ├── web-naive/          # NaiveUI
+│   └── web-antd/           # Ant Design
+├── packages/               # Shared packages
+│   ├── @core/              # Core components
+│   ├── @core/ui-kit/       # UI kit (shadcn-ui)
+│   └── effects/            # Effects/layouts
+├── internal/               # Build configs
+│   ├── lint-configs/       # ESLint, Prettier
+│   └── tailwind-config/    # Tailwind
+└── playground/             # Dev playground
+```
+
+## Where to Look
+
+| Task | Location |
+|------|----------|
+| API calls | `apps/*/src/api/` |
+| Components | `packages/@core/ui-kit/shadcn-ui/src/ui/` |
+| Stores | `apps/*/src/stores/` |
+| Routing | `apps/*/src/router/` |
+| Views | `apps/*/src/views/` |
+
+## Conventions
+
+- **Import aliases**: `@/` → `src/`, `#/` → `apps/web-ele/src/`
+- **Store usage**: Pinia with `defineStore`
+- **API**: Auto-generated via Vben conventions
+- **Components**: Auto-imported via unplugin-vue-components
+
+## Anti-Patterns
+
+- Don't modify internal configs directly — use overrides
+- Don't mix UI frameworks (stick to assigned variant)