작업 방식: PDCA 사이클

모든 작업은 PDCA(Plan-Do-Check-Act) 사이클로 진행한다.

┌─────────────────────────────────────────────────────────┐
│                      PDCA Cycle                         │
├──────────────┬──────────────────────────────────────────┤
│ Plan         │ Claude Code와 상의하여 계획 수립         │
│              │ → 확정된 계획은 TodoWrite로 기록          │
├──────────────┼──────────────────────────────────────────┤
│ Do           │ Todo에 기록된 계획대로 단계적 실행        │
│              │ → 각 단계 완료 시 Todo 상태 업데이트      │
├──────────────┼──────────────────────────────────────────┤
│ Check        │ 작업 결과물은 Kay(김경호)가 검증          │
│              │ → 피드백 제공                            │
├──────────────┼──────────────────────────────────────────┤
│ Analyze/Act  │ 결과물 분석 후 다음 계획 수립            │
│              │ → 개선점 반영하여 다음 PDCA 시작          │
└──────────────┴──────────────────────────────────────────┘

Plan 단계 규칙

• 작업 시작 전 반드시 계획을 세우고 사용자와 합의
• 계획이 확정되면 TodoWrite 도구로 할 일 목록 기록
• 복잡한 작업은 작은 단계로 분해하여 기록

Do 단계 규칙

• Todo 목록의 순서대로 작업 진행
• 현재 작업 중인 항목은 in_progress 상태로 표시
• 완료 즉시 completed로 상태 변경 (배치 처리 금지)

Check 단계 규칙

• Claude가 작업한 모든 결과물은 Kay가 검증
• 검증 전까지는 다음 작업 진행하지 않음 (명시적 승인 필요 시)
• 피드백 반영하여 수정

Analyze/Act 단계 규칙

• 완료된 작업을 분석하여 다음 계획에 반영
• 발견된 이슈나 개선점 기록
• 다음 PDCA 사이클 시작

Claude Code 사용 규칙

코드베이스 분석 원칙

절대 규칙: 추측 금지

• Context 제한이나 token exceed로 일부만 읽고 추측하지 않는다
• 모든 문서와 코드는 완전히 읽고 이해한 후 작업한다

대규모 코드베이스 분석 시 필수 사용 기능

1. Task 병렬 처리

   • 여러 파일/디렉토리 분석 시 Task 도구로 병렬 실행
   • 독립적인 분석 작업은 동시에 수행

2. Sub Agent 활용

   • subagent_type=Explore: 코드베이스 탐색, 구조 파악
   • subagent_type=Plan: 복잡한 작업 계획 수립
   • subagent_type=general-purpose: 다단계 복합 작업

3. 분할 읽기

   • 큰 파일은 offset과 limit 파라미터로 분할 읽기
   • 전체 내용 파악 후 분석 진행

금지 사항

❌ 파일 일부만 읽고 전체를 추측하여 작업
❌ 토큰 제한으로 생략하고 넘어가기
❌ 확인 없이 코드 구조 가정하기
❌ 사용자 확인 없이 대규모 변경 진행

필수 사항

✅ 모든 관련 파일을 완전히 읽고 분석
✅ 불확실한 부분은 사용자에게 질문
✅ 변경 전 영향 범위 파악
✅ 작업 진행 상황을 Todo로 추적

작업 방식: PDCA 사이클

모든 작업은 PDCA(Plan-Do-Check-Act) 사이클로 진행한다.

┌─────────────────────────────────────────────────────────┐
│                      PDCA Cycle                         │
├──────────────┬──────────────────────────────────────────┤
│ Plan         │ Claude Code와 상의하여 계획 수립         │
│              │ → 확정된 계획은 TodoWrite로 기록          │
├──────────────┼──────────────────────────────────────────┤
│ Do           │ Todo에 기록된 계획대로 단계적 실행        │
│              │ → 각 단계 완료 시 Todo 상태 업데이트      │
├──────────────┼──────────────────────────────────────────┤
│ Check        │ 작업 결과물은 Kay(김경호)가 검증          │
│              │ → 피드백 제공                            │
├──────────────┼──────────────────────────────────────────┤
│ Analyze/Act  │ 결과물 분석 후 다음 계획 수립            │
│              │ → 개선점 반영하여 다음 PDCA 시작          │
└──────────────┴──────────────────────────────────────────┘

Plan 단계 규칙

• 작업 시작 전 반드시 계획을 세우고 사용자와 합의
• 계획이 확정되면 TodoWrite 도구로 할 일 목록 기록
• 복잡한 작업은 작은 단계로 분해하여 기록

Do 단계 규칙

• Todo 목록의 순서대로 작업 진행
• 현재 작업 중인 항목은 in_progress 상태로 표시
• 완료 즉시 completed로 상태 변경 (배치 처리 금지)

Check 단계 규칙

• Claude가 작업한 모든 결과물은 Kay가 검증
• 검증 전까지는 다음 작업 진행하지 않음 (명시적 승인 필요 시)
• 피드백 반영하여 수정

Analyze/Act 단계 규칙

• 완료된 작업을 분석하여 다음 계획에 반영
• 발견된 이슈나 개선점 기록
• 다음 PDCA 사이클 시작

Claude Code 사용 규칙

코드베이스 분석 원칙

절대 규칙: 추측 금지

• Context 제한이나 token exceed로 일부만 읽고 추측하지 않는다
• 모든 문서와 코드는 완전히 읽고 이해한 후 작업한다

대규모 코드베이스 분석 시 필수 사용 기능

1. Task 병렬 처리

   • 여러 파일/디렉토리 분석 시 Task 도구로 병렬 실행
   • 독립적인 분석 작업은 동시에 수행

2. Sub Agent 활용

   • subagent_type=Explore: 코드베이스 탐색, 구조 파악
   • subagent_type=Plan: 복잡한 작업 계획 수립
   • subagent_type=general-purpose: 다단계 복합 작업

3. 분할 읽기

   • 큰 파일은 offset과 limit 파라미터로 분할 읽기
   • 전체 내용 파악 후 분석 진행

금지 사항

❌ 파일 일부만 읽고 전체를 추측하여 작업
❌ 토큰 제한으로 생략하고 넘어가기
❌ 확인 없이 코드 구조 가정하기
❌ 사용자 확인 없이 대규모 변경 진행

필수 사항

✅ 모든 관련 파일을 완전히 읽고 분석
✅ 불확실한 부분은 사용자에게 질문
✅ 변경 전 영향 범위 파악
✅ 작업 진행 상황을 Todo로 추적