Open Source · MIT · von Bluewaves
Craftsman Mit Agenten bauen, ohne die Messlatte zu senken. Die Maschine sagt bestanden — oder eben nicht.
Für alle, die die Messlatte nicht senken
Auf alle, die den Agenten die Arbeit machen lassen — und ihn nie seine eigenen Hausaufgaben benoten lassen.
Deine eigene Toolchain — die Tests, der Linter, der Type-Checker, der Build — wird zur Urteilsmaschine. Jede Prüfung liefert einen Exit-Code. Kein Bauchgefühl. Keine Meinung eines Sprachmodells. Ein Urteil, hinter dem eine Maschine steht.
Der Vertrag
Der Mensch besitzt die Vision.
Der Agent macht die Arbeit.
Die Maschine sagt bestanden.
Ein Satz, dem das ganze System dient. Alles andere ist Detail.
Grün heißt exit 0 — gezeigt, nicht behauptet. Was es ist
Die Verfassung
Hundert Zeilen, gelesen bei jedem Zug.
AGENTS.md — Vision, Stack, ein Beispiel pro Konvention, die Gate-Befehle. In Menschenhand, nie kompaktiert, nie über hundert Zeilen. Eine Datei lenkt jeden Zug der Arbeit.
Maschinenurteile
Der Exit-Code ist das Urteil.
Das Modell beurteilt nie, ob sein eigener Code funktioniert — das tun die Gates. Und die Gates sind die eigenen Befehle deines Projekts: test, lint, types, build. Grün heißt exit 0, mit eingefügtem Nachweis.
Neun Skills
Scharf, nicht schwer.
Brainstorm, specify, plan, implement, verify, fix, review, finish — und einer, der alles aufsetzt. Jeder umfasst höchstens siebzig Zeilen: Er zeigt die Gestalt guter Arbeit, dann hört er auf.
Der Flow
Gelenkt vom Zustand, nie von Hand.
Eine Tabelle in der Verfassung lenkt jeden Zug. Die Spezifikation friert bei der Freigabe ein; der Plan passt sich an jeder Batch-Grenze an; unsichtbare Änderungen dürfen das Zeremoniell überspringen — nie die Gates.
Die Kontobücher
Alles Dauerhafte liegt auf der Platte.
SPEC.md hält die eingefrorenen Kriterien, PLAN.md die lebenden Batches, ADR.md die Entscheidungen und Sackgassen, das Git-Log die Erzählung — typisierte Commits, die ein Mensch prüfen kann. Die Arbeit überlebt jede Kompaktierung.
Der Flow
Neun scharfe Skills. Niemand ruft sie beim Namen — die Arbeit lenkt sich selbst.
craftsman-mode — beobachtet deine Codebasis und schreibt die Verfassung aus Befehlen, die er wirklich ausgeführt hat.
brainstorm — öffnet den Raum — was soll das überhaupt werden?
specify — macht aus Absicht eingefrorene, prüfbare Kriterien. Du gibst sie frei.
plan — schneidet die Spezifikation in Batches, passt sich an jeder Grenze an, wartet auf dein Go.
implement — eine Aufgabe, Test zuerst, Doku offen — rot vor grün.
verify — jedes Gate, frischer Nachweis, Exit-Codes — nie Selbsteinschätzung.
fix — diagnostiziert bis zur Wurzel, bevor eine einzige Zeile repariert wird.
review — frische Augen beurteilen, ob die Arbeit gut ist, nicht nur grün.
finish — volle QA, konsolidierte Entscheidungen, Dokumentation, die auf einer sauberen Maschine stimmt.
Du triffst die Produktentscheidungen; Exit-Codes beurteilen den Code. Das ist der ganze Job.
Zwölf Nachrichten vom Menschen — ein Prompt, Produktentscheidungen, Freigaben. Alles andere hat der Flow selbst geroutet: ein ausgeliefertes Produkt, auf einem Mittelklasse-Modell, ohne einen einzigen Subagenten.
16/16 Kriterien · 53/53 Tests · 44 typisierte Commits · $7.07
Gemessen, nicht versprochen.
Wie es gebaut ist
Markdown, keine Maschinerie
Eine Verfassung und drei Kontobücher — SPEC, PLAN, ADR — dazu dein Git-Log. Einfache Dateien, in Menschenhand, kein Zustand irgendwo sonst. Keine CLI, keine Abhängigkeiten, kein Daemon: Markdown und Bash, nichts, was brechen könnte.
Ein Befehl zur Installation
Nur Bash, idempotent, auf Nutzer- oder Projektebene. Die Skills landen im Store des offenen Standards, dein Agent entdeckt sie, und deine bestehende AGENTS.md wird nie angerührt. Die Deinstallation ist im Skript dokumentiert.
Die Skills
Neun Skills im offenen Standard Agent Skills — lesbar für Claude Code, Codex, Cursor, was auch immer als Nächstes kommt. Jeder zeigt die Gestalt guter Arbeit in siebzig Zeilen, dann tritt er beiseite.
Die Maschine spricht
Der Flow hat eine Stimme für den Status: den Nachweis. Sie schmeichelt nie, und sie rät nie.
Nicht für jeden
Craftsman jagt weder dem Ranking, der Demo noch dem Modell der Woche hinterher. Es ist ein Geschenk — MIT-lizenziert, ohne Haken — für die Menschen, die echte Software ausliefern und sich weigern, einen Agenten seine eigene Arbeit benoten zu lassen. Wenn das du bist, gehört es dir.
Herkunft
Zwei Vorfahren und eine Wette — jeder Vorfahr behalten für das eine, das er richtig gemacht hat.
Craftsman v1 — maschinell erzwungen: seine Einsicht ist, dass Urteile Exit-Codes sein müssen. Behalten — minus die CLI mit 22.000 Zeilen.
Superpowers — verhaltensgestaltet: seine Einsicht ist Progressive Disclosure — fast nichts bleibt ständig resident. Behalten — minus das Zeremoniell.
The LLM-judge research — Modelle erkennen korrekten Code kaum besser als ein Münzwurf; mechanisches Feedback schlägt „bitte mach TDD“.
Agent Skills — ein Skill-Format, das jeder Harness lesen kann — Prozess, kein Lock-in.
Die Wette auf beidem: Frontier-Modelle folgen Gestalt besser als Regeln. Zeig ein gutes Beispiel, und sie generalisieren; schreib zehn Absätze Verbote, und sie rationalisieren.
Der Mensch besitzt die Vision. Der Agent macht die Arbeit. Die Maschine sagt bestanden.
Führen und zeigen, nicht befehlen und kontrollieren.
Nimm es. Es gehört dir.
Den Pilotbericht lesenMIT-lizenziert · von Bluewaves