# SKILL 동적 로딩 체계 분할 설계 v1 — 정식 진행 안

> **신설 일자**: 2026-05-07
> **근거**: PD 직접 결정 "A안대로 진행해" — 정식 SKILL 분할 + 동적 로딩 체계 도입
> **선행 PoC**: bt-poc-l1-essential·bt-poc-l2-data-protection 신규 작성 → system-reminder 자동 등록 확증 (Skill 메커니즘 정상 작동)
> **양 팀장 교차 검증**: 기획팀장 (다) 2-2 분리 권고 / 개발팀장 (라) 본문 유지 권고 → PD 절충 결정 = A 분할 채택

---

## 1. 목적

PD 비전 정합 — 토큰·컨텍스트 최적화 극대화. 매 세션 60K SKILL.md 항시 주입 회피 + 작업 영역별 동적 로딩으로 **세션당 ~70-80% 토큰 절감** 달성.

## 2. 3계층 동적 로딩 체계

| 계층 | 내용 | 로딩 방식 | 토큰 추정 |
|------|------|----------|----------|
| **L1 헌법급 상시** | 헌법 1원칙 + 19개 핵심 규칙 + C42-7 자기검증 인덱스 | 모든 agent 자동 주입 (`skills: [bt-foundation]`) | ~7-10K |
| **L2 작업 영역 동적** | 나머지 49-56개 규칙을 8-10개 SKILL로 분류 | description auto-load | 활성 시 5-10K each |
| **L3 메모리 동적** | feedback 메모리 (이미 운영 중 — `recent_feedback_brief.sh`) | 키워드 매칭 환기 | 0 (필요 시 Read) |

## 3. L1 헌법급 SKILL 카탈로그 (19개)

`bt-foundation` SKILL — 모든 agent에 항시 주입.

| 그룹 | 포함 규칙 | 사유 |
|------|---------|------|
| 헌법 제1원칙 | ① ② ③ ④ ⑤ | 조직 비전 |
| **응답 작성 매번 적용** (10) | C1·C2·C3·C5·C9·C23·C42·C44·C45·C46·C47 | 모든 응답 영향 |
| **헌법급 의무 호출** (3) | C13·C32·C33 | 의미 작업 매번 적용 |
| **세션·종결 의무** (2) | C40·C41 | 조직 생명급 |
| **감사·자기검증** (3) | C29·C35·C36·C39 | PM 자율 + 감사 |

**총 19개 + 헌법 제1원칙** = ~7-10K 토큰

## 4. L2 작업 영역 SKILL 카탈로그 (8개)

| SKILL 이름 | 포함 규칙 | 트리거 키워드 |
|-----------|---------|------------|
| `bt-commit-rules` | C18·C19·C20·C28·C30 | commit·push·main·merge·git |
| `bt-task-delegation` | C4·C43·C48·C49·P7·P33 | Task·위임·팀장·호출·delegation |
| `bt-data-protection` | C6·C19-2 | 백업·backup·데이터·테이블·xlsm·csv·프로덕션·롤백 |
| `bt-session-mgmt` | C16·C17·C21·C24·P21·P21-2 | 세션 갱신·세션 공유·sync |
| `bt-pd-tracking` | C27·P19·P28 | PD 지시·활성 지시·현황 보고 |
| `bt-document-mgmt` | C14·C22·C25·C26·C37·P18 | SKILL.md·규칙 변경·문서·커밋 메시지 |
| `bt-c50-token-policy` | C50·P32 | 토큰·분량·과도·맥락 분할 |
| `bt-archive-mgmt` | C14-5·C14-6·폐기 규칙 | 아카이브·archived·폐기·승격 |

**총 8개 + 잠정 부서별 1개 (`bt-planning-fun` P30 — 기획팀 전용)** = 9개

각 SKILL ~5-10K, 작업 시 활성 평균 1-2개 = 작업당 평균 ~10-15K

## 5. 메타 인덱스 SKILL — `bt-index`

L1 함께 항시 로드 (~1K). 모든 SKILL 1줄 색인:

```yaml
name: bt-index
description: BurningTimes 조직 SKILL 카탈로그 인덱스. 어떤 작업에 어떤 SKILL이 활성화되는지 가이드.
```

본문:
```
- bt-foundation (L1·헌법급 19개)
- bt-commit-rules (commit·push·main·merge 영역)
- bt-task-delegation (Task·위임·팀장·호출 영역)
- bt-data-protection (백업·데이터·테이블·프로덕션 영역)
- bt-session-mgmt (세션 갱신·공유 영역)
- bt-pd-tracking (PD 지시·현황 보고 영역)
- bt-document-mgmt (SKILL.md·규칙 변경·문서 영역)
- bt-c50-token-policy (토큰 분량·맥락 분할 영역)
- bt-archive-mgmt (아카이브·폐기 영역)
- bt-planning-fun (P30 재미 우선 — 기획팀 전용)
```

## 6. agent frontmatter 매핑 (14 agents)

### 모든 agent (14)
- `skills: [bt-foundation, bt-index]` — 항시 주입

### 부서별 차등 (기획팀장 권고)
- 기획팀장·6 designer (system·content·level·narrative·balance·ux): `skills: [bt-foundation, bt-index, bt-planning-fun]`
- balance-designer 추가: `skills: [..., bt-data-protection]` 항시 주입
- pm-auditor·dev-auditor·plan-auditor: `skills: [bt-foundation, bt-index]` + L2 모든 SKILL 항시 (감사 영역 — 별도 처리)

## 7. Hook 보강 명세

### 신설 hook 4종

| Hook | 영역 | 트리거 |
|------|------|--------|
| `scripts/skill_trigger_audit.sh` | 작업 영역 매칭 안된 경우 환기 | PostToolUse |
| `scripts/hardboiled_empathy_check.sh` | C45 감정 위로 키워드 차단 | PostToolUse (Edit/Write) |
| `scripts/proactive_inference_check.sh` | C47 관습 되묻기 키워드 차단 | PostToolUse |
| `scripts/c35_obligation_check.sh` | C35 의무 호출 7종 영역 작업 감지 | PreToolUse |

### 기존 hook (강화 영역)
- `auditor_gate.sh` — 결함 1·2·3 패치 적용 (commit `3854395`)
- `c9_2_block.sh` — 일정 표현 키워드 차단 (운영 중)
- `fact_first_check.sh` — C44 팩트 검증 (운영 중)
- `identity_guard.sh` — C46 상용구 차단 (운영 중)

## 8. SKILL.md 본문 처리

### 분할 후 SKILL.md 단일 SOT의 처리

**옵션 1**: SKILL.md 본문 그대로 유지 (역사 보존)
- 신설 SKILL은 본문 발췌·정제
- SKILL.md = 정식 SOT (본문 변경 X)
- 단 토큰 비효율 잔존 (단순 발췌가 아닌 자동 주입에 의존 X)

**옵션 2**: SKILL.md 본문 슬림화 (인덱스 + 외부 SOT 참조)
- 본문 = 헌법 1원칙 + 규칙 1줄 인덱스 (각 규칙 = "L1 또는 어느 L2 SKILL 참조" 1줄)
- 본 PM 권고

**옵션 3**: SKILL.md 폐기 + 신설 SKILL만 SOT
- 위험 ↑ (역사 손실)
- 차기 프로젝트 이식 영향
- 비권고

**PM 권고**: 옵션 2 슬림화 (P29 차기 이식 정합)

## 9. 시험 SKILL 정리

| 시험 SKILL | 정식 SKILL 매핑 | 처리 |
|-----------|--------------|------|
| `bt-poc-l1-essential` | `bt-foundation` | 본문 확장 후 rename |
| `bt-poc-l2-data-protection` | `bt-data-protection` | 본문 확장 후 rename |
| `bt-poc-tester` | — | `git rm` (시험 전용) |
| `scripts/poc_skill_measure.sh` | — | `git rm` |
| `memory/poc_skill_phase2_results.md` | — | 0차 검증 결과 보존 (rename 또는 통합) |

## 10. 진행 Phase 분할

| Phase | 산출물 | 매니페스트 |
|-------|--------|---------|
| **A-1 (본 문서)** | 설계 문서 v1 | `skill_split_phase_a1` |
| A-2 | `bt-foundation/SKILL.md` (L1 19개) | 별도 |
| B | L2 SKILL 8-10개 | 별도 |
| C | `bt-index/SKILL.md` + 부서별 frontmatter 작업 | 별도 |
| D | 14 agent frontmatter 갱신 + hook 4종 신설 + SKILL.md 슬림화 + 시험 SKILL 정리 | 별도 |
| E | 통합 commit + push + 결과 보고 + 운영 측정 메트릭 운영 시작 | 별도 |

각 Phase별 PD 보고 + 진행. 차단 발견 시 즉시 자진 고지.

## 11. 운영 측정 메트릭 (PoC 정량 측정 한계 보완)

PoC 정량 측정은 sandbox 한계로 실측 불가. **운영 후 점진 측정 메커니즘** 도입:

| 메트릭 | 측정 방식 | 목표 |
|--------|----------|------|
| 세션당 시작 토큰 | log 분석 (TBD 자동화) | < 15K (현 60K 대비 75% 절감) |
| SKILL 활성화 정확도 | 헌법급 위반 사례 / 전체 작업 | < 1% (월 분석) |
| 트리거 매칭 정밀도 | 불필요 SKILL 활성 / 활성 총수 | < 10% |
| 분기별 description 튜닝 | 운영 데이터 분석 | 분기 1회 |

## 12. 기각된 옵션·후속 안건

### 기각된 옵션
- **(B) 하이브리드** — 본 분할 진행 결정으로 비채택. 단 향후 효과 미흡 시 fallback 안으로 보존
- **(C) sandbox 정량 측정 후 결정** — 외부 의존, 진행 지연

### 후속 안건
1. Phase B·C·D·E 순차 진행
2. 운영 데이터 수집 메커니즘 신설 (log 분석 자동화)
3. 분기별 description 튜닝 사이클
4. EerieVillage 영향 모니터링 (양 팀장 보수 권고 영역 — 안정 운영 후 점검)

## 13. 변경 이력

| 일시 | 변경 |
|------|------|
| 2026-05-07 본 PM | v1 신설 (PD A안 결정 후) |

---

**참조**:
- C2·C5·C14·C26·C36·C37 (정합 검증)
- 양 팀장 검증 결과 통합 (기획팀장·개발팀장)
- PoC Phase 2 0차 데이터 (Skill 메커니즘 자동 작동 검증)
- 매니페스트 SOT (나) 채택 commit `8519cda` + 결함 3종 패치 (`abe379b`·`3854395`)
