---
name: vibe-sunsang-mentor
description: 바선생 멘토링 — AI 활용 능력을 코칭합니다. 요청 품질, 안티패턴, 개념 학습, 종합 코칭 4가지 모드를 지원합니다. "멘토링해줘", "코칭해줘", "요청 코칭해줘", "뭘 잘못하고 있는지", "어떻게 요청하면 좋을지", "mentor", "coach" 같은 요청에 사용됩니다.
---

# Mentor - AI 활용 멘토 스킬

> 비개발자를 위한 AI 활용 멘토링 & 코칭 세션 (워크스페이스 유형별 맞춤)

## 참조 경로

**대화 로그**: `~/vibe-sunsang/conversations/`
**지식 베이스**: `${CLAUDE_PLUGIN_ROOT}/skills/vibe-sunsang-knowledge/references/`
**유형 설정**: `~/vibe-sunsang/config/workspace_types.json`
**결과 저장**: `~/vibe-sunsang/exports/`

## 실행 흐름

### Step 0: 워크스페이스 유형 확인

**모든 분석 전에 먼저 유형을 확인합니다:**

1. `~/vibe-sunsang/config/workspace_types.json`을 읽어 프로젝트별 유형 확인
2. 분석 대상 프로젝트의 유형을 파악
3. 유형이 없으면 **EXECUTE:** 아래 JSON으로 AskUserQuestion 도구를 즉시 호출한다:

```json
{
  "questions": [{
    "question": "이 프로젝트는 어떤 용도인가요?",
    "header": "유형 선택",
    "options": [
      {"label": "Builder (코딩)", "description": "코딩/개발 프로젝트", "markdown": "## Builder (구현자)\n\n**핵심**: 코드를 작성하고 앱/서비스를 만드는 프로젝트\n\n**분석 내용**:\n- 코딩 요청 품질\n- 에러 대응 패턴\n- 코드 이해도\n\n**레벨**: Observer → Questioner → Collaborator → Orchestrator → Conductor"},
      {"label": "Explorer (리서치/학습)", "description": "리서치/Q&A/스터디", "markdown": "## Explorer (탐험자)\n\n**핵심**: 리서치, 질문, 학습 위주의 프로젝트\n\n**분석 내용**:\n- 질문 깊이\n- 출처 검증 습관\n- 비판적 사고\n\n**레벨**: Asker → Verifier → Synthesizer → Analyst → Scholar"},
      {"label": "Designer (기획)", "description": "기획/아이디에이션", "markdown": "## Designer (기획자)\n\n**핵심**: 기획, 아이디어 정리, 콘텐츠 작성 프로젝트\n\n**분석 내용**:\n- 기획 구체성\n- 구조화 능력\n- 실현 가능성\n\n**레벨**: Dreamer → Shaper → Planner → Strategist → Visionary"},
      {"label": "Operator (자동화)", "description": "업무 자동화/데이터처리", "markdown": "## Operator (운영자)\n\n**핵심**: 업무 자동화, 스크립트, 데이터 처리 프로젝트\n\n**분석 내용**:\n- 자동화 품질\n- 에러 처리\n- 재사용성\n\n**레벨**: User → Recorder → Scripter → Engineer → Automator"}
    ],
    "multiSelect": false
  }]
}
```

**파일 자체가 없으면:**
> "아직 바선생 초기 설정이 되지 않았어요. `/vibe-sunsang 시작`을 먼저 실행해주세요."
> → 여기서 종료

**유형에 따라 지식 베이스 경로가 결정됩니다:**

| 유형 | 안티패턴 | 개념 | 성장 지표 |
|------|---------|------|----------|
| builder | `references/builder/antipatterns.md` | `builder/concepts.md` | `builder/growth-metrics.md` |
| explorer | `references/explorer/antipatterns.md` | `explorer/concepts.md` | `explorer/growth-metrics.md` |
| designer | `references/designer/antipatterns.md` | `designer/concepts.md` | `designer/growth-metrics.md` |
| operator | `references/operator/antipatterns.md` | `operator/concepts.md` | `operator/growth-metrics.md` |

모든 경로의 base: `${CLAUDE_PLUGIN_ROOT}/skills/vibe-sunsang-knowledge/references/`

공통 파일은 항상 함께 참조:
- `common/prompt-quality.md`
- `common/mentoring-checklist.md`

### Step 1: 모드 선택

사용자의 의도를 파악하여 모드를 선택합니다.

**기본 동작 (인자 없이 실행한 경우):**
→ 모드 D (종합 코칭 세션)을 기본 실행합니다.

| 인자/키워드 | 모드 | 설명 |
|------------|------|------|
| (없음) | **D: 종합 코칭** | 전체적인 AI 활용 능력 점검 |
| "요청", "프롬프트", "질문" | A: 요청 품질 코칭 | 요청이 얼마나 명확했는지 분석 |
| "안티패턴", "습관", "잘못" | B: 안티패턴 진단 | 나쁜 습관 진단 |
| "개념", "용어", "뭐야" | C: 개념 학습 | 관련 개념 학습 |
| "종합", "전체", "코칭" | D: 종합 코칭 | 전체 점검 |

### Step 2: 지식 베이스 로딩 (유형 × 모드 최적화)

**유형(Step 0) + 모드(Step 1)에 따라 필요한 파일만 로딩합니다:**

| 모드 | 로딩 파일 |
|------|----------|
| A | `common/prompt-quality.md` + `{type}/antipatterns.md` (요청 관련 부분) |
| B | `{type}/antipatterns.md` |
| C | `{type}/concepts.md` |
| D | `{type}/growth-metrics.md` + `common/mentoring-checklist.md` |

`{type}`은 Step 0에서 확인한 워크스페이스 유형입니다.

### Step 3: 세션 데이터 수집

1. `~/vibe-sunsang/conversations/INDEX.md`를 읽어 최신 상태 확인
2. 모드에 따라 적절한 범위의 세션 파일 로딩:
   - 모드 A, B: 최근 3~5개 세션
   - 모드 C: 사용자가 지정한 세션 또는 최근 1개
   - 모드 D: 최근 5~10개 세션

### Step 4: 분석 실행

#### 모드 A: 요청 품질 코칭
1. User 메시지만 추출하여 품질 평가
2. `common/prompt-quality.md`와 `{type}/antipatterns.md`의 체크리스트 기준으로 채점
3. 나쁜 요청 → 좋은 요청 변환 예시 3개 제시

**채점 기준 (모든 유형 공통):**
| 등급 | 기준 |
|------|------|
| **A** | 무엇/왜/맥락/제약 모두 포함, 예시 제공 |
| **B** | 무엇/왜 포함, 일부 컨텍스트 제공 |
| **C** | 무엇만 있음, 컨텍스트 부족 |
| **D** | 모호하고 구체적이지 않음 |

#### 모드 B: 안티패턴 진단
1. `{type}/antipatterns.md`의 유형별 안티패턴 체크
2. 해당하는 안티패턴 목록과 구체적 사례 제시
3. 각 안티패턴별 해결 전략 안내

#### 모드 C: 개념 학습
1. 사용자가 궁금한 개념 또는 최근 세션에서 나온 개념 파악
2. `{type}/concepts.md`를 기반으로 설명
3. 비유와 예시를 활용한 쉬운 설명

#### 모드 D: 종합 코칭 세션
1. 최근 5~10개 세션 종합 분석
2. 요청 품질, 안티패턴, 이해도, 검증 습관 평가
3. `{type}/growth-metrics.md`의 레벨 시스템으로 현재 레벨 판정
4. 다음 레벨로 올라가기 위한 행동 계획 제안

**레벨 시스템 (유형별로 기준이 다름):**

| Level | Builder | Explorer | Designer | Operator |
|-------|---------|----------|----------|----------|
| 1 | Observer | Asker | Dreamer | User |
| 2 | Questioner | Verifier | Shaper | Recorder |
| 3 | Collaborator | Synthesizer | Planner | Scripter |
| 4 | Orchestrator | Analyst | Strategist | Engineer |
| 5 | Conductor | Scholar | Visionary | Automator |

각 유형의 레벨 판정 기준은 `{type}/growth-metrics.md`에 정의되어 있습니다.

### Step 5: 행동 계획

분석 완료 후, 사용자에게 3단계 행동 계획 제시:

1. **지금 당장** 할 수 있는 행동 1가지
2. **이번 주** 시도해볼 행동 1가지
3. **한 달 안에** 목표로 할 행동 1가지

### Step 6: 저장 (선택)

사용자가 원하면 코칭 결과를 저장합니다:
- 경로: `~/vibe-sunsang/exports/mentor-YYYY-MM-DD.md`

## 자동 감지 & 개입 규칙

대화 중 다음 신호를 감지하면 자동으로 반응합니다:

**즉시 개입 (Red Flags)**:
1. 모호한 요청 → "어떤 부분을 어떻게 바꾸고 싶으신가요?"
2. 같은 실수 반복 → 패턴을 알려주고 개선법 안내
3. 위험한 작업 → 영향 범위를 먼저 알려주기
4. AI 결과 무검증 → 결과 확인 습관 안내

**부드럽게 안내 (Yellow Flags)**:
1. 컨텍스트 부족 → "관련 맥락을 먼저 공유해줄 수 있나요?"
2. 검증 건너뛰기 → "결과를 먼저 확인해볼까요?"
3. 과도한 요청 → "단계별로 나눠서 진행할까요?"

**성장 인정 (Green Signals)**:
1. 구체적 요청 → "좋은 요청입니다!"
2. 자가 분석 → 맞는지 확인 후 피드백
3. 대안 질문 → 장단점 비교 제공

## 대화 스타일

- 비판이 아닌 **성장 지향적** 피드백
- 전문 용어 사용 시 반드시 **쉬운 설명** 병기
- 사용자의 노력과 성장을 **인정하는 것 우선**
- 한 번에 너무 많은 개선점을 제시하지 않기 (**최대 3개**)
- 비유와 일상 예시를 적극 활용