Repository navigation
feat(portfolio): Belegstufen Ist/Soll/Meldung im Fakten-Index (D10a, v0.55.0) - #321
Merged
Merged
Conversation
…v0.55.0)
Jeder Fakt traegt eine Belegstufe (Fact.basis): actual (vom Werkzeug
gemessen), target (Ziel, Termin, Schwelle, Beschluss) oder reported (von
einer Stelle eingetragen). Die Contract-Zeile zeigt die Stufe, der Index
erklaert sie in einem Satz.
Neuer Belegstufen-Waechter (llm/guard.py::basis_violations): Zitiert ein
Satz keinen Ist-Fakt, sondern nur ein Soll oder eine Meldung, die einen
Zustand behauptet, und sagt das nicht, wird die Antwort verworfen
(BasisGuardError, eine CitationGuardError). Wortliste DE/EN, kein zweites
Modell. Unter jeder Antwort steht der vom Werkzeug gezaehlte Belegspiegel
("1 Ist . 1 Soll . 5 Meldung") - im Dialog, in der .ask.md und im
Rueckweg llm check. Prompt-Version v3.
Abweichung vom Konzept: Kennwortpflicht fuer Soll und zustandsbehauptende
Meldungen, nicht fuer jedes Registerfeld - die gepruefte Musterantwort des
Tutorials waere sonst gescheitert.
Tests: tests/llm/unit/test_basis_guard.py, Ergaenzungen in test_facts.py
und test_ask.py; Gesamtlauf 2057 bestanden, ruff und mypy sauber.
Doku: mkdocs portfolio/llm DE+EN, Manual 5.19 (fuenf Sprachen), Tutorial
DE+EN mit PDF, Onepager evidence_basis DE+EN, Roadmap D10, CHANGELOG.
Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Was sich ändert
Roadmap D10, Schnitt a: Jeder Fakt des Fakten-Index trägt eine Belegstufe — Ist (
actual, vom Werkzeug gemessen), Soll (target: Ziel, Termin, Schwelle, Beschluss) oder Meldung (reported: von einer Stelle eingetragen). Ein neuer Belegstufen-Wächter verwirft Antworten des befragbaren Lagebilds, die ein Soll oder einen gemeldeten Zustand als Zustand ausgeben. Unter jeder Antwort steht der vom Werkzeug gezählte Belegspiegel, zum Beispiel „Belege (vom Werkzeug gezählt): 1 Ist · 1 Soll · 5 Meldung".Anlass ist ein Gesprächsverlauf mit einem KI-Assistenten vom 17.11.2026, der Zielwerte als Zustand behandelte und sein Urteil danach nach dem Widerspruch des Fragenden richtete. Konzept und Entscheidungen E1–E7 (Robert, 18.11.2026, „wie empfohlen") liegen lokal unter
Ideen/.Bausteine
portfolio/facts.py:Fact.basis, Zuordnung je Baustein,TARGET_FIELDS(due,needed_by,review_by,target_pct,threshold,horizon,follow_up_pi), Legende im Index; Wert und Status eines Entscheidungspunkts erben die Stufe der beobachteten Kennzahl. Faktenzeile:- [S1/total.median_ct] {actual} ….llm/guard.py:basis_violations(Wortliste Deutsch und Englisch, kein zweites Modell),BasisGuardError(eineCitationGuardError, daher greifen GUI, CLI und Noise-Audit unverändert),basis_counts,basis_mirror(fünf Sprachen).llm/prompts.py: Prompt-Version v3, Regel „Belegstufen" im Fragen-Prompt DE/EN.portfolio/ask.py,portfolio/gui.py,llm/check.py: Wächter nach dem Zitat-Wächter, Belegspiegel im Dialog, in der.ask.mdund im geprüften Entwurf des Rückwegs; neue Ablehnungsmeldung in fünf Sprachen. Bündel, die vor 0.55.0 exportiert wurden, tragen keine Stufen und werden wie bisher geprüft.Abweichung vom Konzept — bitte bestätigen
Das Konzept verlangte ein Kennwort für jeden Satz, der nur Soll- oder Meldungs-Fakten zitiert. Beim Bau zeigte sich: Die geprüfte Musterantwort des Tutorials wäre daran in zwei von vier Sätzen gescheitert („Betroffen sind ART Alpha-1 als Geber und ART Alpha-3 als Nehmer"). Gebaut ist deshalb: Kennwortpflicht für jedes Soll und für Meldungen, die einen Zustand behaupten (Status, ROAM, Health, Bewertung, Zählung nach Status). Beschreibende Registerfelder zählen im Belegspiegel als Meldung, brauchen aber kein Kennwort. Wenn die strenge Fassung gewünscht ist, ist das eine Zeile in
llm/guard.py.UX read (vor dem ersten Edit an Dialog und Datei)
.ask.mdund Rückweg; alle drei Stufen stehen immer da.UX check
portfolio/gui.py:2017-2020,portfolio/ask.py:189-191llm/guard.py:377-385,portfolio/gui.py:2020llm/guard.py:440basis_mirrorfür Dialog, Datei und Rückweg; Dialog nutzt die Antwortsprache wie die Dateiportfolio/ask.py:89-91,llm/check.py(checked_text)portfolio/gui.py:262,:2021-2023Based on Laws of UX by Jon Yablonski, lawsofux.com. Published by Pip Decks.
Texte zur Freigabe
CHANGELOG.md: Eintrag 0.55.0 (Added, Changed)docs/modules/portfolio.de.mdundportfolio.md: Abschnitt „Belegstufen: Ist, Soll, Meldung"docs/modules/llm.de.mdundllm.md: ein Satz zum Rückwegdocs/generate_portfolio_manual.py: Absatz in 5.19, fünf Sprachen (PDFs neu erzeugt)docs/tutorials/ask-the-picture.de.mdund.md: sechster Begriff, Spiegel im Beispiel, vierte Verstoßart; Zahlen auf den heutigen Demo-Stand gebracht (598 Fakten, Prompt v3)docs/generate_feature_onepagers.py: Onepager „Belegstufen" DE/EN (evidence_basis)docs/portfolio_roadmap_solution-lagebild.md: D10 mit Ist-Stand, Abweichung, offenen SchnittenPrüfung
ollama_live)Danach
Schnitt b (Wertungswort- und Gefälligkeits-Wächter) und Schnitt c (Gegenprobe in drei Rahmungen).
beta/ux-redesignholtmainnach dem Merge nach. Merge, Tag und Release nur auf Roberts Wort.🤖 Generated with Claude Code