diff --git a/.prettierignore b/.prettierignore
new file mode 100644
index 0000000..4c16caf
--- /dev/null
+++ b/.prettierignore
@@ -0,0 +1,2 @@
+# Ignore files for Prettier formatting
+AGENTS.md
\ No newline at end of file
diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..b474b39
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,87 @@
+# Kevin's Journey - AI Agent Guide
+
+This documentation provides context, conventions, and instructions for AI agents working on this codebase.
+
+## 1. Project Overview
+
+This is a personal travel visualization project built with:
+- **Framework**: [SolidJS](https://www.solidjs.com/) (Reactive UI)
+- **Styling**: [UnoCSS](https://unocss.dev/) (Atomic CSS)
+- **Map**: [Mapbox GL JS](https://docs.mapbox.com/mapbox-gl-js/)
+- **Language**: TypeScript
+
+## 2. Tooling & Commands
+
+Use `pnpm` for all package management.
+
+### core scripts
+- **Start Dev Server**: `pnpm dev` (runs on http://localhost:5173)
+- **Build for Production**: `pnpm build`
+- **Type Check**: `pnpm typecheck`
+- **Lint**: `pnpm lint`
+- **Format**: `pnpm format`
+
+### testing
+*Note: There is currently no dedicated unit test runner (e.g., Vitest) configured.*
+- Rely on **Type Checking** (`pnpm typecheck`) and **Linting** (`pnpm lint`) for verification.
+- Verify UI changes visually by running the dev server.
+
+## 3. Code Architecture & Patterns
+
+### SolidJS Components
+- **Functional Components**: Use PascalCase (e.g., `PlaceMarker`).
+- **Reactivity**:
+  - Use `createSignal` for local state.
+  - Use `createMemo` for derived state (especially for expensive calculations or map filters).
+  - Use `createDeferred` for rendering heavy lists to keep the UI responsive.
+  - **Props**: Access props via `props.property` to maintain reactivity. Destructuring props loses reactivity unless using `splitProps`.
+- **Control Flow**: Prefer Solid's built-in components:
+  - `<Show when={...}>` instead of ternary operators.
+  - `<For each={...}>` or `<Index each={...}>` instead of `.map()`.
+- **Context**: Use `createContext` and `useContext` for global state like the Mapbox instance.
+
+### State Management
+- **Primitives**: Leverage `@solid-primitives` where possible:
+  - `@solid-primitives/set`: For reactive Sets (e.g., active filters).
+  - `@solid-primitives/storage`: For persisting state to localStorage.
+
+### Styling (UnoCSS)
+- **Utility-First**: Use utility classes directly in the `class` attribute.
+- **Conditional Styling**: Use the `classList` attribute for toggling classes based on state:
+  ```tsx
+  <div classList={{ 'opacity-50': !isActive() }} />
+  ```
+- **Icons**: Use pure CSS icons via the `i-` prefix (Iconify):
+  ```tsx
+  <div class="i-ph:globe-duotone" />
+  ```
+- **Dark Mode**: Use the `dark:` modifier.
+
+### Mapbox Integration
+- **Direct DOM Access**: Mapbox requires a DOM element container. Handle this safely within SolidJS components, typically using a variable reference assigned in JSX (e.g., `ref={container}` pattern or explicit assignment).
+
+## 4. Coding Standards
+
+### TypeScript
+- **Strict Mode**: The project uses strict TypeScript. Avoid `any`.
+- **Interfaces**: Define explicit interfaces for data structures (e.g., `Place`, `marker`).
+- **Imports**:
+  1. External libraries (Solid, Mapbox, Primitives)
+  2. Internal components
+  3. Types (use `import type`)
+  4. Styles/Assets
+
+### Data Handling
+- **YAML Data**: Primary data is stored in `data.yaml`.
+- **Importing**: Import YAML files directly; they are handled by `unplugin-yaml`.
+
+### File Organization
+- **Components**: `src/**/*.tsx` (PascalCase)
+- **Configuration**: Root level config files (camelCase/kebab-case)
+- **Entry**: `src/index.tsx`
+- **Main App**: `src/App.tsx`
+- **Map Logic**: `src/Map.tsx`
+
+## 5. Error Handling
+- Use non-null assertions (`!`) only when you are certain a value exists (e.g., after a check or known DOM presence).
+- Ensure Mapbox load events are handled before interacting with the map instance.
diff --git a/eslint.config.js b/eslint.config.js
index a9a8fd9..8f95b0b 100644
--- a/eslint.config.js
+++ b/eslint.config.js
@@ -1,4 +1,4 @@
 import { sxzz } from '@sxzz/eslint-config'
 import solid from 'eslint-plugin-solid/configs/recommended'
 
-export default sxzz().append(solid)
+export default sxzz().append(solid, { ignores: ['AGENTS.md'] })