mint-commit

Enforce standardized git commit and promotion workflows with branch and merge rules.

Updated Jan 25, 2026
One-click install
npx skills add https://github.com/MINT-IA/MINT --skill mint-commit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mint-commit
Source: https://github.com/MINT-IA/MINT/tree/main/.claude/skills/mint-commit
Command: npx skills add https://github.com/MINT-IA/MINT --skill mint-commit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enforces a consistent, auditable git commit and promotion workflow so contributors avoid broken releases, diverging histories, and unsafe repository changes.

Core Features & Use Cases

  • Branch flow enforcement: mandates feature/* and hotfix/* branching patterns and forbids direct pushes to staging or main.
  • Commit and PR standards: requires conventional commit messages with scopes, Co-Authored-By attribution, and pre-commit test verification.
  • Promotion rules and merge strategies: defines promotion PR bases and uses squash merges for feature→dev and merge commits for dev→staging and staging→main to preserve SHAs.
  • Use Case: A mobile engineer preparing a feature branch runs tests, commits with the prescribed format, opens a PR to dev, and relies on the workflow to promote changes through staging to production safely.

Quick Start

Create a feature branch, run the project test suites until green, commit using the conventional message format including Co-Authored-By, and open a PR to dev following the branch and PR rules.

Frequently Asked Questions about mint-commit

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

FAQPage Schema
How do I enforce a standard git commit and promotion workflow across dev, staging, and main branches?

To enforce a standard git commit and promotion workflow, you mandate feature/* and hotfix/* branching patterns, require conventional commit messages with Co-Authored-By, and use squash merges for feature→dev and merge commits for dev→staging and staging→main. This prevents diverging histories and unsafe repository changes.

What is the correct branch flow and merge strategy for promoting code to staging and production?

The correct branch flow forbids direct pushes to staging or main. It uses squash merges for feature→dev promotion PRs and merge commits for dev→staging and staging→main flows to preserve commit SHAs and ensure an auditable promotion history.

Do I need to run tests before committing changes to a feature or hotfix branch?

Yes, you need to run project test suites until they pass before committing changes. Pre-commit test verification is required to ensure no broken releases occur, and conventional commit messages with scopes and Co-Authored-By attribution must be used.

Can I use force pushes when managing feature and hotfix branches?

No, force pushes are explicitly forbidden when managing feature and hotfix branches. The standardized git commit workflow prescribes specific merge strategies and branch naming conventions to maintain an auditable and safe repository history.

Does this standardized commit workflow require the GitHub CLI?

Yes, this standardized commit workflow requires both git and the GitHub CLI. These tools are necessary to enforce branch naming conventions, execute pre-commit test verification, and create promotion PRs across dev, staging, and main.

What's the best way to prevent broken releases and diverging histories in a git repository?

The best way to prevent broken releases and diverging histories is to enforce a consistent git commit workflow with conventional commit messages, pre-commit test verification, no force pushes, and prescribed merge strategies like squash merges for feature branches.