메뉴
LLM 컨텍스트 윈도우를 효율적으로 사용하는 3단계 정보 로드 원칙. Skills, Agents, Prompts 작성 시 참조. SKILL.md, AGENT.md 작성, 프롬프트 설계, 컨텍스트 최적화 시 활성화.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | progressive-disclosure |
| description | LLM 컨텍스트 윈도우를 효율적으로 사용하는 3단계 정보 로드 원칙. Skills, Agents, Prompts 작성 시 참조. SKILL.md, AGENT.md 작성, 프롬프트 설계, 컨텍스트 최적화 시 활성화. |
정보를 필요한 시점에 필요한 만큼만 로드하여 컨텍스트 윈도우를 효율적으로 사용합니다.
LLM의 컨텍스트 윈도우는 제한된 자원입니다. 모든 정보를 한 번에 로드하면:
Progressive Disclosure는 정보를 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 설정 |
|---|---|
| 매 세션 자동 적용 | user-invocable: false |
| 특정 조건에서만 적용 | description에 트리거 조건 명시 |
| 누락 방지 필요 | core-skills로 그룹화 후 세션 시작 시 트리거 |
변환 예시:
# Before: Rule (rules/code-style.md)
---
description: 코드 스타일 규칙
paths:
- "**/*.ts"
---
# After: Skill (skills/code-style/SKILL.md)
---
name: code-style
description: >
TypeScript 코드 작성 시 적용되는 스타일 가이드.
코드 작성, 리뷰, 리팩토링 시 자동 참조.
user-invocable: false
---
asset-name/
├── AGENTS.md # 진입점 - 개요 (Claude 자동 인식)
├── [TYPE].md # 2단계 - 핵심 지침
├── CLAUDE.md # AGENTS.md 참조 (선택적, 호환성)
└── references/ # 3단계 - 상세 문서
└── *.md
| 파일 | 역할 | 크기 제한 |
|---|---|---|
| AGENTS.md | 진입점, Claude 자동 인식 | 최소화 |
| CLAUDE.md | AGENTS.md 참조 (선택적) | 최소화 |
| SKILL.md / RULE.md / AGENT.md | 핵심 지침 | <5000 토큰, <500줄 |
| references/*.md | 상세 문서, 예제 | 무제한 |
---
name: asset-name # 1-64자, 소문자/숫자/하이픈
description: > # 무엇 + 언제 사용하는지
무엇을 하는지 설명.
어떤 상황에서 사용하는지 트리거 키워드 포함.
---
description만 읽고 "이 자산이 필요한가?"를 판단할 수 있어야 합니다.
# 좋은 예
description: >
코드 리뷰 시 적용되는 품질 기준.
PR 리뷰, 코드 검토, 품질 점검 요청 시 활성화.
# 나쁜 예
description: 코드 리뷰 규칙
자산 작성 시 확인:
□ 1단계: description이 무엇+언제를 명확히 설명하는가?
□ 1단계: name이 디렉토리명과 일치하는가?
□ 2단계: 본문이 5000 토큰 이하인가?
□ 2단계: 하나의 관심사에 집중하는가?
□ 3단계: 상세 내용이 references/로 분리되었는가?
□ 3단계: 참조 경로가 1단계 깊이인가?
각 자산 유형별 상세 적용 방법:
소프트웨어 프로젝트의 소스 코드를 체계적으로 분석합니다. 프로젝트 경로를 입력하면 아키텍처, 데이터 흐름, 설계 패턴, 의존성을 단계별로 파악합니다. 소스 분석, 코드 분석, 리버스 엔지니어링, 아키텍처 분석, 코드베이스 파악 요청 시 활성화.
Claude Code Skill을 생성하거나 기존 스킬을 개선합니다. 스킬 생성, 스킬 수정, SKILL.md 작성, 새 스킬 만들기, 스킬 개선, 스킬 업데이트 요청 시 활성화.
Claude Code Skill을 생성하거나 기존 스킬을 개선합니다. 스킬 생성, 스킬 수정, SKILL.md 작성, 새 스킬 만들기, 스킬 개선, 스킬 업데이트 요청 시 활성화.
CHANGELOG.md에 변경 사항과 담당자를 정리하고 package.json 버전을 올립니다. changelog 작성, 변경 이력 정리, 버전 올리기, 릴리즈 노트, CHANGELOG 업데이트 요청 시 사용.
새 프로젝트를 프레임워크에 맞게 초기화하고 최신 버전과 모범 사례를 적용합니다. 초기화 완료 후 rule-manager 워크플로우를 참조하여 기본 규칙을 자동 생성합니다. 프로젝트 생성, 프로젝트 초기화, 새 프로젝트, project init, scaffold, boilerplate, 프로젝트 시작, 프로젝트 만들기 요청 시 활성화.
Skill 기반의 규칙을 레포지토리에 추가하고 관리합니다. 기존 구조 분석 → 적절한 위치 판단 → 사용자 확인 후 추가. 규칙 추가, 룰 추가, rule 추가, 새 규칙, 컨벤션 추가, 스타일 가이드 추가, 가이드라인 추가 요청 시 활성화.