🔷 09. 오케스트레이션 실전

@plan, /start-work, ulw를 언제 쓰는지 헷갈릴 때 보는 실전 운영 가이드입니다.

이 문서는 입문 이후 단계입니다. 처음이면 아래 2개를 먼저 읽고 오면 이해가 훨씬 빠릅니다.

• 04. Oh-My-OpenCode 개요
• 05. Oh-My-OpenCode 설치

빠르게 실행 (복붙)

@plan "auth 시스템 리팩터링"
/start-work
ulw fix flaky tests

flowchart TD
A[요청] --> B{복잡도/정밀도}
B -->|단순| C[just prompt]
B -->|복잡+빠름| D[ulw]
B -->|복잡+정밀| E[@plan]
E --> F[/start-work]

단계별 적용

1) 복잡도 먼저 판단

• 설명: 단순 작업은 일반 프롬프트, 복잡+빠른 진행은 ulw, 복잡+정밀은 @plan→/start-work를 선택합니다.
• 실행 예시: @plan "auth 시스템 리팩터링"

2) @plan 진입 방식 선택

• 설명: Tab으로 Prometheus 진입 또는 Sisyphus에서 @plan 호출 둘 다 동일한 플래닝 결과를 만듭니다.
• 실행 예시: /start-work

3) /start-work 재개 로직 이해

• 설명: boulder.json이 있으면 재개, 없으면 최신 plan으로 초기 실행됩니다.
• 실행 예시: ulw fix flaky tests

4) Hephaestus vs ulw 구분

• 설명: 깊은 추론/탐색 특화는 Hephaestus, 일반 고난도 실행은 ulw가 기본입니다.
• 실행 예시: ulw fix flaky tests

5) 문제 상황별 대응

• 설명: 계획 없음/재개 꼬임/에이전트 혼동은 troubleshooting 섹션 규칙으로 해결합니다.
• 실행 예시: ulw fix flaky tests

부록) 원문 코드 스니펫 (검수용, 초보자는 건너뛰기)

[Switch to Hephaestus]
"I need to understand how data flows through this entire system
and identify all the places where we might lose transactions.
Explore thoroughly before proposing fixes."

[Stay in Sisyphus]
"ulw refactor the user service to use the new repository pattern"
[Agent automatically:]
- Explores existing codebase patterns
- Implements the refactor
- Runs verification (tests, typecheck)
- Reports completion

마무리 체크

• 위 “빠르게 실행” 명령을 최소 1개 실행했다.
• 실패 시 “원문 실행 코드 확장”의 관련 코드를 사용해 재검증했다.
• 원본 항목 대조 인덱스에서 빠진 기능이 없는지 확인했다.

---

출처

• 원문(로컬): oh-my-opencode/docs/orchestration-guide.md
• 원문(GitHub): https://github.com/code-yeongyu/oh-my-opencode/blob/dev/docs/orchestration-guide.md