Öppen källkod · MIT · av Bluewaves
Craftsman Bygg med agenter utan att sänka ribban. Maskinen säger godkänt — eller inte.
För dem som vägrar sänka ribban
En skål för dem som låter agenten göra arbetet — och aldrig låter den rätta sin egen läxa.
Din egen verktygskedja — testerna, lintern, typkontrollen, bygget — blir utslagsmaskinen. Varje kontroll ger en exit-kod. Ingen känsla. Ingen språkmodells åsikt. Ett utslag en maskin kan stå för.
Kontraktet
Människan äger visionen.
Agenten gör arbetet.
Maskinen säger godkänt.
En enda mening som hela systemet tjänar. Allt annat är detaljer.
Grönt betyder exit 0 — visat, inte påstått. Vad det är
Konstitutionen
Hundra rader, lästa varje varv.
AGENTS.md — vision, stack, ett exempel per konvention, grindkommandona. Människoägd, aldrig komprimerad, aldrig över hundra rader. En enda fil dirigerar varje varv av arbetet.
Maskinutslag
Exit-koden är utslaget.
Modellen avgör aldrig om dess egen kod fungerar — det gör grindarna. Och grindarna är ditt projekts egna kommandon: test, lint, types, build. Grönt betyder exit 0, med beviset inklistrat.
Nio färdigheter
Skarpa, inte tunga.
Brainstorm, specify, plan, implement, verify, fix, review, finish — och en som sätter upp alltihop. Var och en är sjuttio rader eller färre: den visar formen på gott arbete, sedan slutar den.
Flödet
Dirigerat av tillstånd, aldrig för hand.
En tabell i konstitutionen dirigerar varje varv. Specen fryses vid godkännande; planen anpassar sig vid varje batchgräns; osynliga ändringar får hoppa över ceremonin — aldrig grindarna.
Liggarna
Allt beständigt ligger på disk.
SPEC.md rymmer de frysta kriterierna, PLAN.md de levande batcharna, ADR.md besluten och återvändsgränderna, git-loggen berättelsen — typade commits en människa kan granska. Arbetet överlever kompaktering.
Flödet
Nio skarpa färdigheter. Ingen nämner dem vid namn — arbetet dirigerar sig självt.
craftsman-mode — observerar din kodbas och skriver konstitutionen utifrån kommandon den faktiskt har kört.
brainstorm — öppnar rummet — vad ska det här ens vara?
specify — förvandlar avsikt till frysta, kontrollerbara kriterier. Dina att godkänna.
plan — skivar specen i batchar, anpassar sig vid varje gräns, väntar på ditt klartecken.
implement — en uppgift, test först, dokumentationen uppslagen — rött före grönt.
verify — varje grind, färska bevis, exit-koder — aldrig självskattning.
fix — diagnostiserar ner till grundorsaken före en enda rad reparation.
review — friska ögon bedömer om arbetet är gott, inte bara grönt.
finish — full QA, konsoliderade beslut, dokumentation som stämmer på en ren maskin.
Du fattar produktbesluten; exit-koder dömer koden. Det är hela jobbet.
Tolv meddelanden från människan — en prompt, produktbeslut, godkännanden. Allt annat dirigerade flödet på egen hand: en levererad produkt, på en medelklassmodell, utan en enda subagent.
16/16 kriterier · 53/53 tester · 44 typade commits · $7.07
Uppmätt, inte utlovat.
Hur det är byggt
Markdown, inte maskineri
En konstitution och tre liggare — SPEC, PLAN, ADR — plus din git-logg. Vanliga filer, människoägda, inget tillstånd någon annanstans. Ingen CLI, inga beroenden, ingen daemon: markdown och bash, inget som kan gå sönder.
Ett kommando för att installera
Enbart bash, idempotent, på användar- eller projektnivå. Färdigheterna landar i det öppna standardförrådet, din agent upptäcker dem, och din befintliga AGENTS.md rörs aldrig. Avinstallation är dokumenterad i skriptet.
Färdigheterna
Nio färdigheter i den öppna standarden Agent Skills — läsbara för Claude Code, Codex, Cursor, vad som än kommer härnäst. Var och en visar formen på gott arbete på sjuttio rader, och kliver sedan åt sidan.
Maskinen talar
Flödet har en enda röst för status: bevis. Den smickrar aldrig, och den gissar aldrig.
Inte för alla
Craftsman jagar inte topplistan, demon eller veckans modell. Det är en gåva — MIT-licensierad, utan förbehåll — för dem som levererar riktig mjukvara och vägrar låta en agent rätta sitt eget arbete. Är det du, är det ditt.
Härstamning
Två anfäder och ett vad — var och en behållen för det enda den fick rätt.
Craftsman v1 — maskinupprätthållen: dess insikt är att utslag måste vara exit-koder. Behållen — minus CLI:n på 22 000 rader.
Superpowers — beteendekonstruerad: dess insikt är progressivt avslöjande — håll nästan ingenting ständigt närvarande. Behållen — minus ceremonin.
The LLM-judge research — modeller känner igen korrekt kod knappt bättre än en slantsingling; mekanisk återkoppling slår ”snälla, gör TDD”.
Agent Skills — ett färdighetsformat varje harness kan läsa — process, inte inlåsning.
Vadet ovanpå båda: frontmodeller följer form bättre än regler. Visa ett gott exempel och de generaliserar; skriv tio stycken förbud och de rationaliserar.
Människan äger visionen. Agenten gör arbetet. Maskinen säger godkänt.
Vägled och visa, diktera och kontrollera inte.
Ta det. Det är ditt.
Läs pilotrapportenMIT-licensierat · från Bluewaves