git-commit

Git Commit & Commit Message (SignNow MCP Server)

Critical rules

• NEVER commit directly to main or master. Always work on a dedicated branch.
• Do not commit unless all required checks pass (see below).
• Keep each commit one logical change (single change type).
• Commit message follows Conventional Commits.

Workflow

1. Create (or switch to) a feature branch — MANDATORY

• NEVER commit to main or master directly.
• If not already on a feature branch, create one:
  • git checkout -b <type>/<short-description> (e.g., feat/add-embedded-editor, fix/token-refresh)
• Branch naming: <type>/<short-description> using the same type vocabulary as commit types.

1. Check what changed

• git status -sb
• If changes are mixed, split into separate commits using git add -p.

1. Review staged diff

• Stage what belongs to this commit.
• Inspect: git diff --cached

1. Run required checks (must be green)

pytest tests/unit/ -v
ruff check src/ tests/
ruff format --check src/ tests/

• If any command fails, fix the issue and rerun all checks.

1. Compose the commit message

Subject format

<type>(<scope>)?: <subject>

Subject rules

• Imperative mood ("Add", "Fix", "Remove", "Prevent", ...)
• No trailing period
• Prefer ≤ 72 chars

Body (optional)

• Explain why, not just what.
• Wrap lines at ~80 chars.

Breaking changes (if applicable)

• Add ! after type/scope: feat!: ... or feat(tools)!: ...

• Add footer:

  • BREAKING CHANGE: <what breaks and migration notes>

1. Commit

• One-liner (no body/footer needed):

  • git commit -m "..."

• Otherwise:

  • git commit and write subject + body in editor.

1. Post-commit sanity

• git show --stat
• Ensure no accidental files were committed.

1. Push

• git push

1. Create Pull Request (if none exists)

• After pushing, check whether a PR already exists for the current branch:
  • Use the GitHub MCP tool (search_pull_requests) to check.
• If no PR exists → create one immediately.