<!-- 사용 방법 (워크플로우) -->

# Manual Usage & Prompt Guide

이 문서는 **자동 워크플로우(`workflow.md`)를 사용하지 않거나**, 특정 단계만 **수동으로 실행/재실행**해야 할 때 사용하는 프롬프트 모음집입니다. 상황에 맞는 프롬프트를 선택하여 AI에게 복사-붙여넣기 하세요.

---

## 1. 프로젝트 시작 및 초기화 (Initialization)

**상황:** 새로운 세션을 시작하거나, AI가 프로젝트 문맥을 잊어버렸을 때 사용합니다.

### 📂 Step 1: 문맥 주입 (Context Loading)
> "첨부된 `copilot-instructions.md`, `project_requirements.md`, `implementation_plan.md`를 모두 읽고, 이 프로젝트의 목표와 내가 구축하려는 시스템의 아키텍처를 요약해주세요. 그리고 `implementation_plan.md`의 단계들이 적절한지 검토해주세요."

### 🔍 Step 2: 계획 검증 (Plan Validation)
> "`implementation_plan.md`의 내용이 충분히 구체적인가? 만약 부족한 부분이 있다면 Python/C++ 프로젝트 표준에 맞춰서 수정해주세요. (수정이 없다면 이 단계는 생략)"

---

## 2. 단계별 실행 프롬프트 (Phase Execution)

**상황:** `implementation_plan.md`의 특정 단계를 실행할 때 사용합니다. (원하는 단계만 골라서 사용 가능)

### 🚀 Phase 1: 환경 설정 (Setup)
> "`implementation_plan.md`의 **[Phase 1]** 작업을 시작한다.
> `copilot-instructions.md`의 **Tech Stack**에 맞춰 폴더 구조를 잡고, 필요한 설정 파일(.env, requirements.txt, CMakeLists.txt 등)을 작성해줘.
> 작성 후에는 `implementation_plan.md`의 해당 항목을 체크(x)해주세요."

### 🧩 Phase 2: 코어 로직 구현 (Core Domain)
> "`implementation_plan.md`의 **[Phase 2]** 작업을 수행한다.
> `copilot-instructions.md`의 **Core Principles**를 준수하여 비즈니스 로직과 도메인 모델을 구현해주세요.
> **중요:** 코드를 작성하기 전에 **로직 설계와 시간 복잡도**를 먼저 설명하고, 반드시 **단위 테스트(Unit Test)** 코드를 함께 작성해주세요."

### 🔌 Phase 3: 인터페이스 연동 (Integration)
> "`implementation_plan.md`의 **[Phase 3]** 작업을 수행한다.
> 외부 API 연동, DB 연결, 또는 UI 컴포넌트를 구현해주세요.
> **Error Handling:** 예외 상황(네트워크 실패, DB 연결 끊김 등)에 대한 처리를 `try-except`(Python) 또는 `RAII/Exception Safety`(C++) 규칙에 맞춰 견고하게 작성해주세요."

### 🖥️ Phase 4: 시스템 통합 (System Interface)
> "`implementation_plan.md`의 **[Phase 4]** 작업을 수행한다.
> 전체 모듈을 하나로 묶는 메인 진입점(Main Entry Point)을 작성하고, 전체 프로세스가 유기적으로 동작하는지 검증하는 **통합 테스트(Integration Test)** 시나리오를 작성해주세요."

### ⚡ Phase 5: 최적화 및 리팩토링 (Refinement)
> "`implementation_plan.md`의 **[Phase 5]** 작업을 수행한다.
> 현재 코드에서 **성능 병목(O(N^2) 이상)**이 발생할 수 있는 구간이나 **메모리 누수** 가능성을 분석해주세요.
> 그 후, `review_prompt.md`의 기준에 따라 스스로 코드를 리뷰하고 개선안을 적용해주세요."

---

## 3. 자동 진행 및 복구 (Auto-Pilot & Recovery)

**상황:** 다음 할 일을 AI가 스스로 찾게 하거나, 꼬인 상황을 풀 때 사용합니다.

### 🤖 Auto-Pilot (알아서 다음 단계 진행)
> "`implementation_plan.md`를 확인해서 **아직 완료되지 않은(체크되지 않은) 가장 첫 번째 작업**을 수행해주세요.
> `copilot-instructions.md`의 규칙을 철저히 지켜서 코드를 작성하고, 작업이 끝나면 플랜 파일을 업데이트해주세요."

### 🚑 Troubleshooting (품질/방향성 교정)

**Q. AI가 엉뚱하거나 질 낮은 코드를 작성할 때**
> "방금 작성한 코드를 멈추고, `review_prompt.md`를 기준으로 다시 리뷰해주세요. 치명적인 결함이나 개선할 점을 찾아서 보고하고 코드를 수정해주세요."

**Q. 진행 상황(체크박스)이 실제와 다를 때**
*(사용자가 파일을 직접 수정한 뒤 명령)*
> "`implementation_plan.md` 파일을 다시 읽어봐. 내가 현재 진행 상황을 업데이트했으니, 체크되지 않은 항목부터 다시 작업을 이어가주세요."


copilot-instructions.md 지침을 따라서 작업해주세요.
project_requirements.md 파일에 작성된 템플릿에 맞춰 프로그램 요구사항을 작성한 후
implementation_plan.md 파일에 작성된 템플릿에 맞춰 작업계획을 작성해주세요.
프로그램 요구사항과 작업계획을 작성하기전에 필요한 데이터가 부족하면 나한테 물어보고 데이터 준비가 완료되면 작성해주세요.
프로그램에 요구되는 기능은 다음과 같습니다.

xxx

더 필요한 내용이 있다면 물어봐주세요.

workflow.md 지침에 따라 작업을 진행해주세요.

review_prompt.md 지침에 따라 코드를 검토해주세요.

이 프로그램을 사용하는 방법을 user_guide.md 파일에 작성해줘.