Ein Entwurf ist auffindbar

01Was die Registry heute trägt

Jede Zeile ist ein Kapitel, wie DOC_CHAPTERS es kennt. Die rechte Spalte misst sie an dem, was ihre Art verlangt: ein Kapitel sagt, welche Art es ist, und ein Entwurf sagt, welches Issue er beantwortet.

Alle 40 Kapitel tragen, was ihre Art verlangt.

02Eine Art, kein Namenspräfix

Das Einzige, was design/account-block heute als Entwurf ausweist, ist das Wort „Entwurf“ vorn im Titel und ein Satz im Teaser. Das ist Prosa, und Prosa ist kein Feld: danach lässt sich nicht gruppieren, und keine Prüfung kann sie lesen.

• Ein Dokument erklärt, was läuft — der Leser will es verstehen.
• Ein Entwurf fragt, ob etwas gebaut werden soll — der Leser soll entscheiden.
• Zwei Fragen, zwei Gruppen. In einer Liste vermischt verliert der Leser beide.

03Die Rückrichtung

Ein Plan nennt seinen Entwurf im Front Matter, und just chain liest das. Umgekehrt führt nichts: Wer auf dem Kapitel steht, kommt nicht zu der Entscheidung, zu der es gehört. Das Feld issue am Kapitel schließt den Kreis — bei account-block steht der Wert heute schon da, als Satz im Teaser statt als Feld.

Geprüft wird nicht die Schreibweise, sondern die Übereinstimmung in beide Richtungen: zu jedem Kapitel der Art draft gibt es einen Plan, dessen draft: auf dieses Kapitel zeigt und dessen issue: dieselbe Id trägt. Beide Seiten sind Dateien in diesem Baum, die Prüfung bleibt also offline grün, im frischen Clone und in einem CI-Schritt ohne Seed.

Ob das genannte Issue wirklich existiert, wird hier absichtlich nicht gefragt. Das ist die Frage des Merge-Gates, und lokal bräuchte sie einen Seed. Das ist die eine Stelle, an der die Prüfung schwächer ist, als sie aussieht — deshalb steht sie hier.

04Was diese Seite nicht sehen kann

Die Tabelle oben misst die Registry an sich selbst. Sie kann nicht sehen, was gar nicht in ihr steht — ein Kapitel, das unter app/docs/design/ liegt und in keiner Liste vorkommt. Dafür müsste die Seite den Quellbaum lesen, und der ist im laufenden Container nicht mehr da: Die Prüfung liefe in just dev und fände in der Produktion still nichts.

Eine Seite, die vollständig aussieht und heimlich nichts prüft, ist schlechter als eine, die sagt, wo die andere Hälfte geprüft wird. Sie wird geprüft in lib/docs.test.ts, dort wo die Dateien liegen: ein Verzeichnis mit page.tsx, das kein Kapitel registriert, lässt die Suite fallen.