f788dba5f2
- experimental-dependency.md: dependency graph v1.2.0 -> v1.3.1, Last updated 2026-04-18 -> 2026-06-17, Scenario C patch tag v1.2.x -> v1.3.x - CLAUDE.md: add change-history rows for the standalone-plugin split and the Agent Teams API usage correction Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
71 lines
3.6 KiB
Markdown
71 lines
3.6 KiB
Markdown
# 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` 스킬을 사용하라.
|
||
|
||
---
|
||
|
||
## 폴더 구조 빠른 참조
|
||
|
||
```
|
||
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` | 에이전트 역할·원칙·통신 프로토콜 정의 |
|