move: source_type: Default streichen, unclassified als sichtbares Fach, layout: fuer source (schliesst #66)
CI / verify (push) Successful in 53s
Release / release (push) Successful in 35s

Files changed:
- CHANGES.md
- VERSION
- instructions/dev/corpus-policy.md
- instructions/wiki-ingest/SKILL.md
- kb/index.md
- kb/log.md
- kb/sources/COLLECTION.md
- kb/sources/INDEX.md
- kb/sources/Source - AMD Powermanagement CPU.md
- kb/sources/Source - Arch Linux Cheat Sheet.md
- kb/sources/Source - Conversation - AGENTS.md Skill Restructuring Session 2026-08-04.md
- kb/sources/Source - Conversation - Auto Mode and Tool Choice Session 2026-08-31.md
- kb/sources/Source - Conversation - Comma Bug Budget Refund and Lint Report Path Session 2026-08-31.md
- kb/sources/Source - Conversation - ENVIRONMENT.md as an Optional Third Session-Level File Session 2026-08-31.md
- kb/sources/Source - Conversation - Gate Counting and Measured Calibration Session 2026-08-31.md
- kb/sources/Source - Conversation - Hardening the Test Suite Against Silent Environment Dependencies Session 2026-08-31.md
- kb/sources/Source - Conversation - Issue Triage Labels and TODO Retirement Session 2026-08-31.md
- kb/sources/Source - Conversation - Nightly Drift-Check Workflow and doctor's Bootstrap Gap Session 2026-08-31.md
- kb/sources/Source - Conversation - Two Round-Trip Defects Found by an Ingest Session 2026-08-31.md
- kb/sources/Source - Conversation - Versioning CI-CD and Content Migration Session 2026-08-30.md
- kb/sources/Source - Conversation - Write-Once Frontmatter Fields and touch --set Session 2026-08-31.md
- kb/sources/Source - Copilot Skill Restructure Instructions.md
- kb/sources/Source - Docker Cheatsheet.md
- kb/sources/Source - Gitea Issue 41 - Issue Management and Label Scheme 2026-09-02.md
- kb/sources/Source - Gitea Issues 62-63 - status-incoming Label Introduction 2026-09-04.md
- kb/sources/Source - LLM Improvements Codex Analysis.md
- kb/sources/Source - LLM Improvements Production Agent Gaps 2026.md
- kb/sources/Source - LLM Improvements Sonnet Analysis.md
- kb/sources/Source - LLM Wiki Pattern.md
- kb/sources/Source - LLM Wiki v2.md
- kb/sources/Source - MCP Read Server Implementation Session 2026-09-02.md
- kb/sources/Source - Private-Instance Merge Correction and Issue 30 Session 2026-09-01.md
- kb/sources/Source - Public Release, Corpus Purge and History Squash Session 2026-09-01.md
- kb/sources/Source - Publish-Remote Gate and Issue Triage Session 2026-09-01.md
- kb/sources/Source - Version Part Nomenclature and Breaking Change Gate Session 2026-09-02.md
- kb/sources/Source - Wine.md
- kb/sources/Source - qmd - GitHub Repository.md
- kb/sources/analyses/Source - Copilot Skill Restructure Instructions.md
- kb/sources/analyses/Source - LLM Improvements Codex Analysis.md
- kb/sources/analyses/Source - LLM Improvements Production Agent Gaps 2026.md
- kb/sources/analyses/Source - LLM Improvements Sonnet Analysis.md
- kb/sources/articles/Source - AMD Powermanagement CPU.md
- kb/sources/articles/Source - LLM Wiki Pattern.md
- kb/sources/articles/Source - LLM Wiki v2.md
- kb/sources/documents/Source - qmd - GitHub Repository.md
- kb/sources/notes/Source - Arch Linux Cheat Sheet.md
- kb/sources/notes/Source - Docker Cheatsheet.md
- kb/sources/notes/Source - Wine.md
- kb/sources/trackers/Source - Gitea Issue 41 - Issue Management and Label Scheme 2026-09-02.md
- kb/sources/trackers/Source - Gitea Issues 62-63 - status-incoming Label Introduction 2026-09-04.md
- kb/sources/transcripts/Source - Conversation - AGENTS.md Skill Restructuring Session 2026-08-04.md
- kb/sources/transcripts/Source - Conversation - Auto Mode and Tool Choice Session 2026-08-31.md
- kb/sources/transcripts/Source - Conversation - Comma Bug Budget Refund and Lint Report Path Session 2026-08-31.md
- kb/sources/transcripts/Source - Conversation - ENVIRONMENT.md as an Optional Third Session-Level File Session 2026-08-31.md
- kb/sources/transcripts/Source - Conversation - Gate Counting and Measured Calibration Session 2026-08-31.md
- kb/sources/transcripts/Source - Conversation - Hardening the Test Suite Against Silent Environment Dependencies Session 2026-08-31.md
- kb/sources/transcripts/Source - Conversation - Issue Triage Labels and TODO Retirement Session 2026-08-31.md
- kb/sources/transcripts/Source - Conversation - Nightly Drift-Check Workflow and doctor's Bootstrap Gap Session 2026-08-31.md
- kb/sources/transcripts/Source - Conversation - Two Round-Trip Defects Found by an Ingest Session 2026-08-31.md
- kb/sources/transcripts/Source - Conversation - Versioning CI-CD and Content Migration Session 2026-08-30.md
- kb/sources/transcripts/Source - Conversation - Write-Once Frontmatter Fields and touch --set Session 2026-08-31.md
- kb/sources/transcripts/Source - MCP Read Server Implementation Session 2026-09-02.md
- kb/sources/transcripts/Source - Private-Instance Merge Correction and Issue 30 Session 2026-09-01.md
- kb/sources/transcripts/Source - Public Release, Corpus Purge and History Squash Session 2026-09-01.md
- kb/sources/transcripts/Source - Publish-Remote Gate and Issue Triage Session 2026-09-01.md
- kb/sources/transcripts/Source - Version Part Nomenclature and Breaking Change Gate Session 2026-09-02.md
- tools/CONTRACT.md
- tools/chemenu/lint_core.py
- tools/chemenu/tests/conftest.py
- tools/chemenu/tests/test_lint.py
- tools/chemenu/tests/test_new_page.py
- tools/chemenu/tests/test_provenance.py
- tools/chemenu/tests/test_touch.py
- tools/chemenu/tests/test_type_resolver.py
- tools/chemenu/tests/test_xref.py
- types/source.md
- types/source.schema.yaml
- types/type-spec.md
- work/reclassify-source-types/README.md
- work/reclassify-source-types/plan.md
This commit is contained in:
2026-09-08 20:38:15 +02:00
parent 7f74303a00
commit b138fd8e64
51 changed files with 467 additions and 96 deletions
@@ -0,0 +1,96 @@
---
type: types/source.md
source_type: tracker
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]]
@@ -0,0 +1,87 @@
---
type: types/source.md
source_type: tracker
author: Torben Nehmer
raw_files: [raw/notes/Gitea Issues 62-63 - status-incoming Label Introduction 2026-09-04.md]
source_language: de
date: 2026-09-04
tags: [issues, gitea, labels, triage, process]
entities: [Chemenu, Gitea MCP Server]
concepts: [Issue Label Scheme]
summary: 'Threadkopie zu Gitea-Issues #62/#63: das dritte status/-Flag status/incoming (Stubs werden nie so umgesetzt wie sie dastehen, es setzt die vier Pflichtachsen aus statt sie zu qualifizieren), plus die dadurch veraltete kb-Seite (17 statt 16 Labels)'
---
# Source: Gitea Issues 62-63 - status-incoming Label Introduction 2026-09-04
**Autor:** Torben Nehmer
**Datum:** 2026-09-04
**Raw-Dateien:** raw/notes/Gitea Issues 62-63 - status-incoming Label Introduction 2026-09-04.md
**Typ:** Notes
## Zusammenfassung
Wörtliche Kopie zweier zusammenhängender Gitea-Issue-Threads, gezogen am 2026-09-04: #62 im
Endstand nach Body-Rewrite und Close, #63 im Erstzustand (offen, unkommentiert), dazu das zu
diesem Zeitpunkt in Gitea angelegte Label-Set. Beide Issues gehören zusammen: #62 führt das
dritte `status/`-Flag ein, #63 ist der Folgebefund, den #62 im eigenen Body selbst benennt.
`status/incoming` markiert einen vom Menschen angelegten Stub - eine kurze Anforderung oder
einen Verdacht, ohne Akzeptanzkriterium und ohne die vier Pflichtachsen. Die Regel, die #62 in
`instructions/dev/issue-tracking.md` verankert: ein solcher Stub wird nie so umgesetzt, wie er
dasteht, sondern erst in einer eigenen Sitzung ausgearbeitet und trianiert. Das Flag setzt dabei
die Vier-Pflichtachsen-Regel aus `Issue Label Scheme` nicht außer Kraft, sondern verschiebt ihre
Fälligkeit: die Achsen fehlen einem Stub nicht, sie sind noch nicht dran.
Die Quelle ist zugleich der Beleg für die Umsetzung: #62 verzeichnet Commit `4ab358f` und Stack-
Version `4.7.5-beta.1`, mit allen sieben Akzeptanzkriterien abgehakt. #63 hält im Gegenzug fest,
dass `kb/concepts/Issue Label Scheme.md` dadurch veraltet ist - der Stand von 2026-09-02 kennt
das neue Flag nicht und zählt sechzehn statt siebzehn Labels.
## Kernaussagen
- **`status/incoming` ist das einzige Flag, das die Vier-Achsen-Pflicht aussetzt statt sie zu
qualifizieren.** `status/blocked` und `status/unconfirmed` gelten zusätzlich zu den vier
Pflichtlabeln; `status/incoming` gilt *anstelle* von ihnen, solange der Stub nicht ausgearbeitet
ist. Ein Stub auf Sicht durchzulabeln ist der Fehler, nicht das Weglassen - es lässt
Ungeprüftes triagiert aussehen.
- **Ein Stub ist die Absichtserklärung des Menschen, nicht die Spezifikation.** Sein Wortlaut ist
der einzige Beleg dessen, was gewünscht war. Die Ausarbeitung liest ihn, statt ihn
umzudeuten, prüft ihn gegen den Baum, rettet den Originaltext wörtlich in einen Kommentar
bevor der Body-Rewrite ihn überschreibt, und benennt offene Fragen statt sie zu beantworten
(`kind/decision`).
- **`status/incoming` ist das einzige Flag, das eine Sitzung nie selbst vergibt.** Ein Issue, das
eine Sitzung anlegt, erfüllt Schritt 1 (Body als überlebensfähige Spec) oder wird gar nicht
angelegt.
- **Zwei Ausgänge, wie bei `status/unconfirmed`.** Ein Stub wird ausgearbeitet - Flag entfernt,
alle vier Pflichtlabel gesetzt für real - oder mit Begründung geschlossen. Er bleibt nicht
unbegrenzt im Eingang liegen.
- **Der Anlass war akut, nicht hypothetisch.** Zwei Issues (#60, #61) trugen `status/incoming`
bereits, bevor die Regel geschrieben war - beide zwei bis drei Sätze Prosa, ohne
Akzeptanzkriterium, teils Vermutung statt Feststellung.
- **PATCH, nicht MINOR.** `4.7.5-beta.1`, weil `dist export` `instructions/dev/` vollständig
ausschließt - dieselbe Begründung wie bei `4.0.1`, das die vier Pflichtachsen eingeführt hatte.
- **Siebzehn Labels stehen in Gitea**, gelesen am 2026-09-04: gegenüber dem Stand vom
2026-09-02 (sechzehn) ist genau `status/incoming` neu dazugekommen.
## Aufgaben
- [ ] `kb/concepts/Issue Label Scheme.md` um das dritte `status/`-Flag und die korrekte
Labelzahl ergänzen (Gitea #63 - wird im selben Zug wie diese Source erledigt)
- [ ] #60 und #61 ausarbeiten und triagieren - die erste tatsächliche Anwendung der neuen Regel,
eigene `stack-dev`-Sitzung
## Nicht übernommen
- **Der volle Prosa-Abschnitt "§ Incoming stubs" aus `instructions/dev/issue-tracking.md`
selbst.** #62 beschreibt, was dort hineingeschrieben wurde; die Instruction ist Teil des
Stacks und kein Rohmaterial - dieselbe Abgrenzung, die schon die Vorgängerquelle zu #41 zieht.
- **Die Sachinhalte von #60 und #61.** Sie kommen in #62 nur als Nummern vor. Was in ihnen
steht, ist eigenes Rohmaterial für die Sitzung, die sie ausarbeitet, nicht Teil dieser Quelle.
## Verwandte Entities
- [[Chemenu]]
- [[Gitea MCP Server]]
## Verwandte Concepts
- [[Issue Label Scheme]]