<!-- task=stability_baseline/02_doc_consistency plan=0 tag=DOCS -->

# 안정화 문서 정합성 점검

## 이 파일을 읽는 구현 에이전트에게

구현 완료 전 `CODE_REVIEW-cloud-G05.md`의 구현 에이전트 소유 섹션을 반드시 채운다. 검증 명령을 실제 실행하고 출력은 요약하지 말고 붙여 넣는다. active 파일은 그대로 두고 리뷰 준비 상태만 보고한다. 최종 archive, `complete.log`, 코드리뷰 전용 체크리스트 처리는 code-review 스킬 전용이다.

## 배경

안정화 기준선은 README, PROTOCOL, VERSIONING, PORTING_GUIDE 설명이 현재 운영 방식과 맞는지 확인해야 한다. `stability-baseline.md:27`은 이 점검이 아직 미완료다. README는 안정화 방향을 이미 공개 snapshot으로 설명하지만, 공식 프로토콜/버전/포팅 문서와 충돌 여부를 증거로 남겨야 한다.

## 분석 결과

### 읽은 파일

- `README.md`
- `PROTOCOL.md`
- `VERSIONING.md`
- `PORTING_GUIDE.md`
- `agent-ops/roadmap/milestones/stability-baseline.md`
- `agent-ops/roadmap/milestones/continuous-verification.md`
- `agent-ops/rules/project/domain/protocol/rules.md`
- `agent-ops/rules/project/domain/tools/rules.md`

### 테스트 커버리지 공백

- 문서 정합성은 단위 테스트로 직접 커버되지 않는다.
- 결정적 검색(`rg --sort path`)과 `tools/check_proto_sync.sh`로 프로토콜/검증 문구와 proto sync 상태를 확인한다.

### 심볼 참조

- none. renamed/removed symbol 없음.

### 분할 판단

분할 정책을 먼저 평가했다. 공유 task group은 `stability_baseline`이다.

- `01_validation_evidence`: fresh matrix 실행 및 결과 기록. 선행 없음.
- `02_doc_consistency`: 문서 정합성 점검. 선행 없음.
- `03+01,02_protocol_freeze`: 이 점검 결과와 검증 근거에 의존.
- `04+03_maintenance_criteria`: protocol freeze 판단 후 재개 기준 문서화.

문서 정합성은 여러 문서를 읽지만 결과는 독립적으로 리뷰 가능하다. protocol freeze 판단에 입력으로 쓰이므로 별도 plan으로 둔다.

### 범위 결정 근거

이 작업은 문서 충돌을 고치는 범위까지 허용한다. proto schema, 언어 구현체, test runner 수정은 제외한다. C#/Swift 구현 시작, package registry 릴리즈 준비, 외부 CI 연결은 제외한다.

### 빌드 등급

build `local-G05`, review `cloud-G05`. 변경은 문서 중심이지만 공식 프로토콜/버전/포팅 문서 간 정합성 판단이 있어 review는 cloud로 둔다.

## 구현 체크리스트

- [ ] README, PROTOCOL, VERSIONING, PORTING_GUIDE의 지원 언어, 비목표, protocol 0.1, 검증 gate, 보류 정책 문구를 대조한다.
- [ ] 충돌이 있으면 해당 문서만 최소 수정하고, 충돌이 없으면 `stability-baseline.md`에 점검 결과를 기록한다.
- [ ] 문서 정합성 체크박스를 완료 처리한다.
- [ ] 중간/최종 검증 명령을 실행한다.
- [ ] CODE_REVIEW-*-G??.md의 구현 에이전트 소유 섹션을 실제 구현 내용과 검증 출력으로 채운다. 이 항목이 완료되기 전에는 구현이 완료된 것이 아니다.

### [DOCS-1] 문서 간 충돌 점검 및 결과 기록

#### 문제

`stability-baseline.md:27`은 README, PROTOCOL, VERSIONING, PORTING_GUIDE 간 설명 충돌 점검이 미완료다. 현재 README는 5개 언어 available, C#/Swift deferred, Git 기반 사용, validation matrix gate를 말한다(`README.md:11-21,54-64,220-230,315-320`). PROTOCOL과 VERSIONING은 protocol 0.1과 breaking 조건을 말한다(`PROTOCOL.md:6,100,123,136`, `VERSIONING.md:7,11,24,34-51`). PORTING_GUIDE는 새 언어 추가 조건을 말한다(`PORTING_GUIDE.md:27-34`).

#### 해결 방법

문서 간 정책 문구를 대조한다. 충돌이 없으면 `stability-baseline.md` 작업 컨텍스트에 점검 결과를 짧게 추가하고 체크박스를 완료한다. 충돌이 있으면 해당 문서의 최소 문장만 수정한 뒤 결과를 기록한다.

Before (`agent-ops/roadmap/milestones/stability-baseline.md:27,49-50`):

```markdown
- [ ] PROTOCOL, VERSIONING, README, PORTING_GUIDE 간 설명 충돌이 없는지 점검한다.
- 검증 근거: 가장 가까운 검증 근거는 지속 검증 Milestone의 2026-05-21 전체 매트릭스 통과 기록이다.
- 확인 필요: 현재 5개 언어 구현을 완성형으로 유지할지, 새 언어 포팅과 릴리즈 준비 보류를 언제 해제할지 판단한다.
```

After example:

```markdown
- [x] PROTOCOL, VERSIONING, README, PORTING_GUIDE 간 설명 충돌이 없는지 점검한다.
- 문서 정합성: 2026-05-22 기준 README, PROTOCOL, VERSIONING, PORTING_GUIDE의 protocol `0.1`, 지원 언어, 새 언어 보류, package registry 보류, validation gate 설명이 충돌하지 않는다.
```

#### 수정 파일 및 체크리스트

- [ ] `agent-ops/roadmap/milestones/stability-baseline.md`: 점검 결과와 체크박스 갱신.
- [ ] `README.md`: 충돌이 발견될 때만 최소 수정.
- [ ] `PROTOCOL.md`: 충돌이 발견될 때만 최소 수정.
- [ ] `VERSIONING.md`: 충돌이 발견될 때만 최소 수정.
- [ ] `PORTING_GUIDE.md`: 충돌이 발견될 때만 최소 수정.

#### 테스트 작성

테스트 추가 없음. 문서 정합성 점검이며, deterministic search와 proto sync로 검증한다.

#### 중간 검증

```bash
rg --sort path -n 'protocol `0\.1`|0\.1|Available|Planned|deferred|package registry|Git-based|validation matrix|check_proto_sync|C#|Swift|release|breaking|non-breaking' README.md PROTOCOL.md VERSIONING.md PORTING_GUIDE.md agent-ops/roadmap/milestones/stability-baseline.md
```

예상 결과: 각 정책 문구가 충돌 없이 같은 방향을 가리킨다.

## 수정 파일 요약

| 파일 | 항목 |
|------|------|
| `agent-ops/roadmap/milestones/stability-baseline.md` | DOCS-1 |
| `README.md` | DOCS-1, 충돌 발견 시만 |
| `PROTOCOL.md` | DOCS-1, 충돌 발견 시만 |
| `VERSIONING.md` | DOCS-1, 충돌 발견 시만 |
| `PORTING_GUIDE.md` | DOCS-1, 충돌 발견 시만 |

## 최종 검증

```bash
tools/check_proto_sync.sh
```

예상 결과: proto schema sync PASS. 문서만 바꿨더라도 protocol domain 경계 확인을 위해 실행한다.

```bash
git diff --check
```

예상 결과: whitespace error 없음.

모든 코드 변경 완료 후 반드시 `CODE_REVIEW-*-G??.md`의 구현 에이전트 소유 섹션을 채운다. 이 파일 작성이 구현의 마지막 단계다.
