git-workflow

Enforces approval-gated git commit, push, branching, and PR workflows with Conventional Commits.

1|Updated Apr 3, 2026
One-click install
npx skills add https://github.com/TierOne-Studio/spa-velocity --skill git-workflow-tierone-studio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: git-workflow
Source: https://github.com/TierOne-Studio/spa-velocity/tree/main/.ruler/skills/git-workflow
Command: npx skills add https://github.com/TierOne-Studio/spa-velocity --skill git-workflow-tierone-studio

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It prevents accidental or unauthorized git mutations—such as pushes to main, force-pushes on shared branches, or AI-attributed commits—by enforcing a strict approval protocol and consistent commit conventions. ## Core Features & Use Cases - Approval-gated mutations: Requires explicit user approval before commits, pushes, branch creation, merges, rebases, tags, and destructive operations like reset --hard. - Branch protection: Hard-blocks all writes to main/master and mandates a typed branching model (feat/, fix/, chore/, refactor/, docs/, test/, perf/, ci/). - Conventional Commits and PR format: Standardizes commit messages, PR titles, and PR bodies with What/Why/How verified/Risk sections, and bans AI-attribution trailers. - Use Case: When an assistant is asked to commit and push a bug fix, it first outputs an impact summary covering branch, files changed, remote impact, reversibility, and collaborators, then waits for the user to reply "approve" before executing. ## Quick Start Ask the assistant to commit the current changes on a new fix branch and push it, and it will present an impact summary and wait for your approval before running any git command.

Frequently Asked Questions about git-workflow

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I commit and push changes safely with an AI assistant?

Request the commit or push and the assistant outputs an impact summary covering branch, files changed, remote impact, reversibility, and collaborators. The git command only executes after you reply "approve", "yes", or "go ahead".

What commit message format does this git workflow enforce?

It enforces Conventional Commits: type(scope) followed by an imperative summary under 72 characters, with the body explaining why rather than what. Examples include feat(rbac): scope=all contract and fix(projects): exclude unready sources.

Can the assistant push directly to main or master?

No. Writes to main or master are hard-blocked at the tool boundary by permissions.deny patterns with no exceptions. Changes reach main only through a user-created hotfix branch and pull request that the user approves themselves.

Which git operations do not require approval?

Read-only operations run freely: git status, log, diff, show, blame, fetch, stash list, branch listing, and gh pr or issue view, list, and diff. Any state-changing command requires explicit approval first.

Why are AI attribution trailers banned from commit messages?

The workflow prohibits Co-Authored-By Claude lines, Generated with Claude Code footers, and similar AI-attribution in commits, PRs, and release notes. The git author is the human user, and this rule overrides any tool default that would inject such trailers.