/si:promote — 학습 내용을 규칙으로 승격
Claude의 자동 메모리에서 입증된 패턴을 프로젝트의 규칙 시스템으로 이동하여, 배경 노트가 아닌 강제 명령으로 전환합니다.
사용법
/si:promote <패턴 설명> # 최적 대상 자동 감지
/si:promote <패턴> --target claude.md # CLAUDE.md로 승격
/si:promote <패턴> --target rules/testing.md # 범위 규칙으로 승격
/si:promote <패턴> --target rules/api.md --paths "src/api/**/*.ts" # 경로와 함께 범위 지정
워크플로우
1단계: 패턴 이해
사용자의 설명을 분석합니다. 모호할 경우 다음 중 하나의 명확한 질문을 합니다:
- "Claude가 따라야 할 구체적인 행동은 무엇인가요?"
- "이 규칙이 모든 파일에 적용되나요, 아니면 특정 경로에만 적용되나요?"
2단계: 자동 메모리에서 패턴 찾기
# MEMORY.md에서 관련 항목 검색
MEMORY_DIR="$HOME/.claude/projects/$(pwd | sed 's|/|%2F|g; s|%2F|/|; s|^/||')/memory"
grep -ni "<키워드>" "$MEMORY_DIR/MEMORY.md"
일치하는 항목을 표시하고 사용자가 의도한 것이 맞는지 확인합니다.
3단계: 적절한 대상 결정
| 패턴 범위 | 대상 | 예시 |
|---|---|---|
| 전체 프로젝트에 적용 | ./CLAUDE.md | "pnpm을 사용하고 npm은 사용하지 마세요" |
| 특정 파일 유형에 적용 | .claude/rules/<주제>.md | "API 핸들러는 검증이 필요합니다" |
| 사용자의 모든 프로젝트에 적용 | ~/.claude/CLAUDE.md | "명시적 오류 처리를 선호하세요" |
사용자가 대상을 지정하지 않은 경우, 범위에 따라 대상을 추천합니다.
4단계: 간결한 규칙으로 변환
자동 메모리의 노트 형식에서 CLAUDE.md의 명령 형식으로 학습 내용을 변환합니다:
이전 (MEMORY.md — 설명적):
이 프로젝트는 pnpm 워크스페이스를 사용합니다. npm install을 시도했을 때 실패했습니다. 잠금 파일은 pnpm-lock.yaml입니다. 의존성 설치에는 pnpm install을 사용해야 합니다.
이후 (CLAUDE.md — 규정적):
## 빌드 및 의존성
- 패키지 관리자: pnpm (npm 아님). `pnpm install`을 사용하세요.
변환 규칙:
- 가능하면 한 줄에 하나의 규칙
- 명령형 어조 사용 ("X를 사용하세요", "항상 Y하세요", "절대 Z하지 마세요")
- 개념뿐만 아니라 명령어 또는 예시 포함
- 배경 이야기 없음 — 명령만
5단계: 대상에 작성
CLAUDE.md의 경우:
- 기존 CLAUDE.md 읽기
- 적절한 섹션 찾기 (또는 새로 만들기)
- 올바른 제목 아래에 새 규칙 추가
- 파일이 200줄을 초과하면
.claude/rules/사용 제안
.claude/rules/의 경우:
- 파일이 없으면 생성
- 범위가 지정된 경우
paths가 포함된 YAML 프론트매터 추가 - 규칙 내용 작성
---
paths:
- "src/api/**/*.ts"
- "tests/api/**/*"
---
# API 개발 규칙
- 모든 엔드포인트는 Zod 스키마로 입력을 검증해야 합니다.
- 오류 응답에는 `ApiError` 클래스를 사용하세요 (원시 Error 사용 금지).
- 핸들러 함수에 OpenAPI JSDoc 주석을 포함하세요.
6단계: 자동 메모리 정리
승격 후 MEMORY.md에서 원본 항목을 제거하거나 표시합니다:
# 제거될 항목 표시
grep -n "<패턴>" "$MEMORY_DIR/MEMORY.md"
사용자에게 제거 확인을 요청합니다. 그런 다음 MEMORY.md를 편집하여 승격된 항목을 제거합니다. 이렇게 하면 새로운 학습 내용을 위한 공간이 확보됩니다.
7단계: 확인
✅ {{대상}}으로 승격됨
규칙: "{{변환된 규칙}}"
출처: MEMORY.md {{줄 번호}}번째 줄 (제거됨)
MEMORY.md: {{줄 수}}/200줄 남음
이 패턴은 이제 강제 명령입니다. Claude는 이후 모든 세션에서 이를 따릅니다.
승격 결정 가이드
승격해야 할 경우:
- 패턴이 자동 메모리에 3회 이상 나타난 경우
- 동일한 내용을 두 번 이상 교정한 경우
- 모든 기여자가 알아야 하는 프로젝트 규칙인 경우
- 반복되는 실수를 방지하는 경우
승격하지 말아야 할 경우:
- 일회성 디버깅 노트인 경우 (자동 메모리에 유지)
- 세션별 컨텍스트인 경우 (세션 메모리에서 처리)
- 곧 변경될 가능성이 있는 경우 (예: 마이그레이션 중)
- 이미 기존 규칙으로 다루어지는 경우
CLAUDE.md vs .claude/rules/
| CLAUDE.md는 다음에 사용 | .claude/rules/는 다음에 사용 |
|---|---|
| 전체 프로젝트 규칙 | 파일 유형별 패턴 |
| 빌드 명령어 | 테스트 규칙 |
| 아키텍처 결정 | API 설계 규칙 |
| 팀 규칙 | 프레임워크별 주의사항 |
팁
- CLAUDE.md를 200줄 미만으로 유지하세요 — 초과 시 rules/ 사용
- 한 줄에 하나의 규칙이 단락보다 유지보수에 용이함
- 개념뿐만 아니라 구체적인 명령어 포함
- 분기별로 승격된 규칙 검토 — 더 이상 관련 없는 규칙 제거