Git Workflow
Branch Naming
Use prefixed branch names:
feature/short-description— new functionalityfix/short-description— bug fixeschore/short-description— tooling, dependencies, configrefactor/short-description— code restructuring
Lowercase, hyphens, under 50 characters.
Commit Messages
Follow Conventional Commits:
<type>: <short summary under 72 chars>
Types: feat, fix, chore, docs, test, refactor, style
Pull Request Format
gh pr create \
--title "feat: add projects endpoint" \
--body "## Summary
- What changed and why (1-3 bullets)
## Test plan
- How the changes were verified"
Pre-Push Checklist
Before pushing, run the full verification suite:
make verify # lint + typecheck + test for both backend and frontend
This runs the same checks as CI, so if it passes locally, CI will pass too.
Source: Benja-Pauls/SerpentStack — distributed by TomeVault.