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 파일에 작성해줘.

5.1 KiB Raw Blame History