# PROJECT_MAP

> 마지막 업데이트: 2026-07-21
> 프로젝트: harness — Claude Code Plugin 저장소 (ythong 마켓플레이스)
> 버전: zioinfo v2.1.0 (plugins/zioinfo/.claude-plugin/plugin.json 기준)
> 업데이트 방법: "PROJECT_MAP 업데이트해줘" 또는 구조 변경 후 analyst 에이전트 자동 갱신

---

## 프로젝트 목적

Claude Code용 **ZIO INFOTECH 통합 하네스** 플러그인 저장소. 2026-07-21 구 4개 플러그인(harness·zio-harness·proposal-builder·zioinfo)을 `plugins/zioinfo/` 단일 플러그인 v2.0.0으로 통합.

- `zio-harness` 스킬: React + Spring Boot + Mobile 풀스택 개발 6인 팀 (hermes 전령 포함)
- `harness` 스킬: 도메인 설명 → 에이전트 팀 + 스킬 자동 생성 (메타 스킬)
- `proposal-builder-orchestrator` 스킬: RFP+PPT 템플릿 → 제안서 자동완성 (`/zioinfo:proposal`)
- `pm-pmo-orchestrator` 스킬: PM·PMO 프로젝트 관리 (`/zioinfo:pmo`)
- `/zioinfo:wiki`: graphify LLM wiki 생성

---

## 루트 디렉토리 구조

| 파일/폴더 | 용도 |
|----------|------|
| `.claude-plugin/marketplace.json` | ythong 마켓플레이스 매니페스트 — **zioinfo 단일 엔트리** |
| `.github/` | GitHub 이슈/PR 템플릿 |
| `plugins/zioinfo/` | ★ 통합 플러그인 v2.0.0 (아래 상세) |
| `docs/` | 장기 참조 문서 (카탈로그·퀵스타트·설치가이드 pptx·gen_*.py) |
| `graphify-out/` | 이 저장소의 지식그래프 (SessionStart 훅 산출) |
| `_workspace/` | 에이전트 작업 중간 산출물 |
| `CLAUDE.md` | Claude Code 세션 진입 포인터 + 트랙별 트리거 규칙 |
| `PROJECT_MAP.md` | 이 파일 — 폴더 구조 메모리 |
| `README.md` / `README_KO.md` / `README_JA.md` | 다국어 설명 (동기화 필수) |
| `CHANGELOG.md` | 버전별 변경 이력 (Semantic Versioning) |
| `CONTRIBUTING.md` | 기여 가이드 + SLA (PR 72h, Issue 48h) |
| `LICENSE` | Apache 2.0 |
| `index.html` / `privacy.html` | 마켓플레이스 랜딩 / 개인정보처리방침 |
| `zioinfo_*.png` | 브랜드 이미지 (banner, icon, social, team — team은 6인 다이어그램) |

---

## plugins/zioinfo/ (통합 플러그인 v2.0.0)

| 경로 | 용도 |
|------|------|
| `.claude-plugin/plugin.json` | 매니페스트 — `$schema`·`displayName`("ZIO INFOTECH Suite")·`experimental.themes`·버전 단일 출처 |
| `agents/` | 16인 — **hermes**(전령: `memory: user`·hermes-delivery 사전 로드·cron·External APIs) + proposal 7종(rfp-analyst·proposal-strategist·proposal-tech-advisor·proposal-writer·proposal-visual-designer·deck-designer·proposal-qa) + pm·pmo 8종(pm-planner·pm-risk-manager·pm-reporter·pm-auditor·pmo-governance·pmo-portfolio·pm-ai-commissioner·pm-qa) |
| `commands/pmo.md` | `/zioinfo:pmo` — PM·PMO 팀 지휘 |
| `commands/proposal.md` | `/zioinfo:proposal` — 제안서 팀 지휘 |
| `commands/wiki.md` | `/zioinfo:wiki` — graphify LLM wiki 생성/갱신 (graphify-out/wiki/) |
| `hooks/hooks.json` | SessionStart → `scripts/graphify_setup.py` (지식그래프 자동 구축/갱신) |
| `scripts/graphify_setup.py` | graphifyy[sql] 설치 + extract/update |
| `themes/zioinfo.json` | ZIO WISE 테마 (시안 #11c3ff·블루 #1f29fc, experimental) |
| `knowledge/kintex/` | KINTEX 도메인 지식베이스 (기획·설계·백로그·분석 md 전체) |
| `knowledge/guardia/` | GUARDiA 전사 지식 (solutions-catalog·standard-framework·operations-cicd·lessons-learned) |
| `docs/INSTALL.md` | 설치·이관·트러블슈팅 가이드 |
| `README.md` | 플러그인 개요 (4개 트랙) |

### skills/harness/ (하네스 팩토리 메타 스킬)

| 파일 | 용도 |
|------|------|
| `SKILL.md` | 메인 스킬 정의. 7 Phase 워크플로우 (감사→분석→설계→에이전트→스킬→통합→검증) |
| `references/agent-design-patterns.md` | 6가지 아키텍처 패턴 + 에이전트 분리 기준 + 재사용 설계 |
| `references/orchestrator-template.md` | 팀/서브에이전트/하이브리드 오케스트레이터 템플릿 3종 |
| `references/team-examples.md` | 실전 팀 구성 예시 5종 (파일 전문 포함) |
| `references/skill-writing-guide.md` | 스킬 작성 패턴 + Progressive Disclosure + 재사용 설계 |
| `references/skill-testing-guide.md` | 테스트/평가/반복 개선 방법론 |
| `references/qa-agent-guide.md` | QA 에이전트 통합 가이드 + 7개 버그 패턴 |

### skills/zio-harness/ (풀스택 개발 하네스)

| 파일 | 용도 |
|------|------|
| `SKILL.md` | 오케스트레이터 진입점. 6인 팀 구성·워크플로우·에러 핸들링·테스트 시나리오 |
| `references/folder-map.md` | **PROJECT_MAP.md 생성·유지 시스템** |
| `references/designer.md` | Designer — UI/UX 스펙·디자인 토큰·선 SVG 아이콘·Stitch 의뢰 design.md |
| `references/hermes.md` | Hermes — 전령: Gitea commit/push·배포 확인·산출물 중계·알림·릴리즈 노트 |
| `references/react.md` | React 18 + TypeScript + TanStack Query + Zustand 패턴 |
| `references/spring-boot.md` | Spring Boot 3.x 레이어 아키텍처 + JPA + JWT + Flyway |
| `references/mobile.md` | React Native + Expo + React Navigation + AsyncStorage |
| `references/playwright.md` | E2E 테스트 + 페이지 오브젝트 패턴 + CI 통합 |
| `references/database.md` | PostgreSQL/MySQL MCP 설정 + Flyway 마이그레이션 + JPA 최적화 |
| `references/orchestrator.md` / `analyst.md` / `bot.md` / `agent.md` | 에이전트 상세 정의 템플릿 |

### skills/proposal-builder-orchestrator/ (제안서 자동완성)

| 파일 | 용도 |
|------|------|
| `SKILL.md` | 7인 팀 오케스트레이터 (분석→전략→기술→본문→비주얼→PPTX→검증) |
| `scripts/inspect_template.py` | PPT 템플릿 레이아웃 분석 |
| `scripts/build_deck.py` | python-pptx 결정적 덱 생성 |

### skills/pm-pmo-orchestrator/ (PM·PMO)

| 파일 | 용도 |
|------|------|
| `SKILL.md` | 8인 팀 오케스트레이터 (계획→리스크→보고→감리→거버넌스→포트폴리오→AI 의뢰→QA) |

### skills/hermes-delivery/ (전령 운영 절차)

| 파일 | 용도 |
|------|------|
| `SKILL.md` | hermes 실행 절차 — 전달 파이프라인·cron/정기작업(CronCreate·/schedule)·External APIs(Gitea REST·webhook)·스킬 자가 축적. hermes 에이전트에 사전 로드 |

---

## docs/ (참조 문서)

| 파일 | 용도 |
|------|------|
| `plugins.md` | 플러그인 카탈로그 (zioinfo v2.0.0 단일) + 설치·검증 명령 |
| `quickstart.md` | 5분 퀵스타트 |
| `experimental-dependency.md` | `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` 플래그 설명 |
| `plugin-guide.md` | 하네스 플러그인 작성 가이드 (작성자용) |
| `gen_install_guide.py` | 사내전용 설치가이드 pptx 생성 스크립트 (진실원천) |
| `gen_intro_deck.py` | 소개 덱 생성 스크립트 |
| `zioinfo_사내전용_설치가이드.pptx` | 산출물 |

---

## 핵심 컨벤션

| 항목 | 규칙 |
|------|------|
| 스킬 위치 | `plugins/zioinfo/skills/{skill-name}/SKILL.md` |
| 참조 파일 | `plugins/zioinfo/skills/{skill-name}/references/*.md` |
| 에이전트(플러그인 번들) | `plugins/zioinfo/agents/{name}.md` (frontmatter name/description 필수) |
| 에이전트(프로젝트별) | 대상 프로젝트 `.claude/agents/{name}.md` — zio-harness references 템플릿으로 생성 |
| SKILL.md 크기 제한 | 500줄 이내 (초과 시 references/ 분리) |
| 버전 관리 | Semantic Versioning, plugins/zioinfo/.claude-plugin/plugin.json 기준 |
| 다국어 문서 | README.md (EN) · README_KO.md · README_JA.md 동기화 필수 |

---

## 환경 요구사항

| 항목 | 값 |
|------|-----|
| Claude Code 버전 | v2.x 이상 (테마는 experimental — 최신 버전 권장) |
| 필수 환경 변수 | `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` (에이전트 팀 모드) |
| 설치 명령(이 저장소) | `claude plugin marketplace add https://git.zioinfo.co.kr/ythong/harness.git` → `claude plugin install zioinfo@ythong` (⚠️ 비-GitHub git 저장소는 **`.git` 필수** — 없으면 `expected object, received string` 오류) |

---

## 최근 변경 이력

| 날짜 | 변경 내용 | 담당 |
|------|----------|------|
| 2026-07-21 | **v2.1.0 — hermes 4대 특징 탑재**: 번들 에이전트(memory: user)·hermes-delivery 스킬·cron·External APIs(userConfig notify_webhook_url) | - |
| 2026-07-21 | **4개 플러그인 → zioinfo v2.0.0 단일 통합** (git mv 히스토리 보존) + LLM wiki 커맨드·ZIO WISE 테마·manifest 최신화($schema·displayName) | - |
| 2026-07-21 | zio-harness v1.3.0 — hermes(전령) 에이전트 추가 (5→6인) + 팀 이미지 일치화 | - |
| 2026-06-23 | `docs/plugin-guide.md` 신설 + PROJECT_MAP 현행화 | - |
| 2026-06-17 | zio-harness 스킬 + 에이전트 4종 신규 생성 | orchestrator |
| 2026-04-18 | v1.2.0/1.2.1 릴리즈: 버전 정합성·포지셔닝·CONTRIBUTING·docs/ 신설 | - |