diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..0dc97cf
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,118 @@
+# AGENTS.md
+
+This file contains guidelines for agentic coding assistants working in this repository.
+
+## Project Overview
+Vue 3 + Vite + Leaflet interactive map visualizing the novel "大唐双龙传" (The Twin of Brothers), showing factions, locations, character routes, and key events across 20 volumes.
+
+## Commands
+
+### Build & Dev
+- `cd frontend && npm run dev` - Start dev server (http://localhost:5173)
+- `cd frontend && npm run build` - Production build (outputs to ../dist)
+- `cd frontend && npm run preview` - Preview production build
+
+### Testing
+No test framework currently configured. Before adding tests, propose the approach (e.g., Vitest for unit tests, Playwright for E2E).
+
+### Linting/Typechecking
+No linting tools configured. Before adding eslint/prettier, verify compatibility with existing code style.
+
+## Code Style Guidelines
+
+### Vue 3 & JavaScript
+- Use Composition API with `