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.