BurningTimesAi/공유/소통/plan-auditor→PM/2026-04-18_원칙1_재검토_감사.md

255 lines
16 KiB
Markdown
Raw Normal View History

refactor(rules): 원칙 1 외연 명확화 + OPT-1·DEC-3 + 07 축약 + REQ 6건 정리 ## PD님 승인 범위 2026-04-18 직접 지시 4건 중 DEC-2 제외 전부: - PM 재량 즉시 집행 (OPT-1·OPT-2·OPT-3) - DEC-1 원칙 1 외연 명확화 문구 추가 - DEC-3 C31-E 체크리스트 확장 - DEC-2 C급 집행 시점은 PD님 재논의 대기 ## 3축 감사 + 팀장급 5 에이전트 병렬 논의 종합 반영 - plan-auditor·dev-auditor·pm-auditor 모드 C 정규 산출물 3종 발행 - dev-auditor 2026-04-17 산출물 미이행 메타 이슈 교정 실증 - PM 과도 보수 해석 feedback 메모리 신설 (3회차 재발 시 역할 재검토) ## OPT-1 SKILL.md 교훈 섹션 외부화 - L1150~1172 (22줄, ~18KB) → memory/org/MEMORY.md 인덱스 참조 1줄 - 교훈 자산 memory/org/feedback_* 18종 100% 보존 - C14-4 참조 무결성 회복, 고정비 절감 ## DEC-3 C31-E 체크리스트 확장 - 신설 문항: "자산 가치 보존 ≠ 저장 위치 보존 구분했는가?" - PM 과도 보수 해석 2회 연속 재발 방지 ## DEC-1 인계서 원칙 1 외연 명확화 - 변동비 문서 = 본문 유지 - 고정비 문서 내 활성 결합 없는 섹션 = 외부 SOT 이관 + 1줄 참조 - C14 + 헌법 목표 2-B 동시 만족 ## OPT-2 07 Headless 파일 내 축약 - §3(Phase A~E)·§4(담당 팀)·§5(재개 조건)·§7(완료 기준) 약 120줄 삭제 - §1·§2(Option A/B 비교)·§6(검증 방법)·§8(OI)·§10(참고) 유지 - 228 → 129 라인 (43% 축약) - 차기 Unity 외 환경 참고 가치 보존 ## OPT-3 REQ 6건 경로 이동 - REQ001~003 요청 3건 + 2026-04-16 응답 3건 → 공유/소통/완료/ - 개발팀장 실측 "이미 응답 완료" 프론트매터 근거 - C29-4 완료 후 동기화 이행 ## 3축 감사관 산출물 신설 - 공유/소통/pm-auditor→PM/2026-04-18_원칙1_재검토_메타감사.md - 공유/소통/dev-auditor→PM/2026-04-18_원칙1_재검토_감사.md - 공유/소통/plan-auditor→PM/2026-04-18_원칙1_재검토_감사.md - memory/org/feedback_pm_over_conservative_interpretation.md - memory/feedback_dev_auditor_output_gap.md Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-17 17:26:20 +00:00
---
type: 감사보고서
mode: C (주제 집중)
audit_date: 2026-04-18
auditor: plan-auditor
subject: 수정 3대 원칙의 원칙 1 재검토 + C급 기획 5문서 본문 축약 가능성 + 교훈 섹션 저장 위치
pd_instruction: 2026-04-18 PD님 직접 — "원칙 1에서 본문 전부 유지 시 낭비되는 측면 재검토. 교훈은 반드시 본문에 남기지 않아도 됨"
triggered_by: PM 재량 위임 (plan-auditor 모드 C 호출)
related_rules: 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문서 본문** — 전량 유지 권고
근거:
1. **변동비 문서** — SKILL.md·CLAUDE.md와 달리 매 세션 자동 주입 안 됨. 업무 필요 시 Read. **고정비 영향 0**
2. **Phase 3 재개 시 즉시 실행 자산** — 5문서 모두 "HOLD 중 PD님 재량 위임" 작업. Day 1~15+ 로드맵·조건 판정 의사코드·스테이지별 데이터·빌드-조건 매트릭스는 **재개 즉시 실무 집행될 본문**
3. **방법론/데이터 분리 불가** — §1-1에서 §1-2·§1-3으로 매끄럽게 연결되는 구조. "틀만 남기고 데이터 삭제"하면 원본 맥락이 파괴되어 역으로 차기 프로젝트 참고 가치도 훼손
4. **실측 수치 소실 리스크** — Phase2 카드임팩트의 "PC6001 앵커 DPS=1.05, G1 5장 -45% TTK"는 PD님 3차 승인 실측. 축약 시 근거 소실로 이슈 1·3 재논의 시 재측정 필요 (비용 대)
**(B) B1·B2 아카이브 본문** — 전량 유지 권고
근거:
1. 07 Headless 원안: **배너에 "본문은 기각안 근거·당시 설계 실증으로 보존"** 명시. 차기 프로젝트 Unity 외 환경 고려 시 참고 자료 의도 부합 (헌법 목표 2-B)
2. 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)**:
```markdown
---
## 교훈 및 노하우
> 형식: `[날짜] 교훈 내용 — 발생 맥락`. 상세 경위는 [교훈 아카이브](공유/조직공지/교훈_아카이브.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 사안이 아닌 이유**:
1. 현재 구용어는 **실제 파일 존재(SOT 미검증)** 이슈 없이 내용 자체는 전부 정합
2. Phase 3 HOLD 중이므로 실무 참조 빈도 낮음
3. 재개 시점에 구용어 수정이 자연 병행 가능
### 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축 종합 보고서 반영용)
1. **SKILL.md 교훈 섹션 L1150~L1172 외부화** — 신규 파일 `공유/조직공지/교훈_아카이브.md` 생성 + 활성 본문 1줄 안내. **약 17KB 고정비 절감** + 자산 100% 보존 (PD님 지시 직접 응답)
2. **원칙 1 외연 재정의** — "변동비 문서는 본문 유지 / 고정비 문서 내 활성 운영과 결합 없는 섹션은 외부화 가능"으로 명확화 (원칙 3과의 경계 명시)
3. **C급 5문서 본문 유지** — Phase 3 재개 즉시 실행 자산. 구용어 수동 치환만 별도 수행 권고
4. **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 재량*