initiative-research

name	initiative-research
description	Initiative 주제에 대한 리서치를 수행하고 결과를 기록. Internal skill — called by initiative workflow during research phases.
context	main
allowed-tools	["Read","Write","Edit","Glob","Grep","WebSearch","WebFetch"]
argument-hint	<topic-slug> <type: internal|external|study>
spec-version	2

Initiative Research

Domain: initiative Version: 1.0.0

WHY

Initiative subtopic에 대한 리서치를 구조화하여 research/ 디렉토리에 기록한다. internal/external/study 유형별로 방법론을 분리하여 리서치 품질과 추적성을 보장한다.

Input

Required

• $ARGUMENTS: <topic-slug> <type>
• type: internal (코드 분석), external (외부 조사), study (학습)

Output

• research/{type}/{subtopic-id}-{topic}.md 파일 생성
• index.yml 해당 subtopic artifacts 업데이트

STEPS

Internal Research

1. research/internal/ 디렉토리 확인/생성
2. 분석 대상 코드 탐색 (Glob, Grep, Read)
3. 분석과 동시에 주요 발견 사항 기록 (완료 후가 아님)
4. research/internal/{id}-{topic}.md 작성
5. index.yml artifacts 업데이트

External Research

1. research/external/ 디렉토리 확인/생성
2. WebSearch, WebFetch로 관련 자료 조사
3. 비교 분석, 모범 사례 정리
4. research/external/{id}-{topic}.md 작성
5. index.yml artifacts 업데이트

Study

1. research/study/ 디렉토리 확인/생성
2. 개념 학습 및 프로젝트 적용 방안 도출
3. research/study/{id}-{topic}.md 작성
4. index.yml artifacts 업데이트

Templates

Internal Research

# Internal Research: {주제}

> **대상**: {분석 대상}
> **날짜**: {date}
> **관련 Subtopic**: {id}

## 분석 범위
## 주요 발견
## 코드 참조
## 시사점

External Research

# External Research: {주제}

> **날짜**: {date}
> **관련 Subtopic**: {id}

## 조사 내용
## 비교 분석
## 시사점

JUDGMENT

• type 미지정 시 → 사용자에게 internal/external/study 선택 요청
• 기존 research 파일과 주제가 겹치면 → 기존 파일 보강 또는 신규 생성 여부를 사용자에게 확인
• 리서치 중 Initiative 범위를 벗어나는 발견 시 → Catalyst 메모로 기록

AGENT DELEGATION

None — 메인 컨텍스트에서 직접 실행한다. WebSearch/WebFetch를 도구로 사용하지만 에이전트 위임은 없다.

KNOWLEDGE REFS

참조	역할	로드 시점
workspace/squads/initiative/knowledge/lifecycle.md	Initiative stage/subtopic 구조	Input validation
workspace/squads/initiative/policies/subtopic-document-standard.md	리서치 문서 표준	리서치 파일 작성 시
workspace/initiatives/README.md	Initiative 디렉토리 구조	Input validation

Error Handling

Error	Cause	Solution
Initiative 미존재	잘못된 slug	active/ 내 목록 표시
타입 오류	유효하지 않은 type	internal/external/study 안내