docs/agents/issue-tracker.md

@@ -61,6 +61,27 @@ Create a Gitea issue.
 
 Run `tea issues <index>` plus `tea comments ls <index>`.
 
+## Branch- und PR-Workflow
+
+Änderungen werden **nicht direkt auf `main`** committet, sondern auf einem eigenen Branch
+pro logischer Einheit — `feat/`, `fix/`, `refactor/`, `chore/`, `docs/`. Eine Einheit ist,
+was man in einem Satz begründen kann; wenn die Commit-Nachricht „und außerdem" braucht,
+sind es zwei Branches.
+
+Zurück nach `main` geht es über einen **Pull Request in Gitea**, nicht per lokalem Merge:
+
+```bash
+git push -u origin <branch>
+tea pulls create --title "..." --description "..."
+```
+
+`--description` nimmt wie bei Issues nur eine Zeichenkette; für längere Texte eine Datei
+schreiben und mit `$(cat datei)` übergeben. Bezieht sich der PR auf ein Ticket, gehört
+`Closes #<n>` in die Beschreibung, damit Gitea es beim Mergen schließt.
+
+Gemergt wird in der Weboberfläche — das Mergen ist eine Entscheidung des Menschen, nicht
+Teil der Umsetzung.
+
 ## Wayfinding operations
 
 Used by `/wayfinder`. The **map** is a single issue with **child** issues as tickets.