diff --git a/AGENTS.md b/AGENTS.md
index e88aeed..56f66bc 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -15,10 +15,14 @@ personalized, and privacy-first self-tracking experience.
 - `dist/` – Contains static HTML, JavaScript, and CSS bundle files output by the production build process.
 - `node_modules/` – Stores third-party library dependencies and packages managed by npm.
 - `scripts/` – Houses automation scripts, including database schema configuration tools for Appwrite.
+- `public/` – PWA assets: web manifest and app icons, served at the site root.
 - `src/` – Contains client-side React source code, components, utility models, and stylesheets.
-  - `src/components/` – Reusable UI panel elements, forms, and splash screen wrappers.
+  - `src/components/` – Feature components (modals, panels, ledger, shell pieces); `src/components/views/`
+    holds the four main views plus auth, and `src/components/ui/` holds the shared design primitives
+    (Button, Card, Field, Badge, EmptyState).
   - `src/data/` – Static configurations, including theme lists and built-in flavours mapping.
-  - `src/lib/` – Business logic engines for calculations, file parsers, and Appwrite client connections.
+  - `src/lib/` – Business logic engines for calculations, file parsers, Appwrite client connections,
+    motion constants, toast context, and the localStorage entry cache.
 
 ## Build & Development Commands