torben
b138fd8e64
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
133 lines
8.0 KiB
Markdown
133 lines
8.0 KiB
Markdown
---
|
|
type: types/source.md
|
|
source_type: transcript
|
|
author: Claude Code (claude-opus-5)
|
|
raw_files: ['raw/notes/Conversation Transcript - Issue Triage, Labels and TODO Retirement Session 2026-08-31.md']
|
|
source_language: en
|
|
date: 2026-08-31
|
|
tags: [gitea, issues, labels, triage, ci-cd, paths-ignore, stack-dev]
|
|
entities: [Chemenu, Gitea, Gitea Actions, Gitea MCP Server, wikitool]
|
|
concepts: [Issue Label Scheme, KB Stack Versioning, Detect-Repair Asymmetry]
|
|
summary: 'Sitzung, die das gesamte offene Issue-Board priorisiert, den Beleg fuer greifende paths-ignore-Filter erbringt (Issue #11 geschlossen) und TODO.md zugunsten von Gitea-Issues mit prio/- und size/-Labels abschafft (Stack 1.2.1)'
|
|
---
|
|
# Source: Conversation - Issue Triage Labels and TODO Retirement Session 2026-08-31
|
|
|
|
**Autor:** Claude Code (claude-opus-5)
|
|
**Datum:** 2026-08-31
|
|
**Raw-Dateien:** raw/notes/Conversation Transcript - Issue Triage, Labels and TODO Retirement Session 2026-08-31.md
|
|
**Typ:** Notes
|
|
|
|
## Zusammenfassung
|
|
|
|
Das Transkript ist eine vom Assistenten am Sitzungsende rekonstruierte Zusammenfassung, kein
|
|
wörtliches Protokoll; die zitierten Befehlsausgaben und Issue-Titel sind echt. Es ist eines von
|
|
drei Transkripten derselben Sitzung. Die beiden anderen behandeln die Werkzeugkorrekturen zu
|
|
den Issues #12 und #13 (eingelesen als
|
|
[[Source - Conversation - Comma Bug Budget Refund and Lint Report Path Session 2026-08-31]])
|
|
und den `auto`-Berechtigungsmodus des Harness.
|
|
|
|
Die Sitzung hat drei Ergebnisse. Erstens wurde das gesamte offene Issue-Board priorisiert, mit
|
|
einem ausdrücklich benannten Kriterium: was laufende Arbeit blockiert oder beschädigt, nicht
|
|
was viel Aufwand kostet. Zweitens fiel beim Prüfen eines Publish der Beleg an, dass Gitea
|
|
`paths-ignore` wie GitHub auswertet; damit war Issue #11 ohne eine Zeile Code geschlossen.
|
|
Drittens wurde `TODO.md` gelöscht und durch Gitea-Issues mit einem zweiachsigen Label-Schema
|
|
ersetzt, das als [[Issue Label Scheme]] festgehalten ist.
|
|
|
|
Ausgeliefert wurde Stack-Version `1.2.1` (Commit `9fa70f3`, 5 Dateien): eine PATCH-Version,
|
|
weil die neue Regel unter `instructions/dev/` liegt und damit keine ausgelieferte Instanz
|
|
erreicht.
|
|
|
|
## Kernaussagen
|
|
|
|
- **Das Priorisierungskriterium war Schaden, nicht Aufwand.** Die Issues #12 und #13 kamen
|
|
gemeinsam an die Spitze, weil beide eine Regel gebogen hatten statt nur zu stören: der
|
|
Komma-Bug führte zur Umbenennung einer Rohdatei gegen die Immutability-Regel aus
|
|
`raw/CONTRACT.md`, und die Budget-Buchführung drängte die Sitzung in `--override-budget`
|
|
gegen Invariante 6. Ein Werkzeug, das seinen Benutzer regelmäßig gegen die eigenen
|
|
Invarianten des Stacks drückt, ist hier die teuerste Fehlerklasse.
|
|
- **Reihenfolge-Urteile mit Begründung.** #8 (Testhärtung) vor #10 (Coverage), weil eine
|
|
Coverage-Messung auf einer umgebungsabhängigen Suite die Umgebung mitmisst. #7 (`dist
|
|
upgrade`) galt als das bestgeschriebene Issue des Boards und trotzdem nicht als vorrangig,
|
|
weil es sich erst auszahlt, sobald eine zweite Instanz existiert. #6 (Backlink-Ranking) kam
|
|
ans Ende, weil es als einziges die Kern-Suchlogik ändert und keine Suchanfrage aktenkundig
|
|
ist, die heute falsch rankt; ohne diesen Vorher-Fall ist das eigene Abnahmekriterium des
|
|
Issues nicht erfüllbar. #3 (Produktname) wurde als "keine Priorität, sondern eine Uhr"
|
|
eingeordnet: technisch blockiert es nichts, wird aber mit jedem Commit teurer, der eine
|
|
weitere `llm-wiki-test1`-Referenz hinzufügt.
|
|
- **`paths-ignore` greift, und das ist jetzt beobachtet.** Commit `f916376` war ein reiner
|
|
Content-Publish (`kb/index.md`, `kb/log.md`, `kb/provenance.md`, acht Seiten unter `kb/*/**`,
|
|
eine Datei unter `raw/notes/`) und erzeugte keinen einzigen Lauf, während die Stack-Commits
|
|
davor und danach je zwei erzeugten. Der Befund wurde in den Kommentarkopf von
|
|
`.gitea/workflows/ci.yml` geschrieben, damit er nicht erneut als Annahme behandelt wird.
|
|
- **Der Befund entlastete ein zweites Issue.** Weil der Filter greift, läuft
|
|
`lint --fail-on-error` bei einem Content-Publish tatsächlich nicht mehr; die stärkste Hälfte
|
|
der Begründung für den nächtlichen Drift-Check aus Issue #9 bleibt damit stehen. Dessen
|
|
eigene Voraussetzung, ob dieser Gitea-Build `on: schedule` überhaupt auswertet, ist unberührt
|
|
und weiter offen.
|
|
- **Zwei Achsen, beide Pflicht, bewusst keine dritte.** `prio/1..3` und `size/XS..L`. Eine
|
|
Priorität ohne Kosten ist eine halbe Entscheidung, deshalb sind beide verpflichtend. Eine
|
|
dritte Achse (Art, Bereich, Status) wurde verworfen als der Punkt, ab dem eine Taxonomie
|
|
eigene Pflege braucht, auf einem Board mit einem einzigen Betreuer. Details auf
|
|
[[Issue Label Scheme]].
|
|
- **Der Ort der Regel war die tragende Entscheidung.** `README.md` und `AGENTS.md` gehen in
|
|
jede ausgelieferte Instanz, und eine ausgelieferte Instanz hat kein Issue-Board auf
|
|
`gitea.nehmer.net`. `instructions/dev/` ist der einzige Ort, der zugleich agentenlesbar ist
|
|
und nie ausgeliefert wird, weil `dist export` ihn vollständig ausschließt. Aus demselben
|
|
Grund war der Release ein PATCH.
|
|
- **Das CI-Versions-Gate greift auch für nicht ausgelieferte Pfade.** Sein Muster passt auf
|
|
`instructions/`, also verlangt eine Änderung unter `instructions/dev/` einen Versionsbump,
|
|
obwohl sie keine Instanz erreicht. Das wurde vor dem Bump in `ci.yml` nachgesehen statt
|
|
angenommen.
|
|
- **Die Notiz zur Recherchefähigkeit wurde vollständig nach Issue #15 übernommen**, samt
|
|
Quellen, Befund, der A/B/C-Tabelle mit der Entscheidung für C, dem Schnitt, der den Netzaufruf
|
|
aus `wikitool` heraushält, den Perplexity-Details einschließlich des
|
|
`/v1/sonar`-Abkündigungsdatums 2026-09-27 sowie sechs offenen Contract-Änderungen und drei
|
|
offenen Entscheidungen. Abnahmekriterien wurden ergänzt, weil die Notiz keine hatte. Die
|
|
inhaltliche Rahmung: Recherche ist der fehlende Ausgang aus Invariante 3. Heute ist "das Wiki
|
|
hat dazu keine belastbare Quelle" eine Sackgasse; Recherche wäre die Antwort "dann hol eine".
|
|
Die offene Entwurfsfrage ist nicht Skill oder nicht, sondern wohin ein Perplexity-Bericht
|
|
gehört, wenn `raw/` alles vom LLM Geschriebene ausschließt und `kb/` verlangt, dass jede
|
|
Aussage auf eine Datei unter `raw/` zurückführt.
|
|
- **Notiz auf #8:** Zwei Tests, die *während* des #12-Fix von jemandem geschrieben wurden, der
|
|
#8 vorher gelesen hatte, führten dieselbe stille Umgebungsabhängigkeit erneut ein. Die
|
|
interessante Frage verschiebt sich damit von "wie viele unbekannte Fälle gibt es" zu "die
|
|
Suite bekommt neue schneller, als jemand die alten findet".
|
|
|
|
## Aufgaben
|
|
|
|
- [ ] Issue #8 (Testsuite gegen Umgebungsabhängigkeiten härten, `prio/1 size/M`) ist das
|
|
nächste Arbeitspaket auf dem Board.
|
|
- [ ] Issue #9 bleibt offen an der Frage, ob dieser Gitea-Build `on: schedule` auswertet.
|
|
- [ ] Issue #3 (Produktname) läuft mit: jede weitere `llm-wiki-test1`-Referenz erhöht die
|
|
spätere Umbenennungslast.
|
|
|
|
## Nicht übernommen
|
|
|
|
- **Die vollständige Board-Tabelle mit allen zehn Issue-Nummern, Titeln und Labels.** Sie ist
|
|
ein Momentzustand des Boards und veraltet mit dem nächsten Triage-Lauf. Das Board selbst ist
|
|
die Quelle der Wahrheit; die Seite [[Issue Label Scheme]] hält stattdessen die Bedeutung der
|
|
Achsen fest, die stabil bleibt.
|
|
- **Der Inhalt der Issues #14 und #15 im Detail.** #14 ist auf
|
|
[[Detect-Repair Asymmetry]] bereits als der Fall beschrieben, den das Concept meint. #15 ist
|
|
eine offene Entwurfsfrage mit drei unentschiedenen Punkten; eine Concept-Seite dazu würde
|
|
einen Entwurf als Entscheidung darstellen, den niemand getroffen hat.
|
|
- **Die Reihenfolge-Begründungen zu den Issues #4, #5 und #10 im Einzelnen.** Sie tragen keine
|
|
über den Einzelfall hinausgehende Regel; das Kriterium, nach dem sie gefällt wurden, steht
|
|
oben.
|
|
- **Die Historie von `TODO.md`.** Ausdrücklich abbedungen: "An ihrer Historie bin ich nicht
|
|
interessiert."
|
|
|
|
## Verwandte Entities
|
|
|
|
- [[Chemenu]]
|
|
- [[Gitea]]
|
|
- [[Gitea Actions]]
|
|
- [[Gitea MCP Server]]
|
|
- [[wikitool]]
|
|
|
|
## Verwandte Concepts
|
|
|
|
- [[Issue Label Scheme]]
|
|
- [[KB Stack Versioning]]
|
|
- [[Detect-Repair Asymmetry]]
|