chore: align opencode memory docs with .memory project

.config/opencode/AGENTS.md

@@ -9,9 +9,9 @@ permalink: opencode-config/agents
 Memory uses one persistent system: **basic-memory**.
 
 - All persistent knowledge is stored in basic-memory notes, split across a **`main` project** (global/shared) and **per-repo projects** (project-specific).
-- Repo-local `.memory/` files are legacy artifacts and are **not** the active source of truth.
-- Do not create, update, or rely on `.memory/*` for current work tracking.
-- **Migration note:** Existing repo-local `.memory/` directories (or `.memory.legacy/`) in projects are non-authoritative and should be ignored unless you are explicitly migrating historical content into basic-memory. Do not delete them automatically — they may contain useful historical context for one-time migration.
+- The managed per-repo basic-memory project directory is `<repo>/.memory/`.
+- Do not edit managed `.memory/*` files directly; use basic-memory MCP tools for all reads/writes.
+- **Migration note:** Older repo-local memory workflow artifacts (including `.memory.legacy/` and legacy contents from prior workflows) are non-authoritative and should not be edited unless you are explicitly migrating historical content into basic-memory.
 
 ### basic-memory
 
@@ -44,12 +44,12 @@ Every code repository must have its own dedicated basic-memory project. This is
 **Creating a new per-repo project:**
 Use `basic-memory_create_memory_project` (or the equivalent MCP tool) with:
 - `project_name`: a short, kebab-case identifier for the repo (e.g., `opencode-config`, `my-web-app`, `data-pipeline`)
-- `project_path`: the repo's root directory on disk
+- `project_path`: the repo's `.memory/` subdirectory on disk (i.e., `<repo-root>/.memory`)
 
 Example for this repo:
 ```
 project_name: opencode-config
-project_path: /home/alex/dotfiles/.config/opencode
+project_path: /home/alex/dotfiles/.config/opencode/.memory
 ```
 
 **Checking if a project exists:**