{"id":43562652,"url":"https://github.com/jhl-labs/vibe-project","last_synced_at":"2026-02-03T21:09:49.365Z","repository":{"id":335352269,"uuid":"1143918530","full_name":"jhl-labs/vibe-project","owner":"jhl-labs","description":"AI Agent(Claude, Cursor, Roo Code)와 함께하는 엔터프라이즈급 Vibe Coding 프로젝트 템플릿","archived":false,"fork":false,"pushed_at":"2026-01-29T19:46:16.000Z","size":214,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-30T08:00:33.477Z","etag":null,"topics":["ai-agent","claude","clean-architecture","cursor","developer-tools","enterprise","github-template","project-template","vibe-coding"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jhl-labs.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":null},"created_at":"2026-01-28T05:05:12.000Z","updated_at":"2026-01-29T20:18:23.000Z","dependencies_parsed_at":"2026-01-30T08:00:58.168Z","dependency_job_id":null,"html_url":"https://github.com/jhl-labs/vibe-project","commit_stats":null,"previous_names":["jhl-labs/vibe-project"],"tags_count":1,"template":true,"template_full_name":null,"purl":"pkg:github/jhl-labs/vibe-project","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jhl-labs%2Fvibe-project","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jhl-labs%2Fvibe-project/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jhl-labs%2Fvibe-project/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jhl-labs%2Fvibe-project/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jhl-labs","download_url":"https://codeload.github.com/jhl-labs/vibe-project/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jhl-labs%2Fvibe-project/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29057186,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-03T20:13:53.544Z","status":"ssl_error","status_checked_at":"2026-02-03T20:13:40.507Z","response_time":96,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agent","claude","clean-architecture","cursor","developer-tools","enterprise","github-template","project-template","vibe-coding"],"created_at":"2026-02-03T21:09:48.575Z","updated_at":"2026-02-03T21:09:49.346Z","avatar_url":"https://github.com/jhl-labs.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚀 Vibe Project Template\n\n\u003e **AI Agent와 함께하는 엔터프라이즈급 개발 환경 템플릿**\n\n[![Use this template](https://img.shields.io/badge/Use%20this-template-2ea44f?style=for-the-badge)](https://github.com/\u003cyour-org\u003e/\u003cyour-project\u003e/generate)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge)](https://opensource.org/licenses/MIT)\n\n[![CI](https://github.com/\u003cyour-org\u003e/\u003cyour-project\u003e/actions/workflows/ci.yml/badge.svg)](https://github.com/\u003cyour-org\u003e/\u003cyour-project\u003e/actions/workflows/ci.yml)\n[![Security Scan](https://github.com/\u003cyour-org\u003e/\u003cyour-project\u003e/actions/workflows/security-scan.yml/badge.svg)](https://github.com/\u003cyour-org\u003e/\u003cyour-project\u003e/actions/workflows/security-scan.yml)\n\n---\n\n## 🎯 Vibe Coding이란?\n\n**Vibe Coding**은 AI Agent(Claude, Cursor, Copilot 등)와 협업하여 개발하는 새로운 방법론입니다.\n\n```\n개발자의 의도(Vibe) + AI의 구현력 = 생산성 극대화\n```\n\n이 템플릿은 Vibe Coding을 위한 **표준화된 환경**을 제공합니다:\n- AI가 프로젝트를 이해할 수 있는 컨텍스트\n- 일관된 코드 생성을 위한 규칙\n- 검증된 프롬프트 템플릿\n- 자동화된 품질 관리\n\n---\n\n## ✨ 주요 기능\n\n### 🤖 AI Agent 지원\n| Agent | 설정 파일 | 설명 |\n|-------|----------|------|\n| **Claude Code** | `CLAUDE.md` | Anthropic Claude CLI |\n| **Cursor AI** | `.cursor/rules/*.mdc` | VS Code 기반 AI IDE |\n| **Roo Code** | `.roo/rules/*.mdc` | AI 코딩 어시스턴트 |\n\n### 📚 프롬프트 라이브러리\n14개의 검증된 프롬프트 템플릿 제공:\n- API 설계, 버그 수정, 코드 리뷰\n- 리팩토링, 보안 검토, 성능 분석\n- 테스트 생성, 마이그레이션, 문서화\n\n### 🔧 개발 환경\n- **VS Code 설정**: 확장, 스니펫, 디버그, 태스크\n- **Git Hooks**: Conventional Commits 강제\n- **Pre-commit**: 린트, 시크릿 스캔, 포맷팅\n- **MCP 지원**: Model Context Protocol 설정\n\n### 🔄 GitHub 자동화\n- **CI/CD**: 빌드, 테스트, 배포 파이프라인\n- **Claude PR Review**: AI 코드 리뷰\n- **Security Scan**: 보안 취약점 자동 검사\n- **Issue Triage**: 이슈 자동 분류\n\n### 📖 예제 프로젝트\n| 예제 | 기술 스택 | 아키텍처 |\n|------|----------|----------|\n| TypeScript API | Express, Prisma, Jest | Clean Architecture |\n| Python API | FastAPI, SQLAlchemy, Pytest | Clean Architecture |\n\n---\n\n## 🚀 시작하기\n\n### 전제 조건\n\n- Git 2.x+\n- 선택적: Node.js 18+ / Python 3.11+\n- 선택적: [Claude Code](https://claude.ai/code) / [Cursor](https://cursor.sh)\n\n### 1단계: 템플릿으로 저장소 생성\n\n**방법 A: GitHub UI**\n1. 이 페이지 상단의 **\"Use this template\"** 버튼 클릭\n2. 새 저장소 이름 입력\n3. **\"Create repository\"** 클릭\n\n**방법 B: GitHub CLI**\n```bash\ngh repo create my-project --template \u003cyour-org\u003e/vibe-project-template --clone\ncd my-project\n```\n\n### 2단계: 프로젝트 초기화\n\n```bash\n# 초기화 스크립트 실행\n./scripts/init-project.sh\n```\n\n대화형 설정:\n1. 프로젝트 정보 입력 (이름, 조직, 설명)\n2. AI Agent 선택 (Claude, Cursor, Roo)\n3. 예제 프로젝트 선택 (선택적)\n4. MCP 설정 (선택적)\n\n### 3단계: AI와 개발 시작\n\n```bash\n# Claude Code 사용\nclaude\n\n# Cursor 사용\ncursor .\n\n# VS Code 사용\ncode .\n```\n\n---\n\n## 📁 프로젝트 구조\n\n```\nvibe-project-template/\n│\n├── 🤖 AI Agent 설정\n│   ├── CLAUDE.md                 # Claude Code 지시사항\n│   ├── .cursor/rules/*.mdc       # Cursor AI 규칙 (신규 형식)\n│   ├── .cursorrules              # Cursor AI 규칙 (레거시)\n│   ├── .roo/rules/*.mdc          # Roo Code 규칙\n│   └── .mcp.json.example         # MCP 설정 템플릿\n│\n├── 📂 .agent/                    # AI 컨텍스트\n│   ├── context.md                # 프로젝트 컨텍스트\n│   ├── conventions.md            # 코딩 컨벤션\n│   ├── architecture.md           # 아키텍처 설명\n│   ├── prompts/                  # 프롬프트 라이브러리 (14개)\n│   ├── skills/                   # Agent 스킬 정의\n│   └── subagents/                # 전문 서브에이전트\n│\n├── 📂 .github/                   # GitHub 설정\n│   ├── workflows/                # CI/CD 파이프라인 (12개)\n│   ├── ISSUE_TEMPLATE/           # 이슈 템플릿\n│   └── PULL_REQUEST_TEMPLATE.md\n│\n├── 📂 .vscode/                   # VS Code 설정\n│   ├── extensions.json           # 권장 확장\n│   ├── settings.json             # 에디터 설정\n│   ├── launch.json               # 디버그 구성\n│   ├── tasks.json                # 빌드 태스크\n│   └── snippets.code-snippets    # 코드 스니펫\n│\n├── 📂 docs/                      # 문서\n│   ├── adr/                      # Architecture Decision Records\n│   ├── api/                      # API 문서\n│   └── guides/                   # 가이드 (8개)\n│\n├── 📂 examples/                  # 예제 프로젝트\n│   ├── typescript-api/           # Express + Prisma\n│   └── python-api/               # FastAPI + SQLAlchemy\n│\n├── 📂 scripts/                   # 유틸리티\n│   └── init-project.sh           # 프로젝트 초기화\n│\n└── 📂 .husky/                    # Git Hooks\n    ├── pre-commit                # 커밋 전 검사\n    └── commit-msg                # 커밋 메시지 검증\n```\n\n---\n\n## 📖 문서\n\n### 가이드\n| 문서 | 설명 |\n|------|------|\n| [시작 가이드](docs/guides/getting-started.md) | 첫 번째 단계 |\n| [개발 가이드](docs/guides/development.md) | 개발 워크플로우 |\n| [AI Agent 가이드](docs/guides/ai-agent-usage.md) | AI 활용법 |\n| [커스터마이징](docs/guides/customization.md) | 템플릿 수정 |\n| [MCP 설정](docs/guides/mcp-setup.md) | MCP 구성 |\n| [효과 측정](docs/guides/effectiveness-measurement.md) | KPI 및 측정 |\n| [GitHub 설정](docs/guides/github-setup-checklist.md) | 저장소 설정 |\n| [FAQ](docs/guides/faq.md) | 자주 묻는 질문 |\n\n### 기타\n| 문서 | 설명 |\n|------|------|\n| [기여 가이드](CONTRIBUTING.md) | 프로젝트 기여 방법 |\n| [보안 정책](SECURITY.md) | 취약점 보고 |\n| [변경 이력](CHANGELOG.md) | 버전별 변경사항 |\n\n---\n\n## 🎨 프롬프트 라이브러리\n\n`.agent/prompts/` 디렉토리에서 검증된 프롬프트를 찾아보세요:\n\n```bash\n# 사용 예시 (Claude Code)\n@.agent/prompts/bug-fix.md 를 참고해서 이 버그를 수정해줘\n```\n\n| 프롬프트 | 용도 |\n|----------|------|\n| `api-design.md` | REST API 설계 |\n| `bug-fix.md` | 버그 분석 및 수정 |\n| `code-review.md` | 코드 리뷰 |\n| `feature-implement.md` | 기능 구현 |\n| `refactor.md` | 코드 리팩토링 |\n| `security-review.md` | 보안 검토 |\n| `test-generation.md` | 테스트 작성 |\n| `migration.md` | 마이그레이션 |\n| [전체 목록](.agent/prompts/README.md) | 14개 프롬프트 |\n\n---\n\n## 🔧 커스터마이징\n\n### AI Agent 규칙 수정\n\n```bash\n# Claude Code\nvim CLAUDE.md\n\n# Cursor AI (.cursor/rules/*.mdc - 신규 형식 권장)\nvim .cursor/rules/general.mdc\n\n# Roo Code\nvim .roo/rules/general.mdc\n```\n\n### 프로젝트 컨텍스트 수정\n\n```bash\n# 프로젝트 설명\nvim .agent/context.md\n\n# 코딩 컨벤션\nvim .agent/conventions.md\n\n# 아키텍처\nvim .agent/architecture.md\n```\n\n### 워크플로우 활성화/비활성화\n\n```bash\n# .github/workflows/ 에서 필요한 워크플로우만 유지\n# 불필요한 워크플로우는 삭제 또는 이름에 .disabled 추가\n```\n\n---\n\n## 🤝 기여하기\n\n기여를 환영합니다! [CONTRIBUTING.md](CONTRIBUTING.md)를 참조하세요.\n\n1. Fork\n2. Feature branch (`git checkout -b feature/amazing`)\n3. Commit (`git commit -m 'feat: Add amazing feature'`)\n4. Push (`git push origin feature/amazing`)\n5. Pull Request\n\n---\n\n## 📄 라이선스\n\n이 프로젝트는 [MIT 라이선스](LICENSE)를 따릅니다.\n\n---\n\n## 💡 Vibe Coding 팁\n\n\u003e \"AI에게 **무엇을** 원하는지 명확히 전달하세요. **어떻게** 할지는 AI가 알아서 합니다.\"\n\n1. **컨텍스트 제공**: `.agent/context.md`를 최신 상태로 유지\n2. **작은 단위로 요청**: 한 번에 하나의 작업만 요청\n3. **프롬프트 활용**: 검증된 프롬프트 템플릿 사용\n4. **결과 검토**: AI 출력물은 항상 검토 후 적용\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eMade with 💜 for Vibe Coding\u003c/strong\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjhl-labs%2Fvibe-project","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjhl-labs%2Fvibe-project","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjhl-labs%2Fvibe-project/lists"}