smith-finish

Smith — Session Finish

Skill Purpose

End-of-session workflow that ensures all work is committed, pushed, merged to main, specs are updated, and the workspace is clean. Prevents losing work when closing a development session.

When to Use

• User is done working and wants to wrap up
• User wants to ensure nothing is lost before ending a session
• Triggered by /smith-finish

How to Execute

Run all steps autonomously. Only stop to ask the user if a decision is genuinely ambiguous (e.g., unrelated uncommitted changes that may need separate branches).

---

Step 1: Inventory — Assess Current State

Gather all of the following in parallel:

# Resolve the configured base branch (falls back to main when unconfigured)
BASE_BRANCH=$(.specify/scripts/bash/get-base-branch.sh)

# What branch are we on?
git rev-parse --abbrev-ref HEAD

# Any uncommitted changes?
git status

# Any unpushed commits? (only if on a branch other than the base branch)
git log origin/$(git rev-parse --abbrev-ref HEAD)..HEAD --oneline 2>/dev/null

# What files changed vs the configured base branch?
git diff "$BASE_BRANCH" --name-only 2>/dev/null

# Any open PRs for this branch?
gh pr list --head $(git rev-parse --abbrev-ref HEAD) --state open --json number,title,url 2>/dev/null

Present a brief status summary to the user:

Session Status:
- Branch: <branch-name>
- Uncommitted changes: <count> files
- Unpushed commits: <count>
- Open PRs: <count>
- Files changed vs main: <count>

Decision tree based on state:

State	Action
On main, no changes	Nothing to do. Report "workspace is clean" and exit.
On main, uncommitted changes	Create a feature branch (fix/<slug> or feat/<slug> based on changes), then continue to Step 2. Ask the user for a brief description to name the branch.
On feature branch, uncommitted changes	Continue to Step 2.
On feature branch, all committed + pushed + PR merged	Skip to Step 6 (verify clean state).
On feature branch, all committed + pushed + PR open	Skip to Step 4 (spec updates, then merge).
On feature branch, all committed + not pushed	Skip to Step 3 (push).