BurningTimesAi/공유/조직공지/2026-04-16_안건_Skill_패킹_근본해결.md

---
from: 총괄PM
to: PD님
type: 안건_완료
subject: Skill 패킹안 — 코어룰 자동 주입 근본 해결 (C26 수동 갱신 대체)
status: 완료
priority: urgent
created: 2026-04-16
completed: 2026-04-16
ref_event: 2026-04-16 부서 서브에이전트 코어룰 자동 주입 실패 사건 (C24·C25·C26 갱신 후에도 미인지)
parent_cycle: C26 수동 갱신 사이클의 본질적 한계 실증
구축_커밋: (본 커밋 SHA 참조)
구축_요약: |
  1. .claude/skills/너드나비스-코어룰/SKILL.md 신설 (공유/공통_업무_규칙.md git mv + frontmatter)
  2. 부서 에이전트 4종(개발실장·기획팀장·서버팀장·클라이언트팀장) frontmatter `skills: [너드나비스-코어룰]` 추가
  3. 부서 에이전트 본문의 코어룰 하드코딩 섹션 폐기, 직무 우선 환기 사항만 유지
  4. 메인 CLAUDE.md(루트·개발실·기획실) @참조 경로 갱신
  5. C26 본문 개정: 수동 갱신 의무 폐지, 단일 SOT 갱신 원칙으로 전환
  6. 활성 참조 파일(pm-general.md·README.md·개발실 commands 8종) 일괄 갱신
  7. 역사 기록(memory·과거 안건)은 C5 정직성상 당시 용어 보존
---

# 안건 — Skill 패킹으로 코어룰 자동 주입 근본 해결

## 1. 배경

### 1) 본 안건이 긴급 안건으로 격상된 이유
2026-04-16 본 사이클에서 다음 사건이 발생:
1. C24·C25 코어룰 신설
2. 수동 갱신(루트 CLAUDE.md + 개발실장.md + 기획팀장.md) 실행
3. C26 신설 (수동 갱신 의무 명문화)
4. 부서 영속 대화에서 merge + 재resume + 서브에이전트 호출 + 암기 테스트
5. **결과: 기획팀장·개발실장 모두 C24·C25 인지 실패** — 수동 갱신·재resume에도 자동 주입 안 됨

→ **수동 갱신 방식의 본질적 한계 확정**. 본 안건이 긴급 우선 처리 대상.

### 2) PD님 명시 지시
2026-04-16: "Skill 패킹 별건 안건 신설해서 근본적인 원인 해결이 가능하도록 조치해"

---

## 2. 문제 정의

### 1) 현재 구조의 결함
1. Claude Code의 `@공유/공통_업무_규칙.md` 자동 주입은 **메인 세션의 CLAUDE.md에만** 작동 (공식 확인)
2. 서브에이전트는 자체 `.claude/agents/*.md` 파일의 system prompt만 받음 (메인 세션 컨텍스트 격리)
3. 서브에이전트가 최신 코어룰을 인지하려면 정의 파일 본문에 코어룰을 **하드코딩**해야 함
4. 코어룰 추가마다 다음 5단계 모두 정확히 수행 필요:
   - 가) 루트 CLAUDE.md 갱신
   - 나) 개발실장.md 갱신
   - 다) 기획팀장.md 갱신
   - 라) main push
   - 1-1) 부서 워크트리 `git merge` + 대화 종료 + 재resume + 호출

### 2) 한계
1. **PD님 운영 부담 과중** — 5단계 누락 시 즉시 불일치
2. **C14(토큰 최소화) 위반 소지** — 같은 정보를 3개 파일에 중복 유지
3. **C24(영속 대화 원칙)와 충돌** — 코어룰 추가마다 강제 재resume
4. **유지보수 자원 낭비** — 매 사이클 갱신 작업

---

## 3. Skill 패킹안 — 본질 해결책

### 1) 핵심 아이디어
공유/공통_업무_규칙.md 를 Claude Code의 **Skill 형식**으로 패키징하고, 부서 에이전트 정의 파일의 frontmatter `skills:` 필드에 등록 → Claude Code가 에이전트 호출 시 자동 주입.

### 2) 예상 구조
```
skills/
└── 너드나비스-코어룰/
    ├── SKILL.md              ← Skill 진입점, 메타데이터
    └── 공통_업무_규칙.md       ← 본문 (현 공유/공통_업무_규칙.md 와 동기 또는 단일화)
```

부서 에이전트 frontmatter:
```yaml
---
name: 기획팀장
description: ...
model: opus
skills:
  - 너드나비스-코어룰
---
```

### 3) 기대 효과
1. 코어룰 추가·변경 시 **단 한 곳(공통_업무_규칙.md)만 갱신** → 모든 부서 서브에이전트 자동 반영
2. C26 수동 갱신 의무 **폐지·간소화** 가능
3. C24(영속 대화) 원칙과 충돌 없음 (재resume 강요 없음)
4. C14(토큰 최소화) 정신 부합 (단일 SOT)

---

## 4. 조사·구축 단계 (제안 순서)

### 1) 선행 조사 (탐색규칙 조사안과 동일 패턴)
1. Claude Code의 Skill 메커니즘 공식 문서 정독
2. `skills:` frontmatter 필드의 정확한 동작 명세 (어떤 파일을 로드? frontmatter 필드 또는 디렉토리 스캔?)
3. 일반 .md 파일을 Skill로 등록 가능한지, 별도 SKILL.md 메타데이터 필요한지
4. Skill 로드 범위 (모든 호출에 자동 vs 트리거 조건 필요)
5. Skill과 메인 세션 CLAUDE.md @참조의 우선순위·중복 처리

### 2) 실증 (소규모 테스트)
1. 임시 Skill 1개 작성 → 부서 에이전트에 등록 → 호출 시 그 Skill 본문이 인지되는지 검증
2. 검증 성공 시 본격 구축으로 진행

### 3) 본격 구축
1. `공유/공통_업무_규칙.md` 를 Skill 형식으로 변환·이전
2. 부서 에이전트(개발실장.md·기획팀장.md) frontmatter `skills:` 추가
3. 검증: 두 부서 세션에서 코어룰 암기 테스트 통과 확인
4. C26 폐기 또는 단순화 (Skill 의무 갱신만 명시)
5. 필요 시 신규 코어룰 (예: C27) 추가해 자동 반영 검증

### 4) 정리
1. 부서 에이전트 .md 의 코어룰 하드코딩 섹션 제거 (Skill 자동 주입으로 대체)
2. 메모리 등재 및 코어룰 정리

---

## 5. 결정 필요 사항

### 1) 착수 시점
1. **즉시** (이번 PM 세션 이어서)
2. 다음 사이클

### 2) 선행 조사 토큰 소비 허용
1. 허용 (claude-code-guide agent 호출 + Skill 공식 문서 fetch + 실증 실험)
2. 제한 (제 자체 지식만)

### 3) Skill 메커니즘 확인 후 본격 구축까지 일관 진행
1. 조사 결과 보고 후 PD님 재승인 받고 본격 구축
2. 자동으로 본격 구축까지 진행 (PD님 위임)

총괄PM 추천:
- 1) **즉시 착수**
- 2) **허용** (이전 탐색규칙 조사안과 동일 패턴, 토큰 소비 정당)
- 3) **조사 후 재승인** (C19 준수, 본격 구축은 되돌리기 어려운 변경 포함)

---

## 6. 연관

- **C26** (코어룰 변경 시 에이전트 정의 파일 동시 갱신 의무): Skill 패킹 성공 시 폐기·개정 대상
- **C24** (영속 대화 원칙): Skill 도입 시 영속 대화에서도 코어룰 자동 갱신 가능 → C24 가치 극대화
- **C14** (토큰 최소화): 단일 SOT로 정보 중복 제거
- **C19-3-4** (자동화 신뢰): Claude Code 공식 기능(Skill) 활용
- 별건 안건: `2026-04-15_안건_축2_워크트리_에이전트_자동동기화.md` 에서 검토했던 5개 후보 중 본 안건은 추가 후보 (직접적 해결책)
- 실증 사건: 2026-04-16 부서 서브에이전트 C24·C25 인지 실패 (스크린샷 기록)

## 처리 이력
- 2026-04-16: 안건 신설·main 반영 (C26 수동 갱신 한계 실증 후 즉시 격상)
- (대기) PD님 결정 3항 → 선행 조사 → 보고 → 본격 구축