Merge pull request #43 from adambullmer/ai-agent-discoverability-12131984314782127933

✨ feat: Add AI agent discoverability configuration files

Author: adambullmer

.cursorrules

@@ -0,0 +1 @@
+AGENTS.md

.gemini/GEMINI.md

@@ -0,0 +1 @@
+../AGENTS.md

.gemini/extensions/semantic-commit-emoji/gemini-extension.json

@@ -0,0 +1,6 @@
+{
+  "name": "semantic-commit-emoji",
+  "description": "Guidelines and style rules for authoring semantic commit messages with emojis, and instructions for staging and splitting commits deterministically.",
+  "version": "1.0.0",
+  "instructions": "Review the semantic-commit-emoji skill instructions located at .github/skills/semantic-commit-emoji/SKILL.md before creating commits or staging and splitting commits."
+}

.github/copilot-instructions.md

@@ -0,0 +1 @@
+../AGENTS.md

SKILL.md …ub/skills/semantic-commit-emoji/SKILL.mdSKILL.md renamed to .github/skills/semantic-commit-emoji/SKILL.md SKILL.md renamed to .github/skills/semantic-commit-emoji/SKILL.md

@@ -1,3 +1,8 @@
+---
+name: semantic-commit-emoji
+description: Guidelines and style rules for authoring semantic commit messages with emojis, and instructions for staging and splitting commits deterministically.
+---
+
 # semantic-commit-emoji
 
 This skill provides guidelines and style rules for authoring commit messages using the `semantic-commit-emoji` convention.
@@ -7,15 +12,15 @@ This convention builds upon the original Conventional Commits specification by a
 
 As an AI agent, you should read and refer to the following extended documents based on these specific conditions:
 
-- **[Conventional Commits Spec](./skills/reference/conventional-commits.md)**
+- **[Conventional Commits Spec](../../../skills/reference/conventional-commits.md)**
   - Read this if you are unfamiliar with the foundational structure of a conventional commit (e.g., `<type>[optional scope]: <description>`).
   - Read this if you need to understand how to correctly format a `BREAKING CHANGE` footer or body.
 
-- **[semantic-commit-emoji Style Rules](./skills/reference/semantic-commit-emoji-style.md)**
+- **[semantic-commit-emoji Style Rules](../../../skills/reference/semantic-commit-emoji-style.md)**
   - Read this **every time** you are preparing to write a commit message to ensure you select the correct commit `<type>` and corresponding emoji.
   - Read this if you need guidance on subject casing, motivation bodies, or issue referencing specific to this project's style.
 
-- **[Staging and Splitting Commits](./skills/reference/staging-and-splitting.md)**
+- **[Staging and Splitting Commits](../../../skills/reference/staging-and-splitting.md)**
   - Read this if you have modified multiple files or made multiple distinct types of changes (e.g., a bug fix and a refactor) and need to create atomic commits.
   - Read this if you need to understand the deterministic order for staging commits.
   - Read this if you need to split changes within a single file using `git add -p`.

AGENTS.md

@@ -0,0 +1,7 @@
+# Agent Instructions
+
+This repository uses the `semantic-commit-emoji` convention for committing code, as well as specific rules for staging and splitting commits.
+
+Whenever you are about to create a commit, or stage and split commits, you MUST first review the `semantic-commit-emoji` skill instructions.
+
+The skill instructions are located at: `.github/skills/semantic-commit-emoji/SKILL.md`

CLAUDE.md

@@ -0,0 +1 @@
+AGENTS.md

GEMINI.md

@@ -0,0 +1 @@
+AGENTS.md

README.md

@@ -49,6 +49,22 @@ The list of current message types and their used emoji
 | chore    | :wrench: `:wrench:`                             |
 | types    | :label: `:label:`                               |
 
+## AI Agent Discoverability
+
+If you are using AI agents like Claude, Cursor, GitHub Copilot, or Gemini, this repository includes built-in configurations that allow these tools to discover and automatically adhere to the `semantic-commit-emoji` convention.
+
+By cloning or referencing this repository's configurations, your AI assistants will automatically read the canonical skill file located at `.github/skills/semantic-commit-emoji/SKILL.md` when preparing commits.
+
+The following agents are natively supported:
+
+- **GitHub Copilot**: Uses `.github/copilot-instructions.md`
+- **Cursor**: Uses `.cursorrules`
+- **Claude / Claude Code**: Uses `CLAUDE.md`
+- **Gemini**: Uses `GEMINI.md`, `.gemini/GEMINI.md`, and is registered as a CLI extension via `.gemini/extensions/semantic-commit-emoji/gemini-extension.json`
+- **Generic Agents**: Uses standard `AGENTS.md`
+
+No further action is required; once your AI agent is operating within the workspace directory, these files automatically steer its commit messages into full compliance with `semantic-commit-emoji`.
+
 ## Installation
 
 This can either be a global module if this is just a personal preference, or a project one, so that you may enforce consistency on all contributors.