Pull Request Title Guide

Name: pr-title
Rating: 92
Author: bloominggrace

Use this skill when creating PR titles or commit messages.

Basic Format

code

{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

code

✅ TSConfig 경로 별칭 설정
✅ mise 환경 변수 설정
✅ ESLint 설정 수정
✅ JWT 환경 변수 이름 오타 수정
✅ Jest에서 Vitest로 마이그레이션
✅ Lodash를 es-toolkit으로 교체
✅ 사용자 수정 테스트 보강
✅ pre-push 로그 가독성 향상

Bad Examples

code

❌ 설정 파일 수정 (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