Pull Request Title Guide
Use this skill when creating PR titles or commit messages.
Basic Format
{Subject} {Action}
- Subject: The target being modified (file, module, feature, library, etc.)
- Action: The type of change being made
Subject Naming Rules
Choose the subject based on what is being modified:
| Target Type | Subject Example | Description |
|---|---|---|
| Config file | TSConfig, ESLint, MikroORM | Use the official/common name of the tool |
| Module | JwtModule, CacheModule, UsersController | Use the class/module name |
| Feature | CI, E2E 테스트, Git Hooks | Use the feature name |
| Library | Lodash, Vitest, Turborepo | Use the library name |
| Domain | 사용자, 인증, OTP | Use Korean domain terms |
Examples
tsconfig.ts→ TSConfigeslint.config.mjs→ ESLintmikro-orm.config.ts→ MikroORMusers.service.ts→ 사용자 or UsersService
Action Types
| Action | Usage | Example |
|---|---|---|
| 설정 | Initial setup or configuration | JwtModule 설정 |
| 변경 | Modify existing configuration | TSConfig 변경 |
| 수정 | Fix issues or errors | ESLint 에러 수정 |
| 추가 | Add new features | UsersController 테스트 추가 |
| 적용 | Apply new tools or patterns | Turborepo 적용 |
| 구축 | Build infrastructure | CI 구축 |
| 교체 | Replace with alternatives | Lodash를 es-toolkit으로 교체 |
| 마이그레이션 | Migrate to new tools | Jest에서 Vitest로 마이그레이션 |
| 표준화 | Standardize patterns | 응답 변환 방식 표준화 |
| 보강 | Strengthen/enhance | 사용자 수정 테스트 보강 |
| 향상 | Improve quality | pre-push 로그 가독성 향상 |
| 제외 | Exclude from rules | fixup 커밋 제목 길이 제한 제외 |
| 정의 | Define rules/specs | Cursor 규칙 정의 |
Good Examples
✅ TSConfig 경로 별칭 설정
✅ mise 환경 변수 설정
✅ ESLint 설정 수정
✅ JWT 환경 변수 이름 오타 수정
✅ Jest에서 Vitest로 마이그레이션
✅ Lodash를 es-toolkit으로 교체
✅ 사용자 수정 테스트 보강
✅ pre-push 로그 가독성 향상
Bad Examples
❌ 설정 파일 수정 (too vague - what config?)
❌ 버그 수정 (too vague - what bug?)
❌ 테스트 추가 (too vague - what test?)
❌ Web 앱 TSConfig 설정 (unnecessary context - Vite implies Web)
Tips
- Be specific: The subject should clearly identify what was changed
- Use official names: TSConfig (not tsconfig), ESLint (not eslint)
- Avoid redundancy: Don't repeat context that can be inferred
- Keep it concise: Title should be scannable at a glance
- Use Korean for actions: 설정, 수정, 추가, etc.
Related: Commit Message vs PR Title
- Commit messages: Can be more granular, multiple per PR
- PR title: Should summarize the overall change in one line
