ai-branch-cleanup

Solid

Cleans branches safely: switches to the default branch, prunes merged and squash-merged branches, syncs to remote, sweeps stale specs, rotates `.ai-engineering/runtime/` per retention policy. Trigger for 'tidy up', 'tidy branches', 'sync to main', 'delete old branches', 'start fresh', 'rotate runtime'. Auto-invoked by /ai-pr after merge. Not for committing changes; use /ai-commit instead. Not for code-level dead-code removal; use /ai-simplify instead.

AI & Automation 52 stars 3 forks Updated 4 days ago MIT

Install

View on GitHub

Quality Score: 89/100

Stars 20%

Recency 20%

100

Frontmatter 20%

Documentation 15%

100

Issue Health 10%

License 10%

100

Description 5%

100

Skill Content

# Branch Cleanup ## Quick start ``` /ai-branch-cleanup # full: sync + branch cleanup + spec sweep + runtime rotate + report /ai-branch-cleanup --sync # sync to default branch only /ai-branch-cleanup --branches # branch cleanup only /ai-branch-cleanup --specs # spec lifecycle sweep + _history.md rotation /ai-branch-cleanup --runtime # rotate .ai-engineering/runtime/ per retention policy /ai-branch-cleanup --consolidate-spec <slug> # delete finalised spec, append _history row ``` Full repository hygiene: safely migrate to the default branch, delete merged and squash-merged branches, rotate runtime artifacts, and produce a per-branch status report. No destructive operations without confirmation. ## When to Use - Session start, after merging PRs, between tasks, before `/ai-brainstorm`. - NOT for committing -- use `/ai-commit`. ## Process Default (no flags) is equivalent to `--all`: runs sync, branch cleanup, and report. ### Phase 0a: Instinct consolidation (default / `--all`, fail-open) 0. **Consolidate session learnings BEFORE switching branches** -- if `.ai-engineering/observations/observations.yml` exists, run `/ai-session-watch --review` to fold this session's observations (especially the LLM-only `corrections` family) into the corpus. This closes the no-commit/no-PR gap: a session that ends at tidy-up time — without a `/ai-commit` or `/ai-pr` having run `--review` — still consolidates its learnings instead of losing t...

Details

Author: arcasilesgroup
Repository: arcasilesgroup/ai-engineering
Created: 4 months ago
Last Updated: 4 days ago
Language: Python
License: MIT

Similar Skills

Semantically similar based on skill content — not just same category

Code & Development Solid

ai-commit

Runs the governed commit pipeline: auto-branches from protected, stages selectively, formats and lints, scans for secrets, gates docs, composes a conventional message, pushes. Trigger for 'commit my changes', 'save my work', 'push this to remote', 'stage these files', 'ship it'. Not for opening a PR; use /ai-pr instead. Not for branch hygiene; use /ai-branch-cleanup instead.

52 Updated 4 days ago

arcasilesgroup

Code & Development Listed

cleanup-branches

Prune local branches whose work is already merged into the base. TRIGGER when the user says "clean up branches", "delete merged branches", "prune local branches", "remove old branches", "I have too many branches", "what branches can I delete", "/nyann:cleanup-branches". Do NOT trigger on "delete THIS branch" (that's a one-off `git branch -D`, not a cleanup pass) or "remove a branch from the remote" (this skill is local-only; remote pruning is `git push --delete origin <branch>` and the user should do that themselves). Do NOT trigger on "merge this branch" (that's the merge step before cleanup).

6 Updated 5 days ago

thettwe

AI & Automation Listed

session-cleanup

End-of-session housekeeping for git repositories. Use when the user asks to 'end of session', 'clean up session', 'session housekeeping', 'clean up branches', 'clean up worktrees', or 'clean up remote branches'.

0 Updated today

Miyamura-sudo