harness/PROJECT_MAP.md

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/ 신설	-