<!-- task=review_followup_alignment/02_docs_runtime_context_split plan=0 tag=REVIEW_DOCS -->
# PLAN-local-G02: 공개 문서와 로컬 검증 문맥 분리
date=2026-07-06

## 목적
tracked `docs/`에는 사람용 최신 공개 가이드만 남기고, 개인/로컬/검증 런북 성격의 runtime 세부사항은 local test 문맥으로 옮긴다.

## 분석 결과
- 읽은 파일: `agent-ops/rules/project/rules.md`, `agent-ops/rules/private/rules.md`, `agent-ops/rules/common/rules-roadmap.md`, `agent-ops/skills/common/router.md`, `agent-ops/skills/common/plan/SKILL.md`, `agent-test/local/rules.md`, `agent-test/local/edge-smoke.md`, `agent-ops/rules/project/domain/testing/rules.md`, `docs/edge-local-dev-guide.md`.
- SDD 기준: 문서 정리 follow-up이며 새 SDD가 필요한 기능 구현이 아니다. 현재 로드맵 active Milestone은 `[스케치]` 및 구현 잠금 상태이므로 로드맵 완료 항목을 선언하지 않는다.
- 테스트 환경 규칙: local 기준. Markdown 문서 변경과 deterministic `rg` 검증으로 충분하다.
- 테스트 커버리지 공백: 공개 문서에 private/local endpoint가 섞이는 것을 막는 자동 검증은 없다.
- 심볼 참조: 없음.
- 분할 판단: 이 plan은 문서 경계만 다룬다. 로그, Client/Nexo, mock 활성화 작업과 독립적이다.
- 범위 결정 근거: 사용자도 이 문제 정리에 동의했으며, 기존 `docs/` 정책과 `agent-test/local` 정책을 맞추는 문서 hygiene 작업이다.
- 빌드 등급: `local-G02`. 코드 실행 없이 문서와 검색 검증으로 닫는다.

## 이 파일을 읽는 구현 에이전트에게
구현 후 `CODE_REVIEW-local-G02.md`의 구현 에이전트 소유 섹션을 실제 변경 내용과 검증 출력으로 채운다. 구현 중 직접 사용자에게 질문하거나 선택지를 제시하지 않는다. 선택된 Milestone의 `구현 잠금 > 결정 필요` 항목이 실제 구현을 차단할 때만 review stub의 `사용자 리뷰 요청` 섹션에 근거를 기록하고 멈춘다.

## 작업 항목

### REVIEW_DOCS-1. Edge local guide 공개/로컬 문맥 분리
- 문제:
  - `docs/edge-local-dev-guide.md:39`부터의 예시 config가 특정 원격/host context를 공개 quickstart처럼 포함한다.
  - `docs/edge-local-dev-guide.md:124`부터의 dev-runtime provider pool, private host, Windows SSH, 내부 IP 검증 내용이 tracked `docs/`에 섞여 있다.
  - `docs/edge-local-dev-guide.md:250` 이후의 token 처리, curl evidence, 운영 검증 순서가 공개 문서와 로컬 검증 런북 성격을 동시에 가진다.
  - 결과적으로 `docs/`가 사람용 최신 공개 가이드와 개인/local verification 기록을 동시에 담는다.
- 해결 방법:
  - `docs/edge-local-dev-guide.md`는 공개적으로 재사용 가능한 Edge local quickstart, config shape, 일반 smoke 흐름만 남긴다.
  - 특정 domain, private IP, machine 이름, evidence 저장 위치, 개인 runtime 절차는 `agent-test/local/edge-local-dev-guide.md` 같은 local test 문서로 이동하거나 이미 있는 local test profile에 합친다.
  - 이동한 local 문서는 secret 원문을 포함하지 않고 placeholder와 환경변수 이름만 남긴다.
  - 변경 전 예:
    ```md
    # 공개 docs 안에 특정 private host와 검증 evidence 절차가 같이 존재
    ```
  - 변경 후 예:
    ```md
    # docs: 일반 절차
    # agent-test/local: 로컬 환경별 검증 런북
    ```
- 수정 파일 및 체크리스트:
  - [x] `docs/edge-local-dev-guide.md`: 공개 가이드로 축소하고 private/local runtime 세부사항 제거.
  - [x] `agent-test/local/edge-local-dev-guide.md` 신규 생성: 필요한 로컬 검증 런북을 이동.
- 테스트 작성:
  - [x] 별도 테스트 파일은 만들지 않는다.
  - [x] `rg` 검증으로 공개 docs에 private/local-only marker가 남지 않음을 확인한다.
- 중간 검증:
  - [x] `rg --sort path -n '192\\.168\\.|dev-runtime|edge-toki-labs|Windows SSH|toki-labs\\.com' docs/edge-local-dev-guide.md` 결과가 비어 있는지 확인한다.
  - [x] `rg --sort path -n 'mattermost_credentials|Bearer [A-Za-z0-9._-]+' docs/edge-local-dev-guide.md` 결과가 비어 있는지 확인한다.

## 구현 체크리스트
- [x] REVIEW_DOCS-1의 공개 문서 축소와 local test 문맥 이동을 수행한다.
- [x] 중간 검증 명령을 실행하고 결과를 `CODE_REVIEW-local-G02.md`에 기록한다.
- [x] CODE_REVIEW-*-G??.md의 구현 에이전트 소유 섹션을 실제 구현 내용과 검증 출력으로 채운다. 이 항목이 완료되기 전에는 구현이 완료된 것이 아니다.

## 최종 검증
```bash
rg --sort path -n '192\.168\.|dev-runtime|edge-toki-labs|Windows SSH|toki-labs\.com' docs/edge-local-dev-guide.md
rg --sort path -n 'mattermost_credentials|Bearer [A-Za-z0-9._-]+' docs/edge-local-dev-guide.md
```
예상 결과: 두 명령 모두 출력이 없다.

## 구현 완료
- `docs/edge-local-dev-guide.md` 공개 가이드로 재작성 완료 (334줄 → 173줄).
- `agent-test/local/edge-local-dev-guide.md` 신규 생성 완료 (287줄, 15KB).
- `CODE_REVIEW-local-G02.md` 구현 에이전트 소유 섹션 완료.
- PLAN 구현 체크리스트, CODE_REVIEW 구현 체크리스트 모두 완료 체크.
