diff --git a/agent-roadmap/ROADMAP.md b/agent-roadmap/ROADMAP.md
index 2a790bd..7695f43 100644
--- a/agent-roadmap/ROADMAP.md
+++ b/agent-roadmap/ROADMAP.md
@@ -32,41 +32,41 @@ provider/device/model별 qualification report와 모델 lifecycle 관리는 prov
 완료, 검토중, 진행중, 계획, 스케치 순서로 두어 아래로 갈수록 미래 작업에 가까워지게 정렬한다.
 
 - [완료] Edge-Node 실행 기반
-  - 경로: `agent-roadmap/archive/phase/edge-node-execution-foundation/PHASE.md`
+  - 경로: [PHASE.md](archive/phase/edge-node-execution-foundation/PHASE.md)
   - 요약: Edge-Node 소켓 실행 경로, Node adapter execution, CLI session, 최소 외부 입력 표면을 안정화한 단계다.
 
 - [완료] Ollama 서빙 안정화 기반
-  - 경로: `agent-roadmap/archive/phase/serving-routing-optimization/PHASE.md`
+  - 경로: [PHASE.md](archive/phase/serving-routing-optimization/PHASE.md)
   - 요약: Edge OpenAI-compatible API에서 Node의 Ollama adapter를 호출하는 E2E 경로를 실제 Ollama endpoint와 split-host 환경에서 안정화했다. 추가 provider, 표준화, 후속 최적화 계층은 후속 Phase로 넘긴다.
 
 - [완료] Control Plane과 Client 운영
-  - 경로: `agent-roadmap/archive/phase/control-plane-portal-ops/PHASE.md`
+  - 경로: [PHASE.md](archive/phase/control-plane-portal-ops/PHASE.md)
   - 요약: 여러 Edge를 관찰하고 운영하는 중앙 제어면과 Flutter client 운영면을 구축하는 단계다.
 
 - [완료] 추론 서버 provider 확장
-  - 경로: `agent-roadmap/archive/phase/inference-provider-extension/PHASE.md`
+  - 경로: [PHASE.md](archive/phase/inference-provider-extension/PHASE.md)
   - 요약: 1차 MVP의 속도 향상 축으로, 같은 Edge 안의 model group queue와 여러 Node 후보 순차 dispatch를 기준으로 다중 디바이스 효율을 높이고 Lemonade/vLLM/SGLang 같은 provider 검증을 이어가는 단계다.
 
 - [진행중] 운영 관측과 Provider 관리
-  - 경로: `agent-roadmap/phase/operational-observability-provider-management/PHASE.md`
+  - 경로: [PHASE.md](phase/operational-observability-provider-management/PHASE.md)
   - 요약: 사용자/토큰/사용량/로그 추적과 API/CLI/local inference provider catalog, 로컬 디바이스 provider 상태 관리, provider/device/model qualification report와 모델 lifecycle 관리 방향을 MVP 운영 축과 후속 심화 축으로 스케치한다.
 
 - [진행중] Update Plane과 자체 업데이트 기반
-  - 경로: `agent-roadmap/phase/update-plane-self-update-foundation/PHASE.md`
+  - 경로: [PHASE.md](phase/update-plane-self-update-foundation/PHASE.md)
   - 요약: frontend와 Control Plane만 재배포해도 Edge/Node가 안정 업데이트 프로토콜, 로컬 상태 캐시, host-local manager를 통해 스스로 버전 수렴하는 기반을 정리한다.
 
 - [계획] Automation Runtime과 Bridge 확장
-  - 경로: `agent-roadmap/phase/automation-runtime-bridge/PHASE.md`
+  - 경로: [PHASE.md](phase/automation-runtime-bridge/PHASE.md)
   - 요약: CLI Agent 실행과 운영 자동화의 MVP 표면을 정리하고, 사용량 limit 알림/자동 이어받기를 우선 스케치하되 원격 터널링과 oto scheduler/CI-CD는 2차로 잠근다.
 
 - [계획] 지식과 도구 최적화 확장
-  - 경로: `agent-roadmap/phase/knowledge-tool-optimization-extension/PHASE.md`
+  - 경로: [PHASE.md](phase/knowledge-tool-optimization-extension/PHASE.md)
   - 요약: 로컬 모델 성능 향상 축으로 단계 호출, tool/schema 강제, 검증/retry/fallback의 MVP 실행 모드를 먼저 스케치하고, RAG 장기 기억, advisor, context hook은 2차로 분리한다.
 
 ## 로딩 정책
 
-- 일반 작업에서는 `agent-roadmap/ROADMAP.md`를 매번 읽지 않는다.
-- 기능 추가, 구조 변경, 스킬 추가/수정, 문서 구조 변경 작업을 수행할 때는 `agent-roadmap/current.md`를 먼저 읽는다.
+- 일반 작업에서는 [ROADMAP.md](ROADMAP.md)를 매번 읽지 않는다.
+- 기능 추가, 구조 변경, 스킬 추가/수정, 문서 구조 변경 작업을 수행할 때는 [current.md](current.md)를 먼저 읽는다.
 - `current.md`는 현재 작업 위치가 아니라 활성 Phase와 활성 Milestone 후보 목록이다.
 - `current.md`에는 개인별 현재 작업 위치나 완료 상태를 기록하지 않는다.
 - `current.md`의 활성 Phase는 실제 활성 Phase 문서 경로를 가리킨다.
diff --git a/agent-roadmap/phase/automation-runtime-bridge/PHASE.md b/agent-roadmap/phase/automation-runtime-bridge/PHASE.md
index 9b0f4c2..2f1b725 100644
--- a/agent-roadmap/phase/automation-runtime-bridge/PHASE.md
+++ b/agent-roadmap/phase/automation-runtime-bridge/PHASE.md
@@ -17,87 +17,87 @@ NomadCode가 IOP를 실행 백엔드로 사용할 수 있도록 하는 Responses
 완료, 검토중, 진행중, 계획, 스케치, 보류 순서로 두어 아래로 갈수록 미래 작업에 가까워지게 정렬한다.
 
 - [완료] CLI Automation Runtime 안정화
-  - 경로: `agent-roadmap/archive/phase/automation-runtime-bridge/milestones/cli-automation-runtime-stabilization.md`
+  - 경로: [cli-automation-runtime-stabilization](../../archive/phase/automation-runtime-bridge/milestones/cli-automation-runtime-stabilization.md)
   - 요약: one-shot, persistent terminal, opencode SSE, codex exec 계열 CLI 실행 모드와 운영 command 응답을 같은 adapter execution 모델 안에서 안정화했다.
 
 - [완료] Agent Bootstrap과 Domain Agent 등록
-  - 경로: `agent-roadmap/archive/phase/automation-runtime-bridge/milestones/agent-bootstrap-domain-agent-enrollment.md`
+  - 경로: [agent-bootstrap-domain-agent-enrollment](../../archive/phase/automation-runtime-bridge/milestones/agent-bootstrap-domain-agent-enrollment.md)
   - 요약: Edge 직접 연결 specialized domain agent 등록을 위한 MVP enrollment 계약과 후속 구현 Milestone 경계를 확정했다.
 
 - [완료] Domain Agent Registry 구현
-  - 경로: `agent-roadmap/archive/phase/automation-runtime-bridge/milestones/domain-agent-registry-implementation.md`
+  - 경로: [domain-agent-registry-implementation](../../archive/phase/automation-runtime-bridge/milestones/domain-agent-registry-implementation.md)
   - 요약: Edge-side `generic-node`/domain-agent 구분을 config/store, registry/transport, service snapshot에 반영하고 검증을 완료했다.
 
 - [완료] Domain Agent Bootstrap Command 발급
-  - 경로: `agent-roadmap/archive/phase/automation-runtime-bridge/milestones/domain-agent-bootstrap-command-issue.md`
+  - 경로: [domain-agent-bootstrap-command-issue](../../archive/phase/automation-runtime-bridge/milestones/domain-agent-bootstrap-command-issue.md)
   - 요약: `iop-edge agent register`가 domain agent record와 Linux bootstrap script 인자를 포함한 one-line command를 발급하고 config roundtrip 검증을 완료했다.
 
 - [완료] IOP 전용 Domain Agent 경로 제거
-  - 경로: `agent-roadmap/archive/phase/automation-runtime-bridge/milestones/domain-agent-specific-iop-removal.md`
+  - 경로: [domain-agent-specific-iop-removal](../../archive/phase/automation-runtime-bridge/milestones/domain-agent-specific-iop-removal.md)
   - 요약: 독립 Control Plane 전환에 맞춰 IOP 활성 코드와 문서에서 전용 agent kind, bootstrap, smoke, 운영 문구를 제거했다.
 
 - [완료] 전역 설계 부채 리팩토링 기반
-  - 경로: `agent-roadmap/archive/phase/automation-runtime-bridge/milestones/architecture-refactor-foundation.md`
+  - 경로: [architecture-refactor-foundation](../../archive/phase/automation-runtime-bridge/milestones/architecture-refactor-foundation.md)
   - 요약: 원격 터미널 브리지와 이후 운영 확장 전에 Edge, Node, Control Plane, Client, proto/config 경계의 설계 부채를 정리했고, 잔여 리스크는 후속 선행 안정화 마일스톤으로 넘겼다.
 
 - [완료] OpenAI Responses Input Surface
-  - 경로: `agent-roadmap/archive/phase/automation-runtime-bridge/milestones/openai-responses-input-surface.md`
+  - 경로: [openai-responses-input-surface](../../archive/phase/automation-runtime-bridge/milestones/openai-responses-input-surface.md)
   - 요약: Edge OpenAI-compatible 입력 표면에 non-streaming `POST /v1/responses`, metadata 전달 계약, response subset, `iop-edge smoke openai` Responses 검증을 추가하고 실제 Edge/Node/fake Ollama smoke evidence를 확보했다.
 
 - [폐기] Specialized Agent proto-socket 연결 기반
-  - 경로: `agent-roadmap/archive/phase/automation-runtime-bridge/milestones/specialized-agent-proto-socket-foundation.md`
+  - 경로: [specialized-agent-proto-socket-foundation](../../archive/phase/automation-runtime-bridge/milestones/specialized-agent-proto-socket-foundation.md)
   - 요약: domain agent가 독립형 실행 방식으로 전환될 예정이므로 Edge 직접 proto-socket specialized peer 기준의 연결 기반 정리는 폐기한다.
 
 - [폐기] Domain Agent Registration Online Smoke
-  - 경로: `agent-roadmap/archive/phase/automation-runtime-bridge/milestones/domain-agent-registration-online-smoke.md`
+  - 경로: [domain-agent-registration-online-smoke](../../archive/phase/automation-runtime-bridge/milestones/domain-agent-registration-online-smoke.md)
   - 요약: 독립형 실행 방식으로 전환될 예정이므로 Edge 직접 registration online smoke는 폐기한다.
 
 - [폐기] Domain Agent Registration Unlock Handoff
-  - 경로: `agent-roadmap/archive/phase/automation-runtime-bridge/milestones/domain-agent-registration-unlock-handoff.md`
+  - 경로: [domain-agent-registration-unlock-handoff](../../archive/phase/automation-runtime-bridge/milestones/domain-agent-registration-unlock-handoff.md)
   - 요약: 독립형 실행 전환으로 Edge 직접 등록 흐름 잠금 해제 handoff가 필요 없어져 폐기한다.
 
 - [폐기] Domain Agent Message Boundary
-  - 경로: `agent-roadmap/archive/phase/automation-runtime-bridge/milestones/domain-agent-message-boundary.md`
+  - 경로: [domain-agent-message-boundary](../../archive/phase/automation-runtime-bridge/milestones/domain-agent-message-boundary.md)
   - 요약: 독립형 실행 전환으로 Edge 직접 domain payload boundary 정리가 현재 범위에서 필요 없어져 폐기한다.
 
 - [완료] 워크스페이스 포트/환경 표준화
-  - 경로: `agent-roadmap/phase/automation-runtime-bridge/milestones/workspace-port-env-standardization.md`
+  - 경로: [workspace-port-env-standardization](milestones/workspace-port-env-standardization.md)
   - 요약: Control Plane, Edge, Node, Client, OpenAI-compatible, A2A, wire, metrics, DB/cache 포트를 workspace 공통 대역으로 정렬한다.
 
 - [완료] 브리지 선행 경계 안정화
-  - 경로: `agent-roadmap/archive/phase/automation-runtime-bridge/milestones/bridge-boundary-hardening.md`
+  - 경로: [bridge-boundary-hardening](../../archive/phase/automation-runtime-bridge/milestones/bridge-boundary-hardening.md)
   - 요약: 원격 터미널 브리지 POC 전에 남은 호환성/소유권 리스크를 Client HTTP lifecycle, Edge run surface, Node terminal core, typed adapter config 계약으로 고정한다.
 
 - [완료] Codex App Server 스트리밍 전환
-  - 경로: `agent-roadmap/archive/phase/automation-runtime-bridge/milestones/codex-app-server-streaming-migration.md`
+  - 경로: [codex-app-server-streaming-migration](../../archive/phase/automation-runtime-bridge/milestones/codex-app-server-streaming-migration.md)
   - 요약: Codex CLI target의 기본 `codex` profile을 app-server 기반으로 전환하고 실제 `codex` foreground/background smoke와 app-server session lifecycle 검증을 완료했다.
 
 - [완료] OpenAI Workspace Agent Execution Contract
-  - 경로: `agent-roadmap/archive/phase/automation-runtime-bridge/milestones/openai-workspace-agent-execution-contract.md`
+  - 경로: [openai-workspace-agent-execution-contract](../../archive/phase/automation-runtime-bridge/milestones/openai-workspace-agent-execution-contract.md)
   - 요약: NomadCode가 IOP CLI를 직접 실행하지 않고 IOP Edge OpenAI-compatible HTTP 호출의 `metadata.workspace`와 task/source metadata만으로 내부 workspace-bound agent target이 해당 checkout에서 산출물을 만들 수 있게 하는 최우선 contract/serving hardening 작업이다.
 
 - [계획] Pi CLI Provider Integration
-  - 경로: `agent-roadmap/phase/automation-runtime-bridge/milestones/pi-cli-provider-integration.md`
+  - 경로: [pi-cli-provider-integration](milestones/pi-cli-provider-integration.md)
   - 요약: Node CLI adapter의 실행 profile 후보에 Pi를 추가하고, Pi JSON stream 출력 파서, config 예시, OpenAI-compatible route smoke를 통해 `adapter=cli,target=pi`를 안정적으로 사용할 수 있게 한다.
 
 - [계획] CLI Agent Group Grade Routing
-  - 경로: `agent-roadmap/phase/automation-runtime-bridge/milestones/cli-agent-group-grade-routing.md`
+  - 경로: [cli-agent-group-grade-routing](milestones/cli-agent-group-grade-routing.md)
   - 요약: `PLAN-local-G08.md`, `CODE_REVIEW-cloud-G07.md` 같은 예약어/lane/grade 파일명을 기준으로 CLI provider agent를 목적별 agent group에 라우팅하고, 수동/자동 grade range assignment와 OpenAI-compatible `metadata.agent_group.task_file` 계약을 정리한다.
 
 - [스케치] CLI Agent 사용량 알림과 자동 이어받기 MVP
-  - 경로: `agent-roadmap/phase/automation-runtime-bridge/milestones/cli-agent-usage-notification-continuation.md`
+  - 경로: [cli-agent-usage-notification-continuation](milestones/cli-agent-usage-notification-continuation.md)
   - 요약: CLI Agent limit 도달 감지, 사용자 알림, 작업 자동 이어받기의 MVP 경계를 스케치한다.
 
 - [스케치] 원격 코딩/유지보수 작업 환경
-  - 경로: `agent-roadmap/phase/automation-runtime-bridge/milestones/remote-workspace-operations-environment.md`
+  - 경로: [remote-workspace-operations-environment](milestones/remote-workspace-operations-environment.md)
   - 요약: CLI Agent와 workspace-bound execution을 이용한 원격 코딩/유지보수 환경의 운영 경계를 스케치한다.
 
 - [스케치] oto 자동화 스케줄러와 CI-CD 연동 (2차)
-  - 경로: `agent-roadmap/phase/automation-runtime-bridge/milestones/oto-automation-scheduler-second-wave.md`
+  - 경로: [oto-automation-scheduler-second-wave](milestones/oto-automation-scheduler-second-wave.md)
   - 요약: oto를 이용한 자동화, scheduler, CI-CD 연동은 MVP 이후 2차 후보로 스케치한다.
 
 - [보류] 원격 터미널/CLI 터널링 POC (2차)
-  - 경로: `agent-roadmap/phase/automation-runtime-bridge/milestones/remote-terminal-bridge-poc.md`
+  - 경로: [remote-terminal-bridge-poc](milestones/remote-terminal-bridge-poc.md)
   - 요약: Agent를 설치하기 어려운 host/device 또는 특정 Node의 CLI agent를 Socket 경유로 다른 원격지에 연결하는 터널링 POC는 MVP 이후 2차로 보류한다.
 
 ## Phase 경계
diff --git a/agent-roadmap/phase/automation-runtime-bridge/milestones/cli-agent-group-grade-routing.md b/agent-roadmap/phase/automation-runtime-bridge/milestones/cli-agent-group-grade-routing.md
index 08d349e..acc3386 100644
--- a/agent-roadmap/phase/automation-runtime-bridge/milestones/cli-agent-group-grade-routing.md
+++ b/agent-roadmap/phase/automation-runtime-bridge/milestones/cli-agent-group-grade-routing.md
@@ -2,8 +2,8 @@
 
 ## 위치
 
-- Roadmap: `agent-roadmap/ROADMAP.md`
-- Phase: `agent-roadmap/phase/automation-runtime-bridge/PHASE.md`
+- Roadmap: [ROADMAP.md](../../../ROADMAP.md)
+- Phase: [PHASE.md](../PHASE.md)
 
 ## 목표
 
@@ -23,7 +23,7 @@ OpenAI-compatible 호출은 파일 내용을 prompt 본문에 섞지 않고 `met
 
 - 상태: 잠금
 - SDD: 필요
-- SDD 문서: `agent-roadmap/sdd/automation-runtime-bridge/cli-agent-group-grade-routing/SDD.md`
+- SDD 문서: [SDD.md](../../../sdd/automation-runtime-bridge/cli-agent-group-grade-routing/SDD.md)
 - SDD 사유: CLI provider agent catalog, agent group grade assignment, OpenAI-compatible metadata schema, config schema, request routing, usage/resource based selection, route audit log가 runtime/API 계약에 직접 닿는다.
 - 잠금 해제 조건:
   - [ ] SDD 잠금이 해제되어 있다
@@ -102,8 +102,8 @@ CLI provider agent와 목적별 agent group, 예약어 설정을 runtime이 해
 
 ## 작업 컨텍스트
 
-- 관련 경로: `agent-contract/outer/openai-compatible-api.md`, `apps/edge/internal/openai`, `apps/edge/internal/service`, `apps/node/internal/adapters/cli`, `packages/go/config`, `configs`, `apps/edge/README.md`
+- 관련 경로: [openai-compatible-api.md](../../../../agent-contract/outer/openai-compatible-api.md), `apps/edge/internal/openai`, `apps/edge/internal/service`, `apps/node/internal/adapters/cli`, `packages/go/config`, `configs`, [README.md](../../../../apps/edge/README.md)
 - 표준선(선택): 내부 실행 개념은 `adapter + target`을 유지하고, OpenAI-compatible 경계의 agent group routing 문맥은 `metadata.agent_group` 아래에 둔다. 파일명은 routing 계약의 source of truth이며 prefix/lane/grade 중복 metadata는 만들지 않는다.
 - 선행 작업: CLI Automation Runtime 안정화, OpenAI Responses Input Surface, OpenAI Workspace Agent Execution Contract
 - 후속 작업: CLI Agent 사용량 알림과 자동 이어받기 MVP, 운영 관측과 Provider 관리의 provider quota/usage 고도화
-- 확인 필요: 선택된 agent 실패/중단/실행 중 quota 소진 시 자동 retry/fallback/중단 정책은 `구현 잠금 > 결정 필요`와 SDD `USER_REVIEW.md`로 분리한다.
+- 확인 필요: 선택된 agent 실패/중단/실행 중 quota 소진 시 자동 retry/fallback/중단 정책은 `구현 잠금 > 결정 필요`와 SDD [USER_REVIEW.md](../../../sdd/automation-runtime-bridge/cli-agent-group-grade-routing/USER_REVIEW.md)로 분리한다.
diff --git a/agent-roadmap/phase/automation-runtime-bridge/milestones/cli-agent-usage-notification-continuation.md b/agent-roadmap/phase/automation-runtime-bridge/milestones/cli-agent-usage-notification-continuation.md
index 1676106..3a766a7 100644
--- a/agent-roadmap/phase/automation-runtime-bridge/milestones/cli-agent-usage-notification-continuation.md
+++ b/agent-roadmap/phase/automation-runtime-bridge/milestones/cli-agent-usage-notification-continuation.md
@@ -2,8 +2,8 @@
 
 ## 위치
 
-- Roadmap: `agent-roadmap/ROADMAP.md`
-- Phase: `agent-roadmap/phase/automation-runtime-bridge/PHASE.md`
+- Roadmap: [ROADMAP.md](../../../ROADMAP.md)
+- Phase: [PHASE.md](../PHASE.md)
 
 ## 목표
 
diff --git a/agent-roadmap/phase/automation-runtime-bridge/milestones/oto-automation-scheduler-second-wave.md b/agent-roadmap/phase/automation-runtime-bridge/milestones/oto-automation-scheduler-second-wave.md
index c1d7461..5a4b72b 100644
--- a/agent-roadmap/phase/automation-runtime-bridge/milestones/oto-automation-scheduler-second-wave.md
+++ b/agent-roadmap/phase/automation-runtime-bridge/milestones/oto-automation-scheduler-second-wave.md
@@ -2,8 +2,8 @@
 
 ## 위치
 
-- Roadmap: `agent-roadmap/ROADMAP.md`
-- Phase: `agent-roadmap/phase/automation-runtime-bridge/PHASE.md`
+- Roadmap: [ROADMAP.md](../../../ROADMAP.md)
+- Phase: [PHASE.md](../PHASE.md)
 
 ## 목표
 
diff --git a/agent-roadmap/phase/automation-runtime-bridge/milestones/pi-cli-provider-integration.md b/agent-roadmap/phase/automation-runtime-bridge/milestones/pi-cli-provider-integration.md
index 235f76a..7f12d87 100644
--- a/agent-roadmap/phase/automation-runtime-bridge/milestones/pi-cli-provider-integration.md
+++ b/agent-roadmap/phase/automation-runtime-bridge/milestones/pi-cli-provider-integration.md
@@ -2,8 +2,8 @@
 
 ## 위치
 
-- Roadmap: `agent-roadmap/ROADMAP.md`
-- Phase: `agent-roadmap/phase/automation-runtime-bridge/PHASE.md`
+- Roadmap: [ROADMAP.md](../../../ROADMAP.md)
+- Phase: [PHASE.md](../PHASE.md)
 
 ## 목표
 
@@ -81,7 +81,7 @@ Pi headless JSON 출력 이벤트를 IOP runtime event로 변환해 기존 CLI s
 
 ## 작업 컨텍스트
 
-- 관련 경로: `apps/node/internal/adapters/cli`, `packages/go/config`, `configs/edge.yaml`, `configs/edge-compose.yaml.tmpl`, `apps/edge/README.md`, `agent-contract/outer/openai-compatible-api.md`
+- 관련 경로: `apps/node/internal/adapters/cli`, `packages/go/config`, `configs/edge.yaml`, `configs/edge-compose.yaml.tmpl`, [README.md](../../../../apps/edge/README.md), [openai-compatible-api.md](../../../../agent-contract/outer/openai-compatible-api.md)
 - 표준선(선택): 내부 실행 개념은 기존처럼 `adapter + target`을 유지한다. Pi는 새 top-level adapter가 아니라 `cli` adapter의 target/profile로 추가한다.
 - 선행 작업: CLI Automation Runtime 안정화, OpenAI Workspace Agent Execution Contract
 - 후속 작업: CLI Agent Group Grade Routing에서 Pi target을 agent group 후보로 포함한다.
diff --git a/agent-roadmap/phase/automation-runtime-bridge/milestones/remote-terminal-bridge-poc.md b/agent-roadmap/phase/automation-runtime-bridge/milestones/remote-terminal-bridge-poc.md
index eb3b104..c8406fb 100644
--- a/agent-roadmap/phase/automation-runtime-bridge/milestones/remote-terminal-bridge-poc.md
+++ b/agent-roadmap/phase/automation-runtime-bridge/milestones/remote-terminal-bridge-poc.md
@@ -2,8 +2,8 @@
 
 ## 위치
 
-- Roadmap: `agent-roadmap/ROADMAP.md`
-- Phase: `agent-roadmap/phase/automation-runtime-bridge/PHASE.md`
+- Roadmap: [ROADMAP.md](../../../ROADMAP.md)
+- Phase: [PHASE.md](../PHASE.md)
 
 ## 목표
 
@@ -62,7 +62,7 @@ Edge는 terminal session broker가 되고, 대상에 도달 가능한 Node가 SS
 
 ## 작업 컨텍스트
 
-- 관련 경로: `apps/edge`, `apps/node`, `README.md`, `agent-test/local/edge-smoke.md`, `agent-test/local/node-smoke.md`
+- 관련 경로: `apps/edge`, `apps/node`, [README.md](../../../../README.md), [edge-smoke.md](../../../../agent-test/local/edge-smoke.md), [node-smoke.md](../../../../agent-test/local/node-smoke.md)
 - 표준선(선택): Control Plane/Client/운영 CLI는 Edge에 terminal session을 요청하고, Edge가 Node terminal transport로 중계한다. OpenAI-compatible/A2A payload에 terminal 제어를 싣지 않는다.
 - 선행 작업: Edge-Node 실행 스켈레톤, CLI Automation Runtime 안정화
 - 후속 작업: 정책, 이력, 감사; Control Plane과 Client의 terminal session 운영 표면
diff --git a/agent-roadmap/phase/automation-runtime-bridge/milestones/remote-workspace-operations-environment.md b/agent-roadmap/phase/automation-runtime-bridge/milestones/remote-workspace-operations-environment.md
index 9f157f4..acb15f1 100644
--- a/agent-roadmap/phase/automation-runtime-bridge/milestones/remote-workspace-operations-environment.md
+++ b/agent-roadmap/phase/automation-runtime-bridge/milestones/remote-workspace-operations-environment.md
@@ -2,8 +2,8 @@
 
 ## 위치
 
-- Roadmap: `agent-roadmap/ROADMAP.md`
-- Phase: `agent-roadmap/phase/automation-runtime-bridge/PHASE.md`
+- Roadmap: [ROADMAP.md](../../../ROADMAP.md)
+- Phase: [PHASE.md](../PHASE.md)
 
 ## 목표
 
@@ -65,7 +65,7 @@ CLI Agent와 workspace-bound execution을 이용해 원격 코딩 환경과 원
 
 ## 작업 컨텍스트
 
-- 관련 경로: `apps/edge`, `apps/node`, `apps/control-plane`, `apps/client`, `agent-contract/outer/openai-compatible-api.md`
+- 관련 경로: `apps/edge`, `apps/node`, `apps/control-plane`, `apps/client`, [openai-compatible-api.md](../../../../agent-contract/outer/openai-compatible-api.md)
 - 표준선(선택): 외부 실행 호출은 OpenAI-compatible shape와 `metadata.workspace`를 유지하고, lifecycle/artifact/approval은 IOP native 운영 표면에서 다룬다.
 - 선행 작업: OpenAI Workspace Agent Execution Contract
 - 후속 작업: 원격 터미널/CLI 터널링 POC, 정책/이력/감사
diff --git a/agent-roadmap/phase/automation-runtime-bridge/milestones/workspace-port-env-standardization.md b/agent-roadmap/phase/automation-runtime-bridge/milestones/workspace-port-env-standardization.md
index 60d510c..d76667f 100644
--- a/agent-roadmap/phase/automation-runtime-bridge/milestones/workspace-port-env-standardization.md
+++ b/agent-roadmap/phase/automation-runtime-bridge/milestones/workspace-port-env-standardization.md
@@ -2,8 +2,8 @@
 
 ## 위치
 
-- Roadmap: `agent-roadmap/ROADMAP.md`
-- Phase: `agent-roadmap/phase/automation-runtime-bridge/PHASE.md`
+- Roadmap: [ROADMAP.md](../../../ROADMAP.md)
+- Phase: [PHASE.md](../PHASE.md)
 
 ## 목표
 
@@ -81,7 +81,7 @@ Inventory에서 확인된 drift를 실제 기본값, 문서, smoke evidence로 
 ### Compatibility checklist
 
 - Smoke: `make test-control-plane-edge-wire`, `./scripts/e2e-smoke.sh`, `./scripts/e2e-openai-ollama.sh`가 새 host slot 또는 명시 override에서 통과해야 한다.
-- Client config: `apps/client/lib/client_config.dart`, `apps/client/Dockerfile`, `apps/client/README.md`, `scripts/dev/web.sh`, `Makefile client-build-web`, compose build args의 HTTP/WS URL 기본값을 같은 기준으로 맞춘다.
+- Client config: `apps/client/lib/client_config.dart`, `apps/client/Dockerfile`, [README.md](../../../../apps/client/README.md), `scripts/dev/web.sh`, `Makefile client-build-web`, compose build args의 HTTP/WS URL 기본값을 같은 기준으로 맞춘다.
 - Remote runner: Docker compose 검증은 원격 runner/code-server에서 수행하고, 포트 `13000`, `18000`, `18080`, `18081`, `19080`, `19081`, `19090`, `19092`, `15400`, `16300` 충돌 여부를 확인한다.
 - Field compatibility: 기존 field 슬롯 `18080`, `18081`, `19080`, `19090`은 smoke evidence가 확보될 때까지 유지하거나 명시 migration note를 남긴다.
 - Secret hygiene: host, token, credential 원문은 tracked docs/roadmap/plan에 기록하지 않는다.
diff --git a/agent-roadmap/phase/knowledge-tool-optimization-extension/PHASE.md b/agent-roadmap/phase/knowledge-tool-optimization-extension/PHASE.md
index a6e27fd..b93f90c 100644
--- a/agent-roadmap/phase/knowledge-tool-optimization-extension/PHASE.md
+++ b/agent-roadmap/phase/knowledge-tool-optimization-extension/PHASE.md
@@ -16,31 +16,31 @@ Ollama serving 경로와 운영 기반이 안정화된 뒤, 단계 호출, tool/
 완료, 검토중, 진행중, 계획, 스케치 순서로 두어 아래로 갈수록 미래 작업에 가까워지게 정렬한다.
 
 - [완료] Tool Call Runtime 검증 재시도 MVP
-  - 경로: `agent-roadmap/archive/phase/knowledge-tool-optimization-extension/milestones/tool-call-runtime-validation-retry.md`
+  - 경로: [tool-call-runtime-validation-retry](../../archive/phase/knowledge-tool-optimization-extension/milestones/tool-call-runtime-validation-retry.md)
   - 요약: 명시적 `tools[]`/`tool_choice` 계약이 있는 OpenAI-compatible 요청에서 IOP 내부 provider 응답의 마지막 tool call을 검증하고, schema 불일치 시 같은 요청을 bounded exact replay로 재시도하는 runtime-only MVP를 구현한다.
 
 - [완료] OpenAI-compatible Think 제어 MVP
-  - 경로: `agent-roadmap/archive/phase/knowledge-tool-optimization-extension/milestones/openai-compatible-think-control.md`
+  - 경로: [openai-compatible-think-control](../../archive/phase/knowledge-tool-optimization-extension/milestones/openai-compatible-think-control.md)
   - 요약: OpenAI-compatible Chat Completions 요청에서 thinking/reasoning 생성과 응답 노출을 요청별로 제어하고 provider별 option 매핑과 unsupported 정책을 구현한다.
 
 - [완료] OpenAI-compatible Tool Call Boundary Hardening
-  - 경로: `agent-roadmap/archive/phase/knowledge-tool-optimization-extension/milestones/openai-compatible-tool-call-boundary-hardening.md`
+  - 경로: [openai-compatible-tool-call-boundary-hardening](../../archive/phase/knowledge-tool-optimization-extension/milestones/openai-compatible-tool-call-boundary-hardening.md)
   - 요약: provider-pool/OpenAI-compatible 응답에서 raw text tool-call block, unknown tool name, chat-template sentinel token이 클라이언트 화면으로 새지 않도록 Edge tool-call 경계를 검증/정규화한다.
 
 - [스케치] 단계 호출과 검증 최적화 MVP
-  - 경로: `agent-roadmap/phase/knowledge-tool-optimization-extension/milestones/knowledge-tool-validation-optimization.md`
+  - 경로: [knowledge-tool-validation-optimization](milestones/knowledge-tool-validation-optimization.md)
   - 요약: 요청 의도 분석, 실제 작업, 검증/schema 강제, 오류 시 회귀를 단계 호출 실행 모드의 MVP 후보로 스케치한다.
 
 - [스케치] Tool Call 판정 모델 Gate 리뷰
-  - 경로: `agent-roadmap/phase/knowledge-tool-optimization-extension/milestones/tool-call-validator-model-gate-review.md`
+  - 경로: [tool-call-validator-model-gate-review](milestones/tool-call-validator-model-gate-review.md)
   - 요약: 명시적 tool schema만으로 판정할 수 없는 자연어/텍스트/agent-specific tool call 후보를 별도 validator 모델로 분류할지, 어떤 조건에서 허용할지 사용자 리뷰가 필요한 결정 항목으로 스케치한다.
 
 - [스케치] 장기 기억과 RAG 업데이트 사이클 (2차)
-  - 경로: `agent-roadmap/phase/knowledge-tool-optimization-extension/milestones/long-term-memory-rag-second-wave.md`
+  - 경로: [long-term-memory-rag-second-wave](milestones/long-term-memory-rag-second-wave.md)
   - 요약: 특정 repo 장기 기억, RAG 저장소, update cycle, MCP 기반 context 절약은 MVP 이후 2차 후보로 스케치한다.
 
 - [스케치] Advisor와 Context Hook 최적화 (2차)
-  - 경로: `agent-roadmap/phase/knowledge-tool-optimization-extension/milestones/advisor-context-hook-second-wave.md`
+  - 경로: [advisor-context-hook-second-wave](milestones/advisor-context-hook-second-wave.md)
   - 요약: advisor 역할과 로컬 LLM hook 기반 context compression 최적화는 MVP 이후 2차 후보로 스케치한다.
 
 ## Phase 경계
diff --git a/agent-roadmap/phase/knowledge-tool-optimization-extension/milestones/advisor-context-hook-second-wave.md b/agent-roadmap/phase/knowledge-tool-optimization-extension/milestones/advisor-context-hook-second-wave.md
index 7f0e055..0ff4c17 100644
--- a/agent-roadmap/phase/knowledge-tool-optimization-extension/milestones/advisor-context-hook-second-wave.md
+++ b/agent-roadmap/phase/knowledge-tool-optimization-extension/milestones/advisor-context-hook-second-wave.md
@@ -2,8 +2,8 @@
 
 ## 위치
 
-- Roadmap: `agent-roadmap/ROADMAP.md`
-- Phase: `agent-roadmap/phase/knowledge-tool-optimization-extension/PHASE.md`
+- Roadmap: [ROADMAP.md](../../../ROADMAP.md)
+- Phase: [PHASE.md](../PHASE.md)
 
 ## 목표
 
diff --git a/agent-roadmap/phase/knowledge-tool-optimization-extension/milestones/knowledge-tool-validation-optimization.md b/agent-roadmap/phase/knowledge-tool-optimization-extension/milestones/knowledge-tool-validation-optimization.md
index 6f8146b..006269f 100644
--- a/agent-roadmap/phase/knowledge-tool-optimization-extension/milestones/knowledge-tool-validation-optimization.md
+++ b/agent-roadmap/phase/knowledge-tool-optimization-extension/milestones/knowledge-tool-validation-optimization.md
@@ -2,8 +2,8 @@
 
 ## 위치
 
-- Roadmap: `agent-roadmap/ROADMAP.md`
-- Phase: `agent-roadmap/phase/knowledge-tool-optimization-extension/PHASE.md`
+- Roadmap: [ROADMAP.md](../../../ROADMAP.md)
+- Phase: [PHASE.md](../PHASE.md)
 
 ## 목표
 
@@ -68,7 +68,7 @@
 
 ## 작업 컨텍스트
 
-- 관련 경로: `apps/edge`, `apps/node`, `apps/control-plane`, `packages/go/policy`, `packages/go/jobs`, `proto/iop`, `agent-contract/outer/openai-compatible-api.md`
+- 관련 경로: `apps/edge`, `apps/node`, `apps/control-plane`, `packages/go/policy`, `packages/go/jobs`, `proto/iop`, [openai-compatible-api.md](../../../../agent-contract/outer/openai-compatible-api.md)
 - 표준선(선택): 외부 실행 호출 계약은 OpenAI-compatible shape를 우선 유지하고, IOP 고유 문맥은 `metadata`나 IOP native endpoint의 명시 필드로 전달한다.
 - 표준선(선택): 단계 호출은 단순 provider 라우팅과 충돌하는 책임이 아니라, 사용자가 선택할 수 있는 IOP 실행 모드 후보로 본다.
 - 선행 작업: Edge 모델 그룹 Queue 스케줄링 전환, 운영 관측과 Provider 관리
diff --git a/agent-roadmap/phase/knowledge-tool-optimization-extension/milestones/long-term-memory-rag-second-wave.md b/agent-roadmap/phase/knowledge-tool-optimization-extension/milestones/long-term-memory-rag-second-wave.md
index 4a76505..0caf4d2 100644
--- a/agent-roadmap/phase/knowledge-tool-optimization-extension/milestones/long-term-memory-rag-second-wave.md
+++ b/agent-roadmap/phase/knowledge-tool-optimization-extension/milestones/long-term-memory-rag-second-wave.md
@@ -2,8 +2,8 @@
 
 ## 위치
 
-- Roadmap: `agent-roadmap/ROADMAP.md`
-- Phase: `agent-roadmap/phase/knowledge-tool-optimization-extension/PHASE.md`
+- Roadmap: [ROADMAP.md](../../../ROADMAP.md)
+- Phase: [PHASE.md](../PHASE.md)
 
 ## 목표
 
diff --git a/agent-roadmap/phase/knowledge-tool-optimization-extension/milestones/openai-compatible-think-control.md b/agent-roadmap/phase/knowledge-tool-optimization-extension/milestones/openai-compatible-think-control.md
index 0c12661..32b162d 100644
--- a/agent-roadmap/phase/knowledge-tool-optimization-extension/milestones/openai-compatible-think-control.md
+++ b/agent-roadmap/phase/knowledge-tool-optimization-extension/milestones/openai-compatible-think-control.md
@@ -2,8 +2,8 @@
 
 ## 위치
 
-- Roadmap: `agent-roadmap/ROADMAP.md`
-- Phase: `agent-roadmap/phase/knowledge-tool-optimization-extension/PHASE.md`
+- Roadmap: [ROADMAP.md](../../../ROADMAP.md)
+- Phase: [PHASE.md](../PHASE.md)
 
 ## 목표
 
@@ -23,7 +23,7 @@ provider runtime은 reasoning-capable 상태로 유지하되, Edge가 공개 요
 
 - 상태: 해제
 - SDD: 필요
-- SDD 문서: `agent-roadmap/sdd/knowledge-tool-optimization-extension/openai-compatible-think-control/SDD.md`
+- SDD 문서: 없음 (작성 전)
 - SDD 사유: OpenAI-compatible request schema, provider option 매핑, streaming response 노출 정책이 바뀌는 API 계약 Milestone이다.
 - 잠금 해제 조건:
   - [x] SDD 잠금이 해제되어 있다.
@@ -73,7 +73,7 @@ OpenAI-compatible 호출자가 요청 단위로 thinking/reasoning 생성과 노
 
 ## 작업 컨텍스트
 
-- 관련 경로: `apps/edge/internal/openai`, `apps/node/internal/adapters/openai_compat`, `agent-contract/outer/openai-compatible-api.md`, `docs/openai-compatible-api-contract.md`, `agent-test/dev`
+- 관련 경로: `apps/edge/internal/openai`, `apps/node/internal/adapters/openai_compat`, [openai-compatible-api.md](../../../../agent-contract/outer/openai-compatible-api.md), [openai-compatible-api-contract.md](../../../../docs/openai-compatible-api-contract.md), `agent-test/dev`
 - 표준선(선택): provider runtime은 reasoning-capable 상태로 띄우고, 요청별 제어는 OpenAI-compatible Edge request 계약에서 검증한 뒤 provider별 지원 option으로 매핑한다.
 - 표준선(선택): 공개 request 표면은 provider raw wrapper를 그대로 열지 않고, IOP가 검증 가능한 OpenAI-compatible field와 내부 provider option 매핑으로 둔다.
 - 선행 작업: OpenAI-compatible reasoning raw trace와 dev-runtime provider reasoning 활성화
diff --git a/agent-roadmap/phase/knowledge-tool-optimization-extension/milestones/tool-call-validator-model-gate-review.md b/agent-roadmap/phase/knowledge-tool-optimization-extension/milestones/tool-call-validator-model-gate-review.md
index 79177b0..aded09d 100644
--- a/agent-roadmap/phase/knowledge-tool-optimization-extension/milestones/tool-call-validator-model-gate-review.md
+++ b/agent-roadmap/phase/knowledge-tool-optimization-extension/milestones/tool-call-validator-model-gate-review.md
@@ -2,8 +2,8 @@
 
 ## 위치
 
-- Roadmap: `agent-roadmap/ROADMAP.md`
-- Phase: `agent-roadmap/phase/knowledge-tool-optimization-extension/PHASE.md`
+- Roadmap: [ROADMAP.md](../../../ROADMAP.md)
+- Phase: [PHASE.md](../PHASE.md)
 
 ## 목표
 
@@ -78,7 +78,7 @@ runtime-only validation으로 해결되지 않는 애매한 tool-call 후보를
 
 ## 작업 컨텍스트
 
-- 관련 경로: `apps/edge/internal/openai`, `apps/edge/internal/service`, `packages/go/policy`, `agent-contract/outer/openai-compatible-api.md`
+- 관련 경로: `apps/edge/internal/openai`, `apps/edge/internal/service`, `packages/go/policy`, [openai-compatible-api.md](../../../../agent-contract/outer/openai-compatible-api.md)
 - 표준선(선택): 명시 schema가 있는 요청은 runtime-only validator가 우선이며, 모델 gate는 schema가 없거나 출력 의도가 애매한 케이스에 한정해 검토한다.
 - 표준선(선택): 모델 판정은 오판 가능성이 있으므로 사용자 승인 전에는 blocking source of truth로 삼지 않는다.
 - 선행 작업: Tool Call Runtime 검증 재시도 MVP
diff --git a/agent-roadmap/phase/operational-observability-provider-management/PHASE.md b/agent-roadmap/phase/operational-observability-provider-management/PHASE.md
index 04d191f..e283046 100644
--- a/agent-roadmap/phase/operational-observability-provider-management/PHASE.md
+++ b/agent-roadmap/phase/operational-observability-provider-management/PHASE.md
@@ -17,35 +17,35 @@ provider 확장 Phase에서 검증한 Ollama, vLLM, SGLang, Lemonade 같은 추
 스케치 Milestone은 아직 구현 가능한 계획이 아니므로 사용자 검토와 구체화 후 `[계획]`으로 승격한다.
 
 - [완료] Model Alias Provider Pool과 Provider Catalog
-  - 경로: `agent-roadmap/archive/phase/operational-observability-provider-management/milestones/provider-catalog-device-status.md`
+  - 경로: [provider-catalog-device-status](../../archive/phase/operational-observability-provider-management/milestones/provider-catalog-device-status.md)
   - 요약: `models[]`를 외부 model key이자 운영 catalog model로 두고, Node 하위 provider와 served model list를 기준으로 Edge가 provider 선택, load-ratio routing, target rewrite, read-only catalog 상태를 소유하는 MVP 계약을 완료했다.
 
 - [완료] Node Resource Model Unification
-  - 경로: `agent-roadmap/archive/phase/operational-observability-provider-management/milestones/node-resource-model-unification.md`
+  - 경로: [node-resource-model-unification](../../archive/phase/operational-observability-provider-management/milestones/node-resource-model-unification.md)
   - 요약: Node를 Edge 연결 identity로 두고 CLI, OpenAI-compatible provider, 기타 resource를 같은 Node 아래 나열하며 provider/resource capacity만 concurrency를 소유하도록 runtime 계약과 dev-runtime 구성을 정렬했다.
 
 - [완료] Node Provider-First Config Surface
-  - 경로: `agent-roadmap/archive/phase/operational-observability-provider-management/milestones/node-provider-first-config-surface.md`
+  - 경로: [node-provider-first-config-surface](../../archive/phase/operational-observability-provider-management/milestones/node-provider-first-config-surface.md)
   - 요약: Node 설정 표면을 `providers[]` resource list 중심으로 재정렬하고, adapter 설정은 내부 실행 IR 또는 legacy compat로 낮춰 운영자가 한 Node의 CLI/provider 자원을 한 곳에서 이해하고 관리하게 만들었다.
 
 - [완료] Model Group Long-Context Admission
-  - 경로: `agent-roadmap/archive/phase/operational-observability-provider-management/milestones/model-group-long-context-admission.md`
+  - 경로: [model-group-long-context-admission](../../archive/phase/operational-observability-provider-management/milestones/model-group-long-context-admission.md)
   - 요약: model group의 단일 context window 계약을 유지하면서 입력 기준 long-context 요청을 별도 slot으로 admission하고, long 요청이 찬 provider와 queue 앞 long 요청이 normal 요청을 불필요하게 막지 않도록 라우팅 정책을 완료했다.
 
 - [스케치] 사용량, 토큰, 로그 운영 추적 MVP
-  - 경로: `agent-roadmap/phase/operational-observability-provider-management/milestones/usage-token-log-ops-mvp.md`
+  - 경로: [usage-token-log-ops-mvp](milestones/usage-token-log-ops-mvp.md)
   - 요약: 사용자 관리, token 관리, API/CLI/local inference 사용량 집계, 요청별 device/provider/time/token ledger, 로그 관리의 1차 운영 경계를 스케치한다.
 
 - [스케치] 요청 실행 로그와 Usage Ledger 기반
-  - 경로: `agent-roadmap/phase/operational-observability-provider-management/milestones/request-execution-log-usage-ledger-foundation.md`
+  - 경로: [request-execution-log-usage-ledger-foundation](milestones/request-execution-log-usage-ledger-foundation.md)
   - 요약: 사용자 요청 하나의 device/provider/model 선택, queue/dispatch/start/first-token/end 시간, token breakdown, status/error를 구조화된 실행 로그와 usage ledger로 남기는 로그 시스템 개편 후보를 스케치한다.
 
 - [스케치] Provider-Device-Model Qualification 리포트와 Lifecycle 관리
-  - 경로: `agent-roadmap/phase/operational-observability-provider-management/milestones/provider-device-model-qualification-report.md`
+  - 경로: [provider-device-model-qualification-report](milestones/provider-device-model-qualification-report.md)
   - 요약: provider catalog와 device 상태 기준선 뒤에, 여러 모델을 각 device/provider에서 측정하고 공식 공개 benchmark와 함께 보여주는 qualification 리포트, compatibility/performance/quality/lifecycle 비교 경계를 깊게 스케치한다.
 
 - [스케치] Provider Runtime 설정과 모델 획득 오케스트레이션
-  - 경로: `agent-roadmap/phase/operational-observability-provider-management/milestones/provider-runtime-model-acquisition-orchestration.md`
+  - 경로: [provider-runtime-model-acquisition-orchestration](milestones/provider-runtime-model-acquisition-orchestration.md)
   - 요약: IOP가 vLLM, vLLM-MLX, Lemonade 같은 provider runtime의 launch/profile 설정과 모델 후보 선정, 다운로드, 캐시, 검증, 적용 경계를 어디까지 소유할지 장기 후속 축으로 스케치한다.
 
 ## Phase 경계
diff --git a/agent-roadmap/phase/operational-observability-provider-management/milestones/provider-device-model-qualification-report.md b/agent-roadmap/phase/operational-observability-provider-management/milestones/provider-device-model-qualification-report.md
index 4a84d32..9bd9a45 100644
--- a/agent-roadmap/phase/operational-observability-provider-management/milestones/provider-device-model-qualification-report.md
+++ b/agent-roadmap/phase/operational-observability-provider-management/milestones/provider-device-model-qualification-report.md
@@ -2,8 +2,8 @@
 
 ## 위치
 
-- Roadmap: `agent-roadmap/ROADMAP.md`
-- Phase: `agent-roadmap/phase/operational-observability-provider-management/PHASE.md`
+- Roadmap: [ROADMAP.md](../../../ROADMAP.md)
+- Phase: [PHASE.md](../PHASE.md)
 
 ## 목표
 
@@ -28,7 +28,7 @@ provider별 모델 lifecycle capability 차이를 IOP가 어떻게 흡수하고,
 
 - 상태: 잠금
 - SDD: 필요
-- SDD 경로: `agent-roadmap/sdd/operational-observability-provider-management/provider-device-model-qualification-report/SDD.md`
+- SDD 경로: 없음 (작성 전)
 - SDD 사유: provider lifecycle 제어, report schema, 저장 책임, 운영 UI/API 경계가 함께 걸리는 제품 설계 Milestone이다.
 - 잠금 해제 조건: 아래 체크리스트
   - [ ] SDD 잠금이 해제되어 있다.
diff --git a/agent-roadmap/phase/operational-observability-provider-management/milestones/provider-runtime-model-acquisition-orchestration.md b/agent-roadmap/phase/operational-observability-provider-management/milestones/provider-runtime-model-acquisition-orchestration.md
index a0812e4..ddcecfc 100644
--- a/agent-roadmap/phase/operational-observability-provider-management/milestones/provider-runtime-model-acquisition-orchestration.md
+++ b/agent-roadmap/phase/operational-observability-provider-management/milestones/provider-runtime-model-acquisition-orchestration.md
@@ -2,8 +2,8 @@
 
 ## 위치
 
-- Roadmap: `agent-roadmap/ROADMAP.md`
-- Phase: `agent-roadmap/phase/operational-observability-provider-management/PHASE.md`
+- Roadmap: [ROADMAP.md](../../../ROADMAP.md)
+- Phase: [PHASE.md](../PHASE.md)
 
 ## 목표
 
@@ -27,7 +27,7 @@ model group의 context/capacity 계약을 실제 provider launch option, 모델
 
 - 상태: 잠금
 - SDD: 필요
-- SDD 문서: `agent-roadmap/sdd/operational-observability-provider-management/provider-runtime-model-acquisition-orchestration/SDD.md`
+- SDD 문서: 없음 (작성 전)
 - SDD 사유: provider runtime launch/restart, 모델 다운로드, artifact cache, rollback, 외부 provider 쓰기와 host 자원 변경을 포함하는 장기 설계 Milestone이다.
 - 잠금 해제 조건: 아래 체크리스트
   - [ ] SDD 잠금이 해제되어 있다.
@@ -85,7 +85,7 @@ provider runtime 설정과 모델 artifact 획득을 IOP 운영 계약으로 끌
 
 ## 작업 컨텍스트
 
-- 관련 경로: `apps/edge`, `apps/node`, `packages/go/config`, `configs/edge.yaml`, `agent-test/dev/inventory.yaml`, `agent-test/dev/edge-smoke.md`, `agent-test/dev/node-smoke.md`
+- 관련 경로: `apps/edge`, `apps/node`, `packages/go/config`, `configs/edge.yaml`, `agent-test/dev/inventory.yaml`, [edge-smoke.md](../../../../agent-test/dev/edge-smoke.md), [node-smoke.md](../../../../agent-test/dev/node-smoke.md)
 - 표준선(선택): long-context admission은 routing 필요조건이며, provider runtime/model acquisition orchestration은 그 정책을 실제 runtime에서 만족하게 만드는 충분조건 후보이다.
 - 표준선(선택): vLLM/vLLM-MLX는 launch profile과 health/capacity verification부터 시작하고, Lemonade는 앱/API 설정 소유권 경계를 먼저 확인한다.
 - 표준선(선택): 모델 다운로드와 삭제는 disk/resource 영향이 크므로 초기에는 사용자 승인 기반 dry-run/apply 흐름을 우선한다.
diff --git a/agent-roadmap/phase/operational-observability-provider-management/milestones/request-execution-log-usage-ledger-foundation.md b/agent-roadmap/phase/operational-observability-provider-management/milestones/request-execution-log-usage-ledger-foundation.md
index a888c9a..51bad4e 100644
--- a/agent-roadmap/phase/operational-observability-provider-management/milestones/request-execution-log-usage-ledger-foundation.md
+++ b/agent-roadmap/phase/operational-observability-provider-management/milestones/request-execution-log-usage-ledger-foundation.md
@@ -2,8 +2,8 @@
 
 ## 위치
 
-- Roadmap: `agent-roadmap/ROADMAP.md`
-- Phase: `agent-roadmap/phase/operational-observability-provider-management/PHASE.md`
+- Roadmap: [ROADMAP.md](../../../ROADMAP.md)
+- Phase: [PHASE.md](../PHASE.md)
 
 ## 목표
 
@@ -29,7 +29,7 @@ provider/tool-call bridge에서 native tool call, text fallback, synthesized too
 
 - 상태: 잠금
 - SDD: 필요
-- SDD 문서: `agent-roadmap/sdd/operational-observability-provider-management/request-execution-log-usage-ledger-foundation/SDD.md`
+- SDD 문서: [SDD.md](../../../sdd/operational-observability-provider-management/request-execution-log-usage-ledger-foundation/SDD.md)
 - SDD 사유: 요청 실행 로그와 usage ledger는 proto/event/schema/storage/API, 데이터 보존, 권한, 실패 처리 경계를 함께 바꾸는 설계 Milestone이다.
 - 잠금 해제 조건: 아래 체크리스트
   - [ ] SDD 잠금이 해제되어 있다.
@@ -93,7 +93,7 @@ provider/tool-call bridge에서 native tool call, text fallback, synthesized too
 - 표준선(선택): Edge는 runtime execution과 provider routing의 원본 이벤트를 가장 먼저 알고, Control Plane은 연결 view와 운영 조회/export 표면을 제공한다.
 - 표준선(선택): usage는 provider-reported 값을 우선하고, provider가 주지 않는 값은 estimated 또는 unavailable로 명시해 정확도와 추정을 분리한다.
 - 표준선(선택): tool-call 추적은 기본적으로 raw 원문 저장보다 `run_id` 기준 판정 필드, 길이, hash, 짧은 redacted preview를 우선하고, bounded raw capture는 명시적으로 켠 진단 모드로 제한한다.
-- SDD gate: `agent-roadmap/sdd/operational-observability-provider-management/request-execution-log-usage-ledger-foundation/SDD.md`, 사용자 리뷰 `USER_REVIEW.md`
+- SDD gate: [SDD.md](../../../sdd/operational-observability-provider-management/request-execution-log-usage-ledger-foundation/SDD.md), 사용자 리뷰 [USER_REVIEW.md](../../../sdd/operational-observability-provider-management/request-execution-log-usage-ledger-foundation/USER_REVIEW.md)
 - 선행 작업: 사용량, 토큰, 로그 운영 추적 MVP
 - 후속 작업: Provider-Device-Model Qualification 리포트, 운영 리포트, 품질 기반 routing/fallback 고도화
 - 확인 필요: ledger canonical owner, usage source 표시 정책, tool-call/raw chunk redaction과 capture 수준, redaction/retention 기본값, schema 분리 여부
diff --git a/agent-roadmap/phase/operational-observability-provider-management/milestones/usage-token-log-ops-mvp.md b/agent-roadmap/phase/operational-observability-provider-management/milestones/usage-token-log-ops-mvp.md
index 5107d92..4fc519f 100644
--- a/agent-roadmap/phase/operational-observability-provider-management/milestones/usage-token-log-ops-mvp.md
+++ b/agent-roadmap/phase/operational-observability-provider-management/milestones/usage-token-log-ops-mvp.md
@@ -2,8 +2,8 @@
 
 ## 위치
 
-- Roadmap: `agent-roadmap/ROADMAP.md`
-- Phase: `agent-roadmap/phase/operational-observability-provider-management/PHASE.md`
+- Roadmap: [ROADMAP.md](../../../ROADMAP.md)
+- Phase: [PHASE.md](../PHASE.md)
 
 ## 목표
 
diff --git a/agent-roadmap/phase/update-plane-self-update-foundation/PHASE.md b/agent-roadmap/phase/update-plane-self-update-foundation/PHASE.md
index 414a81d..cf39318 100644
--- a/agent-roadmap/phase/update-plane-self-update-foundation/PHASE.md
+++ b/agent-roadmap/phase/update-plane-self-update-foundation/PHASE.md
@@ -17,19 +17,19 @@ Control Plane은 release manifest, desired version, rollout/audit view를 제공
 스케치 Milestone은 아직 구현 가능한 계획이 아니므로 사용자 검토와 구체화 후 `[계획]`으로 승격한다.
 
 - [완료] Edge/Node Runtime Reconnect와 Config Refresh
-  - 경로: `agent-roadmap/archive/phase/update-plane-self-update-foundation/milestones/runtime-reconnect-config-refresh.md`
+  - 경로: [runtime-reconnect-config-refresh](../../archive/phase/update-plane-self-update-foundation/milestones/runtime-reconnect-config-refresh.md)
   - 요약: Edge 단절 후 Node 10초 간격 10회 재접속과 종료 정책, 운영 중 config refresh/diff/apply/Node 전파의 MVP 경계를 구현 가능한 계획으로 정리한다.
 
 - [스케치] Update Plane 안정 프로토콜
-  - 경로: `agent-roadmap/phase/update-plane-self-update-foundation/milestones/update-plane-stable-protocol.md`
+  - 경로: [update-plane-stable-protocol](milestones/update-plane-stable-protocol.md)
   - 요약: 전체 운영 프로토콜이 바뀌어도 업데이트를 지속할 수 있는 hello/status, manifest, command, event, recovery 최소 계약을 스케치한다.
 
 - [스케치] Host-local Manager 기반 자체 업데이트
-  - 경로: `agent-roadmap/phase/update-plane-self-update-foundation/milestones/host-local-manager-self-update.md`
+  - 경로: [host-local-manager-self-update](milestones/host-local-manager-self-update.md)
   - 요약: Edge/Node 앱 프로세스 바깥의 manager/updater가 release staging, 검증, 프로세스 종료/재시작, rollback을 담당하는 cross-OS 실행 모델을 스케치한다.
 
 - [스케치] Edge/Node 롤아웃과 복구 정책
-  - 경로: `agent-roadmap/phase/update-plane-self-update-foundation/milestones/edge-node-rollout-recovery-policy.md`
+  - 경로: [edge-node-rollout-recovery-policy](milestones/edge-node-rollout-recovery-policy.md)
   - 요약: Edge가 Node rolling update와 자기 업데이트를 조율하고, 실패/재연결/rollback 상태를 Control Plane에 보고하는 운영 정책을 스케치한다.
 
 ## Phase 경계
diff --git a/agent-roadmap/phase/update-plane-self-update-foundation/milestones/edge-node-rollout-recovery-policy.md b/agent-roadmap/phase/update-plane-self-update-foundation/milestones/edge-node-rollout-recovery-policy.md
index de96579..54fa421 100644
--- a/agent-roadmap/phase/update-plane-self-update-foundation/milestones/edge-node-rollout-recovery-policy.md
+++ b/agent-roadmap/phase/update-plane-self-update-foundation/milestones/edge-node-rollout-recovery-policy.md
@@ -2,8 +2,8 @@
 
 ## 위치
 
-- Roadmap: `agent-roadmap/ROADMAP.md`
-- Phase: `agent-roadmap/phase/update-plane-self-update-foundation/PHASE.md`
+- Roadmap: [ROADMAP.md](../../../ROADMAP.md)
+- Phase: [PHASE.md](../PHASE.md)
 
 ## 목표
 
@@ -26,7 +26,7 @@ Node 연결 단절, Edge 재시작, protocol mismatch, artifact 검증 실패 
 
 - 상태: 잠금
 - SDD: 필요
-- SDD 문서: `agent-roadmap/sdd/update-plane-self-update-foundation/edge-node-rollout-recovery-policy/SDD.md`
+- SDD 문서: 없음 (작성 전)
 - SDD 사유: Edge/Node update lifecycle, drain/restart/rollback 정책, 상태 캐시와 Control Plane 보고 계약이 필요하다.
 - 잠금 해제 조건:
   - [ ] SDD 잠금이 해제되어 있다
diff --git a/agent-roadmap/phase/update-plane-self-update-foundation/milestones/host-local-manager-self-update.md b/agent-roadmap/phase/update-plane-self-update-foundation/milestones/host-local-manager-self-update.md
index 8820d90..c1f0eb0 100644
--- a/agent-roadmap/phase/update-plane-self-update-foundation/milestones/host-local-manager-self-update.md
+++ b/agent-roadmap/phase/update-plane-self-update-foundation/milestones/host-local-manager-self-update.md
@@ -2,8 +2,8 @@
 
 ## 위치
 
-- Roadmap: `agent-roadmap/ROADMAP.md`
-- Phase: `agent-roadmap/phase/update-plane-self-update-foundation/PHASE.md`
+- Roadmap: [ROADMAP.md](../../../ROADMAP.md)
+- Phase: [PHASE.md](../PHASE.md)
 
 ## 목표
 
@@ -26,7 +26,7 @@ Linux, macOS, Windows에서 공통으로 유지할 release directory와 current
 
 - 상태: 잠금
 - SDD: 필요
-- SDD 문서: `agent-roadmap/sdd/update-plane-self-update-foundation/host-local-manager-self-update/SDD.md`
+- SDD 문서: 없음 (작성 전)
 - SDD 사유: cross-OS 프로세스 lifecycle, 파일 전환, rollback 상태 머신, service manager 연동에 영향을 준다.
 - 잠금 해제 조건:
   - [ ] SDD 잠금이 해제되어 있다
diff --git a/agent-roadmap/phase/update-plane-self-update-foundation/milestones/update-plane-stable-protocol.md b/agent-roadmap/phase/update-plane-self-update-foundation/milestones/update-plane-stable-protocol.md
index f14b144..4c7ff1a 100644
--- a/agent-roadmap/phase/update-plane-self-update-foundation/milestones/update-plane-stable-protocol.md
+++ b/agent-roadmap/phase/update-plane-self-update-foundation/milestones/update-plane-stable-protocol.md
@@ -2,8 +2,8 @@
 
 ## 위치
 
-- Roadmap: `agent-roadmap/ROADMAP.md`
-- Phase: `agent-roadmap/phase/update-plane-self-update-foundation/PHASE.md`
+- Roadmap: [ROADMAP.md](../../../ROADMAP.md)
+- Phase: [PHASE.md](../PHASE.md)
 
 ## 목표
 
@@ -26,7 +26,7 @@ hello/status, release manifest, update command, update event, recovery 판단에
 
 - 상태: 잠금
 - SDD: 필요
-- SDD 문서: `agent-roadmap/sdd/update-plane-self-update-foundation/update-plane-stable-protocol/SDD.md`
+- SDD 문서: 없음 (작성 전)
 - SDD 사유: 업데이트 프로토콜, manifest schema, 상태 전이, recovery 규칙이 proto/config/schema와 lifecycle 계약에 직접 닿는다.
 - 잠금 해제 조건:
   - [ ] SDD 잠금이 해제되어 있다
diff --git a/agent-roadmap/sdd/automation-runtime-bridge/cli-agent-group-grade-routing/SDD.md b/agent-roadmap/sdd/automation-runtime-bridge/cli-agent-group-grade-routing/SDD.md
index 546586e..bf87c48 100644
--- a/agent-roadmap/sdd/automation-runtime-bridge/cli-agent-group-grade-routing/SDD.md
+++ b/agent-roadmap/sdd/automation-runtime-bridge/cli-agent-group-grade-routing/SDD.md
@@ -2,8 +2,8 @@
 
 ## 위치
 
-- Milestone: `agent-roadmap/phase/automation-runtime-bridge/milestones/cli-agent-group-grade-routing.md`
-- Phase: `agent-roadmap/phase/automation-runtime-bridge/PHASE.md`
+- Milestone: [cli-agent-group-grade-routing](../../../phase/automation-runtime-bridge/milestones/cli-agent-group-grade-routing.md)
+- Phase: [PHASE.md](../../../phase/automation-runtime-bridge/PHASE.md)
 
 ## 상태
 
@@ -12,7 +12,7 @@
 ## SDD 잠금
 
 - 상태: 잠금
-- 사용자 리뷰: `USER_REVIEW.md`
+- 사용자 리뷰: [USER_REVIEW.md](USER_REVIEW.md)
 - 잠금 항목:
   - [ ] [D01] 선택된 agent 실행 실패, provider quota 소진, 실행 중단, 중복 실행 위험이 발생했을 때 자동 재라우팅/재시도/중단 중 어떤 후속 정책을 적용할지 결정한다.
 
@@ -29,8 +29,8 @@
 
 | 영역 | 기준 | 메모 |
 |------|------|------|
-| Roadmap | `agent-roadmap/phase/automation-runtime-bridge/milestones/cli-agent-group-grade-routing.md` | 목표, 기능 Task, 잠금 항목, 범위 제외 기준 |
-| Contract | `agent-contract/outer/openai-compatible-api.md` | OpenAI-compatible `metadata.agent_group.task_file`와 `metadata.agent_group.params` 계약을 추가할 원문 |
+| Roadmap | [cli-agent-group-grade-routing](../../../phase/automation-runtime-bridge/milestones/cli-agent-group-grade-routing.md) | 목표, 기능 Task, 잠금 항목, 범위 제외 기준 |
+| Contract | [openai-compatible-api.md](../../../../agent-contract/outer/openai-compatible-api.md) | OpenAI-compatible `metadata.agent_group.task_file`와 `metadata.agent_group.params` 계약을 추가할 원문 |
 | Code | `packages/go/config`, `apps/edge/internal/openai`, `apps/edge/internal/service`, `apps/node/internal/adapters/cli`, `configs` | config schema, OpenAI metadata parsing, routing decision, CLI adapter execution 연결 기준 |
 | External Provider | CLI provider agent catalog | opencode/codex/claude/gemini 등 provider-specific 실행 대상은 cli provider agent id로 참조한다 |
 | User Decision | D01 | 실행 실패/중단/quota 소진 시 자동 retry/fallback/중단 정책은 사용자 결정 전까지 잠금 |
@@ -55,7 +55,7 @@
 
 ## Interface Contract
 
-- 계약 원문: `agent-contract/outer/openai-compatible-api.md`
+- 계약 원문: [openai-compatible-api.md](../../../../agent-contract/outer/openai-compatible-api.md)
 - 입력:
   - `metadata.agent_group.task_file`: agent group routing에 사용할 task file 경로다. 절대 경로와 상대 경로를 모두 허용한다. OpenAI-compatible CLI route에서 상대 경로는 `metadata.workspace` 기준으로 해석하고, 상대 경로인데 `metadata.workspace`가 없으면 실패한다.
   - `metadata.agent_group.params`: 예약어 `user_params_schema`로 검증한 사용자 parameter 객체다. 예약어 prompt renderer가 CLI별 prompt 또는 argument로 변환할 수 있다.
@@ -143,7 +143,7 @@
 - [x] Milestone 기능 Task와 Acceptance Scenario가 일치한다.
 - [x] Evidence Map이 code-review/complete.log에서 검증 가능하다.
 - [x] agent-contract를 쓰는 경우 SDD에 계약 원문을 복제하지 않았다.
-- [x] 사용자 리뷰가 필요한 항목은 `USER_REVIEW.md`에만 남겼다.
+- [x] 사용자 리뷰가 필요한 항목은 [USER_REVIEW.md](USER_REVIEW.md)에만 남겼다.
 
 ## 사용자 리뷰 이력
 
diff --git a/agent-roadmap/sdd/automation-runtime-bridge/cli-agent-group-grade-routing/USER_REVIEW.md b/agent-roadmap/sdd/automation-runtime-bridge/cli-agent-group-grade-routing/USER_REVIEW.md
index 2b3d9c3..9f21d80 100644
--- a/agent-roadmap/sdd/automation-runtime-bridge/cli-agent-group-grade-routing/USER_REVIEW.md
+++ b/agent-roadmap/sdd/automation-runtime-bridge/cli-agent-group-grade-routing/USER_REVIEW.md
@@ -6,8 +6,8 @@
 
 ## 검토 대상
 
-- SDD: `agent-roadmap/sdd/automation-runtime-bridge/cli-agent-group-grade-routing/SDD.md`
-- Milestone: `agent-roadmap/phase/automation-runtime-bridge/milestones/cli-agent-group-grade-routing.md`
+- SDD: [SDD.md](SDD.md)
+- Milestone: [cli-agent-group-grade-routing](../../../phase/automation-runtime-bridge/milestones/cli-agent-group-grade-routing.md)
 
 ## 사용자 결정 항목
 
@@ -33,5 +33,5 @@
 ## 해결 조건
 
 - 모든 사용자 결정 항목의 답변이 SDD에 반영되어 있다.
-- `USER_REVIEW.md`가 `user_review_N.log`로 이동되어 있다.
+- [USER_REVIEW.md](USER_REVIEW.md)가 `user_review_N.log`로 이동되어 있다.
 - 남은 잠금 항목이 없으면 SDD 상태가 `[승인됨]`이고 `SDD 잠금` 상태가 `해제`다.
diff --git a/agent-roadmap/sdd/operational-observability-provider-management/request-execution-log-usage-ledger-foundation/SDD.md b/agent-roadmap/sdd/operational-observability-provider-management/request-execution-log-usage-ledger-foundation/SDD.md
index da7ecf7..30de8f5 100644
--- a/agent-roadmap/sdd/operational-observability-provider-management/request-execution-log-usage-ledger-foundation/SDD.md
+++ b/agent-roadmap/sdd/operational-observability-provider-management/request-execution-log-usage-ledger-foundation/SDD.md
@@ -2,8 +2,8 @@
 
 ## 위치
 
-- Milestone: `agent-roadmap/phase/operational-observability-provider-management/milestones/request-execution-log-usage-ledger-foundation.md`
-- Phase: `agent-roadmap/phase/operational-observability-provider-management/PHASE.md`
+- Milestone: [request-execution-log-usage-ledger-foundation](../../../phase/operational-observability-provider-management/milestones/request-execution-log-usage-ledger-foundation.md)
+- Phase: [PHASE.md](../../../phase/operational-observability-provider-management/PHASE.md)
 
 ## 상태
 
@@ -12,7 +12,7 @@
 ## SDD 잠금
 
 - 상태: 잠금
-- 사용자 리뷰: `USER_REVIEW.md`
+- 사용자 리뷰: [USER_REVIEW.md](USER_REVIEW.md)
 - 잠금 항목:
   - [ ] [D01] request ledger의 canonical 저장 책임을 Edge와 Control Plane 중 어디에 둘지 결정한다.
   - [ ] [D02] provider-reported, estimated, mixed, unavailable usage source를 운영 UI와 export에서 어떻게 표시할지 결정한다.
@@ -34,7 +34,7 @@
 
 | 영역 | 기준 | 메모 |
 |------|------|------|
-| Roadmap | `agent-roadmap/phase/operational-observability-provider-management/milestones/request-execution-log-usage-ledger-foundation.md` | Milestone 목표, 기능 Task, 잠금 항목 기준 |
+| Roadmap | [request-execution-log-usage-ledger-foundation](../../../phase/operational-observability-provider-management/milestones/request-execution-log-usage-ledger-foundation.md) | Milestone 목표, 기능 Task, 잠금 항목 기준 |
 | Code | `apps/edge/internal/openai`, `apps/edge/internal/service`, `apps/node/internal/node`, `apps/node/internal/adapters/openai_compat`, `apps/node/internal/adapters/vllm`, `apps/node/internal/adapters/ollama`, `proto/iop/runtime.proto` | OpenAI-compatible input, dispatch, runtime event, usage/tool-call propagation 구현 기준 |
 | External Provider | OpenAI-compatible provider usage chunk | provider-reported token usage가 있으면 우선 사용하고, 없으면 estimated/unavailable로 표시 |
 | User Decision | D01-D06 | 저장 책임, usage source 표시, reasoning token 추정, redaction/retention, schema 분리, tool-call raw capture/redaction 결정 필요 |
@@ -111,7 +111,7 @@
 - [ ] Milestone 기능 Task와 Acceptance Scenario가 일치한다.
 - [ ] Evidence Map이 code-review/complete.log에서 검증 가능하다.
 - [ ] agent-contract를 쓰는 경우 SDD에 계약 원문을 복제하지 않았다.
-- [ ] 사용자 리뷰가 필요한 항목은 `USER_REVIEW.md`에만 남겼다.
+- [ ] 사용자 리뷰가 필요한 항목은 [USER_REVIEW.md](USER_REVIEW.md)에만 남겼다.
 
 ## 사용자 리뷰 이력
 
diff --git a/agent-roadmap/sdd/operational-observability-provider-management/request-execution-log-usage-ledger-foundation/USER_REVIEW.md b/agent-roadmap/sdd/operational-observability-provider-management/request-execution-log-usage-ledger-foundation/USER_REVIEW.md
index d053fa1..c47fb50 100644
--- a/agent-roadmap/sdd/operational-observability-provider-management/request-execution-log-usage-ledger-foundation/USER_REVIEW.md
+++ b/agent-roadmap/sdd/operational-observability-provider-management/request-execution-log-usage-ledger-foundation/USER_REVIEW.md
@@ -6,8 +6,8 @@
 
 ## 검토 대상
 
-- SDD: `agent-roadmap/sdd/operational-observability-provider-management/request-execution-log-usage-ledger-foundation/SDD.md`
-- Milestone: `agent-roadmap/phase/operational-observability-provider-management/milestones/request-execution-log-usage-ledger-foundation.md`
+- SDD: [SDD.md](SDD.md)
+- Milestone: [request-execution-log-usage-ledger-foundation](../../../phase/operational-observability-provider-management/milestones/request-execution-log-usage-ledger-foundation.md)
 
 ## 사용자 결정 항목
 
@@ -83,5 +83,5 @@
 ## 해결 조건
 
 - 모든 사용자 결정 항목의 답변이 SDD에 반영되어 있다.
-- `USER_REVIEW.md`가 `user_review_N.log`로 이동되어 있다.
+- [USER_REVIEW.md](USER_REVIEW.md)가 `user_review_N.log`로 이동되어 있다.
 - 남은 잠금 항목이 없으면 SDD 상태가 `[승인됨]`이고 `SDD 잠금` 상태가 `해제`다.