Unleash Claude Code's full power - Complete development workflow with expert personas, TDD-based agents, and automated documentation
npm install muno-claude-plugin> Claude Code를 제대로 활용하기 위한 통합 개발 워크플로우 플러그인
AI 기반 소프트웨어 개발의 전체 라이프사이클을 지원합니다. 요구사항 정의부터 테스트까지, 체계적인 워크플로우와 전문가 페르소나를 통해 Claude Code의 잠재력을 극대화합니다.
---
- Quick Start
- Features
- Installation
- Core Concepts
- Skills Reference
- Personas Reference
- Subagents Reference
- Workflow Guide
- Usage Examples
- Customization
- Troubleshooting
---
``bash설치 (Project Level)
npx muno-claude-plugin install
30초 만에 시작하세요. 설치 후 Claude Code에서 바로 사용 가능합니다.
---
Features
$3
PRD → Epic/Story → HLD → LLD → Task → TC 전체 개발 라이프사이클 자동화$3
역할별 전문가 페르소나로 상황에 맞는 최적의 답변 제공$3
테스트 먼저(Test-First) 방식의 자동 서브에이전트 체계$3
Epic/Story/Task 상태 자동 추적 및 관리---
Installation
$3
팀원들과 Git으로 공유할 수 있습니다.
`bash
npx muno-claude-plugin install
`설치 위치:
$3
모든 프로젝트에서 자동 적용됩니다.
`bash
npx muno-claude-plugin install-user
`설치 위치:
~/.claude/$3
| 명령어 | 설명 |
|--------|------|
|
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 | 도움말 |$3
`
.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
$3
| 구분 | 호출 방식 | 용도 | 예시 |
|------|----------|------|------|
| Skill | 자동 호출 | 특정 산출물 생성 | prd-generator, hld-generator |
| Command |
/command-name (슬래시 명령어) | 페르소나 활성화 등 | /dev, /qa, /po |
| Subagent | 자동 호출 | 품질 검증, 테스트 생성 | tc-reviewer, code-reviewer |$3
`
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
$3
Product Requirements Document 자동 생성
호출 조건: "PRD 작성해줘", "기획서 만들어줘", "요구사항 정의서 작성" 등의 요청 시 자동 호출
입력: 요구사항 (자연어)
출력:
documents/prd/사용 예시:
`
사용자가 상품을 장바구니에 담고 주문할 수 있는 기능의 PRD를 작성해줘.
- 장바구니 담기/빼기
- 수량 변경
- 주문서 작성
- 결제 연동
`생성되는 PRD 구조:
- 문제 정의 (Problem Statement)
- 목표 및 성공 지표 (Goals & Metrics)
- 사용자 스토리 (User Stories)
- 기능 요구사항 (Functional Requirements)
- 비기능 요구사항 (Non-Functional Requirements)
- 제약사항 및 가정 (Constraints & Assumptions)
- 용어 정의 (Glossary)
---
$3
Epic 자동 생성
호출 조건: "Epic 생성해줘", "에픽 만들어줘" 등의 요청 시 자동 호출
입력: PRD 문서 또는 요구사항
출력:
documents/epics/{epic-name}/epic.md사용 예시:
`
@documents/prd/cart-prd.md 를 기반으로 Epic을 생성해주세요.
`Epic 포함 내용:
- Epic 설명 및 비즈니스 가치
- 관련 PRD 참조
- 하위 Story 목록
- 완료 기준
---
$3
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)
- 기술적 고려사항
- 의존성
---
$3
High-Level Design 자동 생성
호출 조건: "HLD 작성해줘", "시스템 설계", "아키텍처 문서" 등의 요청 시 자동 호출
입력: Story 또는 PRD
출력:
documents/hld/사용 예시:
`
@backlogs/cart-feature/STORY-001-add-item.md 에 대한 HLD를 작성해주세요.
`HLD 포함 내용:
- 시스템 컨텍스트 다이어그램
- 컴포넌트 아키텍처
- 데이터 흐름
- 기술 스택 선정 근거
- 통합 포인트
- 보안 고려사항
---
$3
Low-Level Design 자동 생성
호출 조건: "LLD 작성해줘", "상세 설계", "API 명세" 등의 요청 시 자동 호출
입력: Story + HLD
출력:
documents/lld/사용 예시:
`
@backlogs/cart-feature/STORY-001-add-item.md
@documents/hld/cart-hld.md위 문서를 기반으로 LLD를 작성해주세요.
`LLD 포함 내용:
- ERD (Entity Relationship Diagram)
- 클래스/모듈 설계
- API 명세 (OpenAPI 형식)
- 시퀀스 다이어그램
- 에러 처리 전략
- 데이터 검증 규칙
---
$3
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)
- 기술적 상세
- 의존 태스크
- 예상 복잡도
---
$3
Test Case 자동 생성
호출 조건: "테스트 케이스 작성해줘", "TC 만들어줘", "테스트 시나리오 생성" 등의 요청 시 자동 호출
입력: Story (Acceptance Criteria)
출력:
test-cases/ 디렉토리사용 예시:
`
@backlogs/cart-feature/STORY-001-add-item.mdAC 기반 테스트 케이스를 생성해주세요.
`생성 구조:
`
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:
1.
tc-reviewer - TC 품질 리뷰 및 보완
2. acceptance-test-generator - 실제 테스트 코드 생성---
$3
모든 TODO 상태 Task를 한 번에 순차 실행
호출 조건: "100개 task 실행", "모든 task 구현", "bulk 실행", "전체 task 처리" 등의 요청 시 자동 호출
입력: documents/issues/ 디렉토리의 Task 파일들
출력: 구현 완료된 코드 + 완료 리포트
사용 예시:
`
documents/issues/ 에 있는 모든 TODO 상태 task를 실행해줘.
`동작 과정:
1.
documents/issues//tasks//*.md 검색
2. Frontmatter에서 status: todo 필터링
3. dependencies 순서로 정렬
4. 각 Task 순차 실행:
- Task 문서 읽기
- 코드 구현 (Write/Edit)
- 테스트 실행 (Bash)
- Frontmatter status 업데이트 (todo → done)
5. 완료 리포트 생성자동 트리거되는 Subagent:
- ✅
unit-test-generator - Task 구현 전 테스트 생성 (TDD)
- ✅ code-reviewer - 코드 작성 완료 후 리뷰
- ✅ task-tracker - Task 완료 시 상태 추적Ralph와 함께 사용하기:
대량의 Task (50개 이상)를 중단 없이 처리하려면 Ralph Wiggum 플러그인과 함께 사용하세요:
`bash
Ralph 설치 (한 번만)
git clone https://github.com/frankbria/ralph-claude-code.git
cd ralph-claude-code
./install.shRalph로 bulk-executor 실행
/ralph-loop "/bulk-executor" --max-iterations 100
`Ralph가 필요한 이유:
- Claude Code는 작업 완료 시 자동 종료
- Ralph는 종료를 감지하고 자동으로 재시작
- 100개 Task도 중단 없이 처리 가능
고급 옵션:
`bash
Feature별 실행
/bulk-executor --feature=auth실패한 Task만 재실행
/bulk-executor --failed-onlyDry run (테스트 실행)
/bulk-executor --dry-run
`참고 문서:
- Ralph 연동 가이드
---
$3
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
참고 자료:
- Apple Human Interface Guidelines
- Toss Design System
---
$3
Swagger/OpenAPI 문서 → Markdown 자동 변환
호출 조건: "API 문서 만들어줘", "Swagger 문서화", "OpenAPI 변환" 등의 요청 시 자동 호출
입력: Swagger 문서 URL
출력:
documents/api/사용 예시:
`
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 생성
- 버전별 문서 관리
---
$3
System Architecture Document (SAD) 자동 생성
호출 조건: "아키텍처 문서 만들어줘", "시스템 구조", "전체 아키텍처" 등의 요청 시 자동 호출
입력: 시스템 요구사항
출력:
documents/architecture/system-architecture.md사용 예시:
`
전체 시스템 아키텍처 문서를 작성해주세요.
현재 프로젝트는 Spring Boot 기반 백엔드와 React 프론트엔드로 구성됩니다.
`SAD 포함 내용:
- 시스템 컨텍스트 및 비즈니스 목표
- 전체 컴포넌트 구성
- 기술 스택 및 인프라
- 데이터 흐름 및 통신 패턴
- 보안 아키텍처
- 확장성 전략
SAD vs Feature HLD:
- SAD: 전체 시스템 1개 (지속적 업데이트)
- HLD: 각 피처별 다수 (피처 단위 설계)
---
$3
Implementation Task 품질 검증
호출 조건: "태스크 검토해줘", "Task 리뷰해줘", "구현 스펙 검증" 등의 요청 시 자동 호출
입력: 생성된 Implementation Tasks
출력: 검토 결과 및 개선 제안
사용 예시:
`
.tasks/STORY-001/ 디렉토리의 태스크들을 검토해주세요.
코딩 에이전트가 바로 구현할 수 있는 수준인지 확인해주세요.
`검토 기준:
- 명시성: 추론 없이 구현 가능한 명확성
- 완전성: 필요한 모든 정보 포함 여부
- 구체성: 파일명, 클래스명, 메서드 시그니처 명시
- 테스트 가능성: DoD(Definition of Done) 명확성
핵심 원칙:
> 코딩 에이전트는 추론하면 틀린다. Task에 모든 정보가 명시적으로 포함되어야 한다.
---
Personas Reference
$3
전문 분야: 소프트웨어 설계 및 구현
`
/dev이 서비스 클래스의 트랜잭션 처리가 적절한지 검토해주세요.
`역량:
- 클린 코드 & SOLID 원칙
- 디자인 패턴 적용
- TDD/BDD 실천
- 성능 최적화
- 코드 리뷰
활용 시점:
- 코드 구현 중 설계 질문
- 리팩토링 조언
- 버그 분석 및 해결
- 코드 리뷰 요청
---
$3
전문 분야: 테스트 설계 및 품질 보증
`
/qa이 기능에 대한 테스트 전략을 수립해주세요.
엣지 케이스와 경계값 테스트도 포함해주세요.
`역량:
- 테스트 전략 수립
- TC 설계 (경계값, 동등 분할)
- 자동화 테스트 설계
- 탐색적 테스트
- 성능/보안 테스트
활용 시점:
- TC 작성 전 전략 수립
- 테스트 커버리지 검토
- 버그 재현 시나리오 설계
- 테스트 자동화 설계
---
$3
전문 분야: 제품 기획 및 요구사항 관리
`
/po이 기능의 우선순위를 어떻게 정해야 할까요?
MVP 범위를 정의해주세요.
`역량:
- 요구사항 정의 및 우선순위화
- 사용자 스토리 작성
- 백로그 관리
- 이해관계자 커뮤니케이션
- 비즈니스 가치 분석
활용 시점:
- PRD 작성 및 검토
- 스코프 조정
- MVP 정의
- 기능 우선순위 결정
---
$3
전문 분야: 애자일 프로세스 및 팀 퍼실리테이션
`
/sm스프린트 플래닝에서 이 Epic을 어떻게 분해해야 할까요?
`역량:
- 스프린트 계획 및 실행
- 장애물 제거
- 프로세스 개선
- 팀 협업 촉진
- 메트릭스 관리
활용 시점:
- 스프린트 계획
- 회고 진행
- 팀 이슈 해결
- 프로세스 개선
---
$3
전문 분야: 시스템 아키텍처 및 기술 전략
`
/principal-engineerMSA로 전환할 때 서비스 경계를 어떻게 나눠야 할까요?
`역량:
- 시스템 아키텍처 설계
- 기술 의사결정
- 성능/확장성 설계
- 기술 부채 관리
- 멘토링
활용 시점:
- 아키텍처 의사결정
- 기술 스택 선정
- 시스템 설계 검토
- 복잡한 기술 문제 해결
---
$3
전문 분야: 기술 리더십 및 조직 영향력
`
/staff-engineer이 프로젝트의 기술적 리스크를 평가해주세요.
`역량:
- 기술 로드맵 수립
- 크로스팀 기술 조율
- 기술 표준화
- 시니어 멘토링
- 기술 전략
활용 시점:
- 기술 전략 수립
- 팀 간 기술 조율
- 기술 표준 정의
- 복잡한 의사결정
---
$3
전문 분야: Claude Code 및 AI 도구 활용
`
/claude-code-expertMCP 서버를 설정하는 방법을 알려주세요.
커스텀 스킬을 만들고 싶어요.
`역량:
- Claude Code 기능 활용
- MCP 서버 설정
- 커스텀 스킬/에이전트 개발
- AI 페어 프로그래밍
- 프롬프트 엔지니어링
활용 시점:
- Claude Code 기능 질문
- 커스터마이징
- AI 활용 최적화
- 워크플로우 개선
---
$3
전문 분야: 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
$3
호출 시점: 코드 작성 완료 후, 커밋 전, 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): 변수명, 함수 분리, 리팩토링
---
$3
호출 시점: TC 생성 직후
역할: TC 품질 리뷰 및 보완
검토 기준:
- AC 커버리지 100% 확인
- 경계값/엣지케이스 포함 여부
- 테스트 독립성
- 명확한 기대 결과
---
$3
호출 시점: TC 리뷰 완료 후
역할: TC 기반 인수 테스트 코드 생성
생성 위치:
src/test/---
$3
호출 시점: Task 구현 시작 전
역할: TDD 기반 Unit Test 생성 (Red 단계)
Task의 완료 조건(DoD)을 테스트로 변환합니다.
---
$3
호출 시점: Task 완료, TC 통과, 리뷰 승인 시
역할: Epic/Story/Task 상태 자동 추적
상태 흐름:
todo → inprogress → resolve → review → close---
$3
호출 시점: PRD 생성 후
역할: PRD 품질 검증 및 개선점 제안
검토 기준:
- 문제 정의 명확성
- 요구사항 완전성
- 성공 지표 측정 가능성
- 범위 및 제약사항 명확성
---
$3
호출 시점: HLD 생성 후
역할: 시스템 아키텍처 검증 및 기술 선택 검토
검토 기준:
- 아키텍처 패턴 적합성
- 기술 스택 선택의 타당성
- 확장성 및 성능 고려
- 보안 및 규정 준수
---
$3
호출 시점: LLD 생성 후
역할: 상세 설계 검증 및 구현 가능성 검토
검토 기준:
- API 설계 일관성
- 데이터 모델 정규화
- 에러 처리 전략
- 구현 가능성 및 복잡도
---
$3
호출 시점: 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: 이슈 없음
---
$3
호출 시점: 워크플로우 단계 전환 시
역할: 개발 워크플로우 가이드 및 다음 단계 제안
기능:
- 현재 워크플로우 단계 파악
- 다음 수행 작업 제안
- 필요한 산출물 확인
- 누락된 단계 알림
---
Workflow Guide
$3
#### L1~L2: 단순 작업 (버그 수정, 작은 기능)
`
요구사항 → 바로 구현
`#### L3: 중간 복잡도 (일반적인 기능)
`
요구사항 → Story → Task + LLD → 구현 → TC → 테스트
`#### L4~L5: 높은 복잡도 (대규모 기능, 신규 시스템)
`
요구사항 → PRD → Epic/Story → HLD → LLD → Task → 구현 → TC → 테스트
`$3
`
[기획]
요구사항
│
▼
/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)
│
▼
상태 자동 업데이트
`$3
`
documents/
├── request/
│ └── -prd.md # PRD
├── issues/
│ ├── / # Feature별 그룹화
│ │ ├── README.md # Epic 개요 (선택)
│ │ ├── stories/
│ │ │ └── STORY--.md # Story
│ │ └── tasks/
│ │ └── STORY-/ # Story별 Task 그룹화
│ │ └── TASK-.md # Task
│ └── standalone/ # Epic/Feature 없는 독립 작업
│ ├── stories/
│ └── tasks/
├── system-design/
│ └── features//
│ ├── hld.md # HLD
│ └── lld.md # LLD
└── test/
├── acceptance/AT-.md # Acceptance Test
└── unit/UT-.md # Unit Test
`---
Usage Examples
$3
`
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 구현을 시작하겠습니다.
테스트가 통과하도록 구현해주세요.
`$3
`bash
/dev
로그인 시 세션이 제대로 생성되지 않는 버그가 있습니다.
SessionService.createSession() 메서드를 확인해주세요.
`$3
`bash
/dev
이 PR의 코드를 리뷰해주세요.
특히 트랜잭션 처리와 예외 처리가 적절한지 확인해주세요.
`$3
`bash
/qa
이 결제 기능에 대한 테스트 전략을 수립해주세요.
- 어떤 종류의 테스트가 필요한가요?
- 엣지 케이스는 무엇인가요?
- 성능 테스트도 필요한가요?
`$3
`bash
/principal-engineer
현재 모놀리식 아키텍처에서 MSA로 전환을 고려하고 있습니다.
- 서비스 경계는 어떻게 나눠야 할까요?
- 데이터 분리 전략은?
- 전환 시 주의할 점은?
`---
Customization
$3
.claude/personas/ 파일을 수정하여 팀에 맞게 조정:`markdown
Persona: Developer (Dev)
Identity
[팀의 기술 스택과 문화에 맞게 수정]Expertise
[팀에서 중요하게 생각하는 역량 추가]Mindset
[팀의 개발 철학 반영]
`$3
.claude/skills/ 디렉토리의 템플릿 수정:`
.claude/skills/prd-generator/reference/
├── prd-template.md # PRD 템플릿 수정
└── prd-examples.md # 예시 추가
`$3
`bash
1. 페르소나 정의
touch .claude/personas/devops.md2. 명령어 정의
touch .claude/commands/devops.md
`---
Troubleshooting
$3
`bash
Claude Code 재시작
또는 설치 상태 확인
npx muno-claude-plugin status
`$3
`bash
npx muno-claude-plugin install --force
`$3
| 상황 | 추천 |
|------|------|
| 팀 프로젝트 | Project Level (Git 공유) |
| 개인 프로젝트 | User Level (전역 적용) |
| 팀마다 다른 설정 | Project Level |
$3
현재는 전체 설치만 지원됩니다. 설치 후 불필요한 파일 삭제 가능:
`bash
rm -rf .claude/skills/prd-generator # 특정 스킬 제거
`$3
Subagent는 Claude Code가 해당 시점을 인식할 때 자동 호출됩니다.
명시적으로 호출하려면:
`
TC 생성이 완료되었습니다. tc-reviewer로 검토해주세요.
``---
- Node.js >= 18.0.0
- Claude Code CLI
---
MIT
---
이슈 및 PR 환영합니다.
1. Fork the repository
2. Create your feature branch
3. Commit your changes
4. Push to the branch
5. Create a Pull Request