tidy-repo

Tidy-Repo

Post-shipping git reconciliation for the current repo.

Formerly clean-it. The "clean it" and "clean up" triggers still resolve here.

This skill is thin: it reads the repo's facts from config and delegates the actual mechanics — the [gone] grep trap, squash-merge -D, stash triage by closedByPullRequestsReferences, agent-worktree teardown — to sassy-dog:repo-cleanup, so the plumbing lives in one place across every repo.

Acting principle: assess first, act on what's confident, escalate only on mixed signal — substantive WIP, dep-file touches, abandoned-but-non-trivial work. Never auto-drop a stash on an OPEN issue; never auto-discard outside the allowlist.

1. Derive the repo facts

These are never configured — read them live so they cannot drift:

gh repo view --json nameWithOwner,defaultBranchRef,deleteBranchOnMerge \
  --jq '"repo=\(.nameWithOwner) branch=\(.defaultBranchRef.name) dbom=\(.deleteBranchOnMerge)"'

2. Repo config

!root="$(git rev-parse --show-toplevel 2>/dev/null)"; echo "CONFIG_SOURCE: ${root:-<not a git repo>}"; cat "$root/.claude/sassy-dog/tidy-repo.md" 2>/dev/null || echo "NO_CONFIG"

Check CONFIG_SOURCE before using any of this. It is the repo root resolved from the session's working directory at skill-load time — not necessarily the repo you are about to act on — and cwd resets between Bash calls, so you cannot influence it. If it names a repo other than the one you are working in, discard the block above, read that repo's own .claude/sassy-dog/tidy-repo.md by absolute path, and use that instead. Config is meant to be applied exactly as written, so the wrong one silently applies another repo's rules: on 2026-08-18 two agents shipping in sassydog-routines and sassydog-skills were each handed platform's Terraform gates, and caught it only by noticing the mismatch themselves.

The block above is this repo's .claude/sassy-dog/tidy-repo.md, inlined at load time. Its frontmatter carries the sweep policy — dep_version_globs, noise_allowlist, never_discard, optional claim_label — and its ## sections carry repo-specific prose. The contract is sassy-dog:setup-config → references/config-contract.md.