org-branch-cleanup

name	org-branch-cleanup
description	Audit and safely prune stale branches across a GitHub organization with immutable snapshots, conservative merged-PR classification, live SHA/protection/open-PR revalidation, resumable deletion ledgers, and post-delete verification. Use when a maintainer asks to clean up old, dead, merged, bot-created, or abandoned organization branches without risking default, protected, release, security-advisory, state, or active pull-request refs.
license	MIT
metadata	{"source":"https://github.com/vincentkoc/dotskills"}

Org Branch Cleanup

Purpose

Remove organization branch clutter without guessing which refs are safe to delete.

The bundled scripts/org_branch_cleanup.py separates the work into read-only audit, explicit apply, and full verification phases. Dry-run evidence is the default; deletion requires an exact organization confirmation.

When to use

• A GitHub organization has accumulated old or merged development branches.
• Bot, agent, migration, or dependency branches remain after pull requests merge.
• A maintainer wants an evidence-backed cleanup ledger rather than broad git push --delete.
• Branch-heavy security, state, archive, or generated-data repositories need to be separated from ordinary development repos.
• A previous cleanup stopped midway and must resume without repeating completed deletions.

Workflow

1. Read the target repository or organization instructions before mutation.