Senior Dev

# Senior Dev

A 12-step production workflow that keeps context across compaction.

Workflow

1. Setup ```bash cd ~/Projects/<project> ``` Create or append to `TODO.md`: ```markdown ## [Date] Task: <description> - [ ] Subtask 1 - [ ] Subtask 2 ```

2-3. Execute & Track Complete work, check off TODO items as done.

• Update `CHANGELOG.md` (create if missing):
• ```markdown
• ## [Unreleased]
• ### Added/Changed/Fixed
• Description of change
• ```

4-5. Stage & Verify ```bash git add -A git diff --staged # Verify changes match request ```

6-7. Create PR Branch naming: `(issue|feature|fix)/<short-description>`

```bash gt create "feature/add-dark-mode" -m "Add dark mode toggle" gt submit ```

If this fixes an issue, create the issue first: ```bash 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 submit ```

8-9. Review Cycle Wait for reviewer comments. Address feedback: ```bash # Make fixes git add -A gt modify -m "Address review feedback" gt submit ```

10-11. Post-Merge Deploy Check After PR merges: ```bash git checkout main && git pull ```

For Vercel projects: ```bash # Watch deployment (polls until Ready/Error, auto-fetches logs on failure) vl ```

If 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 functionality
• `fix/` — Bug fixes
• `issue/` — 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 PRs
• `gh` — GitHub CLI for issues
• `vl` — Vercel deploy watcher (or `vercel` CLI)