Entwurf · Issue 55ba307

Ein Effort zu zweit trägt einen Spec

Entwurf zu Issue 55ba307, zu docs/plans/55ba307-an-effort-of-two-carries-a-spec.md. Jedes Urteil unten rechnet lib/docs.ts und lib/effort.ts beim Rendern aus.

Die Kopplung, die ein Leser will — die Entscheidungen neben dem, wie es aussehen kann — existierte eine Ebene zu tief: der Entwurf gehört dem Issue. Ein Effort über mehrere Karten hatte kein eigenes Dokument, seine Entscheidungen lagen verschmiert über Member-Entwürfe. Der Spec ist das Dokument des Organs: das Problem, die Entscheidungen bisher, wohin es aussieht — die Seite, die man VOR jedem Member-Entwurf öffnet.

01Eine dritte Kapitelart

DocKind kennt jetzt spec, und ein Spec-Kapitel nennt sein Organ statt eines Issues: effort: "board" in der Registry bindet docs/design/board an effort/board. Das Feld bedeutet genau eines — lib/docs.test.ts weist ein Nicht-Spec-Kapitel mit effort ab.

  • hältdie Registry kennt die Art "spec"
  • hältspecFor(board) findet design/board — der erste echte Spec
  • hältnur Spec-Kapitel tragen ein effort-Feld

02Weich erzwungen, und die Weichheit ist der Punkt

Ein Organ mit zwei oder mehr Mitgliedern und ohne Spec trägt ein Abzeichen auf seinem Board-Kopf — no spec — und sonst nichts. Das Gate bleibt draußen: ob es je einen Spec verlangt, wird nach zwei echten Efforts entschieden, in einem eigenen Issue. Ein Effort mit einer Karte braucht nichts — der Entwurf seiner Karte genügt, und ein Abzeichen dort wäre Zeremonie.

  • hälteine Karte schuldet nichts
  • hältzwei Karten schulden einen Spec

03Was der Spec hält, was die Map rechnet

  • Die Map rechnet: Frontier, Entscheidungsindex, Mitgliederzählung — alles, was aus den Karten ableitbar ist, wird abgeleitet und nie von Hand gepflegt.
  • Der Spec hält, was kein Index tragen kann: warum das Organ existiert, welche Entscheidungen es geprägt haben, wohin es aussieht — Prosa, die ein Mensch für einen Menschen schreibt. Der erste steht: Spec — Das Board ist das eine Arbeitsbild.
  • Member-Entwürfe bauen darauf: sie beantworten ihr Issue und verweisen nach oben, statt die Organ-Geschichte jedes Mal neu zu erzählen.