oh-my-ag 1.2.0

package/.agent/skills/_shared/api-contracts/README.md

@@ -0,0 +1,56 @@
+# API Contracts
+
+이 디렉토리는 PM Agent가 생성하고, backend/frontend/mobile 에이전트가 참조하는 API 계약서를 담습니다.
+
+## 사용법
+
+### PM Agent (작성자)
+계획 단계에서 API 계약서를 여기에 생성:
+```
+[WRITE]("api-contracts/{domain}.md", contract content)
+```
+
+MCP 메모리 도구가 없을 경우 이 디렉토리에 직접 파일 생성.
+
+### Backend Agent (구현자)
+계약서를 읽고 그대로 구현:
+```
+[READ]("api-contracts/{domain}.md")
+```
+
+### Frontend / Mobile Agent (소비자)
+계약서를 읽고 API 클라이언트를 그대로 연동:
+```
+[READ]("api-contracts/{domain}.md")
+```
+
+## Tool Reference
+
+도구명은 `mcp.json → memoryConfig.tools`에서 설정:
+- `[READ]` → default: `read_memory`
+- `[WRITE]` → default: `write_memory`
+
+## 계약서 형식
+
+```markdown
+# {Domain} API Contract
+
+## POST /api/{resource}
+- **Auth**: Required (JWT Bearer)
+- **Request Body**:
+  ```json
+  { "field": "type", "field2": "type" }
+  ```
+- **Response 200**:
+  ```json
+  { "id": "uuid", "field": "value", "created_at": "ISO8601" }
+  ```
+- **Response 401**: `{ "detail": "Not authenticated" }`
+- **Response 422**: `{ "detail": [{ "field": "error message" }] }`
+```
+
+## 규칙
+1. PM Agent가 계획 시 반드시 생성
+2. Backend Agent는 계약서와 다르게 구현하면 안 됨
+3. Frontend/Mobile Agent는 계약서 기준으로 타입 정의
+4. 변경이 필요하면 PM Agent에게 재계획 요청

package/.agent/skills/_shared/api-contracts/template.md

@@ -0,0 +1,88 @@
+# {Domain} API Contract
+
+> Generated by PM Agent | Session: {session-id} | Date: {YYYY-MM-DD}
+
+## Base URL
+`/api/{domain}`
+
+## Authentication
+All endpoints require JWT Bearer token unless marked as `Public`.
+
+---
+
+## Endpoints
+
+### POST /api/{domain}
+- **Description**: Create a new {resource}
+- **Auth**: Required
+- **Request Body**:
+  ```json
+  {
+    "field1": "string (required)",
+    "field2": "number (optional, default: 0)"
+  }
+  ```
+- **Response 201**:
+  ```json
+  {
+    "id": "uuid",
+    "field1": "string",
+    "field2": 0,
+    "created_at": "2024-01-01T00:00:00Z"
+  }
+  ```
+- **Errors**: 401, 422
+
+### GET /api/{domain}
+- **Description**: List {resources} (paginated)
+- **Auth**: Required
+- **Query Params**: `page` (default: 1), `size` (default: 20)
+- **Response 200**:
+  ```json
+  {
+    "items": [...],
+    "total": 100,
+    "page": 1,
+    "size": 20
+  }
+  ```
+
+### GET /api/{domain}/{id}
+- **Description**: Get single {resource}
+- **Auth**: Required
+- **Response 200**: Single resource object
+- **Errors**: 401, 404
+
+### PATCH /api/{domain}/{id}
+- **Description**: Update {resource}
+- **Auth**: Required (owner only)
+- **Request Body**: Partial update fields
+- **Response 200**: Updated resource object
+- **Errors**: 401, 403, 404, 422
+
+### DELETE /api/{domain}/{id}
+- **Description**: Delete {resource}
+- **Auth**: Required (owner only)
+- **Response 204**: No content
+- **Errors**: 401, 403, 404
+
+---
+
+## Data Models
+
+### {Resource}
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| id | UUID | auto | Primary key |
+| field1 | string | yes | Description |
+| field2 | number | no | Default: 0 |
+| user_id | UUID | auto | Owner (FK to users) |
+| created_at | datetime | auto | ISO 8601 |
+| updated_at | datetime | auto | ISO 8601 |
+
+---
+
+## Notes
+- Pagination: offset-based (page/size)
+- Sorting: `?sort=created_at&order=desc` (optional)
+- Filtering: `?field1=value` (optional)

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

@@ -0,0 +1,217 @@
+# Clarification Protocol
+
+요구사항이 모호할 때 "가정하고 진행"하면 대부분 잘못된 방향으로 간다.
+이 프로토콜을 따라 명확한 요구사항을 확보한 후 실행한다.
+
+> **핵심 원칙**: "Agents learn when to ask for help rather than blindly attempting every task" - Ask early, ask often.
+
+---
+
+## 불확실성 레벨 정의 (Uncertainty Levels)
+
+| 레벨 | 상태 | 행동 | 예시 |
+|------|------|------|------|
+| **LOW** | 명확함 | 기본값 적용 후 진행, 가정 기록 | "TODO 앱 만들어줘" |
+| **MEDIUM** | 일부 모호 | 2-3개 옵션 제시 + 사용자 선택 요청 | "사용자 관리 시스템 만들어줘" |
+| **HIGH** | 매우 모호 | **진행 불가**, 반드시 질문 | "좋은 앱 만들어줘" |
+
+---
+
+## 불확실성 트리거 (Uncertainty Triggers)
+
+다음 상황에서 자동으로 MEDIUM/HIGH 레벨로 분류:
+
+### HIGH (반드시 질문)
+- [ ] 비즈니스 로직 결정 필요 (가격 정책, 승인 워크플로우 등)
+- [ ] 보안/인증 관련 결정 (OAuth provider, 권한 모델 등)
+- [ ] 기존 코드와 충돌 가능성 있음
+- [ ] 요구사항이主관적 ("좋은", "빠른", "예쁜")
+- [ ] 범위가 무제한으로 느껴짐
+
+### MEDIUM (옵션 제시)
+- [ ] 기술 스택 선택 가능성 2개 이상
+- [ ] 구현 방식에 대한 trade-off 존재
+- [ ] 우선순위가 불명확한 다중 기능
+- [ ] 외부 API/서비스 선택 필요
+
+---
+
+## 에스컬레이션 템플릿 (Escalation Templates)
+
+### LOW → 진행 (Assumed)
+```
+⚠️ Assumptions applied:
+- JWT authentication included
+- PostgreSQL database
+- REST API
+- MVP scope (CRUD only)
+
+Proceeding with these defaults. Override if needed.
+```
+
+### MEDIUM → 선택 요청 (Options)
+```
+🔍 Uncertainty detected: {specific issue}
+
+Option A: {approach}
+  ✅ Pros: {benefits}
+  ❌ Cons: {drawbacks}
+  💰 Effort: {low/medium/high}
+
+Option B: {approach}
+  ✅ Pros: {benefits}
+  ❌ Cons: {drawbacks}
+  💰 Effort: {low/medium/high}
+
+Option C: {approach}
+  ✅ Pros: {benefits}
+  ❌ Cons: {drawbacks}
+  💰 Effort: {low/medium/high}
+
+Which approach do you prefer? (A/B/C)
+```
+
+### HIGH → 차단 (Blocked)
+```
+❌ Cannot proceed: Requirements too ambiguous
+
+Specific uncertainty: {what is unclear}
+
+Questions needed:
+1. {specific question}
+2. {specific question}
+3. {specific question}
+
+Impact of proceeding blindly: {what could go wrong}
+
+Status: BLOCKED (awaiting clarification)
+```
+
+---
+
+## 필수 확인 항목
+
+아래 항목 중 하나라도 불명확하면 **가정하지 말고** 명시적으로 기록한다.
+
+### 모든 에이전트 공통
+| 항목 | 확인 질문 | 기본값 (가정 시) | 불확실성 |
+|------|----------|-----------------|----------|
+| 대상 사용자 | 누가 쓰는 서비스인가? | 일반 웹 사용자 | LOW |
+| 핵심 기능 | 반드시 포함해야 할 기능 3가지는? | 태스크 설명에서 추론 | MEDIUM |
+| 기술 스택 | 특정 프레임워크 제약이 있는가? | 프로젝트 기본 스택 | LOW |
+| 인증 | 로그인이 필요한가? | JWT 인증 포함 | MEDIUM |
+| 범위 | MVP인가 완전한 기능인가? | MVP | LOW |
+
+### Backend Agent 추가 확인
+| 항목 | 확인 질문 | 기본값 | 불확실성 |
+|------|----------|--------|----------|
+| DB 선택 | PostgreSQL? MongoDB? SQLite? | PostgreSQL | MEDIUM |
+| API 스타일 | REST? GraphQL? gRPC? | REST | MEDIUM |
+| 인증 방식 | JWT? Session? OAuth? | JWT (access + refresh) | HIGH |
+| 파일 업로드 | 필요한가? 크기 제한은? | 불필요 | LOW |
+| 배포 환경 | Serverless? Container? VM? | Container | MEDIUM |
+
+### Frontend Agent 추가 확인
+| 항목 | 확인 질문 | 기본값 | 불확실성 |
+|------|----------|--------|----------|
+| SSR/CSR | Server-side rendering 필요? | Next.js App Router (SSR) | MEDIUM |
+| 다크모드 | 지원 필요? | 지원 | LOW |
+| 국제화 | 다국어 지원? | 불필요 | LOW |
+| 기존 디자인 시스템 | 사용할 UI 라이브러리? | shadcn/ui | MEDIUM |
+| 상태 관리 | Context? Redux? Zustand? | Zustand | MEDIUM |
+
+### Mobile Agent 추가 확인
+| 항목 | 확인 질문 | 기본값 | 불확실성 |
+|------|----------|--------|----------|
+| 플랫폼 | iOS만? Android만? 둘 다? | 둘 다 | MEDIUM |
+| 오프라인 | 오프라인 지원 필요? | 불필요 | LOW |
+| 푸시 알림 | 필요한가? | 불필요 | LOW |
+| 최소 OS | iOS/Android 최소 버전? | iOS 14+, Android API 24+ | LOW |
+| 아키텍처 | MVC? MVVM? Clean? | MVVM | MEDIUM |
+
+---
+
+## 모호함 수준별 대응 (상세)
+
+### Level 1 (LOW): 약간 모호 (핵심은 명확, 세부사항 부족)
+예: "TODO 앱 만들어줘"
+
+**대응**: 기본값을 적용하고, 가정 목록을 result에 기록
+```
+⚠️ Assumptions:
+- JWT authentication included
+- PostgreSQL database
+- REST API
+- MVP scope (CRUD only)
+```
+
+### Level 2 (MEDIUM): 상당히 모호 (핵심 기능이 불명확)
+예: "사용자 관리 시스템 만들어줘"
+
+**대응**: 핵심 기능을 3가지로 좁혀서 명시하고 진행
+```
+⚠️ Interpreted scope (3 core features):
+1. User registration + login (JWT)
+2. Profile management (view/edit)
+3. Admin user list (admin role only)
+
+NOT included (would need separate task):
+- Role-based access control (beyond admin/user)
+- Social login (OAuth)
+- Email verification
+```
+
+### Level 3 (HIGH): 매우 모호 (방향 자체가 불명확)
+예: "좋은 앱 만들어줘", "이거 개선해줘"
+
+**대응**: 진행하지 말고 구체화 요청을 result에 기록
+```
+❌ Cannot proceed: Requirements too ambiguous
+
+Questions needed:
+1. What is the app's primary purpose?
+2. Who are the target users?
+3. What are the 3 must-have features?
+4. Are there existing designs or wireframes?
+
+Status: blocked (awaiting clarification)
+```
+
+---
+
+## PM Agent 전용: 요구사항 구체화 프레임워크
+
+PM Agent는 모호한 요청을 받으면 아래 프레임워크로 구체화한다:
+
+```
+=== 요구사항 구체화 ===
+
+원본 요청: "{사용자 원문}"
+
+1. 핵심 목표: {한 문장으로 정의}
+2. 사용자 스토리:
+   - "As a {user}, I want to {action} so that {benefit}"
+   - (최소 3개)
+3. 기능 범위:
+   - Must-have: {목록}
+   - Nice-to-have: {목록}
+   - Out-of-scope: {목록}
+4. 기술 제약:
+   - {기존 코드 / 스택 / 호환성}
+5. 성공 기준:
+   - {측정 가능한 조건}
+```
+
+---
+
+## 서브에이전트 모드에서의 적용
+
+CLI 서브에이전트는 사용자에게 직접 질문할 수 없다.
+따라서:
+
+1. **Level 1**: 기본값 적용 + 가정 기록 → 진행
+2. **Level 2**: 범위를 좁혀서 해석 + 명시 → 진행
+3. **Level 3**: `Status: blocked` + 질문 목록 → 진행하지 않음
+
+Orchestrator는 Level 3 결과를 받으면 사용자에게 질문을 전달하고,
+답변을 받은 후 해당 에이전트를 재실행한다.

package/.agent/skills/_shared/common-checklist.md

@@ -0,0 +1,31 @@
+# Common Code Quality Checklist
+
+Apply these checks to ALL code before submitting, regardless of domain.
+
+## Code Quality
+- [ ] No hardcoded secrets (API keys, passwords, tokens)
+- [ ] No `TODO`/`FIXME` left unresolved
+- [ ] Meaningful variable and function names
+- [ ] Functions < 50 lines, files < 500 lines
+- [ ] Cyclomatic complexity < 10 per function
+- [ ] No deeply nested code (< 4 levels)
+
+## Error Handling
+- [ ] All async operations have try/catch or error boundaries
+- [ ] User-facing error messages are clear and actionable
+- [ ] No silent failures (errors logged or surfaced)
+
+## Security
+- [ ] No user input directly in SQL/shell/HTML
+- [ ] Authentication checked on protected endpoints
+- [ ] Sensitive data not in logs or error messages
+
+## Testing
+- [ ] Unit tests for new business logic
+- [ ] Edge cases covered (empty, null, boundary values)
+- [ ] Tests actually assert meaningful behavior
+
+## Git Hygiene
+- [ ] Commit message describes the "why", not the "what"
+- [ ] No unrelated changes bundled
+- [ ] No generated files or secrets committed

package/.agent/skills/_shared/context-budget.md

@@ -0,0 +1,118 @@
+# Context Budget Management
+
+컨텍스트 윈도우는 유한하다. 특히 Flash급 모델에서는 불필요한 로딩이 성능을 직접 저하시킨다.
+이 가이드를 따라 컨텍스트를 효율적으로 사용한다.
+
+---
+
+## 핵심 원칙
+
+1. **전체 파일 읽기 금지** — 필요한 함수/클래스만 읽는다
+2. **중복 읽기 금지** — 이미 읽은 파일은 다시 읽지 않는다
+3. **리소스 지연 로딩** — 필요한 시점에 필요한 리소스만 로딩한다
+4. **기록 유지** — 읽은 파일과 심볼을 progress에 메모한다
+
+---
+
+## 파일 읽기 전략
+
+### Serena MCP 사용 시 (권장)
+
+```
+❌ 나쁜 예: read_file("app/api/todos.py")          ← 전체 파일 500줄
+✅ 좋은 예: find_symbol("create_todo")              ← 해당 함수 30줄
+✅ 좋은 예: get_symbols_overview("app/api")          ← 함수 목록만
+✅ 좋은 예: find_referencing_symbols("TodoService")  ← 사용처만
+```
+
+### Serena 없이 파일 읽기 시
+
+```
+❌ 나쁜 예: 파일 전체를 한 번에 읽기
+✅ 좋은 예: 파일의 첫 50줄 (import + 클래스 정의) 확인 → 필요한 함수만 추가 읽기
+```
+
+---
+
+## 리소스 로딩 예산
+
+### Flash급 모델 (128K 컨텍스트)
+
+| 구분 | 예산 | 비고 |
+|------|------|------|
+| SKILL.md | ~800 토큰 | 자동 로딩 |
+| execution-protocol.md | ~500 토큰 | 항상 로딩 |
+| 태스크 리소스 1개 | ~500 토큰 | 난이도별 선택 |
+| 태스크 리소스 2개 | ~500 토큰 | Complex만 |
+| error-playbook.md | ~800 토큰 | 에러 시만 |
+| **총 리소스 예산** | **~3,100 토큰** | 전체의 ~2.4% |
+| **작업용 예산** | **~125K 토큰** | 나머지 전부 |
+
+### Pro급 모델 (1M+ 컨텍스트)
+
+| 구분 | 예산 | 비고 |
+|------|------|------|
+| 리소스 예산 | ~5,000 토큰 | 넉넉하게 로딩 가능 |
+| 작업용 예산 | ~1M 토큰 | 큰 파일도 가능 |
+
+Pro는 예산 압박이 적지만, 불필요한 로딩은 여전히 주의력을 분산시킨다.
+
+---
+
+## 읽은 파일 추적 (progress에 기록)
+
+에이전트는 progress 업데이트 시 읽은 파일/심볼을 기록한다:
+
+```markdown
+## Turn 3 Progress
+
+### 읽은 파일
+- app/api/todos.py: create_todo(), update_todo() (find_symbol)
+- app/models/todo.py: Todo class (find_symbol)
+- app/schemas/todo.py: 전체 (짧은 파일, 40줄)
+
+### 아직 안 읽은 파일
+- app/services/todo_service.py (다음 턴에 읽을 예정)
+- tests/test_todos.py (구현 후 참조)
+
+### 수행한 작업
+- TodoCreate 스키마에 priority 필드 추가
+```
+
+이렇게 하면:
+- 같은 파일을 중복으로 읽지 않음
+- 다음 턴에 뭘 할지 명확함
+- Orchestrator가 에이전트 상태를 파악 가능
+
+---
+
+## 대형 파일 처리 전략
+
+### 500줄 이상 파일
+
+1. `get_symbols_overview`로 구조 파악
+2. 필요한 심볼만 `find_symbol`로 읽기
+3. 전체 파일은 절대 읽지 않음
+
+### 복잡한 컴포넌트 (React/Flutter)
+
+1. 컴포넌트의 props/state 정의만 먼저 읽기
+2. render/build 메서드는 수정이 필요할 때만 읽기
+3. 스타일 부분은 수정 대상이 아니면 스킵
+
+### 테스트 파일
+
+1. 구현 완료 후에만 읽기 (구현 전에는 불필요)
+2. 기존 테스트 패턴만 확인 (첫 1-2개 테스트 함수만)
+3. 나머지는 패턴을 따라서 작성
+
+---
+
+## 컨텍스트 초과 징후 & 대응
+
+| 징후 | 의미 | 대응 |
+|------|------|------|
+| 앞서 읽은 코드를 잊음 | 컨텍스트 윈도우 소진 | progress에 핵심 정보 메모, 재참조 가능하게 |
+| 같은 파일을 반복 읽음 | 추적 미비 | progress의 "읽은 파일" 목록 확인 |
+| 출력이 갑자기 짧아짐 | 출력 토큰 부족 | 핵심만 작성, 부가 설명 생략 |
+| 지시사항을 무시함 | SKILL.md 내용 잊음 | execution-protocol 핵심만 재참조 |

package/.agent/skills/_shared/context-loading.md

@@ -0,0 +1,105 @@
+# Dynamic Context Loading Guide
+
+에이전트는 모든 리소스를 한 번에 읽지 말고, 태스크 유형에 따라 필요한 리소스만 로딩한다.
+이렇게 하면 컨텍스트 윈도우를 절약하고, 관련 없는 정보로 인한 혼란을 방지한다.
+
+---
+
+## 로딩 순서 (모든 에이전트 공통)
+
+### 항상 로딩 (필수)
+1. `SKILL.md` — 자동 로딩됨 (Antigravity가 제공)
+2. `resources/execution-protocol.md` — 실행 프로토콜
+
+### 태스크 시작 시 로딩
+3. `../_shared/difficulty-guide.md` — 난이도 판단 (Step 0)
+
+### 난이도에 따라 로딩
+4. **Simple**: 추가 로딩 없이 바로 구현
+5. **Medium**: `resources/examples.md` (유사 예시 참고)
+6. **Complex**: `resources/examples.md` + `resources/tech-stack.md` + `resources/snippets.md`
+
+### 실행 중 필요시 로딩
+7. `resources/checklist.md` — Step 4 (Verify) 시점에 로딩
+8. `resources/error-playbook.md` — 에러 발생 시에만 로딩
+9. `../_shared/common-checklist.md` — Complex 태스크의 최종 검증 시
+10. `../_shared/serena-memory-protocol.md` — CLI 모드일 때만
+
+---
+
+## 에이전트별 태스크 유형 → 리소스 매핑
+
+### Backend Agent
+
+| 태스크 유형 | 필요 리소스 |
+|------------|-----------|
+| CRUD API 생성 | snippets.md (route, schema, model, test) |
+| 인증 구현 | snippets.md (JWT, password) + tech-stack.md |
+| DB 마이그레이션 | snippets.md (migration) |
+| 성능 최적화 | examples.md (N+1 example) |
+| 기존 코드 수정 | examples.md + Serena MCP |
+
+### Frontend Agent
+
+| 태스크 유형 | 필요 리소스 |
+|------------|-----------|
+| 컴포넌트 생성 | snippets.md (component, test) + component-template.tsx |
+| 폼 구현 | snippets.md (form + Zod) |
+| API 연동 | snippets.md (TanStack Query) |
+| 스타일링 | tailwind-rules.md |
+| 페이지 레이아웃 | snippets.md (grid) + examples.md |
+
+### Mobile Agent
+
+| 태스크 유형 | 필요 리소스 |
+|------------|-----------|
+| 화면 생성 | snippets.md (screen, provider) + screen-template.dart |
+| API 연동 | snippets.md (repository, Dio) |
+| 네비게이션 | snippets.md (GoRouter) |
+| 오프라인 기능 | examples.md (offline example) |
+| 상태 관리 | snippets.md (Riverpod) |
+
+### Debug Agent
+
+| 태스크 유형 | 필요 리소스 |
+|------------|-----------|
+| 프론트엔드 버그 | common-patterns.md (Frontend section) |
+| 백엔드 버그 | common-patterns.md (Backend section) |
+| 모바일 버그 | common-patterns.md (Mobile section) |
+| 성능 버그 | common-patterns.md (Performance section) + debugging-checklist.md |
+| 보안 버그 | common-patterns.md (Security section) |
+
+### QA Agent
+
+| 태스크 유형 | 필요 리소스 |
+|------------|-----------|
+| 보안 리뷰 | checklist.md (Security section) |
+| 성능 리뷰 | checklist.md (Performance section) |
+| 접근성 리뷰 | checklist.md (Accessibility section) |
+| 전체 감사 | checklist.md (전체) + self-check.md |
+
+### PM Agent
+
+| 태스크 유형 | 필요 리소스 |
+|------------|-----------|
+| 신규 프로젝트 계획 | examples.md + task-template.json + api-contracts/template.md |
+| 기능 추가 계획 | examples.md + Serena MCP (기존 구조 파악) |
+| 리팩토링 계획 | Serena MCP만 |
+
+---
+
+## Orchestrator 전용: 서브에이전트 프롬프트 구성 시
+
+Orchestrator가 서브에이전트 프롬프트를 구성할 때, 위 매핑을 참조하여
+태스크 유형에 맞는 리소스 경로만 프롬프트에 포함시킨다.
+
+```
+프롬프트 구성:
+1. 에이전트 SKILL.md의 Core Rules 섹션
+2. execution-protocol.md
+3. 태스크 유형에 매칭되는 리소스 (위 표 참조)
+4. error-playbook.md (항상 포함 — 복구 필수)
+5. Serena Memory Protocol (CLI 모드)
+```
+
+이렇게 하면 불필요한 리소스를 로딩하지 않아 서브에이전트의 컨텍스트 효율이 극대화된다.

package/.agent/skills/_shared/difficulty-guide.md

@@ -0,0 +1,55 @@
+# Difficulty Assessment & Protocol Branching
+
+모든 에이전트는 태스크 시작 시 난이도를 판단하고, 그에 맞는 프로토콜 깊이를 적용한다.
+
+## 난이도 판단 기준
+
+### Simple (단순)
+- 단일 파일 변경
+- 명확한 요구사항 (예: "버튼 색상 변경", "필드 추가")
+- 기존 패턴 반복
+- **예상 턴**: 3-5
+
+### Medium (보통)
+- 2-3 파일 변경
+- 약간의 설계 판단 필요
+- 기존 패턴을 새 도메인에 적용
+- **예상 턴**: 8-15
+
+### Complex (복잡)
+- 4개 이상 파일 변경
+- 아키텍처 결정 필요
+- 새로운 패턴 도입
+- 다른 에이전트 결과물에 의존
+- **예상 턴**: 15-25
+
+---
+
+## 프로토콜 분기
+
+### Simple → Fast Track
+1. ~~Step 1 (Analyze)~~: 스킵 — 바로 구현
+2. Step 3 (Implement): 구현
+3. Step 4 (Verify): 체크리스트 최소 항목만
+
+### Medium → Standard Protocol
+1. Step 1 (Analyze): 간략히
+2. Step 2 (Plan): 간략히
+3. Step 3 (Implement): 전체
+4. Step 4 (Verify): 전체
+
+### Complex → Extended Protocol
+1. Step 1 (Analyze): 전체 + Serena로 기존 코드 탐색
+2. Step 2 (Plan): 전체 + progress에 계획 기록
+3. **Step 2.5 (Checkpoint)**: 계획을 `progress-{agent-id}.md`에 기록
+4. Step 3 (Implement): 전체
+5. **Step 3.5 (Mid-check)**: 구현 50% 시점에서 progress 업데이트 + 방향 점검
+6. Step 4 (Verify): 전체 + `../_shared/common-checklist.md`도 실행
+
+---
+
+## 난이도 오판 복구
+
+- Simple로 시작했는데 예상보다 복잡 → Medium 프로토콜로 전환, progress에 기록
+- Medium으로 시작했는데 아키텍처 결정 필요 → Complex로 업그레이드
+- Complex로 시작했는데 실제로 간단 → 그냥 빠르게 끝내면 됨 (오버헤드 최소)