Git Workflow Conventions
Commit Format
Use conventional commits: type(scope): description
- •feat: new feature
- •fix: bug fix
- •docs: documentation only
- •refactor: neither fixes nor adds
- •chore: maintenance tasks
Before Starting
- •Check CONTRIBUTING.md, Makefile, and Justfile if they exist for project-specific conventions
- •Follow existing commit style visible in
git log
PR Workflow
- •Create feature branch from main
- •Make changes, test, lint
- •Commit with conventional format
- •Push:
git push -u origin <branch> - •Create PR:
gh pr create
Commit Signing (1Password SSH)
- •All commits and tags are auto-signed via 1Password SSH keys (Touch ID prompt)
- •Signing uses
op-ssh-sign(symlinked at~/.local/bin), not GPG - •Never use
--no-gpg-sign-- if signing fails, check that 1Password is running - •Verify signatures:
git log --show-signatureorgit verify-commit HEAD
Review Checklist (before committing)
- •Run tests and lint
- •Check
git diff --stagedfor unintended changes - •Ensure no secrets/credentials in staged files