Branch- und PR-Workflow dokumentieren #10

Merged
RDietermann merged 1 commits from docs/branch-workflow into main 2026-08-28 07:29:16 +00:00
Owner

Hält den vereinbarten Arbeitsablauf dort fest, wo die Skills ihn lesen — neben den tea-Kommandos in docs/agents/issue-tracker.md.

Ohne diesen Vermerk kennt den Workflow nur die Sitzung, in der er vereinbart wurde; die nächste Session würde wieder direkt auf main committen.

Enthalten:

  • Branch pro logischer Einheit (feat/, fix/, refactor/, chore/, docs/)
  • Zuschnitt-Faustregel: Wenn die Commit-Nachricht „und außerdem" braucht, sind es zwei Branches
  • Zurück nach main über tea pulls create, nicht per lokalem Merge
  • Der Fallstrick, über den ich selbst gestolpert bin: --description nimmt nur eine Zeichenkette, längere Texte brauchen $(cat datei)
  • Closes #<n> für den Bezug auf ein Ticket
  • Das Mergen gehört dem Menschen, nicht der Umsetzung
Hält den vereinbarten Arbeitsablauf dort fest, wo die Skills ihn lesen — neben den `tea`-Kommandos in `docs/agents/issue-tracker.md`. Ohne diesen Vermerk kennt den Workflow nur die Sitzung, in der er vereinbart wurde; die nächste Session würde wieder direkt auf `main` committen. Enthalten: - Branch pro logischer Einheit (`feat/`, `fix/`, `refactor/`, `chore/`, `docs/`) - Zuschnitt-Faustregel: Wenn die Commit-Nachricht „und außerdem" braucht, sind es zwei Branches - Zurück nach `main` über `tea pulls create`, nicht per lokalem Merge - Der Fallstrick, über den ich selbst gestolpert bin: `--description` nimmt nur eine Zeichenkette, längere Texte brauchen `$(cat datei)` - `Closes #<n>` für den Bezug auf ein Ticket - Das Mergen gehört dem Menschen, nicht der Umsetzung
RDietermann added 1 commit 2026-08-28 07:24:03 +00:00
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.
RDietermann merged commit c2247faed4 into main 2026-08-28 07:29:16 +00:00
RDietermann deleted branch docs/branch-workflow 2026-08-28 07:29:16 +00:00
Sign in to join this conversation.