Codex 플레이북 허브

Codex로 일하는 표준

읽기 전에 작은 작업 하나를 맡겨보세요. 그 결과를 보며 요청, 검증, handoff (인수인계)를 익히는 플레이북입니다.

  • 입문첫 요청을 안전하게 맡기는 기준
  • 실무작은 diff (변경점)와 검증으로 작업을 닫는 루프
  • 승인선, 리뷰 증거, handoff (인수인계)를 남기는 운영 체계

처음 10분 실습

읽기 전에 첫 요청을 하나 맡겨보세요

파일 하나만 고르고 아래 요청서를 복사해 Codex에게 맡깁니다. 결과가 완벽하지 않아도 괜찮습니다. diff (변경점), 검증, 남은 위험을 받아보는 순간 나머지 문서가 훨씬 구체적으로 읽힙니다.

  1. 0-1분

    작업 하나 고르기

    새 기능보다 파일 하나에서 끝나는 문서 수정, 테스트 보강, 작은 버그를 고릅니다.

  2. 2분

    요청서 복사하기

    목표, 허용 범위, 금지, 증거를 채워 Codex에게 바로 넘깁니다.

  3. 3-6분

    먼저 읽게 하기

    바로 고치기 전에 바꿀 위치와 위험을 짧게 확인하게 합니다.

  4. 7-8분

    diff와 검증 보기

    바뀐 파일, 실행한 명령, 못 확인한 것을 받아 리뷰합니다.

  5. 9-10분

    다음 문서 고르기

    요청이 흔들렸다면 작업 요청서로, 결과를 믿기 어렵다면 패치 루프로 갑니다.

왜 지금인가

자동완성에서 작업 운영으로

Codex는 코드 몇 줄을 대신 쓰는 도구를 넘어, 로컬 패치와 클라우드 작업, 리뷰, Skills (반복 절차), automation (자동화)을 한 흐름으로 묶는 작업 표면입니다. 그래서 차이는 프롬프트 길이가 아니라 범위, 검증, 승인선, 인계에서 납니다.

맡기기

작업 요청서

목표와 범위를 작게 자르고, 실행 표면을 먼저 고른다.

맡기기 단계가 끝나면 사람이 확인할 수 있는 흔적이 남아야 합니다.

고치기

패치 루프

관계없는 리팩터링을 막고, 리뷰 가능한 diff (변경점)로 만든다.

고치기 단계가 끝나면 사람이 확인할 수 있는 흔적이 남아야 합니다.

검증하기

검증 증거

테스트, 빌드, 스크린샷, CI 결과로 말보다 증거를 남긴다.

검증하기 단계가 끝나면 사람이 확인할 수 있는 흔적이 남아야 합니다.

남기기

handoff (인수인계)

다음 사람이나 다음 세션이 이어받을 수 있게 위험과 판단을 적는다.

남기기 단계가 끝나면 사람이 확인할 수 있는 흔적이 남아야 합니다.

읽기 경로

당신은 무엇을 얻는가

같은 Codex라도 독자마다 필요한 가치는 다릅니다. 이 허브는 입문자의 첫 성공, 실무자의 반복 가능한 작업 루프, 팀 리드의 운영 기준을 한 흐름으로 연결합니다.

입문자

Codex를 어디서 켜고 첫 요청을 어떻게 맡길지

작고 되돌릴 수 있는 첫 패치를 만든다

이 경로로 시작하기 →
실무자

버그, 기능, UI, CI 작업을 어떻게 끝낼지

diff (변경점)와 테스트 증거로 작업을 닫는다

이 경로로 시작하기 →
팀 리드

팀원이 만든 AI 변경을 어떻게 믿고 리뷰할지

AGENTS.md, 승인선, 리뷰 규칙을 세운다

이 경로로 시작하기 →
비개발 빌더

직접 코드를 몰라도 어디까지 맡길 수 있는지

요청, 검수, handoff (인수인계)의 언어를 배운다

이 경로로 시작하기 →

바로 가져갈 산출물

자료가 아니라 운영 도구처럼 읽기

읽고 끝나는 설명보다 오늘 업무에 붙일 수 있는 산출물을 먼저 가져가세요. 이 플레이북은 Codex에게 맡길 요청, 사람이 확인할 증거, 팀에 남길 기준을 문서마다 같은 형식으로 묶습니다.

요청서

작업 요청서

목표, 허용 범위, 금지, 검증, 중단 조건을 한 장으로 묶어 Codex에게 넘깁니다.

가져가기 →
리뷰

패치 완료 보고

바뀐 파일, diff (변경점), 테스트 증거, 남은 위험을 리뷰 가능한 언어로 닫습니다.

가져가기 →
승인

안전선 체크

sandbox (기술 울타리), approval (사람 승인), secret (비밀값) 취급을 분리합니다.

가져가기 →

인수인계 기준

AGENTS.md, PR 템플릿, 검증 스크립트, handoff (인수인계)를 팀 기준으로 남깁니다.

가져가기 →

무료 플레이북

기능명이 아니라 작업 흐름으로 읽기

각 문서는 OpenAI 공식 기능과 실무 운영 해석을 분리합니다. 먼저 무료 플레이북으로 신뢰할 수 있는 작업 단위를 익히고, 필요하면 워크숍에서 실제 저장소로 훈련합니다.

입문

처음 시작 지도

Codex를 어디서 켜고, 첫 작업을 어디에 맡길지 정합니다.

문서 읽기 →
입문/실무

작업 요청서

요청을 목표, 범위, 금지선, 증거로 나눠 맡깁니다.

문서 읽기 →
실무

패치 루프

버그, 기능, UI, CI 작업을 diff (변경점)와 검증으로 닫습니다.

문서 읽기 →
실무

안전선과 승인

파일 쓰기, 명령 실행, 네트워크, 비밀정보 기준을 세웁니다.

문서 읽기 →
고급

병렬·클라우드 운영

긴 작업, worktree (작업 책상), automation (자동화), Skill을 분리 운영합니다.

문서 읽기 →

팀 도입

개인 요령을 팀의 리뷰, 보안, 온보딩 기준으로 바꿉니다.

문서 읽기 →
기준

자료 근거

공식 문서와 참고 PDF를 어떻게 나눠 썼는지 확인합니다.

문서 읽기 →

근거와 해석

자료는 나누어 씁니다

공식 기능은 공식 문서로, 제공 자료는 독자 눈높이와 실패 패턴을 읽는 보조 근거로, 이 사이트의 프레임워크는 실전 운영 언어로 분리합니다.

공식 문서

Codex app, CLI, Web, Skills, use cases는 OpenAI 공식 문서로 확인합니다.

제공 자료

참고 PDF는 문장이나 구조를 옮기지 않고, 위임·검증·인계의 문제의식만 반영합니다.

자체 해석

작업 요청서와 패치 루프는 실제 팀 운영을 위해 재배열한 플레이북 언어입니다.

실습으로 이어가기

Codex 실전 워크숍

실제 저장소에서 작업 요청서, diff (변경점), 검증 증거, review note (리뷰 메모)를 한 바퀴로 닫는 훈련. 첫 세션은 설치가 아니라 실제 저장소에서 작업을 맡기고, Codex가 만든 결과를 사람이 믿을 수 있는 증거로 닫는 훈련으로 설계합니다.

  • 첫 요청을 작업 요청서로 바꾸기
  • 작은 diff (변경점) 만들고 검증하기
  • 리뷰 메모와 handoff (인수인계) 작성하기
대기자 알림 준비 중 작업 요청서 먼저 보기

대기자 신청이 열리면 새 기수, 커리큘럼, 샘플 자료 공개 소식을 받을 수 있게 준비 중입니다.

Codex로 일하는 표준 책 표지 시안
실제 저장소를 놓고 요청서, 검증 증거, 리뷰 보고서를 함께 작성하는 실습입니다.