Loop Goal Runner은(는) 무엇을 하나요?
이 스킬을 사용하여 열린 Codex 작업을 작은 상태 기반 루프로 전환하세요. 루프는 명확한 목표, 지속 가능한 상태, 객관적인 게이트, 그리고 중지 규칙을 가져야 합니다. 기본 경로는 가볍게 유지하고, 작업이 추가 비용을 정당화할 때만 서브 에이전트나 워크트리를 추가하세요.
핵심 계약
모든 루프 실행은 다음 네 가지 아티팩트 또는 결정을 유지해야 합니다:
- 목표(Goal): 현재 사용자 목표와 완료 기준.
- 상태(State): 지속 가능한
STATE.md파일 또는 명시적으로 명명된 외부 상태 시스템. - 게이트(Gate): 테스트, 린트, 타입 검사, 빌드, 데이터 유효성 검사, 스크린샷 검사 또는 기타 객관적인 증명 명령.
- 중지 규칙(Stop rule): 성공, 차단, 최대 시도 횟수, 최대 런타임, 예산 한도 또는 인간 승인 경계.
새로운 검증 증거 없이 완료를 주장하지 마십시오. 객관적인 게이트가 없으면 작업을 조언/수동 모드로 유지하고 이것이 좋은 루프 후보가 아니라고 말하세요.
워크플로우
1. 루프 적합성 검사 실행
루프를 구축하거나 계속하기 전에 작업이 적합한지 확인하세요:
- 최소한 매주 반복되거나, 지속적인 상태가 중요할 만큰 길이가 깁니다.
- 잘못된 출력을 거부할 수 있는 객관적인 게이트가 있습니다.
- 사용 가능한 환경에서 실행될 수 있습니다.
- 하드 중지 조건이 있습니다.
- 아키텍처, 인증, 결제, 프로덕션 배포 또는 되돌릴 수 없는 작업에 대한 감독되지 않은 판단이 필요하지 않습니다.
이 중 하나라도 실패하면 실패 조건을 설명하고 사용자가 명시적으로 진행을 요청하지 않는 한 일반적인 원샷 워크플로우를 사용하세요.
2. 상태 찾기 또는 생성
기본적으로 상태를 목표 범위로 취급하세요. 고유한 목표는 각각 고유한 지속 상태 파일을 가져야 합니다. 단, 사용자가 기존 상태 파일을 재사용하도록 명시적으로 요청하거나 기존 파일이 동일한 활성 목표에 명확하게 속하는 경우는 예외입니다.
상태 파일 경로 우선 순위:
- 사용자가 지정한 정확한 상태 파일 경로(있는 경우)를 사용합니다.
- 기존 목표를 계속 진행 중이고 이전 상태 경로를 알고 있는 경우 동일한 파일을 재사용합니다.
- 목표가 하나의 작업 리포지토리 또는 아티팩트 디렉토리를 생성하거나 주로 수정하는 경우 해당 작업 루트의
STATE.md를 사용합니다. - 그렇지 않으면 현재 워크스페이스의
.codex/goals/<goal-slug>/STATE.md아래에 목표별 파일을 생성합니다. - 워크스페이스 자체가 목표이거나 사용자가 명시적으로 선택한 경우에만 워크스페이스 루트
STATE.md를 사용합니다.
기존 STATE.md를 재사용하기 전에 해당 파일의 Goal 및 Current Status 섹션을 검사하세요. 다른 목적을 설명하는 경우 덮어쓰거나 용도를 변경하지 마십시오. 대신 새로운 목표 범위 상태 파일을 생성하고 그 분리에 대해 간략히 언급하세요.
선택한 상태 파일이 존재하지 않고 파일 편집이 허용되는 경우 references/state-template.md에서 생성하세요. 편집이 허용되지 않는 경우 응답에 초기 상태 초안을 작성하고 사용자에게 배치를 요청하세요.
모든 루프 실행 시작 시:
- 계획을 세우기 전에 선택한 목표 범위 상태 파일을 읽습니다.
- 사용 가능한 가장 가까운
AGENTS.md또는 이에 상응하는 프로젝트 지침을 읽습니다. - 마지막 실행, 현재 상태, 열린 차단기, 다음 작업, 검증 기록, 교훈 및 상태 파일 경로를 추출합니다.
모든 루프 실행 종료 시:
- 선택한 목표 범위 상태 파일만 실제 수행된 작업으로 업데이트합니다.
- 검증 명령과 결과를 기록합니다.
- 다음 작업 또는 중지 이유를 기록합니다.
- 압축이나 향후 실행에서 살아남아야 할 교훈을 보존합니다.
- 사용자가 명시적으로 요청하지 않는 한 관련 없는 목표의 상태를 이동, 보관 또는 다시 작성하지 마십시오.
3. 목표 구체화
Codex Goal 모드의 경우 목표를 측정 가능하게 작성하세요:
/goal <목적>. 완료 조건: <객관적인 게이트 통과>. 제약 조건: 각 실행 시 선택한 목표 범위 상태 파일을 업데이트합니다. <N>회 실패 시 또는 인간의 판단이 필요할 때 중지합니다.
목표가 이미 활성화된 경우 사용자가 변경하지 않는 한 현재 목표를 진실의 원천으로 사용하세요. 활성화된 목표가 없으면 사용자 요청에서 작업 목표를 추론하여 간략히 명시하세요.
4. 하나의 루프 반복 실행
다음 반복 형태를 사용하세요:
- 상태 및 지침을 읽습니다.
- 다음으로 가장 작은 유용한 작업을 선택합니다.
- 작업을 실행합니다.
- 관련 게이트를 실행하거나 실행할 수 없는 이유를 설명합니다.
- diff 또는 출력을 검토합니다.
- 선택한 목표 범위 상태 파일을 업데이트합니다.
- 계속, 중지 또는 에스컬레이션을 결정합니다.
변경 범위를 좁게 유지하세요. 자동화를 예약하기 전에 하나의 신뢰할 수 있는 수동 실행을 선호하십시오.
5. 서브 에이전트 사용 여부 결정
기본값은 단일 에이전트입니다. 다음 중 하나 이상에 해당하는 경우에만 서브 에이전트를 사용하세요:
- 독립적인 조사를 병렬로 실행할 수 있습니다.
- 제작자/검사자 분할이 실질적으로 위험을 줄일 수 있습니다.
- 작업에 여러 관련 없는 실패, 하위 시스템 또는 문서가 있습니다.
- 사용자가 병렬 에이전트 또는 서브 에이전트를 명시적으로 요청합니다.
서브 에이전트를 사용할 때는 다음 패턴을 적용하세요:
- 제작자/검사자: 한 에이전트가 구현 또는 조사하고, 다른 에이전트가 사양 준수 및 코드 품질을 검토합니다.
- 병렬 디스패치: 독립적인 문제 영역당 하나의 에이전트.
- 검증자: 새로운 에이전트가 숨겨진 추론이 아닌 증거를 검토합니다.
서브 에이전트의 의견을 하드 게이트로 취급하지 마십시오. 객관적인 검증이 여전히 우선합니다.
6. 워크트리 사용 여부 결정
여러 에이전트 또는 장기 실행 브랜치가 동시에 쓸 수 있는 코드 변경 사항에 대해 워크트리를 사용하세요. 읽기 전용 연구, 문서 분석, 작은 단일 파일 편집 또는 비리포지토리 워크스페이스의 경우 워크트리를 건너뛰세요.
워크트리가 필요한 경우 사용 가능할 때 Codex 네이티브 워크트리 지원을 선호하세요. 그렇지 않으면 대상 리포지토리를 확인하고 워크트리 디렉토리가 실수로 커밋되지 않도록 확인한 후에만 Git 워크트리를 사용하세요.
7. 완료 및 에스컬레이션
다음 상황에서 명확하게 중지하고 보고하세요:
- 게이트가 통과되고 목표 기준이 충족되었습니다.
- 최대 시도 횟수, 런타임 또는 예산 한도에 도달했습니다.
- 필수 권한, 자격 증명, 외부 서비스 또는 인간의 판단이 필요합니다.
- 동일한 차단기가 세 번의 연속 루프 턴에 걸쳐 반복됩니다.
- 루프가 명시적인 인간 승인 없이 아키텍처, 인증, 결제, 프로덕션 배포, 비밀 또는 광범위한 권한을 건드려야 합니다.
최종 응답에는 현재 상태, 검증 증거 및 다음 권장 조치가 포함되어야 합니다.
트리거 신뢰성
스킬 트리거는 설명 기반입니다. 향후 Goal 모드 사용 시 이 스킬이 자동으로 실행되도록 하려면 references/agents-snippet.md의 스니펫을 전역 또는 프로젝트 AGENTS.md에 추가하세요.
참조
references/state-template.md: 새STATE.md파일용 템플릿.references/agents-snippet.md: 사용자가 목표를 시작하거나 논의할 때마다 Codex가 이 스킬을 호출하도록 하는 선택적 내구성 지침.