Evidenzgestützte Dokumentation
Eine Behauptung ist nur dann eine Dokumentation, wenn sie die Mittel zu ihrer Überprüfung enthält. Dieses Skill ist der Standard und die Karte: zehn Kanons, und wo jeder definiert, durchgesetzt und verankert ist.
Es ist ein Navigator, keine Zweitkopie. Jedes Gesetz unten hat genau ein Zuhause – das ist Kanon 3, und ein Navigator, der die Doktrin wiederholte, würde die Regel brechen, die er indexiert. Die vollständige Aussage jedes Kanons, seine Begründung und seine Durchsetzung befinden sich in documentation.md → Die Kanons.
Die zehn Kanons
- Eine Behauptung trägt ihre Adresse –
datei:zeile, ein Befehl mit seiner Ausgabe, ein Testname; eine Lektion nennt ihren Commit. - Zahlen werden berechnet, nie wiederholt.
- Jede Tatsache hat genau ein Zuhause – andere verlinken, wiederholen nie.
- Eine Referenz löst vom Ort des Lesens auf – nicht von dem, wo sie lebt.
- Grün, das niemand rot werden sah, ist kein Beweis.
- Ein Check beweist seinen Umfang und nichts darüber hinaus.
- Schweigen ist kein Bestehen – frage, was ein Mechanismus ausgibt, wenn er nicht hinsah.
- Eine Schätzung wird nie als Messung ausgegeben – eine Regel nennt ihre Beweisbedingung.
- Was nicht geprüft wurde, wird neben dem ausgegeben, was geprüft wurde.
- Das Dokument reist in der Änderung, die es wahr gemacht hat – und eine Korrektur wird angehängt, nie überschrieben.
Sie sind epistemisch: was eine Behauptung zur Dokumentation macht. Die operative Ebene – was bei einem bestimmten Auslöser zu tun ist, mit einem Check und einem Abbruchkriterium – ist learned.md. Wenn die beiden dasselbe zu sagen scheinen, ist der Kanon das Warum und die Regel das Wie.
Wohin als nächstes
| Sie sind dabei… | Lesen Sie | Weil… |
|---|---|---|
| die Dokumentation eines Projekts von Grund auf einzurichten | documentation.md → Das Inventar | vier Fragen, beantwortet vor der ersten Arbeitszeile |
| eine Entscheidung so festzuhalten, dass sie ihren Autor überlebt | Register und IDs + templates/decisions.md | append-only IDs, Randmarker, ein Zuhause für Entscheidungen |
| etwas zu ändern und die Doku nicht zu verwaissen | Der Dokumentationskreislauf + Die Ausbreitungsmatrix | welche Dokumente eine Änderung schuldet, beginnend mit der Metazeile |
| zu entscheiden, wo eine Tatsache hingehört | Einzige Quelle der Wahrheit | zwei Zuhause widersprechen sich am Tag, an dem eines aktualisiert wird |
| einen Check zu bauen, der nicht lügen kann | gates.md | drei Achsen, die Durchsetzungsleiter, progressive Scharfschaltung, Sondierung |
| einem Mechanismus zu vertrauen, der Erfolg meldet | gates.md → Falscher Erfolg | der Fehler, der den Grund zum Nachsehen beseitigt |
| einen Check in die eigene Toolumgebung des Agenten einzubinden | hooks.md | der Hook-Vertrag und warum ein abgestürzter Wächter die Aktion erlaubt |
| die Dokumentation eines bestehenden Projekts zu prüfen | setup.md | sieben Durchläufe, günstigste zuerst, Ausgabe ist ein Reparaturplan |
| eine Lektion in den nächsten Lauf zu übernehmen | retrospective.md | zuerst stempeln (der kalte Auslöser liest ihn), dann auf maximal zehn beschneiden; jede Lektion nennt ihren Commit |
| ein Gate in ein Host-Projekt einzupflanzen | templates/docgate.sh | es pflanzt grün ein: ruhend, wo es noch keine Eingabe gibt |
| zu behaupten, dass sich ein Agent korrekt verhält | tdd.md → Wenn die zu testende Sache ein Agent ist – benannt statt verlinkt, weil die Out-of-Verzeichnis-Links dieses Navigators brechen, sobald ein Packager dieses Skill allein ausliefert | die Adresse ist eine Trace-ID und die Behauptung, die lief (Kanon 1); ein Beobachter, der niemand widerspricht, ist Grün, das niemand rot werden sah (Kanon 5) |
| eine gesamte Änderung bis zur Abnahme zu bringen | task-pipeline | dieses Skill ist der Standard; jenes ist, wie eine Änderung das Repository erreicht |
Wann dies gilt
Die Grenze ist: "es wird als wahr gelesen werden." Ein Entscheidungsprotokoll, eine README, ein Abnahmebericht, ein Runbook, ein Changelog für Benutzer, ein Prüfbefund, eine Behauptung, dass etwas verifiziert wurde.
Nicht durch dieses Skill: ein Entwurf, lautes Denken, eine Antwort im Chat, eine Commit-Nachricht, ein Code-Kommentar. Das Fordern einer datei:zeile für "lass mich das überprüfen" ist der schnellste Weg, einem Agenten beizubringen, um die Regel herumzunavigieren, wo sie tatsächlich etwas schützt.
Verweigerungsphrase – "без доков" / "auf mein Wort". Sie funktioniert bei einer Aufgabe, die sonst hier durchliefe: mache es direkt und sage laut, dass die Behauptung ungedeckt ist, anstatt eine Schätzung als Messung zu präsentieren (Kanon 8).
Der eine Test
Bevor ein Dokument ausgeliefert wird, lies es auf den Satz, der dich in Verlegenheit brächte, wenn jemand fragte "woher weißt du das?" – und gib diesem Satz entweder seine Adresse oder lösche ihn. Alles oben ist diese Frage, mechanisch gemacht.