튜토리얼 24: 지속적인 목표

이 글은 Hermes Agent 공식 튜토리얼 시리즈의 일부입니다. 전체 튜토리얼 보기

복잡한 요리를 하고 있는데 보조 셰프에게 이렇게 말한다고 상상해 보세요. “준비 재료가 가득 찰 때까지 야채 썰어 줘.” 당근 하나 썰 때마다 매번 다시 말하지 않죠 — 일이 끝날 때까지 계속하리라 믿는 겁니다. 지속 목표(Persistent Goals) 는 Hermes에게 바로 그 “끝날 때까지 계속하기” 초능력을 부여합니다.

/goal은 무엇을 하나요?

평소에는 Hermes에게 작업을 주면 응답하고 나서 멈춥니다 — 다음 지시를 기다리는 거죠. /goal을 사용하면 Hermes에게 턴을 넘어서도 유지되는 상시 목표를 부여합니다. 각 응답 후에는 가벼운 “심사” 모델이 확인합니다: “목표가 아직 끝났나?” 끝나지 않았다면 Hermes는 자동으로 계속 프롬프트를 스스로 주입하고 계속 작업합니다 — 여러분이 재촉할 필요가 전혀 없습니다. 목표가 달성되거나, 일시 중지하거나, 취소하거나, 턴 예산이 소진될 때까지 반복합니다.

이 기능은 Codex CLI의 유사한 기능에서 영감을 받았으며, “계속해”라고 세 번이나 말해야 하는 작업에 완벽합니다.

1단계: 언제 사용해야 할까요?

다시 프롬프트하지 않고 Hermes가 스스로 반복 작업하길 원할 때 /goal을 사용하세요. 좋은 예시:

• /goal src/의 모든 린트 에러를 수정하고 ruff check가 통과하는지 확인해 줘
• /goal repo Y에서 기능 X를 테스트 포함해서 포팅하고 CI를 통과시켜 줘
• /goal 세션 ID가 실행 중간 압축 시 가끔 어긋나는 이유를 조사하고 보고서를 작성해 줘
• /goal EXIF 날짜로 파일 이름을 바꾸는 작은 CLI를 만들고 photos/ 폴더에서 테스트해 줘

작업이 한 턴이면 충분하다면 /goal은 건너뛰세요. 계속 붙잡고 있어야 하는 상황에서 이 기능이 빛을 발합니다.

2단계: /goal과 칸반의 차이 이해하기

흔히 혼동하는 부분이니 간단히 정리할게요:

• /goal은 단일 세션입니다. 이 대화 하나 안에서 끝날 때까지 계속 작업합니다. 보드 카드를 만들지 않고, 다른 프로필에 작업을 할당하지 않으며, 분산되지 않습니다.
• 칸반은 많은 작업의 보드입니다. 각 카드는 자체 세션을 가진 별도의 워커 프로세스를 갖습니다. 카드, 의존성, 담당자, 핸드오프는 모두 보드에 있습니다.

겹치는 부분은 작지만 의도적입니다: --goal로 생성된 칸반 카드는 동일한 연속 엔진을 사용하지만, 그 카드의 세션 안에서만 — 엔진을 빌려 쓰는 것이지 보드를 쓰는 게 아닙니다.

원하는 것	사용할 것
이 채팅에서 하나의 작업을 끝날 때까지 계속 반복	/goal <텍스트>
의존성이 있는 여러 독립 작업	hermes kanban create …
수락 기준이 충족될 때까지 계속 반복하는 보드 카드 하나	--goal이 있는 칸반 카드

기억하세요: /goal은 보드를 건드리지 않으며, 목표를 일시 중지하거나 취소해도 카드가 움직이지 않습니다. 보드에서 작업을 원한다면 직접 거기에 넣으세요.

3단계: 첫 번째 목표 실행하기

빠른 시작 방법입니다:

/goal tests/hermes_cli/의 모든 실패 테스트를 수정하고 scripts/run_tests.sh가 해당 디렉토리에서 통과하는지 확인해 줘

이런 과정이 진행됩니다:

1. 목표 수락 — 확인 메시지가 표시됩니다: ⊙ 목표 설정됨 (20턴 예산): <목표>
2. 1턴 실행 — Hermes가 일반 메시지처럼 목표를 받고 작업을 시작합니다.
3. 심사 실행 — 해당 턴 후 심사 모델이 완료 또는 계속을 결정합니다.
4. 필요시 루프 실행 — 계속이면 다음이 표시됩니다: ↻ 목표를 향해 계속 (1/20): <심사 이유> — Hermes가 자동으로 다음 단계를 수행합니다.
5. 종료 — 결국 목표가 달성되거나, 일시 중지하거나, 취소하거나, 턴 예산이 소진됩니다.

4단계: 루프 관리하기

항상 여러분이 통제권을 쥐고 있습니다. 목표를 일시 중지하여 루프를 잠시 멈추거나, 취소하여 완전히 중단하거나, 그냥 완료까지 실행할 수 있습니다. 20턴 예산이 무한 루프를 방지하므로 Hermes가 영원히 도망갈 걱정은 없습니다.

요약

/goal은 “끝날 때까지 계속하기” 기능입니다. 여러 번의 반복이 필요한 단일 세션 작업 — 린트 수정, 기능 포팅, 조사, 작은 도구 만들기 — 에 완벽합니다. 여러 작업을 동시에 관리하는 용도는 아닙니다 (그건 칸반의 몫). 목표를 설정하고, 심사가 루프를 감시하게 두고, 일시 중지하거나 취소하거나 조정하고 싶을 때만 개입하세요.

다음 편: 튜토리얼 25 — 코드 실행: Python 스크립트로 배치 처리 작업하기.