Código aberto · MIT · pela Bluewaves
Craftsman Construa com agentes sem baixar a fasquia. A máquina diz que passa — ou não diz.
Para quem não baixa a fasquia
Aos que deixam o agente fazer o trabalho — e nunca o deixam corrigir os seus próprios trabalhos.
A sua própria toolchain — os testes, o linter, o verificador de tipos, o build — torna-se a máquina de veredictos. Cada verificação devolve um código de saída. Não uma intuição. Não a opinião de um modelo de linguagem. Um veredicto que uma máquina assume.
O contrato
O humano é dono da visão.
O agente faz o trabalho.
A máquina diz que passa.
Uma frase que todo o sistema serve. Tudo o resto é pormenor.
Verde significa exit 0 — mostrado, não alegado. O que é
A Constituição
Cem linhas, lidas a cada turno.
AGENTS.md — visão, stack, um exemplo por convenção, os comandos das barreiras. Pertence ao humano, nunca é compactado, nunca passa das cem linhas. Um só ficheiro encaminha cada turno de trabalho.
Veredictos da Máquina
O código de saída é o veredicto.
O modelo nunca julga se o seu próprio código funciona — as barreiras julgam. E as barreiras são os comandos do seu próprio projeto: test, lint, types, build. Verde significa exit 0, com a prova colada.
Nove Skills
Afiadas, não pesadas.
Brainstorm, specify, plan, implement, verify, fix, review, finish — e uma para montar tudo. Cada uma tem setenta linhas ou menos: mostra a forma do bom trabalho, e depois para.
O Fluxo
Encaminhado pelo estado, nunca à mão.
Uma tabela na constituição encaminha cada turno. A especificação congela na aprovação; o plano adapta-se em cada fronteira de lote; mudanças invisíveis podem dispensar a cerimónia — nunca as barreiras.
Os Livros-Razão
Tudo o que dura está em disco.
O SPEC.md guarda os critérios congelados, o PLAN.md os lotes vivos, o ADR.md as decisões e os becos sem saída, o git log a narrativa — commits tipados que um humano pode auditar. O trabalho sobrevive à compactação.
O fluxo
Nove skills afiadas. Ninguém as nomeia — o trabalho encaminha-se sozinho.
craftsman-mode — observa a sua base de código e escreve a constituição a partir de comandos que de facto executou.
brainstorm — abre o espaço — o que é que isto deve sequer ser?
specify — transforma intenção em critérios congelados e verificáveis. A aprovação é sua.
plan — fatia a especificação em lotes, adapta-se em cada fronteira, espera pelo seu aval.
implement — uma tarefa, teste primeiro, documentação aberta — vermelho antes do verde.
verify — todas as barreiras, prova fresca, códigos de saída — nunca autoavaliação.
fix — diagnostica até à causa raiz antes de uma única linha de reparação.
review — olhos frescos julgam se o trabalho é bom, não apenas verde.
finish — QA completo, decisões consolidadas, documentação verdadeira numa máquina limpa.
As decisões de produto são suas; os códigos de saída julgam o código. É esse o trabalho inteiro.
Doze mensagens do humano — um prompt, decisões de produto, aprovações. Tudo o resto, o fluxo encaminhou sozinho: um produto entregue, num modelo de gama média, sem um único subagente.
16/16 critérios · 53/53 testes · 44 commits tipados · $7.07
Medido, não prometido.
Como é construído
Markdown, não maquinaria
Uma constituição e três livros-razão — SPEC, PLAN, ADR — mais o seu git log. Ficheiros simples, do humano, sem estado em mais lado nenhum. Sem CLI, sem dependências, sem daemon: markdown e bash, nada que se parta.
Um comando para instalar
Só bash, idempotente, ao nível do utilizador ou do projeto. As skills instalam-se no repositório do padrão aberto, o seu agente descobre-as, e o seu AGENTS.md existente nunca é tocado. A desinstalação está documentada no próprio script.
As Skills
Nove skills no padrão aberto Agent Skills — legíveis pelo Claude Code, pelo Codex, pelo Cursor, pelo que vier a seguir. Cada uma mostra a forma do bom trabalho em setenta linhas, e depois sai do caminho.
A máquina fala
O fluxo tem uma só voz para o estado: a prova. Nunca bajula, e nunca adivinha.
Não é para todos
O Craftsman não anda atrás da tabela de classificações, da demonstração ou do modelo da semana. É uma dádiva — sob licença MIT, sem letras miúdas — para quem entrega software a sério e se recusa a deixar um agente corrigir o seu próprio trabalho. Se é o seu caso, é seu.
Linhagem
Dois antepassados e uma aposta — cada antepassado guardado pela única coisa em que acertou.
Craftsman v1 — imposto pela máquina: o seu acerto é que os veredictos têm de ser códigos de saída. Guardado — menos as 22 000 linhas de CLI.
Superpowers — engenharia de comportamento: o seu acerto é a revelação progressiva — manter quase nada sempre residente. Guardado — menos a cerimónia.
The LLM-judge research — os modelos reconhecem código correto pouco melhor do que ao lançar uma moeda ao ar; a resposta mecânica ganha ao “por favor, faça TDD”.
Agent Skills — um só formato de skill que qualquer harness lê — processo, não aprisionamento.
A aposta por cima de ambos: os modelos de fronteira seguem melhor a forma do que as regras. Mostre um bom exemplo e generalizam; escreva dez parágrafos de proibição e racionalizam.
O humano é dono da visão. O agente faz o trabalho. A máquina diz que passa.
Guiar e mostrar, não mandar e controlar.
Leve-o. É seu.
Ler o relatório do pilotoSob licença MIT · da Bluewaves