빠른 흐름
안전한 자동화 순서
1. 일반 스레드에서 프롬프트를 수동 검증한다
2. 자동화로 승격한다
3. Git 저장소면 local 또는 worktree 실행 방식을 고른다
4. 첫 몇 회차는 Triage Inbox에서 결과를 집중 검토한다
5. 끝난 실행은 archive 해서 인박스와 worktree를 정리한다자동화 흐름
자동화는 unattended 실행이기 때문에 수동 검증이 선행되어야 한다
Codex app의 Automations는 백그라운드에서 반복 작업을 실행하고, 결과가 있으면 Triage 인박스로 올리는 기능입니다. 사람이 개입하지 않는 실행이기 때문에, 프롬프트가 모호하거나 diff 범위가 예상보다 넓어도 자동으로 멈추지 않습니다. 공식 문서는 자동화를 바로 예약하지 말고 먼저 일반 스레드에서 프롬프트를 수동으로 시험해 diff 품질과 범위를 확인하라고 권합니다.
Local과 Worktree의 실행 방식 차이가 안전성을 결정한다
Git 저장소에서는 자동화를 현재 로컬 체크아웃에서 직접 돌릴지, 새 Worktree에서 격리해서 돌릴지 고를 수 있습니다. Local 실행은 현재 작업 중인 파일을 바로 수정할 수 있어 빠르지만, 끝나지 않은 로컬 작업과 변경이 섞이는 위험이 있습니다. Worktree 실행은 별도 Git 체크아웃을 만들어 격리하므로 현재 개발 흐름에 영향을 주지 않습니다. 처음에는 Worktree 방식으로 시작하는 편이 훨씬 안전합니다.
Local
-> 빠름
-> 현재 체크아웃 직접 수정
Worktree
-> 느리지만 안전
-> 현재 작업과 격리기본 sandbox 상속이 자동화 위험도를 결정한다
자동화는 현재 프로젝트의 기본 sandbox 설정을 그대로 따릅니다. read-only에서는 수정이나 네트워크 접근이 막히고, full access에서는 무인 실행의 위험이 커집니다. 이 때문에 자동화를 설정할 때 sandbox 범위를 의식적으로 좁히는 것이 중요합니다. "full access + local 실행" 조합은 현재 작업 파일을 무인으로 바로 수정할 수 있어 가장 위험한 조합입니다.
Triage Inbox를 활용해 초반 실행 결과를 집중 검토한다
Triage Inbox는 자동화 실행 결과를 모아 보여 주는 인박스입니다. 결과가 없으면 자동 보관될 수도 있습니다. 자동화가 처음 몇 회 실행될 때는 인박스에서 diff 품질, 작업 범위, 의도치 않은 수정 여부를 집중 검토해야 합니다. 이 검토 결과를 바탕으로 프롬프트와 주기를 조정한 뒤 완전한 자동화로 전환하는 것이 실패를 예방하는 방법입니다.
현재 공식 문서 기준으로 Triage는 automations pane 안의 inbox 역할을 하며, 자동화 결과를 전체 또는 unread 기준으로 필터링해 볼 수 있습니다. 또한 프로젝트 범위 자동화는 앱이 실행 중이어야 하고, 선택한 프로젝트가 디스크에 있어야 정상 동작합니다. 장기 스레드 안에서 같은 맥락을 유지해야 할 때는 standalone automation보다 thread automation이 더 잘 맞습니다.
언제 자동화할까
| 상황 | 적합한 선택 |
|---|---|
| 자동화 결과를 검토해야 할 때 | Triage Inbox에서 diff와 범위 확인 |
| 현재 로컬 작업과 분리하고 싶을 때 | Worktree 실행 방식 선택 |
| 빠른 결과가 필요하고 격리가 덜 중요할 때 | Local 실행 방식 선택 |
| 자동화 권한 범위를 결정해야 할 때 | 기본 sandbox 설정 확인 후 조정 |
| 첫 자동화를 설정할 때 | 수동 스레드 검증 먼저, 자동화 승격은 나중에 |
| 첫 몇 회 결과를 집중 검토할 때 | Triage Inbox를 기준으로 diff 확인 |
주의할 점
자동화는 unattended 실행이기 때문에 수동 스레드보다 위험이 큽니다. 특히 full access와 local 실행을 함께 쓰면 현재 작업 파일을 바로 바꿀 수 있으니, 먼저 Worktree와 좁은 sandbox 조합으로 시작하는 편이 안전합니다.
❌ 프롬프트 수동 검증 없이 바로 주간 자동화 등록
❌ full access + Local 조합으로 메인 저장소 직접 수정이 조합은 diff 범위가 예상보다 넓어져도 중간에 멈추기 어렵습니다.
참고 링크
3 sources