---
name: session-research
description: 세션 plan을 읽고 발표 재료 리서치를 수행해 materials/에 저장
argument-hint: "[세션ID] [주제키워드]"
allowed-tools: Read, Glob, Write, Edit, Bash, WebSearch
---

# 세션 발표 재료 리서치

## 목적

세션 기획안(plan.md)에서 발표 구조와 주제를 파악하고, 필요한 리서치를 수행해
`materials/`에 저장한다. 이 스킬은 **기획 확정 이후, 슬라이드 제작 이전**에 실행한다.

---

## 입력

| 인자 | 필수 | 설명 |
|------|------|------|
| `세션ID` | 선택 | `S01`, `S02` 등. 없으면 `02_sessions/`에서 최신 폴더 자동 탐지 |
| `주제키워드` | 선택 | 리서치 초점 키워드 (없으면 plan.md에서 자동 추출) |

---

## 사전 조건 (게이트)

이 스킬을 실행하기 전에 아래 조건이 충족되어야 한다:

| 조건 | 확인 방법 |
|------|----------|
| `session-ops setup`으로 폴더·plan.md 생성 완료 | `02_sessions/{세션ID}-*/` 폴더 존재 |
| plan.md `session_status: confirmed` 또는 구조(발표 섹션·순서) 확정 | frontmatter 확인 |

조건 미충족 시 사용자에게 알리고 중단한다.

---

## 절차

### 1. 컨텍스트 파악

아래 파일을 읽어 현재 상태를 파악한다:

```
_system/agents/memory/active-context.md   ← 클럽 현재 상태 및 다음 세션 정보
```

### 2. plan.md 읽기

세션ID가 주어지면 해당 폴더를, 없으면 `02_sessions/`에서 가장 최근 `S{NN}-*` 폴더를 찾는다.

```bash
# 세션 폴더 탐지 (세션ID 없을 때)
ls 02_sessions/ | grep -E '^S[0-9]' | sort | tail -1
```

`{세션폴더}/S{NN}-{슬러그}-plan.md`를 읽어 다음을 파악한다:

- 세션 제목, 날짜, 진행자
- 발표 구조 (1부/2부 각 섹션·순서·재료 컬럼)
- 핵심 메시지
- 기존 `## 참고 자료` 섹션 — 이미 링크된 자료 확인 (중복 방지)

### 3. 리서치 항목 식별

plan.md의 발표 구조를 분석해 **2~4개**의 리서치 항목을 도출한다.

우선순위:

1. **재료 컬럼에 명시된 미수집 항목** — 발표 구조 테이블의 "재료" 컬럼에 표기됐으나 materials/에 없는 것
2. **핵심 개념 배경지식** — 발표자가 설명해야 할 핵심 용어·이론의 레퍼런스
3. **사례·인용** — 발표에서 인용할 외부 사례, 연구, 인물 발언
4. **비교·데이터** — 발표 논거를 뒷받침할 통계·비교 자료

식별한 항목을 사용자에게 보여주고 확인받는다 (3개 이상 필수).

### 4. 리서치 수행

각 항목에 대해 WebSearch로 리서치를 수행한다.

리서치 기준:

- 출처 신뢰도: 공식 문서 > 학술 자료 > 주요 미디어 > 블로그
- 최신성: 2년 이내 자료 우선 (배경지식 제외)
- 적용성: "[클럽명] 대학생 멤버에게 어떻게 연결되는가" 한 줄 포함

각 항목당 레퍼런스 최소 1개, 전체 최소 3개 확보.

### 5. 리서치 파일 저장

파일명: `YYMMDD-S{N}-발표재료-리서치.md`
저장 위치: `02_sessions/{세션폴더}/materials/`

```yaml
---
title: "S{NN} 발표 재료 리서치 — {세션 제목}"
kind: research-note
area: sessions
status: draft
created: YYYY-MM-DD
session_id: "S{NN}"
up: "[[S{NN}-{슬러그}-plan]]"
tags:
  - session/S{NN}
  - session/research
---
```

파일 구조:

```markdown
# S{NN} 발표 재료 리서치 — {세션 제목}

> 생성일: YYYY-MM-DD | plan 기준: [[S{NN}-{슬러그}-plan]]

---

## 리서치 요약

| # | 항목 | 레퍼런스 수 | 활용 위치 |
|---|------|------------|---------|
| 1 | {항목명} | N | {발표 섹션} |
| 2 | {항목명} | N | {발표 섹션} |

---

## {항목 1}

### 배경

[2-4문장 요약]

### 주요 레퍼런스

1. **[제목]** — 저자/출처, 연도. URL
   - 핵심: [한 줄 요약]
   - 활용: [발표 어디서 어떻게 사용할지]

2. ...

### [클럽명] 연결

> [이 항목이 대학생 멤버에게 어떤 의미인지 한 줄]

---

## {항목 2}

(동일 형식 반복)

---

## 활용 노트

발표자 참고용 — 슬라이드 제작 전 숙지 권장 항목:

- [ ] {항목명}: {구체적 활용 포인트}
- [ ] ...
```

### 6. plan.md 참고 자료 섹션 업데이트

`plan.md`의 `## 참고 자료` 섹션에 리서치 파일 링크를 추가한다 (Edit 사용):

```markdown
- `materials/YYMMDD-S{N}-발표재료-리서치.md` — 발표 재료 리서치 ({생성일})
```

이미 동일한 링크가 있으면 추가하지 않는다.

### 7. 출력

사용자에게 다음을 보고한다:

- 저장된 파일 경로
- 리서치 항목 목록 및 레퍼런스 수
- plan.md 업데이트 여부
- 다음 단계 제안: `slide-prep` 스킬 실행 안내

---

## 최소 완료 조건

| 조건 | 기준 |
|------|------|
| 리서치 항목 수 | 2~4개 |
| 총 레퍼런스 수 | 3개 이상 |
| 파일 저장 위치 | `materials/YYMMDD-S{N}-발표재료-리서치.md` |
| plan.md 참고 자료 | 리서치 파일 링크 추가됨 |

---

## 세션 수명주기 위치

```
session-ops setup (폴더·plan 생성)
  → plan.md 작성·확정 (@prep 에이전트)
  → session-research  ← 지금 여기
  → slide-prep (슬라이드 외주 준비)
  → session-launch (D-3 점검)
  → 세션 진행
  → session-record (종료 후)
```

---

## 관련 스킬

| 스킬 | 관계 |
|------|------|
| `session-ops setup` | 선행 — 폴더·plan.md 생성 |
| `reference-save` | 병행 가능 — 일반 레퍼런스를 `_system/reference/`에 저장 |
| `slide-prep` | 후행 — 이 스킬의 출력을 입력으로 사용 |

---

## 규칙

- 한국어 기본, 기술 용어·코드·인명·서비스명은 영어 유지
- 출처 URL은 반드시 포함 — 무출처 요약 금지
- 이미 `materials/`에 있는 파일과 중복된 내용은 새 파일에 포함하지 않고 링크로 연결
- `plan.md` 수정은 `## 참고 자료` 섹션 링크 추가에만 한정 — 발표 구조 변경 금지