Monozukuri: un flujo artesanal japonés para que tu agente escriba código sencillo y verificable

Para quién es

• Para desarrolladores que quieren que el agente siga un flujo verificable al escribir código (Observar → Entender → Planificar → Implementar → Verificar → Reflexionar → Mejorar), en lugar de generar el código de una sola vez.
• Para usuarios de agentes que soportan el formato Agent Skills: cada habilidad es un directorio <name>/SKILL.md de nivel superior, y según la documentación oficial es compatible con cualquier agente que soporte dicho formato. Se invoca explícitamente con $monozukuri-core.
• No es adecuado cuando: la evidencia no indica la versión específica del runtime del que depende, no incluye una lista de clientes verificados, ni aclara el soporte para tareas de texto/documentos — esta habilidad está orientada a la construcción y el mantenimiento de software; si la evidencia no menciona otros usos, no los asumas.
• Lo que la documentación oficial no indica: lenguajes de programación soportados, si requiere acceso a la red, ni los límites concretos de efectos secundarios de cada habilidad; no hay evidencia al respecto, verifícalo tú mismo antes de usarlo.

Primer intento en 3 minutos

Requisitos previos: Node.js/npx en tu máquina; un agente que soporte el formato Agent Skills. La documentación oficial ofrece dos métodos de instalación; aquí solo se recomienda una ruta principal:

Ruta principal: instalar la habilidad núcleo con la CLI de skills

Ejecuta en la raíz del proyecto:

npx skills add kuya-egg/Monozukuri --skill monozukuri-core

Esto solo instala la habilidad paraguas monozukuri-core. Si más adelante quieres instalar las 12 habilidades (la paraguas + 11 enfocadas), la misma CLI oficial admite comodines:

npx skills add kuya-egg/Monozukuri --skill '*'

(La documentación oficial también ofrece una instalación como plugin de Claude Code: primero /plugin marketplace add kuya-egg/Monozukuri y luego /plugin install monozukuri@monozukuri, lo que instala las 12 habilidades y las carga bajo el espacio de nombres monozukuri; en este documento no se presenta como ruta principal.)

Desencadena una tarea de bajo riesgo: tras la instalación, escribe explícitamente $monozukuri-core en el agente y asígnale una pequeña tarea de solo lectura/análisis, por ejemplo, «revisa la corrección y la sencillez de una función pequeña siguiendo el flujo craftsmanship». El flujo de trabajo principal es Observe → Understand → Plan → Craft → Verify → Reflect → Kaizen.

Señales de éxito: el agente organiza su respuesta según las siete fases anteriores, en lugar de soltar código directamente; si las habilidades enfocadas se encadenan en el orden oficial (nemawashi → genchi-genbutsu → kanso → kata → poka-yoke → kodawari → andon → shukka), indica que todas las habilidades están activas. Nota: esta habilidad está orientada a tareas de código; no existen rúbricas separadas para novelas o documentos profesionales; si le asignas una tarea de escritura de texto, la evidencia no garantiza que exista un flujo correspondiente. $monozukuri-core es solo la forma explícita de invocación; si lee o escribe archivos, ejecuta comandos o accede a la red no está especificado oficialmente, así que para el primer intento elige una tarea sin efectos secundarios.

Casos de uso

Caso 1: revisión artesanal de una función pequeña Escenario: quieres que el agente examine con cuidado un código existente. Cómo iniciarlo: escribe $monozukuri-core en un agente compatible, adjunta el código objetivo y pide una evaluación siguiendo el flujo. Flujo utilizado: el Observe → Understand → Plan → Craft → Verify → Reflect → Kaizen de la habilidad paraguas. Resultado esperable: el agente presenta por fases observaciones, comprensión, plan y sugerencias de verificación, en lugar de reescribir directamente; en cuanto a si modifica archivos solo tras tu confirmación, la evidencia no lo aclara, así que conviene pedir explícitamente que solo analice y no modifique archivos.

Caso 2: desarrollo completo de una funcionalidad con la cadena de habilidades enfocadas Escenario: instala primero todas las habilidades (--skill '*' o vía el plugin de Claude Code) y pide al agente que desarrolle una funcionalidad pequeña. Flujo utilizado: las habilidades enfocadas se encadenan en el orden oficial nemawashi → genchi-genbutsu → kanso → kata → poka-yoke → kodawari → andon → shukka, cubriendo todo el recorrido desde la preparación hasta la verificación. Resultado esperable: el agente avanza por las fases de cada habilidad y entrega los productos de cada etapa; los modos de activación concretos de cada habilidad enfocada y sus efectos secundarios no se detallan en la evidencia, así que antes de ejecutar confirma con el agente si cada paso modificará el código.

Límites de uso

• La instalación varía según la plataforma: la CLI de skills (npx skills add ...) es la vía universal; en la plataforma Claude Code se usa /plugin marketplace add + /plugin install monozukuri@monozukuri, que instala las 12 habilidades con el espacio de nombres monozukuri. No mezcles ambos métodos ni infieras métodos de instalación para otros clientes.
• Modo de activación: oficialmente se indica la invocación explícita de $monozukuri-core; la sintaxis de invocación de las demás habilidades no aparece en la evidencia.
• Efectos secundarios y puntos de confirmación: esta habilidad guía al agente para escribir código, pero la evidencia no indica si modificará directamente tus archivos, ejecutará comandos o accederá a la red; todo ello es desconocido. Para el primer intento, prioriza tareas de análisis de solo lectura y, antes de cualquier cambio, pide al agente que muestre primero el plan.
• Limitaciones oficiales explícitas: monozukuri-core instalado por separado solo incluye el flujo de la habilidad paraguas; la cadena completa requiere instalar las 12 habilidades. La documentación oficial no especifica lenguajes de programación soportados, configuraciones regionales, requisitos de red ni lista de clientes.
• Información clave sin confirmar: el comportamiento concreto de cada habilidad enfocada, las formas de actualizar/desinstalar y los términos de uso fuera de la licencia no se tratan en la evidencia; consulta el repositorio original antes de usar.