# Agent do/don't ## Do - **.ref folder setup**: When user asks to add a reference, check if it already exists first. For external repos: - **Clone directly** into the target folder: `../.ref/obsidian-dev/plugins//` (for plugins), `../.ref/obsidian-dev/themes//` (for themes), or `../.ref/obsidian-dev//` (for other projects) - **DO NOT** create a `.ref` subfolder inside the plugins/themes folder - clone the repo directly there - Then create symlink in project's `.ref/` folder pointing to the global location - For local projects, symlink directly in project's `.ref/` (don't clone to global) - See [ref-instructions.md](../../obsidian-ref/references/ref-instructions.md) for details. - Add commands with stable IDs (don't rename once released). - Provide defaults and validation in settings. - Write idempotent code paths so reload/unload doesn't leak listeners or intervals. - Use `this.register*` helpers for everything that needs cleanup. - **Apply UI to the main window via `this.app.workspace.containerEl.ownerDocument`, not `activeDocument`**, for anything that must affect the editing window from a settings change — `` classes, CSS variables, `