Feature Workflow
Overview
Create a branch per task, implement the change, and open a pull request using gh. Keep the workflow lightweight and consistent.
Workflow (PowerShell)
1) Identify the task
- •Confirm the todo item or issue number.
- •If needed, note acceptance criteria and key touchpoints.
2) Create a branch
- •Pull latest default branch:
- •
git fetch origin - •
git checkout main - •
git pull
- •
- •Create a branch named after the task:
- •
git checkout -b fix/<short-slug> - •or
git checkout -b feat/<short-slug>
- •
3) Implement the change
- •Make focused changes tied to the task.
- •Update docs or tests if required by the task.
4) Commit changes
- •Use Conventional Commits:
- •
feat(scope): ... - •
fix(scope): ...
- •
- •Include only relevant files.
5) Push and open PR
- •Push the branch:
- •
git push -u origin <branch>
- •
- •Create PR with GH CLI:
- •
gh pr create --title "..." --body "..."
- •
PR body template
code
## Summary <what changed and why> ## Testing - <commands or "not run (reason)"> ## Checklist - [ ] Meets acceptance criteria - [ ] Docs/strings updated if needed
Quality checklist
- •Branch name matches task intent.
- •Commit message follows Conventional Commits.
- •PR references the issue number if applicable.
- •PR body includes summary and testing.