OpenAI Codex /goal: 당신이 잠든 사이 코드가 스스로 배포됩니다

AI 코딩 어시스턴트(AI coding assistants)는 매일 더 발전하고 있습니다. 하지만 대부분은 여전히 한 번에 하나의 프롬프트(prompt) 단위로 작동합니다. 무언가를 질문하고, 답변을 얻은 다음, 다음 단계를 수동으로 안내해야 합니다. OpenAI Codex의 새로운 /goal 명령어는 이러한 워크플로우(workflow)를 변화시킵니다. 고립된 답변을 요구하는 대신, 명확한 성공 조건이 포함된 장기적인 목표를 Codex에 부여할 수 있습니다. Codex는 조사하고, 코드를 작성하고, 테스트를 실행하며, 여러 단계에 걸쳐 결과를 향해 작업을 계속할 수 있습니다.

이 가이드에서는 다음 내용을 배우게 됩니다:
/goal이란 무엇인가
작동 방식
활성화 방법
실제 예시
최선의 실무(Best practices)
흔한 실수

Codex에서 /goal 명령어란 무엇인가?
/goal 명령어는 Codex를 위해 지속적인 목표를 정의할 수 있게 해줍니다. 모든 메시지를 별개의 요청으로 취급하는 대신, Codex는 다음 상황이 발생할 때까지 동일한 결과를 향해 작업을 계속합니다:

• 목표가 완료되었을 때
• 사용자가 일시 중지했을 때
• 목표를 삭제했을 때
• 작업이 차단되었을 때
• 리소스 제한(Resource limits)에 도달했을 때

이는 AI 개발자에게 작업을 부여하고, 지시를 반복하지 않아도 계속해서 작업을 수행하도록 내버려 두는 것과 같습니다.

목표 라이프사이클(Goal Lifecycle) 작동 방식
목표는 보통 간단한 워크플로우를 따릅니다.

1단계: 목표 정의
Codex에게 무엇이 일어나야 하는지 말합니다.
예시: /goal 대시보드 페이지 로드 시간을 2초 미만으로 단축할 것

2단계: Codex의 조사 및 계획
Codex는 다음과 같은 작업을 수행할 수 있습니다:

• 파일 읽기
• 코드 분석
• 의존성(dependencies) 확인
• 문제 검색
• 다음 작업 계획

3단계: 실행 및 검증
Codex는 다음과 같은 작업을 수행할 수 있습니다:

• 코드 작성
• 테스트 실행
• 함수 리팩터링(Refactor)
• 변경 사항 검증

4단계: 완료 또는 일시 중지
조건이 충족되면 목표를 완료할 수 있습니다. 또한 나중에 작업을 일시 중지하고 다시 재개할 수도 있습니다.

Codex /goal 예시
/goal을 사용해야 할 때
목표(Goals)는 여러 단계가 필요한 작업에 가장 효과적입니다.

좋은 사용 사례:
성능 최적화 (Performance optimization)
/goal 홈페이지 로딩 시간 단축
제약 조건 (Constraints): 기존 UI 유지, Lighthouse 점수 90점 이상 유지, 로딩 시간 2초 미만 목표

어려운 버그 찾기
/goal analytics.ts의 메모리 누수 (memory leaks) 조사
제약 조건 (Constraints): 기존 아키텍처 유지, 필요 시 테스트 추가, 불확실한 결과물은 명확하게 표시

테스트 커버리지 작성
/goal auth.ts를 위한 유닛 테스트 (unit tests) 생성
제약 조건 (Constraints): 최소 90% 커버리지 달성, 비즈니스 로직 수정 금지

대규모 리팩터링 작업
/goal 결제 모듈 리팩터링 (Refactor)
제약 조건 (Constraints): API 동작 보존, 테스트 통과 유지, 가독성 향상

/goal을 사용하지 말아야 할 때
/goal은 모든 작업에 적합한 도구는 아닙니다. 다음과 같은 경우에는 /goal 사용을 피하세요:
한 줄 편집, 간단한 설명, 작은 버그 수정, 짧은 코드 리뷰, 정답이 하나뿐인 질문

나쁜 예시: /goal 이 코드를 더 좋게 만들어줘
이것이 나쁜 이유: "더 좋게"라는 표현은 명확한 종료 지점이 없습니다. Codex는 언제 멈춰야 할지 모르는 상태에서 계속해서 변경을 시도할 수 있습니다.

더 나은 버전: /goal user-service.ts 리팩터링 (Refactor)
제약 조건 (Constraints): API 변경 금지, 가독성 향상, 테스트 통과 유지

Codex에서 /goal 활성화하는 방법
Codex 업데이트: npm install -g @openai/codex@latest
설치 확인: codex --version
일부 Codex 버전에서는 목표 (goal) 관련 기능을 활성화해야 할 수도 있습니다. 이를 위해 config.toml 파일을 찾아 다음 줄을 추가하세요:
[features]
goals = true

목표 (Goal) 명령어
목표 생성: /goal 대시보드 마이그레이션 완료
현재 목표 확인: /goal
일시 정지: /goal pause
재개: /goal resume
삭제: /goal clear

좋은 목표 프롬프트 vs 나쁜 목표 프롬프트
나쁜 /goal: 이 코드를 리팩터링하고 더 좋게 만들어줘
문제점: 측정 가능한 결과가 없음, 제약 조건이 없음, 종료 지점이 없음

좋은 /goal: db.ts의 데이터베이스 쿼리 최적화 (Optimize)
제약 조건 (Constraints): 스키마 변경 금지, 모든 실행 경로를 테스트로 커버, 목표 실행 시간 50ms 미만

작동 원리: 명확한 목표, 정의된 한계, 측정 가능한 결과

권한 및 안전 팁
Codex는 파일을 변경하거나 명령어를 실행하는 작업 전에 확인을 요청할 수 있습니다.

긴 자율 작업 (autonomous tasks)을 실행하기 전:
Git 상태를 깨끗하게 유지하기
새 브랜치 생성: git checkout -b codex-experiment
목표 (goals) 실행 전 커밋하기: git add . git commit -m "Clean starting point"
민감한 환경 피하기

자율 작업을 실행하지 말아야 할 경우:
프로덕션 시스템 (production systems)에서
비밀 키 (secrets)가 노출된 상태에서
중요한 시스템 폴더에서

모범 사례 (Best Practices)
명확한 종료 지점 정의하기
나쁜 예: /goal 성능 개선하기
좋은 예: /goal API 응답 시간을 150ms 미만으로 줄이기

제약 조건 (constraints) 정의하기
Codex에게 변경해서는 안 되는 사항을 알려주세요.
예시:
API를 변경하지 말 것
테스트를 통과하는 상태를 유지할 것
데이터베이스 스키마 (database schema)를 변경하지 말 것

불확실성을 숨기지 말 것
데이터를 사용할 수 없는 경우:
지표 (metrics)를 수집할 수 없다면, 결과를 추정치 (estimated)로 표시하세요.

측정 가능한 목표 사용하기
예시:
응답 시간 100ms 미만
테스트 커버리지 (test coverage) 95%
Lighthouse 점수 90점 이상

비디오 튜토리얼
YouTube에서 시청하기: Codex /goal 설명

결론
/goal 명령어는 Codex를 단순한 프롬프트-응답 (prompt-response) 도구에서 더 오래 지속되는 코딩 워크플로 (coding workflow)로 변화시킵니다. 몇 분마다 지침을 반복하는 대신, Codex에 명확한 목표를 부여하고, 제약 조건을 정의하며, 작업이 완료되었는지는 증거를 통해 결정하도록 합니다.

직접 시도해 보시고 제 YouTube 영상의 댓글을 통해 피드백을 공유해 주세요! ;)
Cheers, proflead! ;)