Hermes 데스크톱, oh-my-hermes와 함께.
워크플로를 고르면, 만들기 전에 먼저 확인합니다.
|
Hermes CLI, oh-my-hermes와 함께.
쓰던 터미널에서 같은 워크플로를.
|
Hermes 메신저 앱, oh-my-hermes와 함께.
스레드에서 요청하면 같은 스레드로 답합니다.
|
omh setup, 명령 하나로.
워크플로를 설치하고 Hermes에 연결합니다.
|
# oh-my-hermes
English |
한국어 |
日本語 |
中文
한 번 설치하세요. Hermes는 그대로 두고, 더 강한 운영층을 더하세요.
계획, 조사, 제작, 코딩 handoff, 운영, 프로젝트 기억을 명확한 증거 경계와 함께 제공합니다.
**oh-my-hermes**(OMH)는
[Hermes Agent](https://github.com/NousResearch/hermes-agent)의 평범한 요청을
알맞은 기능, 유용한 다음 단계, 그리고 실제로 일어난 일과 아직 일어나지 않은
일에 대한 정직한 상태로 바꿉니다. Hermes를 대체하거나 코딩 executor를 숨기지
않고, 이미 사용 중인 Hermes 작업 흐름을 강화합니다.
[Website](https://rlaope.github.io/oh-my-hermes/) ·
[Documentation](docs/README.md) ·
[Installation](docs/INSTALLATION.md) ·
[Capabilities](docs/CAPABILITIES.md) ·
[Capability Impact](docs/CAPABILITY_IMPACT.md) ·
[Agent Install](INSTALL_FOR_AGENTS.md) ·
[GitHub Pages site](site/index.html)
> [!NOTE]
> OMH는 Hermes를 자연어 표면으로 유지하고 명확한 증거 경계를 갖춘 전문 운영층을
> 추가합니다.
>
>
> 
>
>
>
> 
>
## 빠른 시작
**로컬 명령과 관리형 skill을 설치합니다:**
```sh
curl -fsSL https://raw.githubusercontent.com/rlaope/oh-my-hermes/main/install.sh | sh
omh setup
```
**Hermes skill tap 경로:**
```sh
hermes skills tap add rlaope/oh-my-hermes
hermes skills install rlaope/oh-my-hermes/skills/omh-routing --yes
```
**또는 Your AI Agent에게 요청합니다:**
```text
Hey Agent, Install this >> https://github.com/rlaope/oh-my-hermes <<
```
**업데이트와 상태 점검:**
```sh
omh update
omh doctor
```
`--full` 설치를 core로 되돌리는 것 같은 유지보수 경로는
[Installation](docs/INSTALLATION.md#reconciling-an-existing-full-install-back-to-core)에
있습니다.
## OMH가 더하는 것
OMH는 **103개**의 설치형 workflow skill을 사람이 이해하기 쉬운 6개 기능군으로
제공합니다.
그중 11개는 workflow engine입니다 - `deep-interview`, `loop`, `ralph`, `ralplan`, `team`, `ultragoal`, `ultraperf`, `ultraprocess`, `ultraqa`, `ultrawork`, `web-research` - 이들은 `ulw-` 라벨로 렌더링되어
상태 줄만 봐도 어떤 종류의 skill이 도는지 알 수 있습니다. 나머지 90개는 `omh-`를
붙입니다. canonical name은 어느 쪽도 바뀌지 않습니다.
| 기능군 | Hermes가 더 잘할 수 있는 일 |
| --- | --- |
| **계획과 결정** | 모호한 목표를 명확히 하고, 검토된 계획과 durable goal loop를 준비합니다. |
| **학습과 수집** | 출처 탐색, 논문 설명, 데이터 점검, 근거 기반 브리프를 준비합니다. |
| **자료와 시각물 제작** | 웹, 이미지, 문서, 발표 자료, PDF, 포스터를 형식별 품질 게이트와 함께 만듭니다. |
| **코딩 위임과 배포** | Codex, Claude Code, Hermes runtime 또는 선택한 executor에 전달할 명확한 handoff를 준비합니다. |
| **운영과 관찰** | 설정, 서비스 품질, 릴리스, 장애, 자동화, 세션, workflow learning을 점검합니다. |
| **지식 보존** | 검토된 프로젝트 기억을 만들고 외부 지식 시스템을 provider-neutral 경계로 연결합니다. |
전체 목록과 trigger, harness, 증거 규칙은
[Workflow Reference](docs/WORKFLOWS.md)에 있습니다.
**하이라이트**
| 기능 | 사용 방법 | 동작 |
| --- | --- | --- |
| 🧭 **명확화와 계획** | `ulw-interview` · `ulw-plan` · `omh-decide` | 모호한 요청을 명확한 목표, 제약, trade-off, 완료 기준, 그리고 그대로 전달할 수 있는 계획으로 바꿉니다. |
| ⚡ **레버리지를 활용한 실행** | `ulw-work` · `ulw-goal` · `ulw-team` · `ulw-loop` | 빠른 병렬 작업부터 지속적인 다단계 실행까지 확장하면서도 소유권, 체크포인트, 검증을 계속 볼 수 있게 유지합니다. |
| 🔬 **조사와 학습** | `ulw-research` · `omh-best-practice-research` · `omh-research-brief` | 최신성, 출처 품질, 아직 해소되지 않은 불확실성 경계를 함께 표시하며 근거 기반 증거를 찾고 종합합니다. |
| 🛠️ **안전한 코딩과 배포** | `ulw-process` · `omh-code-review` · `ulw-qa` | executor에 종속되지 않는 코딩 작업을 준비하고, review·QA·CI·merge에 대한 주장은 관측된 증거에만 근거하게 만듭니다. |
| 🎨 **완성도 높은 산출물 제작** | `omh-design-quality-gate` · `omh-materials-package` · `omh-deliverable-package` · `omh-image-cards` | 콘텐츠, 완성도, 접근성, 렌더링 품질 게이트를 기준으로 웹사이트, 시각 자료, 보고서, 발표 자료, 문서, PDF, 포스터, 패키지를 만듭니다. |
| 🧠 **기억과 운영** | `omh-memory-new` · `omh-memory-sync` · `omh-ops-observability-card` · `omh-doctor` | 프로젝트 기억을 검토 우선으로 유지하고, 운영 준비 상태를 보여주며, provider나 시스템 상태를 지어내지 않고 다음 복구 행동을 제시합니다. |
| 🔌 **경계를 숨기지 않는 연결** | `omh-toolbelt-readiness` · `omh-external-connector-readiness` · `omh-agent-board` | 작업이 의존하기 전에 필요한 도구·connector·agent 표면이 실제로 준비됐는지 확인하고, host 로드·도구 사용·외부 provider 접근을 각각 별도로 관측할 수 있게 유지합니다. |
## 실제 업무를 위한 설계
> **OMH (Oh-My-Hermes)** — 누구나 hermes-agent를 전문가처럼 쓸 수 있게 합니다.
> AI 에이전트를 위한 강력한 지능 하네스입니다.
**🧭 명령어 목록이 아닌, 더 똑똑한 라우터.** 영어, 한국어, 일본어, 중국어,
스페인어, 프랑스어, 독일어, 힌디어 요청을 번역 API 없이 로컬에서 분류합니다.
OMH는 추천 기능군, skill, 담당자, 다음 행동, 그리고 아직 증거가 아닌 부분을
함께 돌려줍니다.
**🤝 더 나은 코딩 handoff.** 저장소 제약, 합의된 범위, worktree 및
session-isolation 지침, 로컬에서 사용 가능한 skill, 완료 기준, review
기대치, verification gate를 담을 수 있습니다. Codex, Claude Code, Hermes,
generic executor는 모두 숨은 기본값이 아니라 명시적인 담당자로 남습니다.
**🎨 품질을 아는 제작.** Frontend, 접근성, 이미지, 보고서, 발표 자료, 문서,
스프레드시트, PDF, 포스터, 공유 패키지 요청은 전용 제작·QA 지침을 거칩니다.
준비된 브리프를 생성되었거나 시각적으로 검증된 산출물처럼 보여주지 않습니다.
**🔍 주장보다 증거.** OMH는 준비된 의도, 관측된 runtime 이벤트, 검증된
결과를 구분합니다. handoff는 executor가 실행했다거나 review가 통과했다거나
CI가 성공했다거나 배포가 끝났다거나 PR이 merge됐다는 주장 없이도 준비될 수
있습니다.
**🧠 검토 우선 프로젝트 기억.** OMH는 프로젝트 기억 후보를 승인된 기록과
분리해서 관리하고, 검토를 거쳐 준비된 맥락만 이후 handoff에 다시 불러옵니다.
불투명한 Hermes 내부 기억을 읽거나 바꿨다고 주장하지 않습니다.
**🔌 provider-neutral 운영.** metric, wiki, browser, image, video, connector
시스템은 명시적인 외부 provider 계약 뒤에 있습니다. 실제로 연결하거나
호출하지 않은 provider를 사용했다고 주장하지 않으면서 제공된 데이터를
검증하고 분석할 수 있습니다.
**🏛️ Hermes-native, executor-neutral 아키텍처.** Hermes는 여전히 채팅,
명확화, 계획, 조사, 상태 표면을 담당합니다. 선택된 executor가 구현을 맡고,
OMH는 그 작업을 둘러싼 로컬 계약, 라우팅, 기억, 품질 게이트, 증거 경계를
제공합니다.
**🧱 local-first 제어면.** OMH의 핵심 라우팅, catalog, manifest, 주장
규칙은 결정적인 로컬 표면입니다. 외부 호출과 provider 접근은 코어 내부에
숨겨진 동작이 아니라 명시적인 통합으로 남습니다.
## 주장보다 증거
| 상태 | 의미 |
| --- | --- |
| Prepared | route, plan, prompt, 산출물 계약 또는 handoff가 준비됐습니다. |
| Observed | wrapper 또는 runtime이 행동이나 결과가 발생했다고 기록했습니다. |
| Verified | 필요한 test, review, 실제 화면 검사 또는 다른 gate가 통과했습니다. |
`prepared_not_observed`는 실행, provider 접근, 산출물 생성, review, CI, 배포,
merge readiness 또는 merge가 아닙니다.
## 문서
- [문서 지도](docs/README.md)
- [설치와 업데이트](docs/INSTALLATION.md)
- [제품 방향과 경계](docs/DIRECTION.md)
- [아키텍처](docs/ARCHITECTURE.md)
- [기능 manifest](docs/CAPABILITIES.md)
- [Workflow reference](docs/WORKFLOWS.md)
- [역할](docs/ROLES.md)
- [활용 사례](docs/APPLICATION_CASES.md)
- [릴리스와 개발](docs/RELEASE.md)
## 개발
```sh
PYTHONPATH=tests uv run python -m unittest discover -s tests -v
uv run python -m compileall -q src tests
uv run python -m omh.cli docs workflows --check
git diff --check
```
OMH는 [Team Art & Engineering](https://rlaope.github.io/artengine-lab/)의
공개 프로젝트로 개발되고 있습니다. 프로젝트 소식은
[@rlaope](https://github.com/rlaope)에서 확인할 수 있습니다.