| name | sdlc:complete |
| description | Finish work and reset local environment for next task. Use this when the user is done with a feature branch, wants to clean up after a merged PR, or needs to reset their workspace. |
| allowed-tools | ["Bash(git *)","Bash(gh *)","Bash(linear *)","Bash(*get-base-branch.sh*)","Bash(test *)","Bash(*get-linear-issue-id.sh*)"] |
Complete Work
Finish the current task and reset the local environment for the next piece of work.
In all bash steps below, substitute placeholder names (like BASE_BRANCH, CURRENT_BRANCH, etc.) with the actual values you stored earlier.
Workflow
- Verify PR is merged to confirm the work is done
- Update Linear issue to Done (if applicable)
- Detect environment and cleanup worktree or branch
- Prune stale branches that have been merged remotely
- Confirm clean state
Step 1: Verify PR is Merged
Follow Branch Verification.
If CURRENT_BRANCH equals BASE_BRANCH, note "Already on default branch" and skip to Step 4.
Otherwise, check PR status:
gh pr view --json state --jq '.state'
Store the output as PR_STATE (or "NONE" if the command fails).
- If OPEN: warn the user the PR is still open and ask if they want to continue anyway
- If MERGED: note "PR merged successfully"
- If NONE: note "No PR found for branch" and proceed
Step 2: Update Linear Issue
Try to extract a Linear issue ID from the branch name:
../../scripts/get-linear-issue-id.sh "CURRENT_BRANCH"
If it succeeds, store the output as ISSUE_ID and update:
linear issue update ISSUE_ID -s "Done"
If the Linear CLI is not available or the command fails, continue silently.
Step 3: Detect Environment and Cleanup
Follow Linked Worktree Detection to determine if the current directory is a linked worktree. Then follow the matching case below.
Case A: Linked worktree with SDLC marker
Applies when worktree detection indicates a linked worktree AND the marker file exists:
test -f .sdlc-worktree
Get the current worktree path:
git rev-parse --show-toplevel
Store as WORKTREE_PATH. Get the main worktree path:
git worktree list --porcelain
The first line has the format worktree /path/to/main. Extract the path and store as MAIN_WORKTREE.
Remove the worktree:
git -C "MAIN_WORKTREE" worktree remove "WORKTREE_PATH"
If this fails because the worktree has uncommitted changes, inform the user and advise manual cleanup. Do not force-remove, as that risks losing work.
Case B: Linked worktree without SDLC marker
This worktree was not created by sdlc:design. Warn the user and advise manual cleanup. Do not attempt any removal.
Case C: Main working tree
Switch back to the default branch and clean up the feature branch:
git checkout "BASE_BRANCH"
git pull origin "BASE_BRANCH"
git branch -d "CURRENT_BRANCH"
The -d flag (lowercase) only deletes if the branch is fully merged, which is a safety net against accidental deletion of unmerged work.
Step 4: Prune Stale Branches
From the main worktree, clean up remote tracking branches that no longer exist:
git fetch --prune
List branches to identify those whose remote was deleted after merge:
git branch -vv
For each branch showing [gone] in the output, delete it:
git branch -d <branch-name-here>
Step 5: Confirm Reset
git worktree list
git branch --show-current
git status --short
Output
Environment reset complete
Branch: main
Status: (clean)
Ready for next task. Use /sdlc:design <issue-id> to start.
