- name
- senior-dev
- description
- Production development workflow with TODO tracking, Graphite PRs, GitHub issues, Vercel deploy checks, and SMS notifications. Use when starting a new task, fixing bugs, implementing features, or any development work that needs tracked progress and code review.
Senior Dev
A 12-step production workflow that keeps context across compaction.
Workflow
1. Setup
cd ~/Projects/<project>Create or append to TODO.md:
## [Date] Task: <description>
- [ ] Subtask 1
- [ ] Subtask 22-3. Execute & Track
Complete work, check off TODO items as done.
Update CHANGELOG.md (create if missing):
## [Unreleased]
### Added/Changed/Fixed
- Description of change4-5. Stage & Verify
git add -A
git diff --staged # Verify changes match request6-7. Create PR
Branch naming: (issue|feature|fix)/<short-description>
gt create "feature/add-dark-mode" -m "Add dark mode toggle"
gt submitIf this fixes an issue, create the issue first:
gh issue create --title "Bug: description" --body "Details..."
# Note the issue number
gt create "issue/42-fix-login-bug" -m "Fix login bug (#42)"
gt submit8-9. Review Cycle
Wait for reviewer comments. Address feedback:
# Make fixes
git add -A
gt modify -m "Address review feedback"
gt submit10-11. Post-Merge Deploy Check
After PR merges:
git checkout main && git pullFor Vercel projects:
# Watch deployment (polls until Ready/Error, auto-fetches logs on failure)
vlIf build fails → gh issue create with error logs, restart from step 6.
12. Report & Cleanup
Report completion format:
✅ [Project] Task completed PR: <url> Deploy: success/failed
Quick Reference
| Step | Command | Purpose |
|---|---|---|
| Stage | git add -A | Stage all changes |
| Verify | git diff --staged | Review before commit |
| Branch | gt create "type/name" -m "msg" | Create branch + commit |
| PR | gt submit | Push + create/update PR |
| Issue | gh issue create | Track bugs/tasks |
| Deploy | vl | Watch build, auto-fetch logs on error |
Branch Prefixes
feature/— New functionalityfix/— Bug fixesissue/— Linked to GitHub issue (include #number)chore/— Maintenance, deps, config
Files to Maintain
- TODO.md — Active task tracking (survives context compaction)
- CHANGELOG.md — Version history
- PLAN.md — Architecture decisions (optional)
Tools Required
gt— Graphite CLI for stacked PRsgh— GitHub CLI for issuesvl— Vercel deploy watcher (orvercelCLI)