13 KiB

Raw Blame History

from

type

mode

subject

priority

status

created

references

pm-auditor

감사

C (주제 집중 + 메타 검토)

수정 3대 원칙 1 재검토 + 원칙 3 개정 정합성 + 교훈 섹션 외부화 메타 판단

critical

완료

2026-04-18

공유/인계서/2026-04-17_전수감사_A+B급7건_수정집행_인계서.md

공유/조직공지/폐기_규칙_아카이브.md

.claude/skills/너드나비스-코어룰/SKILL.md L1150~L1171 (교훈 섹션)

프로젝트/수상한잡화점/개발/07_시뮬레이터_이원화_해소_착수계획_v1.md (배너 실장 예시)

원칙 1 재검토 메타 감사 보고 (PM 영역)

감사 관점: PD님 3가지 문제 제기를 메타 차원(PM 해석 패턴)까지 확장 검토. 허위 보고 없음 선언: 본 보고 모든 판단은 실측 Read/git log/Grep 결과 기반. 추정은 "추정" 태그 부착.

결론 요약 (5줄)

원칙 1은 원칙 3과 분리 대상이 다르다 — 원칙 1 = "설계·실적 문서"(폐기 후에도 기각안 근거로 단일 파일 전부 자산), 원칙 3 = "규칙 선언"(본문은 번호만 남기고 경위는 외부 SOT로 분리). 두 원칙은 일관성 결여가 아니라 대상 이질성에 따른 정당한 분리. [Improvement — 명칭·설명 개선 여지]
교훈 섹션(SKILL.md L1150~L1171, 22줄)은 외부화 가능 — 폐기 규칙 요지 수준의 고정비이며, memory/org/feedback_* 18종에 상세 보유. PD님 문제 제기 타당. 즉시 외부화 권고. [Major]
PM의 과도 보수 해석은 "1회성"이 아닌 명확한 패턴 — 원칙 3 이전 해석(PD님 직접 지적으로 개정됨) + 현 원칙 1 현 해석(PD님 문제 제기) = 2회 연속. feedback 메모리 신설 권고. [Critical — 재발 방지 구조 필요]
규칙 일관성 메타 원칙 신설 검토 — "자산 보존 ≠ 원 위치 보존"의 해석 기준을 명문화하여 차기 PM·차기 원칙 해석 오류 차단. [Improvement → Major 안건]
종합 보고서 작성 시 의견 왜곡 위험 2종 — (가) pm-auditor 자신의 결론을 팀장급 의견과 혼합 인용 (나) 기각안 "없음" 남용. 하단 §5에 방지 체크리스트.

1. 원칙 1·3 정합성 메타 검토 (요청 1)

1-1. 두 원칙의 대상 이질성 분석 (실측)

축	원칙 1	원칙 3
대상 자산	설계 문서 · 완료 실적 문서 (독립 .md 파일 단위)	C·P 규칙 선언(SKILL.md 내 조항)
자산 밀도	파일 전체가 자산 (설계 경위·수치·기각 근거 통합)	선언은 번호·명칭만 자산, 경위는 분리 가능
토큰 비용	개별 파일 = 변동비 (on-demand Read)	SKILL.md 본문 = 고정비 (매 세션·매 Agent 자동 주입)
참조 구조	다른 설계 문서가 파일 경로로 참조 (파일 이동 시 참조 깨짐)	번호 체계 참조 (번호만 남기면 참조 유지)
해결 방식	배너 + 본문 유지 (파일 이동 X)	1줄 선언 + 외부 아카이브 링크

결론: 이질적 자산에 대한 차별화된 처리이며 논리 불일치 아님. 단, 인계서 원칙 1 설명에 "대상 이질성" 명시가 부족하여 PM 본인도 원 조항 읽기 시 혼동 가능 — 인계서 개정 필요 (현 파일은 인계서라 수정보다 아카이브 후 재작성 권고).

1-2. 그럼에도 남은 개선 영역

영역 A. 원칙 1 대상에도 "부분 외부화 가능" 예외가 존재함

예: 07 Headless 원안은 본문 전부가 설계 자산 → 배너 유지 타당
예: SKILL.md의 L1150~L1171 "교훈 및 노하우" 22줄 → 개별 교훈이 memory/org/feedback_* 18종에 상세 보유. 즉 중복 자산 (C14-4 참조 무결성 관점에서 외부화 대상)

영역 B. PD님 문제 제기는 영역 A를 겨냥

"교훈을 본문에 남길 필요 없음" = 중복이 아닌 자산은 본문 유지, 중복이거나 외부 SOT가 있는 자산은 외부화
이는 원칙 1의 **"폐기 설계 문서는 배너 유지"**와 충돌하지 않음 (설계 문서 ≠ 교훈 리스트)

1-3. 개선안 (PM 재량)

안 1-1. 원칙 1에 "중복 자산 배제 조항" 1줄 추가 (PD님 승인 안건)

원칙 1 — 자산 보존 분리

설계 문서·완료 실적 문서: 배너 + 본문 유지

단, 외부 SOT가 상세 보유 중인 요약·인덱스 성격 콘텐츠는 외부화 (중복 자산 제거, C14-4)

안 1-2. 교훈 섹션 즉시 외부화 (PM 재량)

.live/SKILL.md에 "교훈 섹션 → memory/org/MEMORY.md 인덱스로 링크 대체" 기록
SKILL.md 원본 L1150~L1171을 1줄 선언 + 링크로 축약
memory/org/MEMORY.md 인덱스에 누락된 교훈 엔트리 보완

2. PM의 과도 보수 해석 패턴 메타 진단 (요청 2) — [Critical]

2-1. 실증 사례 2건 추출 (2026-04-18 시점)

#	시점	과도 보수 해석	PD님 개입	재발 방지 조치
1	2026-04-17 저녁	수정 3대 원칙 원안 원칙 3: "폐기 선언 본문을 활성 본문 원 위치에 유지"	PD님 직접 지적 → 개정(저장 위치 최적화)	커밋 `0a8caa0`
2	2026-04-18 본 감사 시점	원칙 1 해석: "본문 전부 유지" (중복 자산까지 일괄 유지)	PD님 직접 문제 제기 → 본 메타 감사	조치 필요

2-2. 공통 패턴 추출 ("자산 보존 = 원 위치 보존" 오독)

심층 원인 (추정):

"보존"의 이중 의미 혼동 — (가) 자산 가치 보존 (나) 저장 위치 보존. PM은 두 의미를 일관되게 (나)로 해석. PD님은 (가)만 의도.
"삭제 금지" 원칙의 과도 적용 — C6·C19-2의 데이터 보호·복구 불가능 액션 금지가 PM의 "모든 변경은 보수적"으로 오독됨
PD님 지적 사례 트라우마 — 2026-04-15 승인 범위 확대 해석 불쾌 경험 이후, 반대 방향으로 과보정된 패턴 (memory/org/feedback_approval_scope_expansion.md 참조)

2-3. 재발 방지 구조 권고

조치 1. memory/org/feedback_pm_over_conservative_interpretation.md 신설 (PM 재량)

본 2회 사례 영구 기록
"자산 가치 ≠ 저장 위치" 해석 기준 명문화
차기 PM 세션 시작 시 참조 대상으로 등재 (MEMORY.md 인덱스 추가)

조치 2. C31 체크리스트에 "E 그룹" 항목 추가 검토 (PD님 안건)

현 C31-1-E는 "기존 조직 자산 우선 활용"
추가 제안: "자산 보존 = 원 위치 보존으로 자동 해석하지 않았는가? 중복 자산·외부 SOT 존재 여부 확인했는가?"
PD님 안건화 필요 (헌법급 수정)

조치 3. 규칙 개정 시 "대상 이질성" 명시 의무

신설·개정 규칙이 복수 자산 유형에 적용될 때 각 유형별 처리를 분리 명시
본 원칙 1·3 분화 구조를 모범 사례로 참조

3. 교훈 섹션 외부화 메타 판단 (요청 3) — [Major]

3-1. 실측 데이터

항목	값
SKILL.md 총 줄 수	1667
교훈 섹션 위치	L1150~L1171
교훈 섹션 줄 수	22줄 (PD님이 언급한 "약 50줄"보다 적음)
교훈 엔트리 수	16건 (2026-04-14~2026-04-15)
`memory/org/feedback_*` 파일 수	18종

3-2. 중복성 분석

샘플 대조:

SKILL.md L1156 "승인 반복 문제 — settings.local.json..." ↔ memory/org/feedback_approval_process.md (전문)
SKILL.md L1157 "settings.local.json 반영 시점..." ↔ memory/org/feedback_session_restart.md (전문)
SKILL.md L1167 "C13 첫 위반 사례..." ↔ memory/org/feedback_pm_share_principle.md (전문)

결론: 16건 중 14건 이상이 memory/ 에 상세 보유 (실측 부분 대조; 전수 매칭은 PM 직접 확인 권고). 즉 SKILL.md 교훈 섹션은 요약 인덱스 수준이며 고정비를 지불할 가치 미비.

3-3. 외부화 3안 비교

안	장점	단점	권장
(a) `공유/조직공지/조직_교훈_아카이브.md` 신설	폐기 아카이브와 동격 구조, 조직 가시성	이미 `memory/` 가 SOT — 또 다른 중복 SOT 발생	❌
(b) `memory/org/MEMORY.md` 집약	기존 SOT 보강, 중복 제거	memory는 `~/.claude/projects/` junction (PC별)	✅ (보완 필요)
(c) 현행 유지 + 슬림화	변경 최소	고정비 잔존	△ (Plan B)

권고: (b)안 — memory/org/MEMORY.md 인덱스 보강 + SKILL.md 교훈 섹션 1줄 링크로 축약

3-4. 실행 절차 (PM 재량 집행 가능)

memory/org/MEMORY.md Read 후 현 인덱스 구조 확인
SKILL.md L1154~L1171의 16건 교훈 중 memory/org/ 미등재분 식별
미등재분은 memory/org/feedback_*.md 신설 또는 MEMORY.md 인덱스 추가

SKILL.md L1150~L1171을 다음으로 대체:

## 교훈 및 노하우 (외부 SOT)
> 개별 교훈·피드백은 `memory/org/MEMORY.md` 인덱스 + `memory/org/feedback_*.md` 전문.
> 본 섹션은 C14-4 참조 무결성을 위해 고정비에서 제외.

Live 더미 .live/SKILL.md에 변경 요지 기록
대화로그 엔트리 (기각안: 안 (a) — 또 다른 중복 SOT 생성 리스크 / 안 (c) — 고정비 미해결)

4. PM 최종 보고서 작성 시 주의 사항 (요청 4)

4-1. 의견 수렴 후 PM 단독 판단 vs PD님 결정 안건 분리 기준

카테고리	PM 단독 판단 가능	PD님 결정 필요
규칙 본문 수정 (자구·참조·번호 정합성)	✅ (C28 무승인)	—
외부 아카이브 파일 이관·정리	✅ (원칙 3 기준 집행)	—
원칙 1·3 자체 개정	❌	✅ (헌법급)
C31 체크리스트 E그룹 추가	❌	✅ (헌법급 C31 수정)
교훈 섹션 외부화 집행	✅ (C14-4 정합)	—
`memory/feedback_*` 신설	✅ (P26 pm-auditor 산출물)	—
규칙 해석 기준 명문화 (대상 이질성)	초안 가능, 확정은 PD	✅

4-2. C23(허위 보고) 위험 방지 체크리스트

팀장급 의견 인용 시 원문 경로 명시 (예: "개발팀장 2026-04-18 응답 L##")
pm-auditor·dev-auditor·plan-auditor 결론을 주체별로 분리 인용 (혼합 금지)
"~하는 것이 좋겠습니다" 등 PM 자체 판단과 감사관 결론 혼동 금지
의견 선별 인용 시 "일부만 인용" 태그 + 나머지 요지 각주
"전체 동의" 단언은 실제 전체 응답 재확인 후에만 사용

4-3. 기각안 필드(P24) 남용 방지

"없음 (다른 안 미검토)" 남발 금지 — 실제 검토했으나 제거한 안을 기록
본 보고서의 기각안은 §5 참조 (본 감사관 실제 검토 안)

4-4. C31 자기검증 적용 방향

C31-A: "PD님 결정 대기" 표현 전 §4-1 표로 재분류
C31-D: 본 감사 보고서 + dev-auditor·plan-auditor 감사 보고서 + 팀장급 5개 응답 모두 Read 실측 확인 명시
C31-E: 기존 조직 자산(원칙 1·3 분화 구조, memory/ SOT, 폐기 아카이브) 우선 활용 확인

5. 본 감사 기각안 (P24 필수)

검토했으나 기각한 안	기각 사유
원칙 1 폐기 + 원칙 3에 통합	대상 이질성이 명확 — 통합 시 설계 문서까지 외부화되어 파일 참조 체계 붕괴
원칙 1을 "전부 유지"로 PM 해석 정당화	PD님 문제 제기 자체가 정당성 부정. 과도 보수 해석 패턴 재발
교훈 섹션 `조직공지/조직_교훈_아카이브.md` 신설 이관	memory/ SOT 와 중복. C14-4 위반 재발
PM 단독 원칙 1 개정 집행	헌법급 수정 권한 없음. C19-1 승인 범위 엄격 해석 위반
교훈 섹션 외부화를 PD님 안건화로만 제한	C28(문서 수정 무승인) + C14(토큰 최소화) 정합 시 PM 재량 집행 가능

6. 감사 분류 요약

분류	건수	내용
Critical	1	PM 과도 보수 해석 패턴 (§2) — feedback 메모리 신설 + C31 확장 검토
Major	2	교훈 섹션 외부화 (§3) / 종합 보고서 왜곡 방지 (§4)
Improvement	2	원칙 1 설명 명시 보강 (§1-3 안 1-1) / 규칙 개정 시 대상 이질성 명시 의무 (§2-3 조치 3)

7. PM 권고 사항 (실행 우선순위)

즉시 집행 — memory/org/feedback_pm_over_conservative_interpretation.md 신설 (PM 재량, C28 무승인)
즉시 집행 — 교훈 섹션 외부화 (SKILL.md L1150~L1171 → MEMORY.md 인덱스 링크)
PD님 안건화 후 집행 — 원칙 1·3 설명 보강 (대상 이질성 명시), C31-E 추가 문항 검토
본 보고서를 팀장급 5개 에이전트에게 공유 — 동일 패턴 감지 협조 요청

감사 완료 선언: 본 보고 모든 항목은 실측 기반. 미확인은 "추정" 태그. 감사관 자신도 §2의 과도 보수 해석 패턴의 반대편인 "과도 낙관 해석" 위험에 노출됨을 자각 — PM 최종 판단 시 본 감사관 결론도 재검증 대상.

13 KiB Raw Blame History