Files
C.E.L_Slide_test2/docs/architecture/PHASE-Q-AUDIT-PASS-2-EXECUTION-PLAN.md
kyeongmin bf55a53633 docs: lock Phase Q audit pass 2 boundaries
- Add §0-B Audit scope lock and strengthen §0-0 invariants
- Reclassify §2.5 F-3 deterministic budget assets as Reference Only
- Remove invalid AI/Kei revival rows from §2.2/§2.4/§2.5 lens tables
- Normalize §3/§4 legacy wording from Migrate/Delete vocabulary
- Add §5-1 reclassification tags and factual drift update
- Add pass 2 execution tracker document

Verified with 13-pattern context-aware grep:
positive misuse 0 within PHASE-Q-AUDIT.md pass 2 scope.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 11:55:51 +09:00

164 lines
11 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
> 본 문서는 실행 tracker다.
> PHASE-Q-AUDIT.md 의 원칙 / 분류 / lock 을 재정의하지 않는다.
# Phase Q Audit — Pass 2 Execution Plan
---
## 0. 문서 역할
- pass 2 실행 tracker
- 원칙 / 분류 / lock 의 single source of truth = [PHASE-Q-AUDIT.md](PHASE-Q-AUDIT.md)
- 본 문서는 lock 내용을 재정의하지 않고, **실행 순서 + 정정 위치 + progress** 만 추적한다
- pass 2 commit 후 archive 또는 status-only 로 축약 가능 (transient phase doc)
---
## 1. 목표 — L1~L4 boundary lock
| # | Boundary | 미끄러진 양상 (lock 이유) |
|---|---|---|
| **L1** | Phase Z 22-step normal path = 본체 / Phase Q = 참고 자료 | "Phase Q 를 Phase Z 에 *적용*" 식으로 미끄러짐 |
| **L2** | Kei persona 흐름 ≠ AI repair fallback | Kei 자산 옆에 "AI repair 별 axis 가능성 보존" 같이 두 개념을 같은 spectrum 으로 묶음 |
| **L3** | 이번 audit pass = Phase Z normal path 기준만 (AI repair axis = out of scope) | "AI repair 에서 살아날지도" 식으로 audit 범위가 흐려짐 |
| **L4** | 4-area 책임 분리 (관련 §7-B 표 / 현재 Phase Z 표 / 재사용 가능성 표 / 후속 참고 사항 + dual-write 기준) | 같은 자산이 여러 표에 다른 분류로 박혀 self-inconsistent |
4 boundary lock 후 = §2.6 이후 audit / §3 Salvage Plan / §4 reorder 단계에서 미끄러짐 재발 risk 차단.
---
## 2. 진행 상태
| sub-axis | 상태 |
|---|---|
| 2-a 진행 로그 정책 반영 | ✅ 완료 |
| 2-b §0 / §0-A / §1 용어 정리 | ✅ 완료 |
| 2-c §2.1 / §2.2 stale wording | ✅ 완료 |
| **2-c hygiene fix 2** | ✅ 완료 (체크리스트 24/24, 2026-05-11) |
| 2-d-0 / 2-d-1 §2.4 line 435 / 443 정정 | ✅ 완료 (2026-05-11) |
| 2-e-0 / 2-e-1 §3 / §4 5 위치 정정 | ✅ 완료 (2026-05-11) |
| 2-f-0 / 2-f-1 §5-1 5 entry 인라인 재분류 태그 | ✅ 완료 (2026-05-11) |
| 2-g 최종 verification (13 pattern grep) | ✅ 완료 (0 positive misuse, all preserved context, 2026-05-11) |
| pass 2 commit (단일 decision unit) | ⏳ GO 대기 |
---
## 3. Sub-axis Sequence
```
2-a (완료) → 2-b (완료) → 2-c (완료)
2-c hygiene fix 2 (GO 대기)
2-d → 2-e → 2-f → 2-g
commit (별도 GO, pass 2 전체 = 1 decision unit)
```
각 sub-axis 시작 시 명시 GO 신호 필요. **1 turn = 1 step** 원칙 ([feedback_one_step_per_turn.md](../../../../../Users/User/.claude/projects/d--ad-hoc-kei-design-agent/memory/feedback_one_step_per_turn.md)).
---
## 4. 2-c Hygiene Fix 2 Checklist
> **체크리스트 항목 = 24 개 / 실 정정 위치 ≈ 21 곳**
> (일부 항목은 multi-line edit. F13 같은 항목은 4 함수 × 3 line 합산.)
### A — §0-0 / §0-B (4-boundary lock 본체)
- [x] **A.** §0-0 invariant 보강 — Archive Candidate 정의 sharpening + Kei persona 흐름 ≠ AI repair fallback split + Phase Q Kei 자산이 AI repair 기반 *아님* 단절 명시 + 별 axis nuance (deterministic retry OK / Kei-AI revival X)
- [x] **A'.** §0-B 새 섹션 추가 (§0-A 뒤 / §1 앞) — 핵심 lock 3 lines + 포함 list + 제외 list (제외 list 의 "AI 콘텐츠 생성용 글자수 예산 / AI 텍스트 압축 흐름" 좁힌 표현 채택)
### B / C — §5 영역
- [x] **B.** §5-0 매핑표 (line 656, 661) — "AI repair 별 axis 가능성만 보존" / "AI repair 가 별 axis 자체" wording 제거
- [x] **C.** §5 실행 원칙 (line 690) — "AI repair 별 axis 가능성 보존" 라인 제거
### D — §2.2 (β 일관 적용)
- [x] **D1.** §2.2 line 220 관련 §7-B 표 — **row 제거** (2-c relabel undo. map_topics_to_sections 분류는 line 246 재사용 가능성 표 SoT)
- [x] **D2.** §2.2 line 231 현재 Phase Z 표 — wording fix ("(별 axis 자체)" 제거 → "Kei persona 꼭지/대목차 매핑 결정 흐름. Phase Z 본체도 AI repair fallback 도 salvage 대상 아님")
### E — §2.4 (β 일관 적용)
- [x] **E1.** §2.4 line 406 관련 §7-B 표 — **row 제거** (V-7~V-10 분류는 line 428 재사용 가능성 표 SoT)
- [x] **E2.** §2.4 line 414 현재 Phase Z 표 — wording fix ("Kei 통합 path. 별 axis" → "Archive — Kei AI 흐름 (강조/bold/popup 차용 판단). Phase Z 미존재 + AI repair fallback salvage 대상 아님")
### F — §2.5 (확장 propagation, β + F-3 + ε)
- [x] **F1.** §2.5 line 506 관련 §7-B 표 — "Migrate 강 후보" → "Salvage Candidate". deterministic retry axis 표현 유지
- [x] **F2.** §2.5 line 507 관련 §7-B 표 — **row 제거** (font_hierarchy/dynamic_ratio Kei input 의존 — invalid Step 8 정밀화 axis)
- [x] **F3.** §2.5 line 508 관련 §7-B 표 — **row 제거** ("AI 통합" axis 자체 forbidden)
- [x] **F4.** §2.5 line 509 관련 §7-B 표 — wording fix ("Phase Z frame contract validation 강화 시 Reference" → "Reference Only — frame contract slot capacity validation 참고 가능")
- [x] **F5.** §2.5 line 505 현재 Phase Z 표 — build_containers_type_b "Reference 패턴" → "Archive 정합 (page_structure 입력 source 없음)". "B-4 진짜 fix" negation context 는 2-d 위임
- [x] **F6.** §2.5 line 516 현재 Phase Z 표 — "패턴만 Reference" → "Archive 정합"
- [x] **F7.** §2.5 line 517 현재 Phase Z 표 — font_hierarchy/dynamic_ratio "Reference 강 후보 (별 axis)" → "Archive — Kei 역할별 텍스트 길이 입력 없음. Phase Z = frame contract fixed font"
- [x] **F8.** §2.5 line 518 현재 Phase Z 표 — design_budget framing → "Reference Only — frame contract slot capacity validation 참고 가능"
- [x] **F9.** §2.5 line 519 현재 Phase Z 표 — char_budget framing → "Reference Only — overflow 예측 / pre-render fit check 참고 가능. AI 콘텐츠 생성 / repair axis 근거 X"
- [x] **F10.** §2.5 line 520 현재 Phase Z 표 — "Migrate 강 후보" → "Salvage Candidate" (compute_glue)
- [x] **F11.** §2.5 line 521 현재 Phase Z 표 — "Migrate" → "Salvage Candidate" (find_fitting_font_size)
- [x] **F12.** §2.5 line 522 현재 Phase Z 표 — trim_chars framing → "Reference Only — excess px → chars 결정론적 계산. retry 판단 참고 가능. AI 텍스트 압축 흐름과 분리"
- [x] **F13.** §2.5 line 534 / 535 / 539 재사용 가능성 표 — **4 함수 Archive → Reference Only 재분류** (design_budget / char_budget / budgets_for_candidates / trim_chars) + reasoning 갱신 ("AI 격리 invariant 충돌" reasoning 제거 → deterministic capacity/budget 계산 reasoning)
- [x] **F14.** §2.5 line 544~558 audit 판정 summary text — 분류 변경 반영 (Salvage / Reference Only / Archive 자산 list 갱신)
- [x] **F-extra1.** §2.5 line 581 후속 참고 사항 F4 entry — **entry 삭제 (ε)**. char_budget Reference Only 재분류 후 "(제거)" marker semantic 무효. AI 통합 방어 문구는 §0-B single anchor. F3 (font_hierarchy/dynamic_ratio Archive marker) 만 잔존
- [x] **F-extra2.** §2.5 line 590 dual-write 기준 — Archive list 한정 ("Kei 입력 / page_structure / role_text_lengths 의존" 4 함수: container_specs / build_containers_type_b / font_hierarchy / dynamic_ratio) + Reference Only list 추가 ("design_budget / char_budget / budgets_for_candidates / trim_chars — §3 adapter / dual-write 검토 가능. AI 콘텐츠 생성 / repair axis 근거 아님")
---
## 5. 후속 Sub-axis 개요
### 2-d. §2.3 / §2.4 / §2.5 잔여 stale wording
- **목적**: 2-c / 2-c hygiene fix 2 에서 처리 안 된 legacy Migrate-era 표현 정리
- **대상**: §2.3 영역의 잔여 표현 / §2.4 line 405 / 413 등 "Migrate" wording (Salvage Candidate / Reference Only 자산에 박힘) / §2.5 line 505 "B-4 진짜 fix" negation context 판단
- **처리**: positive misuse 만 정정, negation context 보존 (정정 pass 2 실행 원칙)
### 2-e. §3 / §4 용어 정리
- **목적**: Salvage Plan (§3) / 우선순위 reorder (§4) 의 표현 정정
- **대상**: §3 line 608 "Migrate 항목" / line 612 표 column "Migrate / Reference / 새로 만들기" / §4 line 634 "Migrate 로 빠르게 끝남"
- **처리**: §0-0 분류 체계 (Salvage Candidate / Reference Only / Archive Candidate) + dual-write 표현으로 일관 정정
### 2-f. 진행 로그 인라인 재분류 태그
- **목적**: §5-0 정책 (2-a) 의 재분류 매핑표를 §5-1 진행 로그 각 dated entry 옆에 인라인 태그로 적용
- **대상**: §5-1 dated entries (line 647, 648, 650, 651, 652, 653)
- **처리**: 과거 entry 본문 보존, 옆에 `[재분류: ... → ...]` marker 만 추가 (5-0 정책 따름)
### 2-g. context-aware grep 최종 검증
- **목적**: pass 2 전체 종료 후 positive misuse 잔존 확인
- **검색 대상**: `Migrate` / `진짜 fix` / `Kei 통합` / `AI 통합` / `AI 텍스트 압축 path` / `별 axis 잠재` + AI/Kei 자산 인접 표현
- **처리**: negation context 보존 / positive misuse 정정. 발견 시 단건 patch 또는 추가 sub-axis 결정
---
## 6. Source-of-Truth Links
PHASE-Q-AUDIT.md 의 lock 본체 anchor:
- **§0-0** — 자산 분류 기준 (Salvage Candidate / Reference Only / Archive Candidate) + AI 격리 invariant
- **§0-A** — Phase Q Salvage 10 원칙 lock
- **§0-B** *(2-c hygiene fix 2 에서 신규 추가 예정)* — Audit 범위 lock (핵심 lock 3 lines + 포함/제외 list)
- **§5-0** — 진행 로그 정책 + legacy 표현 재분류 매핑표
- **§2.X 재사용 가능성 표** — 각 §2.X 의 자산별 분류 SoT
본 plan doc 의 lock 인용은 위 5 anchor 만 참조. plan doc 자체가 lock 을 재정의하지 않음.
관련 memory anchor:
- [feedback_review_vs_go.md](../../../../../Users/User/.claude/projects/d--ad-hoc-kei-design-agent/memory/feedback_review_vs_go.md) — 검토 vs GO 신호 구분
- [feedback_workflow_atomicity_rules.md](../../../../../Users/User/.claude/projects/d--ad-hoc-kei-design-agent/memory/feedback_workflow_atomicity_rules.md) — 1 commit = 1 decision unit
- [feedback_one_step_per_turn.md](../../../../../Users/User/.claude/projects/d--ad-hoc-kei-design-agent/memory/feedback_one_step_per_turn.md) — 1 turn = 1 step
- [feedback_ai_isolation_contract.md](../../../../../Users/User/.claude/projects/d--ad-hoc-kei-design-agent/memory/feedback_ai_isolation_contract.md) — AI 격리 contract
---
## 7. Commit Policy
- pass 2 전체 = **1 decision unit** ([Workflow atomicity rules](../../../../../Users/User/.claude/projects/d--ad-hoc-kei-design-agent/memory/feedback_workflow_atomicity_rules.md))
- commit timing = **2-g 종료 후**
- 별도 명시 GO 신호 필요 (`commit GO` 등)
- 중간 sub-axis 종료 시 commit X (단일 git change set 으로 묶음)
- commit message style = PHASE-Q-AUDIT.md prior commit history 참조
- 본 plan doc 자체도 같은 commit 에 포함 (pass 2 의 일부 산출물)