Ein Plan liest sich als Dokument

01Zwei Formen derselben Datei

parsePlanSpec flacht jeden Absatz zu einer Zeile ab, und das ist richtig so: Was es zurückgibt, ist das, worüber der Freigabe-Digest gebildet wird, und eine Signatur darf nicht brechen, weil jemand einen Satz neu umbrochen hat. Genau das macht diese Form zum Falschen zum Anzeigen — die sieben Absätze der ## Approach werden abgeflacht zu einer Wand.

Deshalb steht planSections daneben, auf demselben Splitter gebaut. Eine Regel dafür, wo ein Abschnitt beginnt, zwei Formen daraus: eine flache zum Signieren, eine rohe zum Lesen. Die Seite nimmt ihr Skelett aus der ersten und ihre Prosa aus der zweiten.

Bei allen 46 Plänen zeigt die Seite, was die Signatur zählt.

Die Spalten signiert und gezeigt zählen dieselben Meilensteine auf zwei Wegen. Laufen sie auseinander, sieht der Leser etwas anderes als das, was unterschrieben wird — und das ist der eine Fehler, den diese Konstruktion überhaupt erst möglich macht.

02Die Fragen zuerst

Alles in einem Plan sagt, was der Runner tun wird. Die offenen Fragen sind das Einzige, was den Leser anspricht — und an ihrer Stelle in der Datei stehen sie hinter dem Ansatz und den Meilensteinen, also hinter der Entscheidung, um die es geht.

• Offene Fragen stehen oben, vor dem Ansatz. Ein Plan ohne solche hat dort schlicht nichts stehen.
• ## What the work settled steht unten und wird erst nach der Arbeit geschrieben — seine Anwesenheit ist der Unterschied zwischen offen und erledigt.
• Was die Seite nicht zeigt: ob der Plan freigegeben ist. Das Etikett hängt am Issue, die Signatur dahinter prüft das Merge-Gate.

03Ein Widerspruch, den diese Arbeit gefunden hat

AGENTS.md sagte, ein Plan darf einen Entwurf nennen und muss keinen haben. lib/chain.ts verweigert seit dem Chain-Gate jeden Plan ohne einen — die Zeile daneben sagt es sogar: „Optional in plan-spec.ts, required here“. Dieses Kapitel existiert, weil just chain den Plan dazu zurückgewiesen hat.

36 von 46 Plänen nennen einen Entwurf.

Die Pläne, die keinen Entwurf nennen, sind älter als das Gate. Der Satz in AGENTS.md ist beim Aufschreiben der Entwurfs-Regel entstanden und beschreibt nicht, was durchgesetzt wird. Er wird an die Durchsetzung angeglichen, nicht umgekehrt: Ob ein Gate diese Forderung behalten soll, ist eine eigene Entscheidung und gehört in ein eigenes Issue — eine Regel, die manchmal gilt, ist genau die Verwirrung, gegen die dieses ganze Kapitelwerk gebaut ist.

04Was diese Seite nicht sehen kann

Die Tabelle misst jeden Plan an sich selbst. Sie kann nicht sagen, ob das Issue, das er nennt, existiert: dafür braucht es einen Seed. Diese Frage stellt /code/-/plans, das einen hat, und es zeigt die Antwort, statt zu verweigern.

Ebenso wenig sagt sie, ob eine Freigabe verifiziert. Das ist die Frage des Merge-Gates, und ein grüner Haken, den diese Seite aus einer Datei rendert, die sie selbst gelesen hat, wäre eine Behauptung aus der schwächstmöglichen Quelle — genau das, was die Kette nicht auf Treu und Glauben nehmen soll.

Was diese Seite gar nicht sehen kann, steht in lib/plans.test.ts, dort wo die Dateien liegen: dass kein Plan die Adresse eines anderen beansprucht, und dass jeder über die Kurzform seiner Id erreichbar ist.