# Phase 10 OpenAPI Follow-up 코드 리뷰·QA

## 1. 리뷰 정보

| 항목 | 내용 |
|---|---|
| 리뷰 대상 | Phase 10 / OpenAPI 2.3.0 후속 구현, 전체 통합 Gate와 현재 상태 문서 |
| 기준 commit 또는 working tree | `dd30e36323543e8f60e9983326503653e8001f12`, 2026-07-31 종합 재점검 당시 사용자 변경을 포함한 current working tree |
| 리뷰 일자 | 2026-08-01 |
| 리뷰어 | Codex |
| 기준 문서 | `prd.md`, `api-contract.openapi.json` 2.3.0, `plan-task.md`, 이전 Phase 10 리뷰 |
| 리뷰 상태 | `REV-P10-018`/`P10-R17` 수정 완료, 실제 수동 QA 대기 |

## 2. 리뷰 목적과 범위

### 목적

- OpenAPI 2.3.0의 implemented operation, 후속 도메인 변경, 전체 자동 Gate와 수동 QA 상태를 종합 점검한다.
- 계획 상단·상태 절·과거 리뷰의 현재형 결론이 최신 완료 이력과 이번 신규 발견을 정확히 반영하는지 확인한다.

### 포함 범위

- 코드·테스트: 전 도메인 통합 경계와 전체 자동 Gate
- 계약: OpenAPI paths/operations/status/schema refs
- 문서: `P10-*`, plan 현재 상태·검증 기록, `review-phase-10-20260729.md`
- 수동 검증: 문서 상태 문장과 실제 task/Gate 기록 대조

### 제외 범위

- 실제 개발 서버 credential과 고정 fixture가 필요한 Series/FanTalk/Comments 수동 QA
- 이번 리뷰에서 발견한 코드 문제의 구현

## 3. 판정 기준

심각도는 `Blocker`, `High`, `Medium`, `Low`, 상태는 `후보`, `확정`, `오탐`, `보류`, `수정 완료`를 사용한다. 계약 누락·통합 회귀와 현재 상태 문서의 의사결정 오류를 확인한다.

## 4. 검토한 근거

### 문서와 코드

- 요구사항: PRD 전체와 §14 성공 기준
- 계약: `api-contract.openapi.json` 2.3.0 전체
- 계획: `P10-T1`~`P10-GATE`, 후속 회귀 Task, 상단 상태와 §6
- 이전 리뷰: `reviews/review-phase-10-20260729.md:134-158`
- 현재 신규 발견: `REV-P0-004`, `REV-P3-004/005`, `REV-P4-007`, `REV-P5-004`, `REV-P6-002`, `REV-P7-001`, `REV-P8-003`, `REV-P9-003`

### 실행 환경

```text
macOS 26.0 (Build 25A354)
Node v24.12.0 / npm 11.7.0
Playwright Chromium, Mobile Chrome
OpenAPI: 3.1.0 / info.version 2.3.0
```

### 실행한 검증

| 명령 또는 수동 검증 | 결과 | 핵심 증거 |
|---|---|---|
| `npm run typecheck` / `npm run lint` | 성공 | 모두 exit 0 |
| `npm run test:run` | 성공 | 72 files, 354 tests passed |
| `npm run build` | 성공 | exit 0, 253 modules transformed |
| `npm run e2e:mock` | 실패 | 201 passed, 22 skipped, 5 failed; origin 4건과 비재현 timeout 1건 |
| `npm run e2e:mock -- tests/e2e/series.spec.ts --project=webkit --grep "desktop and tablet Series management flow remains available at 768px"` | 성공 | 1 passed |
| `npm run e2e` | 실패 | 12 passed, 24 failed; 현재 API origin과 과거 route 불일치 |
| `jq` operation/status 집계 및 component schema `$ref` 차집합 검증 | 성공 | 두 명령 모두 exit 0; 25 paths, 37 operations, 전부 `implemented`, 누락 component schema ref 없음 |
| 실제 서버 수동 QA | 불가 | ADMIN credential과 제어 가능한 fixture가 제공되지 않음 |
| plan·이전 리뷰 상태 대조 | 성공 | plan 상단·§6·이전 리뷰가 자동 Gate 완료와 수동 QA 대기로 일치 |
| FanTalk PUT schema 실행 대조 | 실패 | OpenAPI `FanTalkListItem` data는 현재 schema가 거부하고 POST 응답 shape만 허용 |
| FanTalk POST→목록 reply ID 대조 | 실패 | mock `creatorReplies[].fanTalkId`에 POST `replyId`가 아니라 root `fanTalkId` 저장 |
| 현재형 문서·dead scaffold 검색 | 실패 | README가 implemented operation을 대기/구현 대상으로 설명하고 미사용 Phase 3 placeholder export가 남음 |

OpenAPI 검증은 다음 명령으로 실행했다.

```bash
jq '[.paths[] | to_entries[] | select(.key | IN("get", "put", "post", "delete", "patch", "head", "options", "trace")) | .value] as $operations | {openapi, version: .info.version, paths: (.paths | length), operations: ($operations | length), statuses: ([$operations[]."x-implementation-status"] | unique)}' docs/20260725_AI캐릭터관리자웹/api-contract.openapi.json
jq -e '((([.. | objects | .["$ref"]? // empty | select(startswith("#/components/schemas/")) | split("/")[-1]] | unique) - (.components.schemas | keys)) | length) == 0' docs/20260725_AI캐릭터관리자웹/api-contract.openapi.json
```

## 5. 발견 사항 요약

| ID | 심각도 | 상태 | 제목 | 소유 Task | 후속 goal |
|---|---|---|---|---|---|
| `REV-P10-003` | Low | 수정 완료 | plan과 이전 Phase 10 리뷰의 현재 상태가 완료 이력과 신규 회귀 목록을 반영하지 않는다 | `P10-R3` | `P10-R3` |
| `REV-P10-004` | High | 수정 완료 | FanTalk PUT client가 OpenAPI 응답 대신 POST 응답 schema를 사용해 성공 응답 parsing에 실패한다 | `P10-R4` | `P10-R4` |
| `REV-P10-005` | Medium | 수정 완료 | FanTalk mock이 새 답변의 reply row ID 대신 root ID를 수정 path에 사용한다 | `P10-R4` | `P10-R4` |
| `REV-P10-006` | Low | 수정 완료 | 현재 문서와 dead scaffold가 완료된 Phase 3·10 기능을 아직 대기 상태로 설명한다 | `P10-R5` | `P10-R5` |

## 6. 발견 사항 상세

### REV-P10-003 — plan과 이전 Phase 10 리뷰의 현재 상태가 완료 이력과 신규 회귀 목록을 반영하지 않는다

- **심각도:** Low
- **상태:** 수정 완료
- **관련 요구사항:** 구현 계획·리뷰 가이드의 현재 상태 및 검증 기록 유지 규칙
- **관련 계약:** 없음
- **소유 Task:** 신규 `P10-R3`

**관찰 내용**

plan 상단 상태는 2026-07-29 신규 회귀 Task와 `P10-GATE`가 미완료라고 적는다. 중간 §6은 Series/FanTalk server E2E가 최종 완료를 막는다고 서술하지만, plan 후반에는 자동 Gate 완료와 수동 QA 대기가 기록돼 있다. 이전 Phase 10 리뷰도 이미 완료된 `P10-R1`·`P10-R2` 및 Gate를 대기 상태로 유지한다. 이번 리뷰에서 새로 확정한 Task 목록도 현재 상태에 아직 반영되지 않는다.

**근거**

- 계획: `plan-task.md:13`, §6의 server E2E 상태 문장, 후반 `P10-R1`·`P10-R2`·Gate 완료 기록
- 이전 리뷰: `reviews/review-phase-10-20260729.md:134-151`
- 이번 리뷰: Phase 0~10 신규 report와 새 회귀 Task
- 가이드: 완료 체크를 되돌리지 않고 현재 상태와 수정 후 검증을 누적해야 함

**재현 또는 검증 절차**

1. plan 상단 상태와 §6의 blocker 문장을 읽는다.
2. 문서 후반의 `P10-R1`, `P10-R2`, 자동 Gate 완료 기록을 읽는다.
3. 이전 Phase 10 리뷰의 최종 결론과 비교한다.
4. 동일 작업이 “미완료”, “자동 Gate 완료”, “수동 QA 대기”로 동시에 표현되는 것을 확인한다.

**영향**

다음 실행자가 현재 자동 Gate, 수동 QA, 신규 회귀 Task 중 무엇이 남았는지 잘못 판단할 수 있다. 완료된 Task를 재개하거나 아직 수정하지 않은 신규 결함을 완료로 오인할 위험이 있다.

**권장 조치**

기존 실행 이력은 보존하고 현재 상태 요약만 2026-07-30 기준으로 갱신한다. 과거 Phase 10 리뷰에는 완료된 항목의 `수정 완료`·검증 기록을 누적하고, 새 회귀 Task와 실제 서버 수동 QA 대기를 구분한다.

**판정 기록**

- 2026-07-30 — plan의 세 상태 위치, 이전 리뷰와 이번 신규 Task를 대조해 확정.
- 2026-07-30 — plan 상단·§6과 이전 Phase 10 리뷰 결론을 자동 Gate 완료·실제 개발 API 수동 QA 대기 기준으로 정렬해 완료.

### REV-P10-004 — FanTalk PUT client가 OpenAPI 응답 대신 POST 응답 schema를 사용해 성공 응답 parsing에 실패한다

- **심각도:** High
- **상태:** 수정 완료
- **관련 요구사항:** `FANTALK-004`, `FANTALK-009`
- **관련 계약:** `PUT .../fan-talks/{fanTalkId}/replies/{replyId}`의 `FanTalkReplyUpdateApiResponse`
- **소유 Task:** 신규 `P10-R4`

**관찰 내용**

OpenAPI PUT 성공 data는 레거시 `CreatorChannelFanTalkResponse`에 대응하는 `FanTalkListItem` shape다. 그러나 `updateFanTalkReply`는 POST 성공용 `fanTalkReplyResponseSchema`와 `FanTalkReplyResponse`를 재사용한다. 실제 계약 shape의 성공 응답을 받으면 strict schema parsing이 실패해 서버 mutation이 성공했어도 UI는 수정 실패로 처리한다. 현재 contract/UI test fixture도 PUT에 POST shape를 반환해 문제를 고정한다.

**근거**

- client: `src/features/fan-talks/api/fan-talk-api.ts:72-80`
- POST schema: `src/features/fan-talks/schemas/fan-talk-reply-schema.ts:9-19`
- 잘못된 fixture: `src/features/fan-talks/tests/fan-talk-contract.test.ts:58-60,106-117`, `fan-talk-reply.test.tsx:65-71,104-117`
- 계약: OpenAPI `FanTalkReplyUpdateApiResponse.data → FanTalkListItem`; data의 `fanTalkId`는 수정 reply row ID, `creatorReplies`는 빈 배열
- 실행 재현: OpenAPI PUT data shape parse `false`, POST data shape parse `true`

**재현 또는 검증 절차**

1. PUT handler가 `{fanTalkId,writerId,writerNickname,writerProfileImageUrl,content,createdAtUtc,creatorReplies:[]}`를 성공 data로 반환하게 한다.
2. 기존 `updateFanTalkReply`를 호출한다.
3. HTTP 200 이후 `fanTalkReplyResponseSchema`가 `replyId`, `creatorMemberId` 누락과 extra fields 때문에 parsing 오류를 내는 것을 확인한다.

**영향**

실제 개발 API에서 답변 수정이 서버에는 반영되지만 관리자는 실패 안내를 보고 재시도할 수 있다. 이는 중복 PUT과 상태 혼동을 유발하며 `P10-T5`의 완료 증거를 무효화하는 계약 위반이다.

**권장 조치**

PUT 전용 response schema/type을 `FanTalkListItem` 기반으로 분리하고 contract/MSW/mock fixture를 OpenAPI shape로 바꾼다. UI가 응답을 직접 표시하지 않더라도 성공 data validation은 유지한다.

**판정 기록**

- 2026-07-30 — OpenAPI schema와 client strict parser를 실행 대조해 확정.
- 2026-07-30 — PUT 전용 response schema/type과 OpenAPI shape fixture를 추가하고 focused FanTalk unit·mock E2E로 수정 완료.

### REV-P10-005 — FanTalk mock이 새 답변의 reply row ID 대신 root ID를 수정 path에 사용한다

- **심각도:** Medium
- **상태:** 수정 완료
- **관련 요구사항:** `FANTALK-004`, `FANTALK-009`, `FANTALK-010`, `MOCK-005`
- **관련 계약:** POST `FanTalkReplyResponse.replyId`, 목록 `creatorReplies[].fanTalkId`, PUT path `replyId`
- **소유 Task:** 신규 `P10-R4`

**관찰 내용**

mock POST는 새 `replyId=9001`을 반환하지만 목록 갱신 시 `creatorReplies[].fanTalkId`에 root FanTalk ID를 저장한다. mock PUT도 그 root ID를 reply ID로 기대해 잘못된 mapping이 자체적으로 성공한다. 기존 E2E는 답변 생성 후 같은 item을 수정하지 않고 별도 pre-existing item만 수정해 이 차이를 찾지 못한다.

**근거**

- mock create mapping: `src/shared/mocks/fan-talk-mock-store.ts:38-49`
- mock PUT ID 비교/응답: `src/shared/mocks/fan-talk-mock-store.ts:54-73`
- UI fixture 동일 오류: `src/features/fan-talks/tests/fan-talk-reply.test.tsx:95-102`
- 문서: `prd.md:323,328-329`
- 현재 E2E: create flow와 pre-existing reply edit flow가 분리돼 POST→같은 item PUT path를 검증하지 않음

**재현 또는 검증 절차**

1. 미답변 root `fanTalkId=7001`에 POST하고 응답 `replyId=9001`을 받는다.
2. 목록을 다시 읽으면 mock의 `creatorReplies[0].fanTalkId`가 9001이 아니라 7001이다.
3. 같은 item을 수정하면 `/replies/7001`을 호출한다.
4. 요구 결과는 `/replies/9001` 호출이다.

**영향**

mock preview가 새 답변의 후속 수정 path를 실제 server와 다르게 검증해 integration 결함을 숨긴다. 새 답변 작성 직후 수정하는 운영 흐름이 실제 API에서 404 또는 다른 row 오조회를 일으킬 수 있다.

**권장 조치**

목록 creator reply에는 POST의 `replyId`를 저장하고 mock PUT lookup도 그 ID를 사용한다. create→재조회→같은 item edit E2E를 추가해 path를 고정한다.

**판정 기록**

- 2026-07-30 — PRD ID mapping과 mock create/update branch 및 E2E journey를 대조해 확정.
- 2026-07-30 — mock 목록 mapping이 POST `replyId`를 보존하도록 수정하고 POST→동일 item PUT path E2E로 수정 완료.

### REV-P10-006 — 현재 문서와 dead scaffold가 완료된 Phase 3·10 기능을 아직 대기 상태로 설명한다

- **심각도:** Low
- **상태:** 수정 완료
- **관련 요구사항:** 구현 계획·리뷰 가이드의 현재 상태 유지 규칙
- **관련 계약:** OpenAPI 2.3.0 implemented operation 상태
- **소유 Task:** 신규 `P10-R5`

**관찰 내용**

README는 v2 원작·장르 lookup을 아직 대기라고 설명하고 FanTalk 수정·삭제, Comments CRUD, Community pagination을 “Phase 10 구현 대상”이라고 적는다. 이 기능들은 OpenAPI 2.3.0과 `P10-T1~T7`에서 implemented/완료다. 또한 사용처 없는 `AiCharactersPage` export가 “Phase 3에서 연결” placeholder UI를 보존한다.

**근거**

- 문서: `README.md:54-57`
- dead scaffold: `src/app/admin-pages.tsx:19-36`
- 사용처 검색: `AiCharactersPage`는 정의 외 참조 0건
- 계약·계획: OpenAPI 25 paths/37 operations 전부 implemented, `P10-T1~T7` 체크 완료

**재현 또는 검증 절차**

1. README Known Backend Constraints를 현재 OpenAPI·Phase 10 완료 기록과 비교한다.
2. `rg -n 'AiCharactersPage' src`로 placeholder가 routing되지 않는 dead export임을 확인한다.
3. 현재 인수자가 문서만 읽으면 이미 구현된 기능을 미구현으로 판단하게 되는 것을 확인한다.

**영향**

다음 작업자가 완료된 lookup·FanTalk·Comments 범위를 다시 계획하거나 실제 남은 수동 QA와 제품 제외 범위를 잘못 구분할 수 있다. dead placeholder는 오래된 문구가 재사용될 가능성을 남긴다.

**권장 조치**

README 현재 상태만 implemented 범위와 실제 개발 API 수동 QA 대기로 갱신하고, 사용처 없는 placeholder component는 삭제한다. 날짜별 과거 Decision/Progress는 보존한다.

**판정 기록**

- 2026-07-30 — README·dead export 검색과 OpenAPI/plan 완료 상태를 대조해 확정.
- 2026-07-30 — README 현재형 stale 문구를 갱신하고 미사용 `AiCharactersPage` export를 삭제해 수정 완료.

## 7. 확정 항목의 plan·goal 전환

- `REV-P10-003` → `plan-task.md` 신규 `P10-R3`
- goal objective: `[P10-R3] 계획과 이전 Phase 10 리뷰의 현재 상태를 완료 이력·신규 회귀 Task·수동 QA 대기 기준으로 동기화한다.`
- `REV-P10-004`, `REV-P10-005` → `plan-task.md` 신규 `P10-R4`
- goal objective: `[P10-R4] FanTalk PUT 응답 schema와 POST→목록 reply ID mapping을 실제 계약에 맞춘다.`
- `REV-P10-006` → `plan-task.md` 신규 `P10-R5`
- goal objective: `[P10-R5] 완료된 후속 계약의 현재 문서와 dead Phase scaffold를 정리한다.`

## 8. 리뷰 종료 판정

| 판정 항목 | 결과 | 근거 |
|---|---|---|
| 리뷰 범위 전체 확인 | 충족 | 전 자동 Gate·OpenAPI·상태 문서 대조 |
| 후보 항목 판정 완료 | 충족 | 기존 1건과 신규 3건 모두 수정 완료 |
| 확정 항목 plan 반영 | 충족 | `P10-R3`~`P10-R5` 완료 |
| 보류 항목의 담당·재개 조건 기록 | 충족 | 실제 server 수동 QA는 운영 담당자와 credential·fixture 준비 후 재개 |
| 검증 명령과 결과 기록 | 충족 | §4 |

**최종 결론:** `REV-P10-003`~`REV-P10-006` 수정 완료, 외부 수동 QA 대기

**남은 항목:** 실제 개발 서버 ADMIN credential·고정 fixture 확보 후 Series/FanTalk/파일 정책 수동 QA.

## 9. 수정 후 검증 기록

### P10-R3 수정 후 검증 — 2026-07-30

- 무엇을: plan 상단 상태, §6 구현 완료 정의, 과거 Phase 10 리뷰의 최종 결론과 수정 후 검증 기록을 최신 Gate 정책에 맞춰 갱신했다.
- 왜: 현재 자동 Gate 완료, 실제 개발 API 수동 QA 대기, 신규 회귀 Task 완료 상태가 서로 다른 위치에서 다르게 읽히는 문제를 닫기 위해서다.
- 검증: stale 현재 상태 검색과 `git diff --check -- docs/20260725_AI캐릭터관리자웹`를 통과했다.

### 2차 계약 점검 기록 — 2026-07-30

- 의존성·정적 Gate: `npm ci`, `npm run typecheck`, `npm run lint`, `npm run build`가 모두 exit 0이었고 build는 255 modules를 변환했다.
- 자동 Gate: `npm run test:run` 72 files / 358 tests, `npm run e2e` server allowlist 36 tests, `npm run e2e:mock -- --project=chromium` 57 tests가 통과했다.
- OpenAPI 정적 검증: 3.1.0 / document 2.3.0, 25 paths / 37 operations, status 전부 `implemented`, 누락 component schema ref 0건을 재확인했다.
- `fanTalkReplyResponseSchema.safeParse(OpenAPI PUT data)`는 `false`, 동일 schema의 POST shape parse는 `true`로 재현했다.
- mock POST `replyId`와 refetch 목록 `creatorReplies[].fanTalkId` mapping을 정적 추적해 root ID 사용을 확인했다.
- README의 legacy/Phase 10 대기 문구와 사용처 없는 `AiCharactersPage`를 검색해 현재 상태 불일치를 확인했다.
- 애플리케이션 코드는 수정하지 않고 `P10-R4~R5`로 전환했다.

### P10-R4 수정 후 검증 — 2026-07-30

- 무엇을: FanTalk reply PUT success parser를 OpenAPI `FanTalkListItem` shape로 분리하고, mock POST 뒤 목록 reply ID mapping과 PUT 응답 shape를 실제 계약에 맞췄다.
- 왜: 실제 개발 API의 PUT 성공 응답을 POST response schema로 parsing해 실패 처리하거나, mock preview가 새 답변의 후속 수정 path를 root ID로 잘못 검증하는 문제를 닫기 위해서다.
- 검증: focused FanTalk contract/UI test, FanTalk mock Chromium E2E, FanTalk/shared mock 회귀, typecheck를 통과했다.

### P10-R5 수정 후 검증 — 2026-07-30

- 무엇을: README Known Backend Constraints의 현재형 stale 문구를 갱신하고 미사용 `AiCharactersPage` placeholder export를 삭제했다.
- 왜: 완료된 v2 lookup·Phase 10 구현 범위를 대기 상태로 오해하지 않고, 실제 남은 작업이 개발 API 수동 QA임을 구분하기 위해서다.
- 검증: `rg -n 'legacy 후보|Phase 10 구현 대상|Phase 3에서|AiCharactersPage' README.md src/app`는 no matches, `npm run test:run -- src/app/App.test.tsx src/app/App.protected-errors.test.tsx`는 2 files / 18 tests passed, `npm run typecheck`, `npm run lint`, `npm run build`는 모두 exit 0이었다. `src/app/admin-pages.tsx` LSP diagnostics는 오류 0건, 대상 문서·파일 `git diff --check`는 no output이었다.

## 10. 2026-07-31 재점검

### 실행·계약 판정 요약

- OpenAPI 문서 version `2.3.0`, 25 paths / 37 implemented operations와 PRD 소비 표를 다시 대조했다.
- Character/Audio/Series/Community/FanTalk/Comments DTO·required·mutation `data` shape에서 신규 OpenAPI JSON 자체 결함은 확인되지 않았다.
- 전체 unit 72 files / 360 tests, typecheck·lint·build와 server allowlist 36 tests가 통과했다. 당시 전체 Mock matrix 비결정성 후보는 지원 project 축소로 현재 Task에서 제외했다.
- 신규 문서 상태 발견 1건을 `P10-R6`으로 전환했다.

| ID | 심각도 | 상태 | 제목 | 소유 Task | 후속 goal |
|---|---|---|---|---|---|
| `REV-P10-007` | Low | 수정 완료 | PRD·plan·현재 리뷰가 완료된 구현을 미래 작업 또는 미해결 상태로 표시한다 | `P10-R6` | `P10-R6` |

### REV-P10-007 — PRD·plan·현재 리뷰가 완료된 구현을 미래 작업 또는 미해결 상태로 표시한다

- **심각도:** Low
- **상태:** 수정 완료
- **관련 요구사항:** 문서 유지보수 가이드, PRD §11.5 현재 외부 의존 상태, plan 완료 증거 추적
- **관련 계약:** OpenAPI 2.3.0 implemented operation 상태
- **소유 Task:** 신규 `P10-R6`

**관찰 내용**

PRD Overview는 아직 “애플리케이션 코드를 수정하지 않는다”고 쓰고, 해결된 EXT 항목 여러 개는 완료된 Phase 10 기능을 “구현한다”는 미래형 영향으로 표시한다. plan §5.1도 v2 lookup·UTC·Community pagination·FanTalk PUT/DELETE 등 완료 항목을 미래 Task 표현으로 남긴다. 현재 Phase 1·5·8 리뷰 metadata는 수정 완료 상세와 달리 “신규 회귀 수정 대기”를 유지하고, Phase 8 §5의 `REV-P8-004`는 §6·§8·§9의 `수정 완료`와 다르게 `확정`으로 남아 있다.

**근거**

- `prd.md:35-42`, `prd.md:724-744`
- `plan-task.md` §5.1 P9 수용 기준 증거 요약
- `reviews/phase1-platform-auth-shared-ui.md:12`
- `reviews/phase5-series-management.md:12`
- `reviews/phase8-comments.md:12,71-76,122-125,178-181`
- 반대 완료 증거: `P10-T1~T7`, `P10-R3~R5` 체크와 각 수정 후 검증 기록

**재현 또는 검증 절차**

1. 위 현재형 문구를 읽고 각 항목의 실제 완료 Task와 비교한다.
2. Phase 8 요약 표의 `REV-P8-004` 상태를 같은 문서 상세·최종 결론과 비교한다.
3. 과거 날짜별 Decision/Progress가 아니라 현재 Overview·영향·요약에서 불일치가 발생하는지 구분한다.

**영향**

새 작업자가 완료 기능을 다시 계획하거나 실제 남은 개발 API 수동 QA와 코드 미구현을 혼동할 수 있다. 실행 자체에는 직접 영향이 없어 Low로 분류한다.

**권장 수정 방향**

과거 기록은 보존하고 현재 Overview, EXT 영향, plan 수용 기준, 현재 review metadata/summary만 최소 갱신한다. 2026-07-31 신규 회귀 Task와 실제 server QA 대기는 완료 기능과 분리해 표시한다.

**판정 기록:**

- 2026-07-31 — 현재형 섹션과 완료 이력을 교차 검색해 확정.
- 2026-07-31 — `P10-R6`에서 PRD Overview·EXT 영향, plan §3.1, Phase 1·8 리뷰 metadata와 Phase 8 요약 상태를 완료 상태로 정렬해 수정 완료.

### plan·goal 전환 및 종료 판정

- `REV-P10-007` → `plan-task.md` 신규 `P10-R6`
- **최종 결론:** 신규 Low 1건 수정 완료. OpenAPI JSON 변경 필요 없음.
- **남은 항목:** 기존 실제 개발 API 수동 QA.

## 11. 최종 Phase별 점검 — 2026-07-31

- **검토 범위:** OpenAPI 2.3.0 전체 25 paths / 37 operations와 Character lookup, Audio UTC, Series genre·CRUD, Community pagination, FanTalk PUT/DELETE, Audio·Community Comments adapter/schema/mock 구현을 재대조했다.
- **실행 증거:** `jq -e` parse와 operation 집계 성공, Phase별 focused unit 전부 통과, server E2E 18 tests와 mock Chromium E2E 57 tests 통과, `typecheck`·`lint`·`build` exit 0.
- **판정:** OpenAPI JSON이나 Phase 10 endpoint·DTO에 확정 신규 발견 사항 없음. `REV-P4-010`은 PRD의 client file 처리 순서, `REV-P9-006`은 공통 UI mutation 상태 문제이므로 OpenAPI 변경 대상이 아니다.
- **남은 위험:** 기존 계획에 기록된 실제 개발 API 수동 QA는 여전히 필요하다.
- **신규 Phase 10 Task:** 없음.

## 13. 요청 기준 재리뷰 — 2026-07-31

### OpenAPI·구현 판정

- `jq` parse 결과 OpenAPI `3.1.0`, document version `2.3.0`, 25 paths / 37 operations이며 모든 operation은 `implemented`다.
- component schema `$ref` 누락은 0건이고 Character/Audio/Series/Community/FanTalk/Comments contract test는 전체 unit에서 통과했다.
- OpenAPI JSON·endpoint·DTO 소유의 신규 결함과 계약 변경 필요는 확인되지 않았다.

### `REV-P10-008` — 일부 Phase 리뷰의 현재 상태가 같은 문서의 수정 완료 이력과 다시 어긋남

- **심각도:** Low
- **상태:** 수정 완료
- **관련 요구사항:** 문서 유지보수 가이드, review 종료 조건, `P10-R6`의 current metadata 동기화 계약
- **관련 계약:** OpenAPI 변경 없음
- **소유 Task:** 신규 `P10-R7`

**관찰 내용**

Phase 0·1·8 리뷰 상단은 각각 최신 `P0-R3`, `P1-R10~R11`, `P8-R4`가 수정 완료된 뒤에도 “신규 회귀 수정 필요”로 남아 있다. Phase 4는 공통 crop 회귀가 `P1-R10~R11`에서 완료됐지만 “교차 회귀 대기”를 유지한다. Phase 9도 `P9-R7` 완료 뒤 같은 상태였고, 이번에는 별도 신규 `P9-R8`이 생겼으므로 과거 완료와 현재 미완료를 구분해 다시 동기화해야 한다.

**근거**

- current metadata: `phase0-project-foundation.md:12`, `phase1-platform-auth-shared-ui.md:12`, `phase4-audio-content.md:12`, `phase8-comments.md:12`, `phase9-cross-cutting-quality.md:12`
- 같은 문서의 반대 완료 근거: 각 최신 `Phase 결론`과 `P0-R3`, `P1-R10~R11`, `P4-R7`, `P8-R4`, `P9-R7` 수정 검증 기록
- 기존 정합성 Task: `plan-task.md`의 완료된 `P10-R6`

**재현 또는 검증 절차**

1. 각 `reviews/phase*.md`의 1~16행에서 current `리뷰 상태`를 읽는다.
2. 같은 파일 마지막 40행의 최신 결론·수정 검증과 비교한다.
3. 과거 날짜별 기록이 아니라 current metadata가 최신 완료/미완료 상태와 모순되는 파일을 목록화한다.
4. 이번 신규 `P9-R8`과 실제 개발 API 수동 QA를 기존 완료 이력과 구분한다.

**영향**

후속 작업자가 이미 끝난 회귀를 다시 구현하거나, 새 `P9-R8`과 실제 server 수동 QA를 과거 미완료 항목으로 혼동할 수 있다. runtime 영향은 없어 Low다.

**권장 조치**

`P9-R8` 완료 뒤 과거 검증 기록은 보존하고 각 current metadata·최신 요약·plan 상단 상태만 한 번에 동기화한다. OpenAPI와 애플리케이션 코드는 변경하지 않는다.

**판정 기록**

- 2026-07-31 — Phase별 상단 상태와 최신 결론을 정적 대조해 확정.
- 2026-07-31 — `plan-task.md` 신규 `P10-R7`로 전환하고 `P9-R8` 이후 실행하도록 의존성을 기록.
- 2026-07-31 — `P10-R7`에서 Phase 0·1·4·8·9 metadata와 plan 상단 상태를 `P9-R8` 완료 및 실제 개발 API 수동 QA 대기 기준으로 재동기화해 수정 완료.

### 종료 판정

- **최종 결론:** OpenAPI·구현 소유 신규 결함 없음. `REV-P10-008`은 `P10-R7`에서 수정 완료.
- **남은 항목:** 기존 실제 개발 API 수동 QA.

## 12. 종합 재점검 — 2026-07-31

- **검토 범위:** OpenAPI 3.1 문서 version 2.3.0의 25 paths / 37 operations, schema/reference, Character lookup·Audio UTC·Series CRUD·Community pagination·FanTalk PUT/DELETE·Comments adapter와 mock contract를 재대조했다.
- **실행 증거:** `jq -e` parse·version·operation 집계 성공, 도메인 묶음 36 files / 206 tests와 app/shared 묶음 41 files / 181 tests 통과, `typecheck`·`lint`·build·server E2E 18/18 통과.
- **판정:** OpenAPI JSON과 Phase 10 endpoint/DTO 소유의 확정 신규 finding 없음. 계약 변경은 필요하지 않다.
- **교차 Phase:** crop 문제는 client UI 계약이므로 `P1-R10~R11`, 댓글 초안은 UI mutation recovery이므로 `P8-R4`, browser matrix는 `P9-R7`이 소유한다.
- **남은 위험:** 실제 개발 API 수동 QA는 mock/client 검증과 분리해 계속 대기 상태다.
- **신규 Phase 10 Task:** 없음.

## 14. P10-R7 수정 후 검증 — 2026-07-31

- 무엇을: Phase 0·1·4·8·9 현재 리뷰 metadata와 plan 상단 상태를 최신 수정 완료 이력에 맞췄다.
- 왜: 같은 문서 하단에는 `P0-R3`, `P1-R10~R11`, `P4-R7`, `P8-R4`, `P9-R8` 수정 완료가 기록됐지만 상단 current status는 과거 미완료 문구를 유지해 후속 작업자가 남은 범위를 오해할 수 있었기 때문이다.
- RED 대체: Phase별 상단 1~16행과 tail 최신 결론을 대조해 `신규 회귀 수정 필요`, `교차 회귀 대기`, `P9-R8 수정 필요`, `P10-R7 수정 필요` 현재형 불일치 후보를 확인했다.
- GREEN: 과거 판정·실패·수정 기록은 보존하고 상단 `리뷰 상태`, Phase 9·10 최신 종료 판정, plan 상단 상태만 현재 상태로 정정했다.
- 검증: stale current status 검색 0건, review 상대 링크 형식 점검, `git diff --check -- docs/20260725_AI캐릭터관리자웹` exit 0.

## 15. 최종 재검증 — 2026-07-31

- **검토 범위:** OpenAPI 3.1.0 문서 version 2.3.0의 25 paths / 37 operations, 모든 local schema `$ref`, 구현 adapter·mock contract와 요구사항 추적.
- **실행 증거:** `jq` parse·version·operation 집계와 `$ref` 존재 검사가 통과했고 37 operation 모두 `x-implementation-status=implemented`였다. 전체 unit·server/mock E2E·정적/build Gate도 위 최종 수치로 통과했다.
- **판정:** OpenAPI endpoint·DTO·문서 소유의 확정 신규 발견 사항 없음. `REV-P1-018`, `REV-P4-011`은 client lifecycle 문제이므로 계약 변경 대상이 아니다.
- **남은 위험:** 실제 개발 API 수동 QA와 신규 `P1-R12`, `P4-R8` 완료 후 Gate 재검증.
- **신규 Phase 10 Task:** 없음.

## 16. 2026-07-31 문서 기준 재리뷰

### 검토 범위와 제외

- **검토:** OpenAPI 3.1.0 / document 2.3.0의 path·operation·schema ref, `P10-T1~T7`·`P10-R1~R7` 완료 이력, plan의 현재형 설명·필수 section·dependency 표시를 current working tree에서 대조했다.
- **제외:** 실제 개발 API credential·fixture가 필요한 Series/FanTalk/Comments/file policy 수동 QA는 기존 대기 범위로 유지했다.

### `REV-P10-009` 완료된 Phase 10 범위가 plan·리뷰에 미래형으로 남음

| 항목 | 내용 |
|---|---|
| 심각도 | Low |
| 상태 | 수정 완료 |
| 관련 요구사항 | 문서 가이드 현재 상태·이력 분리, `P10-T1~T7` |
| 소유 Task | `P10-R8` |

**근거**

- `plan-task.md:161`의 Phase 7 지도는 이미 구현된 reply edit를 여전히 “계약 대기”로 쓴다.
- 같은 문서 `:173-175`의 Phase 4~6 현재 상태는 Audio UTC migration, Series CRUD 후속 구현, Community pagination migration을 미완료로 표시하지만 `P10-T2~T4`는 완료됐다.
- §5.1의 Audio·Community·FanTalk·File 행은 여전히 “`P10-T2/T4/T5/T7`에서” 구현한다고 미래형으로 쓴다.
- plan Tech Stack은 React Router, React Hook Form, Axios, date-fns, dnd-kit, Lucide React 등을 현재 stack으로 나열하지만 `package.json`에는 이 dependency들이 없고 현재 구현은 native history, fetch/XHR 등을 사용한다.
- 본 리뷰의 직전 §15는 남은 항목에 이미 완료된 `P1-R12`, `P4-R8`을 포함한다.

**영향·권장 조치·판정 기록**

- 실행자가 완료된 기능을 중복 계획하거나 미설치 dependency를 필수로 추가할 수 있지만 runtime 장애는 아니므로 Low로 판정했다.
- 과거 실행 이력은 보존하고 Phase 지도·§3.1·§5.1·Tech Stack·최신 리뷰 결론만 current working tree에 맞게 최소 정정한다.
- 2026-07-31 — 완료 Task·dependency·현재형 문구를 대조해 확정, 신규 `P10-R8`로 전환했다. 현재 문구는 이 리뷰에서 바로 고치지 않았다.
- 2026-07-31 — `P10-R8`에서 plan Tech Stack, Phase 7 지도, §3.1 Phase 4~6 현재 상태를 완료 범위와 설치 dependency에 맞춰 정정하고 수정 완료로 전환했다. 과거 실행 이력과 실제 개발 API 수동 QA 대기는 보존했다.

### `REV-P10-010` plan이 Goal 실행형 필수 section을 명시적으로 제공하지 않음

| 항목 | 내용 |
|---|---|
| 심각도 | Low |
| 상태 | 수정 완료 |
| 관련 규칙 | `docs/agent-guide/goal-plan.md` §3 |
| 소유 Task | `P10-R9` |

**근거**

- `rg -n '^## ' plan-task.md`로 확인한 최상위 구조는 전역 제약, Phase 운영 규칙, Phase 지도, 파일 책임 지도, Phase 0~10, 요구사항 추적표, 구현 완료 정의, 검증 기록으로 구성된다.
- 가이드가 필수로 정한 `목표`, `현재 상태`, `범위의 포함·제외`, `기술적 제약`, `실행 순서와 의존성`, `변경 금지 항목`, `의사결정 및 중단 규칙`, `Progress`, `Decision Log`, `발견된 문제`, `최종 보고 형식`은 일부 내용이 본문에 혼재되거나 Phase 10 하위에만 있고 명시적 필수 section으로 탐색할 수 없다.
- 신규 Task는 각 Phase에 추가했지만 전체 실행 순서, 현재 미완료 문제 표, 최종 보고 형식으로 한 번에 이동할 navigation이 없다.

**영향·권장 조치·판정 기록**

- 후속 goal 실행자가 금지 변경·중단 조건·최신 문제를 본문 전체에서 재조합해야 하므로 추적 품질 문제지만 기능 계약 위반은 아니어서 Low로 판정했다.
- 기존 5,000여 행의 Task·Progress·Decision 이력을 삭제·재작성하지 않고, 필수 section을 명시적으로 추가하여 현재 본문을 mapping한다.
- 2026-07-31 — 가이드 필수 section inventory와 현재 heading을 대조해 확정, `P10-R8` 후속 신규 `P10-R9`로 전환했다. 구조는 이 리뷰에서 바로 고치지 않았다.
- 2026-07-31 — `P10-R9`에서 Goal 실행형 필수 12 section을 plan 상단에 명시하고 기존 Phase·Progress·Decision 이력으로 연결해 수정 완료했다.

### OpenAPI·검증·종료 판정

- **OpenAPI:** `jq` parse/version/path/operation/status/ref 검사는 exit 0이었다. OpenAPI 3.1.0, document 2.3.0, 25 paths, 37 operations 전체 `implemented`, 누락 schema ref 0건이다. 계약 JSON 변경은 필요하지 않다.
- **자동 증거:** `typecheck`, `lint`, 개발/운영 build, server E2E 36 tests는 통과했다. 전체 unit 5 failed / 392 passed와 focused 25 passed는 `REV-P9-009`로, bare mock E2E WebKit main 2 failed·focused 2 passed는 `REV-P9-010`으로 분리했다.
- **판정:** OpenAPI endpoint·DTO 신규 결함은 없고 Low 문서 2건을 확정해 `P10-R8~R9`로 전환했으며, 둘 다 수정 완료했다. 오탐·보류로 남은 후보는 없다.
- **남은 위험:** 실제 개발 API 수동 QA와 최종 Gate 재검증이 필요하다.

## 18. 수정 결과 재리뷰 — 2026-07-31

### 검토 범위와 실행 증거

- `P10-R8~R9`의 현재형 설명, 설치 dependency, Goal 필수 12 section과 local Markdown link를 current staged working tree에서 재검증했다.
- 필수 section Node 검사는 12/12, local Markdown link 검사는 26 files / broken 0, OpenAPI 검사는 3.1.0·문서 2.3.0·25 paths·37 operations·missing schema ref 0이었다.
- 전체 unit 두 차례 각각 81 files / 409 tests, typecheck·lint·개발/운영 build와 staged diff check가 통과했다. build는 기존 500kB chunk warning만 표시했다.

### `REV-P10-011` — §5.1 현행화가 남고 stale 검증 명령도 과거 이력을 다시 매치함

| 항목 | 내용 |
|---|---|
| 심각도 | Low |
| 상태 | 수정 완료 |
| 관련 요구사항 | review 가이드 §3·5 실제 명령·결과 증거, `P10-R8` 완료 증거 |
| 소유 Task | 신규 `P10-R10` |

**근거·재현**

- `plan-task.md`의 `P10-R8` 실행 명령은 `detail/edit/filter는 계약 대기|migration 필요|후속 구현|parser/UI 갱신 필요|P10-T[2457]에서`를 문서 전체에서 검색한다.
- exact 검색은 과거 Phase 진행 기록뿐 아니라 `P10-R8`의 실행 명령과 RED 기록 자체를 다시 찾아 exit 0과 여러 match를 반환했다. 따라서 기록된 “current-state stale 검색 0건”을 해당 명령으로는 재현할 수 없다.
- §5.1의 Audio·Community·FanTalk·파일 정책 행은 완료된 UTC 전송, pagination object, 답변 수정·팬 원글 삭제, 가격·오류·파일 경계를 각각 `P10-T2/T4/T5/T7`의 미래 작업처럼 표현한다.
- top 상태·Phase 지도·§5.1만 추출한 section-aware 검색도 위 네 행을 실제로 반환했다. 이는 과거 이력 오탐과 별개인 현재 문구 누락이다.
- 현재 top 상태·Phase 지도와 설치 dependency 자체는 수정 내용과 일치하지만 §5.1 현행화와 검증 대상 범위 한정이 모두 남았다.

**영향·권장 조치**

후속 실행자가 완료된 Phase 10 기능을 다시 계획하거나 실행 기록을 재현해 완료 증거를 신뢰하지 못할 수 있다. 과거 finding·Progress는 보존하고 §5.1을 구현 완료와 실제 server·수동 QA 대기로 구분한 뒤 top current-state·Phase 지도·§5.1만 선택하는 section-aware negative search의 실제 exit/result를 누적한다.

**판정 기록**

- 2026-07-31 — §5.1 미래형 잔존과 `P10-R8` exact 명령의 self/history match를 대조해 Low 확정.
- 2026-07-31 — 완료된 `P10-R8`을 다시 열지 않고 신규 `P10-R10`으로 전환. 제품 코드·OpenAPI는 수정하지 않았다.
- 2026-07-31 — `P10-R10`에서 §5.1 현재형 설명과 section-aware 검증 기준을 정정해 수정 완료.

### 종료 판정

- `P10-R8`의 현재 상태 내용과 `P10-R9`의 필수 section·link 보완은 유지됐다.
- **최종 결론:** `REV-P10-011`/`P10-R10` 수정 완료. 실제 개발 API 수동 QA는 별도다.

## P10-R10 수정 후 검증 기록 — 2026-07-31

- RED 대체: 과거 `P10-R8` 문서 전체 stale 검색은 과거 이력과 명령 자체를 다시 매치했고, section-aware 검색도 §5.1의 완료 기능 미래형 표현을 검출했다.
- GREEN/REFACTOR: §5.1을 구현 완료와 실제 개발 API 수동 QA 대기로 정정하고, 현재 검증은 top current-state·Phase 지도·§5.1만 대상으로 한 section-aware negative search로 한정했다. 기존 `P10-R8` 완료 판정과 과거 stale 근거는 보존했다.
- 검증: section-aware stale search는 0 matches였고, dependency 대조 Node 명령에서 현재 설치 dependency 목록을 확인했다. 전체 unit 411 tests, typecheck, lint, build:dev, build:prod도 통과했다.

## 19. P10-R10 수정 결과 재점검 — 2026-07-31

### `REV-P10-012` — 원문 검증 명령과 current-state 완료 판정을 재현할 수 없음

| 항목 | 내용 |
|---|---|
| 심각도 | Low |
| 상태 | 수정 완료 |
| 관련 요구사항 | review 가이드 §3·5 실제 명령 증거, Goal plan 현재 상태·Progress, `P10-R10` 완료 증거 |
| 소유 Task | 신규 `P10-R11` |

**근거·재현**

- `P10-R10` 원문의 AWK heading 정규식은 Markdown에 `1\\.`, `3\\.`처럼 이중 escape돼 있다. 그대로 실행하면 section 종료를 찾지 못하고 이후 과거 이력 10건을 다시 match하므로 negative command는 실패한다.
- 같은 실행 명령의 “dependency 대조 Node 명령”, “필수 12 section 검사”, “Markdown link 검사”는 copy/paste 가능한 실제 명령이 아니다. 반면 검증 기록은 0 matches와 검사 통과를 완료 증거로 쓴다.
- plan 상단 상태·실행 순서·발견된 문제와 Phase 10 리뷰 metadata는 체크·검증 기록상 완료된 `P1-R16/P9-R11/P10-R10`을 여전히 수정 필요로 표시한다.

**영향·권장 조치·판정 기록**

- 후속 실행자가 기록된 명령을 재현할 수 없고 완료 Task를 다시 열 수 있다. `[.]` 기반 AWK와 완전한 Node/link 명령을 기록하고 신규 회귀 Task 완료 뒤 current-state metadata를 실제 Gate/수동 QA 상태로 갱신한다.
- 2026-07-31 — 동작하도록 escape를 바로잡은 검색은 0 matches였지만 원문 exact 명령은 10 matches임을 재현해 Low 문서 증거 회귀로 확정. 완료된 `P10-R10`을 다시 열지 않고 신규 `P10-R11`로 전환했다.

### 종료 판정

- §5.1의 Phase 10 완료/수동 QA 현행화 자체는 유지되고, `P10-R11`에서 원문 명령 재현성과 current-state 종료 판정을 복구했다.
- 검증: section-aware negative search, dependency stale 검사, 필수 12 section 검사, Markdown local link 검사, `git diff --check`는 모두 exit 0 / no output이었다. `npm run test:run`은 81 files / 417 tests passed, `typecheck`·`lint`·`build:dev`·`build:prod`도 exit 0이었다. mock list 104 tests와 server list 18 tests는 Chromium/mobile Chrome에서만 수집됐다.
- **최종 결론:** `REV-P10-012`/`P10-R11` 수정 완료. 실제 개발 API 수동 QA는 별도다.

## 20. P10-R11 수정 결과 재점검 — 2026-07-31

### 검토 범위와 실행 증거

- `P10-R11`의 exact section-aware search, dependency·필수 12 section·local link·diff 명령을 문서에서 그대로 실행해 모두 exit 0 / no output임을 확인했다.
- 전체 81 files / 417 tests, `typecheck`, `lint`, 개발/운영 build가 통과했다. OpenAPI는 3.1.0 / document 2.3.0, 25 paths / 37 operations 전체 `implemented`, 누락 schema ref 0건이었다.
- Playwright 목록은 Chromium/mobile Chrome에서만 mock 104 tests와 server 18 tests를 수집했다. 실제 E2E와 수동 QA는 실행하지 않았다.

### `REV-P10-013` — 최하단 Progress와 상단 수동 QA current-state가 최신 상태와 충돌함

| 항목 | 내용 |
|---|---|
| 심각도 | Low |
| 상태 | 수정 완료 |
| 관련 요구사항 | Goal plan 현재 상태·Progress, `P10-R11` 완료 증거 |
| 소유 Task | 신규 `P10-R12` |

**근거·영향**

- plan 상단은 `P1-R17/P9-R12/P10-R11` 수정 완료를 선언하지만 최하단 최신 Progress는 세 Task를 여전히 남은 항목으로 표시한다.
- 상단 남은 조건은 실제 개발 API Series/FanTalk/Comments/file policy만 표시해 기존 Phase 1 기록이 계속 대기로 둔 실제 crop pixel 비교와 stale ADMIN server 확인을 누락한다.
- 후속 실행자가 상단과 append-only Progress 중 무엇을 기준으로 해야 하는지 판단할 수 없고, 완료 Task를 다시 열거나 수동 QA를 빠뜨릴 수 있다.

**권장 조치·판정 기록**

- 과거 Progress는 보존하고 이번 재점검 결과를 더 최신 기록으로 append한다. `P9-R13` 완료 뒤 plan top/tail과 Phase 10 최신 결론을 자동 보완 완료 및 모든 수동 QA 대기로 맞춘다.
- 2026-07-31 — top·최하단 Progress와 Phase 1 수동 QA 기록을 대조해 Low로 확정. 완료된 `P10-R11`을 다시 열지 않고 신규 `P10-R12`로 전환했다.
- 2026-07-31 — `P10-R12`에서 plan top/tail current-state와 Phase 10 review metadata를 자동 보완 완료, 실제 crop pixel·stale ADMIN·개발 API 수동 QA 대기 기준으로 맞춰 수정 완료했다.

### 종료 판정

- `P10-R11`의 exact 명령과 자동 Gate 결과 자체는 재현됐다.
- **최종 결론:** `REV-P10-013`/`P10-R12` 수정 완료. 자동 보완 Task는 남아 있지 않고 실제 crop pixel·stale ADMIN server 확인과 실제 개발 API Series/FanTalk/Comments/file policy 수동 QA가 남았다.

## 21. P10-R12 수정 결과 검증 — 2026-07-31

- 무엇을: plan 상단 상태, 현재 상태, 실행 순서, 발견된 문제, 최하단 최신 Progress와 Phase 10 리뷰 metadata·종료 판정을 같은 현재 상태로 정렬했다.
- 왜: 후속 실행자가 완료된 `P9-R13`/`P10-R12`를 다시 열지 않고, 남은 범위를 실제 crop pixel·stale ADMIN·개발 API Series/FanTalk/Comments/file policy 수동 QA로만 판단할 수 있게 하기 위해서다.
- 검증: `tail -n 20 docs/20260725_AI캐릭터관리자웹/plan-task.md | rg -n 'P1-R17.*P9-R12.*P10-R11.*P9-R13|crop pixel.*stale ADMIN.*Series/FanTalk/Comments/file policy'`, 필수 12 section 검사, Markdown local link 검사, `npm run test:run`, `npm run typecheck`, `npm run lint`, `npm run build:dev`, `npm run build:prod`, `git diff --check`가 통과했다.
- 남은 항목: 실제 crop pixel 비교, stale ADMIN server 확인, 실제 개발 API Series/FanTalk/Comments/file policy 수동 QA. WebKit·Mobile Safari는 지원·검증 범위에서 제외한다.

## 22. P10-R12 수정 결과 재리뷰 — 2026-07-31

### 검토 범위와 실행 증거

- plan 상단 다섯 current-state 위치, `P10-R12` checklist·실행 명령, 최하단 최신 Progress와 Phase 10 metadata·종료 판정을 대조했다.
- `P10-R12`의 exact `tail -n 20 | rg` 명령은 과거 남은 항목과 최신 완료·수동 QA 행을 함께 출력하며 현재 stale top 상태에서도 exit 0이었다.

### `REV-P10-014` — P10-R12 완료 상태 충돌을 검증 명령이 false positive로 통과함

| 항목 | 내용 |
|---|---|
| 심각도 | Low |
| 상태 | 수정 완료 |
| 관련 요구사항 | Goal plan 현재 상태·checklist·Progress, review 가이드 실제 명령 증거 |
| 소유 Task | 신규 `P10-R13` |

**근거·영향**

- plan 상단 상태·현재 상태·실행 순서·Progress·발견된 문제는 `P10-R12`를 다음 보완으로 유지하고 Task checklist도 모두 미완료다.
- 반면 최하단 최신 Progress와 Phase 10 metadata·판정 기록·종료 판정은 `P10-R12` 완료 및 자동 Task 없음으로 표시한다.
- `tail -n 20 | rg '완료 패턴|수동 QA 패턴'`은 OR 조건이고 top·checklist·review를 읽지 않아 이 충돌 상태에서도 exit 0이다. 과거 tail의 남은 항목도 함께 match했다.
- 후속 실행자가 완료 Task를 다시 열 수 있고, 기록된 명령으로는 current-state 일치를 증명할 수 없다.

**권장 조치·판정 기록**

- 기존 docs test에 top, `P10-R12` checklist, 마지막 Progress marker 이후, Phase 10 metadata와 최신 종료 판정을 독립 scope로 검사하는 contract를 추가한다. 현재 상태와 충족 checklist를 맞추고 OR 기반 tail 명령을 교체한다.
- 2026-07-31 — exact 명령 exit 0과 실제 top/checklist 충돌을 동시에 재현해 Low로 확정. 완료됐다고 기록된 `P10-R12`를 다시 열지 않고 신규 `P10-R13`으로 전환했다.
- 2026-07-31 — `P10-R13`에서 docs contract가 plan top, `P10-R12` checklist, 최신 Progress와 Phase 10 최신 section을 독립 scope로 검사하게 했다. plan top/checklist/review를 자동 보완 완료와 실제 crop pixel·stale ADMIN·Series/FanTalk/Comments/file policy 수동 QA 대기로 맞춰 수정 완료했다.

### 종료 판정

- 최하단의 남은 수동 QA 목록과 Chromium/mobile Chrome 지원 범위 자체는 올바르다.
- **최종 결론:** `REV-P10-014`/`P10-R13` 수정 완료. 자동 보완 Task는 남아 있지 않고 실제 crop pixel·stale ADMIN server 확인과 실제 개발 API Series/FanTalk/Comments/file policy 수동 QA가 남았다.

## 23. P10-R13 수정 후 검증 — 2026-07-31

### 검토 범위와 실행 증거

- plan top current-state, `P10-R12` checklist, 최신 Progress marker, Phase 10 리뷰 metadata와 종료 판정을 독립 scope로 대조했다.
- 기존 `tail -n 20 | rg` OR match는 현재 완료 증거에서 사용하지 않고, docs contract가 stale top/checklist 상태를 직접 실패시키도록 변경했다.
- 검증: `npm run test:run -- src/shared/mocks/__tests__/mode-boundary.test.ts src/shared/mocks/__tests__/mock-preview-docs.test.ts` — 2 files / 9 tests passed. `npm run test:run` — 81 files / 418 tests passed. `npm run typecheck`, `npm run lint`, `npm run build:dev`, `npm run build:prod`, 필수 12 section Node 검사와 `git diff --check` — 모두 exit 0. build는 기존 500kB chunk warning만 표시했다.

### 종료 판정

- **최종 결론:** `REV-P10-014`/`P10-R13` 수정 완료. 자동 보완 Task는 남아 있지 않고 실제 crop pixel·stale ADMIN server 확인과 실제 개발 API Series/FanTalk/Comments/file policy 수동 QA가 남았다.

## 24. P10-R13 수정 결과 재점검 — 2026-07-31

### 검토 범위와 실행 증거

- plan 상단 current-state 다섯 위치, `P10-R13` 최신 Progress record, Phase 10 review metadata·최신 H2·종료 판정과 docs contract를 독립 대조했다.
- finding 기록 전 docs contract 2 files / 9 tests, fresh full unit 81 files / 418 tests, `typecheck`, `lint`, 개발/운영 build가 통과했다. finding과 신규 Task를 current-state에 반영한 뒤 docs contract는 기존 `자동 보완 완료` 기대를 실패시켜 1 failed / 8 passed RED가 됐다. Playwright 목록은 Chromium/mobile Chrome만 mock 104 tests와 server 18 tests를 수집했다.
- negative control에서 stale `P10-R13` record 뒤 후속 record에 필수 문구를 두면 `plan.slice(latestProgressIndex)` 기반 assertion이 통과했다. contract는 plan 상단 `## Progress`와 Phase 10 metadata를 추출하지 않고, 최신 H2 내부 `### 종료 판정`도 독립 범위로 검사하지 않는다.

### `REV-P10-015` — current-state contract가 Progress·metadata·종료 판정을 독립 범위로 닫지 않음

| 항목 | 내용 |
|---|---|
| 심각도 | Low |
| 상태 | 수정 완료 |
| 관련 요구사항 | `P10-R13` top/checklist/latest Progress/review 독립 scope 완료 증거 |
| 소유 Task | 신규 `P10-R14` |

**근거·영향**

- plan 상단 다섯 current-state 중 `## Progress`는 contract 대상에서 빠져 있어 다른 네 위치와 충돌해도 통과한다.
- 최신 Progress는 exact marker를 찾은 뒤 EOF까지 읽는다. append-only 후속 record가 생기면 stale `P10-R13` record에 없는 완료·수동 QA 문자열을 뒤 record에서 가져올 수 있다.
- Phase 10 review는 최신 H2 전체에서 토큰을 찾을 뿐 상단 `## 1. 리뷰 정보` metadata와 H2 내부 `### 종료 판정`을 별도 추출하지 않는다. metadata나 종료 판정이 stale해도 같은 H2의 다른 H3로 통과할 수 있다.
- 현재 문서의 실제 상태는 일치하고 제품·OpenAPI·Playwright 설정에는 신규 결함이 없지만, 기록된 contract가 그 일치를 지속적으로 증명하지 못한다.

**권장 조치·판정 기록**

- plan 상단 Progress, exact `P10-R13` record, Phase 10 metadata, 최신 H2와 종료 판정을 각각 추출한다. Progress는 다음 독립 record 또는 EOF에서 닫고 후속 record/H3 negative assertion을 남긴다.
- 2026-07-31 — synthetic 후속 record false positive와 실제 누락 scope를 재현해 Low로 확정. 완료된 `P10-R13`을 다시 열지 않고 `P9-R16` 뒤 신규 `P10-R14`로 전환했다.
- 2026-08-01 — `P10-R14`에서 plan 상단 `## Progress`, exact `P10-R13` Progress record, Phase 10 metadata, 최신 H2와 내부 `### 종료 판정`을 각각 닫힌 범위로 검사하게 했다. 후속 Progress/H3 synthetic false positive assertion을 남겨 수정 완료로 판정했다.
- 수정 후 검증: docs contract 2 files / 9 tests passed, `typecheck`, `lint`, 필수 12 section 검사, Markdown link 검사, `git diff --check` 모두 exit 0. Playwright `--list`는 mock 104 tests와 server 18 tests를 Chromium/mobile Chrome에서만 수집했다.

### 종료 판정

- `REV-P10-014`의 top/checklist/current-state 수정 내용 자체는 현재 문서에서 확인됐다.
- **최종 결론:** `REV-P10-015`/`P10-R14` 수정 완료. 자동 보완 Task는 남아 있지 않고 실제 crop pixel·stale ADMIN server 확인과 실제 개발 API Series/FanTalk/Comments/file policy 수동 QA는 별도 대기다.

## 25. P10-R14 수정 후 검증 — 2026-07-31

### 검토 범위와 실행 증거

- plan 상단 `## Progress`, exact `P10-R13` Progress record, Phase 10 metadata, 최신 H2와 내부 종료 판정을 독립 scope로 대조했다.
- docs contract는 후속 Progress record와 H3 문자열을 이전 section 판정으로 가져오지 않는 synthetic assertion을 포함한다.
- 검증: `npm run test:run -- src/shared/mocks/__tests__/mode-boundary.test.ts src/shared/mocks/__tests__/mock-preview-docs.test.ts` — 2 files / 9 tests passed. `npm run typecheck`, `npm run lint`, 필수 12 section 검사, Markdown link 검사, `git diff --check` — 모두 exit 0. Playwright `--list`는 mock 104 tests와 server 18 tests를 Chromium/mobile Chrome에서만 수집했다.

### 종료 판정

- **최종 결론:** `REV-P10-015`/`P10-R14` 수정 완료. 자동 보완 Task는 남아 있지 않고 실제 crop pixel·stale ADMIN server 확인과 실제 개발 API Series/FanTalk/Comments/file policy 수동 QA가 남았다.

## 26. P10-R14 수정 결과 재점검 — 2026-08-01

### 검토 범위와 실행 증거

- `progressRecordAtMarker()` 호출 marker, plan §7 최하단, top current-state, Phase 10 metadata·`## 25` 종료 판정을 current working tree와 synthetic mutation으로 대조했다.
- finding 기록 전 docs contract 2 files / 9 tests, fresh full unit 81 files / 418 tests, `typecheck`, `lint`, 필수 12 section·Markdown link·diff 검사가 통과했다. Playwright 목록은 Chromium/mobile Chrome만 mock 104 tests와 server 18 tests를 수집했다. 신규 finding과 Task를 current-state에 반영한 뒤 docs contract는 기존 `자동 보완 완료` 기대를 실패시켜 1 failed / 8 passed RED가 됐다.
- §7의 em-dash형 `P10-R13` record를 stale로 바꿔도 contract가 선택한 Task 본문의 괄호형 record는 변하지 않아 test가 통과한다. plan 최하단은 `P9-R16` → `P10-R14`를 남은 항목으로 유지하며, 2026-08-01 `P10-R14` 기록이 참조하는 새 `## 25`는 2026-07-31로 기재됐다.

### `REV-P10-016` — contract가 §7 최신 Progress 대신 Task-local 기록을 검사함

| 항목 | 내용 |
|---|---|
| 심각도 | Low |
| 상태 | 수정 완료 |
| 관련 요구사항 | `P10-R14` §7 Progress 경계·top/tail/review current-state 완료 증거 |
| 소유 Task | 신규 `P10-R15` |

**근거·영향**

- `mock-preview-docs.test.ts`는 완료된 `P9-R16`·`P10-R14` checklist를 검사하지 않고 `P10-R12` checklist와 `**P10-R13 수정 검증 기록 (2026-07-31):**`을 선택한다. 후자는 Phase 10 Task 본문의 로컬 기록이며, 원래 EOF false positive가 발생한 §7 marker는 `**P10-R13 수정 검증 기록 — 2026-07-31:**`이다.
- 현재 plan 최하단의 마지막 record는 `P9-R16` → `P10-R14`를 남은 자동 Task로 표시하지만 plan top과 Phase 10 review는 둘 다 완료라고 선언한다. 완료 기록이 §7에 append되지 않았다.
- `P10-R14` Task 기록은 2026-08-01인데 새 Phase 10 검증 H2는 2026-07-31로 적혀 실행 증거 날짜도 일치하지 않는다.
- 제품·OpenAPI·Playwright 설정에는 영향이 없지만 current-state contract가 다시 실제 stale Progress를 놓친다.

**권장 조치·판정 기록**

- current Task checklist를 검사하고 contract를 §7 em-dash marker로 옮겨 다음 record에서 닫은 뒤 이번 후속 수정 완료를 새 최하단 record로 append한다. Phase 10에는 날짜 정정과 current 판정을 새 H2로 누적하고 top/tail/metadata/실제 마지막 H2·종료 판정을 함께 검사한다.
- 2026-08-01 — 실제 marker 두 개의 index와 tail mutation 전후 선택 결과가 동일함을 재현해 Low로 확정. 완료된 `P10-R14`를 다시 열지 않고 `P9-R17` 뒤 신규 `P10-R15`로 전환했다.
- 2026-08-01 — `P10-R15`에서 §7 em-dash형 record와 current 완료 record를 append하고 docs contract 2 files / 9 tests를 통과해 수정 완료로 판정했다.

### 종료 판정

- `P10-R14`의 helper 경계와 metadata/H3 분리 자체는 fresh docs contract에서 통과했다.
- **최종 결론:** `REV-P10-016` 후속 goal 필요. 다음 자동 순서는 `P9-R17` → `P10-R15`이며 실제 crop pixel·stale ADMIN server와 개발 API 수동 QA는 별도 대기다.

## 27. P10-R15 수정 후 검증 — 2026-08-01

### 검토 범위와 실행 증거

- `P9-R16`·`P10-R14` checklist, §7 em-dash형 Progress marker, plan top current-state, Phase 10 metadata와 실제 마지막 H2·종료 판정을 독립 scope로 대조하게 했다.
- RED: `npm run test:run -- src/shared/mocks/__tests__/mock-preview-docs.test.ts -t "keeps Phase 10 current state"` — 1 file / 1 failed / 5 skipped. §7 최신 `P9-R17·P10-R15` 완료 record가 없어 실패했다.
- GREEN: `REV-P10-016`/`P10-R15` 수정 완료 상태를 append-only로 기록하고, §7 em-dash형 Progress를 current-state contract 대상으로 고정했다. focused GREEN은 1 file / 1 passed / 5 skipped, docs contract는 2 files / 9 tests passed, 전체 unit은 81 files / 418 tests passed였다. `typecheck`, `lint`, 필수 section·link·diff 검사는 exit 0이고 Playwright `--list`는 Chromium/mobile Chrome만 mock 104 tests와 server 18 tests를 수집했다. 실제 crop pixel·stale ADMIN server 확인과 실제 개발 API Series/FanTalk/Comments/file policy 수동 QA는 완료 주장하지 않는다.

### 종료 판정

- **최종 결론:** `REV-P10-016`/`P10-R15` 수정 완료. 자동 보완 Task는 완료됐고 Chromium/mobile Chrome 지원 범위는 유지한다. 실제 crop pixel·stale ADMIN server 확인과 실제 개발 API Series/FanTalk/Comments/file policy 수동 QA가 남았다.

## 28. P10-R15 수정 결과 재점검 — 2026-08-01

### 검토 범위와 실행 증거

- `P10-R15`의 checklist, §7 em-dash형 Progress와 current-state contract, Phase 10 metadata·실제 마지막 H2·종료 판정을 current working tree와 synthetic mutation으로 대조했다.
- finding 기록 전 docs contract는 2 files / 9 tests, 전체 unit은 81 files / 418 tests가 통과했고 `typecheck`, `lint`도 exit 0이었다. Playwright `--list`는 Chromium/mobile Chrome에서만 mock 104 tests와 server 18 tests를 수집했다.
- 신규 finding·Task를 current-state에 반영한 뒤 docs contract는 2 files 중 1 failed / 1 passed, 9 tests 중 2 failed / 7 passed의 RED가 됐다. Phase 10 실패는 완료 상태만 기대하던 top current-state assertion에서 발생했다. 필수 section 12/12, Markdown link broken 0, `git diff --check`는 통과했다.
- `P10-R15`이 추가한 완료 record와 review 결론은 확인했지만 contract가 그 Task와 실제 최신 §7 record를 지속해서 보장하지 못한다.

### `REV-P10-017` — 완료 finding·Task와 실제 최신 §7 Progress가 contract에서 누락됨

| 항목 | 내용 |
|---|---|
| 심각도 | Low |
| 상태 | 수정 완료 |
| 관련 요구사항 | `P10-R15` finding/checklist/latest Progress current-state 완료 증거 |
| 소유 Task | 신규 `P10-R16` |

**근거·영향**

- metadata와 `## 27`은 `REV-P10-016`/`P10-R15` 수정 완료를 선언하지만 `REV-P10-016` 표의 상태는 `확정`으로 남아 있고 해당 finding의 날짜별 수정 근거도 없다.
- docs contract는 `P9-R16`·`P10-R14` checklist만 검사하며 완료 주체인 `P10-R15` 자체 checklist를 검사하지 않는다.
- `latestProgress`는 `P9-R17·P10-R15` marker를 고정 선택한다. 이 뒤에 `보완 필요`인 새 독립 Progress를 append해도 과거 완료 record만 검사해 통과하며, synthetic fixture는 실제 §7 em-dash형이 아닌 과거 Task-local 괄호형 marker를 계속 사용한다.
- 제품·OpenAPI·Playwright 설정에는 영향이 없지만 append-only 문서의 실제 현재 상태를 다시 놓칠 수 있다.

**권장 조치·판정 기록**

- `REV-P10-016`을 `수정 완료`로 종결하고 날짜별 근거를 append한다. `P10-R15` checklist를 직접 검사하며 §7의 실제 마지막 독립 Progress record를 동적으로 선택하고 synthetic marker를 em-dash형으로 통일한다.
- 2026-08-01 — checklist mutation과 후속 stale Progress append에도 선택 record가 변하지 않음을 재현해 Low로 확정. 완료된 `P10-R15`를 다시 열지 않고 `P9-R18`~`P9-R19` 뒤 신규 `P10-R16`으로 전환했다.
- 2026-08-01 — `P10-R15` checklist와 `REV-P10-016`·`REV-P10-017` 상태를 직접 검사하고 §7의 실제 마지막 독립 record를 동적으로 선택하게 해 수정 완료로 판정했다.

### 종료 판정

- `P10-R15`의 §7 em-dash형 record 추가와 top/review 완료 상태 수정은 확인됐고 Chromium/mobile Chrome 2-project 범위는 유지된다.
- **최종 결론:** `REV-P10-017` 후속 goal 필요. 다음 자동 순서는 `P9-R18` → `P9-R19` → `P10-R16`이며 실제 crop pixel·stale ADMIN server 및 개발 API 수동 QA는 별도 대기다.

## 29. P10-R16 수정 후 검증 — 2026-08-01

### 검토 범위와 실행 증거

- `P10-R15` 자체 checklist, `REV-P10-016`·`REV-P10-017` 상태, plan §7의 실제 마지막 독립 Progress record를 current contract에 포함했다.
- RED: 고정된 과거 marker를 선택한 synthetic Progress는 현재 record를 찾지 못해 1 failed / 8 skipped였고, `P10-R16` current-state focused test는 plan 상단의 보완 대기 상태로 1 failed / 8 skipped였다.
- GREEN: §7에서 em-dash 날짜형 독립 marker의 마지막 항목을 선택하도록 최소 helper를 추가하고 synthetic marker를 실제 형식으로 통일했다.
- GREEN/회귀: Phase 10 current-state와 최신 Progress focused는 2 passed / 7 skipped, docs contract는 2 files / 12 tests passed였다.
- 전체 검증: 81 files / 421 tests, `typecheck`, `lint`, 필수 section·Markdown link·diff 검사가 통과했다. Playwright 목록은 Chromium/mobile Chrome만 mock 104 tests와 server 18 tests를 수집했다.

### 종료 판정

- **최종 결론:** `REV-P10-017`/`P10-R16` 수정 완료. 실제 마지막 독립 Progress와 top/review current-state가 일치하고 자동 보완 Task는 완료됐다. Chromium/mobile Chrome 2-project 지원 범위는 유지하며 실제 crop pixel·stale ADMIN server 확인과 실제 개발 API Series/FanTalk/Comments/file policy 수동 QA가 남았다.

## 30. P10-R16 수정 결과 재점검 — 2026-08-01

### 검토 범위와 실행 증거

- 독립 reviewer가 `latestProgressRecord()`의 마지막 marker 선택과 `progressRecordAtMarker()`의 record 시작점 선택을 동일 marker 반복 조건으로 대조했다.
- 나머지 Task 경계, finding/checklist 상태, fenced·동일 H2 처리와 plan top/tail·Phase 9/10 review 동기화는 일치했다.

### `REV-P10-018` — 동일 Progress marker 반복 시 첫 record를 다시 선택함

| 항목 | 내용 |
|---|---|
| 심각도 | Low |
| 상태 | 수정 완료 |
| 관련 요구사항 | `P10-R16` 실제 마지막 독립 Progress record contract |
| 소유 Task | 신규 `P10-R17` |

**근거·영향**

- `latestProgressRecord()`는 마지막 marker의 문자열만 얻은 뒤 `progressRecordAtMarker()`에 전달한다. 후자는 `findIndex()`로 첫 동일 문자열 occurrence를 선택한다.
- append-only §7에 동일 제목·날짜 marker가 반복되면 오래된 완료 record를 반환해 최신 `보완 필요` 상태를 놓칠 수 있다.

**권장 조치·판정 기록**

- 기존 marker helper가 뒤에서 마지막 occurrence를 찾게 하고 동일 marker 반복 negative-control을 남긴다.
- 2026-08-01 — 독립 reviewer가 line-level 흐름과 synthetic 조건을 대조해 Low로 확정. 완료된 `P10-R16`을 다시 열지 않고 신규 `P10-R17`로 전환했다.
- 2026-08-01 — marker를 뒤에서 찾아 마지막 동일 occurrence를 사용하고 중복 marker synthetic을 통과해 수정 완료로 판정했다.

### 종료 판정

- **최종 결론:** `REV-P10-018` 후속 goal 필요. `P10-R17`을 plan에 추가했으며 Chromium/mobile Chrome 지원 범위와 수동 QA 대기는 유지한다.

## 31. P10-R17 수정 후 검증 — 2026-08-01

### 검토 범위와 실행 증거

- `progressRecordAtMarker()`가 첫 occurrence 대신 마지막 동일 marker occurrence를 선택하게 하고 `P10-R17` checklist와 `REV-P10-018` 상태를 current contract에 포함했다.
- RED: 동일 marker 반복 synthetic이 과거 완료 record를 반환해 1 failed / 8 skipped였고, GREEN은 1 passed / 8 skipped였다. current-state RED는 plan 상단의 보완 대기 상태로 1 failed / 8 skipped였다.
- 검증: Phase 10 focused 2 passed / 7 skipped, docs contract 2 files / 12 tests, 전체 unit 81 files / 421 tests가 통과했다. `typecheck`, `lint`, 필수 section·Markdown link·diff 검사도 exit 0이었다. Playwright 목록은 Chromium/mobile Chrome만 mock 104 tests와 server 18 tests를 수집했다.
- 독립 재리뷰: 직전 동일 marker Important는 닫혔고 신규 Critical/Important/Minor 없음, 요청 범위 merge ready로 판정됐다.

### 종료 판정

- **최종 결론:** `REV-P10-018`/`P10-R17` 수정 완료. 마지막 동일 marker occurrence와 실제 최신 Progress를 검사하며 자동 보완 Task는 완료됐다. Chromium/mobile Chrome 2-project 지원 범위는 유지하고 실제 crop pixel·stale ADMIN server 확인과 실제 개발 API Series/FanTalk/Comments/file policy 수동 QA가 남았다.