session-research

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}-* 폴더를 찾는다.

# 세션 폴더 탐지 (세션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/

---
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
---

파일 구조:

# 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 사용):

- `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 수정은 ## 참고 자료 섹션 링크 추가에만 한정 — 발표 구조 변경 금지