참고자료 · RevFactory

RevFactory Harness 플러그인

`revfactory/harness`는 실제로 존재하는 Claude Code 플러그인입니다. 저장소 원문 기준으로 보면, 이 플러그인은 프로젝트 도메인에 맞는 agent team과 skill 구성을 자동으로 설계하는 메타 스킬 성격을 가집니다. 즉, 개별 skill 하나를 제공하는 것이 아니라, 하네스 자체를 생성하는 도구입니다.

1. 실제 설치 방법

# 1) 마켓플레이스 등록
/plugin marketplace add revfactory/harness

# 2) 플러그인 설치
/plugin install harness@harness

README는 추가로 “global skill처럼 직접 설치”하는 경로도 보여 줍니다. 즉 marketplace 없이 `skills/harness`를 `~/.claude/skills/harness` 아래에 복사하는 방식도 가능합니다.

2. 실제 사용 방식

설치 뒤에는 복잡한 명령보다 자연어 트리거가 핵심입니다. README_KO와 SKILL 문서 둘 다 `하네스 구성해줘`, `하네스 구축해줘`, `이 프로젝트에 맞는 에이전트 팀을 설계해줘` 같은 요청을 직접 예시로 제시합니다.

하네스 구성해줘
이 프로젝트에 맞는 에이전트 팀 구축해줘
풀스택 웹사이트 개발 하네스를 구성해줘
Build a harness for this project
Design an agent team for this domain

3. README 기준 핵심 워크플로

Phase 1: Domain Analysis
Phase 2: Team Architecture Design (Agent Teams vs Subagents)
Phase 3: Agent Definition Generation (.claude/agents/)
Phase 4: Skill Generation (.claude/skills/)
Phase 5: Integration & Orchestration
Phase 6: Validation & Testing

주의할 점은 저장소 안의 실제 SKILL/CHANGELOG를 더 읽어보면, 운영 단계에서는 `Phase 0: 현황 감사`와 `Phase 7: 하네스 진화` 같은 흐름도 추가되어 있다는 점입니다. 따라서 간단히 소개할 때는 “README 기준 6단계, 내부 운영 문서까지 보면 0/7단계가 더 있다”고 설명하는 편이 가장 정확합니다.

4. 지원하는 팀 아키텍처 패턴

• Pipeline
• Fan-out / Fan-in
• Expert Pool
• Producer-Reviewer
• Supervisor
• Hierarchical Delegation

5. 생성되는 산출물

your-project/
└── .claude/
    ├── agents/
    │   ├── analyst.md
    │   ├── builder.md
    │   └── qa.md
    └── skills/
        ├── analyze/
        │   └── SKILL.md
        └── build/
            └── SKILL.md

6. 관련 생태계

• revfactory/harness-100: 100개 하네스, 한영 200패키지, 1,808개 markdown 파일
• revfactory/claude-code-harness: 구조화된 사전 설정이 코드 에이전트 품질에 미치는 영향을 다룬 연구 저장소

7. 이 사이트에 어떻게 반영하면 좋은가

8. 같이 읽으면 좋은 페이지