# PROJECT_PLAN.md 기반 작업 규칙
## 🚨 핵심 원칙
**모든 작업은 반드시 `.cursor/PROJECT_PLAN.md` 파일을 기반으로 시작해야 합니다.**
## 📋 작업 시작 전 필수 확인사항
### 1. PROJECT_PLAN.md 파일 읽기
- 현재 상태 파악 (섹션 2)
- 우선순위 로드맵 확인 (섹션 3)
- 세부 체크리스트 검토 (섹션 4)
- 백로그 아이디어 검토 (섹션 5)
### 2. 작업 우선순위 결정
- **P0**: 바로 착수해야 할 핵심 작업
- **P1**: 안정화/테스트 관련 작업
- **P2**: 기능 확장 관련 작업
### 3. 체크리스트 항목 확인
- 해당 작업이 어떤 체크리스트에 속하는지 파악
- 현재 완료 상태 확인 (`- [ ]` vs `- [x]`)
## 🔄 작업 진행 규칙
### 체크리스트 관리
- 완료한 항목은 `- [ ]` → `- [x]` 로 변경
- 새 이슈/아이디어는 **수집함**에 추가
- 변경 시 **변경 로그** 섹션에 1줄 기록
### 문서화 규칙
- 트러블슈팅은 `docs/troubleshooting/YYYYMMDD_title.md` 로 기록
- 본문에 링크를 남기고 PROJECT_PLAN.md에 반영
- README와 관련 문서 동기화 유지
## 💡 Cursor 사용 지시 예시
### 체크리스트 업데이트
```
"PROJECT_PLAN.md의 P0 체크리스트 중 '데코레이터 기반 서버 진입점 정리' 항목을 완료로 체크하고, 변경 로그에 한 줄 추가해."
```
### 새 아이디어 추가
```
"수집함에 'PR 라벨링 자동화 툴' 아이디어를 추가해."
```
### 설정 수정
```
"테스트 섹션의 커버리지 목표를 85%→90%로 수정해."
```
### 백로그 관리
```
"백로그에 'codecov 연동' 추가."
```
### 트러블슈팅 문서화
```
"docs/troubleshooting에 '20250904_cursor_extension_conflict.md' 파일을 만들고, 재현/원인/해결/후속조치 섹션을 추가."
```
## 📚 관련 문서 참조
- **메인 계획**: `.cursor/PROJECT_PLAN.md`
- **MCP 도구 패턴**: `docs/MCP_TOOL_PATTERNS.md`
- **트러블슈팅 가이드**: `docs/troubleshooting/`
- **테스트 가이드**: `docs/testing_guide.md`
## ⚠️ 주의사항
- PROJECT_PLAN.md를 읽지 않고 작업을 시작하지 마세요
- 우선순위를 무시하고 작업하지 마세요
- 체크리스트 업데이트를 잊지 마세요
- 변경 로그 기록을 누락하지 마세요
## 🔍 빠른 참조
- **현재 상태**: 섹션 2
- **우선순위**: 섹션 3 (P0, P1, P2)
- **체크리스트**: 섹션 4
- **백로그**: 섹션 5
- **완료 기록**: 섹션 6
- **변경 로그**: 섹션 7
