Cursor rule

1---
2description: "Git branch naming, commit message format, rebase-first workflow, and PR process for SAFe development. Apply to ALL git operations."
3alwaysApply: true
4---
5 
6# Git Workflow
7 
8This project enforces a **rebase-first workflow** validated by CI/CD automation. See `CONTRIBUTING.md` for the full guide.
9 
10## Branch Naming
11 
12**Required format:** `{{TICKET_PREFIX}}-{number}-{short-description}`
13 
14Examples:
15- `{{TICKET_PREFIX}}-42-add-user-authentication`
16- `{{TICKET_PREFIX}}-57-fix-profile-image-upload`
17 
18Rules:
19- MUST start with `{{TICKET_PREFIX}}-{number}`
20- Use lowercase letters and hyphens only
21- Keep total length under 50 characters
22- Never include personal names or dates
23- CI will reject branches that do not follow this format
24 
25## Commit Message Format
26 
27**Required format:** `type(scope): description [{{TICKET_PREFIX}}-XXX]`
28 
29### Types
30 
31- `feat` -- New feature
32- `fix` -- Bug fix
33- `docs` -- Documentation changes
34- `style` -- Code formatting (no logic changes)
35- `refactor` -- Code restructuring
36- `test` -- Adding or updating tests
37- `chore` -- Maintenance tasks, dependencies
38- `ci` -- CI/CD pipeline changes
39 
40### Scopes (optional)
41 
42- `payments`, `auth`, `ui`, `api`, `db`, `scheduler`, `security`, `cursor`
43 
44### Examples
45 
46```
47feat(payments): add Stripe checkout integration [{{TICKET_PREFIX}}-42]
48fix(auth): resolve login redirect issue [{{TICKET_PREFIX}}-57]
49docs: update API documentation [{{TICKET_PREFIX}}-123]
50```
51 
52CI will reject commits that do not include a ticket reference.
53 
54## Workflow Steps
55 
56```bash
57# 1. Start from latest base branch
58git checkout {{MAIN_BRANCH}}
59git pull origin {{MAIN_BRANCH}}
60git checkout -b {{TICKET_PREFIX}}-{number}-{description}
61 
62# 2. Make changes and commit
63git add <files>
64git commit -m "feat(scope): description [{{TICKET_PREFIX}}-XXX]"
65 
66# 3. Keep branch updated (rebase, NEVER merge)
67git fetch origin
68git rebase origin/{{MAIN_BRANCH}}
69 
70# 4. Validate before pushing
71# Run: {{CI_VALIDATE_COMMAND}}
72 
73# 5. Push
74git push --force-with-lease origin {{TICKET_PREFIX}}-{number}-{description}
75 
76# 6. Create PR using .github/pull_request_template.md
77# 7. Merge using "Rebase and merge" ONLY (never squash or merge commit)
78```
79 
80## Rules
81 
82- **Rebase-first**: Never create merge commits. Always rebase onto the base branch.
83- **Force-with-lease**: Use `--force-with-lease` after rebase, never `--force`.
84- **Linear history**: The project requires a clean linear commit history.
85- **One ticket per branch**: Each branch maps to exactly one project management ticket.
86- **PR template**: Always use `.github/pull_request_template.md` and fill ALL sections.
87 
88## Role Collapsing
89 
90- **RTE** role is collapsible (PR creation can be done by implementer)
91- **QAS** role is NOT collapsible (independence gate)
92- **SecEng** role is NOT collapsible (security audit requires independence)
93