oh-my-ag 1.2.0

package/.agent/skills/_shared/lessons-learned.md

@@ -0,0 +1,113 @@
+# Lessons Learned
+
+세션 간 누적되는 교훈 저장소. 모든 에이전트는 실행 시작 시 이 파일을 참조한다.
+QA Agent와 Orchestrator가 세션 종료 후 새 교훈을 추가한다.
+
+---
+
+## 사용 방법
+
+### 읽기 (모든 에이전트)
+- Complex 태스크 시작 시: 자신의 도메인 섹션을 읽고 동일 실수 방지
+- Medium 태스크: 관련 항목이 있으면 참고
+- Simple 태스크: 스킵 가능
+
+### 쓰기 (QA Agent, Orchestrator)
+세션 종료 후 아래 형식으로 추가:
+```markdown
+### {YYYY-MM-DD}: {agent-type} - {한줄 요약}
+- **문제**: {무엇이 잘못되었나}
+- **원인**: {왜 발생했나}
+- **해결**: {어떻게 고쳤나}
+- **예방**: {앞으로 어떻게 방지하나}
+```
+
+---
+
+## Backend Lessons
+
+> 이 섹션은 backend-agent, debug-agent (backend 버그 시) 가 참조합니다.
+
+### 초기 교훈 (프로젝트 설정 시 기록)
+- **SQLAlchemy 2.0 스타일만 사용**: `query()` 대신 `select()` 사용. 레거시 스타일은 경고 발생.
+- **Alembic autogenerate 후 반드시 리뷰**: 자동 생성된 마이그레이션에 인덱스 누락 또는 잘못된 타입이 있을 수 있음.
+- **FastAPI Depends 체인**: 의존성 함수 내에서 다른 Depends를 호출하면 순서 문제 발생 가능. 테스트로 확인.
+- **async/await 일관성**: 하나의 라우터에서 sync/async 혼용하지 말 것. 모두 async로 통일.
+
+---
+
+## Frontend Lessons
+
+> 이 섹션은 frontend-agent, debug-agent (frontend 버그 시) 가 참조합니다.
+
+### 초기 교훈
+- **Next.js App Router**: `useSearchParams()`는 반드시 `<Suspense>` 바운더리 안에서 사용. 안 그러면 빌드 에러.
+- **shadcn/ui 컴포넌트**: import 경로가 `@/components/ui/button`이지 `shadcn/ui`가 아님.
+- **TanStack Query v5**: `useQuery`의 첫 번째 인자가 객체 형태 `{ queryKey, queryFn }`. v4의 `useQuery(key, fn)` 형태 사용 불가.
+- **Tailwind 다크 모드**: `dark:` 접두사는 `darkMode: 'class'` 설정이 있어야 동작.
+
+---
+
+## Mobile Lessons
+
+> 이 섹션은 mobile-agent, debug-agent (mobile 버그 시) 가 참조합니다.
+
+### 초기 교훈
+- **Riverpod 2.4+ code generation**: `@riverpod` 어노테이션 사용 시 `build_runner` 실행 필요. 빌드 전에 `dart run build_runner build`.
+- **GoRouter redirect**: redirect 함수에서 현재 경로를 반환하면 무한 루프. 반드시 `null` 반환하여 리다이렉트 없음을 표시.
+- **Flutter 3.19+ Material 3**: `useMaterial3: true`가 기본값. ThemeData에서 명시적으로 설정하지 않아도 M3 적용됨.
+- **iOS 시뮬레이터에서 네트워크**: localhost 대신 `127.0.0.1` 사용. 또는 Android는 `10.0.2.2`.
+
+---
+
+## QA / Security Lessons
+
+> 이 섹션은 qa-agent가 참조합니다.
+
+### 초기 교훈
+- **rate limiting 확인 방법**: `curl`로 연속 요청 보내서 429 응답 확인. 코드 리뷰만으로는 부족.
+- **CORS 와일드카드**: 개발 환경에서 `*` 사용은 OK, 하지만 production 빌드에서는 반드시 특정 도메인으로 제한.
+- **npm audit vs safety**: frontend는 `npm audit`, backend (Python)은 `pip-audit` 또는 `safety check`.
+
+---
+
+## Debug Lessons
+
+> 이 섹션은 debug-agent가 참조합니다.
+
+### 초기 교훈
+- **React hydration 에러**: `Date.now()`, `Math.random()`, `window.innerWidth` 등 서버/클라이언트 값이 다른 코드가 원인. `useEffect` + `useState`로 감싸기.
+- **N+1 쿼리 감지**: SQLAlchemy에서 `echo=True` 설정하면 모든 쿼리 로깅. 같은 패턴 쿼리가 반복되면 N+1.
+- **Flutter hot reload 후 상태 유실**: StatefulWidget의 initState가 hot reload 시 재실행되지 않음. 상태 초기화 로직은 didChangeDependencies에.
+
+---
+
+## Cross-Domain Lessons
+
+> 모든 에이전트가 참조합니다.
+
+### 초기 교훈
+- **API 계약 불일치**: backend가 `snake_case`, frontend가 `camelCase` 기대 시 파싱 실패. 계약서에 casing 명시 필수.
+- **시간대 문제**: backend는 UTC로 저장, frontend는 로컬 타임존으로 표시. ISO 8601 형식 통일.
+- **인증 토큰 전달**: backend가 `Authorization: Bearer {token}` 기대하는데 frontend가 `token` 헤더로 보내는 실수 주의.
+
+---
+
+## 교훈 추가 프로토콜
+
+### QA Agent가 추가하는 경우
+리뷰 중 반복되는 이슈를 발견하면:
+1. 해당 도메인 섹션에 교훈 추가
+2. 형식: `### {날짜}: {한줄 요약}` + 문제/원인/해결/예방
+3. MCP 메모리 도구: `[EDIT]("lessons-learned.md", 추가 내용)`
+
+### Orchestrator가 추가하는 경우
+세션 종료 시 실패한 태스크가 있으면:
+1. 실패 원인 분석
+2. 해당 도메인 섹션에 교훈 추가
+3. 다음 세션에서 같은 실수 방지
+
+### 교훈이 너무 많아지면 (50개 이상)
+- 오래된 교훈 (6개월+)은 아카이브로 이동
+- 프레임워크 버전 업그레이드로 무효화된 교훈 삭제
+- 이 정리는 수동으로 수행 (에이전트가 임의 삭제하지 말 것)

package/.agent/skills/_shared/memory-protocol.md

@@ -0,0 +1,79 @@
+# Memory Protocol (CLI Mode)
+
+When running as a CLI subagent via `gemini -p "..." --approval-mode=yolo`, follow this protocol.
+
+## Tool Reference
+
+Tool names are configurable via `mcp.json → memoryConfig.tools`:
+- `[READ]` → default: `read_memory`
+- `[WRITE]` → default: `write_memory`
+- `[EDIT]` → default: `edit_memory`
+- `[LIST]` → default: `list_memories`
+- `[DELETE]` → default: `delete_memory`
+
+Memory base path is configurable via `memoryConfig.basePath` (default: `.serena/memories`).
+
+---
+
+## On Start
+
+1. `[READ]("task-board.md")` to confirm your assigned task
+2. `[WRITE]("progress-{agent-id}.md", initial progress entry)` with Turn 1 status
+
+## During Execution
+
+- Every 3-5 turns: `[EDIT]("progress-{agent-id}.md")` to append a new turn entry
+- Include: action taken, current status, files created/modified
+
+## On Completion
+
+- `[WRITE]("result-{agent-id}.md")` with final result including:
+  - Status: `completed` or `failed`
+  - Summary of work done
+  - Files created/modified
+  - Acceptance criteria checklist
+
+## On Failure
+
+- Still create `result-{agent-id}.md` with Status: `failed`
+- Include detailed error description and what remains incomplete
+
+---
+
+## Example with Default Tools (Serena)
+
+```python
+# On Start
+read_memory("task-board.md")
+write_memory("progress-backend.md", initial_content)
+
+# During Execution
+edit_memory("progress-backend.md", turn_update)
+
+# On Completion
+write_memory("result-backend.md", final_result)
+```
+
+## Example with Custom Tools
+
+If `memoryConfig.tools` is configured differently:
+
+```json
+{
+  "memoryConfig": {
+    "tools": {
+      "read": "fs_read",
+      "write": "fs_write",
+      "edit": "fs_patch"
+    }
+  }
+}
+```
+
+Then use:
+```python
+fs_read("task-board.md")
+fs_write("progress-backend.md", initial_content)
+fs_patch("progress-backend.md", turn_update)
+fs_write("result-backend.md", final_result)
+```

package/.agent/skills/_shared/reasoning-templates.md

@@ -0,0 +1,161 @@
+# Reasoning Templates
+
+멀티스텝 추론이 필요한 상황에서 이 템플릿의 빈칸을 채우며 진행한다.
+중간에 방향을 잃지 않도록 **각 단계를 완료한 후** 다음 단계로 넘어간다.
+
+---
+
+## 1. 디버깅 추론 (Debug Agent, Backend/Frontend/Mobile Agent)
+
+버그의 원인을 찾을 때 아래 루프를 반복한다. 최대 3회 반복 후에도 해결 안 되면 `Status: blocked` 기록.
+
+```
+=== 가설 #{N} ===
+
+관찰: {에러 메시지, 증상, 재현 조건}
+가설: "{현상}은 {추정 원인}으로 인한 것이다"
+검증 방법: {어떻게 확인할 것인가 — 코드 읽기, 로그, 테스트 등}
+검증 결과: {실제로 확인한 내용}
+판정: 맞음 / 틀림
+
+맞으면 → 수정 단계로 이동
+틀리면 → 새 가설 #{N+1} 작성
+```
+
+**예시:**
+```
+=== 가설 #1 ===
+관찰: TodoList에서 "Cannot read property 'map' of undefined"
+가설: "API 응답 전에 todos가 undefined 상태로 .map()이 호출된다"
+검증 방법: TodoList 컴포넌트에서 todos의 초기값 확인
+검증 결과: useState()에 초기값 없음 → undefined
+판정: 맞음 → todos의 기본값을 [] 로 설정
+```
+
+---
+
+## 2. 아키텍처 결정 (PM Agent, Backend Agent)
+
+기술 선택이나 설계 결정이 필요할 때 이 매트릭스를 채운다.
+
+```
+=== 결정: {무엇을 선택해야 하는가} ===
+
+선택지:
+  A: {선택지 A}
+  B: {선택지 B}
+  C: {선택지 C} (있으면)
+
+평가 기준과 점수 (1-5):
+| 기준         | A | B | C | 가중치 |
+|-------------|---|---|---|--------|
+| 성능         |   |   |   | {H/M/L} |
+| 구현 복잡도   |   |   |   | {H/M/L} |
+| 팀 익숙도     |   |   |   | {H/M/L} |
+| 확장성       |   |   |   | {H/M/L} |
+| 기존 코드 일관성 |   |   |   | {H/M/L} |
+
+결론: {선택지}
+이유: {1-2줄 근거}
+트레이드오프: {선택하지 않은 것의 장점을 포기하는 이유}
+```
+
+**예시:**
+```
+=== 결정: 상태 관리 라이브러리 ===
+
+선택지:
+  A: Zustand
+  B: Redux Toolkit
+  C: React Context
+
+| 기준         | A | B | C | 가중치 |
+|-------------|---|---|---|--------|
+| 성능         | 4 | 4 | 3 | M     |
+| 구현 복잡도   | 5 | 3 | 4 | H     |
+| 팀 익숙도     | 3 | 5 | 5 | M     |
+| 확장성       | 4 | 5 | 2 | M     |
+| 기존 코드 일관성 | 2 | 5 | 3 | H |
+
+결론: Redux Toolkit
+이유: 기존 코드가 RTK 사용 중이며, 팀 익숙도 최고
+트레이드오프: Zustand의 간결함을 포기하지만 일관성 확보
+```
+
+---
+
+## 3. 원인-결과 체인 (Debug Agent)
+
+복잡한 버그에서 실행 흐름을 단계별로 추적할 때 사용한다.
+
+```
+=== 실행 흐름 추적 ===
+
+1. [진입점]   {파일:함수} - {입력값}
+2. [호출]     {파일:함수} - {전달된 값}
+3. [처리]     {파일:함수} - {변환/로직}
+4. [실패 지점] {파일:함수} - {여기서 예상과 다른 일이 발생}
+   - 예상: {예상 동작}
+   - 실제: {실제 동작}
+   - 원인: {왜 다른가}
+5. [결과]     {에러 메시지 또는 잘못된 출력}
+```
+
+**예시:**
+```
+1. [진입점]   pages/todos.tsx:TodoPage - 유저가 /todos 접근
+2. [호출]     hooks/useTodos.ts:useTodos - fetchTodos() 호출
+3. [처리]     api/todos.ts:fetchTodos - GET /api/todos 요청
+4. [실패 지점] hooks/useTodos.ts:23 - data가 undefined인 채로 반환
+   - 예상: data = [] (빈 배열)
+   - 실제: data = undefined (fetch 완료 전)
+   - 원인: useQuery의 initialData 미설정
+5. [결과]     TodoList에서 undefined.map() → TypeError
+```
+
+---
+
+## 4. 리팩토링 판단 (모든 구현 에이전트)
+
+코드를 수정할 때 "고칠 것인가, 그대로 둘 것인가" 판단에 사용한다.
+
+```
+=== 리팩토링 판단 ===
+
+현재 코드 문제: {무엇이 문제인가}
+태스크와 관련성: 직접 관련 / 간접 관련 / 무관
+
+직접 관련 → 수정한다
+간접 관련 → result에 기록하되, 현재 태스크 범위 내에서만 수정
+무관     → result에 기록만 한다 (절대 수정하지 않는다)
+```
+
+---
+
+## 5. 성능 병목 분석 (Debug Agent, QA Agent)
+
+"느리다"는 보고에 대해 체계적으로 병목을 찾는다.
+
+```
+=== 성능 병목 분석 ===
+
+측정:
+  - 전체 응답 시간: {ms}
+  - DB 쿼리 시간: {ms} (쿼리 {N}개)
+  - 비즈니스 로직: {ms}
+  - 직렬화/렌더링: {ms}
+
+병목 위치: {가장 시간이 오래 걸리는 단계}
+원인: {N+1 쿼리 / 무거운 연산 / 큰 응답 / 인덱스 부재 / ...}
+해결: {구체적 수정 방법}
+예상 개선: {X}ms → {Y}ms
+```
+
+---
+
+## 사용 규칙
+
+1. **언제 사용하나**: Complex 난이도 태스크에서 필수, Medium에서 권장
+2. **어디에 기록하나**: `progress-{agent-id}.md`에 추론 과정 기록
+3. **빈칸을 채울 수 없으면**: 해당 정보를 먼저 수집 (Serena, 코드 읽기, 로그 확인)
+4. **3회 반복 후에도 미해결**: `Status: blocked` + 현재까지의 추론 기록을 result에 포함

package/.agent/skills/_shared/skill-routing.md

@@ -0,0 +1,80 @@
+# Skill Routing Map
+
+Orchestrator와 workflow-guide가 태스크를 올바른 에이전트에 배정하기 위한 라우팅 규칙.
+
+---
+
+## 키워드 → 스킬 매핑
+
+| 사용자 요청 키워드 | 1차 스킬 | 비고 |
+|-------------------|---------|------|
+| API, endpoint, REST, GraphQL, database, migration | **backend-agent** | |
+| 인증, auth, JWT, login, register, password | **backend-agent** | frontend에도 auth UI 태스크 생성 가능 |
+| UI, 컴포넌트, component, page, form, 화면(웹) | **frontend-agent** | |
+| 스타일, Tailwind, 반응형, responsive, CSS | **frontend-agent** | |
+| 모바일, iOS, Android, Flutter, React Native, 앱 | **mobile-agent** | |
+| 오프라인, push notification, camera, GPS | **mobile-agent** | |
+| 버그, bug, error, crash, 안됨, 깨짐, 느림 | **debug-agent** | |
+| 리뷰, review, 보안, security, 성능, performance | **qa-agent** | |
+| 접근성, accessibility, WCAG, a11y | **qa-agent** | |
+| 계획, plan, 분해, breakdown, 태스크, sprint | **pm-agent** | |
+| 자동, automatic, 병렬, parallel, orchestrate | **orchestrator** | |
+| 워크플로우, workflow, 가이드, manual, step-by-step | **workflow-guide** | |
+
+---
+
+## 복합 요청 라우팅
+
+| 요청 패턴 | 실행 순서 |
+|----------|----------|
+| "풀스택 앱 만들어줘" | pm → (backend + frontend) 병렬 → qa |
+| "모바일 앱 만들어줘" | pm → (backend + mobile) 병렬 → qa |
+| "풀스택 + 모바일" | pm → (backend + frontend + mobile) 병렬 → qa |
+| "버그 수정하고 리뷰해줘" | debug → qa |
+| "기능 추가하고 테스트해줘" | pm → 해당 agent → qa |
+| "자동으로 다 해줘" | orchestrator (내부적으로 pm → agents → qa) |
+| "수동으로 관리할게" | workflow-guide |
+
+---
+
+## 에이전트 간 의존성 규칙
+
+### 병렬 실행 가능 (의존성 없음)
+- backend + frontend (API 계약서가 사전 정의된 경우)
+- backend + mobile (API 계약서가 사전 정의된 경우)
+- frontend + mobile (서로 독립)
+
+### 순차 실행 필수
+- pm → 다른 모든 에이전트 (계획이 먼저)
+- 구현 에이전트 → qa (구현 완료 후 리뷰)
+- 구현 에이전트 → debug (구현 완료 후 디버깅)
+- backend → frontend/mobile (API 계약서 없이 병렬 실행 시)
+
+### QA는 항상 마지막
+- qa-agent는 모든 구현 태스크 완료 후에 실행
+- 예외: 사용자가 특정 파일만 리뷰 요청한 경우 즉시 실행 가능
+
+---
+
+## 에스컬레이션 규칙
+
+| 상황 | 에스컬레이션 대상 |
+|------|-----------------|
+| 에이전트가 다른 도메인 버그 발견 | debug-agent에 태스크 생성 |
+| QA에서 CRITICAL 발견 | 해당 도메인 에이전트 재실행 |
+| 아키텍처 변경 필요 | pm-agent에 재계획 요청 |
+| 성능 이슈 발견 (구현 중) | 현재 에이전트가 수정, 심각하면 debug-agent |
+| API 계약 불일치 | orchestrator가 backend 에이전트 재실행 |
+
+---
+
+## 에이전트별 턴 제한 가이드
+
+| 에이전트 | 기본 턴 | 최대 턴 (재시도 포함) |
+|---------|--------|---------------------|
+| pm-agent | 10 | 15 |
+| backend-agent | 20 | 30 |
+| frontend-agent | 20 | 30 |
+| mobile-agent | 20 | 30 |
+| debug-agent | 15 | 25 |
+| qa-agent | 15 | 20 |

package/.agent/skills/_shared/verify.sh

@@ -0,0 +1,252 @@
+#!/bin/bash
+# =============================================================================
+# Subagent Result Auto-Verification Script
+# Used by orchestrator after agent completion to objectively verify deliverables.
+#
+# Usage: bash .agent/skills/_shared/verify.sh <agent-type> <workspace-path>
+#   agent-type: backend | frontend | mobile | qa | debug | pm
+#   workspace-path: project root or agent workspace directory
+#
+# Exit codes:
+#   0 = all checks passed
+#   1 = some checks failed (see output)
+#   2 = invalid arguments
+# =============================================================================
+
+set -euo pipefail
+
+AGENT_TYPE="${1:-}"
+WORKSPACE="${2:-.}"
+PASS=0
+FAIL=0
+WARN=0
+
+if [ -z "$AGENT_TYPE" ]; then
+  echo "Usage: verify.sh <agent-type> <workspace-path>"
+  echo "  agent-type: backend | frontend | mobile | qa | debug | pm"
+  exit 2
+fi
+
+cd "$WORKSPACE" || { echo "FAIL: Cannot access workspace $WORKSPACE"; exit 2; }
+
+# --- Helper functions ---
+check_pass() { echo "  PASS: $1"; ((PASS++)); }
+check_fail() { echo "  FAIL: $1"; ((FAIL++)); }
+check_warn() { echo "  WARN: $1"; ((WARN++)); }
+check_skip() { echo "  SKIP: $1"; }
+
+echo "=========================================="
+echo "Verification: $AGENT_TYPE agent"
+echo "Workspace: $WORKSPACE"
+echo "=========================================="
+echo ""
+
+# --- Common checks (all agents) ---
+echo "[Common Checks]"
+
+# Check for hardcoded secrets
+if grep -rn --include="*.py" --include="*.ts" --include="*.tsx" --include="*.js" --include="*.dart" \
+  -E "(password|secret|api_key|token)\s*=\s*['\"][^'\"]{8,}" . 2>/dev/null | grep -v "test" | grep -v "example" | grep -v "node_modules" | head -5; then
+  check_fail "Possible hardcoded secrets found (see above)"
+else
+  check_pass "No hardcoded secrets detected"
+fi
+
+# Check for TODO/FIXME left behind
+TODO_COUNT=$(grep -rn --include="*.py" --include="*.ts" --include="*.tsx" --include="*.js" --include="*.dart" \
+  -E "TODO|FIXME|HACK|XXX" . 2>/dev/null | grep -v "node_modules" | grep -v ".agent/" | wc -l | tr -d ' ')
+if [ "$TODO_COUNT" -gt 0 ]; then
+  check_warn "$TODO_COUNT TODO/FIXME comments found"
+else
+  check_pass "No TODO/FIXME comments"
+fi
+
+echo ""
+
+# --- Agent-specific checks ---
+case "$AGENT_TYPE" in
+
+  backend)
+    echo "[Backend Checks]"
+
+    # Python syntax check
+    if command -v python3 &>/dev/null; then
+      PY_ERRORS=$(find . -name "*.py" -not -path "*/node_modules/*" -not -path "*/.venv/*" -exec python3 -m py_compile {} \; 2>&1 | head -10)
+      if [ -z "$PY_ERRORS" ]; then
+        check_pass "Python syntax valid"
+      else
+        echo "$PY_ERRORS"
+        check_fail "Python syntax errors found"
+      fi
+    else
+      check_skip "python3 not available"
+    fi
+
+    # Check for raw SQL string interpolation
+    if grep -rn --include="*.py" -E "f['\"].*SELECT|f['\"].*INSERT|f['\"].*UPDATE|f['\"].*DELETE" . 2>/dev/null | grep -v "test" | grep -v "node_modules" | head -5; then
+      check_fail "Possible SQL injection: f-string with SQL keywords"
+    else
+      check_pass "No SQL string interpolation detected"
+    fi
+
+    # Check for pytest
+    if command -v pytest &>/dev/null || [ -f "pyproject.toml" ]; then
+      if pytest --co -q 2>/dev/null | tail -1 | grep -q "no tests"; then
+        check_warn "No tests found"
+      else
+        if pytest -q --tb=no 2>/dev/null; then
+          check_pass "Tests pass"
+        else
+          check_fail "Tests failing"
+        fi
+      fi
+    else
+      check_skip "pytest not available"
+    fi
+    ;;
+
+  frontend)
+    echo "[Frontend Checks]"
+
+    # TypeScript check
+    if [ -f "tsconfig.json" ] && command -v npx &>/dev/null; then
+      if npx tsc --noEmit 2>/dev/null; then
+        check_pass "TypeScript compilation clean"
+      else
+        check_fail "TypeScript errors found"
+      fi
+    else
+      check_skip "TypeScript not configured or npx not available"
+    fi
+
+    # Check for inline styles
+    INLINE_COUNT=$(grep -rn --include="*.tsx" --include="*.jsx" 'style={{' . 2>/dev/null | grep -v "node_modules" | wc -l | tr -d ' ')
+    if [ "$INLINE_COUNT" -gt 0 ]; then
+      check_warn "$INLINE_COUNT inline styles found (should use Tailwind)"
+    else
+      check_pass "No inline styles"
+    fi
+
+    # Check for 'any' type
+    ANY_COUNT=$(grep -rn --include="*.ts" --include="*.tsx" ': any' . 2>/dev/null | grep -v "node_modules" | grep -v ".d.ts" | wc -l | tr -d ' ')
+    if [ "$ANY_COUNT" -gt 3 ]; then
+      check_fail "$ANY_COUNT 'any' types found (limit: 3)"
+    elif [ "$ANY_COUNT" -gt 0 ]; then
+      check_warn "$ANY_COUNT 'any' types found"
+    else
+      check_pass "No 'any' types"
+    fi
+
+    # Run tests
+    if [ -f "package.json" ] && command -v npx &>/dev/null; then
+      if npx vitest run --reporter=verbose 2>/dev/null; then
+        check_pass "Tests pass"
+      else
+        check_warn "Tests failed or vitest not configured"
+      fi
+    else
+      check_skip "No package.json or npx not available"
+    fi
+    ;;
+
+  mobile)
+    echo "[Mobile Checks]"
+
+    # Dart analysis
+    if command -v flutter &>/dev/null; then
+      ANALYSIS=$(flutter analyze 2>/dev/null | tail -3)
+      if echo "$ANALYSIS" | grep -q "No issues found"; then
+        check_pass "Flutter analysis clean"
+      else
+        echo "$ANALYSIS"
+        check_fail "Flutter analysis issues found"
+      fi
+    elif command -v dart &>/dev/null; then
+      if dart analyze 2>/dev/null | grep -q "No issues found"; then
+        check_pass "Dart analysis clean"
+      else
+        check_fail "Dart analysis issues found"
+      fi
+    else
+      check_skip "Flutter/Dart not available"
+    fi
+
+    # Check for undisposed controllers
+    UNDISPOSED=$(grep -rn --include="*.dart" "Controller()" . 2>/dev/null | grep -v "dispose" | grep -v "test" | grep -v ".dart_tool" | wc -l | tr -d ' ')
+    if [ "$UNDISPOSED" -gt 0 ]; then
+      check_warn "$UNDISPOSED controllers found — verify dispose() is called"
+    else
+      check_pass "Controller disposal looks correct"
+    fi
+
+    # Run tests
+    if command -v flutter &>/dev/null; then
+      if flutter test 2>/dev/null; then
+        check_pass "Flutter tests pass"
+      else
+        check_fail "Flutter tests failed"
+      fi
+    else
+      check_skip "Flutter not available for tests"
+    fi
+    ;;
+
+  qa)
+    echo "[QA Report Checks]"
+    # QA agent produces reports, not code — verify report quality
+    check_pass "QA agent report verified by self-check.md (manual)"
+    ;;
+
+  debug)
+    echo "[Debug Checks]"
+    # Debug agent fixes bugs — run the relevant test suite
+    echo "  Running project test suite to verify fix..."
+    if [ -f "pyproject.toml" ] && command -v pytest &>/dev/null; then
+      if pytest -q --tb=short 2>/dev/null; then
+        check_pass "All tests pass after fix"
+      else
+        check_fail "Tests failing after fix"
+      fi
+    elif [ -f "package.json" ] && command -v npx &>/dev/null; then
+      if npx vitest run 2>/dev/null; then
+        check_pass "All tests pass after fix"
+      else
+        check_fail "Tests failing after fix"
+      fi
+    else
+      check_skip "No test runner detected"
+    fi
+    ;;
+
+  pm)
+    echo "[PM Plan Checks]"
+    # PM produces plans, not code
+    if [ -f ".agent/plan.json" ]; then
+      check_pass "plan.json exists"
+      # Validate JSON
+      if python3 -c "import json; json.load(open('.agent/plan.json'))" 2>/dev/null; then
+        check_pass "plan.json is valid JSON"
+      else
+        check_fail "plan.json is invalid JSON"
+      fi
+    else
+      check_warn "plan.json not found at .agent/plan.json"
+    fi
+    ;;
+
+  *)
+    echo "Unknown agent type: $AGENT_TYPE"
+    exit 2
+    ;;
+esac
+
+echo ""
+echo "=========================================="
+echo "Results: $PASS passed, $FAIL failed, $WARN warnings"
+echo "=========================================="
+
+if [ "$FAIL" -gt 0 ]; then
+  exit 1
+else
+  exit 0
+fi