| name | progressive-disclosure |
| description | LLM 컨텍스트 윈도우를 효율적으로 사용하는 3단계 정보 로드 원칙. Skills, Agents, Prompts 작성 시 참조. SKILL.md, AGENT.md 작성, 프롬프트 설계, 컨텍스트 최적화 시 활성화.
|
Progressive Disclosure 원칙
정보를 필요한 시점에 필요한 만큼만 로드하여 컨텍스트 윈도우를 효율적으로 사용합니다.
왜 필요한가
LLM의 컨텍스트 윈도우는 제한된 자원입니다. 모든 정보를 한 번에 로드하면:
- 핵심 내용이 희석됨
- 관련 없는 정보로 성능 저하
- 토큰 비용 증가
Progressive Disclosure는 정보를 3단계로 나누어 필요할 때만 로드합니다.
3단계 로드 모델
| 단계 | 로드 시점 | 토큰 | 내용 |
|---|
| 1단계 | 항상 | ~100 | name, description, 트리거 키워드 |
| 2단계 | 활성화 시 | <5000 | 핵심 규칙, 필수 지침 |
| 3단계 | 요청 시 | 무제한 | 예제, 상세 문서, 스크립트 |
적용 대상
| 대상 | 1단계 | 2단계 | 3단계 |
|---|
| Skills | frontmatter | SKILL.md 본문 | references/, scripts/ |
| Agents | frontmatter | AGENT.md 본문 | references/, hooks |
| Prompts | 역할 정의 | 핵심 지침 | 예제, 참조 문서 |
Rule → Skill 변환
Rule 대신 Skill 사용을 권장합니다.
기존 Rule을 Skill로 변환하면 더 유연하고 강력한 기능을 활용할 수 있습니다.
| Rule 사용 의도 | Skill 설정 |
|---|
| 매 세션 자동 적용 | |