Day 2 Task 01 불일치 검출

Task 01. 불일치 검출 (Consistency Check)

서로 다른 기획서 문서 간의 숨겨진 모순점들을 Codex Client를 활용해 자동 검출하고 조치 리포트를 구성하는 실무 방법을 학습합니다.

Task 01 명세 불일치 검출 실습 가이드

📥 실습 입력 (Input)

  • meeting-notes.md (회의록)
  • requirements.md (요구사항 정의서)
  • screen-specification.md (화면 정의서)

📤 실습 출력 (Output)

  • • 모순점 및 조치 사항 요약 리포트 표

🛠️ 실제 따라 하기 실습 가이드

  1. 실습용 파일 생성: 아래 다운로드 버튼들을 눌러 3개 파일을 automation/ 폴더 내에 저장합니다.
  2. Codex 검토 위임: Codex Client 프롬프트 입력창에 아래 Codex 요청 프롬프트를 전송하여 빌드합니다.
  3. 리포트 점검: 출력된 리포트에서 회원 탈퇴 예약 자동취소 충돌, 평가 주체 주객전도 오류 등 의도된 모순이 정확하게 도출되었는지 확인합니다.

실습 자료 다운로드

Codex 요청 프롬프트

Task 01 Prompt프로젝트 폴더 내에 있는 'meeting-notes.md', 'requirements.md', 'screen-specification.md' 세 문서를 비교 분석해줘.

각 문서 간에 서로 모순되거나 불일치하는 항목, 혹은 한쪽 문서에만 존재하고 다른 문서에서는 누락된 항목을 찾아서 정리해줘.
결과는 아래 요구사항에 맞춰 출력해줘.

1. 결과는 '구분(기능/화면/정책/용어 등)', '발견 내용 및 모순점', '영향도(높음/중간/낮음)', '권한이 가장 높은 기준 문서', '권장 조치' 칼럼을 가진 Markdown 표 형태로 정리해줘.
2. 개발 및 테스트 진입 시 치명적인 리워크(재작업)를 유발할 수 있는 사항은 영향도를 '높음'으로 표기해줘.
3. 임의의 해답을 창조하지 말고 문서 텍스트에 기반해서 팩트 위주로만 비교 분석 결과를 도출해줘.

예상 결과 리포트

구분 발견 내용 및 모순점 영향도 기준 문서 권장 조치
정책/기능 회의록에는 예약 취소 시 10% 수수료 환불 정책이 확정되었으나, 요구사항 정의서(`requirements.md`)에는 관련 내용이 완전히 누락됨. 높음 회의록 요구사항 정의서에 예약 취소 및 10% 위약금 환불 기능 요구사항 추가 반영 필요
정책/화면 회원 탈퇴 시 기존 예약에 대해 회의록은 '자동 취소 및 전액 환불'이라 정의했으나, 요구사항서에는 '보관 유지', 화면정의서에는 '안내 팝업 없이 숨김 처리'로 세 문서가 모두 상이함. 높음 회의록 기획팀 조율을 거쳐 회의록 기준으로 요구사항과 화면 정의서의 탈퇴 로직 일체화 수정 필요
기능/화면 회의록 및 화면정의서에서는 '사용자(Customer)가 전문가(Expert)를 평가'하도록 설계되었으나, 요구사항서(FR-004)에는 '전문가(Expert)가 사용자(Customer)를 평가'하도록 주체가 반대로 작성됨. 높음 회의록 요구사항 정의서의 FR-004 평가 주체를 Customer로 수정 반영
화면 회의록에는 비회원의 경우 '예약 신청 버튼 비활성화'를 명시했으나, 화면정의서(SCR-001)에는 '비회원 예약하기 버튼 활성화' 및 가입 유도 없는 일정 진입으로 모순됨. 중간 회의록 화면 정의서의 비회원 홈화면 예약 흐름을 '비활성화 또는 가입 팝업 유도'로 수정

💡 AI 활용 및 학습 포인트

AI를 '정답 작성자'가 아닌 '정밀 검토자(Reviewer)'로 훈련할 때 검증 생산성이 극대화됩니다. 3대 문서 간의 불일치를 사전에 검증하여 설계 누락으로 인한 리워크(재작업) 비용을 100배 가량 아끼는 실무 방법론입니다.