claude-unity-harness

claude-unity-harness

Unity 프로젝트를 위한 Claude Code 플러그인.

세션 관리 하네스, 코드 리뷰, 설계 플랜, 문서화, pre-commit 자동 리뷰를 제공합니다.

---

설치

/plugin marketplace add https://github.com/cwp10/claude-unity-harness
/plugin install claude-unity-harness@cwp10-plugins

설치 후 Unity 프로젝트 루트에서 최초 1회 실행:

/setup

---

슬래시 커맨드

커맨드	설명
/setup	프로젝트 초기화 — CLAUDE.md 스택 설정, 하네스 파일 생성, hook 설치 · ↓
/context-load	세션 시작 — 이전 진행 상황 복구 · ↓
/context-save	세션 종료 — 진행 상황 저장 + git 커밋 · ↓
/deep-interview [기능명]	요구사항 심층 인터뷰 → /plan 자동 연결 · ↓
/plan [기능명]	설계 플랜 생성 (Plan Mode 강제) · ↓
/review [파일]	코드 리뷰 · ↓
/audit	전체 감사 + 빌드 체크 · migrate localize 서브커맨드 포함 · ↓
/refactor [대상]	리팩토링 플랜 + 실행 (Plan Mode 강제) · ↓
/fix [오류]	버그 진단 + 수정 · ↓
/analyze [대상]	코드·시스템 분석 · ↓
/git-summary	커밋 메시지 제안 · ↓
/doc readme|handover|delivery	문서 생성 · ↓
/setup-check	설치 상태 점검 · ↓
/unity-setup-mcp	Unity MCP 서버 연동 설정 · ↓
/unity-console	Unity 콘솔 에러·경고 분석 (UnityMCP 필요) · ↓
/unity-test [EditMode|PlayMode|All]	테스트 실행 + 실패 원인 분석 (UnityMCP 필요) · ↓
/unity-scene-audit	씬 품질 감사 — Missing·네이밍·성능 점검 (UnityMCP 필요) · ↓
/perf [파일]	성능 패턴 탐지 — GC Alloc·캐싱 누락·Draw Call · ↓
/allow [on|off]	권한 자동 승인 토글 — git push는 항상 차단 · ↓
/ship [기능명]	전체 개발 파이프라인 — 설계 승인 1회 후 구현→리뷰→감사→검증 자동 · ↓
/ensure [대상]	검증 + 실패 시 자동 수정 재시도 (최대 3회) · ↓

---

포함 컴포넌트

claude-unity-harness/
│
├── skills/                  슬래시 커맨드 구현체 (21개 + 자동 로드 스킬 1개)
│   ├── plan/                설계 플랜 생성
│   ├── review/              코드 리뷰
│   ├── refactor/            리팩토링 플랜 + 실행
│   ├── audit/               전체 감사 (migrate · localize 서브커맨드 포함)
│   ├── perf/                성능 패턴 탐지
│   ├── allow/           권한 자동 승인 토글
│   ├── ship/                전체 개발 파이프라인
│   ├── ensure/              검증 + 자동 재시도 루프
│   ├── fix/                 버그 진단
│   ├── analyze/             코드 분석
│   ├── doc/                 문서 생성 (readme · handover · delivery)
│   ├── git-summary/         커밋 메시지 제안
│   ├── deep-interview/      요구사항 인터뷰
│   ├── context-load/        세션 시작 루틴
│   ├── context-save/        세션 종료 루틴
│   ├── setup/               프로젝트 초기화
│   ├── setup-check/         설치 상태 점검
│   ├── unity-setup-mcp/     Unity MCP 서버 연동 설정
│   ├── unity-console/       Unity 콘솔 에러·경고 분석 (UnityMCP)
│   ├── unity-test/          테스트 실행 + 실패 분석 (UnityMCP)
│   ├── unity-scene-audit/   씬 품질 감사 (UnityMCP)
│   └── unity-patterns/      Unity C# 패턴 레퍼런스 (자동 로드)
│
├── agents/                  스킬이 내부적으로 위임하는 전문 에이전트
│   ├── codebase-explorer    코드베이스 탐색 · 의존 관계 파악
│   ├── architect-planner    설계 플랜 · 리팩토링 플랜 작성
│   ├── unity-reviewer       Unity C# 코드 리뷰
│   ├── doc-writer           문서 작성
│   ├── debugger             버그 진단 (using 누락 자동 검증 포함)
│   ├── critic               대안 제시 · 성능 최적화 관점
│   └── verifier             최종 스펙 검증 · using 누락 grep · passes:true 판정
│
├── hooks/
│   ├── pre-commit           git commit 시 자동 실행 — [1/2] .meta 체크 · [2/2] 컴파일 검증
│   └── hooks.json           Claude Code 훅 설정
│       ├── SessionStart     세션 시작 시 컨텍스트 자동 주입
│       ├── UserPromptSubmit 컨텍스트 누락 시 자동 보완
│       ├── PreToolUse       .cs 수정 전 Unity 규칙 안내
│       ├── PostToolUse      .cs 저장 후 MCP 연결 시 컴파일 에러 자동 확인 (5초 쿨다운)
│       ├── PreCompact       컨텍스트 압축 전 진행 상황 자동 저장
│       ├── SessionEnd       세션 종료 시 진행 이력 기록
│       └── Stop             세션 메모리 타임스탬프 갱신
│
└── rules/                   Claude Code paths frontmatter 조건부 자동 로드
    ├── response.md          소통 언어 · 응답 원칙 · 금지 사항 (항상 로드)
    ├── git.md               브랜치 전략 · 커밋 메시지 컨벤션 (항상 로드)
    ├── code-review.md       심각도 기준 (Critical / Warning / Suggestion) (항상 로드)
    ├── unity-engine.md      Unity 6 LTS 네이밍 · 생명주기 · 금지 목록 (Assets/**/*.cs)
    ├── unity-domain.md      아키텍처 패턴 · UI · 물리 · 씬 관리 (Assets/**/*.cs)
    ├── csharp.md            C# 스타일 가이드 · 개발 원칙 · 코드 스멜 (**/*.cs)
    ├── unity/               세부 규칙 — 에이전트가 필요 시 명시적 Read
    │   ├── serialization.md  직렬화 · RequireComponent · 네임스페이스 테이블
    │   ├── caching.md        컴포넌트 캐싱 · 이벤트 구독/해제 패턴
    │   ├── async.md          Coroutine · Awaitable · CancellationToken 패턴
    │   ├── performance.md    성능 기준 · LINQ 금지 · SOLID 원칙
    │   ├── systems.md        오디오 · 다국어 · 접근성 · 학습 흐름
    │   └── platform.md       빌드 타겟별 고려사항 · CI/CD