16 KiB

Raw Blame History

type	mode	audit_date	auditor	subject	pd_instruction	triggered_by	related_rules
감사보고서	C (주제 집중)	2026-04-18	plan-auditor	수정 3대 원칙의 원칙 1 재검토 + C급 기획 5문서 본문 축약 가능성 + 교훈 섹션 저장 위치	2026-04-18 PD님 직접 — "원칙 1에서 본문 전부 유지 시 낭비되는 측면 재검토. 교훈은 반드시 본문에 남기지 않아도 됨"	PM 재량 위임 (plan-auditor 모드 C 호출)	C14, C17, C26, C30, P18, P24, 헌법 제1원칙 목표 2 원칙 B

원칙 1 재검토 감사 보고 (2026-04-18)

감사 범위: (가) 수정 3대 원칙의 원칙 1(자산 보존 분리) "본문 유지" 조항 재검토 / (나) C급 기획 5문서 본문 축약·외부화 시나리오 / (다) SKILL.md 교훈 섹션 저장 위치 감사 방법: 각 문서 본문 실측 Read + 헌법 제1원칙 목표 2 원칙 B(차기 프로젝트 참고 자료) + C14(토큰 최소화) + C26(코어룰 단일 SOT) 교차 검증 감사 결과 요지: 원칙 1 "본문 유지"는 대부분 유지하되 SKILL.md 교훈 섹션만 외부화 권고. C급 5문서는 본문 그대로 유지 (Phase 3 재개 즉시 실행 자산).

1. 감사 대상 현황 실측

1-1. C급 기획 5문서 규모

문서	라인수	본문 성격	재개 시 활용도
Phase3_재개준비_체크리스트_v1.md	342	Day 1~15+ 실행 로드맵, 선행 의존성, 담당 매핑, 리스크 체크	재개 즉시 참조 (Day별 작업표 원문)
3성조건_12개_상세명세_v1.md	747	조건별 판정 로직 의사코드, 측정 변수, UI 표시, 개발실 구현 요청 초안	재개 즉시 개발 전달 자료
맵패턴_사전분석_v1.md	287	C9 배치 금지·적합 스테이지 실 데이터, 42개 슬롯 검증 틀	재개 즉시 실측 자료
Phase2_카드임팩트측정_v1.md	237	PC6001 앵커 DPS=1.05·EHP=64·TTK=5.7s, 등급별 실측 기여도, G1 5장 -45% TTK 등	고정 실측 SOT — 축약 불가 (수치 소실 위험)
빌드_조건_충돌점검_v1.md	385	빌드 10축 × 조건 12개 = 120조합 충돌 매트릭스 (E/X/SS/S/—)	재개 즉시 밸런스 결정 자료
합계	1,998 라인	—	—

1-2. SKILL.md 규모 분포

구간	라인 범위	바이트 수 추정	성격
활성 규칙 본문 (C1~C31, P1~P28)	L1~L1148	약 140KB	매 세션 자동 주입 (고정비)
교훈 및 노하우 섹션	L1150~L1172 (22개 항목)	약 18KB	매 세션 자동 주입 (고정비) — 감사 대상
부록 A	L1175~ 이후	약 10KB	매 세션 자동 주입 (고정비)
총합	1,667 라인	약 170KB	—

1-3. 각 문서의 "차기 프로젝트 참고 가치" 섹션 식별

문서	본문 내 차기 프로젝트 참고 가치 구간	현 프로젝트 전용 구간
Phase3 체크리스트	§1-1 선행 조건 4종, §5 산출물 명명 규칙, §6 리스크 체크리스트, §8 한계·유효 기간	§2 Day 1~15+ 로드맵 내 "스테이지 번호·카드 등급" 전부
3성조건 12개 명세	§1-2 조건 설계 원칙 4대, §5-1 임계값 관리 원칙, §5-2 판정 공통 요구사항, §5-3 런타임 컨테이너 설계, §6 단위 테스트 매트릭스, §7 개발 요청서 초안 구조	§3·§4 12개 조건 각 정의 (수상한 잡화점 조건 풀 고유)
맵패턴 사전분석	§1-1 P17 규칙 운영 원리, §3-3 42슬롯 검증 체크리스트 틀	§1-2~§1-5 스테이지별 보스 실 데이터
Phase2 카드임팩트	§1 핵심 발견 요약 "양적/질적 파워 이중 구조" 인사이트, §4 빌드별 드래프트 기대값 방법론	§2 PC6001 실측 수치, §3 G1 5장 -45% 실측
빌드 × 조건 충돌 점검	§0 용어 정의(E/X/SS/S/—), §2 매트릭스 구조, §3~ 결론(구조적 충돌 식별 방법론)	10×12=120 조합 실 판정 셀

관찰: 5문서 모두 방법론·운영 원리·체크리스트 틀은 차기 프로젝트 참고 가치 있음. 실 데이터·수치·스테이지 번호는 현 프로젝트 전용. 그러나 방법론과 실 데이터가 혼재되어 있어 섹션 단위 분리 곤란 — 분리 시 원본 맥락이 파괴됨.

2. 원칙 1 "본문 유지"의 낭비 측면 진단

2-1. 낭비 가능성이 실재하는 경우 (외부화 권고)

(A) 매 세션 자동 로드되는 문서의 교훈·역사 섹션

SKILL.md L1150~L1172 교훈 섹션 — 22개 항목, 약 18KB. 매 세션 전량 주입되나 활성 운영과 직접 결합 없음
교훈 중 C13·C14·C15·P17·P18 연계 항목은 이미 해당 활성 규칙 본문에 "신설 계기" 형태로 인라인 반영됨 → 중복 기재 = C14-4 참조 무결성 위반 소지
예시:
- 교훈 L1162 "Phase 3 HOLD 위반 사례" ↔ C10 본문 내 "신설 계기" 인라인
- 교훈 L1167~1170 "C13 위반 사례 3건" ↔ C13 본문 내 "절대 원칙" + feedback_pm_share_principle.md
- 교훈 L1154 "PM 3명 → 1명 통합" ↔ 활성 본문과 무관한 순수 역사 (외부화 최적)

(B) 매 세션 로드되지만 실무 참조 드문 역사 기록

C20-7 변경 이력·C26-5 진화 이력 등 활성 본문 내부의 "진화 이력" 섹션 — 감사 우선순위는 2순위이나 차후 검토 대상

2-2. 낭비 아님 (본문 유지 필수)

(A) C급 기획 5문서 본문 — 전량 유지 권고

근거:

변동비 문서 — SKILL.md·CLAUDE.md와 달리 매 세션 자동 주입 안 됨. 업무 필요 시 Read. 고정비 영향 0
Phase 3 재개 시 즉시 실행 자산 — 5문서 모두 "HOLD 중 PD님 재량 위임" 작업. Day 1~15+ 로드맵·조건 판정 의사코드·스테이지별 데이터·빌드-조건 매트릭스는 재개 즉시 실무 집행될 본문
방법론/데이터 분리 불가 — §1-1에서 §1-2·§1-3으로 매끄럽게 연결되는 구조. "틀만 남기고 데이터 삭제"하면 원본 맥락이 파괴되어 역으로 차기 프로젝트 참고 가치도 훼손
실측 수치 소실 리스크 — Phase2 카드임팩트의 "PC6001 앵커 DPS=1.05, G1 5장 -45% TTK"는 PD님 3차 승인 실측. 축약 시 근거 소실로 이슈 1·3 재논의 시 재측정 필요 (비용 대)

(B) B1·B2 아카이브 본문 — 전량 유지 권고

근거:

07 Headless 원안: 배너에 "본문은 기각안 근거·당시 설계 실증으로 보존" 명시. 차기 프로젝트 Unity 외 환경 고려 시 참고 자료 의도 부합 (헌법 목표 2-B)
02 추출대상: 배너 + 각 항목 역참조 구조가 이미 정합. Tier 1 16/16 구현 경로가 커밋 해시·파일 경로로 역참조되므로 실측 자산

2-3. 원칙 1의 정확한 외연 재정의 권고

현행 원칙 1 (2026-04-18 개정 후):

자산 보존 분리 — 폐기 설계 문서: 배너 + 본문 유지 / 완료 실적 문서: 배너 + 역참조 / SKILL.md 내 폐기 규칙: 원칙 3(저장 위치 최적화)

감사 권고 재정의:

자산 보존 분리 — 폐기 설계 문서·완료 실적 문서: 배너 + 본문 유지 (변동비 원칙). 매 세션 자동 로드되는 활성 본문(SKILL.md·CLAUDE.md)에 포함된 교훈·역사·진화 이력 섹션은 외부 아카이브로 이관 가능. 활성 본문에는 "교훈 요지 + 외부 경로 링크" 1줄만 유지.

이 재정의는 원칙 1과 원칙 3의 경계를 명확하게 함:

원칙 1: 변동비 문서 (업무 시 Read) 본문 유지
원칙 3: 고정비 문서 (매 세션 자동 주입) 내부의 외부화 가능 섹션

3. SKILL.md 교훈 섹션 외부화 시나리오

3-1. 제안 경로

시나리오	방식	토큰 절감	자산 보존	권장도
A. 현행 유지 (L1150~1172)	매 세션 18KB 자동 주입	0	⭕	기각 (낭비 실재)
B. SKILL.md 하단 유지 + 요약 축약	22개 → 핵심 5개로 축약	약 14KB	일부 소실	기각 (자산 훼손)
C. 외부 아카이브 이관 (채택 권고)	`공유/조직공지/교훈_아카이브.md` 신설 + SKILL.md에 1줄 안내만 유지	약 17KB	⭕ 완전 보존	채택 권고
D. `memory/feedback_*` 완전 흡수	기존 feedback 메모리에 항목별 통합	약 18KB	일부 중복	보조안 (차후 정리)

3-2. 시나리오 C 구체 설계

신설 파일: 공유/조직공지/교훈_아카이브.md

구조:

---
type: 교훈아카이브
created: 2026-04-18
maintainer: 총괄PM
sot_boundary: 운영 교훈·노하우·재발 방지 사례의 단일 SOT
related: SKILL.md (활성 본문 안내 1줄), memory/feedback_* (상세 실증)
rationale: C14 + 헌법 제1원칙 목표 2 원칙 B 동시 만족
---

# 교훈 및 노하우 아카이브

## 🏛️ 아카이브 원칙
- 포함 대상: 활성 규칙 본문과 직접 결합 없는 순수 교훈, 재발 방지 실증 사건, 역사 기록
- 제외 대상: 활성 규칙 본문에 인라인된 "신설 계기" 요지 (중복 금지)
- 읽기 규칙: 본 파일은 변동비. PM 필요 시 Read. SessionStart hook 자동 로드 대상 아님

## 교훈 (시간순)

[현 SKILL.md L1150~L1172 22개 항목 그대로 이관]

SKILL.md 수정 (L1148~1172):

---

## 교훈 및 노하우

> 형식: `[날짜] 교훈 내용 — 발생 맥락`. 상세 경위는 [교훈 아카이브](공유/조직공지/교훈_아카이브.md) 참조.
> 활성 본문에는 교훈 요지를 인라인 반영한 규칙(C10·C13·C14·C23·C29·C31 등)만 유지.

---

토큰 절감 추정: 약 17KB (= 18KB - 1KB 안내 블록)

3-3. 외부화 위험 및 완화

위험	완화 방법
새 PM 세션이 교훈을 놓침	활성 본문 각 규칙의 "신설 계기" 인라인은 유지 — 규칙을 읽으면 교훈도 자연 읽힘
PD님이 전체 교훈 맥락 필요 시 접근성 저하	SKILL.md L1148에 외부 링크 안내 + `공유/조직공지/` 기존 경로이므로 PD님 이미 숙지
교훈 아카이브 자체 소실	폐기 규칙 아카이브와 동일 보호 규칙(PD님 직접 승인 필수) 적용
`memory/feedback_*`와 중복	교훈 아카이브는 요약 연대기, feedback_는 사건별 상세*. 역할 분담 명시

3-4. PD님 지시 정합성 검증

PD님 발언: "교훈은 반드시 본문에 남기지 않아도 됨"

✅ "본문 외 저장 허용" = 외부 아카이브 파일 저장 명시 허용
✅ 헌법 목표 2-B(차기 프로젝트 참고 자료) 정신 유지 (아카이브 보존)
✅ C14(토큰 최소화) 직접 대응
⚠️ 단, "반드시 본문에 남기지 않아도"는 "본문 제거 필수"가 아니라 "본문 유지 강제 해제"로 해석. 완전 제거가 아닌 선별 이관 적용 권고

4. C급 기획 5문서 본문 축약 가능성 결론

4-1. 축약 권고 (Critical 수준)

없음. 5문서 전량 본문 유지 권고.

4-2. 실행 권고 (후속 작업)

구용어 수동 정밀 치환만 수행:

"기획실" → "기획팀"
"개발실" → "개발팀"
"개발실장" → "개발팀장"
대상 5문서 + (B1 07 Headless 원안에서도 구용어 존재)

수정 3대 원칙 준수:

원칙 1 (자산 보존 분리): 배너 이미 부착된 문서는 배너 하위 본문 구용어도 치환 (실무 참조 시 혼란 방지)
원칙 2 (sed 일괄 치환 금지): 수동 정밀 치환 엄수
원칙 3 (저장 위치 최적화): 해당 없음 (본문 유지)

Major 사안이 아닌 이유:

현재 구용어는 실제 파일 존재(SOT 미검증) 이슈 없이 내용 자체는 전부 정합
Phase 3 HOLD 중이므로 실무 참조 빈도 낮음
재개 시점에 구용어 수정이 자연 병행 가능

4-3. 기각안

안	기각 사유
5문서 "틀만 남기고 데이터 외부화"	원본 맥락 파괴, 재개 집행 시 재구성 비용 과다
5문서 "Phase 2·3 재개 완료 후 일괄 폐기"	Phase 3 재개 후에도 이슈 1·3 재논의·v2 확정 전까지 장기 참조 유지. 완료 선언 시점 판정 모호
5문서 전량 외부 위키·Notion 이관	조직 정책: git SOT 원칙(C16·C26). 외부 시스템 의존 회피
3성조건 명세 §3·§4 "조건별 정의" 만 남기고 의사코드 제거	개발 요청서 초안이 된 문서 — 의사코드 없으면 개발 전달 불가

5. 기각안 (감사 자체의 다른 안)

안	기각 사유
1. 본 감사를 "구용어 치환만" 권고로 한정	PD님 지시 범위 초과 — "낭비 측면 재검토"는 구조 레벨 검토 요구
2. 원칙 1 전면 폐기 (모든 폐기 문서 외부화)	5문서가 재개 즉시 실행 자산이라는 실무 판단 무시 — 원칙 과잉 교정
3. SKILL.md 전체 재구조화 (교훈 + 진화 이력 + 비교표 전량 외부화)	범위 과다 — PD님 지시는 "교훈" 명시. 비교표·진화 이력은 후속 감사 안건
4. C급 5문서 모두 배너만 남기고 본문 이관	Phase 3 재개 시 실행 자산 성격 간과 — 배너+링크만 남기면 재개 Day 1에 즉시 참조 불가

6. 권고 요약 (PM 3축 종합 보고서 반영용)

SKILL.md 교훈 섹션 L1150~L1172 외부화 — 신규 파일 공유/조직공지/교훈_아카이브.md 생성 + 활성 본문 1줄 안내. 약 17KB 고정비 절감 + 자산 100% 보존 (PD님 지시 직접 응답)
원칙 1 외연 재정의 — "변동비 문서는 본문 유지 / 고정비 문서 내 활성 운영과 결합 없는 섹션은 외부화 가능"으로 명확화 (원칙 3과의 경계 명시)
C급 5문서 본문 유지 — Phase 3 재개 즉시 실행 자산. 구용어 수동 치환만 별도 수행 권고
B1·B2 아카이브 현행 유지 — 배너 + 본문 + 역참조 구조 이미 정합

6-1. 영향 범위 (승인 시)

수정: SKILL.md L1148~1172 (교훈 섹션 정리)
신규: 공유/조직공지/교훈_아카이브.md
인계서: §1 원칙 1 외연 재정의 문구 1줄 추가 (선택)

6-2. 미승인 유지 (PM 재량 아님)

원칙 1 외연 재정의는 PD님 승인 안건으로 보고 후 진행 권고 (C26 단일 SOT 변경)

7. 감사 제약 명시 (C23 정직성)

본 감사는 문서 실측 Read + 규칙 교차 검증 기반. 실 집행·구용어 치환 수행 안 함 (plan-auditor 모드 C 산출물 3종 규범 — 보고만)
5문서 각 §별 "차기 프로젝트 참고 가치 구간" 식별은 문서 구조 분석 근거이며, 실 차기 프로젝트 요구사항과의 정합성은 차기 프로젝트 시작 시점에서 별도 검증 필요
교훈 섹션 외부화 시 feedback_* 메모리와의 중복 여부 상세 비교는 본 감사 범위 외 (구조 판단만 수행, 항목별 중복 매트릭스는 후속 작업 권고)

8. 참조 문서

헌법 제1원칙 목표 2 원칙 B (차기 프로젝트 인사이트 기록)
C14 (토큰 최소화 우선 설계) + C14-4 (참조 무결성)
C26 (코어룰 단일 SOT)
P24 (대화로그 — 기각안 필수 필드)
2026-04-18 대화로그 (원칙 3 개정 경위)
공유/조직공지/폐기_규칙_아카이브.md (원칙 3 실증)
공유/인계서/2026-04-17_전수감사_A+B급7건_수정집행_인계서.md

감사 완료: 2026-04-18 감사관: plan-auditor 후속: PM 3축 종합 보고서에 본 권고 반영 여부는 PM 재량

16 KiB Raw Blame History Unescape Escape