Open source · MIT · door Bluewaves
Craftsman Bouw met agents zonder de lat te verlagen. De machine zegt geslaagd — of niet.
Voor wie de lat niet verlaagt
Op hen die de agent het werk laten doen — en het nooit zijn eigen huiswerk laten nakijken.
Je eigen toolchain — de tests, de linter, de typechecker, de build — wordt de oordeelsmachine. Elke controle geeft een exit-code terug. Geen onderbuikgevoel. Geen mening van een taalmodel. Een oordeel waar een machine achter staat.
Het contract
De mens bezit de visie.
De agent doet het werk.
De machine zegt geslaagd.
Eén zin die het hele systeem dient. Al het andere is detail.
Groen betekent exit 0 — getoond, niet beweerd. Wat het is
De Grondwet
Honderd regels, elke beurt gelezen.
AGENTS.md — visie, stack, één voorbeeld per conventie, de gate-commando's. In handen van de mens, nooit gecomprimeerd, nooit langer dan honderd regels. Eén bestand routeert elke beurt werk.
Machineoordelen
De exit-code is het oordeel.
Het model beoordeelt nooit of zijn eigen code werkt — dat doen gates. En de gates zijn de eigen commando's van je project: test, lint, types, build. Groen betekent exit 0, met het bewijs erbij geplakt.
Negen Skills
Scherp, niet zwaar.
Brainstorm, specify, plan, implement, verify, fix, review, finish — en één om alles op te zetten. Elk zeventig regels of minder: hij toont de vorm van goed werk, en stopt dan.
De Flow
Gerouteerd op toestand, nooit met de hand.
Een tabel in de grondwet routeert elke beurt. De spec bevriest bij goedkeuring; het plan past zich aan bij elke batchgrens; onzichtbare wijzigingen mogen ceremonie overslaan — nooit de gates.
De Grootboeken
Alles wat duurzaam is staat op schijf.
SPEC.md bewaart de bevroren criteria, PLAN.md de levende batches, ADR.md de beslissingen en doodlopende wegen, de git-log het verhaal — getypeerde commits die een mens kan controleren. Werk overleeft compactie.
De flow
Negen scherpe skills. Niemand noemt ze bij naam — het werk routeert zichzelf.
craftsman-mode — observeert je codebase en schrijft de grondwet op basis van commando's die hij echt heeft uitgevoerd.
brainstorm — opent de ruimte — wat moet dit eigenlijk worden?
specify — vertaalt intentie naar bevroren, controleerbare criteria. Aan jou om goed te keuren.
plan — snijdt de spec in batches, past zich aan bij elke grens, wacht op jouw akkoord.
implement — één taak, test eerst, docs open — rood vóór groen.
verify — elke gate, vers bewijs, exit-codes — nooit zelfbeoordeling.
fix — diagnosticeert tot aan de oorzaak voordat er één regel wordt hersteld.
review — frisse ogen beoordelen of het werk goed is, niet alleen groen.
finish — volledige QA, geconsolideerde beslissingen, documentatie die klopt op een schone machine.
Jij neemt de productbeslissingen; exit-codes beoordelen de code. Dat is het hele werk.
Twaalf berichten van de mens — één prompt, productbeslissingen, goedkeuringen. Al het andere routeerde de flow zelf: een opgeleverd product, op een middenklassemodel, zonder één enkele subagent.
16/16 criteria · 53/53 tests · 44 getypeerde commits · $7.07
Gemeten, niet beloofd.
Hoe het gebouwd is
Markdown, geen machinerie
Een grondwet en drie grootboeken — SPEC, PLAN, ADR — plus je git-log. Gewone bestanden, in handen van de mens, nergens anders state. Geen CLI, geen dependencies, geen daemon: markdown en bash, niets dat kapot kan.
Eén commando om te installeren
Alleen bash, idempotent, op gebruikers- of projectniveau. De skills landen in de open-standaard-store, je agent ontdekt ze, en je bestaande AGENTS.md blijft onaangeroerd. Deïnstalleren staat gedocumenteerd in het script.
De Skills
Negen skills in de open standaard Agent Skills — leesbaar voor Claude Code, Codex, Cursor, wat er ook komt. Elk toont de vorm van goed werk in zeventig regels, en gaat dan uit de weg.
De machine spreekt
De flow heeft één stem voor status: bewijs. Hij vleit nooit, en hij gokt nooit.
Niet voor iedereen
Craftsman jaagt niet op het scorebord, de demo, of het model van de week. Het is een geschenk — onder MIT-licentie, zonder voorwaarden — voor de mensen die echte software leveren en weigeren een agent zijn eigen werk te laten nakijken. Als dat jij bent, is het van jou.
Herkomst
Twee voorouders en een weddenschap — elke voorouder behouden om het ene wat hij goed had.
Craftsman v1 — machinaal afgedwongen: zijn inzicht is dat oordelen exit-codes moeten zijn. Behouden — minus de CLI van 22.000 regels.
Superpowers — gedragsmatig geëngineerd: zijn inzicht is progressive disclosure — houd bijna niets permanent aanwezig. Behouden — minus de ceremonie.
The LLM-judge research — modellen herkennen correcte code nauwelijks beter dan kop of munt; mechanische feedback verslaat “doe alsjeblieft aan TDD”.
Agent Skills — één skill-formaat dat elke harness kan lezen — proces, geen lock-in.
De weddenschap daarbovenop: frontier-modellen volgen vorm beter dan regels. Toon één goed voorbeeld en ze generaliseren; schrijf tien alinea's verbod en ze rationaliseren.
De mens bezit de visie. De agent doet het werk. De machine zegt geslaagd.
Leiden en tonen, niet dicteren en controleren.
Neem het. Het is van jou.
Lees het pilotrapportOnder MIT-licentie · van Bluewaves