progressive-disclosure

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 설정
매 세션 자동 적용