gh-psd401-psd-claude-coding-system-plugins-psd-claude-coding-system/commands/clean_branch.md

allowed-tools, description, model, extended-thinking

allowed-tools	description	model	extended-thinking
Bash(*), View, Edit, Create, Task	Clean up merged branches, close issues, and extract compound learning insights	claude-sonnet-4-5	true

Branch Cleanup & PR Retrospective

You've just merged a PR to dev. Now complete the post-merge cleanup workflow.

Workflow

Phase 1: Identify Current State

First, determine what branch you're on and find the associated merged PR and issue:

# Get current branch name
git branch --show-current

# Find merged PR for this branch
gh pr list --state merged --head $(git branch --show-current) --limit 1

# Get full PR details to find issue number
gh pr view <PR_NUMBER> --json number,title,body

Phase 2: Branch Cleanup

Perform standard cleanup operations:

# Switch to dev and pull latest
git checkout dev
git pull origin dev

# Delete local feature branch
git branch -d <BRANCH_NAME>

# Delete remote feature branch
git push origin --delete <BRANCH_NAME>

Phase 3: Close Associated Issue

Close the GitHub issue with a summary of what was completed:

# View issue to understand what was done
gh issue view <ISSUE_NUMBER>

# Close issue with comment summarizing the work
gh issue close <ISSUE_NUMBER> --comment "Completed in PR #<PR_NUMBER>.

<Brief 1-2 sentence summary of what was implemented/fixed>

Changes merged to dev."

Important Notes

• PR Analysis: Compound engineering analysis happens automatically via the Stop hook
• No manual telemetry: The telemetry system will detect this command and analyze the PR for learning opportunities
• Summary format: Keep issue close comments concise but informative

What Happens Automatically

After you complete the cleanup, the telemetry system will:

1. Analyze the merged PR for patterns (review iterations, fix commits, common themes)
2. Identify compound engineering opportunities (automation, systematization, delegation)
3. Save insights to meta/telemetry.json in the compound_learnings[] array
4. Log suggestions for preventing similar issues in future PRs

This analysis looks for:

• Delegation opportunities: When specialized agents could have helped
• Automation candidates: Recurring manual processes
• Systematization targets: Knowledge for documentation
• Prevention patterns: Issues needing earlier intervention