커밋 전 보고는 코드 검토가 아니라 보고서 승인이다"
이번 작업은 Core Enum 11종의 구현 완료 보고를 검토하는 것으로 시작했습니다. Codex가 작업을 마쳤다고 알려왔지만, git status를 확인해보니 관련 파일 10개가 전부 untracked 상태였습니다. 커밋되지 않은 파일은 아직 누구도 실제로 들여다보지 않은 코드라는 뜻이라, 이 상태에서 "완료했다"는 보고만 믿고 승인하면 그건 코드 검토가 아니라 보고서를 승인하는 것에 불과하다고 판단했습니다.
그래서 access.ts, progress.ts, index.ts, enums.test.ts 4개 핵심 파일의 실제 내용을 요청했습니다. 값 배열이 기획 문서와 문자 단위로 일치하는지, union type이 하드코딩이 아니라 배열에서 파생되는 구조인지, 테스트가 실제 리터럴 기대값과 대조하는 방식인지 하나씩 확인했습니다.
확인 결과 11개 Enum 전부 문서와 값이 일치했고, 테스트 23개가 모두 실제 기대값을 기준으로 통과하는 것을 확인했습니다. 문제가 없다고 판단한 뒤에야 승인했고, 커밋(dcc1a58)과 푸시까지 마쳤습니다.
이 과정에서 다시 확인한 건, "완료했다"는 AI의 보고 자체는 검증이 아니라는 점입니다. untracked 상태에서의 승인 요청은 이후에도 반복될 수 있는 패턴이라, 이번 케이스를 계기로 승인 전 체크리스트에 이 절차를 명시적으로 남겨두었습니다.
CLAUDE.md에 명시한 Reviewer 역할 원칙상, AI의 자체 완료 보고는 검토의 시작점일 뿐 근거가 될 수 없다고 판단했습니다. 특히 untracked 상태는 "아직 아무도 보지 않은 코드"와 같은 의미라, 이 상태에서 승인이 나가면 이후 모든 검토 절차의 신뢰성이 흔들린다고 봤습니다. 그래서 승인 전에 반드시 실제 파일 내용을 요구하는 절차를 이번 케이스에서 다시 한번 명문화했습니다.
관련 프로젝트
프로젝트 개요 비즈니스 프로세스 트랜스포메이션(BPR)을 지원하는 한국어 기반 웹 애플리케이션. 컨설팅 프로젝트의 AS-IS 프로세스 분석부터 TO-BE 설계, Blueprint 승인까지의 전체 워크플로우를 디지털화하는 플랫폼으로, EPIC 단위로 구조화된 백로그를 기반으로 개발 중. 역할 및 워크플로우 PM / Architect / Reviewer 역할 수행 Codex(구현 담당)에게 Task 단위 구현 프롬프트 설계 Codex 구현 결과를 git log, git grep, git status로 직접 검증 후 승인 승인 전에는 Codex가 commit하지 않는 엄격한 게이팅 프로세스 운영 한 번에 하나의 Backlog Task만 진행, Task 완료 전 다음 Task 착수 금지 기술적 의사결정 및 성과 워크스페이스/프로젝트 접근 권한을 DB 레벨(복합 FK, SECURITY DEFINER 트리거)과 애플리케이션 레벨(Server Action 권한 검증)의 이중 방어 구조로 설계 Hard Delete 미구현 원칙 하에 배열 필드 전체교체(replace)를 단일 트랜잭션 RPC로 처리하는 패턴 확립 및 재사용 AS-IS 프로세스 그래프의 순환 참조 탐지에 Tarjan SCC 알고리즘 적용, 차단 오류(Error)와 경고(Warning)를 분리한 이중 Validator 아키텍처 설계 도메인 규칙 위반을 커스텀 Postgres 에러 코드 체계(SIA0104)로 문서화하여 거버넌스 문서와 코드베이스 간 정합성 유지 AI 생성 데이터와 사람이 검증한 데이터를 구분하는 generatedbyai / verified 메타데이터 패턴을 여러 도메인 테이블에 일관되게 적용 진행 상태 ✅ EPIC-01 (인증 / 워크스페이스 / 프로젝트 접근) ✅ EPIC-02 (조직 / 산업 / 프로젝트) 🚧 EPIC-03 (AS-IS 프로세스 그래프) — 그래프 검증, Input/Output 스키마, Business Rule 스키마 구현 완료