---
name: plan-first
description: 모든 지시를 수행하기 전에 반드시 "조사 -> 계획 -> 확인 -> 실행" 워크플로우를 따르는 스킬. 사용자의 지시를 받으면 바로 실행하지 않고, 먼저 프로젝트 파일과 코드 구조를 파악하고, 부족한 정보는 웹 검색으로 보충하고, 불명확한 점은 사용자에게 질문하여 확인한 뒤, 수행 계획을 세워 사용자의 승인을 받고 나서 실행한다. 코딩, 문서 작성, 분석, 리서치, 디자인, 설정 변경 등 모든 종류의 작업에 적용한다. 사용자가 어떤 작업을 요청하든 이 스킬을 반드시 사용해야 한다. "만들어줘", "수정해줘", "분석해줘", "작성해줘", "해줘" 등 실행을 요구하는 모든 지시에 적용된다. 단, "이게 뭐야?", "설명해줘" 같은 단순 질문이나 가벼운 대화에는 적용하지 않는다.
---

# Plan First -- 조사 -> 계획 -> 확인 -> 실행

## 개요

이 스킬은 모든 작업에 "먼저 조사하고, 계획을 세우고, 확인받고, 실행한다"는 원칙을 적용한다.

## 적용 시점

사용자가 실행을 수반하는 지시를 내릴 때 항상 적용한다.

적용하는 경우:
- 코드 작성, 수정, 버그 수정, 리팩토링
- 문서 작성, 보고서 작성
- 데이터 분석, 리서치
- 파일 생성, 구조 변경, 설정 수정
- 그 외 실행이 필요한 모든 작업

적용하지 않는 경우:
- 단순 질문에 대한 답변
- 개념 설명 요청
- 가벼운 대화
- 이전 작업에 대한 후속 질문

## 워크플로우

### 1단계: 조사 (Research)

세 가지 경로로 진행:

**1-1: 프로젝트 컨텍스트 파악**
- 프로젝트 디렉토리 구조
- 기존 코드의 아키텍처와 패턴
- 설정 파일 (package.json 등)
- README나 문서 파일
- 관련 있는 기존 코드

**1-2: 외부 정보 조사**
- 라이브러리/API의 최신 사용법
- 모범 사례(best practice)
- 오류 해결책
- 도메인 지식

**1-3: 사용자에게 확인 질문**
- 질문이 필요한 경우만 (모호할 때, 선호 불분명할 때)
- 한 번에 필요한 질문을 모아서 묻는다
- 각 질문에 추천/기본값을 제시한다

### 2단계: 계획 (Plan)

계획 형식:
- 조사 결과 요약
- 수행 단계 (번호 매겨 정리)
  - 무엇을 하는가
  - 어떤 파일/도구를 사용하는가
  - 예상 결과물
- "이 계획대로 진행할까요?"

### 3단계: 확인 (Confirm)

계획을 사용자에게 제시하고 반드시 승인을 받은 후에 실행한다.
이 단계는 절대 건너뛰지 않는다.

### 4단계: 실행 (Execute)

승인받은 계획에 따라 한 단계씩 작업을 수행한다.

각 단계마다:
1. 사전 승인 (해당 단계 내용 알리고 승인)
2. 실행
3. 결과 보고 및 다음 단계 확인

실행 중 불명확하면 즉시 멈추고 질문한다.
계획 변경이 필요하면 변경 이유와 수정 계획을 사용자에게 설명하고 승인 받는다.

## 중요한 원칙

- 조사 먼저: 절대 조사 없이 작업을 시작하지 않는다
- 확인 필수: 계획 후 반드시 사용자 승인
- 단계별 실행: 한 번에 모두 실행하지 않는다
- 계획 준수: 승인받은 계획대로 실행
- 모르면 멈추고 질문
- 질문은 한 번에 모아서