diff --git a/AGENTS.md b/AGENTS.md
index f7174ea..a524161 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -7,8 +7,8 @@
 
 ## Key Singletons
 - `GlobalStates.qml`: Manages global UI visibility (e.g., `mediaControlsOpen`, `notificationPanelOpen`).
-- `common/Config.qml`: Manages JSON configuration and watches for file changes.
-- `common/Directories.qml`: Defines XDG and repository-specific file paths.
+- `common/Config.qml`: Manages JSON configuration at `${XDG_CONFIG_HOME}/hydro-os/config.json` and watches for file changes.
+- `common/Directories.qml`: Defines XDG and repository-specific file paths (e.g., `${XDG_CONFIG_HOME}/hydro-os/color.json`).
 - `common/Appearance.qml`: Handles theme, colors, and transparency.
 
 ## Component Structure
@@ -20,5 +20,5 @@
 - `settings.qml`: Settings view entry point.
 
 ## Development Workflow
-- *TBD*: Check for build/lint/test commands (e.g., `npm`, `make`, or direct `quickshell` execution).
-- Logs: Run `quickshell log` and read only after the last "INFO: Reloading configuration..."
+- **Logs**: Run `quickshell log` and read only after the last "INFO: Reloading configuration..."
+- **Config**: Configuration files are located in `${XDG_CONFIG_HOME}/hydro-os/` and may be auto-created by the application.