Pull Requests

PR Title

Use the Conventional Commit Format, same as commit messages:

<type>(<scope>): <description>

Types

• •feat: User-facing features or behavior changes (must change production code)
• •fix: Bug fixes (must change production code)
• •docs: Documentation only
• •style: Code style/formatting (no logic changes)
• •refactor: Code restructuring without behavior change
• •test: Adding or updating tests
• •chore: CI/CD, tooling, dependency bumps, configs (no production code)

PR Description Template

## Summary

One sentence describing the overall change.

- Optional supporting details
- If needed

## Test plan

- [ ] How to verify it works

Labels

Apply all labels that fit. Use gh pr create --label <label> or gh pr edit --add-label <label>:

• •enhancement - User-facing features or improvements (must change production code behavior)
• •refactor - Production code changes that don't alter behavior
• •bug - Fixes broken production code functionality
• •test - Changes to tests
• •documentation - Documentation changes

No label needed for dependency bumps, CI/CD, tooling, or infrastructure changes.

Branch Naming

Use type/short-description:

feat/search-pagination
fix/year-search-bug
chore/pre-commit-hooks

Instructions

1. •Run git log main..HEAD to see commits for this branch
2. •Run git diff main...HEAD to see all changes
3. •Summarize the changes in 1-2 sentences
4. •Create a test plan with verification steps
5. •Apply appropriate labels