97 lines
7.6 KiB
Markdown
97 lines
7.6 KiB
Markdown
|
---
|
||
|
|
from: pm-auditor
|
||
|
|
to: PM
|
||
|
|
type: 감사
|
||
|
|
subject: 전수 문서·규칙 정합성 감사 (모드 C, PM 영역)
|
||
|
|
priority: high
|
||
|
|
status: 완료
|
||
|
|
created: 2026-04-17
|
||
|
|
---
|
||
|
|
|
||
|
|
# 전수 감사 보고 — 문서·규칙 정합성 (PM 영역)
|
||
|
|
|
||
|
|
**범위**: 루트 CLAUDE.md · SKILL.md · settings.json · PD 지시 로그 2종 · 조직운영 대화로그 · 조직공지 · memory · scripts
|
||
|
|
**방법**: 실측 기반 (Read/Grep/ls). 발견 없는 축은 "발견 없음" 명시. 허위 보고 없음 확인.
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## A. 불필요 (실효·폐기 잔존) — 4건
|
||
|
|
|
||
|
|
**A1. [Critical] 루트 CLAUDE.md 최상단 블록 전면 시대착오**
|
||
|
|
- 경로: `CLAUDE.md` L33~L49
|
||
|
|
- 근거: (가) "C1~C26" 표기 — 현재 C31까지 존재. (나) "P1~P20" — 현재 P28까지 존재. (다) C17 본문 요약 잔존("**C17** 세션 이동 복사 명령어 동봉") — 2026-04-16 폐기. (라) "**C18** 조직 공유 완료 판정 (main 병합 + **대상 세션 도달**)" — 2026-04-16 "대상 세션 도달" 개념 소멸. (마) "**C24** 부서 세션 영속 대화 운용" — 현 C24는 "단일 세션 운용 원칙"으로 재정의. (바) "**C26** 코어룰 변경 시 에이전트 정의 파일 동시 갱신 의무" — 현 C26은 "단일 SOT 갱신 원칙"(동시 갱신 폐지, Skill 자동 주입)
|
||
|
|
- 제안: CLAUDE.md 최상단 요약 블록을 삭제하거나 SKILL.md 참조 1줄로 축약. C14-4 참조 무결성 위반이며, 특히 폐기된 C17·구 C24·구 C26을 요약으로 노출하여 세션 리더 오해 유발 위험
|
||
|
|
|
||
|
|
**A2. [Major] SKILL.md 내부 폐기 P20 참조 6개소 잔존**
|
||
|
|
- 경로: `.claude/skills/너드나비스-코어룰/SKILL.md`
|
||
|
|
- 근거: L294(단일 SOT 절 "+`공유/일일보고/`"), L299(공유 채널 분리 "P20"), L315·L317(구체 절차 P20 참조), L326·L386(C20-1 "일일보고" 잔존), L590(P9 모니터링 4단계 "일일 보고 확인"), L1206~L1208(부록 A3 "P20 의무" 섹션 통째로 잔존)
|
||
|
|
- 제안: P20 본문(L743)은 폐기 표시 유지하고 위 6개소 참조를 P24로 갱신 또는 삭제. 특히 L1206~L1208 부록 A3는 "세션 종료 시 일일보고 작성" 의무 서술로 살아있어 다음 세션 리더 혼선 위험 최대
|
||
|
|
|
||
|
|
**A3. [Minor] SKILL.md 다른 위치 잔존 구 표기**
|
||
|
|
- 경로: 동 SKILL.md
|
||
|
|
- 근거: (가) L3 frontmatter description "C1~C26 + P1~P20" — 실제 C31/P28. (나) L165 "공통_업무_규칙.md 의 C1~C13" — 본 파일 자체가 SOT이며 `공통_업무_규칙.md`는 실존하지 않음(실측 MISSING). (다) L1191 부록 A1도 동일 참조. (라) L205 "공통_업무_규칙.md"도 참조 잔존. (마) L1363 "P1~P20"
|
||
|
|
- 제안: description 라벨 갱신 + 공통_업무_규칙.md 참조 4개소 전부 "본 SKILL.md" 또는 직접 참조로 정정
|
||
|
|
|
||
|
|
**A4. [Minor] 공유/README.md 일일보고 섹션**
|
||
|
|
- 경로: `공유/README.md` L18·L34·L78
|
||
|
|
- 근거: P20 폐기 완료됐으나 README 구조도·type 리스트·섹션 설명에 "일일보고" 3개소 잔존
|
||
|
|
- 제안: 폴더 구조 다이어그램에서 제거하고 "일일보고/ (폐기, 역사 아카이브)" 1줄 주석으로 축소
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## B. 중복 (C14-4 위반) — 2건
|
||
|
|
|
||
|
|
**B1. [Major] 부록 A (SKILL.md L1175~L1210)와 C10-1 본문 중복**
|
||
|
|
- 경로: SKILL.md L1175~L1210 부록 A1·A2·A3
|
||
|
|
- 근거: A1 본문이 C10-1(L162~L172) 4단계와 실질 동일 중복. A2는 P19 A2와 중복. A3는 P20 폐기 상태에서 잔존(A2 중복 참고)
|
||
|
|
- 제안: 부록 A 통째 삭제 또는 "C10-1·P19 참조" 1줄로 축약 (신설 근거였던 "부서별 CLAUDE.md 중복 방지"는 단일 세션 구조에서 의미 상실)
|
||
|
|
|
||
|
|
**B2. [Minor] C20-1 vs C20-1-A 상태 정의 중복 느낌**
|
||
|
|
- 경로: SKILL.md L323~L366
|
||
|
|
- 근거: C20-1(재량 범위)과 C20-1-A(공유·push 시점)가 2개의 소절로 분리되어 있으나 C20-1-A가 C20-1의 적용 조건을 사실상 덮어쓰고 있음. C20-1은 "커밋 재량" 1줄만 남고 핵심은 C20-1-A에 있어 가독성 저하
|
||
|
|
- 제안: C20-1에 C20-1-A 요지 1줄 삽입 또는 병합 재구조화 (Improvement로도 분류 가능)
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## C. 상충 (규칙 간 충돌·최근 개정 미반영) — 3건
|
||
|
|
|
||
|
|
**C1. [Critical] P19 "단일 SOT" 절과 P24·P27 충돌**
|
||
|
|
- 경로: SKILL.md L294 "**단일 SOT** — `공유/PD_지시_트래킹/{부서}_PD_지시_로그.md` + `공유/일일보고/`로 일원화"
|
||
|
|
- 근거: P20 폐기 후 P24(대화로그)가 일일보고 대체. 그러나 C13 본문의 P19 참조 절은 여전히 "일일보고로 일원화"로 단정. P27-4 SOT 경계표와 정면 충돌(P27-4는 대화로그·결정로그·소통·조직공지·memory/feedback 분리 SOT 명시)
|
||
|
|
- 제안: L294 문구를 "PD 지시 로그(P19) + 대화로그(P24) + 소통(본 디렉토리) 목적별 분리 SOT"로 수정. P27-4 표 참조 링크
|
||
|
|
|
||
|
|
**C2. [Major] 기획팀 #3 산출물 경로 무효 참조**
|
||
|
|
- 경로: `공유/PD_지시_트래킹/기획팀_PD_지시_로그.md` L41
|
||
|
|
- 근거: 산출물에 `공유/조직공지/2026-04-14_작업착수전_HOLD공지_전수확인_의무화.md` 참조. 실측 — 해당 파일은 조직공지 폴더에 실존함(확인됨). 단, 해당 파일이 "Phase 3 HOLD" 자체가 아니라 일반 HOLD 공지 의무화 문서이므로 #3 "Phase 3 보류" 근거 문서로 적합한가 의문. 2026-04-17 현재 Phase 3 HOLD 자체를 규정한 `🛑_*` 파일이 있는지 불명확
|
||
|
|
- 제안: PM이 Phase 3 HOLD SOT가 현재 어느 문서인지 검증하고 #3 산출물 경로 갱신 (허위 단정 회피를 위해 "검증 필요"로만 제시)
|
||
|
|
|
||
|
|
**C3. [Minor] 조직공지 폐기 영역 미표시**
|
||
|
|
- 경로: `공유/조직공지/2026-04-15_C17_핵심규칙_신설_세션이동_복사명령어_동봉.md`, `2026-04-15_C17-3_보강_진입절차_3요소_의무.md`, `2026-04-15_안건_축2_워크트리_에이전트_자동동기화.md`, `2026-04-15_Phase3_NAS_post_receive_설치가이드.md`
|
||
|
|
- 근거: C17 폐기(2026-04-16)·워크트리 구조 폐기(C24 단일 세션 전환) 이후에도 공지 파일 내부에 "폐기됨" 표시 없음. 특히 Phase3 NAS 가이드는 "완료" 상태로 보이나 상위 Phase 3는 현재 보류 중 — 혼선 여지
|
||
|
|
- 제안: 공지 파일 상단에 `> ⚠️ 2026-04-16 상위 규칙 폐기로 실효` 1줄 주석 추가 (C6 원본 보존하되 실효 표시)
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 발견 없음 축
|
||
|
|
- settings.json hook 배치 — C20-1-A·P25·P27-5 체계와 정합, deny 규칙 적절 (Bash rm:* 차단 + PowerShell Remove-Item 대체 경로 제공)
|
||
|
|
- scripts/ 디렉토리 — 폐기 스크립트 잔존 없음 (nas_post_receive.sh는 Phase 3 보류 중이나 외부 가동 자산이므로 보존 타당)
|
||
|
|
- memory/feedback_* 18종 — 중복·모순 패턴 발견 없음
|
||
|
|
- dev-auditor·plan-auditor·기획팀·개발팀 영역 — **본 감사 범위 외** (해당 감사관·감사 보고에서 별도 다뤄야 함, pm-auditor 월권 회피)
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 우선순위 요약
|
||
|
|
- **Critical 2건**: A1 (루트 CLAUDE.md 최상단 구 C17/C18/C24/C26 요약), C1 (P19 "일일보고 일원화" P24·P27 충돌)
|
||
|
|
- **Major 2건**: A2 (SKILL.md P20 참조 6개소), B1 (부록 A 중복), C2 (기획 #3 산출물 검증 필요)
|
||
|
|
- **Minor 3건**: A3 (frontmatter·공통_업무_규칙.md 4개소), A4 (공유/README 3개소), C3 (폐기 공지 미표시)
|
||
|
|
- **Improvement 1건**: B2 (C20-1/C20-1-A 병합 검토)
|
||
|
|
|
||
|
|
## PM 집행 권고
|
||
|
|
- Critical 2건 즉시 Edit 집행 권고. C14-4 참조 무결성·세션 리더 맥락 복원 직접 영향
|
||
|
|
- Major 3건 일괄 처리 1커밋 권고 (C20-1 팀장 재량 범위 내 md 수정, C28 무승인 적용)
|
||
|
|
- Minor·Improvement는 PD님 확인 후 일괄 적용
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
**허위 보고 없음 선언**: 본 보고 모든 항목은 실측 Read/Grep 결과 기반. 의심만 있는 C2는 "검증 필요" 태그 부착. 발견 없는 축(settings.json·scripts·memory) 은폐 아닌 정합 확인 결과.
|