Skip to content

matthewwong525/WongStack / .agents/plugins/loop/skills/save

references/git-gate.md

View on GitHub
# The git gate

Every `/save` checkpoint, including `/ship`'s, is one run of [`checkpoint.mjs`](../scripts/checkpoint.mjs) on a feature branch with its files staged.

## The default branch

`main` means the default branch. Assume it; new repos lack `origin/HEAD`. If neither local nor remote `main` exists, substitute the name `gh repo view --json defaultBranchRef` gives.

## 1 — open or update the pull request

The command pushes to an **OPEN** PR, or creates one. A **MERGED** PR gets no push or wait: already shipped, no live preview. A **CLOSED** one stops it: ask, reopen or push to a fresh branch. It refuses nothing to save, the default branch, a credential match and a spent fix cap; a `gh` failure → [the preconditions](preconditions.md).

### The body mirrors the change

The body is regenerated as the [change mirror](../../../references/rules.md#the-change-is-a-living-handoff-not-just-a-plan), replacing manual edits; a rendering failure keeps the old body and stops. With no change, it is the summary and a `/ship` footer.

## 2 — wait for checks, auto-fix on failure

The command waits up to 20 minutes and ends with `SAVE_GATE_RESULT=`:

| Result | Meaning | `/save` | `/ship` |
|---|---|---|---|
| **SUCCESS** | checks passed | report | mergeable |
| **NONE** | no checks configured — PR review is the gate | report | mergeable; invoking `/ship` is the approval |
| **LOCAL** | no remote: the pre-check passed | report | mergeable, no `/verify`; `finish` reruns the pre-check |
| **FAILURE** | checks failed | auto-fix loop; report when the cap runs out | do not merge |
| **TIMEOUT** | still running past the budget | report with the PR link | do not merge |
| **UNKNOWN** | `gh` couldn't be asked | report as **unverified** | do not merge |

**`UNKNOWN` is never `NONE`**: merging on it lets a red branch into the default branch.

### The auto-fix loop

`FAILURE` lists every failing check with the cause its log shows. Fix all by [fix it or ask](../../../references/rules.md#fix-it-or-ask) in one push, after rerunning the failed check here where the tools exist: `node .claude/plugins/loop/scripts/slot.mjs --run precheck`. A failure outside the diff gets one rerun; still red: stop, no code edit, but [in `/ship`](../../../references/rules.md#inside-ship) one fix that keeps the check as strong.

**Cap: 3 attempts per `/save` run**, counted by the command; each of [`/verify`](../../verify/SKILL.md)'s two re-walks passes `--new-run` for a fresh cap (budgets nest, never share). Still red → stop with the error and the checks link. Never bypass with `--no-verify` or `--force`.

## Saved revision handoff

`RECEIPT` is a temporary nonsecret file with the saved revision's identity and the waiter's result. UNKNOWN and LOCAL yield no receipt.

`/verify --checkpoint <receipt>` reuses SUCCESS/NONE only for the same head and newest check/run identity; a new attempt invalidates it. Otherwise it reads the existing gate, without reruns, pushes or record edits. Delete receipts at chain end.
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall