Day 2 Summary Codex AI Auditor PM Automation

Day 2. Codex Client 기반 오디팅 실무 요약서

기획서 불일치 정합성 검출, 요구사항 변경에 따른 영향도 분석, 메신저 비정형 대화록 의사결정 로그 추출 등 실무에서 병목을 초래하는 핵심 설계 통제 업무를 Codex Workspace의 추론 능력과 접목하는 요령을 마스터합니다.

Part 1. 도입 배경
Part 2. 실습 목표
Part 3. 따라하기
Part 4. 작동 원리
Part 5. 교육 가이드

왜 이 세 가지 업무에 Codex Client인가?

전형적인 IT 서비스 구축 과정에서 가장 많은 시간과 재작업 비용을 초래하는 지점은 **"커뮤니케이션 오차로 인한 기획/설계 불일치"**입니다. ChatGPT와 같은 범용 대화 모델과 프로젝트 단위 파일 전체를 통째로 쥐고 컨텍스트를 유지하는 Codex Client의 차이점을 파악해 봅니다.

ChatGPT와 Codex Client의 결정적 차이

비교 항목 일반 ChatGPT (단일 대화) Codex Client (Workspace 기반)
분석 범위 단일 또는 파편화된 복사-붙여넣기 텍스트 비교 프로젝트 디렉터리 내 다중 문서 전체 정합성 파악
이력 추적 대화가 이어지면서 이전 파일의 컨텍스트 손실 위험 변경 전/후 요구사항과 하위 명세서(API, UI)의 불일치 실시간 동기화
대화록 정제 단순 회의 결과만 기록하거나 가상의 주체 창조 위험 비정형 대화의 의미적 근거(Why) 및 미결 사항(Action Items) 정밀 분리

AI를 검토자(Reviewer)로 활용할 때의 생산성

소프트웨어 공학적 예방

설계 단계의 오류 수정 비용은 개발 및 테스트가 완료된 상태에서 수정하는 것에 비해 **최대 100배** 저렴합니다. AI는 설계 모순을 즉각 잡아내 리워크를 방지합니다.

Reviewer로서의 꼼꼼함

AI는 사람이 전수검사하기 번거로운 미활성화 규칙 누락, 엇갈린 변수 매핑(예: 평가 주체 뒤바뀜) 등을 몇 초 만에 정확하게 팩트 위주로 짚어냅니다.

오늘 만들 최종 결과물

Task 01. 설계 불일치 검출

회의록, 요구사항, 화면설계서 간 모순 및 누락 항목을 분류한 불일치 요약 리포트 표 (출력: consistency-report.md)

Task 02. 변경 영향도 관리

새로운 요구사항 변경에 따라 화면 UI 기획 및 백엔드 API 명세에 반영되어야 할 구체적 액션 아이템 매핑 변경 영향도 분석 표 (출력: impact-analysis.md)

Task 03. 의사결정 추적

비정형 구두/채팅 기록에서 최종 합의된 사항(Why) 및 향후 검토가 필요한 보류 사안을 분리한 Decision Log 및 Pending Items 표 (출력: decision-log.md)

Mission 1 (Task 06). 영향도 분석

회원가입 휴대폰 인증 추가에 따라 영향을 받는 화면, API, DB, 문서를 분석한 영향도 분석 보고서 (출력: impact-analysis-report.md)

Mission 2 (Task 07). 이슈 리포트 작성

프로젝트 자료를 종합 분석하여 현재 진행 상황과 주요 이슈를 요약한 프로젝트 이슈 리포트 (출력: project-issue-report.md)

Input / Output 데이터 파이프라인

실습 과정에서 입력 파일들이 Codex Client를 거치며 결과 표로 정제되는 전체 워크플로우 맵입니다.

01
불일치 검출
02
변경 영향도
03
의사결정 이력
M1
영향도 분석
M2
이슈 리포트
Task 01. 불일치 검출 데이터 흐름
📥 Input (기획/설계 문서)
• meeting-notes.md (회의록) • requirements.md (요구사항 정의서) • screen-specification.md (화면 정의서)
Codex Client
💾 Output (요약 보고서)
| 구분 | 발견 모순점 | 영향도 | 기준 | 권장 조치 | | 정책 | 탈퇴 시 환불 수수료 상이 | 높음 | 회의록 | 로직 일체화 | | 기능 | 평가 주체 오류 | 높음 | 회의록 | FR-004 수정 |

STEP 1. Task 01 - 불일치 검출

프로젝트 폴더에 실습 파일을 생성한 뒤, 아래 지시문을 Codex Client 프롬프트 창에 전송하여 모순 오디팅을 진행합니다.

🔍 Codex 요청 프롬프트 (검토 지시)

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

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

1. 결과는 '구분', '발견 내용 및 모순점', '영향도', '권한이 가장 높은 기준 문서', '권장 조치' 칼럼을 가진 Markdown 표 형태로 정리해줘.
2. 개발 및 테스트 진입 시 치명적인 재작업을 유발할 수 있는 사항은 영향도를 '높음'으로 표기해줘.
3. 임의의 해답을 창조하지 말고 문서 텍스트에 기반해서 팩트 위주로만 비교 분석 결과를 도출해줘.
  • 회의록의 위약금 10% 수수료 정책이 요구사항 정의서에 누락된 부분이 잡혔는지 점검합니다.
  • 회원 탈퇴 처리 시 3개 문서의 정책 불일치(자동취소 vs 보관유지 vs 팝업 없이 숨김)가 잡혔는지 점검합니다.
  • FR-004 요구사항에서 평가 주체가 Customer가 아닌 Expert로 반대로 적힌 논리 오류가 잡혔는지 점검합니다.

STEP 2. Task 02 - 변경사항 관리

요구사항 변경 파일 2종(v1.0 vs v2.0) 및 기존 설계서/API 규격서를 준비한 뒤 변경 영향도 매핑 지시문을 전송합니다.

🔄 Codex 요청 프롬프트 (변경 및 영향 분석 지시)

프로젝트 폴더 내에 있는 'requirements-before.md'와 'requirements-after.md' 파일을 대조하여 어떤 정책이 변경되었는지 먼저 분석해줘.

그 후, 변경된 정책 내용이 v1.0 수준에 머물러 있는 'screen-specification-v2.md' 및 'api-specification.md' 문서의 어느 부분에 반영되어야 하는지 분석해줘.

결과는 아래 형식에 맞춰 Markdown 표 형태로 출력해줘:
1. '변경 항목', '변경 전', '변경 후', '영향 범위 (화면/API)', '중요도', '조치 사항 (필요한 구체적인 수정 가이드)'
2. 추가로, v2.0 요구사항을 기준으로 수정이 필요한 부분의 중요도를 '높음/중간/낮음' 순으로 구분하여 칼럼에 표시해줘.
  • Google 소셜 로그인 반영에 따른 로그인 화면 UI 및 API 파라미터(oauth_token) 변경 가이드 수립 여부를 점검합니다.
  • SMS 인증 도입에 따른 가입 UI 교체 및 API Payload 필수 파라미터(phone, verification_code) 반영 여부를 확인합니다.
  • Admin 권한 구분에 따른 신규 대시보드 화면 설계 및 API role 필드 매핑 체크 여부를 확인합니다.

STEP 3. Task 03 - 의사결정 추적

비정형 개발 대화록(messenger-chat.md)을 준비한 뒤 의사결정 로그와 후속 과제를 자동 분리 추출합니다.

📋 Codex 요청 프롬프트 (의사결정 추출 지시)

프로젝트 폴더 내에 있는 'messenger-chat.md' 대화록을 읽고, 프로젝트 관리 및 추적을 위한 Decision Log와 Pending Items를 작성해줘.

아래 조건에 따라 분석을 수행해줘.
1. 결정 완료된 사안에 대해서는 '의사결정 로그(Decision Log)' 표를 작성해줘. 칼럼은 '결정 항목', '결정 내용', '의사결정 배경/근거', '결정일', '담당자/주체', '상태'를 포함해야 해.
2. 아직 결정되지 않고 후속 검토가 필요하거나 보류된 사안은 '미결 사항 (Pending Items)' 표로 정리해줘. 칼럼은 '미결 항목', '후속 조치 내용', '담당자', '예정 기한'을 포함해줘.
3. 대화록 텍스트에 근거하지 않은 가상의 날짜나 의사결정 주체를 마음대로 작성하지 말아줘.
  • 1차 론칭에서 Apple 로그인을 제외하고 Google 로그인만 가져가기로 한 근거(심사 지연 등) 및 주체가 추출되었는지 확인합니다.
  • 실시간 계좌이체 보류 사유와 해외 Paypal 연동 검토의 담당자(개발팀) 및 후속 조치가 도출되었는지 확인합니다.
  • 보안실 감사 요건 충족을 위한 Super/Sub Admin 2단계 계층 권한 컴포넌트 의결 근거가 포함되었는지 확인합니다.

Mission 1. 회원가입 변경 영향도 분석 (Task 06)

고객의 "회원가입 시 휴대폰 인증 추가" 변경 요청에 대해 Codex를 활용하여 시스템 전체(화면, API, DB, 문서) 영향도를 분석하고 보고서를 작성합니다.

🔍 Codex 요청 프롬프트 (영향도 분석 지시)

회원가입에 휴대폰 인증 기능이 추가될 경우 영향을 받는 화면, API, DB, 문서를 모두 찾아 영향도 분석 보고서를 작성해 주세요.
  • 휴대폰 인증 추가에 따라 회원가입 화면(UI)의 영향도를 '높음' 및 '화면 수정' 조치로 감지했는지 확인합니다.
  • 로그인/가입 API의 영향도를 '중간' 및 'API 수정'으로 감지했는지 확인합니다.
  • User DB의 영향도를 '높음' 및 '컬럼 추가' 조치로 매핑했는지 점검합니다.
  • 관리자 화면의 영향도를 '낮음' 및 '조회 항목 추가' 조치로 매핑했는지 확인합니다.

Mission 2. 프로젝트 이슈 리포트 작성 (Task 07)

회의록, 변경 이력, Action Item, 이슈 목록 등 프로젝트 원본 자료를 분석하여 현재 진행 상황과 주요 이슈 리포트를 자동 작성합니다.

📋 Codex 요청 프롬프트 (이슈 리포트 작성 지시)

현재 프로젝트의 주요 이슈를 요약하고, 긴급도와 우선순위를 포함한 프로젝트 이슈 리포트를 작성해 주세요.
  • 완료(로그인 기능) 및 진행(회원가입 기능) 현황이 올바르게 분류되었는지 확인합니다.
  • 결제 API 일정 지연 이슈의 우선순위가 '높음' 및 PM 담당으로 분석되었는지 확인합니다.
  • 요구사항 변경 예정 위험의 우선순위가 '높음' 및 기획팀 담당으로 매핑되었는지 확인합니다.
  • 관리자 권한 정책 확정 미결 사항의 우선순위가 '중' 및 기획팀 담당으로 정확하게 도출되었는지 확인합니다.

의미론적 디프 (Semantic Diff)

단순한 텍스트 줄(Line) 간의 비교나 변경 사항 감지가 아닙니다. 비즈니스 요구조건의 핵심 논리(예: 이메일 인증 ➔ SMS 휴대폰 번호 인증)가 어떻게 개정되었는지 인지하고, 이와 종속 관계를 갖는 물리 파일(프론트엔드 UI 와이어프레임 설계서 및 백엔드 API REST 규격서)의 변수 매핑 테이블까지 종속적으로 해석하여 수정 가이드를 매핑해주는 원리입니다.

비정형 대화 내 컨텍스트 캡슐화

"애플은 다음 회의 때 다시 이야기해요", "PG 심사 때문에 계좌이체는 일단 보류" 등의 정형화되지 않은 단톡방 구어체 흐름 속에서 최종 합의에 도달하게 된 배경 요인(애플 개발자 연간 계정 심사 일정, PG사 계약 승인 지연 등)을 AI가 의미론적으로 정제해 냅니다. 이로써 프로젝트 멤버가 변경되어도 회의실 의사결정 배경(Why)을 온전히 기억할 수 있습니다.

세 가지 Task의 연결 흐름 시너지

기획/설계 검토 프로세스는 단발적인 태스크가 아닙니다. IT 프로젝트 생애주기에서 기획과 개발 격차를 메꾸는 유기적인 설계 통제 장치 역할을 수행합니다.

1. 모순 발견 (Task 01)

기존 기획, 화면설계, 회의록 간 엇갈린 충돌이나 구멍을 단 몇 초 만에 식별.

2. 결정 추적 (Task 03)

요구사항 변경을 의결하게 된 회의 대화 속 근거와 미결 업무 리포팅.

3. 통제 적용 (Task 02)

의사결정 결과가 하위 UI 화면과 API 명세서에 빠짐 없이 매핑되도록 최종 통제.

교육 설계 스펙

평가 항목 상세 교육 기준 스펙
교육 난이도 ★★★☆☆ (중급 과정)
예상 실습 시간 1시간 30분 ~ 2시간 (종합 실습 및 피드백 포함)
실무 활용도 ★★★★★ (IT 프로젝트 정합성 검증 및 재작업 방지)

기획설계 단계 최종 교육 Task

Task 주제 AI 활용
Task 01 불일치 검출 문서 간 차이 비교 및 검증
Task 02 누락 검출 기능·정책·예외사항 누락 확인
Task 03 변경사항 관리 변경 이력 관리 및 영향 분석
Task 04 문서 버전 관리 버전 비교 및 최신 문서 관리
Task 05 의사결정 추적 회의 결정사항 및 Action Item 관리
Task 06 영향도 분석 변경 요청에 따른 영향 범위 분석
Task 07 프로젝트 이슈 리포트 프로젝트 현황 및 이슈 자동 보고

학습자 질문 및 토의 주제

"회의를 마친 직후에 이 세 가지 Task를 수행하는 것과, 개발 도중 또는 개발 끝난 후에 사람이 직접 대조하는 것의 비용 차이는 어떨까요?"

→ 초기 기획 명세 검증은 개발이 모두 완료된 뒤 코드를 뜯어고쳐야 하는 리워크 장애 대응에 비해 비용과 공수를 최대 100배 가까이 아낄 수 있어 비즈니스 출시 일정을 대폭 방어합니다.

"AI가 도출한 영향 범위 분석 결과 중 실제 개발자가 누락할 수 있는 마이너 필드(예: API Request Payload) 검출 성능은 어떠한가요?"

→ 소셜 로그인 토큰, SMS 인증용 전화번호 수신 규격 등 사람이 바쁜 일정 중에 API 명세서에서 무심코 누락하기 쉬운 입력 파라미터를 정확하게 식별하는 성능을 체감할 수 있습니다.

← Day 2 강의실 입장 전체 로드맵 보기