오늘 실행해 볼 OpenAI Codex 고급 워크플로우

트위터보다가 좋아 보여서 GPT 돌려서 퍼왔어요. 오늘 시도해볼 계획입니다.

일단 해보기 전이지만
흐름은 일단 좋아보이는 것 같아요. 일반적인 사람이 하는 과정과 똑같구요.

지금까지는 저번에 소개한데로 Codex 는 기본적으로 플랜 모드가 내부적으로 동작하기 때문에
1,2 단계가 의미 없을 수 있어, 그동안 1단계 프롬프트와 함께 바로 구현에 들어갔거든요.

여튼 여러 방식을 실험해보면서 좋은 방법을 찾아볼려고요.

🧠 OpenAI Codex 고급 워크플로우 요약

이 워크플로우는 복잡한 기능을 안정적으로 구현하기 위한 3단계 구조로, 기본 세팅보다 훨씬 강력하고 신뢰성이 높음.
**GPT-5(high)**와 GPT-5-codex(high) 모델을 단계별로 사용함.

① 초기 이해 단계 (Initial Explanation Stage)

목적: 아직 구현하지 말고, 기능을 완전히 이해하고 준비하는 단계.

입력:

기능에 대한 상세한 설명

해야 할 일:

• 기존 코드베이스 구조를 분석하고 의존성, 제약, 통합 지점을 파악.

• 기능이 시스템에 어떻게 통합될지 정리.

• 불명확하거나 모호한 부분을 명확히 질문.

• 아직 구현하지 않음.

출력:
명확히 해야 할 질문 목록, 파악한 구조와 제약사항 정리.
→ 모든 모호점이 해결될 때까지 질의응답 반복.

② 계획 작성 단계 (Plan Creation Stage)

모델: gpt-5 high 유지
명령:
이전 단계의 대화를 기반으로 plan.md 작성.

요구사항:

• 불필요한 범위 확장 없이 최소하고 명확한 단계별 계획 작성.

• 각 단계의 진행 상태를 이모지로 표시:

  • 🟩 완료 (Done)

  • 🟨 진행 중 (In Progress)

  • 🟥 할 일 (To Do)

• 전체 진행률을 상단에 %로 표시.

• 단계는 모듈형, 간결, 기존 코드와 자연스럽게 통합되어야 함.

예시 구조:

# 기능 구현 플랜
**전체 진행률:** `0%`

## 타스크:
- [ ] 🟥 단계 1: 인증 모듈 구현
  - [ ] 🟥 Service Class 생성
  - [ ] 🟥 JWT 구현
  - [ ] 🟥 DB 연동
...

⚠️ 이 단계에서도 실제 구현은 하지 않음.
목표는 단순하고 우아한 설계 문서 작성.

③ 구현 단계 (Implementation Stage)

모델 전환: gpt-5-codex high

명령:
“계획한데로 모두 완전하게 수행해주세요.”

구현 원칙:

• 코드 스타일과 패턴은 기존 프로젝트 규칙에 정확히 맞춰야 함.

• 모듈형, 간결, 주석 충분히 포함.

• 각 단계 구현 시:

  • plan.md의 상태 이모지와 진행률을 실시간 업데이트.

✅ 요약

결과적으로 이 워크플로우는

• 스코프 크립 최소화,

  • 스코프 크리프(Scope creep)는 프로젝트 범위가 통제되지 않은 채 원래 목표를 벗어나 무분별하게 확장되는 것을 의미합니다.

• 코드 품질 향상,

• 복잡한 기능도 일관된 패턴으로 구현 가능
  이라는 장점을 가짐.

원문: https://x.com/mattshumer_/status/1981027089810637023?s=12&t=Z3gGYreM_J0AHUdOgrc_Jw