"commit은 끝이 아니라, 다음 세션이 이어받는 기록의 시작이다"
모든 코드 리뷰와 브라우저 검증이 끝났지만, 아직 아무것도 commit되지 않은 상태였습니다. working tree에는 diff만 쌓여 있었고, 이번 작업에서 있었던 스코프 결정이나 RLS 허점 발견 같은 과정도 아직 메모리에는 반영되지 않은 상태였습니다.
commit 구성을 어떻게 할지(본 구현과 보완을 나눌지 하나로 할지), 메시지 규칙, push, 최종 보고 항목까지 명시한 지시 프롬프트를 작성해 전달했습니다. Codex가 커밋 하나(d28839b)로 나누지 않고 commit·push까지 완료했다고 보고했고, git log와 status로 원격에 실제로 반영됐는지 최종 확인했습니다.
여기서 끝내지 않고, 이번 작업 전체 과정 — 스코프를 왜 그렇게 확정했는지, RLS 허점이 어떻게 발견되고 보완됐는지, 브라우저 검증에서 무엇을 확인했는지, slug 오기가 어떻게 정정됐는지, 잔재 데이터가 존재한다는 사실까지 — 하나의 메모리 항목으로 기록했습니다.
단순히 "완료했다"고만 적었다면 다음 세션에서 왜 Owner를 읽기전용으로 뒀는지, 왜 트리거를 추가했는지를 다시 설명해야 했을 것입니다. commit은 작업의 끝이 아니라, 다음 세션이 이어받을 수 있는 기록의 시작점이라는 걸 이번에 다시 확인했습니다.
구현 상세뿐 아니라 판단 근거와 발견된 이슈까지 기록해야 다음 세션이 이어진다는 이 프로젝트의 메모리 운영 방식에 따라, 단순히 "완료했다"만 적지 않고 왜 그렇게 결정했는지, 무엇이 발견됐는지까지 포함해 기록했습니다. 이렇게 해야 다음 세션에서 같은 맥락을 처음부터 다시 설명받지 않아도 된다고 판단했습니다.
관련 프로젝트
프로젝트 개요 비즈니스 프로세스 트랜스포메이션(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 스키마 구현 완료