@su-record/vibe 2.8.52 → 2.9.1

package/README.ko.md

@@ -7,57 +7,50 @@
 [![Node.js](https://img.shields.io/badge/node-%3E%3D18-green)](https://nodejs.org/)
 [![License: MIT](https://img.shields.io/badge/license-MIT-yellow.svg)](LICENSE)
 
-> 한 번 설치하면 에이전트 56개, 스킬 45개, 멀티 LLM 오케스트레이션, 자동 품질 게이트가 기존 AI 코딩 워크플로우에 추가됩니다.
+Vibe는 AI 코딩 도구를 위한 품질 하네스입니다. Claude Code, Codex, Cursor, Gemini CLI를 감싸고, 타입 안전성, 코드 품질, 보안을 자동으로 강제합니다.
 
 ```bash
 npm install -g @su-record/vibe
 vibe init
 ```
 
-**Claude Code**, **Codex**, **Cursor**, **Gemini CLI**에서 동작합니다.
-
 ---
 
-## 문제
+## 이렇게 동작합니다
 
-AI 코딩 도구는 동작하는 코드를 생성하지만:
+```
+사용자: "사용자 인증 추가해줘"
 
-- 타입은 `any`, 리뷰는 생략, 테스트는 잊혀짐
-- 문제를 수동으로 잡아냄 — 이미 피해가 발생한 뒤에
-- 세션 간 컨텍스트가 사라짐
-- 복잡한 작업은 구조 없이 산으로 감
+  /vibe.spec        → GPT + Gemini 병렬 리서치 → SPEC 문서 자동 생성
+  /vibe.run         → SPEC 기반 구현 → 12개 에이전트 병렬 리뷰
+  품질 게이트        → any 타입 차단, 긴 함수 차단, 위험한 명령 차단
+  완료              → 리뷰 통과된 타입 안전 코드만 남음
 
-**Vibe는 하네스입니다.** AI 코딩 도구를 감싸고, 코드 생성 전/중/후에 품질을 자동으로 강제합니다.
+전부 자동. 프롬프트 한 줄이면 됩니다.
+```
 
 ---
 
-## 작동 원리
+## 빠른 시작
 
-```
-Agent = Model + Harness
-```
+```bash
+# 1. 설치
+npm install -g @su-record/vibe
 
-| | 역할 | 구성 요소 |
-|---|------|----------|
-| **Guides** (피드포워드) | 행동 **전에** 방향 설정 | CLAUDE.md, 에이전트 56개, 스킬 45개, 코딩 규칙 |
-| **Sensors** (피드백) | 행동 **후에** 관찰·교정 | 훅 21개, 품질 게이트, 이볼루션 엔진 |
+# 2. 프로젝트 초기화 (스택 자동 감지)
+cd your-project
+vibe init
 
-### 워크플로우
+# 3. AI 코딩 도구와 함께 사용
+claude                                 # Claude Code
+# 또는 codex, cursor, gemini — 모두 지원
 
-```mermaid
-flowchart LR
-    A["/vibe.spec"] --> B["/vibe.spec.review"]
-    B --> C["/vibe.run"]
-    C --> D["자동 리뷰"]
-    D --> E["완료"]
+# 4. 워크플로우 시작
+/vibe.spec "사용자 인증 추가"            # 요구사항 작성
+/vibe.run                              # SPEC 기반 구현
 ```
 
-1. **정의** — `/vibe.spec`이 GPT + Gemini 병렬 리서치로 요구사항 작성
-2. **검증** — `/vibe.spec.review`가 3중 교차 검증 실행 (Claude + GPT + Gemini)
-3. **구현** — `/vibe.run`이 SPEC 기반 구현 + 병렬 코드 리뷰
-4. **리뷰** — 12개 에이전트가 병렬 리뷰, P1/P2 이슈 자동 수정
-
-`ultrawork`를 추가하면 전체 파이프라인이 자동화됩니다:
+`ultrawork`를 붙이면 전체 파이프라인이 자동화됩니다:
 
 ```bash
 /vibe.run "사용자 인증 추가" ultrawork
@@ -65,112 +58,39 @@ flowchart LR
 
 ---
 
-## 핵심 기능
-
-**품질 게이트** — `any` 타입, `@ts-ignore`, 50줄 초과 함수를 차단합니다. 3계층 방어: 센티넬 가드 → 프리툴 가드 → 코드 체크.
-
-**56개 전문 에이전트** — 탐색, 구현, 아키텍처, 12개 병렬 리뷰어, 8개 UI/UX 에이전트, QA 코디네이터. 각 에이전트는 범용 래퍼가 아닌 목적 특화 설계.
-
-**멀티 LLM 오케스트레이션** — Claude로 오케스트레이션, GPT로 추론, Gemini로 리서치. 가용 모델에 따라 자동 라우팅. 기본값은 Claude 단독 운영.
+## 주요 기능
 
-**Session RAG** — SQLite + FTS5 하이브리드 검색으로 결정, 제약, 목표를 세션 간 지속. 세션 시작 시 컨텍스트 자동 복원.
+**품질 게이트** — `any` 타입, `@ts-ignore`, 50줄 초과 함수를 차단. 3계층 방어가 모든 도구 호출마다 실행.
 
-**24개 프레임워크 감지** — 스택 자동 감지 (Next.js, React, Django, Spring Boot, Rails, Go, Rust 외 17종) 후 프레임워크별 규칙 적용. 모노레포 인식.
+**전문 에이전트** — 탐색, 구현, 아키텍처, 코드 리뷰(12개 병렬), UI/UX 분석 등 56개 목적 특화 에이전트.
 
-**자기 개선** — 이볼루션 엔진이 훅 실행 패턴을 분석하고, 스킬 갭을 감지하고, 새 규칙을 생성. 회귀 발생 시 서킷 브레이커가 롤백.
+**멀티 LLM** — Claude가 오케스트레이션, GPT가 추론, Gemini가 리서치. 가용 모델에 따라 자동 라우팅. 기본값은 Claude 단독.
 
----
-
-## 포함 내용
-
-| 분류 | 수량 | 예시 |
-|------|------|------|
-| **에이전트** | 56 | Explorer, Implementer, Architect (각 3단계), 리뷰 전문가 12개, UI/UX 8개, QA 코디네이터 |
-| **스킬** | 45 | 3티어 시스템 (core/standard/optional) — 컨텍스트 과부하 방지 |
-| **훅** | 21 | 세션 복원, 파괴적 명령 차단, 자동 포맷, 품질 체크, 컨텍스트 자동 저장 |
-| **프레임워크** | 24 | TypeScript (12), Python (2), Java/Kotlin (2), Rails, Go, Rust, Swift, Flutter, Unity, Godot |
-| **슬래시 커맨드** | 11 | `/vibe.spec`, `/vibe.run`, `/vibe.review`, `/vibe.trace`, `/vibe.figma` 등 |
+**세션 메모리** — 결정, 제약, 목표가 SQLite + FTS5 검색으로 세션 간 유지.
 
----
-
-## 멀티 CLI 지원
+**스택 감지** — 24개 프레임워크 자동 감지 (Next.js, Django, Rails, Go, Rust, Flutter 등) 후 프레임워크별 규칙 적용.
 
-| CLI | 에이전트 | 스킬 | 지침 파일 |
-|-----|---------|------|----------|
-| Claude Code | `~/.claude/agents/` | `~/.claude/skills/` | `CLAUDE.md` |
-| Codex | `~/.codex/plugins/vibe/` | 플러그인 내장 | `AGENTS.md` |
-| Cursor | `~/.cursor/agents/` | `~/.cursor/skills/` | `.cursorrules` |
-| Gemini CLI | `~/.gemini/agents/` | `~/.gemini/skills/` | `GEMINI.md` |
+**Figma → 코드** — 트리 기반 구조적 매핑으로 디자인 대비 90% 완성도 목표. Figma REST API에서 30+ CSS 속성을 추출하여 반응형 코드 생성.
 
 ---
 
-## 멀티 LLM 라우팅
-
-| 프로바이더 | 역할 | 필수 여부 |
-|-----------|------|----------|
-| **Claude** | 오케스트레이션, SPEC, 리뷰 | 필수 (Claude Code) |
-| **GPT** | 추론, 아키텍처, 엣지 케이스 | 선택 (Codex CLI 또는 API Key) |
-| **Gemini** | 리서치, 교차 검증, UI/UX | 선택 (gemini-cli 또는 API Key) |
+## 지원 도구
 
-가용 모델에 따라 자동 전환. 기본값은 Claude 단독 — GPT와 Gemini는 강화 옵션.
-
-Codex CLI나 gemini-cli가 설치되어 있으면 자동 감지됩니다. 직접 API Key를 설정하려면:
-
-```bash
-vibe gpt key <your-api-key>
-vibe gemini key <your-api-key>
-```
+| CLI | 상태 |
+|-----|------|
+| [Claude Code](https://claude.ai/code) | 전체 지원 |
+| [Codex](https://github.com/openai/codex) | 플러그인 |
+| [Cursor](https://cursor.sh) | 에이전트 + 룰 |
+| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | 에이전트 + 스킬 |
 
 ---
 
-## Figma → 코드
-
-트리 기반 구조적 매핑으로 디자인을 코드로 변환 (스크린샷 추정이 아님).
-
-```bash
-/vibe.figma              # 모든 URL 한번에 입력 (스토리보드 + 모바일 + 데스크탑)
-/vibe.figma --new        # 새 피처 모드 (독립 스타일 생성)
-/vibe.figma --refine     # 보완 모드 (기존 코드 + Figma 재비교 → 수정)
-```
-
-스토리보드·모바일·데스크탑 Figma URL을 한번에 전달. Figma REST API로 트리 + 노드 이미지 추출 → 브레이크포인트 간 리매핑 → 스택 인식 코드 생성 (React/Vue/Svelte/SCSS/Tailwind) → 시각 검증 루프.
-
----
-
-## CLI 레퍼런스
-
-```bash
-vibe init                      # 프로젝트 초기화 (스택 감지, 하네스 설치)
-vibe update                    # 스택 재감지, 설정 새로고침
-vibe upgrade                   # 최신 버전 업그레이드
-vibe status                    # 현재 상태 확인
-vibe config show               # 통합 설정 보기
-vibe stats [--week|--quality]  # 사용량 텔레메트리
-
-vibe gpt key|status            # GPT API Key 설정
-vibe gemini key|status         # Gemini API Key 설정
-vibe figma breakpoints         # 반응형 브레이크포인트
-vibe skills add <owner/repo>   # skills.sh에서 스킬 설치
-```
-
----
-
-## 설정
-
-| 파일 | 용도 |
-|------|------|
-| `~/.vibe/config.json` | 글로벌 — 인증, 채널, 모델 (0o600) |
-| `.claude/vibe/config.json` | 프로젝트 — 스택, 기능, 품질 설정 |
-
----
+## 문서
 
-## 매직 키워드
+상세 가이드, 스킬 레퍼런스, 설정 방법은 [Wiki](https://github.com/su-record/vibe/wiki)를 참고하세요.
 
-| 키워드 | 효과 |
-|--------|------|
-| `ultrawork` | 전체 자동화 — 병렬 에이전트 + 자동 계속 + 품질 루프 |
-| `ralph` | 100% 완료까지 반복 (스코프 축소 없음) |
-| `quick` | 빠른 모드, 최소 검증 |
+- [README (English)](README.md)
+- [릴리스 노트](RELEASE_NOTES.md)
 
 ---
 
@@ -178,12 +98,7 @@ vibe skills add <owner/repo>   # skills.sh에서 스킬 설치
 
 - Node.js >= 18.0.0
 - Claude Code (필수)
-- GPT, Gemini (선택 — 멀티 LLM 기능용)
-
-## 문서
-
-- [README (English)](README.md)
-- [릴리스 노트](RELEASE_NOTES.md)
+- GPT, Gemini (선택)
 
 ## 라이선스
 

package/README.md

@@ -7,170 +7,90 @@
 [![Node.js](https://img.shields.io/badge/node-%3E%3D18-green)](https://nodejs.org/)
 [![License: MIT](https://img.shields.io/badge/license-MIT-yellow.svg)](LICENSE)
 
-> One install. 56 agents, 45 skills, multi-LLM orchestration, and automated quality gates — added to your existing AI coding workflow.
+Vibe is a quality harness for AI coding tools. It wraps around Claude Code, Codex, Cursor, or Gemini CLI and automatically enforces type safety, code quality, and security — before, during, and after code generation.
 
 ```bash
 npm install -g @su-record/vibe
 vibe init
 ```
 
-Works with **Claude Code**, **Codex**, **Cursor**, and **Gemini CLI**.
-
----
-
-## The Problem
-
-AI coding tools generate working code, but:
-
-- Types are `any`, reviews are skipped, tests are forgotten
-- You catch issues manually — after the damage is done
-- Context vanishes between sessions
-- Complex tasks spiral without structure
-
-**Vibe is a harness.** It wraps around your AI coding tool and enforces quality automatically — before, during, and after code generation.
-
 ---
 
 ## How It Works
 
 ```
-Agent = Model + Harness
-```
-
-| | Role | What's Inside |
-|---|------|--------------|
-| **Guides** (feedforward) | Set direction *before* action | CLAUDE.md, 56 agents, 45 skills, coding rules |
-| **Sensors** (feedback) | Observe and correct *after* action | 21 hooks, quality gates, evolution engine |
+You: "Add user authentication"
 
-### Workflow
+  /vibe.spec        → GPT + Gemini research in parallel → SPEC document
+  /vibe.run         → Implement from SPEC → 12 agents review in parallel
+  Quality gates     → Block any types, long functions, dangerous commands
+  Done              → Only reviewed, type-safe code remains
 
-```mermaid
-flowchart LR
-    A["/vibe.spec"] --> B["/vibe.spec.review"]
-    B --> C["/vibe.run"]
-    C --> D["Auto Review"]
-    D --> E["Done"]
+Every step is automatic. You type one prompt.
 ```
 
-1. **Define** — `/vibe.spec` writes requirements with GPT + Gemini parallel research
-2. **Review** — `/vibe.spec.review` runs triple cross-validation (Claude + GPT + Gemini)
-3. **Implement** — `/vibe.run` builds from SPEC with parallel code review
-4. **Verify** — 12 agents review in parallel, P1/P2 issues auto-fixed
-
-Add `ultrawork` to run the entire pipeline hands-free:
-
-```bash
-/vibe.run "add user authentication" ultrawork
-```
-
----
-
-## Key Features
-
-**Quality Gates** — Blocks `any` types, `@ts-ignore`, functions > 50 lines. Three-layer defense: sentinel guard → pre-tool guard → code check.
-
-**56 Specialized Agents** — Exploration, implementation, architecture, 12 parallel reviewers, 8 UI/UX agents, QA coordination. Each agent is purpose-built, not a generic wrapper.
-
-**Multi-LLM Orchestration** — Claude for orchestration, GPT for reasoning, Gemini for research. Auto-routes based on available models. Works Claude-only by default.
-
-**Session RAG** — SQLite + FTS5 hybrid search persists decisions, constraints, and goals across sessions. Context is restored automatically on session start.
-
-**24 Framework Detection** — Auto-detects your stack (Next.js, React, Django, Spring Boot, Rails, Go, Rust, and 17 more) and applies framework-specific rules. Monorepo-aware.
-
-**Self-Improvement** — Evolution engine analyzes hook execution patterns, detects skill gaps, and generates new rules. Circuit breaker rolls back on regression.
-
 ---
 
-## What's Included
-
-| Category | Count | Examples |
-|----------|-------|---------|
-| **Agents** | 56 | Explorer, Implementer, Architect (3 depth levels each), 12 review specialists, 8 UI/UX, QA coordinator |
-| **Skills** | 45 | 3-tier system (core/standard/optional) to prevent context overload |
-| **Hooks** | 21 | Session restore, destructive command blocking, auto-format, quality check, context auto-save |
-| **Frameworks** | 24 | TypeScript (12), Python (2), Java/Kotlin (2), Rails, Go, Rust, Swift, Flutter, Unity, Godot |
-| **Slash Commands** | 11 | `/vibe.spec`, `/vibe.run`, `/vibe.review`, `/vibe.trace`, `/vibe.figma`, and more |
+## Quick Start
 
----
-
-## Multi-CLI Support
-
-| CLI | Agents | Skills | Instructions |
-|-----|--------|--------|-------------|
-| Claude Code | `~/.claude/agents/` | `~/.claude/skills/` | `CLAUDE.md` |
-| Codex | `~/.codex/plugins/vibe/` | Plugin built-in | `AGENTS.md` |
-| Cursor | `~/.cursor/agents/` | `~/.cursor/skills/` | `.cursorrules` |
-| Gemini CLI | `~/.gemini/agents/` | `~/.gemini/skills/` | `GEMINI.md` |
-
----
+```bash
+# 1. Install
+npm install -g @su-record/vibe
 
-## Multi-LLM Routing
+# 2. Initialize your project (auto-detects stack)
+cd your-project
+vibe init
 
-| Provider | Role | Required |
-|----------|------|----------|
-| **Claude** | Orchestration, SPEC, review | Yes (via Claude Code) |
-| **GPT** | Reasoning, architecture, edge cases | Optional (Codex CLI or API key) |
-| **Gemini** | Research, cross-validation, UI/UX | Optional (gemini-cli or API key) |
+# 3. Use with your AI coding tool
+claude                              # Claude Code
+# or codex, cursor, gemini — all supported
 
-Auto-switches based on model availability. Claude-only is the default — GPT and Gemini enhance but aren't required.
+# 4. Try the workflow
+/vibe.spec "add user authentication"   # Write requirements
+/vibe.run                              # Implement from SPEC
+```
 
-Codex CLI or gemini-cli are auto-detected if installed. To set API keys manually:
+Add `ultrawork` to any command for full automation:
 
 ```bash
-vibe gpt key <your-api-key>
-vibe gemini key <your-api-key>
+/vibe.run "add user authentication" ultrawork
 ```
 
 ---
 
-## Figma → Code
+## What It Does
 
-Design-to-code pipeline with tree-based structural mapping (not screenshot guessing).
+**Quality gates** — Blocks `any` types, `@ts-ignore`, functions over 50 lines. Three-layer defense runs on every tool call.
 
-```bash
-/vibe.figma              # All URLs at once (storyboard + mobile + desktop)
-/vibe.figma --new        # New feature mode (create standalone styles)
-/vibe.figma --refine     # Refine mode (compare existing code with Figma → fix)
-```
+**Specialized agents** — 56 purpose-built agents for exploration, implementation, architecture, code review (12 in parallel), and UI/UX analysis.
 
-Pass storyboard, mobile, and desktop Figma URLs together. Extracts tree + node images via Figma REST API → remaps across breakpoints → generates stack-aware code (React/Vue/Svelte/SCSS/Tailwind) → visual verification loop.
+**Multi-LLM** — Claude orchestrates, GPT reasons, Gemini researches. Auto-routes by availability. Works Claude-only by default.
 
----
+**Session memory** — Decisions, constraints, and goals persist across sessions via SQLite + FTS5 hybrid search.
 
-## CLI Reference
+**Stack detection** — Auto-detects 24 frameworks (Next.js, Django, Rails, Go, Rust, Flutter, and more) and applies framework-specific rules.
 
-```bash
-vibe init                      # Initialize project (detect stack, install harness)
-vibe update                    # Re-detect stacks, refresh config
-vibe upgrade                   # Upgrade to latest version
-vibe status                    # Show current status
-vibe config show               # Unified config view
-vibe stats [--week|--quality]  # Usage telemetry
-
-vibe gpt key|status            # GPT API key setup
-vibe gemini key|status         # Gemini API key setup
-vibe figma breakpoints         # Responsive breakpoints
-vibe skills add <owner/repo>   # Install skills from skills.sh
-```
+**Figma → Code** — Tree-based structural mapping targeting 90% design fidelity. Extracts 30+ CSS properties from Figma REST API, remaps across breakpoints, generates responsive code.
 
 ---
 
-## Configuration
+## Supported Tools
 
-| File | Purpose |
-|------|---------|
-| `~/.vibe/config.json` | Global — credentials, channels, models (0o600) |
-| `.claude/vibe/config.json` | Project — stacks, capabilities, quality settings |
+| CLI | Status |
+|-----|--------|
+| [Claude Code](https://claude.ai/code) | Full support |
+| [Codex](https://github.com/openai/codex) | Plugin |
+| [Cursor](https://cursor.sh) | Agents + Rules |
+| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | Agents + Skills |
 
 ---
 
-## Magic Keywords
+## Documentation
+
+Full guides, skill reference, and configuration details are in the [Wiki](https://github.com/su-record/vibe/wiki).
 
-| Keyword | Effect |
-|---------|--------|
-| `ultrawork` | Full automation — parallel agents + auto-continue + quality loop |
-| `ralph` | Iterate until 100% complete (no scope reduction) |
-| `quick` | Fast mode, minimal verification |
+- [README (Korean)](README.ko.md)
+- [Release Notes](RELEASE_NOTES.md)
 
 ---
 
@@ -178,12 +98,7 @@ vibe skills add <owner/repo>   # Install skills from skills.sh
 
 - Node.js >= 18.0.0
 - Claude Code (required)
-- GPT, Gemini (optional — for multi-LLM features)
-
-## Documentation
-
-- [README (Korean)](README.ko.md)
-- [Release Notes](RELEASE_NOTES.md)
+- GPT, Gemini (optional)
 
 ## License
 

package/agents/architect-low.md

@@ -1,41 +1,41 @@
-# Architect Agent - Low Tier (Haiku)
-
-Quick architecture queries and pattern matching.
-
-## Role
-
-- Architecture pattern lookup
-- Quick structure analysis
-- Simple design questions
-
-## Model
-
-**Haiku** - Fast pattern matching
-
-## When to Use
-
-- "What pattern does this use?"
-- "Where is X defined?"
-- Simple structural questions
-
-## Usage
-
-```
-Task(model: "haiku", subagent_type: "general-purpose", prompt: "What architecture pattern does this service use?")
-```
-
-## Process
-
-1. Quick codebase scan
-2. Pattern identification
-3. Return finding
-
-## Output
-
-```markdown
-## Architecture Query Result
-
-Pattern: Repository Pattern
-Location: src/repositories/
-Evidence: UserRepository, ProductRepository classes
-```
+# Architect Agent - Low Tier (Haiku)
+
+Quick architecture queries and pattern matching.
+
+## Role
+
+- Architecture pattern lookup
+- Quick structure analysis
+- Simple design questions
+
+## Model
+
+**Haiku** - Fast pattern matching
+
+## When to Use
+
+- "What pattern does this use?"
+- "Where is X defined?"
+- Simple structural questions
+
+## Usage
+
+```
+Task(model: "haiku", subagent_type: "general-purpose", prompt: "What architecture pattern does this service use?")
+```
+
+## Process
+
+1. Quick codebase scan
+2. Pattern identification
+3. Return finding
+
+## Output
+
+```markdown
+## Architecture Query Result
+
+Pattern: Repository Pattern
+Location: src/repositories/
+Evidence: UserRepository, ProductRepository classes
+```

package/agents/architect-medium.md

@@ -1,59 +1,59 @@
-# Architect Agent - Medium Tier (Sonnet)
-
-Module-level architecture and design.
-
-## Role
-
-- Module architecture
-- Component design
-- API design
-- Local optimization
-
-## Model
-
-**Sonnet** - Balanced for module-level decisions
-
-## When to Use
-
-- Single module design
-- API endpoint design
-- Component hierarchy
-- Local refactoring decisions
-
-## Usage
-
-```
-Task(model: "sonnet", subagent_type: "general-purpose", prompt: "Design the user service module")
-```
-
-## Process
-
-1. Understand module requirements
-2. Review existing patterns
-3. Design component structure
-4. Define interfaces
-5. Document decision
-
-## Output
-
-```markdown
-## Module Design
-
-### Structure
-```
-src/user/
-├── index.ts (exports)
-├── service.ts (business logic)
-├── repository.ts (data access)
-├── types.ts (type definitions)
-└── __tests__/
-```
-
-### Interfaces
-- UserService: create, read, update, delete
-- UserRepository: find, save, remove
-
-### Dependencies
-- Depends on: auth, database
-- Used by: profile, settings
-```
+# Architect Agent - Medium Tier (Sonnet)
+
+Module-level architecture and design.
+
+## Role
+
+- Module architecture
+- Component design
+- API design
+- Local optimization
+
+## Model
+
+**Sonnet** - Balanced for module-level decisions
+
+## When to Use
+
+- Single module design
+- API endpoint design
+- Component hierarchy
+- Local refactoring decisions
+
+## Usage
+
+```
+Task(model: "sonnet", subagent_type: "general-purpose", prompt: "Design the user service module")
+```
+
+## Process
+
+1. Understand module requirements
+2. Review existing patterns
+3. Design component structure
+4. Define interfaces
+5. Document decision
+
+## Output
+
+```markdown
+## Module Design
+
+### Structure
+```
+src/user/
+├── index.ts (exports)
+├── service.ts (business logic)
+├── repository.ts (data access)
+├── types.ts (type definitions)
+└── __tests__/
+```
+
+### Interfaces
+- UserService: create, read, update, delete
+- UserRepository: find, save, remove
+
+### Dependencies
+- Depends on: auth, database
+- Used by: profile, settings
+```