revfactory/harness · Claude Code 플러그인
문장 하나가
에이전트 팀이 된다
이 요청이 여덟 단계를 거칩니다
- 0현황 감사
- 1도메인 분석
- 2팀 아키텍처 설계
- 3에이전트 정의
- 4스킬 생성
- 5통합·오케스트레이션
- 6검증·테스트
- 7하네스 진화
만들어지는 것 · .claude/agents/ · .claude/skills/ · CLAUDE.md 포인터
판정
신규 구축Phase 1부터 전부 실행이번 경로
기존 확장필요한 Phase만 골라 실행
운영·유지보수감사하고 어긋난 곳을 맞춤
감사 결과를 요약해 보고하고, 사용자에게 실행 계획을 확인받은 뒤 다음 단계로 넘어갑니다.
리서치 하네스 구성해줘. 공식 발표·미디어·커뮤니티·배경 자료를 동시에 조사해서 종합 보고서를 쓰는 팀으로.
작업 종류조사 4건 · 통합 1건
- 공식 발표 조사
- 미디어·투자 조사
- 커뮤니티 반응 조사
- 배경·경쟁 조사
- 종합 보고서 작성
의존 관계병렬 가능
네 가지 조사는 서로 결과를 기다리지 않습니다. 그래서 동시에 돌릴 수 있습니다.
사용자 수준말투 조절
요청에 쓴 용어와 질문 수준을 보고 설명할 때 쓸 단어를 고릅니다. 처음 쓰는 사람에게는 전문 용어를 풀어서 말합니다.
같은 주제를 네 방향에서 동시에 조사해 한곳에 모으는 일 → 팬아웃/팬인
에이전트가 두 명 이상인가?예 · 조사원 4명
팀원끼리 연락해야 하는가?예 · 찾은 내용을 서로 나눔
에이전트 팀기본값팀원끼리 직접 메시지를 주고받고 작업 목록을 함께 씁니다
TeamCreate
SendMessage
TaskCreate선택
서브 에이전트대안각자 일하고 결과만 메인에 돌려줍니다
Agent
하이브리드혼합단계마다 두 방식을 섞어 씁니다
팀 + 서브
팬아웃/팬인은 에이전트 팀으로 짜는 것이 원칙입니다. 한 팀원이 찾은 사실이 다른 팀원의 조사 방향을 바로 바꿀 수 있기 때문입니다.
.claude/agents/official-researcher.md
---
name: official-researcher
description: "공식 발표·블로그 조사"
---
## 핵심 역할
## 작업 원칙
## 입력/출력 프로토콜
## 에러 핸들링
## 팀 통신 프로토콜
→ background에게 관련 발표 공유
model: "opus"모든 팀원 호출에 지정
호출 프롬프트에만 역할 적기금지 · 다음 세션에서 다시 쓸 수 없음
에이전트 = 누가
스킬 = 어떻게
skills/web-research/4명 공유
- ├ SKILL.md
- ├ references/sources.md
- └ scripts/dedupe.py
skills/report-writing/
- ├ SKILL.md
- └ references/citation.md
description 쓰는 법
스킬이 발동할지는 이 설명 한 줄로 정해집니다.
약한 설명리서치를 돕는 스킬
적극적인 설명공식·미디어·커뮤니티·학술 자료를 찾아 출처와 함께 정리한다. ‘조사’, ‘동향’, ‘찾아줘’라는 말이 나오면 반드시 이 스킬을 쓴다.
Claude는 스킬을 아껴 쓰는 편이라, 설명을 적극적으로 써야 제때 발동합니다.
컨텍스트 창
남은 공간
그대로
web-research
SKILL.md 본문
sources-kr.md
1단계메타데이터
name + description
약 100단어
항상 올라가 있음
2단계SKILL.md 본문
작업 절차와 판단 기준
500줄 이내
스킬이 발동할 때
3단계references/
분량 제한 없음 · scripts/는 읽지 않고 실행
sources-kr.mdsources-global.md · 안 읽음
필요할 때만
요청 ›AI 반도체 동향 조사해줘web-research 설명과 일치 → 본문 읽기
research-orchestrator
오케스트레이터 스킬
누가 · 언제 · 어떤 순서로
흩어진 팀원을 한 묶음으로 조율합니다
팀 구성TeamCreate(research-team)
작업 배분TaskCreate × 4 · 의존 관계 포함
팀원끼리 연락SendMessage · 리더를 거치지 않음
결과 전달_workspace/{phase}_{agent}_{artifact}.md
실패 대응한 번 다시 시도하고, 또 실패하면 누락을 적고 진행
조율은 작업 목록으로, 산출물은 파일로, 급한 소식은 메시지로 주고받습니다.
CLAUDE.md 새 세션마다 읽힘
에이전트·스킬 목록은 적지 않음
구조 검증 파일 · 이름 · 참조
- ✓에이전트 파일 4개가 .claude/agents/에 있다
- ✓스킬마다 name과 description이 있다
- ✓에이전트끼리 부르는 이름이 서로 맞다
- ✓만들 필요 없는 커맨드 파일이 없다
스킬 효과 비교 with-skill vs without-skill
같은 요청을 스킬이 있을 때와 없을 때 한 번씩 실행해 결과를 견줍니다.
발동 검증 should / should-not
- “A사 최근 투자 소식 모아줘”발동
- “지난번 조사 다시 정리해줘”발동
- “이 보고서 맞춤법만 봐줘”발동 안 함
- “엑셀 차트를 PNG로 뽑아줘”발동 안 함
드라이런 데이터 경로 점검
끊긴 구간 0곳
실행
피드백
수정
기록
실행할 때마다
조금씩 고친다
팀원regulation 합류
“분석이 너무 얕아”
스킬 수정web-research · 깊이 기준 추가
“규제 쪽도 조사해 줘”
에이전트 추가regulation-researcher.md
“검증을 먼저 하자”
오케스트레이터 수정Phase 순서 변경
CLAUDE.md · 변경 이력
날짜변경 내용대상사유
2026-09-26초기 구성전체-
2026-09-29깊이 기준 추가skills/web-research“분석이 얕다”
2026-10-02규제 조사원 추가agents/regulation-researcher.md규제 관점 누락
2026-10-05검증 단계 앞당김skills/research-orchestrator“검증 먼저”
CLAUDE.md트리거 규칙 확인
research-orchestrator오케스트레이터 발동
TeamCreate(research-team)
TaskCreate × 4
파일 4개 읽고 종합
SendMessagemedia → background
투자 뉴스 공유
SendMessagecommunity → media
커뮤니티 반응 전달
_workspace/
아직 비어 있음
- 03_official_findings.md
- 03_media_findings.md
- 03_community_findings.md
- 03_background_findings.md
최종 산출물종합보고서.md서로 다른 정보는 출처를 함께 적음
평균 품질 점수 향상
+60%
49.5점 → 79.3점
0255075100
15/15
과제 15개 모두에서 하네스를 쓴 쪽의 점수가 높았습니다.
n=15 · 저자가 직접 측정한 A/B 실험 · 제3자 재현 대기 중 · 출처 revfactory/claude-code-harness
›하네스 구성해줘
설치하고 프로젝트에서 이 한 줄을 요청하면 시작됩니다.
1 마켓플레이스 추가/plugin marketplace add revfactory/harness
2 플러그인 설치/plugin install harness@harness-marketplace
에이전트 팀 기능 켜기 · CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
harness
- 0감사
- 1분석
- 2설계
- 3에이전트
- 4스킬
- 5통합
- 6검증
- 7진화