docs validator: validate_docs_sync.py 재도입(테스트 포함) #363

New Issue

agentson · 2026-03-01T23:01:22+09:00

agentson commented

2026-03-01 23:01:22 +09:00

Summary

#350/#352 원안의 미완료 항목인 scripts/validate_docs_sync.py를 현행 validator 패턴(scripts/validate_*.py + tests/test_validate_*.py)으로 재작성한다.

핵심은 문서 요약본(README/CLAUDE)과 기준 문서(commands/testing/workflow) 간 드리프트를 자동 감지하는 규칙 정의다.

Scope

신규: scripts/validate_docs_sync.py
- 가변 수치 하드코딩/중복 명령/누락 링크 규칙 정의
신규: tests/test_validate_docs_sync.py
- 정상/실패 케이스 단위 테스트

Acceptance Criteria

validator 스크립트 + 테스트 파일 모두 추가
pytest -q tests/test_validate_docs_sync.py 통과
ruff check scripts/validate_docs_sync.py tests/test_validate_docs_sync.py 통과
기존 문서 검증 스크립트와 충돌 없음

Scope Mapping

REQ: REQ-OPS-002, REQ-OPS-003
TASK: TASK-OPS-002, TASK-OPS-003
TEST: TEST-ACC-008, TEST-ACC-009

## Summary `#350/#352` 원안의 미완료 항목인 `scripts/validate_docs_sync.py`를 현행 validator 패턴(`scripts/validate_*.py` + `tests/test_validate_*.py`)으로 재작성한다. 핵심은 문서 요약본(README/CLAUDE)과 기준 문서(commands/testing/workflow) 간 드리프트를 자동 감지하는 규칙 정의다. ## Scope - 신규: `scripts/validate_docs_sync.py` - 가변 수치 하드코딩/중복 명령/누락 링크 규칙 정의 - 신규: `tests/test_validate_docs_sync.py` - 정상/실패 케이스 단위 테스트 ## Acceptance Criteria - [ ] validator 스크립트 + 테스트 파일 모두 추가 - [ ] `pytest -q tests/test_validate_docs_sync.py` 통과 - [ ] `ruff check scripts/validate_docs_sync.py tests/test_validate_docs_sync.py` 통과 - [ ] 기존 문서 검증 스크립트와 충돌 없음 ## Scope Mapping - REQ: `REQ-OPS-002`, `REQ-OPS-003` - TASK: `TASK-OPS-002`, `TASK-OPS-003` - TEST: `TEST-ACC-008`, `TEST-ACC-009`

agentson referenced this issue

2026-03-01 23:01:37 +09:00

docs: SSOT 문서 허브 도입 및 동기화 자동 검증 게이트 (#350) #352

agentson referenced this issue from a commit

2026-03-01 23:03:52 +09:00

docs validator: add validate_docs_sync with unit tests (#363)

agentson referenced a pull request that will close this issue

2026-03-01 23:04:01 +09:00

docs validator: add docs sync invariants with tests (#363) #365

jihoson closed this issue

2026-03-01 23:12:17 +09:00

jihoson referenced this issue from a commit