[Phase 3 트랙 C] 운영자 리뷰 및 2026-Q2 세션 대기 항목 추적

[devfloor9]

배경

Phase 3(2026-04-19 완료)에서 추가된 트랙 C 4개 문서는 draft 상태로 머지됐으며, 실무자 리뷰와 2026-Q2 온톨로지 세션 후 최종 승인 예정입니다.

체크리스트 파일: .omc/plans/phase3-track-c-review-checklist.md
완료 커밋 레퍼런스: 28647d9, f1b72e2, 33984ea, decb903, f041b6c, 96b3332, 117bb7a, af3551d, 383572a

이미 완료된 자동 검증 (2026-04-20)

• C1 측정 조건 :::note 박스 (14일, 42k 요청, us-east-2)
• C3 KEP-2008 / cuda-checkpoint 로드맵 공식 소스 재검증
• C4 Faithfulness/Recall 수치 외부 레퍼런스 각주 (arXiv:2404.16130, 2408.08921)
• C2 검증 상태 disclaimer
• Mermaid 블록 pairing (17/17)
• 내부 상대 링크 전수 스캔 (22/22 유효)
• 4개 수정 문서 last_update.date 2026-04-20 갱신

Phase 3 Split-spec 검증 완료 (2026-04-21, 커밋 383572a)

• 원본 라인 합계 vs 분할 합계 ±10% 이내 (3,065 → 3,352, +9.4%)
• RefArch 상한(1,200줄) 준수 (최대 758줄)
• 신규 8개 파일 Frontmatter 스타일 가이드 준수
• 참고 자료 섹션 8/8 파일 완비
• npm run build SUCCESS
• sidebars.js 등록 확인
• Split-spec 대상 broken link 0건 (ko + i18n/en + i18n/zh)
• ADR 문서에 Architecture Decision Record 개요 섹션 신설 (Nygard 원형·본 플랫폼 규약)

대기 항목 — 운영자 대면 리뷰

C1. Cascade Routing (cascade-routing-tuning.md)

• Langfuse misroute 탐지 SQL/OTel 쿼리 정확성 — Classifier v7 운영자
• Canary 10%/50%/100% 대기 시간·관찰 지표 — Classifier v7 운영자
• Spot reclaim fallback 순서 (rate limit → lower tier → cache) — GLM-5 운영자
• 안티패턴 섹션에 실제 겪은 사례 추가 가능성 — 운영자

C2. AgentCore Hybrid (platform-selection/agentcore-hybrid-strategy.md)

• Decision Matrix 8축 가중치가 LG U+ 환경 적합성 — MLOps 리드
• Hand-off 패턴 카탈로그 vs 현행 온프레(Colab-Co/Sangam) ↔ EKS 정합성
• IAM/STS/AssumeRole 흐름 Phase 3 실배포 시 E2E 검증
• 마이그레이션 로드맵 마일스톤 vs SuperNova 등록 타이밍 충돌 여부

C3. CRIU GPU Migration (criu-gpu-migration.md)

• graceful drain + warm start 순서가 현실적 운영 절차에 부합 — GLM-5 운영자

대기 항목 — 2026-Q2 온톨로지 세션

C4. Knowledge Feature Store (foundations/knowledge-feature-store.md)

• 3-plane KFS 개념의 Feature Store 상위 호환성 합의
• 온톨로지 엔터티 해석 샘플의 LG U+ 도메인(통신·미디어) 적용성
• Write path 일관성 모델 (eventual vs strong)

연관 플랜: .omc/plans/kfs-ontology-session-kickoff.md

수동 실행 필요

• docusaurus serve로 Mermaid 최종 렌더링 확인
• Issue #3에 Phase 3 완료 코멘트 작성 — 2026-04-20 코멘트로 전체 해결 완료 기록 후 이슈 CLOSED
• 운영자 리뷰 반영 후 체크리스트 pending-review → completed 전환
• i18n(en/zh) 동기화 — ko 확정 후 일괄 번역

Phase 4 전반 broken link 정리 (신규 과제)

Phase 4 3-tier 재구조화(af3551d) 이후 다른 카테고리에 남아있는 broken link 약 155건(ko only 기준)은 본 이슈 범위 밖으로, 별도 클린업 과제로 추적이 필요합니다.

지정 리뷰어

• GLM-5 운영자 (us-east-2 테어다운 이전 담당자)
• Classifier v7 운영자
• MLOps 리드 (ADR DRI)

[devfloor9]

Split-spec 검증 완료 (2026-04-21, 커밋 383572a)

Phase 3 분할 작업(.omc/plans/phase3-split-spec.md)의 검증 체크리스트 7건을 전수 검증·완료 처리했습니다.

검증 결과

항목	결과
원본 라인 합계 vs 분할 합계	3,065줄 → 3,352줄 (+9.4%, 상한 ±10% 내)
파일별 라인 상한 (RefArch 1,200줄)	최대 evaluation-rollout.md 758줄 ✅
Frontmatter 스타일 가이드 준수	8/8 파일 필수 필드 완비 (scope 태그 포함)
## 참고 자료 섹션 존재	continuous-training 4/4, inference-optimization 4/4
npm run build	EXIT=0 (SUCCESS)
sidebars.js 등록	신규 8개 + adr-self-improving-loop 등록 확인 (L168, L216-221, L326-331)
Split-spec 대상 broken link	0건 (ko + i18n/en + i18n/zh 전수 수정)

동시 진행

• adr-self-improving-loop.md에 Architecture Decision Record 개요 섹션 추가
  • Nygard 원형 구조·작성 목적·본 플랫폼 ADR 규약 6항
  • 참고 자료 ADR 원전 4건 보강 (Nygard, MADR, adr-tools, ThoughtWorks)

잔존 항목

본 커밋에서 수정한 범위는 split-spec 대상 8개 문서로 한정됩니다. Phase 4 재구조화 이후 다른 영역에 남아있는 broken link 155건은 본 이슈 범위 밖이며 별도 정리 작업이 필요합니다.

[devfloor9]

Phase 4 broken link 일괄 정리 (2026-04-21, 커밋 f16d579)

Phase 4 3-tier 재구조화(af3551d) 이후 stale해진 상대경로를 스크립트 기반으로 전수 수정했습니다.

결과

• Broken links: 470건 → 39건 (91% 감소)
• Broken anchors: 14건 (slugify 불일치, 별도 과제)
• 변경 파일: 141개 (ko + i18n/en + i18n/zh)
• Build: npm run build EXIT=0 SUCCESS

적용된 치환 패턴

카테고리	Before	After
경로 깊이 보정	../operations-mlops/observability/agent-monitoring.md	../../operations-mlops/observability/agent-monitoring.md
파일 리네이밍	inference-gateway-setup.md	inference-gateway/setup/
파일 리네이밍	inference-gateway-routing.md	inference-gateway/routing-strategy.md
파일 리네이밍	openclaw-ai-gateway.mdx	openclaw-example.md
폴더화	msa-complexity.md	msa-complexity/index.md
폴더화	eks-debugging-guide.md	eks-debugging/index.md
절대경로 갱신	/docs/.../operations-mlops/agent-monitoring	/docs/.../operations-mlops/observability/agent-monitoring
Anchor 번호 제거	#5-평가-파이프라인	#평가-파이프라인

잔여 53건 (신규 과제로 추적 필요)

39건 broken links — 주된 원인:

1. i18n/en·zh eks-debugging 서브폴더 번역 누락 (≈20건) — ko 원본이 폴백되면서 i18n 디렉토리에 없는 health-check-mismatch.md 등이 참조됨. 해결책: i18n 전면 동기화(ko의 eks-debugging/ 구조를 en/zh에도 반영)
2. OpenTelemetry 섹션 누락 (monitoring-observability-setup.md) — Phase 4에서 섹션이 삭제됐지만 다른 문서가 #opentelemetry-연동 앵커를 참조. 해결책: OpenTelemetry 섹션 복원 또는 참조 링크 제거
3. 미존재 섹션 anchor (#semantic-caching-구현-옵션-advanced, #llm-classifier-배포 등) — Phase 3 분할 시 앵커 이름이 바뀌었거나 섹션이 이동됨

14건 broken anchors — Docusaurus slugify 규칙 차이:

• 한국어 제목에서 숫자·점·괄호 처리 불일치
• 예: ##5.6 DRA 워크로드를 위한 MNG 전략 제목이 #56-dra-워크로드...가 아닌 #56-dra-워크로드를-위한-managed-node-group-전략으로 생성됨

권장 Follow-up

[ ] i18n/en·zh의 eks-best-practices/operations-reliability/eks-debugging/ 서브폴더 번역 동기화
[ ] monitoring-observability-setup.md의 OpenTelemetry 섹션 복원 여부 결정
[ ] 잔여 39건 중 anchor 미존재 케이스 전수 검토

[devfloor9]

Task A/B/C 일괄 진행 완료 (2026-04-21, 커밋 36c19bf)

결과 요약

지표	시작	최종	감소율
Broken links	470	21	95.5%
Broken anchors	—	9	—
Build status	SUCCESS	SUCCESS	—

Task 내역

Task A — Ultra 병렬 (EN 번역)

• i18n/en/.../eks-best-practices/operations-reliability/eks-debugging/ 서브폴더 번역 11개 파일 추가
  • index, auto-mode, control-plane, gpu-ai-workload, health-check-mismatch, karpenter, networking, node, observability, storage, workload.md
• 구 eks-debugging-guide.md 삭제 (eks-debugging/index.md으로 대체)
• 기술 용어·코드·Mermaid·링크 경로 모두 보존

Task B — max effort (OpenTelemetry 앵커 제거)

• basic-deployment.md / troubleshooting-guide.md의 #opentelemetry-연동 / #opentelemetry-integration anchor 제거
• 파일 링크(../../integrations/monitoring-observability-setup.md)만 유지 (ko + en)

Task C — max effort (잔여 경로/앵커 정리)

• domain-customization.md: ../reference-architecture/ → ../../ (source가 operations-mlops/governance 깊이)
• agentic-ai-solutions-eks.md: ../model-serving/ → ../../
• slugify 불일치 anchor를 파일 링크로 단순화 (#56-dra-워크로드…, #vllm-pp-멀티노드-제약 등)
• health-check-mismatch.md의 absolute path anchor 제거

잔여 21건 broken links / 9건 anchors

구성:

• i18n/zh/eks-debugging/ 서브폴더 미번역으로 인한 fallback 문제 (8건)
• Docusaurus slugify 불일치로 인한 anchor (9건) — 각 문서의 id 속성 지정 또는 헤더 리네이밍 필요

CLAUDE.md "중국어 업데이트 금지" 규칙 준수로 i18n/zh 변경 없음. zh 동기화는 별도 명령 시에 진행.

현재 남은 과제

1. i18n/zh 동기화 — eks-debugging 서브폴더 중국어 번역 (CLAUDE.md 규칙 해제 시)
2. Docusaurus slugify anchor — 9건 anchor 교정 ({#custom-id} 지정 방식 검토)
3. Track C 운영자 리뷰 11건 — 외부 의존 (GLM-5/Classifier v7 운영자)
4. KFS Q2 세션 14건 — 2026-Q2 워크샵 대기

[devfloor9]

트랙 C 검증 이슈 분리 + 문서 배너 추가 (2026-04-21, 커밋 882aea1)

트랙 C 운영자 대면 리뷰 항목을 별도 이슈로 분리하고, 각 문서 상단에 :::caution Verification pending 배너를 추가하여 다른 세션에서 실배포 검증 시 해당 이슈를 참조할 수 있도록 했습니다.

분리된 검증 이슈

항목	문서	이슈	담당
C1. Cascade Routing 실전 튜닝	reference-architecture/inference-gateway/cascade-routing-tuning.md	#5	Classifier v7 운영자
C2. AgentCore Hybrid 배포 패턴	design-architecture/platform-selection/agentcore-hybrid-strategy.md	#6	MLOps 리드
C3. CRIU GPU Migration	model-serving/gpu-infrastructure/criu-gpu-migration.md	#7	GLM-5 운영자

변경 내역

• ko 3개 + i18n/en 3개 파일 상단에 검증 대기 admonition 추가 (총 6 파일)
• 각 배너에 해당 이슈 링크 포함 → 다른 세션이 직접 배포·검증 후 이슈 코멘트로 결과 보고 가능
• C4. Knowledge Feature Store는 .omc/plans/kfs-ontology-session-kickoff.md와 foundations/knowledge-feature-store.md의 기존 disclaimer로 커버됨(Q2 세션 예정 상태 유지).

권장 워크플로우 (검증 세션용)

1. 각 이슈([검증 필요] C1. Cascade Routing Tuning — 실배포 검증 (Classifier v7) #5/[검증 필요] C2. AgentCore Hybrid Deployment — Decision Matrix 실환경 검증 (MLOps 리드) #6/[검증 필요] C3. CRIU GPU Migration — graceful drain 실전 검증 (GLM-5 운영자) #7)의 검증 항목 체크리스트 확인
2. 지정 테스트 환경에서 실배포 수행
3. 결과를 이슈에 코멘트로 기록
4. 검증 완료 시 문서의 :::caution 배너 제거 + last_update.date 갱신
5. .omc/plans/phase3-track-c-review-checklist.md의 해당 항목 [x] 처리

본 이슈(#4) 잔여 작업

• Issue [검증 필요] C1. Cascade Routing Tuning — 실배포 검증 (Classifier v7) #5, [검증 필요] C2. AgentCore Hybrid Deployment — Decision Matrix 실환경 검증 (MLOps 리드) #6, [검증 필요] C3. CRIU GPU Migration — graceful drain 실전 검증 (GLM-5 운영자) #7 완료 대기
• C4 Knowledge Feature Store Q2 세션 (2026-Q2 워크샵)
• i18n/zh 동기화 (CLAUDE.md 규칙 해제 시)
• Docusaurus slugify anchor 9건 교정

[devfloor9]

C2(AgentCore Hybrid) 문서 측 검증 완료 — #6 CLOSED (2026-07-03, 커밋 de43e1c)

• AWS 공식 문서 기준 스팩 전수 재검증: Runtime VPC 연결 반영, Custom Model Import 제약 재정의, invoke_agent_runtime API 마이그레이션, Identity JWT 발급자 정정
• 검증 배너 2종(:::info 검증 상태, :::caution 검증 대기) 제거, last_update.date 2026-07-03 갱신 (ko+en)

C2의 LG U+ 환경 특화 항목(8축 가중치·Colab-Co/Sangam 정합성·IAM E2E·SuperNova 타이밍)은 운영자 대면 리뷰 사안으로 본 이슈에서 계속 추적합니다.