torben/chemenu
1
1
Fork 0
Code Issues 26 Pull Requests Actions Packages Releases 32 Activity

feat(kb): Issue Label Scheme auf Vierachsen-Schema und Body-als-Wahrheit nachgezogen (#41)

Browse Source 
Files changed:
- kb/concepts/INDEX.md
- kb/concepts/Issue Label Scheme.md
- kb/entities/projects/Chemenu.md
- kb/entities/tools/Gitea MCP Server.md
- kb/index.md
- kb/log.md
- kb/provenance.md
- kb/sources/INDEX.md
- kb/sources/Source - Gitea Issue 41 - Issue Management and Label Scheme 2026-09-02.md
- raw/notes/Gitea Issue 41 - Issue Management and Label Scheme 2026-09-02.md
This commit is contained in:
Torben Nehmer
2026-09-02 23:20:39 +02:00
parent c8c238523a
commit 23e34a940c
10 changed files with 346 additions and 51 deletions
Download Patch File Download Diff File Expand all files Collapse all files
kb/concepts/INDEX.md
+1 -1
View File
@@ -41,7 +41,7 @@
| [[Hybrid Search]] | architecture | Multimodale Suche, die BM25-Schlüsselwortabgleich, Vektor-Embeddings und Graph Traversal verbindet, um Wissensabruf im Wiki skalierbar zu machen. | 2026-08-29 |
| [[Implementation Spectrum]] | architecture | Modularer Einführungspfad für die Funktionen von LLM Wiki v2, vom minimal tragfähigen Wiki bis zur vollen Umsetzung mit Automatisierung und Governance. | 2026-08-29 |
| [[Index Scaling]] | workflow | Skalierungsregeln für Indexseiten: Tabellenabschnitte ab 50 Einträgen teilen, ab 200 Seiten _meta/topic-map.md anlegen | 2026-08-29 |
| [[Issue Label Scheme]] | decision | Zweiachsiges Pflicht-Labelschema fuer das Gitea-Board: prio/1..3 und size/XS..L, bewusst keine dritte Achse; die Regel liegt in instructions/dev/, weil sie keine ausgelieferte Instanz erreichen darf | 2026-08-31 |
| [[Issue Label Scheme]] | decision | Pflicht-Labelschema fuer das Gitea-Board: seit 2026-09-02 vier Achsen (area/kind/prio/size) plus zwei optionale status/-Flags, dazu der Issue-Body als aktuelle Wahrheit; die Regel liegt in instructions/dev/, weil sie keine ausgelieferte Instanz erreichen darf | 2026-09-02 |
| [[Iteration and Cost Limits]] | workflow | Im Code durchgesetzte Obergrenze von 60 wikitool-Aufrufen je Session, Loop-Breaker bei 3 identischen Wiederholungen, Slot-Erstattung, ein gemessenes Kalibrierungsband, und Retrieval sowie der MCP-Leseserver bleiben ausgenommen | 2026-09-02 |
| [[KB Migration]] | workflow | Migration des KB-Inhalts entlang einer geordneten Versionskette; abgegrenzt gegen offene Instanz-Aktionen, die in den doctor-Check gehoeren statt in die Kette | 2026-08-31 |
| [[KB Stack Versioning]] | decision | Semantische Versionierung des Wiki-Stacks: VERSION beschreibt die Maschinerie, Kompatibilitaet (Drop-in-Ersatz) und Inhaltsmigration sind seit 2.5.0 getrennte, unabhaengig geprueft Fragen | 2026-09-02 |
kb/concepts/Issue Label Scheme.md
+113 -42
View File
@@ -3,17 +3,17 @@ type: types/concept.md
concept_type: decision
tags: [issues, gitea, triage, labels, backlog]
created: 2026-08-31
modified: 2026-08-31
modified: 2026-09-02
related:
- operates-on: Chemenu
- mechanism: Gitea MCP Server
- see-also: KB Stack Versioning
- see-also: Detect-Repair Asymmetry
sources: [Source - Conversation - Issue Triage Labels and TODO Retirement Session 2026-08-31]
sources: [Source - Conversation - Issue Triage Labels and TODO Retirement Session 2026-08-31, Source - Gitea Issue 41 - Issue Management and Label Scheme 2026-09-02]
confidence: 0.70
confidence_base: 0.70
confidence_base: 0.85
provenance: sourced
summary: 'Zweiachsiges Pflicht-Labelschema fuer das Gitea-Board: prio/1..3 und size/XS..L, bewusst keine dritte Achse; die Regel liegt in instructions/dev/, weil sie keine ausgelieferte Instanz erreichen darf'
summary: 'Pflicht-Labelschema fuer das Gitea-Board: seit 2026-09-02 vier Achsen (area/kind/prio/size) plus zwei optionale status/-Flags, dazu der Issue-Body als aktuelle Wahrheit; die Regel liegt in instructions/dev/, weil sie keine ausgelieferte Instanz erreichen darf'
---
# Issue Label Scheme
@@ -22,36 +22,78 @@ summary: 'Zweiachsiges Pflicht-Labelschema fuer das Gitea-Board: prio/1..3 und s
## Definition
Issue Label Scheme ist die Entscheidung, offene Arbeit an diesem Stack ausschließlich als
Gitea-Issues zu führen und jedes Issue mit genau zwei Pflicht-Labels zu versehen: einer
Priorität `prio/1..3` und einer Größe `size/XS..L`. Eine dritte Achse gibt es bewusst nicht.
Getroffen wurde die Entscheidung am 2026-08-31, gemeinsam mit der Löschung von `TODO.md`[^s-conversation-issue-triage-labels-and-todo-retirement-session-2026-08-31].
Gitea-Issues zu führen und jedes offene Issue mit vier Pflicht-Labels zu versehen: einem
Bereich `area/`, einer Art `kind/`, einer Priorität `prio/` und einer Größe `size/`. Dazu
kommen zwei optionale `status/`-Flags. Getroffen wurde die Entscheidung in dieser Form am
2026-09-02[^s-gitea-issue-41-issue-management-and-label-scheme-2026-09-02]; sie ersetzt das
zweiachsige Schema vom 2026-08-31 (siehe [Historie](#historie)).
| Priorität | Bedeutung |
| `area/` | Bedeutung |
|---|---|
| `prio/1` | Blockiert oder beschädigt laufende Arbeit. Als Nächstes. |
| `prio/2` | Sammelt Zinsen. Eingeplant. |
| `prio/3` | Lohnend, wartet auf einen benannten Auslöser. |
| `area/kb` | `kb/`-Schema, Contract, Confidence, Lint - die Wissensbasis als System. |
| `area/distribution` | Auslieferung, Upgrade und Versionierung einer Instanz. |
| `area/corpus` | Inhalt und Umfang von `kb/` in dieser Instanz, samt Demo-/Testbett-Frage. |
| `area/workflow` | Git, Merge, Branching, Publish, PRs. |
| `area/process` | Der Entwicklungsprozess selbst, nicht der Stack als Artefakt. |
| Größe | Bedeutung |
| `kind/` | Bedeutung |
|---|---|
| `kind/decision` | Wartet auf eine Betreiberentscheidung. |
| `kind/build` | Spezifiziert, wartet nur noch auf Umsetzungszeit. |
| `kind/defect` | Befund: Doku und Realität, oder zwei Dokus, widersprechen sich. |
| `prio/` | Bedeutung |
|---|---|
| `prio/blocking` | Blockiert oder beschädigt laufende Arbeit. Als Nächstes. |
| `prio/planned` | Sammelt Zinsen. Eingeplant. |
| `prio/waiting` | Lohnend, wartet auf einen benannten Auslöser. |
| `size/` | Bedeutung |
|---|---|
| `size/XS` | Minuten. Oft nur eine Entscheidung oder eine Beobachtung. |
| `size/S` | Eine Sitzung, ein Publish, ein klarer Schnitt. |
| `size/M` | Mehrere Dateien; eine Contract- oder Instruction-Änderung; eigener Testaufwand. |
| `size/L` | Mehrere Sitzungen, oder offene Entwurfsfragen vor dem ersten Commit. |
Die sieben Labels wurden angelegt und auf alle zehn zu dem Zeitpunkt offenen Issues
angewandt[^s-conversation-issue-triage-labels-and-todo-retirement-session-2026-08-31].
| `status/` (optional) | Bedeutung |
|---|---|
| `status/blocked` | Wartet auf ein anderes, noch offenes Issue - unabhängig vom `prio`-Wert nicht eigenständig bearbeitbar. |
| `status/unconfirmed` | Gemeldeter Verdacht, noch nicht gegen tatsächliches Verhalten geprüft; `size` und `prio` sind solange vorläufig. |
Sechzehn Labels stehen in Gitea; `prio/1`, `prio/2`, `prio/3` und `size/XS` existieren nicht
mehr[^s-gitea-issue-41-issue-management-and-label-scheme-2026-09-02].
## Kernpunkte
- **Beide Achsen sind Pflicht, weil eine Priorität ohne Kosten eine halbe Entscheidung ist.**
Größe ist Aufwand und nicht Wichtigkeit, deshalb ist `prio/1 size/XS` das Beste, was auf
einem Board stehen kann, und `prio/3 size/L` etwas, worüber gesprochen wird, bevor jemand
anfängt.
- **`prio/3` ist kein Friedhof.** Der Auslöser muss im Issue benannt sein, sonst ist das Label
ein höfliches Nein[^s-conversation-issue-triage-labels-and-todo-retirement-session-2026-08-31].
- **Keine dritte Achse.** Art, Bereich oder Status wurden verworfen als der Punkt, ab dem eine
Taxonomie eigene Pflege braucht. Das Board hat einen einzigen Betreuer.
- **Vier Achsen sind Pflicht, weil ihre Pflege maschinell läuft.** Der ursprüngliche Einwand
gegen eine dritte Achse war der Aufwand für einen einzelnen menschlichen Betreuer. Da
Body-Rewrites und Labelpflege über eine LLM-Sitzung laufen und ein Mensch in der Regel nur
Metadaten anfasst, trägt dieser Einwand
nicht mehr[^s-gitea-issue-41-issue-management-and-label-scheme-2026-09-02].
- **Der Issue-Body ist die aktuelle Wahrheit, nicht der Ursprungstext.** Die Umsetzung eines
Issues zieht sich über mehrere, zeitlich getrennte Sitzungen, und der Body ist das einzige,
was sie verbindet: eine Sitzung muss allein aus ihm rekonstruieren können, was entschieden
und was offen ist. Er wird deshalb umgeschrieben statt
ergänzt[^s-gitea-issue-41-issue-management-and-label-scheme-2026-09-02].
- **Ein Kommentar ist ein Changelog, keine Kopie.** Ein Volltext-Snapshot des alten Bodys pro
Revision zwingt einen Menschen zum Diffen zweier Fließtexte und ist damit keine lesbare
Historie, sondern nur eine weitere
Kopie[^s-gitea-issue-41-issue-management-and-label-scheme-2026-09-02].
- **`area/` folgt der Systemgrenze, nicht dem Codeort.** Die Werte folgen der Stufenteilung aus
`AGENTS.md`. Ein `area/tools` gibt es bewusst nicht - Tooling wird nach der Domäne
einsortiert, die es
bedient[^s-gitea-issue-41-issue-management-and-label-scheme-2026-09-02].
- **`kind/` darf sich im Lauf eines Issues ändern.** Der Wechsel von `decision` zu `build`,
sobald entschieden ist, ist erwünschtes Session-Memory-Verhalten und kein
Makel[^s-gitea-issue-41-issue-management-and-label-scheme-2026-09-02].
- **Eine Priorität ohne Kosten ist eine halbe Entscheidung.** Größe ist Aufwand und nicht
Wichtigkeit, deshalb ist `prio/blocking size/S` das Beste, was auf einem Board stehen kann,
und `prio/waiting size/L` etwas, worüber gesprochen wird, bevor jemand anfängt.
- **`prio/waiting` ist kein Friedhof.** Der Auslöser muss im Issue benannt sein, sonst ist das
Label ein höfliches Nein[^s-conversation-issue-triage-labels-and-todo-retirement-session-2026-08-31].
- **Kein unbelegter Verdacht bleibt offen liegen.** Die Triage eines `status/unconfirmed`
endet entweder mit entferntem Flag und verbindlichen `size`/`prio`-Werten oder mit einem
geschlossenen Issue samt Begründung - die Prozessentsprechung zu Invariante 3 des
Stacks[^s-gitea-issue-41-issue-management-and-label-scheme-2026-09-02].
- **Priorisiert wird nach Schaden, nicht nach Aufwand.** Das Kriterium der ersten Triage
lautete: was blockiert oder beschädigt laufende Arbeit. Ein Werkzeugfehler, der seinen
Benutzer gegen eine Invariante des Stacks drückt, rangiert deshalb vor einer fehlenden
@@ -63,6 +105,28 @@ angewandt[^s-conversation-issue-triage-labels-and-todo-retirement-session-2026-0
Linkliste auf Issues; der zweite, die Recherche-Notiz, ging vollständig nach #15. Danach gab
es nichts mehr in der Datei, was nicht auf Gitea stand.
## Historie
Das ursprüngliche Schema vom 2026-08-31 hatte ~~genau zwei Pflicht-Labels, `prio/1..3` und
`size/XS..L`, und verzichtete ausdrücklich auf eine dritte Achse: Art, Bereich oder Status
wurden verworfen als der Punkt, ab dem eine Taxonomie eigene Pflege braucht, und das Board
habe einen einzigen Betreuer.~~ Sieben Labels wurden angelegt und auf alle zehn zu dem
Zeitpunkt offenen Issues
angewandt[^s-conversation-issue-triage-labels-and-todo-retirement-session-2026-08-31].
Was sich am 2026-09-02 geändert hat:
| Achse | Vorher | Jetzt |
|---|---|---|
| `prio/` | `1`, `2`, `3` | `blocking`, `planned`, `waiting` - reine Umbenennung, Bedeutung unverändert |
| `size/` | `XS`, `S`, `M`, `L` | `S`, `M`, `L` - `XS` entfällt, die übrigen unverändert |
| `area/` | - | fünf Werte, neu |
| `kind/` | - | drei Werte, neu |
| `status/` | - | zwei optionale Flags, neu |
Der Verzicht auf die dritte Achse fiel damit weg, nicht weil die Begründung falsch war,
sondern weil ihre Voraussetzung entfallen ist: gepflegt wird das Board nicht mehr von Hand.
## Wo die Regel liegt
Die Platzierung war die tragende Entscheidung, nicht das Schema selbst. `README.md` und
@@ -80,42 +144,42 @@ Instanz ändert sich nichts. Das CI-Versions-Gate verlangte den Bump trotzdem, w
auf `instructions/` passt und `instructions/dev/` darunter liegt[^s-conversation-issue-triage-labels-and-todo-retirement-session-2026-08-31]. Siehe
[[KB Stack Versioning]].
Für die Erweiterung auf vier Achsen galt dieselbe Rechnung noch einmal: sie ging als `4.0.1`
und damit ebenfalls als PATCH
hinaus[^s-gitea-issue-41-issue-management-and-label-scheme-2026-09-02].
## Beispiele
- [[Chemenu]] - das Repository, dessen Board nach dem Schema geführt wird; sieben Labels
wurden angelegt und auf alle zehn offenen Issues angewandt
- [[Gitea MCP Server]] - der Weg, auf dem Issues und Labels gelesen und geschrieben werden, da
das Origin-Repository privat ist
- [[Chemenu]] - das Repository, dessen Board nach dem Schema geführt wird; sechzehn Labels
stehen dort, verteilt auf vier Pflicht- und eine optionale Familie
- [[Gitea MCP Server]] - der Weg, auf dem Issues und Labels gelesen und geschrieben werden
- [[Detect-Repair Asymmetry]] - Issue #14 ist der Fall, den dieses Concept beschreibt, und
trägt `prio/2 size/S`
trug in der ersten Triage `prio/2 size/S`, nach der Umbenennung also `prio/planned size/S`
## Wann zu verwenden
- Auf einem Board mit einem einzigen Betreuer, das eine erkennbare Reihenfolge braucht, aber
keinen Prozess.
- Auf einem Board mit einem einzigen menschlichen Betreuer, dessen Labelpflege maschinell
läuft. Erst das macht mehr als zwei Achsen bezahlbar.
- Sobald offene Arbeit sonst in Prosa-Dateien wandert, die niemand als Board liest und die
gegen den Tracker driften.
- Sobald die Bearbeitung eines Issues sich über mehrere, zeitlich getrennte Sitzungen zieht -
dann trägt die Body-als-Wahrheit-Konvention den Kontext, den sonst ein Mensch jedes Mal neu
erzählen müsste.
## Wann NICHT zu verwenden
- Nicht auf einem Board mit mehreren Teams, wo Zuständigkeit und Bereich echte Information
tragen. Dann ist die dritte Achse keine Taxonomie-Pflege, sondern Routing.
- Nicht dort, wo Labels von Hand gepflegt werden. Dann ist die ursprüngliche Zweiachsigkeit
die tragfähigere Wahl, und die Begründung von 2026-08-31 gilt unverändert.
- Nicht als Ersatz für die Abnahmekriterien im Issue-Text. Die Labels ordnen ein Issue ein; ob
es fertig ist, sagen sie nicht.
- Nicht mit umgeschriebenen Bodys dort, wo mehrere Menschen denselben Thread lesen und den
Verlauf brauchen. Die Konvention tauscht Historie gegen Aktualität und setzt voraus, dass
der Changelog-Kommentar als Historie genügt.
- Nicht in einer ausgelieferten Instanz. Das Schema beschreibt das Entwicklungs-Repository und
hat außerhalb davon keinen Gegenstand.
## Beziehungen
## Siehe auch
- [[Source - Conversation - Issue Triage Labels and TODO Retirement Session 2026-08-31]]
## Fußnoten
[^s-conversation-issue-triage-labels-and-todo-retirement-session-2026-08-31]: [[Source - Conversation - Issue Triage Labels and TODO Retirement Session 2026-08-31]]
<!-- wikitool:links -->
## Beziehungen
- **operates-on:** [[Chemenu]]
@@ -123,3 +187,10 @@ auf `instructions/` passt und `instructions/dev/` darunter liegt[^s-conversation
- **see-also:** [[KB Stack Versioning]]
- **see-also:** [[Detect-Repair Asymmetry]]
<!-- /wikitool:links -->
<!-- wikitool:footnotes -->
## Fußnoten
[^s-gitea-issue-41-issue-management-and-label-scheme-2026-09-02]: [[Source - Gitea Issue 41 - Issue Management and Label Scheme 2026-09-02]]
[^s-conversation-issue-triage-labels-and-todo-retirement-session-2026-08-31]: [[Source - Conversation - Issue Triage Labels and TODO Retirement Session 2026-08-31]]
<!-- /wikitool:footnotes -->