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
This commit is contained in:
2026-09-02 23:20:39 +02:00
parent c8c238523a
commit 23e34a940c
10 changed files with 346 additions and 51 deletions
+2 -1
View File
@@ -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 |
@@ -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]]