Kaizen 개선은(는) 무엇을 하나요?
.planning/kaizen/의 분석 결과를 실행 가능한 개선 사항(hook, agent 패치, skill 개선, CLAUDE.md 업데이트 및 자동화 스크립트)으로 변환합니다.
전제 조건: .planning/kaizen/에 분석 결과가 존재해야 합니다(전사 분석 스킬에 의해 생성됨).
개선 유형
각 출력 범주에는 위임 템플릿이 있습니다:
- Hook 생성 — PreToolUse deny/redirect, SubagentStart 컨텍스트 주입, Stop 품질 게이트
- Agent 프롬프트 개선 — @subagent-refactorer를 통한 agent 시스템 프롬프트의 정밀 수정
- Skill 패치 — /plugin-creator:skill-creator를 통해 skill에 누락된 지식 추가
- CLAUDE.md 업데이트 — 프로젝트 전반의 행동 규칙
- 스크립트 자동화 — 반복 수동 워크플로를 스크립트나 skill로 대체
자세한 템플릿과 예시는 개선 템플릿을 참조하세요.
자율 개선 루프(ARL) 지식 베이스 — 레이어 3 구현 세부 사항, 전제 조건 및 연구 종합 — ARL 지식을 참조하세요.
워크플로
flowchart TD
Start([분석 결과 읽기]) --> Parse[빈도와 증거로 안티 패턴 추출]
Parse --> Score[빈도 × 영향으로 점수화]
Score --> Top[상위 결과 선택]
Top --> Type{개선 유형?}
Type -->|반복된 도구 오용| Hook[Hook 생성 — deny/redirect]
Type -->|Agent 행동 문제| Agent[Agent 패치 명령어 세트 생성]
Type -->|지식 격차| Skill[Skill 패치 명령어 세트 생성]
Type -->|프로젝트 전반 문제| Claude[CLAUDE.md 추가 항목 생성]
Type -->|수동 워크플로| Script[자동화 제안 생성]
Hook --> Output[.planning/kaizen/improvements/에 작성]
Agent --> Output
Skill --> Output
Claude --> Output
Script --> Output
Output --> Install{--install 플래그?}
Install -->|예| Apply[Hook를 설정에 작성, 패치 적용]
Install -->|아니오| Draft[검토를 위한 제안으로 남김]
Hook 생성
결과를 읽고 → hook 구성 + 선택적 스크립트를 생성합니다. 각 안티 패턴 유형에 매핑된 패턴, 지침 및 예시는 Hook 패턴을 참조하세요.
위임 프로토콜
개선 사항은 전문 agent를 위한 명령어 세트이지 직접 수정이 아닙니다. 결과 중심 위임을 따르세요:
- 증거(세션 ID, 도구 호출, 빈도)와 함께 문제 설명
- 원하는 결과 명시
- 전문 agent가 구현 접근 방식을 결정하도록 함
- 위임 프롬프트에 특정 코드 변경을 절대 지정하지 않음
출력 모드
초안 모드 (기본값)
모든 제안을 .planning/kaizen/improvements/에 마크다운 파일로 작성합니다. 각 파일에는 다음이 포함됩니다:
- 증거가 포함된 결과 요약
- 제안된 개선 사항
- 적절한 전문 agent를 위한 위임 프롬프트
- 우선순위 점수
설치 모드 (--install 플래그)
Hook에만 해당 — .claude/settings.json 또는 hooks/hooks.json에 직접 작성합니다. 다른 개선 유형은 항상 위임 프롬프트를 생성합니다(직접 수정하지 않음).
우선순위 점수
개선 사항의 순위는 다음 기준에 따릅니다:
- 빈도 × 영향 — 세션 전체 발생 횟수 × 발생당 비용
- 자동화 가능성 — hook > 스크립트 > 문서
- 영향 범위 — 프로젝트 전반 > 단일 agent > 단일 세션
- 구현 비용 — hook(분) < CLAUDE.md(분) < skill(시간) < agent(일)