From 50ffab02528a612890e97fb8f26bc75b42fd1ac8 Mon Sep 17 00:00:00 2001 From: MDietermann Date: Fri, 28 Aug 2026 09:24:00 +0200 Subject: [PATCH] docs: Branch- und PR-Workflow im Tracker-Doc festhalten Ab jetzt laufen Aenderungen ueber eigene Branches und Pull Requests statt direkt auf main, damit die logische Trennung sichtbar bleibt. Das gehoert neben die tea-Kommandos, sonst kennt es nur die Sitzung, in der es vereinbart wurde. Festgehalten ist auch die Faustregel fuer den Zuschnitt: Wenn die Commit-Nachricht "und ausserdem" braucht, sind es zwei Branches. Und dass das Mergen dem Menschen gehoert, nicht der Umsetzung. --- docs/agents/issue-tracker.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/docs/agents/issue-tracker.md b/docs/agents/issue-tracker.md index 7420ba4..c809bdb 100644 --- a/docs/agents/issue-tracker.md +++ b/docs/agents/issue-tracker.md @@ -61,6 +61,27 @@ Create a Gitea issue. Run `tea issues ` plus `tea comments ls `. +## 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 +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 #` 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. -- 2.49.1