القائمة
Housekeeping — delete merged local and remote branches, prune stale tracking refs, close resolved GitHub issues, remove leftover worktrees. Use on "clean up", "prune branches", "remove merged branches", "close issues", "tidy up", "housekeeping".
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
Write documentation someone will actually read — READMEs, guides, API references, runbooks — short, scannable, example-first, and verified against the code. Trigger on "write docs", "document this", "write a README", "explain how to use this", "our docs are too long/confusing", or a doc that needs rewriting for humans.
Review a diff, branch, or PR for correctness bugs, security issues, and simplification opportunities; findings to docs/<feature-name>/REVIEW.md. Trigger on "review this", "code review", "security review", "audit this", or after something is implemented and needs checking before merge.
Write docs/<feature-name>/PLAN.md with phased, checkbox-driven steps for a feature, refactor, upgrade, or infrastructure change. Trigger on "create/make a plan", "plan this feature/refactor/upgrade", any request to document steps before coding, and proactively when complexity warrants a written plan.
Decide a feature's shape before planning — system design, data model, API contract, UI/UX, whichever apply — and write docs/<feature-name>/DESIGN.md. Trigger on "design this feature/API/schema/UI", "how should we structure this", or between dev-research and dev-create-plan.
Execute an implementation plan from docs/<feature-name>/PLAN.md — tick checkboxes, commit each phase. Trigger on "implement/execute/continue/resume the plan", "start phase 1", "go" right after a plan was created, or whenever there is a PLAN.md to build, even if the user never says "plan".
Run an autonomous plan → implement → review loop for a feature, iterating until the code review passes and pausing for approval before pushing. Use on "loop on this", "keep going until it passes review", "autonomous dev loop", "plan implement and review", or a self-correcting agent workflow.
استنادا إلى تصنيف SOC المهني
| name | dev-clean-up |
| description | Housekeeping — delete merged local and remote branches, prune stale tracking refs, close resolved GitHub issues, remove leftover worktrees. Use on "clean up", "prune branches", "remove merged branches", "close issues", "tidy up", "housekeeping". |
| argument-hint | [lite|full|ultra] |
Audit first, act second. Always show what will be removed before removing it.
lite | full | ultra, default lite)Mode is the trailing argument when it is exactly lite, full, or ultra; everything else is the task/feature description. No mode given → lite.
lite (default) — branches only (§1 branch/ref audit, §2–§4). Skip worktrees and issues.full — everything, §1–§6.ultra — same as full; nothing to parallelize — this skill is what removes worktrees.Run all before touching anything; present the audit; confirm before any destructive step.
git branch --merged main | grep -v '^\*\|main\|master\|develop' # merged local branches
git remote prune origin --dry-run # stale tracking refs
git worktree list
gh issue list --state open --label resolved 2>/dev/null || true
git branch --merged main | grep -v '^\*\|main\|master\|develop' | xargs -r git branch -d
Never delete main/master/develop, the current branch, or anything the user wants kept.
git push origin --delete <branch> — one at a time, confirm each succeeds. No bulk deletes.
git fetch --prune — removes stale origin/<branch> pointers only; local branches untouched.
For each worktree no longer needed (merged/abandoned): git worktree remove <path> && git branch -d <branch>. Uncommitted changes inside → warn, require explicit confirmation.
gh issue close <number> --comment "Resolved — closing." — only when resolution is clear: linked PR merged, labelled resolved/wontfix, or user says so. Never speculatively.
Deferred work is the other kind of debris: if the tree carries TODO:/FIXME: markers, dev-ponytail-debt collects them into a ledger — this skill deletes branches, that one surfaces the shortcuts they left behind.
Local branches deleted · remote branches deleted · refs pruned · worktrees removed · issues closed (each: list or "none").