Skip to content

chore(git-standards): forbid emoji in commits and PR titles#266

Merged
JacobPEvans merged 2 commits intomainfrom
chore/no-emoji-policy
Apr 29, 2026
Merged

chore(git-standards): forbid emoji in commits and PR titles#266
JacobPEvans merged 2 commits intomainfrom
chore/no-emoji-policy

Conversation

@JacobPEvans
Copy link
Copy Markdown
Owner

Summary

  • Add ## Commit & PR Title Style section to git-standards/skills/pr-standards/SKILL.md
  • Add a one-line cross-reference bullet to git-standards/skills/git-workflow-standards/SKILL.md

Problem

Companion to JacobPEvans/ai-assistant-instructions PR #604 (linked below). Until now, neither plugin skill said anything about emoji in commits/PRs, while ai-assistant-instructions' soul.md actively encouraged gitmoji. Result: recent automated AI-fix PRs (#257 `🤖 Fix #256: stale guard test fixtures...`, #263 `🤖 Fix #261: make _is_on_main_branch() mockable...`) landed with 🤖 prefixes.

This PR closes the loop on the plugin side so that whenever an agent loads /pr-standards (the skill that fires precisely when drafting a PR), it sees the no-emoji rule explicitly.

Why both repos

  • soul.md flip alone could be missed by a session that doesn't auto-load it (rare, but possible)
  • pr-standards is loaded on demand at the moment of PR creation — perfect last-line-of-defense
  • git-workflow-standards cross-reference catches commit-message authors who didn't load pr-standards

Scope

  • ✅ Commit messages
  • ✅ PR titles + descriptions
  • ❌ Tooling-enforced commitlint rule (declined for now — this is guidance only; flagged as a future option in the plan)

Test plan

  • Pre-commit hooks pass (markdownlint, agentskills validation, etc.)
  • `grep -rn "no emoji" git-standards/skills/` returns hits in both target files
  • Next `/finalize-pr` or automated AI fix in this repo produces an emoji-free PR title

Related

(claude)

Adds an explicit "Commit & PR Title Style" section to the pr-standards
skill (loaded on demand whenever an agent drafts a PR), and a one-line
cross-reference bullet in git-workflow-standards.

Companion to the soul.md flip in ai-assistant-instructions. Together
these eliminate the gap that caused recent automated AI-fix PRs (#263,
#257) to land with `🤖` prefixes — soul.md was endorsing gitmoji and
neither plugin skill said otherwise.

Applies to human, AI-assisted, and bot-authored PRs alike. Conventional-
commit prefixes carry the signal.

(claude)
Copilot AI review requested due to automatic review settings April 29, 2026 05:16
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds explicit guidance in the git-standards skills to forbid emoji/gitmoji in commit messages and PR metadata, aligning PR drafting behavior with the repo’s conventional-commit style expectations.

Changes:

  • Add a new “Commit & PR Title Style” section to pr-standards that bans emoji/gitmoji and calls for conventional-commit prefixes.
  • Add a cross-reference bullet in git-workflow-standards reinforcing conventional-commit prefixes and no-emoji commit messages.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 3 comments.

File Description
git-standards/skills/pr-standards/SKILL.md Introduces explicit no-emoji guidance for commits/PR titles (and currently PR descriptions) plus conventional-commit prefix guidance.
git-standards/skills/git-workflow-standards/SKILL.md Adds a branch-hygiene bullet that cross-references pr-standards for commit-message style (no emoji + conventional-commit prefixes).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread git-standards/skills/pr-standards/SKILL.md Outdated
Comment thread git-standards/skills/pr-standards/SKILL.md Outdated
Comment thread git-standards/skills/git-workflow-standards/SKILL.md
…hrasing

Addresses copilot review feedback (threads VOoy, VOpG, VOpT) on PR #266.

Changes:
- Rename section header from "Commit & PR Title Style" to
  "Commit, PR Title & PR Description Style" (header now matches body scope)
- Split rule into two parts: emoji ban (commits + titles + descriptions
  + release notes) and conventional-commit prefix requirement (commit
  subjects + PR titles only)
- Replace ambiguous "Use conventional-commit prefixes only" with "are
  required at the start of commit subjects and PR titles only" — the
  original "only" was meant to scope where prefixes apply, but read as
  if the prefix should be the entire message
- Add release notes to the ban for parity with the soul.md update in
  ai-assistant-instructions PR #604

(claude)
Copy link
Copy Markdown

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request updates the git workflow and PR standards to mandate conventional-commit prefixes and prohibit the use of emojis in commit messages and PR titles. A review comment suggests refining the language in the PR standards document to improve clarity for automated tools, specifically replacing idiomatic phrasing with more direct language.

Comment thread git-standards/skills/pr-standards/SKILL.md
@JacobPEvans JacobPEvans merged commit b561a15 into main Apr 29, 2026
8 checks passed
@JacobPEvans JacobPEvans deleted the chore/no-emoji-policy branch April 29, 2026 05:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

2 participants