Entwurf · Issue 2dc6a5e

Ein Verify sagt, was es voraussetzt

Dreißig von fünfundfünfzig offenen Bau-Karten tragen eine Prüfung, die nur in einem Home-Verzeichnis läuft. Auf dem Board sehen sie genauso solide aus wie eine, die im frischen Clone läuft.

AGENTS.md sagt, was ein ## Verify enthalten muss — ein Kommando und den Zustand davor. Es sagt nirgends, was ein Kommando voraussetzen darf. Ein Beweis, der nur auf einem Laptop läuft, ist kein Beweis, sondern eine Notiz mit Backticks. Für jeden, der nicht an dieser Maschine sitzt, ist die Karte unprüfbar — und nichts auf dem Board sagt ihm das.

01Vier Reichweiten, nicht zwei

Der Reflex wäre ein Verbot, und er wäre falsch. Dreiundzwanzig der dreißig Karten haben recht damit, was sie prüfen — ihre Arbeit liegt wirklich in tessera-sdk, in mosaik, in atproto. Sie haben nur unrecht damit, wie sie es finden: sie setzen ein Verzeichnislayout voraus, statt ein Repository zu nennen.

  • hältein Kommando im Baum setzt nichts voraus — "rg -c 'plans waiting' AGENTS.md lib/board.ts"
  • hältein absoluter Pfad auf DIESES Repository ist der eine Fehler, der nichts einbringt
  • hältein Nachbar-Repository ist eine Reichweite, kein Fehler
  • hältein ssh prüft eine Maschine, keinen Baum — eine eigene Art

02Die Deklaration steht beim Kommando

Eine Voraussetzung wird erklärt, nicht verboten: # needs: repo tessera-sdk im gefencten Block, über dem Kommando, das sie deckt. Sie liest sich als Shell, überlebt das Kopieren ins Terminal — und genau das ist der häufigste Zugriff auf ein ## Verify überhaupt. Ein Abschnitt am Briefende bliebe zurück, sobald jemand nur das Kommando greift.

  • hälteine needs-Zeile ist kein Kommando — der Brief hat weiter genau eine Prüfung
  • hältund das Vokabular ist geschlossen: repo, ein Name, sonst nichts zu verstehen
  • hältsie deckt, was ihr folgt — nicht den ganzen Block
  • hältdeklariert verschwindet aus dem Report, nackt nicht

Das geschlossene Vokabular ist der Teil, der für einen Runner zählt: zwei Tokens vergleichen statt einen Satz interpretieren. „braucht einen Clone von tessera-sdk" wäre für einen Menschen genauso gut und für einen Agenten unbrauchbar.

03Das Verb meldet, es verweigert fast nie

just edges darf blocken: eine unlesbare Kante macht eine Karte unaufnehmbar. Ein unportables Kommando macht eine Karte für jemand anderen unprüfbar — das ist wert, gesagt zu werden, und nicht wert, die Arbeit zu stoppen. Ein Verb, das dreiundzwanzig ehrliche Karten rot färbt, ist das Verb, das alle überspringen.

  • hältein Nachbar-Repo und ein ssh werden gemeldet und halten nichts auf
  • hältder absolute Selbstpfad ist die eine Verweigerung
  • hältund der Report sagt, wie man es erklärt, statt nur zu tadeln
reaches another repository — declare it: `# needs: repo <name>` above the command
aaaa000  aaaa000
           $ cd ~/src/repos/tessera-sdk && just test

reaches another machine — declare it: `# needs: host <name>` above the command
bbbb000  bbbb000
           $ ssh -i ~/.ssh/id_ed25519 root@167.233.240.164 'ps -eo stat'

2 open cards with a command · 0 run in a fresh clone · 0 carry none
every command runs where it says it does.

Was diese Seite nicht sehen kann, sind die Karten selbst. Wie viele heute betroffen sind, beantwortet just briefs im Terminal — hier steht die Regel, nicht ihr Befund.