# 리서치-구현 분리 원칙 (Research-Implementation Separation)

> 제이회장님 지시 (2026-03-27): 2팀 task-1106.1 사고 기반. 1시간 작업 후 산출물 0건.
> 원인: 리서치(카카오 인증 조사)와 구현(TistoryPublisher 코딩)을 한 세션에 몰아넣어 리서치 블랙홀에 빠짐.

---

## 핵심 원칙

**리서치와 구현은 반드시 별도 Phase(또는 별도 디스패치)로 분리한다.**

---

## 판별 기준: 리서치 vs 구현

### 리서치 작업 (task_type=research)
- 외부 API/서비스 현재 상태 조사
- 인증 방식, 약관, 제한사항 파악
- HTML/DOM 구조 분석, 셀렉터 특정
- 기존 도구/라이브러리 조사 및 비교
- 실현 가능성(feasibility) 판단
- **산출물**: 스펙 문서 (`memory/specs/xxx.md`)

### 구현 작업 (task_type=coding)
- 리서치 결과를 기반으로 코드 작성
- 테스트 작성 및 실행
- 파이프라인 연결
- **전제조건**: 리서치 스펙 문서 완료
- **산출물**: 코드 파일 + 테스트 + 보고서

---

## 아누 지시서 작성 규칙

### 1. 리서치가 필요한 작업인지 판별

아래 키워드가 지시서에 포함되면 **리서치 Phase 필수**:
- "조사", "리서치", "파악", "확인", "현재 상태"
- "가능한지", "방법", "우회", "대안"
- "API 문서", "HTML 구조", "셀렉터"
- "외부 서비스", "인증 방식", "2FA/OTP"

### 2. Phase 분리 작성법

**BAD (한 세션에 몰아넣기):**
```
## 1. 카카오 로그인 자동화 리서치  ← 리서치
## 2. TistoryPublisher 구현       ← 구현
## 3. 파이프라인 연결              ← 구현
## 4. 테스트                      ← 구현
```

**GOOD (Phase 분리):**
```
# Phase 1: 리서치 (task_type=research)
## 1. 카카오 인증 방식 조사
## 2. 티스토리 API 현황 확인
→ 산출물: memory/specs/tistory-auth-research.md

# Phase 2: 구현 (task_type=coding) — Phase 1 완료 후
## 1. TistoryPublisher 구현 (리서치 스펙 기반)
## 2. 파이프라인 연결
## 3. 테스트
→ 전제: Phase 1 스펙 참조
```

### 3. 디스패치 명령어 차이

리서치:
```bash
python3 dispatch.py --team <team> --task-file <path> --level normal --task-type research
```

구현:
```bash
python3 dispatch.py --team <team> --task-file <path> --level normal
```

---

## 시간 제한 가이드라인

- **리서치 Phase**: 보통 15~30분. 1시간 넘어가면 이상 신호.
- **구현 Phase**: 작업 규모에 따라 다름. 단, 리서치가 충분하면 구현은 빠름.
- **리서치 블랙홀 방지**: 리서치 지시서에 "최대 조사 시간 30분" 또는 "5개 소스 이상이면 정리" 같은 가드레일 명시.

---

## 사고 사례

### task-1106.1 (2팀, 2026-03-27)
- **상황**: 티스토리 자동발행 PoC. 리서치+구현 한 세션에 투입.
- **결과**: 1시간 13분 작업, 산출물 0건. 제이회장님 강제종료.
- **원인**: 카카오 2FA/OAuth 리서치에서 빠져나오지 못함.
- **대조**: 같은 지시서를 1팀에 재배분 → 14분 만에 전체 완료.

### 교훈
- 1팀이 빨랐던 이유: 리서치와 구현을 병렬 팀원에게 분배 (불칸=리서치, 이리스=구현).
- 하지만 이는 팀장 역량 차이지, 구조적 해결이 아님.
- **구조적 해결**: 아누가 지시서 단계에서 Phase를 분리하면 어떤 팀이든 블랙홀 위험 감소.

---

**버전**: v1.0
**작성일**: 2026-03-27
**지시자**: 제이회장님
**작성자**: 아누 (개발실장)