[OPS-GAP] validator 강제력 부족(타임존/traceability/READ-ONLY/TASK-TEST) #372

Closed
opened 2026-03-02 01:02:23 +09:00 by agentson · 1 comment
Collaborator

Summary

현재 governance/docs validator는 문서 토큰/링크/ID 검증 위주이며,
요구사항(REQ-OPS) 강제 수준 대비 공백이 남아 있다.

Detected Gaps

  1. REQ-OPS-001 타임존(KST/UTC) 내용 검증 부재
  2. PR traceability(REQ/TASK/TEST 누락)가 warning-only
  3. READ-ONLY 변경 시 PR body 없으면 warning-only로 스킵
  4. TASK-TEST 동반 관계는 REQ 존재성 수준만 검사(개별 TASK 단위 강제 부족)

Evidence

  • warning-only traceability: scripts/validate_governance_assets.py:108-120
  • READ-ONLY body 없을 때 warning-only: scripts/validate_governance_assets.py:146-150
  • REQ->TASK/TEST 존재성 중심: scripts/validate_ouroboros_docs.py:153-159

Scope

  • scripts/validate_governance_assets.py
  • scripts/validate_ouroboros_docs.py
  • 필요 시 scripts/validate_docs_sync.py
  • 관련 테스트 파일 추가

Acceptance Criteria

  • REQ-OPS-001/002/003/004 각각에 대해 fail-fast 검증 규칙을 명시/구현한다.
  • warning-only 규칙 중 필수 항목은 error로 승격한다.
  • validator 테스트로 우회 케이스를 고정한다.
## Summary 현재 governance/docs validator는 문서 토큰/링크/ID 검증 위주이며, 요구사항(REQ-OPS) 강제 수준 대비 공백이 남아 있다. ## Detected Gaps 1. `REQ-OPS-001` 타임존(KST/UTC) 내용 검증 부재 2. PR traceability(REQ/TASK/TEST 누락)가 warning-only 3. READ-ONLY 변경 시 PR body 없으면 warning-only로 스킵 4. TASK-TEST 동반 관계는 REQ 존재성 수준만 검사(개별 TASK 단위 강제 부족) ## Evidence - warning-only traceability: `scripts/validate_governance_assets.py:108-120` - READ-ONLY body 없을 때 warning-only: `scripts/validate_governance_assets.py:146-150` - REQ->TASK/TEST 존재성 중심: `scripts/validate_ouroboros_docs.py:153-159` ## Scope - `scripts/validate_governance_assets.py` - `scripts/validate_ouroboros_docs.py` - 필요 시 `scripts/validate_docs_sync.py` - 관련 테스트 파일 추가 ## Acceptance Criteria - `REQ-OPS-001/002/003/004` 각각에 대해 fail-fast 검증 규칙을 명시/구현한다. - warning-only 규칙 중 필수 항목은 error로 승격한다. - validator 테스트로 우회 케이스를 고정한다.
Author
Collaborator

이슈 검토 결과 (Claude Code 자동 리뷰)

등록 적합성: 적합

Evidence 코드 검증 완료:

  • validate_governance_assets.py:108-120: PR traceability(REQ/TASK/TEST)가 errors가 아닌 warnings에 추가 확인
  • validate_governance_assets.py:146-150: PR body 없을 때 error 대신 warnings에 추가 후 return 확인

4가지 탐지된 갭(타임존 검증 부재, traceability warning-only, READ-ONLY warning-only, TASK-TEST 존재성만 검사)이 각각 명확하게 분리되어 있습니다. 단, 구현 시 어떤 규칙을 error로 승격할지 우선순위 결정이 필요합니다.

## 이슈 검토 결과 (Claude Code 자동 리뷰) ### 등록 적합성: ✅ 적합 **Evidence 코드 검증 완료:** - `validate_governance_assets.py:108-120`: PR traceability(REQ/TASK/TEST)가 `errors`가 아닌 `warnings`에 추가 확인 - `validate_governance_assets.py:146-150`: PR body 없을 때 error 대신 `warnings`에 추가 후 return 확인 4가지 탐지된 갭(타임존 검증 부재, traceability warning-only, READ-ONLY warning-only, TASK-TEST 존재성만 검사)이 각각 명확하게 분리되어 있습니다. 단, 구현 시 어떤 규칙을 error로 승격할지 우선순위 결정이 필요합니다.
jihoson reopened this issue 2026-03-02 01:37:56 +09:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: jihoson/The-Ouroboros#372