Skip to content

namojo/oh-my-harness

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 

Repository files navigation

oh-my-harness

Harness + OMC Integration — Harness가 만든 전문 에이전트를 OMC가 자동으로 발견하고 활용합니다.

English | 한국어


한국어

개요

oh-my-harness는 Harnessoh-my-claudecode (OMC)를 연결하는 통합 모듈입니다.

Harness는 프로젝트 도메인에 맞는 전문 에이전트 팀을 설계하고 생성하는 메타 스킬입니다.
OMC는 에이전트 오케스트레이션 시스템으로, ralph/autopilot/team 등의 워크플로우를 제공합니다.

oh-my-harness는 이 둘을 연결합니다:

/harness → 전문 에이전트 생성 → OMC가 자동 발견 → 더 높은 품질의 결과물

왜 필요한가?

Harness 없이 oh-my-harness 적용 후
에이전트 OMC 범용 에이전트 (executor, designer...) 프로젝트 도메인 전문 에이전트
역할 분담 범용적 커리큘럼 설계자, 퀴즈 엔진 개발자 등 역할 특화
도메인 지식 없음 에이전트에 도메인 컨텍스트 내장
품질 일반적 도메인 지식 반영된 고품질 구현

설치

사전 요구사항

설치 방법

# 1. 레포지토리 클론
git clone https://github.com/namojo/oh-my-harness.git

# 2. 설치 스크립트 실행
cd oh-my-harness
bash scripts/install.sh

# 3. Claude Code 재시작

사용 방법

Step 1: Harness로 에이전트 생성 (1회)

프로젝트 디렉토리에서:

/harness

"교육용 웹사이트를 만들고 싶어" 등 프로젝트를 설명하면 Harness가 도메인 전문 에이전트를 생성합니다:

.claude/agents/
├── curriculum-designer.md    # 커리큘럼 설계 전문가
├── quiz-engine-dev.md        # 퀴즈 엔진 개발자
├── lms-frontend.md           # LMS 프론트엔드 개발자
└── ...

.claude/skills/
└── edu-orchestrator/
    └── skill.md              # 교육 도메인 오케스트레이터

Step 2: 평소처럼 작업 지시

autopilot 교육용 사이트 만들어줘. 강의 목록, 퀴즈 기능, 수강 진도 추적 포함.

OMC가 자동으로:

  1. .claude/agents/ 스캔 → Harness 에이전트 발견
  2. 도메인 추론 ([domain: frontend], [domain: backend] 등)
  3. 태스크에 맞는 Harness 에이전트를 OMC 기본 에이전트보다 우선 선택
  4. ralph, autopilot, team 등 모든 워크플로우에서 동작

별도 설정 불필요

  • Zero-config: 설정 파일 변경 없음
  • /harness.claude/agents/에 파일만 만들면 OMC가 알아서 발견
  • CWD 기반 캐싱으로 성능 최적화

아키텍처

┌─────────────────────────────────────────────────────┐
│                   Claude Code                        │
│                                                      │
│  ┌──────────┐    ┌──────────────────┐   ┌─────────┐ │
│  │ Harness  │───>│ oh-my-harness    │<──│   OMC   │ │
│  │ (생성)   │    │ (발견 + 라우팅)  │   │ (실행)  │ │
│  └──────────┘    └──────────────────┘   └─────────┘ │
│       │                  │                    │      │
│       v                  v                    v      │
│  .claude/agents/    도메인 추론          ralph,      │
│  .claude/skills/    [domain: backend]   autopilot,   │
│                     시스템 프롬프트      team         │
└─────────────────────────────────────────────────────┘

핵심 기능

1. 자동 발견 (Auto-Discovery)

.claude/agents/*.md.claude/skills/*/skill.md를 자동 스캔하여 OMC 레지스트리에 병합

2. 도메인 추론 (Domain Inference)

에이전트의 description과 body에서 키워드를 추출하여 도메인을 자동 분류:

  • frontend, backend, ui-design, testing, security, devops, data, docs, orchestration
  • 한국어/영어 모두 지원

3. 스마트 라우팅 (Smart Routing)

시스템 프롬프트에 [domain: backend] 태그를 주입하여, 오케스트레이터 LLM이 도메인 매칭 에이전트를 우선 선택

4. 프로젝트 로컬 우선순위

Harness 에이전트가 OMC 기본 에이전트와 이름이 같으면 Harness 버전이 우선 (프로젝트별 커스터마이징)

제거

bash scripts/uninstall.sh

완전한 복원은 OMC를 재설치합니다:

/plugin install oh-my-claudecode

제한사항

  • Harness 에이전트는 PluginConfig['agents']를 통한 per-agent 모델 오버라이드 불가 (v1 제한)
  • 도메인 추론은 키워드 기반 휴리스틱이므로 모호한 description에서 부정확할 수 있음
  • 첫 번째 delegation 호출 시 파일시스템 I/O 발생 (이후 캐싱)

관련 프로젝트

  • oh-my-claudecode — 에이전트 오케스트레이션 시스템
  • harness — 에이전트 팀 설계 메타 스킬

English

Overview

oh-my-harness integrates Harness with oh-my-claudecode (OMC), enabling OMC to automatically discover and leverage Harness-generated domain-specific agents.

/harness → Generate expert agents → OMC auto-discovers → Higher quality results

Installation

# Prerequisites: Claude Code + OMC plugin + Harness plugin installed

git clone https://github.com/namojo/oh-my-harness.git
cd oh-my-harness
bash scripts/install.sh
# Restart Claude Code

Usage

# Step 1: Generate domain agents (once per project)
/harness

# Step 2: Use OMC as usual — Harness agents are auto-discovered
autopilot build me an educational website with courses, quizzes, and progress tracking

How It Works

  1. Auto-Discovery: Scans .claude/agents/*.md and .claude/skills/*/skill.md, merges into OMC registry
  2. Domain Inference: Extracts keywords from agent descriptions to classify domains (frontend, backend, security, etc.)
  3. Smart Routing: Injects [domain: ...] tags into the system prompt so the orchestrator LLM prefers domain-matched agents
  4. Project-Local Priority: Harness agents override OMC defaults when names collide

Uninstall

bash scripts/uninstall.sh
# Or fully restore: /plugin install oh-my-claudecode

License

MIT

Credits

About

Harness + OMC Integration — Auto-discover Harness-generated agents in oh-my-claudecode

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors