Monozukuri: 일본식 장인정신 절차로 에이전트가 간결하고 검증 가능한 코드를 작성하게 하기

누구에게 적합한가

• 에이전트가 코드를 한 번에 출력하는 대신 검증 가능한 절차(관찰→이해→계획→구현→검증→성찰→개선)를 따르도록 하고 싶은 개발자에게 적합합니다.
• Agent Skills 형식을 지원하는 에이전트 사용자에게 적합합니다: 각 스킬은 최상위 <name>/SKILL.md 디렉터리이며, 공식 설명에 따르면 이 형식을 지원하는 모든 에이전트와 호환됩니다. $monozukuri-core로 명시적으로 호출합니다.
• 적합하지 않은 경우: 근거 자료에 의존하는 구체적인 런타임 버전이 명시되어 있지 않고, 검증된 클라이언트 목록도 없으며, 텍스트/문서류 작업 지원 여부도 언급되지 않았습니다. 이 스킬은 소프트웨어 구축과 유지보수를 대상으로 하며, 근거가 다른 용도를 다루지 않는 한 다른 용도로 가정하지 마십시오.
• 공식적으로 밝히지 않은 사항: 지원 프로그래밍 언어, 네트워크 접근 필요 여부, 각 스킬의 구체적인 부작용 경계는 모두 근거가 없으므로 사용 전에 직접 확인하십시오.

3분 만에 첫 시도하기

전제 조건: 로컬에 Node.js/npx가 있어야 하며, Agent Skills 형식을 지원하는 에이전트를 사용합니다. 공식적으로 두 가지 설치 방법을 제공하지만, 여기서는 한 가지 주 경로만 권장합니다:

주 경로: skills CLI로 코어 스킬 설치

프로젝트 루트에서 실행:

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

이것은 우산 스킬인 monozukuri-core만 설치합니다. 이후 전체 12개 스킬(우산 스킬 + 11개 집중 스킬)을 설치하고 싶다면, 공식의 동일한 CLI가 와일드카드를 지원합니다:

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

(공식은 Claude Code 플러그인 방식의 설치도 제공합니다: /plugin marketplace add kuya-egg/Monozukuri 후 /plugin install monozukuri@monozukuri를 실행하면 전체 12개 스킬이 설치되고 monozukuri 네임스페이스로 로드됩니다. 본문에서는 이를 주 경로로 병렬 나열하지 않습니다.)

저위험 작업 한 번 실행하기: 설치 후 에이전트에 $monozukuri-core를 명시적으로 입력하고, 작은 읽기 전용/분석형 작업을 부여합니다. 예: "craftsmanship 절차에 따라 작은 함수의 정확성과 간결성 검토". 핵심 워크플로는 Observe → Understand → Plan → Craft → Verify → Reflect → Kaizen입니다.

성공 신호: 에이전트가 코드를 바로 던지지 않고 위의 7단계 절차에 따라 답변을 구성하는지 확인합니다. 집중 스킬이 공식 순서대로 연결되면(nemawashi → genchi-genbutsu → kanso → kata → poka-yoke → kodawari → andon → shukka) 전체 스킬이 작동한다는 뜻입니다. 참고: 이 스킬은 코드 작업을 대상으로 하며, 소설/전문 문서용 별도 루브릭 경로는 존재하지 않습니다. 텍스트 작성 작업을 부여할 경우 근거가 대응 절차를 보장하지 않습니다. $monozukuri-core는 명시적 트리거 방식일 뿐이며, 파일을 읽고 쓰는지, 명령을 실행하는지, 네트워크에 접근하는지는 공식적으로 밝히지 않았으므로 첫 시도는 부작용이 없는 작업으로 선택하십시오.

사용 사례

사례 1: 작은 함수의 장인정신적 점검 상황: 기존 코드를 에이전트가 성실하게 검토하게 하고 싶습니다. 실행 방법: 지원 에이전트에 $monozukuri-core를 입력하고 대상 코드를 첨부해 절차에 따른 평가를 요청합니다. 사용하는 워크플로: 우산 스킬의 Observe → Understand → Plan → Craft → Verify → Reflect → Kaizen. 기대 결과: 에이전트가 직접 다시 쓰지 않고 단계별로 관찰, 이해, 계획, 검증 제안을 제공합니다. 파일 변경 전 확인이 필요한지는 근거에 명시되어 있지 않으므로, 분석만 하고 파일을 수정하지 말라고 명확히 요청하는 것이 좋습니다.

사례 2: 집중 스킬 체인으로 전체 기능 개발 상황: 먼저 전체 스킬을 설치한 후(--skill '*' 또는 Claude Code 플러그인 방식), 에이전트에게 작은 기능 개발을 맡깁니다. 사용하는 워크플로: 집중 스킬이 공식 순서대로 nemawashi → genchi-genbutsu → kanso → kata → poka-yoke → kodawari → andon → shukka로 연결되어 준비부터 검증까지 전체 체인을 커버합니다. 기대 결과: 에이전트가 각 스킬의 단계를 진행하며 각 단계의 산출물을 제공합니다. 각 집중 스킬의 개별 트리거 방식과 구체적 부작용은 근거에 상세히 설명되지 않았으므로, 실제 실행 전에 각 단계가 코드를 수정할지 에이전트에게 확인하십시오.

사용 경계

• 설치 방식은 플랫폼별로 다름: skills CLI(npx skills add ...)는 범용 경로입니다. Claude Code 플랫폼은 /plugin marketplace add + /plugin install monozukuri@monozukuri를 사용하며, 전체 12개 스킬이 monozukuri 네임스페이스로 설치됩니다. 두 방식을 혼용하거나 다른 클라이언트의 설치 방식을 추론하지 마십시오.
• 트리거 방식: 공식 설명은 $monozukuri-core 명시적 호출입니다. 다른 스킬의 호출 문법은 근거에 제시되지 않았습니다.
• 부작용과 확인 지점: 이 스킬은 에이전트가 코드를 작성하도록 유도하지만, 파일을 직접 수정하는지, 명령을 실행하는지, 네트워크에 접근하는지는 근거에 명시되지 않았으며 모두 미확인입니다. 첫 시도는 읽기 전용 분석 작업으로 하고, 변경 전에는 에이전트에게 먼저 계획을 보여달라고 요구하십시오.
• 공식의 명확한 제한: monozukuri-core만 단독 설치하면 우산 스킬 절차만 포함됩니다. 전체 스킬 체인에는 12개 스킬 전체 설치가 필요합니다. 공식은 지원 프로그래밍 언어, 언어 환경, 네트워크 요구 사항, 클라이언트 목록을 제공하지 않았습니다.
• 미확인 핵심 정보: 각 집중 스킬의 구체적 동작, 업데이트/제거 방법, 라이선스 외 이용 약관은 근거에서 다루지 않으므로, 사용 전에 저장소 원문을 확인하십시오.