Branch Strategy
ALL changes require feature branches - NO direct commits to main.
Branch format: {type}/{description}
Types:
- •
feature/- New features - •
fix/- Bug fixes - •
docs/- Documentation - •
chore/- Maintenance
Commit Message Format
code
type(scope): short description - Bullet point details - More details if needed
Types: feat, fix, refactor, docs, test, chore, perf
Never include: Emojis, AI attribution, co-author tags
Ticket-to-Commit Mapping
- •BUG tickets →
fix(scope) - •FEAT tickets →
feat(scope) - •DOCS tickets →
docs(scope) - •CHORE tickets →
chore(scope)
Extract scope from ticket content (e.g., sentiment, api, ui, narratives, timeline)
Pull Request Workflow
- •Create PR: Push feature branch and open PR against main
- •PR Naming: Use same format as commits:
type(scope): description - •Merge Strategy: Squash merge to main (one commit per PR)
- •Requirements: All tests must pass before merge
- •Review: Ensure changes match ticket requirements