Initial commit

commands/clean_branch.md

@@ -0,0 +1,80 @@
+---
+allowed-tools: Bash(*), View, Edit, Create, Task
+description: Clean up merged branches, close issues, and extract compound learning insights
+model: claude-sonnet-4-5
+extended-thinking: 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:
+
+```bash
+# 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:
+
+```bash
+# 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:
+
+```bash
+# 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