@su-record/vibe 2.6.34 → 2.6.41

package/commands/vibe.run.md

@@ -20,6 +20,8 @@ Execute **Scenario-Driven Implementation** with automatic quality verification.
 
 ---
 
+> **⏱️ Timer**: Call `getCurrentTime` tool at the START. Record the result as `{start_time}`.
+
 ## **Scenario-Driven Development (SDD)**
 
 > Automate **Scenario = Implementation = Verification** so even non-developers can trust quality
@@ -174,7 +176,7 @@ Like Sisyphus rolling the boulder, ULTRAWORK **keeps going until done**:
 │   ┌──────────────────────────────────────────────────────────┐  │
 │   │  RTM COVERAGE VERIFICATION [Iteration {{ITER}}/{{MAX}}]   │  │
 │   │                                                           │  │
-│   │  Generate RTM via vibe tools:                             │  │
+│   │  Generate RTM via core tools:                             │  │
 │   │  → generateTraceabilityMatrix("{feature-name}")           │  │
 │   │                                                           │  │
 │   │  Coverage Metrics (automated):                            │  │
@@ -571,17 +573,22 @@ When external LLMs are enabled in `.claude/vibe/config.json`:
 #   - If systemPrompt omitted, uses default
 #   - If systemPrompt is "-", uses default and treats next argument as prompt
 
-# Cross-platform path (works on Windows/macOS/Linux)
-VIBE_SCRIPTS="$(node -p "process.env.APPDATA || require('os').homedir() + '/.config'")/vibe/hooks/scripts"
+# Step 1: Resolve script path (once per session)
+node -e "console.log(require('path').join(process.env.APPDATA || require('os').homedir() + '/.config', 'vibe/hooks/scripts/llm-orchestrate.js'))"
+# Save output as [LLM_SCRIPT]
 
-# GPT call
-node "$VIBE_SCRIPTS/llm-orchestrate.js" gpt orchestrate-json "[question content]"
+# GPT call (short prompt - CLI arg)
+node "[LLM_SCRIPT]" gpt orchestrate-json "[question content]"
 
 # Gemini call
-node "$VIBE_SCRIPTS/llm-orchestrate.js" gemini orchestrate-json "[question content]"
+node "[LLM_SCRIPT]" gemini orchestrate-json "[question content]"
 
 # Custom system prompt usage
-node "$VIBE_SCRIPTS/llm-orchestrate.js" gpt orchestrate-json "You are a code reviewer" "[question content]"
+node "[LLM_SCRIPT]" gpt orchestrate-json "You are a code reviewer" "[question content]"
+
+# Long prompt - use --input file (write JSON file first with Write tool)
+# JSON format: {"prompt": "your prompt here"}
+node "[LLM_SCRIPT]" gpt orchestrate-json --input "[SCRATCHPAD]/input.json"
 ```
 
 ### External LLM Fallback
@@ -594,9 +601,9 @@ node "$VIBE_SCRIPTS/llm-orchestrate.js" gpt orchestrate-json "You are a code rev
 - Continue with the implementation without interruption
 - Log the fallback but don't block progress
 
-## Vibe Tools (Semantic Analysis & Memory)
+## Core Tools (Semantic Analysis & Memory)
 
-Use vibe tools for accurate codebase understanding and session continuity.
+Use core tools for accurate codebase understanding and session continuity.
 
 ### Tool Invocation
 
@@ -641,14 +648,50 @@ node -e "import('@su-record/vibe/tools').then(t => t.saveMemory({key: 'auth-patt
 
 ### 1. Load SPEC + Feature
 
+**Search order (check BOTH file AND folder):**
+
+```
+Step 1: Check if SPLIT structure exists (folder)
+  📁 .claude/vibe/specs/{feature-name}/        → Folder with _index.md + phase files
+  📁 .claude/vibe/features/{feature-name}/      → Folder with _index.feature + phase files
+
+Step 2: If no folder, check single file
+  📄 .claude/vibe/specs/{feature-name}.md       → Single SPEC file
+  📄 .claude/vibe/features/{feature-name}.feature → Single Feature file
+
+Step 3: If neither exists → Error
+```
+
+**Split structure (folder) detected:**
+```
+📁 .claude/vibe/specs/{feature-name}/
+├── _index.md              → Master SPEC (read first for overview)
+├── phase-1-{name}.md      → Phase 1 SPEC
+├── phase-2-{name}.md      → Phase 2 SPEC
+└── ...
+
+📁 .claude/vibe/features/{feature-name}/
+├── _index.feature         → Master Feature (read first for scenario overview)
+├── phase-1-{name}.feature → Phase 1 scenarios
+├── phase-2-{name}.feature → Phase 2 scenarios
+└── ...
+
+→ Load _index.md first, then load phase files in order
+→ Execute phases sequentially (or per --phase flag)
+```
+
+**Single file detected:**
 ```
 📄 .claude/vibe/specs/{feature-name}.md      → SPEC (structure, constraints, context)
 📄 .claude/vibe/features/{feature-name}.feature → Feature (scenario = implementation unit)
 ```
 
-**Error if Feature file missing**:
+**Error if NEITHER file NOR folder found:**
 ```
-❌ Feature file not found.
+❌ SPEC not found. Searched:
+   - .claude/vibe/specs/{feature-name}/  (folder)
+   - .claude/vibe/specs/{feature-name}.md (file)
+
    Run /vibe.spec "{feature-name}" first.
 ```
 
@@ -746,8 +789,8 @@ Then: Login success + JWT token returned
 │               │                                                 │
 │  Task(haiku) ─┴─→ "Find existing patterns and conventions"      │
 │                                                                 │
-│  [If GPT enabled] Bash: node {{VIBE_PATH}}/hooks/scripts/llm-orchestrate.js gpt orchestrate-json "[question]"
-│  [If Gemini enabled] Bash: node {{VIBE_PATH}}/hooks/scripts/llm-orchestrate.js gemini orchestrate-json "[question]"
+│  [If GPT enabled] Bash: node "[LLM_SCRIPT]" gpt orchestrate-json "[question]"
+│  [If Gemini enabled] Bash: node "[LLM_SCRIPT]" gemini orchestrate-json "[question]"
 └─────────────────────────────────────────────────────────────────┘
                               │
                               ↓ (wait for all to complete)
@@ -851,7 +894,36 @@ For 5 phases: 4 × 20s saved = **80s faster**
 | Sequential (3 Tasks) | ~30s | Cache cold on each |
 | **Parallel (3 Tasks)** | **~10s** | **Cache warmed once, shared** |
 
-vibe ProjectCache (LRU) caches ts-morph parsing results. Parallel calls share the warmed cache.
+core ProjectCache (LRU) caches ts-morph parsing results. Parallel calls share the warmed cache.
+
+### UI/UX Design Intelligence (Auto-triggered before Phase 1)
+
+> **조건**: SPEC 또는 Feature에 UI/UX 키워드 포함 시 자동 실행
+> **비활성화**: `.claude/vibe/config.json`에 `"uiUxAnalysis": false` 설정
+
+**Phase 1 시작 전, 2개 에이전트 자동 실행:**
+
+| Agent | Condition | Role |
+|-------|-----------|------|
+| ④ ui-stack-implementer | **항상 실행** | 프레임워크별 컴포넌트 가이드라인 제공 |
+| ⑤ ui-dataviz-advisor | **조건부** (chart/dashboard/visualization 키워드) | 차트/시각화 라이브러리 추천 |
+
+**실행 방법:**
+
+```text
+# ④ 항상 실행 (Haiku)
+Task(subagent_type="ui-stack-implementer",
+  prompt="Provide implementation guidelines for project '{project}' using {detected_stack}. Use core_ui_stack_search for framework-specific patterns.")
+
+# ⑤ 조건부 실행 (Haiku) — SPEC에 차트/대시보드/시각화 키워드 포함 시
+Task(subagent_type="ui-dataviz-advisor",
+  prompt="Recommend data visualization approach for project '{project}'. Use core_ui_search for chart types and react-performance patterns.")
+```
+
+**디자인 시스템 자동 참조:**
+- `.claude/vibe/design-system/{project}/MASTER.md` 존재 시 자동 로드
+- 구현 에이전트가 CSS 변수, 폰트, 색상 팔레트를 직접 참조
+- 페이지별 오버라이드 `pages/{page}.md` 존재 시 우선 적용
 
 ### Phase Execution Flow (ULTRAWORK Pipeline)
 
@@ -904,6 +976,436 @@ Phase N+1 Start (IMMEDIATE - exploration already done!)
 
 ---
 
+### Agent Teams — Dev Team
+
+> **Agent Teams**: 에이전트들이 팀을 이루어 서로 소통하며 구현합니다.
+> 설정: `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` + `teammateMode: in-process` (`~/.claude/settings.json` 전역 — postinstall 자동 설정)
+
+**팀 구성:**
+
+| 팀원 | 역할 |
+|------|------|
+| architect (리더) | 설계 결정, 구현 방향 조율, SPEC 준수 검증, 팀 합의 주도 |
+| implementer | 핵심 비즈니스 로직 구현, architect 설계를 따라 코드 작성 |
+| tester | 구현 완료 즉시 테스트 작성, 실패 시 implementer에 피드백 |
+| security-reviewer | 실시간 보안 취약점 검증, 블로킹 이슈 식별 |
+
+**실행 순서:**
+
+1. `TeamCreate(team_name="dev-{feature}")` — 팀 + 공유 태스크 리스트 생성
+2. 4개 팀원 병렬 생성 — 각각 `Task(team_name=..., name=..., subagent_type=...)` 으로 spawn
+3. architect가 SPEC Phase를 분석하여 구현 계획 수립 → TaskList에 작업 등록
+4. 팀원들이 TaskList에서 작업을 claim하고, SendMessage로 실시간 협업
+5. 모든 시나리오 검증 완료 → 팀원 shutdown_request → TeamDelete로 정리
+
+**팀원 spawn 패턴:**
+
+```text
+TeamCreate(team_name="dev-{feature}", description="Implementation team for {feature} Phase {N}")
+
+# 4개 병렬 spawn
+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",
+  prompt="구현 팀 코드 담당. SPEC: {spec_content}
+  역할: architect의 설계를 따라 프로덕션 코드 작성.
+  architect에게서 설계를 받으면 구현을 시작하세요.
+  컴포넌트 구현 완료 시 tester에게 SendMessage로 테스트 요청하세요.
+  security-reviewer의 블로킹 이슈는 즉시 수정하세요.
+  TaskList에서 구현 작업을 claim하세요.")
+
+Task(team_name="dev-{feature}", name="tester", subagent_type="tester",
+  prompt="구현 팀 테스트 담당. SPEC: {spec_content}
+  역할: implementer가 완료한 컴포넌트부터 즉시 테스트 작성.
+  구현 전체를 기다리지 말고 컴포넌트 단위로 점진적 테스트하세요.
+  테스트 실패 시 implementer에게 SendMessage로 피드백하세요.
+  edge case 발견 시 architect에게 설계 검토를 요청하세요.
+  TaskList에서 테스트 작업을 claim하세요.")
+
+Task(team_name="dev-{feature}", name="security-reviewer", subagent_type="security-reviewer",
+  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} 모든 시나리오 통과 확인. 구현 완료합니다"
+```
+
+**팀 모드 vs 기존 병렬 모드 비교:**
+
+| 측면 | 기존 병렬 모드 | Agent Teams |
+|------|---------------|-------------|
+| 통신 | 결과만 수집 | 실시간 상호 피드백 |
+| 테스트 | 구현 후 별도 단계 | 구현과 동시 진행 |
+| 보안 | 사후 리뷰 | 실시간 검증 |
+| 설계 변경 | 메인 에이전트만 결정 | architect 주도 팀 합의 |
+| 오류 복구 | 재시도 루프 | 팀 내 즉시 피드백 |
+
+**활성화 조건 (Dev Team Full — 4명):**
+- ULTRAWORK 모드 + 3개 이상 시나리오
+- 또는 복잡도 점수 20+ (High)
+
+### Agent Teams — Lite Team (Normal Mode)
+
+> **일반 모드에서도 팀 협업**. Dev Team의 축소 버전으로, 3개 이상 시나리오 시 자동 활성화.
+> security-reviewer를 제외한 architect + implementer + tester 3명 구성.
+
+**팀 구성:**
+
+| 팀원 | 역할 |
+|------|------|
+| architect (리더) | 설계 결정, 시나리오 분석, 구현 방향 조율 |
+| implementer | 핵심 비즈니스 로직 구현 |
+| tester | 구현 완료 즉시 테스트 작성, 실패 시 피드백 |
+
+**spawn 패턴:**
+
+```text
+TeamCreate(team_name="lite-{feature}", description="Lite implementation team for {feature} Phase {N}")
+
+Task(team_name="lite-{feature}", name="architect", subagent_type="architect",
+  prompt="Lite 팀 리더. Phase {N}의 SPEC을 분석하고 구현 계획을 수립하세요.
+  SPEC: {spec_content}
+  Feature Scenarios: {scenarios}
+  역할: 설계 결정, 구현 방향 조율. TaskList에 작업을 등록하세요.
+  implementer에게 설계를 SendMessage로 전달하세요.")
+
+Task(team_name="lite-{feature}", name="implementer", subagent_type="implementer",
+  prompt="Lite 팀 코드 담당. SPEC: {spec_content}
+  역할: architect의 설계를 따라 프로덕션 코드 작성.
+  완료 시 tester에게 SendMessage로 테스트 요청하세요.")
+
+Task(team_name="lite-{feature}", name="tester", subagent_type="tester",
+  prompt="Lite 팀 테스트 담당. SPEC: {spec_content}
+  역할: implementer가 완료한 컴포넌트부터 즉시 테스트 작성.
+  테스트 실패 시 implementer에게 SendMessage로 피드백하세요.")
+```
+
+**활성화 조건 (Lite Team — 3명):**
+- 일반 모드 + 3개 이상 시나리오
+- 복잡도 점수 8-19 (Medium)
+- 단순 구현(1-2 파일, 시나리오 2개 이하)에서는 기존 병렬 모드 유지
+
+**팀 선택 기준:**
+
+| 조건 | 팀 |
+|------|-----|
+| 시나리오 1-2개, 파일 1-2개 | 기존 병렬 모드 (팀 없음) |
+| 시나리오 3개+, 일반 모드 | **Lite Team (3명)** |
+| ULTRAWORK 또는 복잡도 20+ | Dev Team Full (4명) |
+
+### Agent Teams — Review Team
+
+> P1/P2 이슈 교차 검증을 위한 보안+아키텍처+성능+단순성 전문 리뷰 팀.
+> `/vibe.review` 시 P1/P2 이슈가 발견되면 자동 활성화.
+
+**팀 구성:**
+
+| 팀원 | 역할 |
+|------|------|
+| security-reviewer (리더) | 보안 이슈 우선순위 결정, 교차 검증 주도, 오탐 제거 |
+| architecture-reviewer | 아키텍처 위반 검증, 설계 패턴 평가 |
+| performance-reviewer | 성능 병목 검증, N+1 쿼리/메모리 누수 확인 |
+| simplicity-reviewer | 과도한 복잡성 검증, 불필요한 추상화 식별 |
+
+**spawn 패턴:**
+
+```text
+TeamCreate(team_name="review-{feature}", description="Cross-validation review team for {feature}")
+
+Task(team_name="review-{feature}", name="security-reviewer", subagent_type="security-reviewer",
+  prompt="Review team leader. Cross-validate P1/P2 issues found in parallel review.
+  Files: {changed_files}
+  Found issues: {p1_p2_issues}
+  Role: Verify each P1/P2 issue is genuine (not false positive). Prioritize by actual impact.
+  Send disputed findings to relevant reviewer for confirmation via SendMessage.")
+
+Task(team_name="review-{feature}", name="architecture-reviewer", subagent_type="architecture-reviewer",
+  prompt="Review team architecture expert. Validate architecture-related findings.
+  Files: {changed_files}
+  Role: Confirm or dispute architecture violations. Check SOLID principles and layer boundaries.")
+
+Task(team_name="review-{feature}", name="performance-reviewer", subagent_type="performance-reviewer",
+  prompt="Review team performance expert. Validate performance-related findings.
+  Files: {changed_files}
+  Role: Confirm or dispute performance issues. Run complexity analysis on flagged code.")
+
+Task(team_name="review-{feature}", name="simplicity-reviewer", subagent_type="simplicity-reviewer",
+  prompt="Review team simplicity advocate. Challenge over-engineering findings.
+  Files: {changed_files}
+  Role: Verify YAGNI violations. Confirm or dispute unnecessary abstraction flags.")
+```
+
+**팀원 간 통신 예시:**
+
+```text
+security-reviewer → architecture-reviewer: "SQL injection finding in users.py:42 — is this pattern used elsewhere?"
+architecture-reviewer → security-reviewer: "Confirmed. Same pattern in orders.py:78. Elevate to P1."
+performance-reviewer → security-reviewer: "N+1 query finding is false positive — already uses prefetch_related."
+security-reviewer → broadcast: "Review complete. 2 P1 confirmed, 1 P2 downgraded to P3."
+```
+
+**활성화 조건:**
+
+- `/vibe.review` 실행 후 P1 또는 P2 이슈 2개 이상 발견 시
+- Agent Teams 환경변수 활성화 상태
+
+### Agent Teams — Debug Team
+
+> 빌드/테스트 실패 시 아키텍트 진단 → 구현자 수정 → 테스터 검증 사이클.
+> UltraQA 3회 실패 진입 시 또는 빌드 실패 3회+ 시 자동 활성화.
+
+**팀 구성:**
+
+| 팀원 | 역할 |
+|------|------|
+| architect (리더) | 근본 원인 진단, 수정 방향 설계, 아키텍처 레벨 문제 식별 |
+| implementer | architect 진단에 따라 최소 diff 수정 적용 |
+| tester | 수정 후 즉시 테스트 실행, 회귀 검증 |
+
+**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",
+  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",
+  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.")
+```
+
+**활성화 조건:**
+
+- 동일 빌드/테스트 실패 3회 이상
+- UltraQA `architecture_question` 상태 진입 시
+
+### Agent Teams — Research Team
+
+> `/vibe.spec` Step 3 리서치 단계에서 4개 전문 리서치 에이전트가 팀으로 협업.
+> 리서치 결과 교차 검증 및 충돌 해결.
+
+**팀 구성:**
+
+| 팀원 | 역할 |
+|------|------|
+| best-practices-agent (리더) | 베스트 프랙티스 수집, 리서치 통합, 충돌 해결 |
+| security-advisory-agent | 보안 취약점 조사, CVE 확인, 보안 권장사항 |
+| codebase-patterns-agent | 기존 코드베이스 패턴 분석, 유사 구현 참조 |
+| framework-docs-agent | 프레임워크 최신 문서 확인, API 변경사항 추적 |
+
+**spawn 패턴:**
+
+```text
+TeamCreate(team_name="research-{feature}", description="Research team for {feature} SPEC")
+
+Task(team_name="research-{feature}", name="best-practices-agent", subagent_type="best-practices-agent",
+  prompt="Research team leader. Coordinate research for {feature} SPEC.
+  Tech stack: {tech_stack}
+  Requirements: {requirements}
+  Role: Collect best practices. Integrate findings from all researchers.
+  Resolve conflicting recommendations. Produce unified research summary.")
+
+Task(team_name="research-{feature}", name="security-advisory-agent", subagent_type="security-advisory-agent",
+  prompt="Research team security specialist. Check security advisories for {feature}.
+  Tech stack: {tech_stack}
+  Role: Check CVEs for dependencies. Identify security patterns to follow.
+  Share findings with best-practices-agent for integration.")
+
+Task(team_name="research-{feature}", name="codebase-patterns-agent", subagent_type="codebase-patterns-agent",
+  prompt="Research team codebase analyst. Analyze existing patterns for {feature}.
+  Project path: {project_path}
+  Role: Find similar implementations in codebase. Extract conventions and patterns.
+  Share findings with best-practices-agent.")
+
+Task(team_name="research-{feature}", name="framework-docs-agent", subagent_type="framework-docs-agent",
+  prompt="Research team docs specialist. Check latest framework docs for {feature}.
+  Tech stack: {tech_stack}
+  Role: Verify API usage against latest docs. Check for breaking changes.
+  Share findings with best-practices-agent.")
+```
+
+**활성화 조건:**
+
+- `/vibe.spec` Step 3 리서치 단계
+- Agent Teams 환경변수 활성화 상태
+
+### Agent Teams — Security Team
+
+> 보안 민감 코드 변경 시 전문 보안 검증 팀.
+> 인증, 권한, 결제, 개인정보 관련 코드 변경 감지 시 자동 활성화.
+
+**팀 구성:**
+
+| 팀원 | 역할 |
+|------|------|
+| security-reviewer (리더) | OWASP Top 10 검증, 보안 이슈 우선순위 결정 |
+| data-integrity-reviewer | 데이터 무결성, 트랜잭션 관리, 입력 검증 |
+| security-advisory-agent | 사용 라이브러리 CVE 확인, 보안 패치 확인 |
+| tester | 보안 테스트 케이스 작성, 침투 테스트 시나리오 검증 |
+
+**spawn 패턴:**
+
+```text
+TeamCreate(team_name="security-{feature}", description="Security audit team for {feature}")
+
+Task(team_name="security-{feature}", name="security-reviewer", subagent_type="security-reviewer",
+  prompt="Security team leader. Comprehensive security audit for {feature}.
+  Files: {changed_files}
+  Role: OWASP Top 10 check. XSS, CSRF, SQL injection, auth bypass.
+  Coordinate with data-integrity-reviewer for data flow analysis.
+  Any P1 finding blocks merge — notify team immediately.")
+
+Task(team_name="security-{feature}", name="data-integrity-reviewer", subagent_type="data-integrity-reviewer",
+  prompt="Security team data specialist. Verify data integrity for {feature}.
+  Files: {changed_files}
+  Role: Check transaction management, input validation, data sanitization.
+  Report findings to security-reviewer.")
+
+Task(team_name="security-{feature}", name="security-advisory-agent", subagent_type="security-advisory-agent",
+  prompt="Security team advisory specialist. Check dependencies for {feature}.
+  Role: Scan for known CVEs in project dependencies. Check security advisories.
+  Report critical findings to security-reviewer.")
+
+Task(team_name="security-{feature}", name="tester", subagent_type="tester",
+  prompt="Security team test specialist. Write security-focused tests for {feature}.
+  Files: {changed_files}
+  Role: Write tests for auth bypass, injection, permission escalation.
+  Report test results to security-reviewer.")
+```
+
+**활성화 조건:**
+
+- auth, payment, user-data, crypto 관련 파일 변경 감지 시
+- 또는 수동으로 `security` 키워드 지정 시
+
+### Agent Teams — Migration Team
+
+> 프레임워크/라이브러리 마이그레이션 전문 팀.
+> 대규모 의존성 업그레이드, 프레임워크 전환 시 활성화.
+
+**팀 구성:**
+
+| 팀원 | 역할 |
+|------|------|
+| architect (리더) | 마이그레이션 전략 설계, 호환성 분석, 단계별 계획 |
+| implementer | 코드 변환 실행, API 변경 적용 |
+| tester | 마이그레이션 후 회귀 테스트, 호환성 검증 |
+| build-error-resolver | 빌드 에러 즉시 해결, 타입 에러 수정 |
+
+**spawn 패턴:**
+
+```text
+TeamCreate(team_name="migration-{feature}", description="Migration team for {feature}")
+
+Task(team_name="migration-{feature}", name="architect", subagent_type="architect",
+  prompt="Migration team leader. Plan migration strategy for {feature}.
+  From: {current_version}
+  To: {target_version}
+  Role: Analyze breaking changes. Create step-by-step migration plan.
+  Assign file groups to implementer. Monitor build-error-resolver for blockers.")
+
+Task(team_name="migration-{feature}", name="implementer", subagent_type="implementer",
+  prompt="Migration team implementer. Execute code migration for {feature}.
+  Role: Apply migration changes per architect plan. Work file-by-file.
+  Notify tester after each file group. Report blockers to architect.")
+
+Task(team_name="migration-{feature}", name="tester", subagent_type="tester",
+  prompt="Migration team tester. Verify migration correctness for {feature}.
+  Role: Run existing tests after each migration step. Add new tests for changed APIs.
+  Report regressions to implementer and architect.")
+
+Task(team_name="migration-{feature}", name="build-error-resolver", subagent_type="build-error-resolver",
+  prompt="Migration team build fixer. Resolve build errors during {feature} migration.
+  Role: Monitor build output. Apply minimal-diff type fixes for migration errors.
+  Notify implementer of patterns requiring broader changes.")
+```
+
+**활성화 조건:**
+
+- package.json 주요 의존성 버전 변경 감지 시
+- 또는 수동으로 `migration` 키워드 지정 시
+
+### Agent Teams — Fullstack Team
+
+> Frontend + Backend 동시 변경이 필요한 풀스택 기능 구현 팀.
+> API 엔드포인트 + UI 컴포넌트를 동시에 개발.
+
+**팀 구성:**
+
+| 팀원 | 역할 |
+|------|------|
+| architect (리더) | API 인터페이스 설계, frontend/backend 분업 조율 |
+| implementer-backend | Backend API, 데이터베이스, 서비스 로직 구현 |
+| implementer-frontend | Frontend UI, 상태 관리, API 연동 구현 |
+| tester | E2E 테스트, API 테스트, 통합 테스트 |
+
+**spawn 패턴:**
+
+```text
+TeamCreate(team_name="fullstack-{feature}", description="Fullstack team for {feature}")
+
+Task(team_name="fullstack-{feature}", name="architect", subagent_type="architect",
+  prompt="Fullstack team leader. Design API contract for {feature}.
+  SPEC: {spec_content}
+  Role: Define API endpoints (request/response schemas). Design data models.
+  Share API contract with both implementers. Coordinate integration timing.")
+
+Task(team_name="fullstack-{feature}", name="implementer-backend", subagent_type="implementer",
+  prompt="Fullstack team backend developer. Implement API for {feature}.
+  SPEC: {spec_content}
+  Role: Implement API endpoints per architect's contract. Create data models and services.
+  Notify implementer-frontend when endpoints are ready for integration.
+  Share API response samples with tester.")
+
+Task(team_name="fullstack-{feature}", name="implementer-frontend", subagent_type="implementer",
+  prompt="Fullstack team frontend developer. Implement UI for {feature}.
+  SPEC: {spec_content}
+  Role: Build UI components and pages per SPEC. Use architect's API contract for types.
+  Start with mock data, switch to real API when backend notifies readiness.
+  Notify tester when UI is ready for E2E testing.")
+
+Task(team_name="fullstack-{feature}", name="tester", subagent_type="tester",
+  prompt="Fullstack team tester. Write comprehensive tests for {feature}.
+  SPEC: {spec_content}
+  Role: Write API tests (after backend ready). Write E2E tests (after frontend ready).
+  Test API contract conformance. Report integration issues to architect.")
+```
+
+**활성화 조건:**
+
+- SPEC에 frontend + backend 파일이 모두 포함된 경우
+- 또는 수동으로 `fullstack` 키워드 지정 시
+
+---
+
 1. **Related code analysis**: Task(haiku) explores `<context>` related code
 2. **File creation/modification**: Task(sonnet) implements per `<output_format>`
 3. **Constraint compliance**: Check `<constraints>`
@@ -959,7 +1461,8 @@ Brand:
 
 **Manual Generation:**
 ```bash
-node "$(node -p "process.env.APPDATA || require('os').homedir() + '/.config'")/vibe/hooks/scripts/llm-orchestrate.js" gemini image "App icon for MyApp, primary color #2F6BFF, square format 1:1, simple recognizable design, works well at small sizes, no text or letters, solid or gradient background, modern minimalist" --output "./public/app-icon.png"
+# [LLM_SCRIPT] = resolved path from: node -e "console.log(require('path').join(process.env.APPDATA || require('os').homedir() + '/.config', 'vibe/hooks/scripts/llm-orchestrate.js'))"
+node "[LLM_SCRIPT]" gemini image "App icon for MyApp, primary color #2F6BFF, square format 1:1, simple recognizable design, works well at small sizes, no text or letters, solid or gradient background, modern minimalist" --output "./public/app-icon.png"
 ```
 
 ---
@@ -1006,19 +1509,24 @@ After all scenarios are implemented, **GPT and Gemini review in parallel with cr
 
 **Race Review Invocation (GPT + Gemini in parallel via Bash):**
 
-**🚨 Use stdin pipe to avoid CLI argument length limits on Windows.**
+**🚨 Use --input file to avoid CLI argument length limits and Windows pipe issues.**
 
 1. Save code to review into `[SCRATCHPAD]/review-code.txt` (using Write tool)
-2. Run GPT + Gemini in PARALLEL (two Bash tool calls at once):
+2. Write JSON input file `[SCRATCHPAD]/review-input.json` (using Write tool):
+   - `{"prompt": "Review this code for security, performance, and best practices. Return JSON: {issues: [{id, title, description, severity, suggestion}]}. Code: [CODE_CONTENT]"}`
+   - Where `[CODE_CONTENT]` is the code text (properly JSON-escaped inside the prompt string)
+3. Resolve script path (once per session): `node -e "console.log(require('path').join(process.env.APPDATA || require('os').homedir() + '/.config', 'vibe/hooks/scripts/llm-orchestrate.js'))"`
+   - Save output as `[LLM_SCRIPT]`
+4. Run GPT + Gemini in PARALLEL (two Bash tool calls at once):
 
 ```bash
 # GPT review (Bash tool call 1)
-node -e "const fs=require('fs');const p=JSON.stringify({prompt:'Review this code for security, performance, and best practices. Return JSON: {issues: [{id, title, description, severity, suggestion}]}. Code: '+fs.readFileSync('[SCRATCHPAD]/review-code.txt','utf8')});process.stdout.write(p)" | node "$(node -p "process.env.APPDATA || require('os').homedir() + '/.config'")/vibe/hooks/scripts/llm-orchestrate.js" gpt orchestrate-json
+node "[LLM_SCRIPT]" gpt orchestrate-json --input "[SCRATCHPAD]/review-input.json"
 ```
 
 ```bash
 # Gemini review (Bash tool call 2 - run in parallel)
-node -e "const fs=require('fs');const p=JSON.stringify({prompt:'Review this code for security, performance, and best practices. Return JSON: {issues: [{id, title, description, severity, suggestion}]}. Code: '+fs.readFileSync('[SCRATCHPAD]/review-code.txt','utf8')});process.stdout.write(p)" | node "$(node -p "process.env.APPDATA || require('os').homedir() + '/.config'")/vibe/hooks/scripts/llm-orchestrate.js" gemini orchestrate-json
+node "[LLM_SCRIPT]" gemini orchestrate-json --input "[SCRATCHPAD]/review-input.json"
 ```
 
 **Confidence-based Priority:**
@@ -1029,8 +1537,8 @@ node -e "const fs=require('fs');const p=JSON.stringify({prompt:'Review this code
 | 50% (1/2) | P2 | Auto-fix with review |
 
 **Fallback handling:**
-- If one LLM fails → Use single LLM result (reduced confidence)
-- If both fail → Skip and proceed (log warning)
+- If one LLM fails → Use remaining LLM results (reduced confidence)
+- If all fail → Skip and proceed (log warning)
 
 **Review application rules:**
 
@@ -1076,10 +1584,11 @@ After all scenarios complete + Gemini review, **quality report is auto-generated
 │  │ Type check        │ ✅     │ 0 errors                    │    │
 │  │ Complexity        │ ✅     │ All functions ≤30 lines     │    │
 │  │ Security          │ ✅     │ 0 vulnerabilities           │    │
-│  │ Gemini review     │ ✅     │ 3 improvements applied      │    │
+│  │ Race review       │ ✅     │ 3 improvements applied      │    │
 │  └─────────────────────────────────────────────────────────┘    │
 │                                                                 │
-│  ⏱️ Total time: 3m 42s                                          │
+│  ⏱️ Started: {start_time}                                        │
+│  ⏱️ Completed: {getCurrentTime 결과}                             │
 │                                                                 │
 └─────────────────────────────────────────────────────────────────┘
 ```
@@ -1242,7 +1751,8 @@ Then: Login success + JWT token returned
 │  📈 Quality score: 94/100                                       │
 │  Build: ✅ | Tests: ✅ | Types: ✅ | Gemini: ✅ (2 applied)     │
 │                                                                 │
-│  ⏱️ Total time: 3m 42s                                          │
+│  ⏱️ Started: {start_time}                                        │
+│  ⏱️ Completed: {getCurrentTime 결과}                             │
 └─────────────────────────────────────────────────────────────────┘
 
 🎉 Implementation complete! All scenarios passed + Gemini review applied.
@@ -1390,7 +1900,7 @@ After ALL phases complete successfully, **automatically** perform a brief retros
 
 1. Generate retrospective based on the implementation session
 2. Save to `.claude/vibe/retros/{feature-name}.md`
-3. Save key lessons via `vibe_save_memory` (for cross-session recall)
+3. Save key lessons via `core_save_memory` (for cross-session recall)
 4. Update `claude-progress.txt` with final status
 
 **Important:**