• v4.0.1 c8c238523a

    v4.0.1
    CI / verify (push) Successful in 53s
    Release / release (push) Successful in 39s
    Stable

    torben released this 2026-09-02 21:14:49 +00:00 | 82 commits to main since this release

    4.0.1 - 2026-09-02 - Issue-Board: vier Pflicht-Label-Familien und Body-als-Wahrheit

    Author: Torben Nehmer

    Das Issue-Schema aus 1.2.1 hatte zwei Pflichtachsen und einen ausdrücklich begründeten Verzicht
    auf eine dritte: eine Taxonomie mit mehr Achsen brauche eigene Pflege, und das Board habe einen
    einzigen Betreuer. Diese Begründung ist entfallen, weil die Pflege inzwischen maschinell
    passiert - Body-Rewrites und Kommentare laufen über eine LLM-Sitzung, Menschen fassen in der
    Regel nur Labels an. Damit sind vier Achsen bezahlbar (Issue #41).

    Pflicht auf jedem offenen Issue sind jetzt vier Label: area/ (kb, distribution,
    corpus, workflow, process - kein area/tools, Tooling wird nach der bedienten Domäne
    einsortiert, nicht nach Codeort), kind/ (decision, build, defect), prio/
    (blocking, planned, waiting - reine Umbenennung von 1/2/3) und size/ (S, M,
    L; XS entfällt). Dazu zwei optionale Flags: status/blocked für Abhängigkeit von einem
    anderen offenen Issue, status/unconfirmed für einen ungeprüften Verdacht, unter dem size
    und prio vorläufig sind. Ein unconfirmed-Issue endet in der Triage entweder ohne Flag und
    mit verbindlichen Werten oder geschlossen mit Begründung - die Prozessentsprechung zu
    Invariante 3.

    Der Issue-Body ist ab jetzt aktuelle Wahrheit, nicht Ursprungstext. Die Umsetzung eines
    Issues zieht sich über mehrere, zeitlich getrennte Sitzungen, und der Body ist das einzige, was
    sie verbindet: eine Sitzung muss aus ihm allein rekonstruieren können, was entschieden und was
    offen ist. Er wird deshalb umgeschrieben statt ergänzt. Jeder Rewrite bekommt einen Kommentar,
    der ausschließlich benennt, was sich geändert hat - keine Vollkopie des alten Stands, weil ein
    Mensch zwei Fließtexte nicht diffen kann und eine Kopie pro Revision damit keine Historie ist,
    sondern nur eine weitere Kopie.

    Geändert: instructions/dev/issue-tracking.md (Schritte 2,
    3, 5 neu; Schritt 4 um area/ und kind/ erweitert; der Entscheidungspunkt „Two labels feel
    too coarse?" entfällt) und die Beschreibungszeile in instructions/dev/stack-dev/SKILL.md. Für
    eine ausgelieferte Instanz ändert sich nichts: dist export schließt instructions/dev/
    vollständig aus, weshalb dies ein PATCH ist und kein MINOR - dieselbe Begründung wie bei
    1.2.1. Noch offen aus #41: kb/concepts/Issue Label Scheme.md beschreibt weiterhin das
    zweiachsige Schema und braucht eine eigene wiki-manage-Sitzung.

    Downloads