commit · git:20260408.61db2e8 · 2026-04-08 · sha256 b14c246572bf6051

commit git:20260408.61db2e8A

Immutable. This exact content never changes and is served at /api/v1/blob/b14c246572bf6051.

No tool to install first
claude plugin marketplace add https://markdownregistry.com/mp/a/art_hlfzfyo636lhste3/b14c246572bf6051ff456fa050bfa50ec219054e52381d409b4e6e20170bbf66.json

Then /plugin install commit@markdownregistry-hlfzfyo636lhste3 in Claude Code. It installs this exact version, the one graded A here, pinned to the commit it was graded at, and leaves it there.

---
name: commit
description: Stage, commit, and push code changes with branch safety and explicit staging. Use when ready to commit work. Invoked by saying "commit", "push", or "commit and push".
---

# Commit Your Changes

Stage, commit, and push **only the files you modified in this session** to the **current working branch**.

---

## Branch Safety (BLOCKING GATE)

1. **Check the current branch** — run `git branch --show-current`.
2. **If on `master` or `main`** — **STOP immediately**. Do not stage, commit, or push. Tell the user and wait.
3. **If on `dev`** — you may commit, but **do NOT push automatically**. After committing, ask: "Committed. Ready to push to dev?" Wait for explicit approval.
4. **Stay on the branch you started on.** Never switch branches just to commit.
5. Never push or commit directly to `master` or `main` unless explicitly instructed.

---

## Verification Gate (BLOCKING)

Before committing, confirm that **ALL** required verification steps from the task plan have passed. If any verification is blocked or incomplete, do **NOT** commit. Report the blocker. See `AGENTS.md` → Blocker Protocol.

---

## Steps

1. **Check `git status --short`** — Review all modified/untracked files. Identify which ones you touched.

2. **Stage only your files** — Use `git add` with explicit file paths. Never use `git add -A` or `git add .`.

3. **Write a high-quality commit message** using **multiple `-m` flags**.

   ### Subject Format
   ```
   <type>(<optional-scope>): <action-oriented summary>
   ```

   **Allowed Types:** `feat`, `fix`, `refactor`, `docs`, `style`, `data`, `config`, `chore`, `merge`

   **Rules:**
   - Keep subjects under ~80 characters
   - Use lowercase for type and scope
   - Start with a clear verb
   - Be specific, not generic

   ### Body
   - 2–3 `-m` flags max
   - Summarize key changes in 3–5 sentences
   - End with `Files: <key files>`

   ### Quick Rewrite Guide
   - `Updated gateway` → `feat(gateway): add support for digital wallet payments`
   - `fix stuff` → `fix(checkout): correct redirect URL for cancelled payments`

4. **Push to the current working branch** — If on `dev`, ask before pushing.

---

## Rules

- **Never stage files you did not change.**
- **Never use `git add .` or `git add -A`.**
- **Never use a vague commit subject.**
- **Do not include Copilot co-author trailers unless explicitly requested.**
- **Never force push.**
- **One commit per session batch.**
- **ALWAYS present 3 commit message options** (numbered 1–3, concise → descriptive). Wait for user to pick.
- **ALWAYS ask before pushing.**