Branch Naming Convention
To ensure consistency and improve project management, follow the branch naming convention below.
Basic Rules
Only the following branch naming patterns are permitted. Other naming conventions are prohibited.
\p{issue_id}
=[0-9]+
: GitHub Issue ID\p{summary}
=[a-z0-9-]+
: Brief description in English\p{date(yyyymmdd)}
=[0-9]{8}
: Creation date (start date of work)\p{commit_hash}
=[a-f0-9]{7,40}
: Commit hash
Feature
- For feature development
- Use for developing or improving features
feature/{issue_id}-{summary}-{date(yyyymmdd)}
- Example: issue ID is
10
feature/10-add-api-nameabc-20250316
Bugfix
- For production environment bug fixes
- Use to fix bugs occurring in the production environment
bugfix/{issue_id}-{summary}-{date(yyyymmdd)}
- Example: issue ID is
15
bugfix/15-fix-login-error-20250316
Hotfix
- For urgent fixes
- Use for critical bugs requiring immediate resolution in the production environment
hotfix/{issue_id}-{summary}-{date(yyyymmdd)}
- Example: issue ID is
20
hotfix/20-critical-security-patch-20250316
Revert
- For reverting previous changes
- Use when reverting a previous commit
revert/{commit_hash}-{date(yyyymmdd)}
- Example: commit hash is
abcd123
revert/abcd123-20250316
Allowed Characters
- Lowercase alphabet (
a
-z
) - Numbers (
0
-9
) - Hyphen (
-
)
Always use kebab-case (connecting words with hyphens).
Prohibited Characters
- Uppercase alphabet (
A-Z
) - Spaces (
- Underscores (
_
) - Other symbols (
!
,@
,#
,$
,%
,^
,&
,*
,(
,)
, etc.)
Notes
- Keep branch names clear and concise.
- Do not create branches without an issue; always create an issue before creating a branch.
- Changing branch names after creation is prohibited.