@su-record/vibe 2.8.53 → 2.9.2

package/CLAUDE.md

@@ -86,6 +86,7 @@
 | Setup helpers | `src/cli/setup.ts`, `src/cli/setup/` |
 | Hooks scripts | `hooks/scripts/` |
 | Agent definitions | `agents/` |
+| Team definitions | `agents/teams/` |
 | Skill definitions | `skills/` |
 | Language rules | `languages/` |
 | SPEC/rule templates | `vibe/rules/`, `vibe/templates/` |

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/teams/debug-team.md

@@ -0,0 +1,70 @@
+# Debug Team
+
+빌드/테스트 실패 시 아키텍트 진단 → 구현자 수정 → 테스터 검증 사이클.
+
+## 팀 구성
+
+| 팀원 | 역할 | Model |
+|------|------|-------|
+| architect (리더) | 근본 원인 진단, 수정 방향 설계, 아키텍처 레벨 문제 식별 | Opus |
+| implementer | architect 진단에 따라 최소 diff 수정 적용 | Sonnet |
+| tester | 수정 후 즉시 테스트 실행, 회귀 검증 | Haiku |
+
+## 활성화 조건
+
+- 동일 빌드/테스트 실패 3회 이상
+- UltraQA `architecture_question` 상태 진입 시
+
+## 워크플로우
+
+```
+[입력: 에러 출력 + 실패 파일 + 이전 시도 이력]
+    |
+architect: 근본 원인 분석 (증상이 아닌 원인)
+    |
+    └──→ implementer: 최소 diff 수정
+            └──→ tester: 테스트 실행
+                    ├─ PASS → 완료
+                    └─ FAIL → architect 재진단 (3회 실패 → 사용자 에스컬레이션)
+```
+
+## spawn 패턴
+
+```text
+TeamCreate(team_name="debug-{feature}", description="Debug team for {feature} build/test failure")
+
+Task(team_name="debug-{feature}", name="architect", subagent_type="architect",
+  prompt="Debug team leader. Diagnose root cause of build/test failure.
+  Error: {error_output}
+  Failed files: {failed_files}
+  Previous attempts: {attempt_history}
+  Role: Analyze error, identify root cause (not symptoms). Design minimal fix.
+  Send diagnosis to implementer via SendMessage. If same failure 3x, escalate to user.")
+
+Task(team_name="debug-{feature}", name="implementer", subagent_type="implementer",
+  mode="bypassPermissions",
+  prompt="Debug team fixer. Apply minimal-diff fixes based on architect diagnosis.
+  Role: Wait for architect diagnosis. Apply ONLY the specific fix recommended.
+  Do NOT refactor surrounding code. Notify tester when fix is applied.")
+
+Task(team_name="debug-{feature}", name="tester", subagent_type="tester",
+  mode="bypassPermissions",
+  prompt="Debug team verifier. Run tests after each fix to verify resolution.
+  Role: Wait for implementer fix notification. Run failing tests.
+  Report results to architect. If still failing, provide detailed error output.")
+```
+
+## 팀원 간 통신
+
+```text
+architect → implementer: "근본 원인: circular import in module A→B→A. B의 import를 lazy로 변경하세요"
+implementer → tester: "수정 완료. 기존 실패 테스트 재실행 요청합니다"
+tester → architect: "여전히 실패. 새로운 에러: TypeError at line 42"
+architect → broadcast: "3회 실패. 사용자 에스컬레이션이 필요합니다"
+```
+
+## ⛔ 하지 않는 것
+
+- 주변 코드 리팩터링 (최소 diff만)
+- 증상 치료 (근본 원인 해결만)
+- 4회 이상 자동 재시도 (3회 실패 → 사용자 에스컬레이션)

package/agents/teams/dev-team.md

@@ -0,0 +1,88 @@
+# Dev Team
+
+에이전트들이 팀을 이루어 서로 소통하며 구현하는 풀 구현 팀.
+
+## 팀 구성
+
+| 팀원 | 역할 | Model |
+|------|------|-------|
+| architect (리더) | 설계 결정, 구현 방향 조율, SPEC 준수 검증, 팀 합의 주도 | Opus |
+| implementer | 핵심 비즈니스 로직 구현, architect 설계를 따라 코드 작성 | Sonnet |
+| tester | 구현 완료 즉시 테스트 작성, 실패 시 implementer에 피드백 | Haiku |
+| security-reviewer | 실시간 보안 취약점 검증, 블로킹 이슈 식별 | Sonnet |
+
+## 활성화 조건
+
+- ULTRAWORK 모드 + 3개 이상 시나리오
+- 또는 복잡도 점수 20+ (High)
+
+## 워크플로우
+
+```
+architect: SPEC Phase 분석 → 구현 계획 수립 → TaskList에 작업 등록
+    |
+    ├──→ implementer: TaskList에서 claim → 코드 작성
+    │       ├──→ tester: 컴포넌트 완료 즉시 테스트 (점진적)
+    │       │       └── 실패 시 → implementer에 피드백
+    │       └──← security-reviewer: 실시간 보안 검증
+    │               └── 블로킹 이슈 → implementer 즉시 수정
+    |
+architect: 모든 시나리오 통과 확인 → 팀 종료
+```
+
+## spawn 패턴
+
+```text
+TeamCreate(team_name="dev-{feature}", description="Implementation team for {feature} Phase {N}")
+
+Task(team_name="dev-{feature}", name="architect", subagent_type="architect",
+  prompt="구현 팀 리더. Phase {N}의 SPEC을 분석하고 구현 계획을 수립하세요.
+  SPEC: {spec_content}
+  Feature Scenarios: {scenarios}
+  역할: 설계 결정, 구현 방향 조율, 팀원 간 충돌 해결, SPEC 준수 검증.
+  TaskList에 구현 작업을 등록하세요. implementer에게 설계를 SendMessage로 전달하세요.
+  모든 시나리오가 통과할 때까지 팀을 조율하세요.")
+
+Task(team_name="dev-{feature}", name="implementer", subagent_type="implementer",
+  mode="bypassPermissions",
+  prompt="구현 팀 코드 담당. SPEC: {spec_content}
+  역할: architect의 설계를 따라 프로덕션 코드 작성.
+  architect에게서 설계를 받으면 구현을 시작하세요.
+  컴포넌트 구현 완료 시 tester에게 SendMessage로 테스트 요청하세요.
+  security-reviewer의 블로킹 이슈는 즉시 수정하세요.
+  TaskList에서 구현 작업을 claim하세요.")
+
+Task(team_name="dev-{feature}", name="tester", subagent_type="tester",
+  mode="bypassPermissions",
+  prompt="구현 팀 테스트 담당. SPEC: {spec_content}
+  역할: implementer가 완료한 컴포넌트부터 즉시 테스트 작성.
+  구현 전체를 기다리지 말고 컴포넌트 단위로 점진적 테스트하세요.
+  테스트 실패 시 implementer에게 SendMessage로 피드백하세요.
+  edge case 발견 시 architect에게 설계 검토를 요청하세요.
+  TaskList에서 테스트 작업을 claim하세요.")
+
+Task(team_name="dev-{feature}", name="security-reviewer", subagent_type="security-reviewer",
+  mode="bypassPermissions",
+  prompt="구현 팀 보안 담당. SPEC: {spec_content}
+  역할: 구현 코드의 보안 취약점 실시간 검증.
+  보안 이슈는 BLOCKING — implementer에게 SendMessage로 즉시 수정 요청하세요.
+  심각한 설계 결함 발견 시 architect에게 SendMessage로 알리세요.
+  TaskList에서 보안 검증 작업을 claim하세요.")
+```
+
+## 팀원 간 통신
+
+```text
+architect → implementer: "Repository 패턴으로 데이터 접근 계층 분리해서 구현해주세요. 인터페이스는 TaskList에 등록했습니다"
+implementer → tester: "LoginService 구현 완료. 정상/실패/잠금 시나리오 테스트 요청합니다"
+security-reviewer → implementer: "SQL injection 위험: raw query 사용 감지. parameterized query로 즉시 수정 필요"
+tester → architect: "edge case 3건 실패 (빈 입력, 특수문자, 동시 요청). 설계 검토 요청합니다"
+architect → broadcast: "Phase {N} 모든 시나리오 통과 확인. 구현 완료합니다"
+```
+
+## ⛔ 하지 않는 것
+
+- SPEC 범위 밖의 기능 추가
+- architect 승인 없이 설계 변경
+- 테스트 실패 상태에서 다음 컴포넌트 진행
+- security-reviewer 블로킹 이슈 무시