AIMarketly — AIM AI Marketplace
git-workflow logo

git-workflow

git workflow

netresearch/git-workflow-skill265installs23starsAutomation

SKILL.md

Full skill instructions

Git Workflow Skill

Critical Rules (Non-Negotiable)

  1. No direct push to main — always open a PR.
  2. No merge before all threads resolved — see references/pull-request-workflow.md.
  3. No squash unless asked — preserves atomic commits, signatures, bisection.
  4. No "tested/verified/working" without pasted command output — else say so.
  5. No edits to installed skill/plugin cache paths (~/.claude/skills/, ~/.claude/plugins/cache/, **/.bare/**) — always the repo worktree, verified by pwd.
  6. Force-push only with --force-with-lease — never plain --force.
  7. Commit before rebase — add → commit → fetch → rebase → push. Dirty tree aborts rebase.
  8. No editorializing — state what changed, not how good it is; no narrating expected results or self-praise. See references/no-editorializing.md.

See references/pull-request-workflow.md for merge-gate and atomic-commit patterns.

Reference Files

Load on demand:

ReferenceContent Triggers
references/commit-conventions.mdConventional commits, DCO sign-off
references/pull-request-workflow.mdDefault-branch check, PR merge, merge gate, signed rebase
references/ci-cd-integration.mdWatching CI from the CLI, git mirror repositories
references/advanced-git.mdRebase, cherry-pick, bisect, stash, worktrees, reflog, recovery
references/github-releases.mdPointer to the github-release skill
references/git-hooks-setup.mdHook frameworks, detection, hooks per stage
references/claude-code-hooks.mdClaude Code settings.json hooks — merge gate, cache-path rejection, auto-lint
references/code-quality-tools.mdshellcheck, shfmt, git-absorb, difftastic
references/merge-gate-watcher.mdMerge-driver loop, check taxonomy, stale-SHA rerun, review-bot rounds
references/spec-cleanup.mdKeep planning artifacts off the base branch; guard + capture-to-ADR
references/no-editorializing.mdWriting without self-praise or narrating the expected

Conventional Commits

<type>[scope]: <description>

Types: feat (MINOR), fix (PATCH), docs, style, refactor, perf, test, build, ci, chore, revert

Breaking change: Add ! after type or BREAKING CHANGE: in footer.

Branch Naming

feature/TICKET-123-description
fix/TICKET-456-bug-name
release/1.2.0
hotfix/1.2.1-security-patch

Hook Detection

Detect hooks first:

ls lefthook.yml .lefthook.yml captainhook.json .pre-commit-config.yaml .husky/pre-commit 2>/dev/null || echo "No hooks"

Install: lefthook install | composer install | npm install | pre-commit install

Critical Release Rules

  1. Immutable releases: deleted releases block tag reuse; bump version.
  2. Multi-branch releases: Use --latest=false from non-default branches.
  3. Pre-release: Version bumped, CI green, CHANGELOG updated, git pull BEFORE gh release create.

PR Merge Requirements

Before merging: threads resolved, CI green (incl. annotations), rebased, signed. Rebase-only + signed: git merge --ff-only.

Verification

./scripts/verify-git-workflow.sh /path/to/repository

Contributing: https://github.com/netresearch/git-workflow-skill