U-MAKER Plugin v3.4.4

1. 프로젝트 개요

U-MAKER는 Claude Code CLI 위에서 동작하는 PDCA(Plan-Design-Dev-Check-Ship) 기반 소프트웨어 개발 자동화 플러그인입니다. 원시 기획 자료(RFP, 회의록, 와이어프레임 등)를 투입하면, AI 에이전트가 분석 → 설계 → 코드 생성 → 테스트까지 전 과정을 자동 수행하며, 모든 산출물은 SSoT(Single Source of Truth) 원칙으로 일관되게 관리됩니다.

2. 설치 방법

터미널에서 아래 명령 한 줄로 설치할 수 있습니다.

curl -fsSL https://raw.githubusercontent.com/upleat-ax/u-maker-plugin/main/install.sh | bash

3. 파이프라인

U-MAKER의 데이터 흐름은 4단계 파이프라인으로 구성됩니다. 원시 자료가 정제, 분석, 산출물로 변환됩니다.

4. .u-maker/ 폴더 구조

프로젝트 루트에 생성되는 .u-maker/ 디렉토리 구조입니다. /u-plan 최초 실행 시 자동 생성됩니다.

.u-maker/
├── u-maker.config.json          # 프로젝트 설정
├── data/
│   ├── dropzone/                # 원시 입력 파일 (RFP, 회의록 등)
│   ├── digest/                  # 정제된 분석 JSON
│   │   └── _index.json          # 해시 인덱스 (변경 감지)
│   └── links.json               # 글로벌 의존성 그래프
├── docs/
│   └── {app}/
│       ├── plan/                # SRS + IA (.md + .json)
│       ├── design/              # ERD + API + Screens + Design System
│       └── check/               # Test Cases + Test Results
├── output/
│   └── {app}/
│       ├── index.html           # 산출물 내비게이션 인덱스
│       ├── plan/                # Plan HTML (srs.html, ia.html)
│       ├── design/              # Design HTML (erd, api, screens, ds)
│       └── check/               # Check HTML (testcases, results)
├── reports/
│   └── {YYYY-MM-DD}/           # Daily Report HTML
│       └── daily-report.html
└── .state/
    └── loop-state.json          # 런타임 상태 (현재 Phase, Loop 카운트)

5. 13개 Skills

사용자가 직접 호출하는 슬래시 커맨드입니다. 각 스킬은 특정 Phase를 담당하거나 보조 기능을 제공합니다.

6. 7개 Agents

각 에이전트는 특정 역할을 전담합니다. PM이 모든 커맨드를 라우팅하고, 나머지 에이전트가 Phase별 작업을 수행합니다.

7. Gatekeeper 검증항목 (기본 5개, 최대 11개)

모든 Phase 산출물은 Gatekeeper 기준으로 검증됩니다. --loop [N]으로 검증 항목 수를 지정하며(기본 5개, 최대 11개), 각 항목은 0~100점으로 채점되고 평균 95점 이상이어야 다음 Phase로 진행합니다.

┌─────────────────────────────────────────────────────────────┐
│  GATEKEEPER REPORT — Plan Phase (myapp)                  │
├─────┬──────────────────────┬───────┬────────┬───────────────┤
│  #  │ Criteria             │ Score │ Status │ Findings      │
├─────┼──────────────────────┼───────┼────────┼───────────────┤
│  01 │ Completeness  완전성 │   98  │   PASS │ —             │
│  02 │ Accuracy      정확성 │   95  │   PASS │ —             │
│  03 │ Consistency   일관성 │   97  │   PASS │ —             │
│  04 │ Traceability  추적성 │   88  │   FAIL │ FR-030 orphan │
│  05 │ TOC Quality   TOC    │   96  │   PASS │ —             │
│  06 │ Composition   구성   │   95  │   PASS │ —             │
│  07 │ Visual        시각   │   99  │   PASS │ —             │
│  08 │ Diagram       다이어 │   93  │   FAIL │ SVG mismatch  │
│  09 │ Mermaid       무결성 │   90  │   FAIL │ syntax L:45   │
│  10 │ JSON Sync     동기화 │  100  │   PASS │ —             │
│  11 │ Cross-Ref     교차   │   96  │   PASS │ —             │
├─────┼──────────────────────┼───────┼────────┼───────────────┤
│ AVG │                      │ 95.2  │ PASS   │               │
└─────┴──────────────────────┴───────┴────────┴───────────────┘
  Attempt: 1/3 · Threshold: 95 · Result: PASS → advance to Design

8. 커맨드 레퍼런스

모든 커맨드는 /u-{name} 형태로 호출됩니다. 공통 옵션은 아래와 같습니다.

커맨드 목록

9. HTML 산출물

모든 SSoT 문서(.md)는 /u-output 커맨드를 통해 HTML로 변환되어 output/{app}/ 디렉토리에 저장됩니다. Phase 스킬(/u-plan, /u-design, /u-check)은 문서(.md + .json)만 생성하며, HTML 출력은 /u-output으로만 가능합니다. SVG-first 접근으로 인라인 SVG 다이어그램을 기본 사용하며, --diagram 옵션으로 렌더링 모드를 선택할 수 있습니다. 대형 문서(SRS, ERD, API, Screens, TestCases)는 도메인 분할 파이프라인으로 섹션별 개별 HTML을 생성합니다.

output/{app}/
├── index.html                   # 사이드바 내비게이션 인덱스
├── plan/
│   ├── srs.html                 # 요구사항 명세서
│   └── ia.html                  # 정보 아키텍처
├── design/
│   ├── erd.html                 # ER 다이어그램 (Mermaid erDiagram)
│   ├── api.html                 # API 계약서 (Mermaid classDiagram)
│   ├── screens.html             # Screen 명세
│   ├── design-system.html       # Design System (토큰 스워치)
│   └── wireframes/
│       ├── index.html           # 와이어프레임 브라우저
│       └── {SCR-ID}.html        # 화면별 와이어프레임
└── check/
    ├── testcases.html           # 테스트 케이스 (필터링 테이블)
    └── test-results.html        # 테스트 결과 (커버리지 매트릭스)

--diagram 렌더링 모드

HTML 산출물 특징

10. 무인 자동 실행 (u-loop)

/u-loop --app myapp 커맨드로 전체 PDCA 파이프라인을 자동 실행합니다. 각 Phase마다 Gatekeeper가 검증하고, 미달 시 자동 개선합니다.

주요 기능

/u-loop --app myapp

========================================
  u-loop Complete: myapp
========================================
  Phase    | Score  | Attempts | Time
  Plan     | 97.2   | 1        | 2m 15s
  Design   | 95.8   | 2        | 4m 30s
  Dev      | 96.1   | 1        | 3m 45s
  Check    | 98.0   | 1        | 1m 50s
  Ship     | 99.0   | 1        | 0m 30s
========================================
  Status: ALL PHASES PASSED
========================================