바이브 코딩 규칙 세트 템플릿 생성기

팀과 프로젝트에 적용할 수 있는 바이브 코딩 규칙 세트 템플릿을 생성하고 커스터마이징하세요.

코딩 규칙 템플릿 편집기

# 바이브 코딩 규칙 세트

## 코드 스타일 규칙
**변수명 및 함수명**
 - 직관적이고 명확한 이름
 - 변수명: 명사형, 상태를 나타내는 경우 is, has, can 접두사 사용
 - 함수명: 동사로 시작, 반환값이 boolean인 경우 is, has, can 접두사
 - 상수: UPPER_SNAKE_CASE로 작성
 - 약어 사용 금지 (URL, API 등 널리 알려진 것 제외)

**개발규칙 및 코드품질**
 - 한 함수는 하나의 책임만 가져야 함
 - 15줄을 넘지 않도록 작성 (복잡한 로직은 분리)
 - 순수 함수를 우선적으로 작성
 - 중첩 깊이는 3단계를 초과하지 않음

**주석 작성**
 - 코드가 '무엇을' 하는지보다 '왜' 하는지를 설명
 - 복잡한 비즈니스 로직에 설명 주석
 - API 엔드포인트별로 간단한 설명 추가
 - TODO, FIXME, HACK 태그 적극 활용

## 테스트 가이드라인
**테스트 우선순위**
 - 핵심 비즈니스 로직 - 반드시 테스트
 - 사용자 인터랙션 - 중요한 플로우만
 - 유틸리티 함수 - 복잡한 로직만
 - UI 컴포넌트 - 조건부 렌더링 위주

**테스트 작성 기준**
 - 테스트 커버리지 목표: 80% 이상 (핵심 로직 100%)
 - Given-When-Then 패턴 준수
 - Mock은 외부 의존성에만 사용

## 보안 및 에러 처리
**보안 체크리스트**
 - 민감한 정보 환경변수로 관리
 - 프론트엔드와 백엔드 모두에서 검증
 - 사용자 친화적인 에러 메시지
 - XSS, CSRF, SQL 인젝션 방지 등 기본적인 보안 고려사항 준수

## 반응형 및 접근성
**접근성 기본 원칙**
 - 의미있는 HTML 시맨틱 태그 사용
 - 적절한 ARIA 레이블 제공
 - 키보드 네비게이션 지원
 - 색상에만 의존하지 않는 정보 전달

## 배포 및 모니터링
**로깅 및 모니터링**
 - 개발환경: 상세한 로그
 - 프로덕션: 에러 및 중요 이벤트만
 - 사용자 개인정보는 절대 로깅하지 않음

## 문서화 원칙
**README 필수 항목**
 - 프로젝트 설명 및 목적
 - 설치 및 실행 방법
 - 주요 기능 소개
 - API 문서 (있는 경우)

**코드 문서화**
 - 복잡한 비즈니스 로직에 대한 설명
 - API 인터페이스 명세

## 리팩토링 가이드
**리팩토링 신호**
 - 같은 코드가 3번 이상 반복될 때
 - 함수가 20줄을 넘을 때
 - 조건문이 3단계 이상 중첩될 때
 - 변수명이나 함수명이 불명확할 때

**리팩토링 원칙**
 - 작은 단위로 점진적 개선
 - 테스트 코드 먼저 작성
 - 기능 변경과 리팩토링 분리
 - 팀원과의 충분한 소통

## Git 커밋 규칙
**커밋 메시지 컨벤션**
 - feat: 새로운 기능 추가
 - fix: 버그 수정
 - docs: 문서 변경
 - style: 코드 스타일 변경 (기능 변경 없음)
 - refactor: 코드 리팩토링
 - test: 테스트 코드 추가/수정
 - chore: 빌드 과정이나 보조 도구 변경

바이브 코딩 규칙 템플릿

위 템플릿을 편집하여 팀과 프로젝트에 맞는 코딩 규칙을 만들어보세요. 복사, 다운로드, 리셋 기능을 활용할 수 있습니다.

바이브 코딩이란?

바이브 코딩(Vibe Coding)은 개발팀의 분위기와 철학을 반영한 코딩 스타일과 개발 문화를 의미합니다. 단순한 문법 규칙을 넘어서, 팀의 가치관과 개발 철학이 녹아있는 종합적인 개발 지침입니다.

좋은 바이브 코딩 규칙은 팀원들이 일관된 스타일로 코드를 작성할 수 있게 도와주며, 코드 리뷰 시간을 단축시키고, 새로운 팀원의 온보딩을 수월하게 만들어줍니다.

코드 품질 향상 가이드

일관성: 모든 팀원이 동일한 스타일로 코드를 작성하여 가독성을 높입니다.
명확성: 변수명과 함수명에서 의도를 명확히 드러내어 코드 이해도를 향상시킵니다.
단순성: 복잡한 로직을 작은 단위로 분리하여 유지보수성을 높입니다.
테스트 가능성: 테스트하기 쉬운 구조로 코드를 작성하여 안정성을 보장합니다.

사용 방법

템플릿 편집: 제공된 기본 템플릿을 팀의 필요에 맞게 수정하세요.
팀 논의: 팀원들과 함께 규칙을 검토하고 합의점을 찾아보세요.
저장 및 공유: 완성된 규칙을 복사하거나 마크다운 파일로 다운로드하여 팀과 공유하세요.
지속적 개선: 프로젝트 진행 중 필요에 따라 규칙을 업데이트하세요.

바이브 코딩의 장점

개발 효율성 향상: 일관된 코딩 스타일로 코드 리뷰 시간을 단축합니다.
팀 협업 강화: 공통된 개발 철학으로 팀의 결속력을 높입니다.
코드 품질 보장: 체계적인 규칙으로 버그를 줄이고 유지보수성을 높입니다.
신규 개발자 온보딩: 명확한 가이드라인으로 새로운 팀원의 적응을 돕습니다.

주요 기능

실시간 편집: 템플릿을 실시간으로 수정하고 미리보기할 수 있습니다.
원클릭 복사: 완성된 규칙을 클립보드에 쉽게 복사할 수 있습니다.
마크다운 다운로드: .md 파일로 다운로드하여 저장하고 공유할 수 있습니다.
템플릿 리셋: 언제든지 기본 템플릿으로 되돌릴 수 있습니다.
커스터마이징: 팀의 특성에 맞게 자유롭게 수정할 수 있습니다.