Git Workflow

Git conventions for this project. Use when: creating branches, writing commit messages, opening PRs, or running the pre-push checklist.

Benja-Pauls e4f10d1 1.1 KB Updated

File contents

Git Workflow

Branch Naming

Use prefixed branch names:

  • feature/short-description — new functionality
  • fix/short-description — bug fixes
  • chore/short-description — tooling, dependencies, config
  • refactor/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.

Benja-Pauls/SerpentStack/tree/main/.skills/git-workflow commit e4f10d16c9

Frequently asked questions

npx skillmds@latest add benja-pauls/git-workflow