E0min/docanchor

Dokumenten-Lint

Wird einmal direkt vor einem Deployment-Batch ausgeführt. Betrachtet nur Dinge, die eine Strukturprüfung (pnpm docs:validate) nicht abdeckt.

Mit dem stärksten Modell ausführen. Die Fähigkeit, Regeln zu erkennen, und die Fähigkeit, Regeln zu befolgen, sind unterschiedliche Fähigkeiten.

Lesebereich

Es wird nicht vollständig gelesen. Ein breites Lesen erhöht die Anzahl störender Dokumente und verringert die Genauigkeit.

1. Mit pnpm docs:related <Pfad…> die Code-Pfade des aktuellen Deployments eingeben und die gerouteten Dokumente erhalten.
2. Die von diesen Dokumenten verlinkten ADRs sowie die aktiven Pläne des jeweiligen Bereichs.
3. Dauerhafte Dokumente, bei denen pnpm docs:validate eine Überschreitung des Prüfdatums von 90 Tagen warnt.
4. Offene Einträge in docs/findings.md.

Betrachtet wird

• Inkonsistenzen zwischen Dokument und Code in beide Richtungen. Getrennt betrachet: was im Code, aber nicht im Dokument steht (fehlend) und was im Dokument, aber nicht im Code steht (halluziniert). Wird nur eine Seite betrachtet, geht die Hälfte verloren.
• Kandidaten für widersprüchliche ADRs. Wenn zwei Accepted ADRs im selben Bereich gegensätzliche Schlussfolgerungen haben, aber keine Ersatzbeziehung besteht. Mit pnpm docs:links <ADR> die Ersatzkette prüfen.
• Mit Code duplizierte Wertetabellen. Ob das Dokument Werte oder Listen, die aus dem Code gelesen werden könnten, abgeschrieben hat.
• Seit über 90 Tagen ausstehende Pläne. Wird als Eintrag zur Frage hochgezogen, ob der Plan eingestellt oder wieder aufgenommen werden soll.
• Seit über 14 Tagen vorgeschlagene ADRs. Die Entscheidung wurde aufgeschoben.
• Im Leitfaden vermischte Erfahrungsberichte. „Habe es versucht, hat nicht funktioniert“-Aussagen sollten in docs/flows/.
• Abgelaufene Zeilen in docs/operations/current-state.md. Zeilen mit einem alten Prüfdatum gelten als nicht bestätigt, nicht als erfolgreich.

Ausgabe

Es werden Einträge zu docs/findings.md hinzugefügt. Ein Eintrag besteht aus fünf Zeilen.

- Fund 2026-09-04 · docs/policies/xxx.md
  Behauptung: (Was das Dokument aussagt)
  Begründung: (Code-Pfad oder ADR-Nummer)
  Vorschlag: (Was zu tun ist)
  Umfang: (Wird im aktuellen Deployment behoben oder aufgeschoben)

Es wird nicht korrigiert. Die Behebung erfolgt durch einen PR, der die Aufgabe erledigt, und dieser PR löscht den Eintrag.

Das Prüfdatum eines gelesenen dauerhaften Dokuments wird auf heute aktualisiert. Nur die Dokumente, die tatsächlich mit dem Code abgeglichen wurden, werden aktualisiert. Wird einem nicht abgeglichenen Dokument das heutige Datum gegeben, entsteht ein falsches Signal der Aktualität.

Budget

Von vornherein wird davon ausgegangen, dass einer von drei gefundenen Einträgen ein Fehlalarm ist. Die Präzision der LLM-basierten Inkonsistenzerkennung liegt bei etwa 0,6. Bei Unsicherheit wird dies im Eintrag entsprechend vermerkt.

In der ersten Zeile des Berichts stehen „Anzahl der offenen Findings und Alter des ältesten Eintrags“.

Regeln hinzufügen und entfernen

Soll dieser Liste ein Eintrag hinzugefügt werden, muss ein tatsächlicher Fall vorliegen, den der Eintrag aufgreift. Einträge ohne Belege werden nicht aufgenommen. Tritt derselbe Fehler 12 Monate lang nicht auf und erweist sich in pnpm docs:harness-eval als nicht hilfreich, wird der Eintrag entfernt.