muno-claude-plugin
v1.16.4
Published
Unleash Claude Code's full power - Complete development workflow with expert personas, TDD-based agents, and automated documentation
Downloads
3,140
Maintainers
headchaReadme
Muno Claude Plugin
Claude Code를 제대로 활용하기 위한 통합 개발 워크플로우 플러그인
AI 기반 소프트웨어 개발의 전체 라이프사이클을 지원합니다. 요구사항 정의부터 테스트까지, 체계적인 워크플로우와 전문가 페르소나를 통해 Claude Code의 잠재력을 극대화합니다.
Table of Contents
- Quick Start
- Features
- Installation
- Core Concepts
- Skills Reference
- Personas Reference
- Subagents Reference
- Workflow Guide
- Usage Examples
- Customization
- Troubleshooting
Quick Start
# 설치 (Project Level)
npx muno-claude-plugin install
# Claude Code에서 사용
"PRD 작성해줘" # PRD 문서 자동 생성 (prd-generator 스킬 호출)
/dev # Developer 페르소나 활성화 (Command 사용)30초 만에 시작하세요. 설치 후 Claude Code에서 바로 사용 가능합니다.
Features
1. Development Workflow Skills
PRD → Epic/Story → HLD → LLD → Task → TC 전체 개발 라이프사이클 자동화
2. Expert Personas
역할별 전문가 페르소나로 상황에 맞는 최적의 답변 제공
3. TDD-based Subagents
테스트 먼저(Test-First) 방식의 자동 서브에이전트 체계
4. Status Tracking
Epic/Story/Task 상태 자동 추적 및 관리
Installation
Project Level (권장)
팀원들과 Git으로 공유할 수 있습니다.
npx muno-claude-plugin install설치 위치: <project>/.claude/
User Level
모든 프로젝트에서 자동 적용됩니다.
npx muno-claude-plugin install-user설치 위치: ~/.claude/
Commands
| 명령어 | 설명 |
|--------|------|
| npx muno-claude-plugin install | Project 레벨 설치 |
| npx muno-claude-plugin install-user | User 레벨 설치 |
| npx muno-claude-plugin install --force | 기존 파일 덮어쓰기 |
| npx muno-claude-plugin status | 설치 상태 확인 |
| npx muno-claude-plugin uninstall | 제거 |
| npx muno-claude-plugin help | 도움말 |
설치 후 디렉토리 구조
.claude/
├── agents/ # Subagent 정의 (자동 호출)
│ ├── tc-reviewer.md
│ ├── acceptance-test-generator.md
│ ├── unit-test-generator.md
│ ├── task-tracker.md
│ └── ...
├── skills/ # 워크플로우 스킬 (자동 호출)
│ ├── prd-generator/
│ ├── epic-generator/
│ ├── story-generator/
│ ├── hld-generator/
│ ├── lld-generator/
│ ├── task-generator/
│ └── tc-generator/
├── commands/ # Slash 명령어 정의
├── personas/ # 페르소나 상세 정의
├── references/ # 참조 문서
└── WORKFLOW.md # 워크플로우 가이드Core Concepts
Skills vs Commands vs Subagents
| 구분 | 호출 방식 | 용도 | 예시 |
|------|----------|------|------|
| Skill | 자동 호출 | 특정 산출물 생성 | prd-generator, hld-generator |
| Command | /command-name (슬래시 명령어) | 페르소나 활성화 등 | /dev, /qa, /po |
| Subagent | 자동 호출 | 품질 검증, 테스트 생성 | tc-reviewer, code-reviewer |
TDD Workflow (2-Level)
Story Level (인수 테스트)
├── tc-generator → TC 명세 생성
├── tc-reviewer → TC 품질 리뷰 (자동)
└── acceptance-test-generator → 인수 테스트 생성 (Red)
Task Level (단위 테스트)
├── unit-test-generator → Unit Test 생성 (Red)
├── 구현 → 테스트 통과 (Green)
└── 리팩토링 (Refactor)Skills Reference
Skills는 Claude Code가 자동으로 인식하여 호출합니다. 사용자가 특정 요청을 하면 Claude Code가 적절한 스킬을 자동으로 실행합니다.
구현된 Skills 목록:
- 문서 생성: prd-generator, epic-generator, story-generator, hld-generator, lld-generator
- 개발 작업: task-generator, tc-generator
- 디자인: app-design, architecture-design
- API 문서: swagger-docs-generator
prd-generator
Product Requirements Document 자동 생성
호출 조건: "PRD 작성해줘", "기획서 만들어줘", "요구사항 정의서 작성" 등의 요청 시 자동 호출
입력: 요구사항 (자연어)
출력: documents/prd/<feature>-prd.md
사용 예시:
사용자가 상품을 장바구니에 담고 주문할 수 있는 기능의 PRD를 작성해줘.
- 장바구니 담기/빼기
- 수량 변경
- 주문서 작성
- 결제 연동생성되는 PRD 구조:
- 문제 정의 (Problem Statement)
- 목표 및 성공 지표 (Goals & Metrics)
- 사용자 스토리 (User Stories)
- 기능 요구사항 (Functional Requirements)
- 비기능 요구사항 (Non-Functional Requirements)
- 제약사항 및 가정 (Constraints & Assumptions)
- 용어 정의 (Glossary)
epic-generator
Epic 자동 생성
호출 조건: "Epic 생성해줘", "에픽 만들어줘" 등의 요청 시 자동 호출
입력: PRD 문서 또는 요구사항
출력: documents/epics/{epic-name}/epic.md
사용 예시:
@documents/prd/cart-prd.md 를 기반으로 Epic을 생성해주세요.Epic 포함 내용:
- Epic 설명 및 비즈니스 가치
- 관련 PRD 참조
- 하위 Story 목록
- 완료 기준
story-generator
User Story 자동 생성
호출 조건: "Story 만들어줘", "스토리 작성", "백로그 생성" 등의 요청 시 자동 호출
입력: Epic 또는 PRD
출력: documents/epics/{epic-name}/stories/{story-id}-{name}/story.md
사용 예시:
@documents/epics/cart/epic.md 를 기반으로 Story를 생성해주세요.Story 포함 내용:
- 스토리 설명 (As a... I want... So that...)
- Acceptance Criteria (Given-When-Then)
- 기술적 고려사항
- 의존성
hld-generator
High-Level Design 자동 생성
호출 조건: "HLD 작성해줘", "시스템 설계", "아키텍처 문서" 등의 요청 시 자동 호출
입력: Story 또는 PRD
출력: documents/hld/<feature>-hld.md
사용 예시:
@backlogs/cart-feature/STORY-001-add-item.md 에 대한 HLD를 작성해주세요.HLD 포함 내용:
- 시스템 컨텍스트 다이어그램
- 컴포넌트 아키텍처
- 데이터 흐름
- 기술 스택 선정 근거
- 통합 포인트
- 보안 고려사항
lld-generator
Low-Level Design 자동 생성
호출 조건: "LLD 작성해줘", "상세 설계", "API 명세" 등의 요청 시 자동 호출
입력: Story + HLD
출력: documents/lld/<feature>-lld.md
사용 예시:
@backlogs/cart-feature/STORY-001-add-item.md
@documents/hld/cart-hld.md
위 문서를 기반으로 LLD를 작성해주세요.LLD 포함 내용:
- ERD (Entity Relationship Diagram)
- 클래스/모듈 설계
- API 명세 (OpenAPI 형식)
- 시퀀스 다이어그램
- 에러 처리 전략
- 데이터 검증 규칙
task-generator
Implementation Task 자동 생성
호출 조건: "태스크 생성해줘", "구현 작업 분해", "Task 만들어줘" 등의 요청 시 자동 호출
입력: Story + LLD
출력: documents/issues/{feature}/tasks/STORY-{id}/ 디렉토리
사용 예시:
@documents/issues/cart/stories/STORY-001-add-item.md
@documents/system-design/features/cart/lld.md
구현 태스크를 생성해주세요.생성 구조:
documents/issues/cart/tasks/STORY-001/
├── TASK-001-entity.md
├── TASK-002-repository.md
├── TASK-003-service.md
├── TASK-004-controller.md
└── ...Task 포함 내용:
- 구현 목표
- 완료 조건 (Definition of Done)
- 기술적 상세
- 의존 태스크
- 예상 복잡도
tc-generator
Test Case 자동 생성
호출 조건: "테스트 케이스 작성해줘", "TC 만들어줘", "테스트 시나리오 생성" 등의 요청 시 자동 호출
입력: Story (Acceptance Criteria)
출력: test-cases/<story-id>/ 디렉토리
사용 예시:
@backlogs/cart-feature/STORY-001-add-item.md
AC 기반 테스트 케이스를 생성해주세요.생성 구조:
test-cases/STORY-001/
├── index.md # TC 목록
├── TC-001-01-happy-path.md # 정상 시나리오
├── TC-001-02-empty-cart.md # 빈 장바구니
├── TC-001-03-max-quantity.md # 최대 수량 초과
└── ...자동 호출되는 Subagent:
tc-reviewer- TC 품질 리뷰 및 보완acceptance-test-generator- 실제 테스트 코드 생성
bulk-executor
모든 TODO 상태 Task를 한 번에 순차 실행
호출 조건: "100개 task 실행", "모든 task 구현", "bulk 실행", "전체 task 처리" 등의 요청 시 자동 호출
입력: documents/issues/ 디렉토리의 Task 파일들 출력: 구현 완료된 코드 + 완료 리포트
사용 예시:
documents/issues/ 에 있는 모든 TODO 상태 task를 실행해줘.동작 과정:
documents/issues/**/tasks/**/*.md검색- Frontmatter에서
status: todo필터링 dependencies순서로 정렬- 각 Task 순차 실행:
- Task 문서 읽기
- 코드 구현 (Write/Edit)
- 테스트 실행 (Bash)
- Frontmatter status 업데이트 (todo → done)
- 완료 리포트 생성
자동 트리거되는 Subagent:
- ✅
unit-test-generator- Task 구현 전 테스트 생성 (TDD) - ✅
code-reviewer- 코드 작성 완료 후 리뷰 - ✅
task-tracker- Task 완료 시 상태 추적
Ralph와 함께 사용하기:
대량의 Task (50개 이상)를 중단 없이 처리하려면 Ralph Wiggum 플러그인과 함께 사용하세요:
# Ralph 설치 (한 번만)
git clone https://github.com/frankbria/ralph-claude-code.git
cd ralph-claude-code
./install.sh
# Ralph로 bulk-executor 실행
/ralph-loop "/bulk-executor" --max-iterations 100Ralph가 필요한 이유:
- Claude Code는 작업 완료 시 자동 종료
- Ralph는 종료를 감지하고 자동으로 재시작
- 100개 Task도 중단 없이 처리 가능
고급 옵션:
# Feature별 실행
/bulk-executor --feature=auth
# 실패한 Task만 재실행
/bulk-executor --failed-only
# Dry run (테스트 실행)
/bulk-executor --dry-run참고 문서:
app-design
UI/UX 디자인 자동 생성
호출 조건: "UI 디자인해줘", "화면 설계", "UX 만들어줘" 등의 요청 시 자동 호출
입력: 디자인 요청 (화면, 기능, 컴포넌트) 출력: 디자인 스펙 문서
사용 예시:
로그인 화면을 디자인해주세요.
- 이메일/비밀번호 입력
- 소셜 로그인 (Apple, Google)
- Toss 스타일로디자인 스펙 포함 내용:
- 레이아웃 구조 (Navigation, Content, Actions)
- 비주얼 디자인 (Color, Typography, Spacing)
- 컴포넌트 명세 (Button, Input, Card 등)
- 인터랙션 정의 (Tap, Swipe, Animation)
- 상태별 UI (Default, Loading, Error, Empty)
- 접근성 가이드
- 다크 모드 대응
- 개발 가이드 (코드 스니펫)
디자인 철학:
- Apple HIG: Hierarchy, System Integration, Consistency
- Toss Design: 명확성, 속도, 신뢰
- 베스트 프랙티스: Mobile-First, Accessibility, Performance
참고 자료:
swagger-docs-generator
Swagger/OpenAPI 문서 → Markdown 자동 변환
호출 조건: "API 문서 만들어줘", "Swagger 문서화", "OpenAPI 변환" 등의 요청 시 자동 호출
입력: Swagger 문서 URL
출력: documents/api/<service>-api-docs.md
사용 예시:
http://localhost:8080/v3/api-docs 의 API 문서를 생성해주세요.기본 설정:
- Host:
localhost - Port:
8080 - Path:
/v3/api-docs - 주소 미제공 시 자동으로
http://localhost:8080/v3/api-docs사용
생성되는 문서 내용:
- API 엔드포인트 목록 (태그별 그룹핑)
- Request/Response 스키마
- 파라미터 설명
- 데이터 모델 정의
- 에러 코드 정리
- cURL/JavaScript/Python/Java/Kotlin 예제
고급 기능:
- 여러 서버 문서 통합
- Postman Collection 생성
- 버전별 문서 관리
architecture-design
System Architecture Document (SAD) 자동 생성
호출 조건: "아키텍처 문서 만들어줘", "시스템 구조", "전체 아키텍처" 등의 요청 시 자동 호출
입력: 시스템 요구사항
출력: documents/architecture/system-architecture.md
사용 예시:
전체 시스템 아키텍처 문서를 작성해주세요.
현재 프로젝트는 Spring Boot 기반 백엔드와 React 프론트엔드로 구성됩니다.SAD 포함 내용:
- 시스템 컨텍스트 및 비즈니스 목표
- 전체 컴포넌트 구성
- 기술 스택 및 인프라
- 데이터 흐름 및 통신 패턴
- 보안 아키텍처
- 확장성 전략
SAD vs Feature HLD:
- SAD: 전체 시스템 1개 (지속적 업데이트)
- HLD: 각 피처별 다수 (피처 단위 설계)
task-reviewer
Implementation Task 품질 검증
호출 조건: "태스크 검토해줘", "Task 리뷰해줘", "구현 스펙 검증" 등의 요청 시 자동 호출
입력: 생성된 Implementation Tasks 출력: 검토 결과 및 개선 제안
사용 예시:
.tasks/STORY-001/ 디렉토리의 태스크들을 검토해주세요.
코딩 에이전트가 바로 구현할 수 있는 수준인지 확인해주세요.검토 기준:
- 명시성: 추론 없이 구현 가능한 명확성
- 완전성: 필요한 모든 정보 포함 여부
- 구체성: 파일명, 클래스명, 메서드 시그니처 명시
- 테스트 가능성: DoD(Definition of Done) 명확성
핵심 원칙:
코딩 에이전트는 추론하면 틀린다. Task에 모든 정보가 명시적으로 포함되어야 한다.
Personas Reference
/dev - Developer
전문 분야: 소프트웨어 설계 및 구현
/dev
이 서비스 클래스의 트랜잭션 처리가 적절한지 검토해주세요.역량:
- 클린 코드 & SOLID 원칙
- 디자인 패턴 적용
- TDD/BDD 실천
- 성능 최적화
- 코드 리뷰
활용 시점:
- 코드 구현 중 설계 질문
- 리팩토링 조언
- 버그 분석 및 해결
- 코드 리뷰 요청
/qa - QA Engineer
전문 분야: 테스트 설계 및 품질 보증
/qa
이 기능에 대한 테스트 전략을 수립해주세요.
엣지 케이스와 경계값 테스트도 포함해주세요.역량:
- 테스트 전략 수립
- TC 설계 (경계값, 동등 분할)
- 자동화 테스트 설계
- 탐색적 테스트
- 성능/보안 테스트
활용 시점:
- TC 작성 전 전략 수립
- 테스트 커버리지 검토
- 버그 재현 시나리오 설계
- 테스트 자동화 설계
/po - Product Owner
전문 분야: 제품 기획 및 요구사항 관리
/po
이 기능의 우선순위를 어떻게 정해야 할까요?
MVP 범위를 정의해주세요.역량:
- 요구사항 정의 및 우선순위화
- 사용자 스토리 작성
- 백로그 관리
- 이해관계자 커뮤니케이션
- 비즈니스 가치 분석
활용 시점:
- PRD 작성 및 검토
- 스코프 조정
- MVP 정의
- 기능 우선순위 결정
/sm - Scrum Master
전문 분야: 애자일 프로세스 및 팀 퍼실리테이션
/sm
스프린트 플래닝에서 이 Epic을 어떻게 분해해야 할까요?역량:
- 스프린트 계획 및 실행
- 장애물 제거
- 프로세스 개선
- 팀 협업 촉진
- 메트릭스 관리
활용 시점:
- 스프린트 계획
- 회고 진행
- 팀 이슈 해결
- 프로세스 개선
/principal-engineer
전문 분야: 시스템 아키텍처 및 기술 전략
/principal-engineer
MSA로 전환할 때 서비스 경계를 어떻게 나눠야 할까요?역량:
- 시스템 아키텍처 설계
- 기술 의사결정
- 성능/확장성 설계
- 기술 부채 관리
- 멘토링
활용 시점:
- 아키텍처 의사결정
- 기술 스택 선정
- 시스템 설계 검토
- 복잡한 기술 문제 해결
/staff-engineer
전문 분야: 기술 리더십 및 조직 영향력
/staff-engineer
이 프로젝트의 기술적 리스크를 평가해주세요.역량:
- 기술 로드맵 수립
- 크로스팀 기술 조율
- 기술 표준화
- 시니어 멘토링
- 기술 전략
활용 시점:
- 기술 전략 수립
- 팀 간 기술 조율
- 기술 표준 정의
- 복잡한 의사결정
/claude-code-expert
전문 분야: Claude Code 및 AI 도구 활용
/claude-code-expert
MCP 서버를 설정하는 방법을 알려주세요.
커스텀 스킬을 만들고 싶어요.역량:
- Claude Code 기능 활용
- MCP 서버 설정
- 커스텀 스킬/에이전트 개발
- AI 페어 프로그래밍
- 프롬프트 엔지니어링
활용 시점:
- Claude Code 기능 질문
- 커스터마이징
- AI 활용 최적화
- 워크플로우 개선
/app-designer - App Designer
전문 분야: UI/UX 디자인 및 사용자 경험 설계
/app-designer
이 기능의 UI/UX를 디자인해주세요.
텍스트 없이도 직관적으로 이해할 수 있어야 합니다.역량:
- 미니멀리즘 디자인 (Apple, Toss 스타일)
- 텍스트 없는 직관적 인터페이스
- 마이크로 인터랙션 설계
- 디자인 시스템 구축
- 모션 디자인
- 접근성(Accessibility) 설계
활용 시점:
- UI/UX 디자인 검토
- 사용자 플로우 설계
- 디자인 시스템 구축
- 인터랙션 디자인
- 프로토타입 피드백
Subagents Reference
Subagent는 특정 시점에 자동으로 호출됩니다. 사용자가 직접 호출할 필요 없이 Claude Code가 적절한 시점에 자동으로 실행합니다.
구현된 Subagents 목록:
- 문서 리뷰: prd-reviewer, hld-reviewer, lld-reviewer, task-reviewer
- 코드 리뷰: code-reviewer
- 테스트 관련: tc-reviewer, acceptance-test-generator, unit-test-generator
- 프로젝트 관리: task-tracker, workflow-navigator
code-reviewer
호출 시점: 코드 작성 완료 후, 커밋 전, PR 생성 시 역할: 코드 품질 검증 및 개선점 제안 (Staff Engineer 관점)
검토 기준:
- 테스트 코드 존재 여부 (필수)
- 코드 품질 (SOLID, Clean Code)
- 아키텍처 준수 (Layer 분리, 의존성 방향)
- 보안 취약점 (SQL Injection, XSS, 인증/인가)
- 성능 이슈 (N+1 쿼리, 메모리 릭, 동시성)
- 에러 처리 (예외 처리, 로깅)
- 유지보수성 (가독성, 문서화)
리뷰 우선순위:
- Priority 1 (MUST FIX): 보안, 버그, 데이터 손실, 테스트 코드 없음
- Priority 2 (SHOULD FIX): 테스트 부족, SOLID 위반, 아키텍처 위반
- Priority 3 (NICE TO HAVE): 변수명, 함수 분리, 리팩토링
tc-reviewer
호출 시점: TC 생성 직후 역할: TC 품질 리뷰 및 보완
검토 기준:
- AC 커버리지 100% 확인
- 경계값/엣지케이스 포함 여부
- 테스트 독립성
- 명확한 기대 결과
acceptance-test-generator
호출 시점: TC 리뷰 완료 후 역할: TC 기반 인수 테스트 코드 생성
생성 위치: src/test/
unit-test-generator
호출 시점: Task 구현 시작 전 역할: TDD 기반 Unit Test 생성 (Red 단계)
Task의 완료 조건(DoD)을 테스트로 변환합니다.
task-tracker
호출 시점: Task 완료, TC 통과, 리뷰 승인 시 역할: Epic/Story/Task 상태 자동 추적
상태 흐름: todo → inprogress → resolve → review → close
prd-reviewer
호출 시점: PRD 생성 후 역할: PRD 품질 검증 및 개선점 제안
검토 기준:
- 문제 정의 명확성
- 요구사항 완전성
- 성공 지표 측정 가능성
- 범위 및 제약사항 명확성
hld-reviewer
호출 시점: HLD 생성 후 역할: 시스템 아키텍처 검증 및 기술 선택 검토
검토 기준:
- 아키텍처 패턴 적합성
- 기술 스택 선택의 타당성
- 확장성 및 성능 고려
- 보안 및 규정 준수
lld-reviewer
호출 시점: LLD 생성 후 역할: 상세 설계 검증 및 구현 가능성 검토
검토 기준:
- API 설계 일관성
- 데이터 모델 정규화
- 에러 처리 전략
- 구현 가능성 및 복잡도
task-reviewer
호출 시점: Task 생성 후 역할: 코딩 에이전트 관점에서 Task 구현 가능성 검증
검토 기준 (7대 항목):
- Context: Story 연결, AS A/I WANT/SO THAT, 선행/후행 관계
- Document References: Story AC, LLD 발췌 (경로만 X)
- Scope: 파일 경로 구체성, 예상 라인 수
- Reference Code: 기존 코드 발췌, 패턴 체크리스트
- Implementation Spec: 데이터 정의, 비즈니스 규칙, 의사 코드
- Acceptance Criteria: Story AC 연결, 검증 가능한 조건
- Test Scenarios: 구체적 입력/출력, Happy Path + Edge Case
심각도 판정:
- FAIL: Critical 1개 이상 OR Major 3개 이상
- PASS with warnings: Major 1-2개
- PASS: 이슈 없음
workflow-navigator
호출 시점: 워크플로우 단계 전환 시 역할: 개발 워크플로우 가이드 및 다음 단계 제안
기능:
- 현재 워크플로우 단계 파악
- 다음 수행 작업 제안
- 필요한 산출물 확인
- 누락된 단계 알림
Workflow Guide
복잡도별 워크플로우 선택
L1~L2: 단순 작업 (버그 수정, 작은 기능)
요구사항 → 바로 구현L3: 중간 복잡도 (일반적인 기능)
요구사항 → Story → Task + LLD → 구현 → TC → 테스트L4~L5: 높은 복잡도 (대규모 기능, 신규 시스템)
요구사항 → PRD → Epic/Story → HLD → LLD → Task → 구현 → TC → 테스트전체 워크플로우 다이어그램
[기획]
요구사항
│
▼
/prd-generator ──────────────────────► PRD 문서
│ │
│ ┌──────────┘
│ ▼
[백로그]│ /epic-generator
│ │
│ ▼
│ Epic
│ │
│ ▼
│ /story-generator
│ │
│ ▼
│ Story
│ │
│ ┌──────────────┼──────────────┐
│ ▼ │ │
[테스트 설계] /tc-generator │ │
│ │ │ │
│ ▼ │ │
│ TC 문서 │ │
│ │ │ │
│ ▼ │ │
│ tc-reviewer (auto) │ │
│ │ │ │
│ ▼ │ │
│ acceptance-test-generator │ │
│ (auto) │ │
│ │ │ │
│ ▼ │ │
│ 인수 테스트 생성 (Red) │ │
│ │ │
│ ▼ ▼
[설계] │ /hld-generator /lld-generator
│ │ │
│ ▼ ▼
│ HLD 문서 LLD 문서
│ │
│ ▼
[구현] │ /task-generator
│ │
│ ▼
│ Implementation Tasks
│ │
│ ┌───────────────────┤
│ ▼ │
[TDD] │ unit-test-generator (auto) │
│ │ │
│ ▼ │
│ Unit Test 생성 (Red) │
│ │ │
│ ▼ ▼
│ 구현 (Green) ◄───── Task 기반 구현
│ │
│ ▼
│ 리팩토링 (Refactor)
│ │
[검증] │ ▼
└────────────────────────► 인수 테스트 실행 (Green)
│
▼
task-tracker (auto)
│
▼
상태 자동 업데이트문서 저장 위치 (Feature 기반 구조)
documents/
├── request/
│ └── <feature>-prd.md # PRD
├── issues/
│ ├── <feature>/ # Feature별 그룹화
│ │ ├── README.md # Epic 개요 (선택)
│ │ ├── stories/
│ │ │ └── STORY-<id>-<name>.md # Story
│ │ └── tasks/
│ │ └── STORY-<id>/ # Story별 Task 그룹화
│ │ └── TASK-<id>.md # Task
│ └── standalone/ # Epic/Feature 없는 독립 작업
│ ├── stories/
│ └── tasks/
├── system-design/
│ └── features/<feature>/
│ ├── hld.md # HLD
│ └── lld.md # LLD
└── test/
├── acceptance/AT-<id>.md # Acceptance Test
└── unit/UT-<id>.md # Unit TestUsage Examples
Example 1: 새 기능 개발 (Full Workflow)
# 1. PRD 생성 (prd-generator 스킬이 자동 호출됨)
사용자 인증 기능의 PRD를 작성해주세요.
- 이메일/비밀번호 로그인
- 소셜 로그인 (Google, Apple)
- 비밀번호 재설정
- 세션 관리
# 2. Epic 생성 (epic-generator 스킬이 자동 호출됨)
@documents/prd/auth-prd.md 기반으로 Epic을 생성해주세요.
# 3. Story 생성 (story-generator 스킬이 자동 호출됨)
@documents/epics/auth/epic.md 기반으로 Story를 생성해주세요.
# 4. TC 생성 (tc-generator 스킬이 자동 호출됨)
# → 이후 tc-reviewer, acceptance-test-generator 서브에이전트가 자동 실행됨
@documents/epics/auth/stories/STORY-001-email-login/story.md 에 대한 테스트 케이스를 작성해주세요.
# 5. HLD 생성 (hld-generator 스킬이 자동 호출됨)
@documents/epics/auth/stories/STORY-001-email-login/story.md 의 HLD를 작성해주세요.
# 6. LLD 생성 (lld-generator 스킬이 자동 호출됨)
@documents/epics/auth/stories/STORY-001-email-login/story.md
@documents/epics/auth/design/hld.md
위 문서를 기반으로 LLD를 작성해주세요.
# 7. Task 생성 (task-generator 스킬이 자동 호출됨)
# → 이후 unit-test-generator 서브에이전트가 자동으로 테스트 먼저 생성
@documents/epics/auth/stories/STORY-001-email-login/story.md
@documents/epics/auth/design/lld.md
구현 태스크를 생성해주세요.
# 8. 구현 시작 (Developer 페르소나 활성화 - Command 사용)
/dev
@documents/epics/auth/stories/STORY-001-email-login/tasks/task-001.md 구현을 시작하겠습니다.
테스트가 통과하도록 구현해주세요.Example 2: 버그 수정 (간단한 워크플로우)
/dev
로그인 시 세션이 제대로 생성되지 않는 버그가 있습니다.
SessionService.createSession() 메서드를 확인해주세요.Example 3: 코드 리뷰 요청
/dev
이 PR의 코드를 리뷰해주세요.
특히 트랜잭션 처리와 예외 처리가 적절한지 확인해주세요.Example 4: 테스트 전략 수립
/qa
이 결제 기능에 대한 테스트 전략을 수립해주세요.
- 어떤 종류의 테스트가 필요한가요?
- 엣지 케이스는 무엇인가요?
- 성능 테스트도 필요한가요?Example 5: 아키텍처 상담
/principal-engineer
현재 모놀리식 아키텍처에서 MSA로 전환을 고려하고 있습니다.
- 서비스 경계는 어떻게 나눠야 할까요?
- 데이터 분리 전략은?
- 전환 시 주의할 점은?Customization
페르소나 커스터마이징
.claude/personas/<name>.md 파일을 수정하여 팀에 맞게 조정:
# Persona: Developer (Dev)
## Identity
[팀의 기술 스택과 문화에 맞게 수정]
## Expertise
[팀에서 중요하게 생각하는 역량 추가]
## Mindset
[팀의 개발 철학 반영]스킬 템플릿 커스터마이징
.claude/skills/<skill>/reference/ 디렉토리의 템플릿 수정:
.claude/skills/prd-generator/reference/
├── prd-template.md # PRD 템플릿 수정
└── prd-examples.md # 예시 추가새 페르소나 추가
# 1. 페르소나 정의
touch .claude/personas/devops.md
# 2. 명령어 정의
touch .claude/commands/devops.mdTroubleshooting
Q: 설치 후 스킬이 인식되지 않아요
# Claude Code 재시작
# 또는 설치 상태 확인
npx muno-claude-plugin statusQ: 기존 .claude 폴더가 있어서 설치가 안 돼요
npx muno-claude-plugin install --forceQ: User Level과 Project Level 중 어떤 걸 선택해야 하나요?
| 상황 | 추천 | |------|------| | 팀 프로젝트 | Project Level (Git 공유) | | 개인 프로젝트 | User Level (전역 적용) | | 팀마다 다른 설정 | Project Level |
Q: 특정 스킬만 설치하고 싶어요
현재는 전체 설치만 지원됩니다. 설치 후 불필요한 파일 삭제 가능:
rm -rf .claude/skills/prd-generator # 특정 스킬 제거Q: Subagent가 자동으로 호출되지 않아요
Subagent는 Claude Code가 해당 시점을 인식할 때 자동 호출됩니다. 명시적으로 호출하려면:
TC 생성이 완료되었습니다. tc-reviewer로 검토해주세요.Requirements
- Node.js >= 18.0.0
- Claude Code CLI
License
MIT
Contributing
이슈 및 PR 환영합니다.
- Fork the repository
- Create your feature branch
- Commit your changes
- Push to the branch
- Create a Pull Request