diff --git a/docs/agents/issue-tracker.md b/docs/agents/issue-tracker.md
index 822a7f9..7420ba4 100644
--- a/docs/agents/issue-tracker.md
+++ b/docs/agents/issue-tracker.md
@@ -24,7 +24,16 @@ when running from outside the clone.
 - **Comment on an issue**: `tea comments add <index> --description "..."`.
   (The subcommand is `add`, not `create`.)
 - **Apply / remove labels**: `tea issues edit <index> --add-labels "a,b"` / `--remove-labels "a"`.
-- **Assign**: `tea issues edit <index> --add-assignees RDietermann`.
+- **Assign**: **not** `tea issues edit --add-assignees` — that flag posts to
+  `POST /issues/<index>/assignees`, which Gitea does not have, and fails with a bare 404.
+  Assignees are set by patching the issue:
+
+  ```bash
+  tea api --method PATCH "repos/RDietermann/dionotes-client/issues/<index>" \
+    -F assignees='["RDietermann"]'
+  ```
+
+  This replaces the whole list, so include existing assignees when adding one.
 - **Close**: `tea issues close <index>`. It takes no closing comment, so post the explanation
   first with `tea comments add`, then close.
 - **Create a label** (they are not auto-created): `tea labels create --name "..." --color "#rrggbb"`.
@@ -79,7 +88,7 @@ Used by `/wayfinder`. The **map** is a single issue with **child** issues as tic
 - **Frontier query**: `tea issues ls --output json --labels wayfinder:grilling,wayfinder:research,wayfinder:prototype,wayfinder:task`,
   keep those whose body says `Part of #<map>`, drop any with an assignee (claimed) or an open
   blocker; first in map order wins.
-- **Claim**: `tea issues edit <index> --add-assignees RDietermann` — the session's first write.
+- **Claim**: assign the ticket via the PATCH call under "Assign" above — the session's first write.
 - **Resolve**: `tea comments add <index> --description "<answer>"`, then
   `tea issues close <index>`, then append a context pointer (gist + link) to the map's
   Decisions-so-far.