---
description: 현재 변경사항을 커밋 컨벤션에 맞는 메시지로 정리한다.
---

> `/commit` 프론트엔드 엔트리에서 사용하는 커밋 메시지 규칙이다.

현재 변경사항을 분석하고 커밋 컨벤션에 맞는 한 줄 커밋 메시지를 작성한다.

## 작업 절차

1. 프롬프트에 제공된 변경 파일 목록과 diff 참조를 확인한다.
2. 신규 파일이 있으면 diff 참조와 실제 워크스페이스 파일 내용을 함께 확인한다.
3. 변경 내용을 분석해 아래 컨벤션에 맞는 커밋 메시지를 작성한다.
4. 스테이징과 커밋 실행은 `/commit` 명령 실행 흐름에 맡긴다.

## 커밋 컨벤션

```
<타입>[범위(선택)]: <설명> [(SR 번호, 선택)]
```

### 타입

| 타입 | 설명 |
|------|------|
| `feat` | 새 기능 추가 |
| `fix` | 버그 수정 |
| `refactor` | 기능 변경 없는 코드 개선 |
| `chore` | 빌드·설정·의존성 변경 |
| `docs` | 문서 수정 |
| `perf` | 성능 개선 |
| `test` | 테스트 추가·수정 |
| `style` | 포맷·공백 등 스타일 변경 |

### 예시

```bash
git commit -m "feat(태블릿): 전자청약 대면동의서 기능 추가"
git commit -m "fix: (SR-12345) 딜 목록 필터 초기화 버그 수정"
git commit -m "feat!: API 응답 구조 변경 (breaking change)"
```

## 규칙

- 설명은 한국어로 작성한다.
- 설명은 명령형으로 작성한다. (예: "추가한다" X → "추가" O)
- 범위는 영향 받는 앱·패키지·도메인을 간결하게 표기한다. (예: `태블릿`, `design-system`, `ai-agent`)
- breaking change는 타입 뒤에 `!` 를 붙인다.
- SR 번호가 있으면 설명 앞에 `(SR-XXXXX)` 를 붙인다.
- 커밋 메시지에 AI 관련 흔적(Co-Authored-By 등)을 남기지 않는다.
