harness/CLAUDE.md

harness-main — Claude Code 가이드

하네스: zio-harness (React + Spring Boot + Mobile)

목표: React 프론트엔드 + Spring Boot 백엔드 + 모바일 앱 풀스택 개발을 에이전트 팀이 자동 조율한다.

트리거: 기능 개발, 버그 수정, 테스트, 코드 분석, 폴더 구조 파악 요청 시 zio-harness 스킬을 사용하라. 단순 질문은 직접 응답 가능.

변경 이력:

날짜	변경 내용	대상	사유
2026-06-17	zio-harness 초기 구성	전체	React+SpringBoot+Mobile 풀스택 하네스 신규 생성
2026-06-17	zio-harness 독립 플러그인 분리 (plugins/zio-harness/, v1.0.1)	마켓플레이스·폴더 구조	단독 설치 지원, harness 플러그인과 스킬 소유권 분리
2026-06-17	Agent Teams API 사용법 정정 (SKILL.md Phase 2–3 + 오케스트레이터 템플릿)	zio-harness·harness	TeamCreate(members[])/TaskCreate(tasks[])가 실제 실험 API와 불일치 → 빈 팀+Agent spawn / 개별 TaskCreate+TaskUpdate로 수정

---

하네스: harness (메타 스킬)

목표: 새 도메인에 맞는 에이전트 팀과 스킬을 자동 생성하는 팩토리.

트리거: "하네스 구성해줘", "에이전트 팀 설계해줘", 새 도메인 하네스 생성 요청 시 harness 스킬을 사용하라.

---

하네스: proposal-builder (제안서 자동완성)

목표: RFP + PPT 디자인 템플릿을 읽어 제안서를 자동 완성. 시스템 구축(SI)·유지보수(SM) 제안 주력. "제안서를 작성해줘" 한 마디에 오케스트레이터가 7인 전문가 + 아키텍처 전문가 풀을 총지휘.

트리거: 제안서 작성, RFP 분석, PPT 제안서, 수주/기술 제안서, 구축/유지보수 제안, 나라장터 제안 요청 시 proposal-builder-orchestrator 스킬을 사용하라.

구성: 독립 플러그인 plugins/proposal-builder/(v1.0.0) — 에이전트 7(rfp-analyst·strategist·tech-advisor·writer·visual-designer·deck-designer·qa) + 오케스트레이터 + 번들 스크립트(inspect_template·build_deck). tech-advisor가 아키텍처 전문가 풀 동원 허브.

변경 이력:

날짜	변경 내용	대상	사유
2026-06-20	proposal-builder 플러그인 신규(에이전트7·오케스트레이터1·스크립트2) + marketplace 등록	plugins/proposal-builder	RFP+템플릿→제안서 자동완성, 디자인(선아이콘)·기술자문·아키텍처 총동원 요청

---

하네스: pm-pmo (PM·PMO 프로젝트 관리)

목표: 수주 후 프로젝트 수행(PM)·조직 총괄(PMO) 업무 자동화 — 계획(사업수행계획서·WBS·M/M)·리스크/이슈/변경·진척보고(EVM)·감리 대응(모의감리·지적조치)·PMO 표준/품질게이트·포트폴리오 총괄. 제안 단계는 proposal-builder 담당(경계).

트리거: 프로젝트 계획, WBS, 사업수행계획서, 주간/월간/완료 보고, 리스크 관리, 변경 영향분석, 감리 대응, 모의감리, 지적사항 조치, 검수 준비, PMO 표준, 품질게이트, 포트폴리오 현황, 자원 배분, 디자인 의뢰(스티치 design.md), 젠스파크 의뢰서, AI 의뢰서, graphify-out 생성 요청 시 pm-pmo-orchestrator 스킬을 사용하라. /pmo 커맨드 포함.

구성: 독립 플러그인 plugins/pm-pmo/(v1.1.0) — 에이전트 8(pm-planner·pm-risk-manager·pm-reporter·pm-auditor·pmo-governance·pmo-portfolio·pm-ai-commissioner·pm-qa) + 오케스트레이터 + /pmo 커맨드. 설치: /plugin install pm-pmo@ythong-harness → /reload-plugins.

변경 이력:

날짜	변경 내용	대상	사유
2026-07-17	pm-pmo 플러그인 신규(에이전트7·오케스트레이터1·커맨드1) + marketplace 등록	plugins/pm-pmo	플러그인에 PM·PMO 추가 요청. 작업 중 "감리 추가" 요청으로 pm-auditor 전담 에이전트 추가(6→7인), pmo-governance의 감리 실무는 pm-auditor로 이관(중복 제거)
2026-07-17	v1.1.0 — pm-ai-commissioner 추가(7→8인): 외부 AI 의뢰 트랙(스티치 design.md·젠스파크 조사/슬라이드 의뢰 md·graphify 지식그래프 graphify-out/ 생성) + 오케스트레이터 Phase5 신설	plugins/pm-pmo	"플러그인에 design.md 생성·graphify-out 생성·젠스파크 AI 의뢰 md 작성 추가" 요청

---

폴더 구조 빠른 참조

harness-main/
├── .claude-plugin/         # 플러그인 매니페스트
├── .claude/
│   ├── agents/             # 에이전트 정의 파일 (4종)
│   │   ├── orchestrator.md # 전체 조율
│   │   ├── analyst.md      # 분석 + PROJECT_MAP 관리
│   │   ├── bot.md          # 테스트·빌드·자동화
│   │   └── agent.md        # 코드 구현
│   └── skills/             # (추가 스킬 위치)
├── skills/
│   └── harness/            # 메타 하네스 스킬 (harness 플러그인)
│       ├── SKILL.md
│       └── references/     # 패턴·템플릿·가이드
├── plugins/
│   └── zio-harness/        # 독립 플러그인: 풀스택 개발 하네스
│       ├── .claude-plugin/
│       │   └── plugin.json
│       └── skills/
│           └── zio-harness/
│               ├── SKILL.md
│               └── references/
│                   ├── folder-map.md    # PROJECT_MAP 생성 가이드
│                   ├── react.md         # React 개발 패턴
│                   ├── spring-boot.md   # Spring Boot 패턴
│                   ├── mobile.md        # 모바일 앱 패턴
│                   ├── playwright.md    # E2E 테스트 패턴
│                   ├── database.md      # DB + MCP 패턴
│                   ├── orchestrator.md  # 오케스트레이터 에이전트 가이드
│                   ├── analyst.md       # 분석가 에이전트 가이드
│                   ├── bot.md           # 봇 에이전트 가이드
│                   └── agent.md         # 개발 에이전트 가이드
└── _workspace/             # 에이전트 작업 중간 산출물

핵심 파일 역할

파일	역할
PROJECT_MAP.md (프로젝트 루트)	폴더 구조 메모리 — 에이전트가 세션마다 읽는 기준 파일
plugins/zio-harness/skills/zio-harness/SKILL.md	zio-harness 오케스트레이터 진입점 (독립 플러그인)
skills/harness/SKILL.md	harness 메타 스킬 진입점
.claude/agents/*.md	에이전트 역할·원칙·통신 프로토콜 정의