harness/CLAUDE.md
ythong cc46c4528e feat: split zio-harness into a standalone plugin
Move skills/zio-harness into plugins/zio-harness/ as a self-contained
plugin with its own .claude-plugin/plugin.json. Add a second marketplace
entry (zio-harness@1.0.0) and bump the harness plugin to 1.3.0 since it no
longer bundles zio-harness. Single ownership: harness ships only the
harness skill, zio-harness ships only the zio-harness skill.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-17 16:54:17 +09:00

3.2 KiB

harness-main — Claude Code 가이드

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

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

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

변경 이력:

날짜 변경 내용 대상 사유
2026-06-17 zio-harness 초기 구성 전체 React+SpringBoot+Mobile 풀스택 하네스 신규 생성

하네스: 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 에이전트 역할·원칙·통신 프로토콜 정의