/moai goal

완료 조건을 선언하면 세션이 그 조건을 충족할 때까지 스스로 일하는 조건 선언형 자율 루프 명령어입니다. /moai goal "<조건>"으로 완료 조건을 arm하면, 매 턴 종료 시 stop-goal Stop 훅이 조건 충족 여부를 평가하여 충족될 때까지 다음 턴을 자동으로 시작합니다.

정보

한 줄 요약: /moai goal은 “끝 상태를 선언하는 범용 루프” 입니다. /moai loop가 “진단 도구가 찾은 문제를 다 없앨 때까지"라는 조건이 미리 정해진 프리셋이라면, /moai goal은 완료 조건을 직접 선언하는 범용 엔진입니다.

정보

프로그래매틱 명령어: 네이티브 Claude Code /goal은 사용자만 입력할 수 있는 (HUMAN-ONLY) TUI 커맨드입니다. /moai goal은 같은 동작을 파이프라인 안에서 프로그래매틱하게 다시 구현한 MoAI 소유 명령어로, moai 스킬 라우팅과 moai goal CLI로 진입합니다.

정보

이 페이지는 /moai goal의 명령어 레퍼런스 (동사·플래그·안전 불변식)를 다룹니다. 조건 선언형 루프의 개념·설계·진행 모드 이야기는 워크플로우 — /moai goal 페이지에 있습니다. 두 페이지는 역할이 다릅니다 — 이쪽은 “어떤 동사와 플래그가 있는지”, 저쪽은 “언제 쓰고 왜 효과적인지"를 다룹니다.

에이전트에게 “이 조건이 만족될 때까지 알아서 계속 일해줘"라고 시키고 싶을 때 씁니다. 조건은 두 종류를 섞어 쓸 수 있습니다.

• 기계적 조건 (mechanical): 셸 명령어로 판정하는 조건. 예를 들어 go test ./... exits 0이라면, 명령을 돌려 보고 종료 코드를 확인합니다.
• 모델 평가 조건 (model-evaluated): 트랜스크립트를 읽고 판단하는 조건. 예를 들어 모든 AC 행이 PASS로 기록됨이라면, 세션이 지금까지 남긴 내용을 근거로 판정합니다.

이 루프가 v3의 세 가지 핵심 중 하나인 에이전틱 루프 엔지니어링의 범용 엔진입니다. goal 상태는 .moai/state/goal/<session-id>.json에 세션별로 저장되며 (공유 파일이 아닙니다), 턴 상한 (기본 30) 이 루프가 무한정 돌지 않게 막습니다. 상한에 닿으면 평가기가 5-섹션 판정 (Claim / Evidence / Baseline-attribution / Gaps / Residual-risk) 을 내고 블로킹을 멈춥니다. --max-turns 0을 주면 오토컴팩트 경계를 넘어 유지되는 무한 goal이 도는데, 턴 수 대신 --max-duration (실행 시간) 과 정체 가드가 실제 상한이 된다. 실제 상한 없이 --max-turns 0만 arm하면 arm 시점에 거부된다 (fail-closed).

조건 텍스트를 등록하고 활성 세션에 goal을 arm합니다. 조건은 conditions[] 배열로 파싱되는데, 셸 명령 문자열만 있으면 기계적 조건이고 트랜스크립트를 가리키는 주장이면 모델 조건입니다. arm하면 .moai/state/goal/<session-id>.json이 원자적으로 (temp+rename) 기록되고, stop-goal Stop 훅이 다음 턴이 끝날 때 이를 집어 평가를 시작합니다.

> /moai goal "go test ./... exits 0; 모든 AC가 PASS로 기록, 또는 30턴 후 중단"

활성 세션의 goal (또는 --all로 모든 세션의 goal) 을 출력합니다. 조건 텍스트, conditions 배열, 쓴 턴 수와 상한, 진행 로그, 라이프사이클 상태 (armed / satisfied / ceiling-exit / cleared) 를 보여 줍니다.

활성 세션의 goal을 해제합니다 (상태 파일 삭제). Stop 훅은 arm된 goal이 없음을 보고 블로킹을 멈춥니다. 오케스트레이터가 모델 조건을 충족했다고 판정해 루프를 끝낼 때 씁니다.

정보

resume 동사는 없습니다. 한때 이야기되던 resume (해제한 goal을 아카이브에서 되살리는 동사) 은 지금 CLI에 들어 있지 않습니다. moai goal --help도 arm / status / clear만 보여 줍니다. clear가 상태 파일을 아카이브로 남기지 않고 아예 삭제하기 때문에, 되살릴 원본 자체가 없습니다.

오케스트레이터가 구현 착수 승인 (plan→run 경계의 AskUserQuestion) 을 물을 때, 승인이냐 거절이냐와는 별개의 선택지로 자율이냐 반자율이냐 하는 진행 모드를 함께 고르게 합니다. 고른 모드는 goal 상태의 progression_mode 필드에 저장됩니다 (따로 고르지 않으면 기본값은 autonomous입니다).

주의

승인은 두 모드 모두에서 반드시 거칩니다. 진행 모드 선택은 게이트를 통과한 다음에 무엇을 할지 정할 뿐, 게이트를 비켜 가지도 구현 착수 승인을 느슨하게 만들지도 않습니다. arm된 goal은 어떤 모드에서도 run-phase 진입을 승인하거나, PR을 만들거나, 되돌릴 수 없는 작업을 하지 않습니다.

1. 구현 착수 승인은 두 모드 모두 필수 — 진행 모드는 승인 이후의 진행 선택이지 게이트 완화가 아니며, 점수와 무관하게 유지됩니다.
2. arm된 goal은 게이트를 우회하지 않음 — PR을 자동 생성하지 않고, 파괴적 작업을 수행하지 않습니다. 평가기는 턴을 계속할지 여부만 결정하며, 되돌릴 수 없는 작업을 사전 승인하지 않습니다.
3. stop-goal 훅은 AskUserQuestion을 호출하지 않음 — 구조화 JSON만 방출합니다 (훅·서브에이전트 경계).
4. 정체 가드 (stagnation guard) — N회 연속 무진전 반복이 감지되면 루프를 멈추고 E1/E3 에스컬레이션 노트를 담은 5-섹션 판정을 냅니다.

평가기는 턴이 끝날 때마다 돌아갑니다. 전체 스위트 대신 go test -run <pattern>을, 오래 걸리는 명령 대신 결과가 일정한 명령을 쓰세요. stop-goal의 Stop 훅 타임아웃이 120초이긴 하지만, 명령이 빨라야 턴이 촘촘하게 돌아갑니다.

/moai loop는 goal 엔진 위의 프리셋입니다. /moai goal이 사용자가 완료 조건을 직접 선언하는 범용 루프라면, /moai loop는 “진단 도구가 찾은 이슈 큐를 다 비울 때까지"라는 조건을 미리 채워 넣은 프리셋입니다.

끝 상태를 조건식으로 표현할 수 있다면 /moai goal, “도구가 찾는 문제를 전부 없애줘"라면 /moai loop가 맞습니다.

• /moai goal (워크플로우) - 조건 선언형 루프 개념과 설계
• /moai loop - 반복 수정 루프
• /moai fix - 일회성 자동 수정
• /moai - 완전 자율 자동화