← 목록으로

루프 엔지니어링

한 번의 답이 아니라, 행동하고 검증하고 다시 도는 시스템을 설계합니다

루프 엔지니어링 Routines 예약 실행
Claude Code · Codex
루프엔지니어링

사람이 매번 지켜보지 않아도 AI가 목표를 끝까지 달성하도록 설계하는 일입니다.

언제 시작하나
Trigger

프롬프트, 목표 선언, 시간표, 외부 이벤트 중 무엇이 루프를 시작할지 정합니다.

언제 멈추나
Stop

성공 조건, 최대 반복 수, 실패 출구를 미리 정합니다. 멈춤 기준이 없으면 루프는 끝나지 않습니다.

사람의 역할
실행자 → 감독관

매번 지시하지 않고 목표와 기준만 정합니다.

예AI가 밤사이 실패한 테스트가 0건이 될 때까지 수정하고 재실행합니다. 사람은 아침에 결과만 확인합니다.

정의와 유래
루프는 멈출 때까지 반복하는 구조입니다
사전적 정의
loop (명사)

끝이 처음으로 돌아와 이어진 고리.

컴퓨팅조건을 만족할 때까지 같은 명령을 반복하는 구조(반복문)
Claude Code 팀의 정의

에이전트가 멈춤 조건을 만날 때까지 작업 주기를 반복하는 것

무엇으로 시작하나 Trigger
언제 멈추나 Stop
단어의 계보
반복문명령 반복(1947년~)→에이전트 루프모델을 반복 호출(2024년~)→루프 엔지니어링반복 구조 설계(2026년~)
용어의 시작
2024년 3월 20일

Andrew Ng의 The Batch가 에이전트 루프를 적용한 GPT-3.5의 코딩 점수(HumanEval)가 GPT-4 단독보다 높다고 소개

2025년 7월 14일

Geoffrey Huntley가 "Ralph Wiggum as a 'software engineer'"에서 Bash 루프로 에이전트를 반복 호출하는 Ralph 기법을 공개

2026년 6월 2일

Boris Cherny(Claude Code 책임자)가 WorkOS 인터뷰에서 "I don't prompt Claude anymore. I have loops that are running."이라고 발언

2026년 6월 7일

같은 날 Peter Steinberger의 X 글과 Addy Osmani의 블로그 글 "Loop Engineering"이 나오면서 용어가 확산

2026년 6월 30일

Claude 공식 블로그가 "Getting started with loops"에서 루프를 시작 방식과 멈춤 방식으로 분류

출처: etymonline.com, The Batch Issue 241, ghuntley.com/ralph, addyosmani.com/blog/loop-engineering, claude.com/blog, arXiv:2608.21884

AI를 다루는 방식
프롬프트에서 루프까지

AI 활용 방식은 프롬프트에서 시작해 세 번 진화했습니다.

1 · Prompt
프롬프트

모델에 전달할 지시문을 다듬습니다.

지시문 개선
2 · Context
컨텍스트

모델이 참고할 자료, 규칙, 메모리를 미리 준비합니다.

작업 환경 구축
3 · Harness
하네스

도구, 검증, 역할 분담을 묶어 모델을 감싸는 운영 환경을 설계합니다.

운영 환경 설계
4 · Loop
루프

하네스 위에서 실행, 관찰, 조정을 반복합니다.

반복 실행
→ → →

핵심설계 대상이 지시문에서 작업 환경, 운영 환경, 반복 시스템으로 넓어졌습니다.

한 줄 정의
하네스를 목표 달성까지 반복합니다

루프 엔지니어링은 하네스를 목표 달성까지 반복 실행하도록 설계하는 일입니다.

Loop · 목표 달성까지 반복
하네스 엔지니어링 =
ENGINELLM 모델언어 모델
+
1Role역할 분리
+
2Rubric평가 기준
+
3Context컨텍스트 관리
+
4Tools도구
+
5Workflow작업 절차
+
6Guardrail가드레일
1
Trigger · 시작 조건무엇이 루프를 시작하는지 정합니다
2
Stop · 종료 규칙성공 조건, 최대 반복 수, 실패 출구를 정합니다

사람반복 구조를 설계·운영하고, 결과를 보며 계속 개선합니다.

Trigger시작 조건
루프는 세 가지입니다

목표 달성까지 실행할지, 정해진 시간마다 실행할지, 업무 전체를 위임할지 먼저 정합니다.

루프
입력 조건
사용 시점
명령어 · 도구
Goal-based목표 도달형
멈춤 조건
완료 기준이 분명한 일
/goal
Time-based정기 실행형
시작 조건
외부에서 주기적으로 일이 생길 때
/loop · /schedule
Proactive자동 위임형
업무 위임
기준이 분명한 반복 업무
전부 + 동적 워크플로우

원칙가장 단순한 Goal-based부터 시작하고, 반복 작업이 안정되면 확장합니다.

Trigger 1멈춤 조건을 정함
Goal-based loop목표 도달형
/goal 도입
Codex2026년 4월
Claude Code2026년 5월

완료 기준과 최대 반복 수를 먼저 정합니다. Claude·Codex가 멈추려 하면 평가 모델이 조건을 확인하고, 부족하면 작업을 다시 시킵니다.

/goal 템플릿

/goal 첨부한 제안서가 검토 기준을 모두 통과할 때까지 다듬어 주세요. 5번 고쳐도 통과하지 못하면 멈추고, 남은 문제를 정리해 알려 주세요.

# 완료 조건
  • 첫 문단에 핵심 제안과 기대 효과가 보일 것
  • 수치와 인용이 원본과 100% 일치할 것
  • 결론이 앞의 근거에서 이어질 것

출처: Codex v0.128.0 릴리스(2026.4.30), Claude Code v2.1.139 릴리스(2026.5.11)

Trigger 2시작 조건을 정함
Time-based loop정기 실행형
도입 시기
/loop · Claude Code2026년 3월
/schedule · Claude Code2026년 3월
예약 작업 · Codex 앱2026년 2월

사람이 매번 실행하지 않고 일정을 위임합니다. Claude·Codex는 정해진 간격으로 외부 변화를 확인하고, 변화가 있으면 처리합니다.

/loop 템플릿

/loop 5m 공유 메일함에 새로 들어온 고객 문의를 확인하고, 답변 초안을 준비해 주세요.

# 멈출 조건
  • 처리할 새 문의가 없으면 멈출 것
  • 같은 문의가 3번 반복되면 멈추고 원인을 알릴 것
# 매 실행
  • 새 문의만 분류해 초안을 쓰고, 발송은 대기
  • 처리한 내용을 한 줄로 기록

출처: Claude Code v2.1.71 릴리스(2026.3.7), Claude Code 문서 Schedule tasks on the web(2026.3.23 보관본), Codex 앱 발표 보도(Business Today, 2026.2.3)

Trigger 3맡기고 승인만 함
Proactive loop자동 위임형
도입 시기
/schedule · Claude Code2026년 3월
Routines · Claude Code2026년 4월
예약 작업 · Codex 앱2026년 2월

스케줄, 목표, 검증 Skill, 동적 워크플로우, 자동 모드를 조합합니다. 사람은 실시간으로 지켜보지 않고 최종 승인만 맡습니다.

Proactive 템플릿

/schedule every day 08:30 지난 하루의 업계 소식을 모아 아침 브리핑 초안을 만들어 주세요.

# 목표
  • 우리 사업과 관련된 소식만 중요도 순으로
  • 각 항목을 사실과 시사점으로 나눠 정리
# 작업 절차
  • 검토 단계에서 사실과 출처를 다시 확인
  • 통과하면 발송 대기, 발송은 승인 후 진행

출처: Claude Code 문서 Schedule tasks on the web(2026.3.23 보관본), Claude 블로그 Introducing routines in Claude Code(2026.4.14), Codex 앱 발표 보도(Business Today, 2026.2.3)

Stop종료 규칙
멈출 조건 여섯 가지

성공 조건만으로는 부족합니다. 반복 상한, 실패 출구, 승인 게이트까지 정해야 무한 반복을 막을 수 있습니다.

1성공 조건

완료 상태를 숫자나 체크리스트로 정의합니다.

예. 테스트 실패 0건, 체크리스트 전부 통과
2반복 상한

최대 시도 횟수를 정해 무한 반복을 막습니다.

예. 5회 시도 후 멈추고 보고
3검증 장치

테스트, 브라우저 확인, 체크리스트, 독립 채점으로 결과를 검증합니다.

예. 작성자와 판정자를 분리
4실패 출구

진전이 없거나 같은 오류가 반복되면 멈추고 원인을 보고합니다.

예. 같은 오류 3회면 사람에게 보고
5상태 기록

회차마다 수행한 작업과 막힌 지점을 기록합니다.

예. 기억은 압축하고 기록은 보존
6승인 게이트

머지, 배포, 삭제처럼 되돌리기 어려운 작업은 사람이 승인합니다.

예. 자동 실행과 최종 결정을 분리
Stop한 루프의 구조
한 루프는 다섯 단계입니다

목표를 달성하거나 멈춤 조건에 도달할 때까지 이 다섯 단계를 반복합니다.

1
의도

무엇을 달성할지 정합니다

2
맥락

필요한 자료와 규칙을 준비합니다

3
실행

작업을 수행합니다

4
관찰

결과를 확인합니다

5
조정

수정해 다음 회차에 반영합니다

→ → → →
제안만 하는 AI는 루프가 아닙니다.

실행하고 결과를 확인한 뒤, 수정해서 다시 실행해야 루프입니다.

운영 점검운영 중 확인
품질과 비용을 함께 관리합니다

자동으로 실행된다고 결과가 좋아지지는 않습니다. 루프를 돌리면 기존 코드, 문서, 검증 절차, 비용 예산의 장단점이 그대로 커집니다.

품질 관리
  • 코드베이스와 문서를 깨끗하게 유지
  • 검증 절차를 Skill·체크리스트로 기록
  • 최신 공식 문서를 바로 찾도록 연결
  • 작성 에이전트와 리뷰 에이전트 분리
토큰 관리
  • 작업에 맞는 루프와 모델 선택
  • 성공 조건과 멈춤 조건을 구체적으로 설정
  • 큰 실행 전에 작은 범위로 시험
  • 결과가 정해진 반복 작업은 스크립트로 처리
운영 점검세 가지 원칙
검증, 반영, 사용량

Trigger와 Stop을 정했다면, 루프가 제대로 작동하는지 세 가지 원칙으로 점검합니다.

1
검증은 분리합니다

작업한 에이전트가 직접 합격 여부를 판정하면 평가가 후해집니다. 작성자와 검토자를 분리하고, 가능하면 별도의 채점 루브릭을 둡니다.

2
실패를 시스템에 반영합니다

한 번 수정하고 끝내지 않습니다. 같은 문제가 다음 회차에 반복되지 않도록 규칙, Skill, 체크리스트에 반영합니다.

3
사용량을 봅니다

/usage, /goal, /workflows 같은 명령으로 Skill, 서브에이전트, MCP별 비용을 확인합니다.

실행법명령어 고르기
/goal, /loop, /schedule

목표가 분명하면 /goal, 로컬에서 주기적으로 확인하려면 /loop을 씁니다. 클라우드에서 예약 실행하려면 /schedule을 씁니다.

/goal
완료 기준이 있을 때

점수, 테스트 통과, 체크리스트처럼 완료를 판정할 수 있는 작업에 씁니다.

/loop
정해진 간격으로 확인할 때

로컬 컴퓨터에서 PR, 리뷰, CI처럼 외부 상태가 바뀌는 작업을 주기적으로 확인합니다.

/schedule
클라우드에서 돌릴 때

컴퓨터가 꺼져 있어도 정해진 시각에 실행해야 하는 작업은 클라우드 예약(Routines)으로 옮깁니다.

별칭 /routines

Routines/loop은 컴퓨터가 꺼지면 멈춥니다. 무인 실행이 필요하면 Routines로 옮깁니다.

출발점루프 엔지니어링
“

As big as the step from source code to agents was, loops are just as important and as big a step.

소스 코드에서 에이전트로 넘어간 것이 큰 도약이었던 만큼, 루프도 그만큼 중요하고 큰 도약입니다.

보리스 체니 Boris Cherny
Creator & Head of Claude Code, Anthropic (2026년 6월 19일)
출처: The New Stack, thenewstack.io/loop-engineering
1 / 14
루프 엔지니어링이란

사람이 매번 지켜보지 않아도 AI가 목표를 끝까지 달성하도록 설계하는 일입니다.

예를 들어 AI가 밤사이 실패한 테스트가 0건이 될 때까지, 또는 분기 보고서가 검토 항목을 모두 통과할 때까지 스스로 수정하고 재실행합니다. 사람은 아침에 결과만 확인하면 됩니다.

실행자 · 매번 지시→감독관 · 목표와 기준만 정함

AI 활용 방식은 프롬프트에서 시작해 세 번 진화했습니다.
설계 대상이 지시문에서 작업 환경, 운영 환경, 반복 시스템으로 넓어졌습니다.

💬

프롬프트 엔지니어링

모델에 전달할 지시문을 다듬습니다. 지시 한 줄의 품질을 높이는 일입니다.

지시문 개선
🗃️

컨텍스트 엔지니어링

모델이 참고할 자료, 규칙, 메모리를 미리 준비합니다. 좋은 답이 나오는 환경을 만드는 일입니다.

작업 환경 구축
🛡️

하네스 엔지니어링

도구, 검증, 역할 분담을 묶어 모델을 감싸는 운영 환경을 설계합니다. AI가 안전하게 일하도록 가드레일을 세우는 일입니다.

운영 환경 설계
🔁

루프 엔지니어링

하네스 위에서 실행, 관찰, 조정을 반복합니다.

반복 실행
한 줄 정의

루프 엔지니어링은 하네스를 목표 달성까지 반복 실행하도록 설계하는 일입니다. 사람은 이 반복 구조를 설계·운영하고, 결과를 보며 계속 개선합니다. 사람의 역할도 매번 지시하는 실행자에서 루프를 관리하는 감독관으로 바뀝니다.

Loop 엔지니어링
하네스 엔지니어링 =
LLM 모델
ENGINE
+
Role
1역할 분리
+
Rubric
2평가 기준
+
Context
3컨텍스트 관리
+
Tools
4도구
+
Workflow
5작업 절차
+
Guardrail
6가드레일
Trigger

Trigger는 루프를 언제 시작할지 정합니다

루프의 실행 방식은 세 가지입니다. 목표 달성까지 실행할지, 정해진 시간마다 실행할지, 반복 업무 전체를 자동 운영 구조에 위임할지 먼저 정합니다.

Goal-based목표 도달형
멈춤 조건
완료 기준이 분명한 일
/goal
Time-based정기 실행형
시작 조건
외부에서 주기적으로 일이 생길 때
/loop · /schedule
Proactive자동 위임형
업무 위임
기준이 분명한 반복 업무
전부 + 동적 워크플로우
가장 단순한 루프부터 시작합니다

완료 기준이 분명한 일은 Goal-based로 시작합니다. 일이 정해진 간격으로 들어오면 Time-based로 옮깁니다. 반복 작업이 충분히 안정되면 Proactive로 확장합니다.

1Goal-based loop· 목표 도달형
멈춤 조건을 정함
/goal 제안서를 평가 기준 기반 개선하고, 최대 5번만 수행해 주세요 기준에 미달하면 재반복 결과 제출 조건 충족 Claude 작업 목표를 향해 수정 평가 모델 완료 조건 확인 루프 종료 목표 달성 또는 상한 도달

핵심: 완료 기준과 최대 반복 수를 먼저 정합니다. Claude·Codex가 멈추려 하면 평가 모델이 조건을 확인하고, 부족하면 작업을 다시 시킵니다.

/goal 템플릿
/goal 첨부한 제안서가 아래 검토 기준을 모두 통과할 때까지 다듬어 주세요. 5번 고쳐도 통과하지 못하면 멈추고, 남은 문제를 정리해 알려 주세요.

# 완료 조건 (모두 충족되면 끝내 주세요)
  · 첫 문단만 읽어도 핵심 제안과 기대 효과가 드러날 것
  · 모든 수치와 인용이 원본 자료와 100% 일치할 것
  · 결론이 앞의 근거에서 자연스럽게 이어질 것

# 마무리
  · 수정 내용 요약과 함께 최종본을 보고해 주세요
2Time-based loop· 정기 실행형
시작 조건을 정함
5분이 지나면 실행 새 변화가 있으면 처리 대기 반복 TRIGGER 5분마다 /loop · /schedule 정해진 간격에 실행 외부 상태 확인 메일, 채널, 문서 처리하고 보고 새 변화만 반응

핵심: 사람이 매번 실행하지 않고 일정을 위임합니다. Claude·Codex는 정해진 간격으로 외부 변화를 확인하고, 변화가 있으면 처리합니다.

/loop 템플릿
/loop 5m 공유 메일함에 새로 들어온 고객 문의를 확인하고, 답변 초안을 준비해 주세요.

# 멈출 조건 (충족되면 마쳐 주세요)
  · 처리할 새 문의가 없으면 멈춰 주세요
  · 같은 문의가 3번 반복되면 멈추고, 원인을 정리해 알려 주세요

# 매 실행 (실행할 때마다 해 주세요)
  · 새로 온 문의만 골라 유형별로 분류해 주세요
  · 답변 초안을 작성하되, 발송은 하지 말고 대기해 주세요
  · 이번 회차에 처리한 내용을 한 줄로 기록해 주세요
3Proactive loop· 자동 위임형
맡기고 승인만 함
클라우드에서 실행 작업 시작 검토 요청 검토 후 알림 사람이 끌 때까지 반복 TRIGGER /schedule 매일 아침 실행 GOAL + CHECK 메인 에이전트 검증 통과까지 반복 초안 작성 결과물 정리 REVIEW 검토 에이전트 사람 최종 승인

핵심: 스케줄, 목표, 검증 Skill, 동적 워크플로우, 자동 모드를 조합합니다. 사람은 실시간으로 지켜보지 않고 최종 승인만 맡습니다.

Proactive 템플릿
/schedule every day 08:30 지난 하루의 업계 소식을 모아 아침 브리핑 초안을 만들어 주세요.

# 목표
  · 우리 사업과 관련된 소식만 중요도 순으로 골라 주세요
  · 각 항목을 사실과 시사점으로 나눠 정리해 주세요

# 작업 절차
  · 초안을 만든 뒤, 검토 단계에서 사실과 출처를 다시 확인해 주세요
  · 검토를 통과하면 발송 대기 상태로 정리해 주세요
  · 실제 발송은 제 승인을 받은 뒤에 진행해 주세요
Stop

Stop은 루프가 언제 멈출지 정합니다

멈춤 조건이 분명해야 루프를 안전하게 운영할 수 있습니다. 성공 조건만으로는 부족합니다. 최대 반복 수, 실패 출구, 사람 승인 게이트까지 정해야 무한 반복을 막을 수 있습니다.

🎯

성공 조건

완료 상태를 숫자나 체크리스트로 정의합니다.

테스트 실패 0건, 체크리스트 전부 통과
🛑

반복 상한

최대 시도 횟수를 정해 무한 반복을 막습니다.

5회 시도 후 멈추고 보고
⚙️

검증 장치

테스트, 브라우저 확인, 체크리스트, 독립 채점으로 결과를 검증합니다.

작성자와 판정자를 분리
📦

실패 출구

진전이 없거나 같은 오류가 반복되면 멈추고 원인을 보고합니다.

같은 오류 3회면 사람에게 보고
🗂️

상태 기록

회차마다 수행한 작업과 막힌 지점을 기록합니다.

기억은 압축하고 기록은 보존
🔧

승인 게이트

머지, 배포, 삭제처럼 되돌리기 어려운 작업은 사람이 승인합니다.

자동 실행과 최종 결정은 분리
한 루프의 기본 순서

의도 › 맥락 › 실행 › 관찰 › 조정. 이 다섯 단계가 한 루프입니다. 목표를 달성하거나 멈춤 조건에 도달할 때까지 이 단계를 반복합니다. 제안만 하는 AI는 루프가 아닙니다. 실행하고 결과를 확인한 뒤, 수정해서 다시 실행해야 루프입니다.

운영 점검

품질과 비용은 루프를 운영하면서 점검합니다

Trigger와 Stop을 정했다면 루프가 제대로 작동하는지 점검해야 합니다. 자동으로 실행된다고 결과가 좋아지지는 않습니다. 루프를 돌리면 기존 코드, 문서, 검증 절차, 비용 예산의 장단점이 그대로 커집니다.

품질 관리

  • 코드베이스와 문서를 깨끗하게 유지
  • 검증 절차를 Skill·체크리스트로 기록
  • 최신 공식 문서를 바로 찾도록 연결
  • 작성 에이전트와 리뷰 에이전트 분리

토큰 관리

  • 작업에 맞는 루프와 모델 선택
  • 성공 조건과 멈춤 조건을 구체적으로 설정
  • 큰 실행 전에 작은 범위로 시험
  • 결과가 정해진 반복 작업은 스크립트로 처리
1
검증은 분리합니다
작업한 에이전트가 직접 합격 여부를 판정하면 평가가 후해집니다. 작성자와 검토자를 분리하고, 가능하면 별도의 채점 루브릭을 둡니다.
2
실패를 시스템에 반영합니다
한 번 수정하고 끝내지 않습니다. 같은 문제가 다음 회차에 반복되지 않도록 규칙, Skill, 체크리스트에 반영합니다.
3
사용량을 봅니다
/usage, /goal, /workflows 같은 명령으로 Skill, 서브에이전트, MCP별 비용을 확인합니다.
실행법

/goal, /loop, /schedule을 구분해서 씁니다

목표가 분명하면 /goal을 씁니다. 로컬 컴퓨터에서 주기적으로 확인하려면 /loop을 씁니다. 클라우드에서 정해진 시각에 실행하려면 /schedule 또는 Routines를 씁니다. Proactive 루프는 여기에 동적 워크플로우와 자동 모드를 추가해 구성합니다.

1
완료 기준이 있으면 /goal
점수, 테스트 통과, 체크리스트처럼 완료를 판정할 수 있는 작업에 씁니다.
2
정해진 간격으로 확인하면 /loop
로컬 컴퓨터에서 PR, 리뷰, CI처럼 외부 상태가 바뀌는 작업을 주기적으로 확인합니다.
3
클라우드에서 실행하면 /schedule 또는 Routines
컴퓨터가 꺼져 있어도 정해진 시각에 실행해야 하는 작업은 클라우드 예약으로 옮깁니다.
클라우드로 옮기면 Routines입니다

/loop은 지금 켜 둔 컴퓨터에서 실행되므로 컴퓨터가 꺼지면 멈춥니다. 사람이 없어도 정해진 시각에 클라우드에서 실행하려면 Routines 예약 실행으로 옮깁니다.

루프 엔지니어링의 출발점

“As big as the step from source code to agents was, loops are just as important and as big a step.”

소스 코드에서 에이전트로 넘어간 것이 큰 도약이었던 만큼, 루프도 그만큼 중요하고 큰 도약입니다. 그는 이제 프롬프트를 직접 쓰지 않고, 루프가 Claude에게 작업을 지시하게 한다고 말합니다. 이 페이지가 다루는 루프 엔지니어링은 이 발언에서 출발했습니다.

보리스 체니 (Boris Cherny) Creator & Head of Claude Code, Anthropic (2026년 6월 19일) 출처 →
/goal 실습

지시가 아니라 목표를 선언합니다

일반적인 지시는 "이것을 해 주세요"입니다. Claude·Codex가 답을 한 번 내놓으면 작업이 끝납니다. /goal은 종료 기준 자체를 바꿉니다. 목표를 선언하면 Claude·Codex는 "답을 다 했습니다"가 아니라 "조건이 달성됐습니다"를 종료 기준으로 삼습니다. 멈추려 할 때마다 목표 달성 여부를 검사받으므로 중간에 멈추지 않고 끝까지 진행합니다.

지시: 한 번 답하면 끝

"보고서 초안 주세요"
  • 초안 하나를 내놓으면 작업 종료
  • 품질이 기준에 맞는지는 확인하지 않음
  • 부족하면 사람이 다시 지시해야 함

목표 선언: 조건 달성까지

"이번 분기 시장 조사 자료를 임원 보고 수준으로 정리하라"
  • 멈추려 할 때마다 달성 여부를 검사받음
  • 미달이면 스스로 다음 작업을 이어감
  • 사람은 목표와 최종 판정만 맡음
한 문장으로

/goal은 "무엇을 해라"가 아니라 "어떤 상태가 되면 완료로 인정하겠다"를 정하는 명령입니다. 작업 단위가 답변 한 개에서 목표 달성으로 바뀝니다.

Claude Code와 Codex에서 /goal을 활용해 봅니다

이 실습에서는 목표 문장 하나를 다듬습니다

1
Claude Code나 Codex를 열고 /goal을 입력합니다

슬래시 명령창에 /goal을 입력하고 목표 문장을 적습니다. 두 도구의 명령 이름은 같고, Codex에서는 /goal pause, resume, clear로 일시 정지, 재개, 해제합니다. /goal은 Codex에 2026년 4월 30일(v0.128.0), Claude Code에 5월 11일(v2.1.139) 추가됐습니다. Codex에서는 실험 기능으로 시작해 5월 21일(v0.133.0)부터 기본으로 켜졌습니다. 설치하지 않았다면 바이브 코딩 101에서 먼저 설치합니다.

2
목표 문장을 검증 가능하게 적습니다

좋은 목표 문장의 조건은 세 가지입니다. 완료 검증 가능(완료 여부를 기계적으로 판정), 품질 기준 명시(어느 수준이면 합격인지), 범위 명시(어디까지 수정해도 되는지).

3
중간 보고를 받습니다

문제를 모두 찾은 시점, 수정 계획을 세운 시점처럼 방향을 점검할 지점에서 보고하게 합니다. 진행 중에도 사람이 개입할 지점을 미리 정해 둡니다.

4
최종 승인은 사람이 합니다

목표 달성 보고가 오면 결과를 직접 확인하고 판정합니다. 실행은 맡기되 판단은 사람이 하는 것이 /goal 사용의 기본 원칙입니다.

나쁜 목표 문장

"이 자료 좀 더 좋게 만들어줘"
  • "좋게"가 무엇인지 판정할 수 없음
  • 품질 기준이 없어 어디서든 멈출 수 있음
  • 범위가 없어 관계없는 파일까지 수정할 수 있음

좋은 목표 문장

"이 폴더의 시장 조사 자료를 임원 보고 수준으로 정리하라. 수치마다 출처가 있고, 오탈자와 깨진 링크가 0건이면 완료다. 이 폴더 밖은 건드리지 마라"
  • 완료 조건을 기계적으로 판정 가능
  • 품질 기준이 숫자로 명시됨
  • 수정 범위가 분명함
완료 판정 체크리스트
  • 완료 조건을 항목별로 대조했다. 하나라도 미달이면 완료가 아니다
  • 수정된 파일이 목표에 명시한 범위 안에 있다
  • 수치와 출처는 보고에 의존하지 않고 원본에서 확인했다
  • 발송, 배포, 결제 등 되돌릴 수 없는 동작은 사람 승인을 거쳤다

복사해서 바로 쓰는 /goal 템플릿

목표, 완료 조건, 범위는 두 도구가 같고 진행 방식만 다릅니다

Codex 템플릿에 나오는 explorer와 worker는 내장 역할이라 따로 만들 필요가 없습니다. 그 밖의 역할이 필요할 때만 ~/.codex/agents/에 정의합니다.

Claude Code 템플릿
/goal (달성할 목표를 한 줄로 적는다)
  예) 이 폴더의 시장 조사 자료를 임원 보고 수준으로 정리하라

# 완료 조건 (모두 충족해야 완료다)
  · 모든 수치에 출처가 달려 있다
  · 오탈자와 깨진 링크가 0건이다
  · 페이지마다 핵심 메시지가 첫 화면에 보인다

# 범위
  · 이 폴더 안의 파일만 수정한다. 다른 폴더는 건드리지 않는다

# 진행 방식
  · 이 작업에 맞는 동적 워크플로우를 직접 설계해 실행하라
  · 한 에이전트로 충분한 단계는 나누지 마라. 나누는 단계는 검증과 독립된 조사처럼 짧은 결과만 돌려받는 작업으로 한정하라
  · 검수는 관점별로 나눠 병렬로 실행하고, 수정본은 수정하지 않은 에이전트가 적대적으로 검증하게 하라
  · 문제를 모두 찾으면 통합 보고를 먼저 하고, 수정은 승인 후 진행하라
Codex 템플릿 · 사전 준비 없음
/goal (달성할 목표를 한 줄로 적는다)
  예) 이 폴더의 시장 조사 자료를 임원 보고 수준으로 정리하라

# 완료 조건 (모두 충족해야 완료다)
  · 모든 수치에 출처가 달려 있다
  · 오탈자와 깨진 링크가 0건이다
  · 페이지마다 핵심 메시지가 첫 화면에 보인다

# 범위
  · 이 폴더 안의 파일만 수정한다. 다른 폴더는 건드리지 않는다

# 진행 방식 (배치를 직접 지정한다)
  · 에이전트는 아래 단계에서만 실행하고, 그 밖의 작업은 메인 에이전트가 직접 처리하라
  · 검수는 explorer 에이전트를 관점별로 나눠 병렬로 실행하라
  · 수정은 worker 에이전트에 파일 단위로 맡겨라
  · 수정본은 수정을 맡지 않은 에이전트가 다시 검증하게 하라
  · 문제를 모두 찾으면 통합 보고를 먼저 하고, 수정은 승인 후 진행하라
FAQ

자주 묻는 질문

/goal을 처음 쓸 때 자주 나오는 질문

일반 대화와 무엇이 다릅니까?
일반 대화는 한 세션 안에서 묻고 답하면 끝납니다. /goal은 종료 조건을 정해 두고 그 조건을 달성할 때까지 실행과 검증을 반복합니다. 짧은 질문은 대화로 하고, 끝까지 완수해야 하는 큰 작업은 /goal로 맡깁니다.
진행 중에 멈추거나 방향을 바꿀 수 있습니까?
가능합니다. 목표 문장에 중간 보고 지점을 적어 두면 그 시점마다 사람이 진행 상황을 확인하고 방향을 조정할 수 있습니다. 보고 시점이 아니어도 언제든 직접 개입해 작업을 멈추거나 지시를 추가할 수 있습니다.
틀리면 누가 책임집니까?
사람입니다. /goal은 실행을 맡기는 기능이지 판단까지 맡기는 기능이 아닙니다. 그래서 중간 보고 지점과 최종 승인 단계를 목표 문장에 미리 적어 둡니다. 사람의 최종 판정 없이는 결과를 내보내지 않는 것이 원칙입니다.
어디까지 맡겨도 됩니까?
되돌릴 수 있는 일은 넓게, 되돌릴 수 없는 일은 좁게 맡깁니다. 문서 작성, 코드 수정, 분석처럼 결과를 검토하고 되돌릴 수 있는 작업은 끝까지 맡겨도 됩니다. 발송, 배포, 결제처럼 되돌리기 어려운 동작은 반드시 사람의 승인을 거칩니다.
참고 자료

루프 엔지니어링

루프는 실행, 관찰, 수정을 반복하는 구조입니다. 사람이 없어도 정해진 시각에 무인으로 실행하는 다음 단계는 Routines입니다.