Skip to content

v2.1.0

Choose a tag to compare

View all tags
@n-shadloo n-shadloo released this 18 Jul 06:30
· 14 commits to main since this release
v2.1.0
6f4c340

v2.1.0

Minor release. Restructures how the skill's usage is described into four explicit, request-selected modes and adds a deliberate autonomous mode. The new mode is backward-compatible, so this is a MINOR bump rather than a patch; the guarantees that already governed commit-message, file-selection, and pull-request output are unchanged.

No breaking changes. Existing behavior for staged-commit messages, file selection, and pull requests is preserved; the change is that these are now framed as distinct modes with one new opt-in execution mode alongside them.

What changed

The skill now supports four modes, chosen by what you ask for:

  1. Commit command for already-staged changes (default) — reads the staged diff and presents the exact commit command to run.
  2. Choose files, then commit — selects one coherent set of files and presents the staging commands plus the commit command to run.
  3. Pull-request title and description — writes a title and structured Markdown description from the branch's diff against its base.
  4. Autonomous stage, commit, and push — runs the operations end to end, but only when explicitly asked to do the work itself.

Guarantees

  • Modes 1–3 remain read-only. The agent never runs git add, git commit, or git push in these modes — it presents the commands and you run them. A follow-up "go ahead" or "commit this" does not promote these modes to execution.
  • Modes 1–3 add no AI attribution of any kind.
  • Mode 4 is the sole execution exception, and is never inferred — it activates only on an unmistakable request to carry out the work. In this mode only, the no-AI-attribution rule is relaxed (attribution is permitted but optional; other trailers must still be true), and pushing is done normally with no force-push and no git add -A.
  • Every mode that emits a commit uses the quoted-heredoc form, including subject-only commits, for one consistent, expansion-safe shape.

Files updated

  • SKILL.md — version bump to 2.1.0; description and workflow reframed around the four modes; new "Choose the mode" section and Mode 4 section.
  • AGENTS.md — four-mode usage section; inline commit examples converted to the heredoc form; Mode 4 workflow and attribution rules.
  • README.md — usage section documents all four modes with example output; Layout note.
  • GEMINI.md — pointer updated to describe the four modes and the mode boundary.
  • .cursor/rules/git-authoring.mdc — rule updated to the four-mode structure.
  • references/conventional-commits.md — sign-off example aligned to the heredoc commit form.
  • references/examples.md — worked examples and the file-selection walkthrough updated to the heredoc form and mode-2 framing.
  • references/pull-requests.md — clarified as mode 3, read-only, distinct from the autonomous mode.

Upgrade notes

Drop-in replacement for 2.0.0. If you relied on subject-only commits being emitted as git commit -m "…", note that all emitted commit commands — including subject-only ones — now use the quoted-heredoc form.

Full Changelog: v2.0.0...v2.1.0

Assets 2
Loading