From 23e34a940cb77d8cd68edf441d85e9f952f1c69d Mon Sep 17 00:00:00 2001 From: Torben Nehmer Date: Wed, 2 Sep 2026 23:20:39 +0200 Subject: [PATCH] feat(kb): Issue Label Scheme auf Vierachsen-Schema und Body-als-Wahrheit nachgezogen (#41) 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 --- kb/concepts/INDEX.md | 2 +- kb/concepts/Issue Label Scheme.md | 155 +++++++++++++----- kb/entities/projects/Chemenu.md | 2 +- kb/entities/tools/Gitea MCP Server.md | 2 +- kb/index.md | 6 +- kb/log.md | 6 + kb/provenance.md | 14 +- kb/sources/INDEX.md | 3 +- ... Management and Label Scheme 2026-09-02.md | 96 +++++++++++ ... Management and Label Scheme 2026-09-02.md | 111 +++++++++++++ 10 files changed, 346 insertions(+), 51 deletions(-) create mode 100644 kb/sources/Source - Gitea Issue 41 - Issue Management and Label Scheme 2026-09-02.md create mode 100644 raw/notes/Gitea Issue 41 - Issue Management and Label Scheme 2026-09-02.md diff --git a/kb/concepts/INDEX.md b/kb/concepts/INDEX.md index 398980d..d7d1e68 100644 --- a/kb/concepts/INDEX.md +++ b/kb/concepts/INDEX.md @@ -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 | diff --git a/kb/concepts/Issue Label Scheme.md b/kb/concepts/Issue Label Scheme.md index d340162..e9f724d 100644 --- a/kb/concepts/Issue Label Scheme.md +++ b/kb/concepts/Issue Label Scheme.md @@ -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]] - + ## 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]] + + +## 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]] + diff --git a/kb/entities/projects/Chemenu.md b/kb/entities/projects/Chemenu.md index b36fb89..02aac7f 100644 --- a/kb/entities/projects/Chemenu.md +++ b/kb/entities/projects/Chemenu.md @@ -14,7 +14,7 @@ related: - implements: MCP-Leseserver - uses: wikitool - composition: AGENTS.md -sources: [Source - Copilot Skill Restructure Instructions, Source - Conversation - AGENTS.md Skill Restructuring Session 2026-08-04, Source - Conversation - Versioning CI-CD and Content Migration Session 2026-08-30, Source - Conversation - Comma Bug Budget Refund and Lint Report Path Session 2026-08-31, Source - Conversation - Issue Triage Labels and TODO Retirement Session 2026-08-31, Source - Conversation - Write-Once Frontmatter Fields and touch --set Session 2026-08-31, Source - Conversation - Gate Counting and Measured Calibration Session 2026-08-31, Source - Conversation - Two Round-Trip Defects Found by an Ingest Session 2026-08-31, Source - Conversation - Hardening the Test Suite Against Silent Environment Dependencies Session 2026-08-31, 'Source - Public Release, Corpus Purge and History Squash Session 2026-09-01', Source - Publish-Remote Gate and Issue Triage Session 2026-09-01, Source - Private-Instance Merge Correction and Issue 30 Session 2026-09-01, Source - MCP Read Server Implementation Session 2026-09-02, Source - Version Part Nomenclature and Breaking Change Gate Session 2026-09-02] +sources: [Source - Copilot Skill Restructure Instructions, Source - Conversation - AGENTS.md Skill Restructuring Session 2026-08-04, Source - Conversation - Versioning CI-CD and Content Migration Session 2026-08-30, Source - Conversation - Comma Bug Budget Refund and Lint Report Path Session 2026-08-31, Source - Conversation - Issue Triage Labels and TODO Retirement Session 2026-08-31, Source - Conversation - Write-Once Frontmatter Fields and touch --set Session 2026-08-31, Source - Conversation - Gate Counting and Measured Calibration Session 2026-08-31, Source - Conversation - Two Round-Trip Defects Found by an Ingest Session 2026-08-31, Source - Conversation - Hardening the Test Suite Against Silent Environment Dependencies Session 2026-08-31, 'Source - Public Release, Corpus Purge and History Squash Session 2026-09-01', Source - Publish-Remote Gate and Issue Triage Session 2026-09-01, Source - Private-Instance Merge Correction and Issue 30 Session 2026-09-01, Source - MCP Read Server Implementation Session 2026-09-02, Source - Version Part Nomenclature and Breaking Change Gate Session 2026-09-02, Source - Gitea Issue 41 - Issue Management and Label Scheme 2026-09-02] confidence: 0.90 confidence_base: 0.90 provenance: mixed diff --git a/kb/entities/tools/Gitea MCP Server.md b/kb/entities/tools/Gitea MCP Server.md index 100c156..29a9818 100644 --- a/kb/entities/tools/Gitea MCP Server.md +++ b/kb/entities/tools/Gitea MCP Server.md @@ -8,7 +8,7 @@ related: - implements: Issue Label Scheme - uses: Gitea - uses: Gitea Actions -sources: [Source - Conversation - Versioning CI-CD and Content Migration Session 2026-08-30, Source - Conversation - Issue Triage Labels and TODO Retirement Session 2026-08-31] +sources: [Source - Conversation - Versioning CI-CD and Content Migration Session 2026-08-30, 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 provenance: sourced diff --git a/kb/index.md b/kb/index.md index ff23052..3dd7247 100644 --- a/kb/index.md +++ b/kb/index.md @@ -13,11 +13,11 @@ The page tables live in a generated `INDEX.md` inside each collection, linked be ## Statistics -- **Total Pages:** 180 +- **Total Pages:** 181 - **Comparisons:** 1 - **Concepts:** 80 - **Entities:** 72 -- **Sources:** 27 +- **Sources:** 28 - **Last Updated:** 2026-09-02 --- @@ -29,7 +29,7 @@ The page tables live in a generated `INDEX.md` inside each collection, linked be | `comparisons/` | 1 | [comparisons/INDEX.md](comparisons/INDEX.md) | | `concepts/` | 80 | [concepts/INDEX.md](concepts/INDEX.md) | | `entities/` | 72 | [entities/INDEX.md](entities/INDEX.md) | -| `sources/` | 27 | [sources/INDEX.md](sources/INDEX.md) | +| `sources/` | 28 | [sources/INDEX.md](sources/INDEX.md) | ### entities/ diff --git a/kb/log.md b/kb/log.md index 7b54ade..7a196c1 100644 --- a/kb/log.md +++ b/kb/log.md @@ -121,3 +121,9 @@ Einheit u3 der Link-Taxonomie-Migration: alle 80 Seiten unter kb/concepts/ von P Abschluss der Korpus-Migration auf die Link-Taxonomie (Gitea #40, Abschnitte 2 und 3). Zuvor uebersehene Restmenge nachgeholt: 37 unlabelled edges in kb/entities/technologies und kb/entities/tools, die u1 nach dem damaligen 'protect, don't remove'-Muster bewusst unbelegt gelassen hatte - mit der u3-Erkenntnis, dass xref add nur die Quellseite anfasst, waren sie gefahrlos nachlabelbar (Wine-/Arch-/Agent-CLI-Cliquen ueberwiegend see-also, dazu echte Kanten: AUR part-of Arch Linux, Arch Linux uses GPG, Obsidian hosts Dataview/Marp, Obsidian required-by Obsidian Web Clipper, Wine required-by Proton, gdeploy uses Go). Erst damit erfuellt der Korpus das Abschlusskriterium des Migrationsdokuments (Schritt 6: unlabelled_edges und unauthorised_labels muessen 0 sein) - vorher waere migrate done eine unbelegte Behauptung gewesen. Endstand: lint meldet 0 unlabelled_edges, 0 unauthorised_labels, 0 malformed_edges, 0 unbalanced_markers, 0 broken_links, 0 dangling_frontmatter_refs, 0 schema_validation_errors; lint --fail-on-error und docs verify beide exit 0. migrate done 4.0.0 --pages 153 gesetzt, kb_version steht auf 4.0.0. VERSION stand bereits auf 4.0.0 (Bump erfolgte mit dem Mechanismus in u0, Commit 177c7e9), ein zweiter Bump entfaellt daher, und CHANGES.md dokumentiert 4.0.0 bereits vollstaendig. Workshop work/link-taxonomy-migration/ nach work/CONTRACT.md geschlossen und geloescht; die dauerhafte Ausgabe ist der gelabelte Korpus selbst. Eine Notiz aus glossary.md hat sich beim Abschluss als Rueckschritt erwiesen: die dort als Erkenntnis notierte Asymmetrie zwischen xref add (einseitig) und xref remove (bidirektional) steht seit jeher woertlich in tools/CONTRACT.md Zeilen 43-44 - sie war nachzulesen, nicht zu entdecken. Offen und an #40 gemeldet: im Katalog fehlt ein Label fuer Urheberschaft (Person erstellt Entity oder Concept); alle solchen Kanten stehen jetzt auf see-also. --- + +## [2026-09-02] update | Issue Label Scheme - Vierachsen-Schema und Body-als-Wahrheit + +Gitea-Issue #41 als raw/notes/Gitea Issue 41 - Issue Management and Label Scheme 2026-09-02.md aufgenommen und als Source-Seite erfasst. kb/concepts/Issue Label Scheme.md auf den Stand vom 2026-09-02 gebracht: vier Pflicht-Achsen (area/kind/prio/size), zwei optionale status/-Flags, Body-als-Wahrheit-Konvention. Das abgeloeste Zweiachsen-Schema steht als Abschnitt Historie mit Diff-Tabelle in der Seite, nicht geloescht. confidence_base 0.70 -> 0.85 (zweite unabhaengige Quelle, Bestaetigung juenger als 30 Tage). + +--- diff --git a/kb/provenance.md b/kb/provenance.md index 962298b..f165b3b 100644 --- a/kb/provenance.md +++ b/kb/provenance.md @@ -8,8 +8,8 @@ inline `[^cite-id]` footnote). ## Coverage Summary -- **Total raw files:** 26 -- **Covered:** 26 +- **Total raw files:** 28 +- **Covered:** 28 - **Uncovered:** 0 --- @@ -106,6 +106,11 @@ inline `[^cite-id]` footnote). - Covered by: [[Source - Conversation - Two Round-Trip Defects Found by an Ingest Session 2026-08-31]] - Cited by: [[Chemenu]], [[Command Round-Trip Integrity]], [[Denylist over Allowlist]], [[Detect-Repair Asymmetry]], [[Gitea]], [[Green Suite Blind Spot]], [[Write-Once Frontmatter Fields]], [[wikitool]] +### `raw/notes/Conversation Transcript - Version Part Nomenclature and Breaking Change Gate Session 2026-09-02.md` + +- Covered by: [[Source - Version Part Nomenclature and Breaking Change Gate Session 2026-09-02]] + - Cited by: [[Chemenu]], [[KB Stack Versioning]], [[wikitool]] + ### `raw/notes/Conversation Transcript - Versioning, CI-CD and Content Migration Session 2026-08-30.md` - Covered by: [[Source - Conversation - Versioning CI-CD and Content Migration Session 2026-08-30]] @@ -121,6 +126,11 @@ inline `[^cite-id]` footnote). - Covered by: [[Source - Docker Cheatsheet]] - Cited by: [[Docker]] +### `raw/notes/Gitea Issue 41 - Issue Management and Label Scheme 2026-09-02.md` + +- Covered by: [[Source - Gitea Issue 41 - Issue Management and Label Scheme 2026-09-02]] + - Cited by: [[Chemenu]], [[Gitea MCP Server]], [[Issue Label Scheme]] + ### `raw/notes/Wine.md` - Covered by: [[Source - Wine]] diff --git a/kb/sources/INDEX.md b/kb/sources/INDEX.md index efb6a70..c354b25 100644 --- a/kb/sources/INDEX.md +++ b/kb/sources/INDEX.md @@ -2,7 +2,7 @@ # kb/sources/ - Index -27 page(s). Regenerated by `wikitool index rebuild`. +28 page(s). Regenerated by `wikitool index rebuild`. ## All @@ -23,6 +23,7 @@ | [[Source - Conversation - Write-Once Frontmatter Fields and touch --set Session 2026-08-31]] | notes | Sitzung, die write-once-Frontmatterfelder reparierbar macht: touch bekommt --set/--add/--remove ueber eine Denylist statt einer Allowlist, ein idempotentes --remove und einen bewusst engen Scope (Stack 1.4.0, Gitea-Issue #14) | 2026-08-31 | | [[Source - Copilot Skill Restructure Instructions]] | notes | Anweisungssatz zur Aufteilung der monolithischen AGENTS.md in einzelne plattformübergreifende Agent-Skills | 2026-08-03 | | [[Source - Docker Cheatsheet]] | notes | Praktisches Bash-Skript zur Fehlersuche bei Docker-Volumes und Overlay2, um den Container zu einem Verzeichnis im Dateisystem zu ermitteln. | 2026-07-31 | +| [[Source - Gitea Issue 41 - Issue Management and Label Scheme 2026-09-02]] | notes | Threadkopie zu Gitea-Issue #41: vier Pflicht-Label-Achsen statt zwei, zwei optionale status/-Flags, und der Issue-Body als aktuelle Wahrheit statt als Ursprungstext | 2026-09-02 | | [[Source - LLM Improvements Codex Analysis]] | notes | Codex-Analyse, die AGENTS.md und wikitool mit awesome-llm-wiki und Farzas Gist vergleicht und 7 aussichtsreiche Verbesserungen sowie zu vermeidende Anti-Muster benennt. Hinweis: eine Sonnet-Analyse zum Vergleich ist vorgesehen. | 2026-08-03 | | [[Source - LLM Improvements Production Agent Gaps 2026]] | notes | Externe Kritik (dzone, 2026) am Fehlen harter Iterations- und Kostengrenzen sowie eines Loop-Breakers; umgesetzt als Iteration Budget Gate in wikitool. | 2026-08-07 | | [[Source - LLM Improvements Sonnet Analysis]] | notes | Sonnet-Analyse, die AGENTS.md und wikitool mit Farzas Gist und awesome-llm-wiki vergleicht und die Codex-Analyse um konkrete Empfehlungen zu Qualitätsschwellen, Stilrichtlinie, Auditrhythmus und Skalierung ergänzt | 2026-08-03 | diff --git a/kb/sources/Source - Gitea Issue 41 - Issue Management and Label Scheme 2026-09-02.md b/kb/sources/Source - Gitea Issue 41 - Issue Management and Label Scheme 2026-09-02.md new file mode 100644 index 0000000..c8963ca --- /dev/null +++ b/kb/sources/Source - Gitea Issue 41 - Issue Management and Label Scheme 2026-09-02.md @@ -0,0 +1,96 @@ +--- +type: types/source.md +source_type: notes +author: Torben Nehmer +raw_files: [raw/notes/Gitea Issue 41 - Issue Management and Label Scheme 2026-09-02.md] +source_language: de +date: 2026-09-02 +tags: [issues, gitea, labels, triage, process] +entities: [Chemenu, Gitea MCP Server] +concepts: [Issue Label Scheme] +summary: 'Threadkopie zu Gitea-Issue #41: vier Pflicht-Label-Achsen statt zwei, zwei optionale status/-Flags, und der Issue-Body als aktuelle Wahrheit statt als Ursprungstext' +--- +# Source: Gitea Issue 41 - Issue Management and Label Scheme 2026-09-02 + +**Autor:** Torben Nehmer +**Datum:** 2026-09-02 +**Raw-Dateien:** raw/notes/Gitea Issue 41 - Issue Management and Label Scheme 2026-09-02.md +**Typ:** Notes + +## Zusammenfassung + +Wörtliche Kopie des Threads zu Gitea-Issue #41, gezogen am 2026-09-02: Issue-Body im Stand +nach der Umsetzung, die drei Changelog-Kommentare und das zu diesem Zeitpunkt in Gitea +angelegte Label-Set. Das Issue hält eine Diskussion vom selben Tag fest, die aus der +Aufarbeitung von fünf als "Fallouts" des Entwicklungsprozesses eingestuften Issues (#38, #30, +#28, #7, #27) hervorging und den Rahmen für deren Bearbeitung setzen sollte. + +Verhandelt wurden drei Dinge. Erstens bleibt ein eingehender Wunsch ein Issue und wird keine +`kb/`-Seite, weil Issues ephemer sind und Wünsche abbilden - neu ist daran nur, wie ein Issue +gepflegt wird: der Body ist aktuelle Wahrheit und wird umgeschrieben, Kommentare tragen einen +Changelog statt einer Vollkopie, und beides macht in der Regel eine LLM-Sitzung. Zweitens +werden aus zwei Pflicht-Label-Achsen vier: `area/`, `kind/`, `prio/` und `size/`. Drittens +kommen zwei optionale Flags dazu, `status/blocked` und `status/unconfirmed`. + +Die Quelle ist zugleich der Beleg für die Umsetzung: das Issue verzeichnet, dass das +Label-Set in Gitea steht und dass das Schema seit Stack-Version `4.0.1` kanonisch in +`instructions/dev/issue-tracking.md` liegt. + +## Kernaussagen + +- **Der Issue-Body ist die Lifeline für das Agent-Memory.** Die Umsetzung eines Issues zieht + sich über mehrere, zeitlich getrennte LLM-Sitzungen, und der Body ist der einzige Ort, der + sie verbindet: eine Sitzung muss allein aus ihm rekonstruieren können, was entschieden und + was offen ist. Ein additiv wachsendes Log zwingt dagegen zum Lesen der ganzen Geschichte, + um den aktuellen Stand herauszufiltern. +- **Kommentare sind Changelog, nicht 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. Der Kommentar nennt nur, was neu, entfallen oder + korrigiert ist. +- **Vier Pflichtachsen sind bezahlbar geworden, weil die Pflege maschinell läuft.** Der + ursprüngliche Einwand gegen eine dritte Achse war der Pflegeaufwand für einen einzelnen + menschlichen Betreuer; da Body-Rewrites und Labelpflege über eine LLM-Sitzung laufen, trägt + er nicht mehr. +- **`area/` folgt der Systemgrenze, nicht dem Codeort.** Die Werte `kb`, `distribution`, + `corpus`, `workflow`, `process` folgen der Stufenteilung aus `AGENTS.md`. Ein `area/tools` + gibt es bewusst nicht - Tooling wird nach der Domäne einsortiert, die es bedient. +- **`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. +- **`prio/` wurde nur umbenannt.** `1`/`2`/`3` heißen jetzt `blocking`/`planned`/`waiting`, + die Bedeutung ist unverändert. Bei `size/` entfällt `XS`; `S`/`M`/`L` bleiben, wie sie + waren. +- **Ein unbelegter Verdacht bleibt nicht offen liegen.** Solange `status/unconfirmed` gesetzt + ist, sind `size` und `prio` vorläufig. Die Triage endet mit entferntem Flag und + verbindlichen Werten oder mit einem geschlossenen Issue samt Begründung - vom Issue selbst + als Prozessentsprechung zu Invariante 3 des Stacks bezeichnet. +- **Sechzehn Label stehen in Gitea**, gelesen am 2026-09-02: fünf `area/`, drei `kind/`, drei + `prio/`, drei `size/`, zwei `status/`. `size/XS`, `prio/1`, `prio/2` und `prio/3` + existieren nicht mehr. +- **Der Release war ein PATCH.** `4.0.1`, weil `dist export` `instructions/dev/` vollständig + ausschließt und sich für eine ausgelieferte Instanz nichts ändert - dieselbe Begründung wie + bei `1.2.1`, das das Zweiachsen-Schema eingeführt hatte. + +## Aufgaben + +- [ ] Bestehende Sachissues nach und nach auf die vier Pflicht-Label umstellen (laut Issue + bereits umgestellt: #38, #27 geschlossen, #7, #42) + +## Nicht übernommen + +- **Die Diskussion, aus der das Issue hervorging.** Das Issue nennt sie ("Diskussion vom + 2026-09-02"), aber ihr Transkript liegt nicht in `raw/`. Die Quelle ist damit das Ergebnis + der Debatte, nicht ihr Verlauf; die verworfenen Alternativen sind nicht rekonstruierbar. +- **Die Sachinhalte der referenzierten Issues #38, #30, #28, #27, #7, #42, #39, #40.** Sie + kommen im Thread nur als Nummern vor. Was in ihnen steht, gehört in die Seiten zu den + jeweiligen Gegenständen, nicht hierher. +- **Der Volltext von `instructions/dev/issue-tracking.md`.** Das Issue beschreibt, was dort + hineingeschrieben wurde; die Instruction selbst ist Teil des Stacks und kein Rohmaterial. + +## Verwandte Entities + +- [[Chemenu]] +- [[Gitea MCP Server]] + +## Verwandte Concepts + +- [[Issue Label Scheme]] diff --git a/raw/notes/Gitea Issue 41 - Issue Management and Label Scheme 2026-09-02.md b/raw/notes/Gitea Issue 41 - Issue Management and Label Scheme 2026-09-02.md new file mode 100644 index 0000000..060b1aa --- /dev/null +++ b/raw/notes/Gitea Issue 41 - Issue Management and Label Scheme 2026-09-02.md @@ -0,0 +1,111 @@ +# Gitea Issue #41 — Issue-Management: Label-Schema und Body-als-Wahrheit-Konvention + +Wörtliche Kopie des Issue-Threads von , +gezogen am 2026-09-02 nach dem Body-Rewrite, der die Umsetzung in `4.0.1` festhält. Autor +aller Beiträge: torben. Erstellt 2026-09-02T20:48:56Z, zuletzt geändert 2026-09-02T21:13:11Z. + +Labels zum Zeitpunkt der Kopie: `area/process`, `kind/build`, `prio/blocking`, `size/M`. +Status: offen. + +--- + +## Issue-Body (Stand 2026-09-02T21:13:11Z) + +## Kontext + +Bündelt die Ergebnisse einer Diskussion am 2026-09-02 über den Entwicklungsprozess dieses Repos, ausgehend von den Fallouts in #38, #30, #28, #7, #27. Bewusst das erste Issue, das umgesetzt wird - es setzt den Rahmen für die Bearbeitung aller anderen. + +**Stand:** Label-Set steht in Gitea, das Schema ist seit `4.0.1` kanonisch in `instructions/dev/issue-tracking.md` (Commit `c8c2385`). Offen ist nur noch die Relabelung der verbliebenen Sachissues und eine `kb/`-Seite, die noch das alte Schema beschreibt. + +## Entscheidung 1: Issues bleiben Storage für eingehende Specs, mit schärferer Pflege + +Ein eingehender Wunsch/Requirement bleibt Issue, nicht `kb/`-Seite - Issues sind ephemer und bilden Wünsche ab, `kb/` bildet verifiziertes, dauerhaftes Wissen ab (unverändert gegenüber `instructions/dev/issue-tracking.md`). + +**Motivation für die verschärfte Pflege:** Die Umsetzung der hier verhandelten Issues zieht sich über mehrere, oft zeitlich getrennte LLM-Sitzungen. Der Issue-Body ist der einzige Ort, der diese Sitzungen verbindet - er ist die Lifeline für das Agent-Memory. Eine Sitzung, die ein Issue neu öffnet, muss allein aus dem Body rekonstruieren können, was entschieden ist und was noch offen ist, ohne dass ein Mensch den Kontext erneut vorkaut. Ein additiv wachsendes Log zwingt zum Lesen der ganzen Geschichte, um den aktuellen Stand herauszufiltern - ein aktuell gehaltener Body liefert ihn direkt. Das ist der eigentliche Grund für die folgenden drei Regeln, nicht Ordnung um der Ordnung willen. + +- **Body = aktuelle Wahrheit.** Der Body wird aktiv umgeschrieben, wenn sich der Stand ändert - kein additives Anhängen an einen veralteten Ursprungstext. +- **Kommentare = Changelog, nicht Kopie.** Beim Body-Rewrite wird kein Volltext-Snapshot des alten Stands als Kommentar gesichert, sondern ein kurzer Changelog-Eintrag, der nur benennt, was sich gegenüber dem vorherigen Stand geändert hat - neu, entfallen, korrigiert. Eine Vollkopie pro Revision zwingt einen Menschen zum Diffen zweier Fließtexte und ist damit keine lesbare Historie, sondern nur eine weitere Kopie. +- **Bearbeitung primär durch LLM.** Menschen fassen in der Regel nur Labels/Metadaten direkt an; Body-Rewrites und Kommentare laufen über eine LLM-Sitzung. + +## Entscheidung 2: Vier Pflicht-Label-Familien statt zwei + +| Familie | Werte | Bedeutung | +|---|---|---| +| `area/` | `kb`, `distribution`, `corpus`, `workflow`, `process` | Welche Systemgrenze betroffen ist, entlang der bestehenden Stufenteilung aus `AGENTS.md` (kein `area/tools` - Tooling wird nach der Domäne eingeordnet, die es bedient, nicht nach Codeort) | +| `size/` | `S`, `M`, `L` (verdichtet von vier auf drei Stufen, `XS` entfällt) | Aufwand, unverändert in der Bedeutung von `S`/`M`/`L` | +| `prio/` | `blocking`, `planned`, `waiting` (Umbenennung von `1`/`2`/`3`, Bedeutung unverändert) | Dringlichkeit, weiterhin fließend zu handhaben | +| `kind/` | `decision`, `build`, `defect` | Art der Offenheit: wartet auf eine Betreiberentscheidung, ist spezifiziert und wartet auf Umsetzungszeit, oder ist ein Befund über einen Widerspruch. Darf sich im Lauf eines Issues ändern (z.B. `decision` → `build`, sobald entschieden) - das ist erwünschtes Session-Memory-Verhalten, kein Makel | + +Alle vier sind Pflicht auf jedem offenen Issue, weil maschinelle Pflege durch das LLM den ursprünglichen Einwand gegen eine dritte/vierte Achse (Pflegeaufwand für einen einzelnen Menschen) entkräftet. + +## Entscheidung 3: Zwei optionale Status-Flags + +- `status/blocked` - wartet auf ein anderes, noch offenes Issue; unabhängig vom `prio`-Wert nicht eigenständig bearbeitbar. Nicht mandatory, weil es eine Beziehung zwischen Issues abbildet, keine Eigenschaft eines einzelnen. +- `status/unconfirmed` - gemeldeter Verdacht, noch nicht gegen tatsächliches Verhalten geprüft. Gilt für jeden `kind`-Wert, nicht nur `defect`. Solange gesetzt, sind `size` und `prio` vorläufig. Nach Triage: Flag entfernt und `size`/`prio` verbindlich gesetzt, oder Issue mit Begründung geschlossen (kein unbelegter Verdacht bleibt offen liegen - Analogie zu Invariante 3 des Stacks, nur auf Prozessebene). + +## Migration der bestehenden Labels + +`prio/1` → `prio/blocking`, `prio/2` → `prio/planned`, `prio/3` → `prio/waiting` (reine Umbenennung). `size/XS` entfällt, `size/S`/`M`/`L` bleiben unverändert. `area/*`, `kind/*`, `status/*` sind neu. **Erledigt** - alle 16 Label stehen in Gitea. + +## Umgesetzt in `4.0.1` + +`instructions/dev/issue-tracking.md` ist auf das Schema umgeschrieben: Schritt 2 (Body als aktuelle Wahrheit inkl. Mehrsitzungs-Begründung), Schritt 3 (Changelog-Kommentar statt Vollkopie, mit Beispiel), Schritt 4 (alle vier Pflichtachsen als vier Tabellen), Schritt 5 (die beiden `status/`-Flags und der Triage-Ausgang), Schritt 6 (Re-Labeling schließt `kind/`-Wechsel ein). Der Entscheidungspunkt „Two labels feel too coarse?" ist entfallen, an seine Stelle treten zwei neue („Rewrite the body, or add a comment?" und der Umgang mit Altissues, die nur zwei Label tragen). Die Beschreibungszeile in `instructions/dev/stack-dev/SKILL.md` nennt jetzt die vier Achsen und die Body-Konvention. + +PATCH und nicht MINOR, weil `dist export` `instructions/dev/` vollständig ausschließt - für eine ausgelieferte Instanz ändert sich nichts. Gleiche Begründung wie bei `1.2.1`, das das ursprüngliche Zweiachsen-Schema eingeführt hat. + +## Nicht in diesem Issue + +Die Relabelung der bestehenden Sachissues erfolgt in deren jeweiligen Einzel-Sitzungen. Bereits umgestellt: #38, #27 (geschlossen), #7, #42. + +`kb/concepts/Issue Label Scheme.md` beschreibt weiterhin das zweiachsige Schema von 2026-08-31 (`prio/1..3`, `size/XS..L`, „keine dritte Achse") und ist damit veraltet. Die Aktualisierung ist ein `kb/`-Schreibzugriff und braucht eine `wiki-manage`-Sitzung mit ordentlicher Quelle - nicht Teil dieses Issues. + +## Akzeptanzkriterien + +- [x] Label-Set in Gitea angelegt/umbenannt (dieses Issue) +- [x] `instructions/dev/issue-tracking.md` in einer stack-dev-Sitzung um dieses Schema ergänzt (`4.0.1`, Commit `c8c2385`) +- [ ] Bestehende Sachissues nach und nach auf die vier Pflicht-Label umgestellt +- [ ] `kb/concepts/Issue Label Scheme.md` in einer `wiki-manage`-Sitzung nachgezogen +- [ ] Dieses Issue dient bis dahin als Referenz für das Schema + +## Vorgeschichte + +Entschieden in der Diskussion vom 2026-09-02, im Rahmen einer Aufarbeitung von #38, #30, #28, #7, #27 als "Fallouts" des Entwicklungsprozesses. #39 und #40 liefen parallel und unabhängig, nicht Teil dieser Debatte. + +--- + +## Kommentar 1 (2026-09-02T20:57:51Z, issuecomment-512) + +**Changelog:** Entscheidung 1, dritter Punkt korrigiert. Vorher: "Kommentare = Historie", der bisherige Body-Stand wird beim Umschreiben vollständig als Kommentar gesichert. Jetzt: "Kommentare = Changelog, nicht Kopie" - ein Kommentar nennt nur, was sich geändert hat, keine Volltextkopie des alten Bodys. Grund: eine Vollkopie pro Revision ist für einen Menschen nicht diffbar und damit keine brauchbare Historie. + +## Kommentar 2 (2026-09-02T21:07:47Z, issuecomment-539) + +**Changelog:** Entscheidung 1 um Motivationsabsatz ergänzt (Body als Lifeline für Agent-Memory über mehrere Sitzungen hinweg, nicht Ordnung um der Ordnung willen). Akzeptanzkriterium 1 abgehakt, Referenzliste der bereits umgestellten Issues (#38, #27, #7, #42) ergänzt. + +## Kommentar 3 (2026-09-02T21:13:19Z, issuecomment-545) + +**Changelog:** Akzeptanzkriterium 2 abgehakt - das Schema ist mit `4.0.1` (Commit `c8c2385`) kanonisch in `instructions/dev/issue-tracking.md`. Neu: Stand-Zeile im Kontext, Abschnitt „Umgesetzt in `4.0.1`" (was genau in der Instruction steht, und warum PATCH), Vermerk „Erledigt" an der Label-Migration. Neu als offener Punkt und als fünftes Akzeptanzkriterium: `kb/concepts/Issue Label Scheme.md` beschreibt noch das Zweiachsen-Schema und braucht eine eigene `wiki-manage`-Sitzung. Entfallen: der Absatz „Die eigentliche Textänderung ... braucht eine separate stack-dev-Sitzung" - genau die ist jetzt gelaufen. + +--- + +## Label-Set in Gitea (gelesen 2026-09-02, `label_read list_repo_labels`) + +| Label | Beschreibung | +|---|---| +| `area/kb` | Betrifft kb/-Schema, Contract, Confidence, Lint, Wissensbasis | +| `area/distribution` | Betrifft Auslieferung, Upgrade, Versionierung einer Instanz | +| `area/corpus` | Betrifft Demo-/Testbett-Frage, Inhalt und Umfang von kb/ | +| `area/workflow` | Betrifft Git, Merge, Branching, Publish, PRs | +| `area/process` | Betrifft den Entwicklungsprozess selbst, nicht den Stack als Artefakt | +| `kind/decision` | Wartet auf eine Betreiberentscheidung | +| `kind/build` | Spezifiziert, wartet nur noch auf Umsetzungszeit | +| `kind/defect` | Befund: Doku und Realitaet, oder zwei Dokus, widersprechen sich | +| `prio/blocking` | Blockiert oder beschaedigt laufende Arbeit - als naechstes | +| `prio/planned` | Traegt bald Zinsen - eingeplant | +| `prio/waiting` | Sinnvoll, wartet auf einen Ausloeser | +| `size/S` | Eine Sitzung, ein Publish, klar umrissener Schnitt | +| `size/M` | Mehrere Dateien, Contract- oder Instruction-Aenderung, eigener Testaufwand | +| `size/L` | Mehrere Sitzungen oder offene Designfragen vor dem ersten Commit | +| `status/blocked` | Wartet auf ein anderes, noch offenes Issue - nicht eigenstaendig bearbeitbar | +| `status/unconfirmed` | Gemeldeter Verdacht, noch nicht gegen tatsaechliches Verhalten geprueft - size/prio vorlaeufig | + +Sechzehn Label. `size/XS`, `prio/1`, `prio/2` und `prio/3` existieren nicht mehr.