Skip to content
BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
references
references
 
 
templates
templates
 
 
.gitignore
.gitignore
 
 
CHANGELOG.md
CHANGELOG.md
 
 
LICENSE
LICENSE
 
 
README.md
README.md
 
 
SKILL.md
SKILL.md
 
 

Repository files navigation

Hermes ULW — oh-my-openagent Ultrawork 가이드

ULW = Ultrawork. 한 단어로 모든 에이전트를 활성화하고, 끝날 때까지 멈추지 않는 워크플로우. Hermes Agent와 함께 쓸 때 자동으로 트리거됩니다.

🍔 한 줄 요약

"ulw <task> 한 마디 입력하면, AI 팀이 알아서 다 끝내준다"

음식으로 비유하면:

  • 🍱 단순 주문 = 그냥 프롬프트 — 셰프 한 명이 요리 하나
  • 🍽️ 코스 요리 = @plan → /start-work — 기획 → 실행 분업
  • 🍱🍱🍱 뷔페 동시 = ulw — 11명 셰프 브리가드 동시 활성화
  • ♾️ 끝까지 = ulw-loop — 다 끝내야 퇴근 (Todo Enforcer가 다시 데려옴)

🧠 핵심 개념 (1분)

ULW란?

oh-my-openagent (omo) 플러그인이 OpenCode에 추가하는 키워드 기능. ulw 또는 ultrawork 단어를 프롬프트에 붙이면:

  1. 모든 에이전트가 활성화 — 11개 에이전트가 한꺼번에 깨어남
  2. 다 끝날 때까지 안 멈춤 — ulw-loop가 100% 완료까지 반복
  3. 다 같이 일함 — 기획(Prometheus), 실행(Atlas), 검증(Momus), 워커(Sisyphus 등)

OMO 공식 표현: "One word. Every agent activates. Doesn't stop until done."

ULW는 OpenCode 전용 기능입니다. Codex, Claude Code, 그 외 CLI에서는 동작하지 않아요. "이미 Codex 쓰는데 ulw 키워드 비슷하게 쓰고 싶다면" → Hermes의 ulw-routing-in-hermes 스킬 (software-development 카테고리) 참고.

왜 Hermes Agent 스킬인가?

이 hermes-ulw 스킬은 사용자가 Hermes 대화에서 ulw 키워드를 쓰면 자동으로 로드되어, OpenCode + omo 셋업 방법을 안내하고, omo가 자동으로 처리할 수 있도록 도와줍니다. 그냥 자연스러운 대화 흐름 안에서 작업할 수 있어요.

ULW vs 그냥 코딩 도구

그냥 코딩 도구 ULW (oh-my-openagent)
한 가지 일 ✅ ✅
여러 단계 + 검증 사람 손 필요 에이전트 팀이 자동
"다 끝내" 보장 ❌ ✅ (ulw-loop)
백엔드 다양 OpenCode + 11개 에이전트

📦 설치

1단계: oh-my-openagent 설치

bunx oh-my-openagent install

2단계: OpenCode 인증

OpenCode 안에서 /connect (slash command) → 본인이 쓰는 provider 선택:

  • Anthropic (Claude)
  • OpenAI (GPT)
  • Gemini
  • Z.ai (GLM)
  • OpenCode Zen
  • 기타 OpenAI 호환 endpoint

3단계: Hermes에 hermes-ulw 스킬 설치

이 저장소의 SKILL.md를 Hermes가 알면, 사용자가 ulw 키워드를 쓸 때마다 자동 로드됩니다.

옵션 A: 로컬 설치 (Hermes가 자동 인식)

# 1. 저장소 클론 (또는 다운로드)
git clone https://github.com/sigco3111/hermes-ulw.git /tmp/hermes-ulw

# 2. SKILL.md (그리고 선택적으로 references/) 복사
mkdir -p ~/.hermes/skills/autonomous-ai-agents/hermes-ulw
cp /tmp/hermes-ulw/SKILL.md ~/.hermes/skills/autonomous-ai-agents/hermes-ulw/SKILL.md
cp -r /tmp/hermes-ulw/references ~/.hermes/skills/autonomous-ai-agents/hermes-ulw/
cp -r /tmp/hermes-ulw/templates ~/.hermes/skills/autonomous-ai-agents/hermes-ulw/

# 3. 새 Hermes 세션 시작 (skill loader는 세션 시작 시 캐시됨)

💡 autonomous-ai-agents/ 카테고리에 설치하는 이유는 다른 코딩 에이전트 스킬(claude-code, codex, opencode)과 같은 위치이기 때문입니다.

옵션 B: Hermes에게 시키기 (자동 설치)

그냥 Hermes 세션에서:

"hermes-ulw 스킬 GitHub에서 설치해줘: https://github.com/sigco3111/hermes-ulw"

→ Hermes가 skill_manage 도구로 처리합니다 (URL 가져오기 → 등록).

4단계: 새 세션 시작

스킬 로더는 세션 시작 시 한 번 캐싱되므로, 새 Hermes 세션을 시작해야 새 스킬이 보입니다. 그 다음부터:

"ulw add JWT authentication to the API"

→ 시스템이 hermes-ulw 스킬을 자동 로드하고, OpenCode + omo에서 ulw 키워드를 사용하는 법을 안내·지원합니다.

🎯 사용법

🍱 단순한 일 (ulw 없이)

fix the typo in README.md

→ 그냥 일함. 셰프 한 명. ulw 키워드 안 붙여도 됨.

🍽️ 단발성 복잡 작업

ulw add JWT authentication to the API

→ ULW 모드. 다 끝낼 때까지 자동 진행. 정의된 Done 기준 충족하면 멈춤.

🍽️ 계획부터 (Prometheus 사용)

@plan refactor auth to use role-based access control

→ Prometheus(기획자)와 인터뷰 시작. .omo/plans/*.md 파일 생성됨. Momus(검증자)가 검토 → OKAY 시점에 종료.

/start-work

→ Atlas(지휘자)가 계획을 읽고 워커들에게 분배.

🍱🍱🍱 Team Mode (병렬 다중 에이전트)

# 먼저 설정 활성화
# oh-my-openagent.json에 "team_mode": true 추가

ulw audit the user service for security vulnerabilities

→ security-research 프로필 자동 활성화: 3 hunter + 2 PoC engineer 병렬.

👥 11개 에이전트 한눈에 보기

에이전트 역할 읽기/쓰기
Sisyphus 메인 워커 (ulw 기본 진입점) 둘 다
Hephaestus 자율 심층 워커 (AmpCode 스타일) 둘 다
Prometheus 기획자 (인터뷰 → .omo/plans/*.md) .md만
Momus 검증자 (OKAY / REJECT) 읽기만
Atlas 지휘자 (계획 읽고 위임) 둘 다
Metis 사전 컨설턴트 (모호함 잡기) 읽기만
Oracle 아키텍처 자문 읽기만
Sisyphus-Junior 작업 실행자 둘 다
Explore 코드베이스 패턴 검색 읽기만
Librarian 외부 문서/의존성 검색 읽기만
Multimodal-Looker 이미지/PDF 분석 읽기만

🎯 판단 가이드: 뭘 쓸까?

질문: 이건 어떤 일인가?

├─ 단순/즉시 (오타, 한 줄 수정) → 그냥 프롬프트
│
└─ 복잡한가?
   ├─ Yes, 그리고 어떻게 할지 정확히 알아 → @plan (Prometheus) → /start-work
   ├─ Yes, 그리고 알아서 해줬으면 → ulw (Sisyphus)
   └─ Yes, 깊은 추론 필요 → Hephaestus + ulw

빠른 추천 (90% 케이스):

  • 단발 복잡 → ulw <task>
  • 계획부터 → @plan <task> → /start-work
  • 다 끝내야 함 → ulw (자동)

🆘 자주 발생하는 문제

❓ "ulw"만 치면 모든 게 다 일어나나요?

→ 네. 모든 에이전트가 활성화되고, 정의된 Done 기준 충족까지 자동 진행. 단, 모호한 작업에는 무한 루프 가능 — 명확한 Done 기준 주세요.

❓ 비용이 무서워요

→ oh-my-openagent.json에 예산 한도:

{
  "ulw_loop": {
    "max_cost_usd": 2.0
  }
}

→ 단순 작업엔 ulw 안 붙이기 (셰프 한 명이 더 쌈).

❓ 작업 도중 멈추고 싶어요

pause    ← 잠시 멈춤
resume   ← 다시 시작
cancel   ← 완전히 중단

❓ 진행 상황 어디서 봐?

.omo/
├── plans/         ← Prometheus의 계획서
├── notepads/      ← 학습 노트
└── ulw-loop/      ← 반복 로그 + 감사 추적

❓ 같은 작업을 다시 시키면 똑같이 하나요?

→ 비슷하지만 결정적이지 않음. Wisdom Accumulation이 누적되어 더 똑똑해지지만, 100% 동일 결과 보장 ❌.

❓ Hermes 스킬이 자동 트리거 안 돼요

새 세션을 시작했는지 확인. 스킬 로더는 세션 시작 시 한 번 캐싱됩니다.

💰 비용 가이드

작업 종류 비용
단순 수정 $0.01~$0.10 (ulw 없이)
ulw 단발 복잡 작업 $0.50~$3.00
@plan + /start-work 큰 기능 $1.00~$10.00
Team Mode (보안 감사 등) $3.00~$15.00
다중 목표 ulw-loop $2.00~$20.00 (예산 캡 설정 권장)

💡 팁: max_cost_usd 항상 설정. 비용 줄이려면 가벼운 모델 활성화.

📦 더 깊이 들어가는 참고자료

🔐 보안

  1. API 키는 .env나 Keychain에만 (절대 깃허브 ❌)
  2. .omo/ 디렉토리는 로컬 (gitignore 권장)
  3. Team Mode는 opt-in — 기본 OFF
  4. prometheus-md-only 훅 유지 — Prometheus가 무분별하게 파일 쓰는 것 방지

🪪 License

MIT — 자세한 내용 LICENSE

About

ULW = Ultrawork. 한 단어로 모든 에이전트를 활성화하고, 끝날 때까지 멈추지 않는 워크플로우.

Resources

Readme
MIT license
Activity

Stars

2 stars

Watchers

0 watching

Forks

1 fork
Report repository

Releases

Packages

Contributors