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 → TSConfig
eslint.config.mjs → ESLint
mikro-orm.config.ts → MikroORM
users.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