From b8df5ead653c8f01d3a3a3bac51a86f8b21346de Mon Sep 17 00:00:00 2001
From: Baiheng Xie <874256269@qq.com>
Date: Sun, 8 Feb 2026 17:08:25 +0800
Subject: [PATCH 1/2] feat: update Claude Compatibility Bridge section

---
 .clinerules                     | 5 +++++
 .cursorrules                    | 5 +++++
 .github/copilot-instructions.md | 5 +++++
 AGENTS.md                       | 5 +++++
 README.md                       | 5 ++++-
 5 files changed, 24 insertions(+), 1 deletion(-)

diff --git a/.clinerules b/.clinerules
index fea94bb..c230a74 100644
--- a/.clinerules
+++ b/.clinerules
@@ -10,6 +10,11 @@ This file provides guidance to any coding agent when working with code in this r
 
 [@CONTRIBUTIONS.md](/CONTRIBUTIONS.md)
 
+## Discovery
+- Skills live in `.claude/skills/*/SKILL.md` and should be loaded only on demand.
+- Agents live in `.claude/agents/*.md` and should be used when task intent matches.
+- Command templates live in `.claude/commands/*.md` and should be fetched when needed.
+
 ## Output Rules (Most Important)
 
 ### Prohibited Unnecessary Output
diff --git a/.cursorrules b/.cursorrules
index fea94bb..c230a74 100644
--- a/.cursorrules
+++ b/.cursorrules
@@ -10,6 +10,11 @@ This file provides guidance to any coding agent when working with code in this r
 
 [@CONTRIBUTIONS.md](/CONTRIBUTIONS.md)
 
+## Discovery
+- Skills live in `.claude/skills/*/SKILL.md` and should be loaded only on demand.
+- Agents live in `.claude/agents/*.md` and should be used when task intent matches.
+- Command templates live in `.claude/commands/*.md` and should be fetched when needed.
+
 ## Output Rules (Most Important)
 
 ### Prohibited Unnecessary Output
diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md
index fea94bb..c230a74 100644
--- a/.github/copilot-instructions.md
+++ b/.github/copilot-instructions.md
@@ -10,6 +10,11 @@ This file provides guidance to any coding agent when working with code in this r
 
 [@CONTRIBUTIONS.md](/CONTRIBUTIONS.md)
 
+## Discovery
+- Skills live in `.claude/skills/*/SKILL.md` and should be loaded only on demand.
+- Agents live in `.claude/agents/*.md` and should be used when task intent matches.
+- Command templates live in `.claude/commands/*.md` and should be fetched when needed.
+
 ## Output Rules (Most Important)
 
 ### Prohibited Unnecessary Output
diff --git a/AGENTS.md b/AGENTS.md
index fea94bb..c230a74 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -10,6 +10,11 @@ This file provides guidance to any coding agent when working with code in this r
 
 [@CONTRIBUTIONS.md](/CONTRIBUTIONS.md)
 
+## Discovery
+- Skills live in `.claude/skills/*/SKILL.md` and should be loaded only on demand.
+- Agents live in `.claude/agents/*.md` and should be used when task intent matches.
+- Command templates live in `.claude/commands/*.md` and should be fetched when needed.
+
 ## Output Rules (Most Important)
 
 ### Prohibited Unnecessary Output
diff --git a/README.md b/README.md
index 9f1cda3..69c1a41 100644
--- a/README.md
+++ b/README.md
@@ -35,6 +35,8 @@ For Claude Code, configure agent behaviors in `.claude/` directory:
 - **Commands** (`.claude/commands/*.md`) - Slash commands for subagents: `/review`, `/plan`, `/refactor`, `/tdd`
 - **Subagents** (`.claude/agents/*.md`) - Specialized agents for code review, planning, refactoring
 
+Built-in slash commands and automatic skill discovery in `.claude/*` are currently Claude Code-only behaviors.
+
 Inspired by [everything-claude-code](https://github.com/affaan-m/everything-claude-code), few patterns were summarized to help you better utilize Claude for coding a backend project.
 
 ### Backend
@@ -117,7 +119,6 @@ The compose files read environment variables from the repository root `.env` fil
 
 This repo keeps a single source of truth for agent rules in `AGENTS.md`, and syncs it to:
 
-- `CLAUDE.md`
 - `.clinerules`
 - `.cursorrules`
 - `.github/copilot-instructions.md`
@@ -130,6 +131,8 @@ just agent-rules-sync
 
 The `pre-commit` hook `agent-rules` runs the same check on commit.
 
+For Codex, Cline, Cursor, and GitHub Copilot, `.claude` slash-command execution and skill auto-discovery are not built-in.
+
 ## Usage Examples
 
 ### Structured Logging

From 1158766e2681119fca5ed7670f416a7429f8cf01 Mon Sep 17 00:00:00 2001
From: Baiheng Xie <874256269@qq.com>
Date: Sun, 8 Feb 2026 17:08:33 +0800
Subject: [PATCH 2/2] feat: add agent rules sync step to CI workflow

---
 .github/workflows/ci.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 9a4e6bb..7521f60 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -41,6 +41,9 @@ jobs:
       - name: Sync dependencies
         run: uv sync --dev
 
+      - name: Agent rules synced
+        run: uv run --frozen scripts/agent_rules.py check
+
       - name: Ruff check
         run: uv run --frozen ruff check .