From 957d29099c3535a97d1dc6b9a9b2e61796d0dacd Mon Sep 17 00:00:00 2001 From: swrring Date: Thu, 16 Apr 2026 09:02:57 +0900 Subject: [PATCH] =?UTF-8?q?docs(agenda):=20Skill=20=ED=8C=A8=ED=82=B9=20?= =?UTF-8?q?=EC=95=88=EA=B1=B4=20=EA=B8=B4=EA=B8=89=20=EC=8B=A0=EC=84=A4=20?= =?UTF-8?q?=E2=80=94=20=EC=BD=94=EC=96=B4=EB=A3=B0=20=EC=9E=90=EB=8F=99=20?= =?UTF-8?q?=EC=A3=BC=EC=9E=85=20=EA=B7=BC=EB=B3=B8=20=ED=95=B4=EA=B2=B0=20?= =?UTF-8?q?(PD=EB=8B=98=20=EC=A7=81=EC=A0=91=20=EC=A7=80=EC=8B=9C)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 2026-04-16 C24·C25·C26 수동 갱신 사이클 후 부서 서브에이전트 인지 실패 실증 - 수동 갱신 방식의 본질적 한계 확정 (5단계 누락 시 불일치, PD님 운영 부담) - Skill 메커니즘으로 단일 SOT → 모든 부서 자동 주입 구조 전환 안건 - 성공 시 C26 폐기·개정 가능 - PD님 결정 3항 대기: 착수 시점·토큰 허용·본격 구축 위임 범위 Co-Authored-By: Claude Opus 4.6 (1M context) --- .../2026-04-16_안건_Skill_패킹_근본해결.md | 143 ++++++++++++++++++ 1 file changed, 143 insertions(+) create mode 100644 공유/조직공지/2026-04-16_안건_Skill_패킹_근본해결.md diff --git a/공유/조직공지/2026-04-16_안건_Skill_패킹_근본해결.md b/공유/조직공지/2026-04-16_안건_Skill_패킹_근본해결.md new file mode 100644 index 0000000..3501d1c --- /dev/null +++ b/공유/조직공지/2026-04-16_안건_Skill_패킹_근본해결.md @@ -0,0 +1,143 @@ +--- +from: 총괄PM +to: PD님 +type: 안건_신설_긴급 +subject: Skill 패킹안 — 코어룰 자동 주입 근본 해결 (C26 수동 갱신 대체) +status: 우선순위_긴급 +priority: urgent +created: 2026-04-16 +ref_event: 2026-04-16 부서 서브에이전트 코어룰 자동 주입 실패 사건 (C24·C25·C26 갱신 후에도 미인지) +parent_cycle: C26 수동 갱신 사이클의 본질적 한계 실증 +--- + +# 안건 — 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항 → 선행 조사 → 보고 → 본격 구축