/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/의 경우:
- 파일이 없으면 생성
- 범위가 지정된 경우 YAML frontmatter에
paths추가 - 규칙 내용 작성
---
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 {{n}}번째 줄 (제거됨)
MEMORY.md: {{줄 수}}/200줄 남음
이제 패턴이 강제 명령이 되었습니다. Claude는 향후 모든 세션에서 이를 따릅니다.
승격 결정 가이드
승격 대상:
- 자동 메모리에 패턴이 3회 이상 나타난 경우
- Claude를 같은 내용으로 두 번 이상 수정한 경우
- 모든 기여자가 알아야 할 프로젝트 규칙인 경우
- 반복되는 실수를 방지하는 경우
승격하지 말아야 할 경우:
- 일회성 디버깅 노트인 경우 (자동 메모리에 유지)
- 세션별 컨텍스트인 경우 (세션 메모리가 처리)
- 곧 변경될 가능성이 있는 경우 (예: 마이그레이션 중)
- 기존 규칙으로 이미 다루어지는 경우
CLAUDE.md vs .claude/rules/
| CLAUDE.md 사용 대상 | .claude/rules/ 사용 대상 |
|---|---|
| 전역 프로젝트 규칙 | 파일 유형별 패턴 |
| 빌드 명령어 | 테스트 규칙 |
| 아키텍처 결정 | API 설계 규칙 |
| 팀 규칙 | 프레임워크별 주의사항 |
팁
- CLAUDE.md는 200줄 미만으로 유지 — 초과 시 rules/ 사용
- 한 줄에 하나의 규칙이 문단보다 유지보수에 용이
- 개념뿐만 아니라 구체적인 명령어 포함
- 분기마다 승격된 규칙 검토 — 더 이상 관련 없는 규칙은 제거