Código abierto · MIT · por Bluewaves
Craftsman Construye con agentes sin bajar el listón. La máquina dice aprobado — o no lo dice.
Para quienes no bajan el listón
Por quienes dejan que el agente haga el trabajo — y jamás le dejan corregir sus propios deberes.
Tu propia cadena de herramientas — los tests, el linter, el verificador de tipos, la build — se convierte en la máquina de veredictos. Cada comprobación devuelve un código de salida. No una sensación. No la opinión de un modelo de lenguaje. Un veredicto que una máquina puede respaldar.
El contrato
La persona posee la visión.
El agente hace el trabajo.
La máquina dice aprobado.
Una sola frase a la que sirve todo el sistema. Lo demás es detalle.
El verde significa exit 0 — demostrado, no proclamado. Qué es
La Constitución
Cien líneas, leídas en cada turno.
AGENTS.md — la visión, el stack, un ejemplo por convención, los comandos de las compuertas. En manos de la persona, nunca compactado, nunca más de cien líneas. Un solo fichero encauza cada turno de trabajo.
Veredictos de Máquina
El código de salida es el veredicto.
El modelo nunca juzga si su propio código funciona — lo hacen las compuertas. Y las compuertas son los comandos de tu propio proyecto: test, lint, types, build. El verde significa exit 0, con la evidencia pegada.
Nueve Skills
Afiladas, no pesadas.
Brainstorm, specify, plan, implement, verify, fix, review, finish — y una para ponerlo todo en marcha. Cada una tiene setenta líneas o menos: muestra la forma del buen trabajo, y se detiene.
El Flujo
Encauzado por el estado, nunca a mano.
Una tabla en la constitución encauza cada turno. La especificación se congela al aprobarse; el plan se adapta en cada frontera de lote; los cambios invisibles pueden saltarse la ceremonia — nunca las compuertas.
Los Libros de Registro
Todo lo duradero está en disco.
SPEC.md guarda los criterios congelados; PLAN.md, los lotes vivos; ADR.md, las decisiones y los callejones sin salida; el log de git, la narrativa — commits tipados que una persona puede auditar. El trabajo sobrevive a la compactación.
El flujo
Nueve skills afiladas. Nadie las nombra — el trabajo se encauza solo.
craftsman-mode — observa tu código y escribe la constitución a partir de comandos que ejecutó de verdad.
brainstorm — abre el espacio — ¿qué debería ser esto, para empezar?
specify — convierte la intención en criterios congelados y comprobables. La aprobación es tuya.
plan — corta la especificación en lotes, se adapta en cada frontera, espera tu visto bueno.
implement — una tarea, el test primero, la documentación abierta — rojo antes que verde.
verify — cada compuerta, evidencia fresca, códigos de salida — nunca autoevaluación.
fix — diagnostica hasta la causa raíz antes de una sola línea de reparación.
review — ojos nuevos juzgan si el trabajo es bueno, no solo verde.
finish — QA completa, decisiones consolidadas, documentación fiel en una máquina limpia.
Tú tomas las decisiones de producto; los códigos de salida juzgan el código. Ese es todo el oficio.
Doce mensajes del humano — un prompt, decisiones de producto, aprobaciones. Todo lo demás lo encaminó el flujo por sí solo: un producto entregado, con un modelo de gama media, sin un solo subagente.
16/16 criterios · 53/53 tests · 44 commits tipados · $7.07
Medido, no prometido.
Cómo está construido
Markdown, no maquinaria
Una constitución y tres libros de registro — SPEC, PLAN, ADR — más tu log de git. Ficheros planos, en manos de la persona, sin estado en ningún otro lugar. Sin CLI, sin dependencias, sin daemon: markdown y bash, nada que pueda romperse.
Un solo comando para instalar
Solo bash, idempotente, a nivel de usuario o de proyecto. Las skills aterrizan en el almacén del estándar abierto, tu agente las descubre y tu AGENTS.md existente no se toca jamás. La desinstalación está documentada en el propio script.
Las Skills
Nueve skills en el estándar abierto Agent Skills — legibles por Claude Code, Codex, Cursor, lo que venga después. Cada una muestra la forma del buen trabajo en setenta líneas, y luego se aparta.
Habla la máquina
El flujo tiene una sola voz para el estado: la evidencia. Nunca adula, y nunca adivina.
No para todos
Craftsman no persigue el ranking, la demo ni el modelo de la semana. Es un regalo — con licencia MIT, sin ataduras — para quienes entregan software de verdad y se niegan a dejar que un agente corrija su propio trabajo. Si ese eres tú, es tuyo.
Linaje
Dos ancestros y una apuesta — cada ancestro conservado por lo único que acertó.
Craftsman v1 — impuesto por la máquina: su hallazgo es que los veredictos deben ser códigos de salida. Conservado — menos la CLI de 22.000 líneas.
Superpowers — comportamiento por ingeniería: su hallazgo es la revelación progresiva — mantener casi nada siempre residente. Conservado — menos la ceremonia.
The LLM-judge research — los modelos reconocen el código correcto apenas mejor que una moneda al aire; la retroalimentación mecánica supera al «por favor, haz TDD».
Agent Skills — un único formato de skill que toda herramienta puede leer — proceso, no cautiverio.
La apuesta sobre ambos: los modelos de frontera siguen mejor la forma que las reglas. Muéstrales un buen ejemplo y generalizan; escríbeles diez párrafos de prohibiciones y racionalizan.
La persona posee la visión. El agente hace el trabajo. La máquina dice aprobado.
Guiar y mostrar, no ordenar y controlar.
Tómalo. Es tuyo.
Lee el informe del pilotoCon licencia MIT · de Bluewaves