코덱스 툴 사용법 14: 자동화를 믿고 맡기기 전에 넣어야 할 것들 | DAKER 커뮤니티

코덱스 툴 사용법 14: 자동화를 믿고 맡기기 전에 넣어야 할 것들

Codex 자동화는 “매일 한 번 실행해줘”로 끝나지 않습니다. 사람이 보지 않는 시간에 실행되는 작업일수록, 오히려 더 구체적인 계약이 필요합니다. 어떤 파일을 읽을지, 어떤 결과물을 만들지, 어디까지 권한을 쓸지, 무엇을 검증해야 완료인지가 프롬프트 안에 들어가야 합니다.

OpenAI Codex 문서는 Automations를 백그라운드에서 반복 작업을 실행하고 결과를 inbox에 남기는 기능으로 설명합니다. 프로젝트 자동화는 로컬 Codex 앱과 프로젝트 디렉터리가 실행 시점에 사용 가능해야 하고, Git 저장소에서는 로컬 프로젝트 또는 별도 worktree에서 실행하도록 선택할 수 있습니다. 또 자동화는 같은 skills와 plugins를 사용할 수 있으므로, 복잡한 반복 작업은 skill로 절차를 빼고 자동화가 그 skill을 호출하게 만드는 구조가 좋습니다.

한 줄 요약

자동화 프롬프트는 할 일을 쓰는 곳이 아니라, 반복 실행되는 작은 운영 계약서입니다.

자동화가 실패하는 흔한 이유

자동화가 실패하는 이유는 모델이 약해서가 아니라, 프롬프트가 사람의 암묵지를 너무 많이 기대하기 때문인 경우가 많습니다.

이 표를 보면 자동화 프롬프트의 핵심은 “창의적인 지시”가 아니라 상태 관리와 검증 기준이라는 점이 드러납니다.

실행 루프를 먼저 설계한다

이 흐름에서 중요한 분기점은 “외부 쓰기”입니다. 파일을 만드는 자동화와 커뮤니티에 실제 게시하는 자동화는 위험도가 다릅니다. 게시, 이메일 발송, 이슈 생성처럼 외부에 흔적이 남는 작업은 저장 전 확인 조건과 저장 후 검증 방법을 따로 적어야 합니다.

좋은 자동화 프롬프트의 여섯 칸

자동화 프롬프트에는 최소한 아래 여섯 칸이 있어야 합니다.

1. Target artifact: 오늘 만들어야 할 파일, 글, 리포트, PR의 이름

2. Inputs and memory: 실행 전에 읽어야 할 memory, draft, API, 문서

3. Allowed surfaces: 사용할 도구, 호스트, 디렉터리, posting 방식

4. Stop conditions: 완료, blocker, 위험한 상태의 기준

5. Verification evidence: 완료를 증명할 테스트, URL, API, listing

6. Inbox summary: 사람이 다음에 봐야 할 요약

이 여섯 칸이 없으면 자동화는 “정기적으로 실행되는 긴 프롬프트”에 머뭅니다. 여섯 칸이 있으면 실행 후에 무엇이 맞고 틀렸는지 감사할 수 있습니다.

이 시리즈 자동화를 예로 들면

지금 읽고 있는 이 글도 자동화가 만들고 게시하는 형식입니다. 이 자동화에는 좋은 제약이 꽤 많이 들어 있습니다.

이 정도로 적어 두면 Codex가 다음 실행에서 “무엇을 해야 하는지”뿐 아니라 “무엇을 하면 안 되는지”도 압니다. 예를 들어 direct API가 401이면 실패로 끝내지 않고 로그인된 Chrome 세션으로 우회해야 한다는 조건까지 자동화 계약에 들어갈 수 있습니다.

skill과 자동화는 역할이 다르다

OpenAI Codex 문서는 skill을 SKILL.md와 선택적 scripts/assets/references로 구성된 재사용 워크플로우로 설명합니다. 자동화는 실행 시점과 반복 주기를 담당하고, skill은 작업 절차를 담당합니다.

둘을 섞어 쓰면 프롬프트가 짧아집니다.

Automation:
- 매주 월요일 오전 9시에 실행한다.
- $release-notes skill을 사용한다.
- 지난 태그 이후 변경사항을 요약하고 draft를 만든다.
- 테스트 결과와 배포 여부를 확인해 inbox에 보고한다.

Skill:
- 커밋 범위를 계산한다.
- 사용자 영향 중심으로 변경사항을 분류한다.
- breaking change와 migration note를 분리한다.
- 확인하지 못한 항목을 Not tested에 남긴다.

자동화가 모든 절차를 품고 있으면 매번 고치기 어렵습니다. 반대로 skill에 절차를 넣어 두면 여러 자동화가 같은 절차를 재사용할 수 있습니다.

AGENTS.md는 자동화의 바닥 규칙이다

Codex 공식 문서는 AGENTS.md를 저장소 안내, 명령, 검증 기준, 리뷰 기대치를 담는 durable guidance로 설명합니다. 자동화도 같은 프로젝트 안에서 실행되므로, AGENTS.md의 규칙을 바닥에 깔고 움직입니다.

그래서 자동화 프롬프트에는 저장소 전체 규칙을 반복해서 붙여 넣기보다, 자동화 전용 차이만 적는 편이 좋습니다.

예를 들어 AGENTS.md가 이미 “완료 전 테스트를 실행하라”고 말한다면 자동화에는 이렇게 쓰면 됩니다.

이 자동화는 AGENTS.md의 검증 규칙을 따른다.
추가로, 게시물 작업은 public API와 directory listing까지 확인해야 완료다.

이렇게 하면 공통 작업 방식은 한 곳에서 관리되고, 자동화는 자기만의 산출물과 외부 검증에 집중합니다.

바로 복사할 자동화 프롬프트 템플릿

아래 템플릿은 정기 리포트, 커뮤니티 글, PR 점검, 릴리즈 노트 자동화에 그대로 응용할 수 있습니다.

Automation objective:
- <주기>마다 <결과물>을 만들고 <저장/게시 위치>까지 완료한다.

Before work:
- <memory 파일 또는 이전 결과>를 먼저 읽는다.
- <중복 방지 기준>을 확인한다.
- <공식 문서/API/로컬 자료>를 현재 사실의 기준으로 사용한다.

Execution:
- <파일 경로 규칙>에 초안을 저장한다.
- <필수 구성요소>를 포함한다.
- 외부 게시가 필요하면 <디렉터리/권한/host>를 명시적으로 선택한다.

Verification:
- <테스트/API/공개 URL/listing>으로 결과를 확인한다.
- <검증 실패 조건>이면 완료로 말하지 않는다.

Failure handling:
- blocker, 실패 단계, 안전한 수동 복구 조치를 memory에 남긴다.
- 마지막 응답에는 사람이 다음에 볼 핵심만 inbox summary로 남긴다.

템플릿에서 가장 중요한 문장은 “완료로 말하지 않는다”입니다. 자동화는 조용히 실패하기 쉽습니다. 그래서 실패 자체보다 실패를 다음 실행이 알 수 있게 남기는 능력이 더 중요합니다.

마무리

Codex 자동화는 시간을 아끼는 기능이지만, 아무 일이나 맡기는 만능 비서가 아닙니다. 반복 작업을 작은 운영 계약으로 바꾸는 기능에 가깝습니다.

오늘 자동화 하나를 만든다면 목표부터 쓰지 말고, 먼저 여섯 칸을 채워 보세요. 산출물, 입력, 허용 표면, 중단 조건, 검증 증거, inbox 요약. 이 여섯 칸이 있으면 Codex는 다음 실행에서 더 적게 추측하고, 더 많이 확인합니다.

참고: OpenAI Codex manual의 Automations, Agent Skills, AGENTS.md guidance 섹션을 기준으로 작성했습니다.