8.2 KiB
8.2 KiB
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줄 색인:
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 패치 적용 (commit3854395)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 정량 측정 후 결정 — 외부 의존, 진행 지연
후속 안건
- Phase B·C·D·E 순차 진행
- 운영 데이터 수집 메커니즘 신설 (log 분석 자동화)
- 분기별 description 튜닝 사이클
- 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)