diff --git a/AGENTS.md b/AGENTS.md
index ab8fe2d..93d6b04 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -264,6 +264,22 @@ The initial UI rendered by the component on the client must be identical to the
 * Use the `use_server_future` hook instead of `use_resource`. It runs the future on the server, serializes the result, and sends it to the client, ensuring the client has the data immediately for its first render.
 * Any code that relies on browser-specific APIs (like accessing `localStorage`) must be run *after* hydration. Place this code inside a `use_effect` hook.
 
+## Woran gerade gearbeitet wird
+
+**Bevor du irgendetwas anderes tust:** Laufende Vorhaben liegen als *Wayfinder-Map* im
+Issue-Tracker, nicht in diesem Repo. Die offene Map findest du mit
+
+```bash
+tea issues ls --labels wayfinder:map --state open
+```
+
+Lies ihren Beschreibungstext (Destination, Notes, Decisions so far) **und ihren letzten
+Kommentar** — dort steht der Arbeitsstand samt Einstiegspunkt. Erst danach lohnt der Blick
+in den Code.
+
+Ist keine Map offen, gibt es kein laufendes Planungsvorhaben; dann gilt die normale
+Auftragslage aus dem Gespräch.
+
 ## Agent skills
 
 ### Issue tracker
diff --git a/docs/agents/issue-tracker.md b/docs/agents/issue-tracker.md
index 7420ba4..e8877a5 100644
--- a/docs/agents/issue-tracker.md
+++ b/docs/agents/issue-tracker.md
@@ -4,7 +4,19 @@ Issues and specs for this repo live as **Gitea** issues at
 <https://gitlab.hive-brain.de/RDietermann/dionotes-client>.
 
 > The host is named `gitlab.hive-brain.de`, but the server is **Gitea 1.25.5**, not GitLab.
-> `glab` will not work. Use the [`tea`](https://gitea.com/gitea/tea) CLI (v0.15 installed).
+> `glab` will not work. Use the [`tea`](https://gitea.com/gitea/tea) CLI (developed against v0.15).
+
+**Auf einem frischen Gerät** ist `tea` erst einzurichten — ohne das schlägt jedes Kommando
+unten fehl:
+
+```bash
+tea login add --name hive --url https://gitlab.hive-brain.de --token <token>
+tea login list          # prueft, ob es sitzt
+```
+
+Der Token braucht mindestens `write:issue`, `write:repository` und `write:user`. Der hier
+verwendete hat **kein** `read:admin` und **kein** `write:organization` — Wartungs-API und
+Anlegen unter einer Organisation scheitern damit.
 
 Run `tea` from inside the clone — it resolves owner/repo from `git remote`. It prints
 `NOTE: no login matched this repository, falling back to login 'hive'` on every call;