교훈 캡처

목적

작업 중 발견한 실수, 주의사항, 유용한 패턴을 .claude/lessons.md에 기록하여 다음 세션에서 반복을 방지합니다.

카테고리

워크플로우

Step 1: 인수 파싱

사용자 인수를 분석합니다:

• 카테고리: 내용 형식이면 카테고리를 직접 사용
• 카테고리 없이 내용만 있으면 키워드 기반으로 자동 판별:
  • "~하지 마", "금지", "실수" → 실수
  • "조심", "확인", "주의" → 주의
  • "순서", "방법", "패턴", "~할 때" → 패턴
• 판별이 모호하면 AskUserQuestion으로 질문

인수가 비어있으면 AskUserQuestion으로 교훈 내용을 질문합니다.

Step 2: 중복 확인

.claude/lessons.md를 읽고 비슷한 교훈이 이미 있는지 확인합니다.

• 핵심 키워드가 70% 이상 겹치는 항목이 있으면 사용자에게 알림
• 기존 항목을 업데이트할지 새로 추가할지 AskUserQuestion으로 질문

Step 3: 교훈 추가

.claude/lessons.md의 해당 카테고리 섹션에 추가합니다:

형식:

- [YYYY-MM-DD] 교훈 내용

규칙:

• 오늘 날짜를 자동으로 삽입
• 한 줄로 간결하게 작성 (필요하면 — 뒤에 이유 추가)
• 해당 카테고리의 마지막 항목 뒤에 추가

Step 4: 확인

추가된 교훈을 사용자에게 보여줍니다:

교훈이 추가되었습니다:
- 카테고리: {카테고리}
- 내용: {내용}
- 파일: .claude/lessons.md

다음 세션부터 자동으로 컨텍스트에 포함됩니다.

서브커맨드

/lesson list

현재 등록된 모든 교훈을 카테고리별로 보여줍니다.

/lesson clean

오래된(90일+) 교훈이나 중복 항목을 찾아 정리를 제안합니다. AskUserQuestion으로 각 항목의 삭제 여부를 확인합니다.

Related Files