| name | add-rule |
| description | 프로젝트의 rules 구조에 새 규칙을 추가합니다. Progressive Disclosure 원칙에 따라 구조화된 규칙 파일을 생성합니다. "규칙 추가", "rule 추가", "새 규칙 만들기" 요청 시 활성화.
|
| argument-hint | [rule-name] [description] |
Add Rule
프로젝트의 .claude/rules/ 디렉토리에 Progressive Disclosure 원칙에 맞는 규칙을 추가합니다.
실행 단계
0단계: 사전 조건 확인
.claude/rules/progressive-disclosure/ 존재 여부 확인.
규칙이 없는 경우 안내:
"Progressive Disclosure 규칙이 설치되어 있지 않습니다.
규칙 작성 가이드를 참고하려면 먼저 설치해주세요:
https://github.com/anthropics/claude-code/tree/main/.claude/rules/progressive-disclosure"
사용자가 설치 후 다시 진행하도록 안내하고 종료합니다.
1단계: 요구사항 수집
사용자 입력에서 다음 정보를 파악합니다. 부족한 정보는 반드시 사용자에게 질문합니다.
| 필수 정보 | 질문 예시 |
|---|
| 규칙 이름 | "규칙 이름을 지정해주세요 (예: typescript, security)" |
| 규칙 목적 | "이 규칙이 무엇을 하나요?" |
| 트리거 상황 | "어떤 상황에서 이 규칙이 활성화되어야 하나요?" |
| 적용 파일 패턴 (선택) | "특정 파일 패턴에만 적용할까요? (예: **/*.ts)" |
2단계: 규칙 유형 결정
[규칙 복잡도 판단]
│
├─ 단순 규칙 (한 파일로 충분) → 단일 파일: rules/rule-name.md
│
└─ 복잡한 규칙 (참조 문서 필요) → 디렉토리: rules/rule-name/
├── AGENTS.md
├── RULE.md
└── references/
판단 기준:
- 상세 예제나 참조 문서가 필요한가?
- 500줄 이하로 작성 가능한가?
3단계: 규칙 생성
단일 파일 규칙
---
description: >
[무엇을 하는지] 규칙.
[언제 활성화되는지] 트리거 키워드 포함.
paths:
- "[패턴]"
---
- [규칙 1]
- [규칙 2]
- [권장 1]
디렉토리 규칙
AGENTS.md (진입점):
# [규칙명] 원칙
> [한 줄 요약]
## 목적
[규칙의 목적 설명]
## 핵심 체크리스트
- [ ] [체크 1]
- [ ] [체크 2]
## 관련 레퍼런스
- [상세 가이드](references/guide.md)
RULE.md (핵심 지침):
---
description: >
[무엇] 규칙.
[언제] 활성화.
paths:
- "[패턴]"
---
[핵심 지침 내용 - 5000 토큰 이하]
4단계: 인덱스 업데이트
.claude/rules/AGENTS.md에 새 규칙 추가:
| [rule-name] | [트리거 상황] | [rule-name/](rule-name/) |
체크리스트
생성 전 확인:
□ description이 "무엇 + 언제"를 설명하는가?
□ name이 소문자/하이픈 규칙을 따르는가?
□ 본문이 500줄/5000토큰 이하인가?
□ paths가 적절한 파일에만 활성화되는가? (선택사항)
□ AGENTS.md 인덱스에 추가되었는가?
상세 가이드
