Git

git

Purpose

Specialized git operations utility. Handles semantic commits, PR descriptions, branch naming, and changelog generation with consistent conventions. Replaces scattered git logic across cook Phase 7 and other skills with a single, convention-aware utility.

Triggers

• Called by cook Phase 7 for commit creation
• Called by scaffold Phase 8 for initial commit
• Called by team for parallel branch/PR management
• Called by docs for changelog generation
• Called by launch for release tagging
• /rune git commit — manual semantic commit
• /rune git pr — manual PR generation
• /rune git branch — generate branch name
• /rune git changelog — generate changelog from commits
• /rune git release — create tagged release with changelog

Calls (outbound)

None — pure L3 utility. Reads git state, produces git commands/output.

Called By (inbound)

• cook (L1): Phase 7 — create semantic commit after implementation
• scaffold (L1): Phase 8 — initial commit with generated project
• team (L1): parallel PR management across workstreams
• launch (L1): release tagging and changelog
• docs (L2): changelog generation sub-workflow
• User: /rune git direct invocation

Modes

Commit Mode (default)

Analyze staged changes and produce a semantic commit.

PR Mode

Analyze full branch diff against base and produce a pull request.

Branch Mode

Generate a branch name from a task description.

Changelog Mode

Generate changelog entries from commit history.

Executable Steps

Commit Mode

Step 1 — Analyze Staged Changes

Read git diff --staged and git status. Classify the change:

| Type | Signal | Prefix | |------|--------|--------| | New feature | New files, new exports, new routes | feat | | Bug fix | Changed logic in existing code, test fix | fix | | Refactor | Structural change, no behavior change | refactor | | Test | Only test files changed | test | | Documentation | Only .md, comments, JSDoc changed | docs | | Build/CI | Config files, CI pipelines, Dockerfile | chore | | Performance | Optimization, caching, query improvement | perf |

Step 2 — Detect Scope

Extract scope from file paths:

• src/auth/* → scope: auth
• src/components/Button.tsx → scope: ui
• api/routes/users.ts → scope: api
• Multiple directories → omit scope or use most relevant
• Root config files → scope: config

Step 3 — Generate Commit Message

Format: ():

Rules:

• Description: imperative mood, lowercase first letter, no period
• Max 72 characters for subject line
• If > 5 files changed → add body with bullet summary
• If breaking change detected (removed export, changed API signature, schema change) → add ! suffix and BREAKING CHANGE: footer

feat(auth): add JWT refresh token rotation

- Add refresh token endpoint with sliding window expiry
- Store token family for reuse detection
- Add middleware to validate refresh tokens

BREAKING CHANGE: /api/auth/refresh now requires refresh_token in body instead of cookie

Step 4 — Execute

Run git commit with the generated message. If pre-commit hooks fail → report the failure, do not --no-verify.

PR Mode

Step 1 — Analyze Branch

Read ALL commits on the current branch vs base branch using git log ..HEAD and git diff ...HEAD.

Do NOT just look at the latest commit — PRs include ALL branch commits.

Step 2 — Generate PR

## Summary

## Changes
- [grouped by feature/area]

## Test Plan
- [ ] [specific test scenarios]

## Breaking Changes
- [if any — list explicitly]

Title: ` from current branch.

Changelog Mode

Step 1 — Read History

Read commits since last tag (git log $(git describe --tags --abbrev=0)..HEAD) or since specified reference.

Step 2 — Group and Format

Group commits by conventional commit type. Format as Keep a Changelog:

## [Unreleased]

### Added
- New feature description (#PR)

### Fixed
- Bug fix description (#PR)

### Changed
- Change description (#PR)

### Removed
- Removed feature (#PR)

Link to PRs/issues when references found in commit messages.

Release Mode

Create a version tag with release artifacts.

Triggers:

• /rune git release — create release for specified version
• Called by launch (L1) during release pipeline
• Called by deploy (L2) after successful production deploy

Step 1 — Validate Version

Parse version string. Must follow semver (major.minor.patch):

• Breaking changes → major bump
• New features → minor bump
• Bug fixes → patch bump

Check git tag -l to ensure version doesn't already exist.

Step 2 — Generate Release Artifacts

1. Changelog: Run Changelog Mode to generate entries since last tag
2. Version bump: Update version in package.json, pyproject.toml, Cargo.toml, or equivalent
3. Release notes: Summarize changes for GitHub Release body

Step 3 — Tag and Push

git add 
git commit -m "chore: bump version to v"
git tag -a v -m "Release v"
git push origin master --tags

Step 4 — Create GitHub Release

gh release create v --title "v" --notes ""

Step 5 — Notify

If deploy reports customer email list available (via rune-pay /admin/emails), flag for notification.

Output Format

Commit Mode

(): 

[optional body — bullet summary if > 5 files changed]

[BREAKING CHANGE: description — if breaking change detected]

PR Mode

Title: :  (/

Examples: feat/jwt-refresh, fix/123-login-crash, refactor/auth-module

Changelog Mode

## [Unreleased]

### Added
- Feature description (#PR)

### Fixed
- Bug fix description (#PR)

### Changed
- Change description (#PR)

Release Mode

## Release: v
- **Tag**: v
- **Commits**: [count] since last release
- **Changelog**: [path to CHANGELOG.md]
- **GitHub Release**: [URL]
- **Artifacts**: version bump, changelog, tag, release

Constraints

1. MUST use conventional commit format — no freeform messages
2. MUST analyze full diff before generating message — don't guess from file names alone
3. MUST detect breaking changes — missing BREAKING CHANGE footer causes downstream issues
4. MUST NOT use --no-verify — if hooks fail, report and fix
5. MUST NOT force push unless explicitly requested by user
6. PR mode MUST analyze ALL commits on branch, not just the latest
7. MUST respect project's existing commit conventions if detected (check recent git log)

Sharp Edges

| Failure Mode | Severity | Mitigation | |---|---|---| | Commit message doesn't match actual changes | HIGH | Step 1 reads full diff, not just file names | | PR description covers only last commit | HIGH | Step 1 reads ALL commits on branch | | Missing breaking change detection | HIGH | Check: removed exports, changed function signatures, schema changes | | Branch name too long or has special characters | LOW | Max 50 chars, kebab-case only | | Force push without user consent | CRITICAL | Constraint 5: never force push unless explicitly requested | | Ignoring project's existing conventions | MEDIUM | Check recent git log --oneline -10 for existing style |

Done When

Commit Mode

• Staged diff analyzed and change type classified
• Scope extracted from file paths
• Semantic commit message generated (subject + body if needed)
• Breaking changes detected and flagged
• Commit executed (or failure reported)

PR Mode

• All branch commits analyzed (not just latest)
• Summary covers full change set
• Test plan included
• PR created with gh pr create

Branch Mode

• Branch name follows convention
• Branch created from current HEAD

Changelog Mode

• All commits since last tag grouped by type
• Formatted as Keep a Changelog
• PR/issue references linked

Cost Profile

~500-2000 tokens input, ~200-800 tokens output. Haiku — git operations are mechanical and convention-based, no deep reasoning needed.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Rune-kit
• Source: Rune-kit/rune
• License: MIT

Install and usage instructions live in the source repository linked above.