# Implementation Plan: 성숙도 리뷰(2026-09-25) 전 항목 반영 ## Overview `SPEC.md`의 요구사항(리뷰 발견 138건, ID 기준 143개)을 작업 단위로 나눠 고친다. 작업마다 실패하는 테스트를 먼저 쓰고, 고치고, 게이트를 돌리고, 커밋 하나를 만든다. 작업 목록은 `tasks/todo.md`에 있다. - 브랜치: `fix/maturity-review-2026-09-25` - 기준 커밋: `4626b73` ## Architecture Decisions - 결정 D-1 ~ D-19는 `SPEC.md` "결정" 표를 따른다. - 공용 로직은 `src/adapters/platform/`(kernel) 또는 `src/contracts/`에 둔다. 새 파일 단위 예외 규칙은 만들지 않는다. - 공개 포트는 추가만 한다. - 버그를 정상 동작으로 고정한 기존 테스트(예: 12-02의 workflow 스냅샷 테스트)는 같은 커밋에서 고친다. - `config/ci/gates.json`과 `.gitea/workflows/quality-gates.yml`은 Phase 0과 레인 K만 바꾼다. 다른 레인이 게이트 변경이 필요하면 레인 보고에 적고, 통합 때 반영한다. ## 실행 방식 직전 라운드(`fix/src-review-2026-09-24`)와 같은 구조다. 1. **Phase 0 (순차):** 게이트·CI 기반 7개 작업. 이게 끝나야 새 clone, 샘플 제거, CI 계약이 이후 작업의 검증 수단으로 동작한다. Phase 0 뒤 Checkpoint 0. 2. **Phase 1 (병렬 레인):** 레인마다 독립 git worktree에서 서브에이전트가 진행한다. 각 레인은 Phase 0이 반영된 브랜치 HEAD에서 갈라진다. 레인 안의 작업은 todo 순서대로 하나씩 진행한다(RED → GREEN → 게이트 → 커밋). 호스트 부하를 줄이려고 두 묶음으로 나눈다. - 1차: A, C, E, I, K (작업이 많거나 위험이 큰 레인) - 2차: B, D, F, G, H, J, M 3. **통합 (순차):** 레인 브랜치를 하나씩 rebase해 병합하고, 병합할 때마다 공통 게이트를 돌린다. 4. **통합 후 작업:** 12-12, 14-07, 리뷰 색인 상태 갱신. 5. **최종 체크포인트:** 전체 게이트, `build`, `test:sample-removal`, 깨끗한 worktree 재현. worktree 준비 규칙: `node_modules`는 최상위 항목마다 심볼릭 링크를 건다. pnpm 상태 파일(`.pnpm-workspace-state-v1.json`, `.modules.yaml`, `.package-map.json`)은 복사하고, 상태 파일의 프로젝트 경로를 worktree로 바꾼다. 이 방식이면 worktree에서 `corepack pnpm