Open source · MIT · di Bluewaves
Craftsman Costruisci con gli agenti senza abbassare l'asticella. La macchina dice pass — oppure no.
Per chi non abbassa l'asticella
A chi lascia che sia l'agente a fare il lavoro — e non gli lascia mai correggere i propri compiti.
La tua stessa toolchain — i test, il linter, il type checker, la build — diventa la macchina dei verdetti. Ogni controllo restituisce un exit code. Non una sensazione. Non l'opinione di un modello linguistico. Un verdetto che una macchina può firmare.
Il contratto
La persona possiede la visione.
L'agente fa il lavoro.
La macchina dice pass.
Una frase che tutto il sistema serve. Tutto il resto è dettaglio.
Verde significa exit 0 — mostrato, non dichiarato. Cos'è
La Costituzione
Cento righe, lette a ogni turno.
AGENTS.md — visione, stack, un esempio per convenzione, i comandi dei gate. Posseduto dalla persona, mai compattato, mai oltre le cento righe. Un solo file instrada ogni turno di lavoro.
Verdetti della Macchina
L'exit code è il verdetto.
Il modello non giudica mai se il proprio codice funziona — lo fanno i gate. E i gate sono i comandi del tuo stesso progetto: test, lint, types, build. Verde significa exit 0, con le prove incollate.
Nove Skill
Affilate, non pesanti.
Brainstorm, specify, plan, implement, verify, fix, review, finish — e una che prepara tutto. Ognuna sta in settanta righe o meno: mostra la forma del buon lavoro, poi si ferma.
Il Flusso
Instradato dallo stato, mai a mano.
Una tabella nella costituzione instrada ogni turno. La spec si congela all'approvazione; il piano si adatta a ogni confine di batch; le modifiche invisibili possono saltare la cerimonia — mai i gate.
I Registri
Tutto ciò che dura è su disco.
SPEC.md custodisce i criteri congelati, PLAN.md i batch vivi, ADR.md le decisioni e i vicoli ciechi, il log di git la narrazione — commit tipizzati che una persona può verificare. Il lavoro sopravvive alla compattazione.
Il flusso
Nove skill affilate. Nessuno le nomina — il lavoro si instrada da sé.
craftsman-mode — osserva il tuo codebase e scrive la costituzione dai comandi che ha davvero eseguito.
brainstorm — apre lo spazio — che cosa dovrebbe essere, davvero?
specify — trasforma l'intento in criteri congelati e verificabili. Sta a te approvarli.
plan — affetta la spec in batch, si adatta a ogni confine, aspetta il tuo via.
implement — un task, prima il test, la documentazione aperta — rosso prima del verde.
verify — ogni gate, prove fresche, exit code — mai autovalutazione.
fix — diagnostica fino alla causa radice prima di una sola riga di riparazione.
review — occhi nuovi giudicano se il lavoro è buono, non solo verde.
finish — QA completo, decisioni consolidate, documentazione vera su una macchina pulita.
Le decisioni di prodotto le prendi tu; il codice lo giudicano gli exit code. Tutto qui.
Dodici messaggi dall'umano — un prompt, decisioni di prodotto, approvazioni. Tutto il resto l'ha instradato il flusso da solo: un prodotto rilasciato, su un modello di fascia media, senza un solo subagente.
16/16 criteri · 53/53 test · 44 commit tipizzati · $7.07
Misurato, non promesso.
Com'è fatto
Markdown, non macchinari
Una costituzione e tre registri — SPEC, PLAN, ADR — più il tuo log di git. File semplici, posseduti dalla persona, nessuno stato altrove. Niente CLI, niente dipendenze, niente daemon: markdown e bash, niente che si possa rompere.
Un solo comando per installare
Solo bash, idempotente, a livello utente o di progetto. Le skill atterrano nello store dello standard aperto, il tuo agente le scopre, e il tuo AGENTS.md esistente non viene mai toccato. La disinstallazione è documentata nello script.
Le Skill
Nove skill nello standard aperto Agent Skills — leggibili da Claude Code, Codex, Cursor, e ciò che verrà. Ognuna mostra la forma del buon lavoro in settanta righe, poi si fa da parte.
La macchina parla
Il flusso ha una sola voce per lo stato: le prove. Non lusinga mai, e non tira mai a indovinare.
Non per tutti
Craftsman non insegue la classifica, la demo o il modello della settimana. È un dono — con licenza MIT, senza vincoli — per chi rilascia software vero e si rifiuta di lasciare che un agente corregga il proprio lavoro. Se sei così, è tuo.
Discendenza
Due antenati e una scommessa — ogni antenato tenuto per l'unica cosa che ha azzeccato.
Craftsman v1 — imposto dalla macchina: la sua intuizione è che i verdetti devono essere exit code. Tenuta — meno la CLI da 22.000 righe.
Superpowers — ingegnerizzato nel comportamento: la sua intuizione è la progressive disclosure — tenere quasi nulla sempre residente. Tenuta — meno la cerimonia.
The LLM-judge research — i modelli riconoscono il codice corretto appena meglio del lancio di una moneta; il feedback meccanico batte il “per favore fai TDD”.
Agent Skills — un solo formato di skill che ogni harness sa leggere — processo, non lock-in.
La scommessa sopra entrambi: i modelli di frontiera seguono la forma meglio delle regole. Mostra un buon esempio e generalizzano; scrivi dieci paragrafi di divieti e razionalizzano.
La persona possiede la visione. L'agente fa il lavoro. La macchina dice pass.
Guidare e mostrare, non dettare e controllare.
Prendilo. È tuo.
Leggi il report pilotaLicenza MIT · da Bluewaves