From 35dbb72cb6757be658539a3eddd341a6c11f6c14 Mon Sep 17 00:00:00 2001 From: MDietermann Date: Fri, 28 Aug 2026 12:56:07 +0200 Subject: [PATCH 1/2] docs: Einstiegspunkt fuer neue Sitzungen in AGENTS.md Eine Sitzung auf einem anderen Geraet fand bisher zwar die Konventionen und das Glossar, aber keinen Hinweis darauf, dass es ueberhaupt ein laufendes Vorhaben gibt - man musste sie jedes Mal von Hand zur Map schicken. Der Abschnitt nennt keine Issue-Nummer, sondern die Abfrage nach dem Label wayfinder:map. Damit gilt er auch fuer jede kuenftige Map, ohne gepflegt werden zu muessen. --- AGENTS.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) 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 -- 2.49.1 From e5990b9da407a01ee5d6de927ecdf63e9885bc96 Mon Sep 17 00:00:00 2001 From: MDietermann Date: Fri, 28 Aug 2026 12:57:26 +0200 Subject: [PATCH 2/2] docs: tea-Einrichtung fuer ein frisches Geraet beschreiben Die Doku stellte fest, tea sei installiert - was auf jedem anderen Geraet falsch ist und dazu fuehrt, dass saemtliche Kommandos darunter fehlschlagen, ohne dass der Grund dabeisteht. Mit dem noetigen Token-Scope, damit gleich klar ist, warum Wartungs-API und Organisations-Repos nicht funktionieren. --- docs/agents/issue-tracker.md | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) 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 . > 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 +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; -- 2.49.1