vibe-project

# 🚀 Vibe Project Template

> **AI Agent와 함께하는 엔터프라이즈급 개발 환경 템플릿**

[![Use this template](https://img.shields.io/badge/Use%20this-template-2ea44f?style=for-the-badge)](https://github.com/<your-org>/<your-project>/generate)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge)](https://opensource.org/licenses/MIT)

[![CI](https://github.com/<your-org>/<your-project>/actions/workflows/ci.yml/badge.svg)](https://github.com/<your-org>/<your-project>/actions/workflows/ci.yml)
[![Security Scan](https://github.com/<your-org>/<your-project>/actions/workflows/security-scan.yml/badge.svg)](https://github.com/<your-org>/<your-project>/actions/workflows/security-scan.yml)

---

## 🎯 Vibe Coding이란?

**Vibe Coding**은 AI Agent(Cursor, Cursor, Cursor 등)와 협업하여 개발하는 새로운 방법론입니다.

```
개발자의 의도(Vibe) + AI의 구현력 = 생산성 극대화
```

이 템플릿은 Vibe Coding을 위한 **표준화된 환경**을 제공합니다:
- AI가 프로젝트를 이해할 수 있는 컨텍스트
- 일관된 코드 생성을 위한 규칙
- 검증된 프롬프트 템플릿
- 자동화된 품질 관리

---

## ✨ 주요 기능

### 🤖 AI Agent 지원
| Agent | 설정 파일 | 설명 |
|-------|----------|------|
| **Claude Code** | `CLAUDE.md` | Anthropic Claude CLI |
| **Cursor AI** | `.cursor/rules/*.mdc` | VS Code 기반 AI IDE |
| **Roo Code** | `.roo/rules/*.mdc` | AI 코딩 어시스턴트 |

### 📚 프롬프트 라이브러리
14개의 검증된 프롬프트 템플릿 제공:
- API 설계, 버그 수정, 코드 리뷰
- 리팩토링, 보안 검토, 성능 분석
- 테스트 생성, 마이그레이션, 문서화

### 🔧 개발 환경
- **VS Code 설정**: 확장, 스니펫, 디버그, 태스크
- **Git Hooks**: Conventional Commits 강제
- **Pre-commit**: 린트, 시크릿 스캔, 포맷팅
- **MCP 지원**: Model Context Protocol 설정

### 🔄 GitHub 자동화
- **CI/CD**: 빌드, 테스트, 배포 파이프라인
- **Cursor PR Review**: AI 코드 리뷰
- **Security Scan**: 보안 취약점 자동 검사
- **Issue Triage**: 이슈 자동 분류

### 📖 예제 프로젝트
| 예제 | 기술 스택 | 아키텍처 |
|------|----------|----------|
| TypeScript API | Express, Prisma, Jest | Clean Architecture |
| Python API | FastAPI, SQLAlchemy, Pytest | Clean Architecture |

---

## 🚀 시작하기

### 전제 조건

- Git 2.x+
- 선택적: Node.js 18+ / Python 3.11+
- 선택적: [Claude Code](https://claude.ai/code) / [Cursor](https://cursor.sh)

### 1