Monozukuri: faça o agente escrever código simples e verificável com um fluxo artesanal japonês

Para quem é indicado

• Para desenvolvedores que querem que o agente siga um fluxo verificável ao escrever código (Observar → Compreender → Planejar → Implementar → Verificar → Refletir → Melhorar), em vez de simplesmente gerar código de uma vez.
• Para usuários de agentes compatíveis com o formato Agent Skills: cada skill é um diretório <name>/SKILL.md no nível superior; segundo a documentação oficial, funciona com qualquer agente que suporte esse formato. Invocado explicitamente via $monozukuri-core.
• Quando não é indicado: as evidências não informam a versão específica do runtime de que ele depende, não listam clientes verificados e não esclarecem o suporte a tarefas de texto/documento — esta skill é voltada à construção e manutenção de software; não presumas outros usos se as evidências não os mencionarem.
• Não especificado oficialmente: linguagens de programação suportadas, necessidade de acesso à rede e os limites de efeitos colaterais de cada skill — nada disso tem evidência; confirme por conta própria antes de usar.

Primeira tentativa em 3 minutos

Pré-requisitos: Node.js/npx instalado na máquina; um agente que suporte o formato Agent Skills. A documentação oficial oferece duas formas de instalação; aqui recomendamos apenas um caminho principal:

Caminho principal: instalar a skill central via skills CLI

Execute na raiz do projeto:

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

Isso instala apenas a skill guarda-chuva monozukuri-core. Se depois quiser instalar as 12 skills (a guarda-chuva + 11 focadas), a mesma CLI oficial suporta curingas:

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

(A documentação oficial também oferece a instalação como plugin do Claude Code: /plugin marketplace add kuya-egg/Monozukuri seguido de /plugin install monozukuri@monozukuri, que instala todas as 12 skills carregadas sob o namespace monozukuri; este texto não o apresenta como caminho principal.)

Dispare uma tarefa de baixo risco: após a instalação, digite explicitamente $monozukuri-core no agente e dê a ele uma pequena tarefa somente leitura/de análise, por exemplo: "verifique a correção e a simplicidade de uma pequena função seguindo o fluxo craftsmanship". O fluxo de trabalho central é Observe → Understand → Plan → Craft → Verify → Reflect → Kaizen.

Sinais de sucesso: o agente organiza a resposta segundo as sete fases acima, em vez de simplesmente entregar código; as skills focadas se encadeiam na ordem oficial (nemawashi → genchi-genbutsu → kanso → kata → poka-yoke → kodawari → andon → shukka), indicando que todas as skills estão ativas. Atenção: esta skill é voltada a tarefas de código; não há rubrics de rotas separadas para romance/documentos técnicos. Se você der a ela uma tarefa de escrita de texto, as evidências não garantem um fluxo correspondente. $monozukuri-core é apenas a forma explícita de disparo; se ele lê/escreve arquivos, executa comandos ou acessa a rede, a documentação oficial não diz — para a primeira tentativa, escolha uma tarefa sem efeitos colaterais.

Casos de uso

Caso 1: revisão artesanal de uma pequena função Cenário: você quer que o agente examine com cuidado um trecho de código existente. Como iniciar: digite $monozukuri-core em um agente compatível, anexe o código-alvo e peça uma avaliação seguindo o fluxo. Fluxo de trabalho: o Observe → Understand → Plan → Craft → Verify → Reflect → Kaizen da skill guarda-chuva. Resultado esperado: o agente apresenta observações, compreensão, plano e sugestões de verificação por etapas, em vez de reescrever diretamente; se ele pede sua confirmação antes de alterar arquivos, as evidências não dizem — recomenda-se pedir explicitamente apenas análise, sem modificar arquivos.

Caso 2: desenvolvimento completo de uma feature usando a cadeia de skills focadas Cenário: instale todas as skills primeiro (--skill '*' ou via plugin do Claude Code) e depois peça ao agente para desenvolver uma pequena feature. Fluxo de trabalho: as skills focadas se encadeiam na ordem oficial nemawashi → genchi-genbutsu → kanso → kata → poka-yoke → kodawari → andon → shukka, cobrindo o caminho completo da preparação à verificação. Resultado esperado: o agente avança pelas fases de cada skill e entrega os produtos de cada etapa; as formas de disparo de cada skill focada e seus efeitos colaterais específicos não estão detalhados nas evidências — antes de executar, confirme com o agente se cada passo modificará o código.

Limites de uso

• Instalação difere por plataforma: a skills CLI (npx skills add ...) é o caminho universal; na plataforma Claude Code, use /plugin marketplace add + /plugin install monozukuri@monozukuri, que instala todas as 12 skills sob o namespace monozukuri. Não misture os dois nem presuma formas de instalação para outros clientes.
• Forma de disparo: a documentação oficial indica apenas a invocação explícita de $monozukuri-core; a sintaxe de invocação das outras skills não consta nas evidências.
• Efeitos colaterais e pontos de confirmação: esta skill orienta o agente a escrever código, mas as evidências não dizem se ele modificará seus arquivos, executará comandos ou acessará a rede; tudo isso é desconhecido. Na primeira tentativa, prefira tarefas de análise somente leitura e, antes de qualquer alteração, peça ao agente para apresentar o plano primeiro.
• Limitações oficiais explícitas: instalado sozinho, monozukuri-core contém apenas o fluxo da skill guarda-chuva; a cadeia completa de skills exige instalar todas as 12. A documentação oficial não informa linguagens suportadas, configurações de idioma, requisitos de rede nem a lista de clientes.
• Informações-chave não confirmadas: comportamento específico de cada skill focada, formas de atualização/desinstalação e termos de uso fora da licença não constam nas evidências; consulte o repositório original antes de usar.