refactor: remove all Claude references — this is a GitHub Copilot blueprint

Remove CLAUDE.md, .claude/ directory, and Claude agent format references
from all 10 affected files. This repository is exclusively focused on
GitHub Copilot customizations for VS Code.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: trsdn

.github/agents/copilot-customization-builder.agent.md

@@ -11,7 +11,7 @@ You help create and evolve GitHub Copilot and VS Code customization artifacts:
 
 - Custom agents (`.agent.md`)
 - Prompt files (`.prompt.md`) invoked with `/...`
-- Custom instructions (`.github/copilot-instructions.md`, `*.instructions.md`, optional `AGENTS.md`, optional `CLAUDE.md`)
+- Custom instructions (`.github/copilot-instructions.md`, `*.instructions.md`, optional `AGENTS.md`)
 - Agent Skills (`.github/skills/<name>/SKILL.md`) for portable, specialized capabilities
 - Hooks (`.github/hooks/*.json`) for lifecycle automation
 - MCP server configurations (`mcp.json`) and related guidance
@@ -93,14 +93,13 @@ Frontmatter guidelines:
 - Workspace-wide: `.github/copilot-instructions.md`
 - File-pattern scoped: `*.instructions.md` with `applyTo: '<glob>'`
 - Optional: `AGENTS.md` for repository-level guidance (often used by coding agents)
-- Optional: `CLAUDE.md` for cross-tool compatibility with Claude Code
 
 ### Agent Skills
 
 Agent Skills are portable folders of instructions, scripts, and resources that AI agents can load when relevant.
 
-- Project skills: `.github/skills/<skill-name>/SKILL.md` (recommended), `.claude/skills/`, or `.agents/skills/`
-- Personal skills: `~/.copilot/skills/<skill-name>/SKILL.md` (recommended), `~/.claude/skills/`, or `~/.agents/skills/`
+- Project skills: `.github/skills/<skill-name>/SKILL.md`
+- Personal skills: `~/.copilot/skills/<skill-name>/SKILL.md`
 
 SKILL.md frontmatter:
 
@@ -133,7 +132,7 @@ Skills work across VS Code, Copilot CLI, and Copilot coding agent (portable, ope
 
 Hooks execute shell commands at key lifecycle points during agent sessions. They provide deterministic, code-driven automation.
 
-- Configuration files: `.github/hooks/*.json` (workspace), `~/.claude/settings.json` (user)
+- Configuration files: `.github/hooks/*.json` (workspace)
 - Agent-scoped hooks: define in agent frontmatter `hooks:` field (preview, requires `chat.useCustomAgentHooks`)
 - Hook events: `SessionStart`, `UserPromptSubmit`, `PreToolUse`, `PostToolUse`, `PreCompact`, `SubagentStart`, `SubagentStop`, `Stop`
 - Hooks communicate via stdin (JSON input) and stdout (JSON output)

.github/copilot-instructions.md

@@ -17,7 +17,6 @@ Copilot agents, prompt files, instructions, skills, and hooks in any project.
 - Skill files: `SKILL.md` in a named directory under `.github/skills/<name>/`
 - Hook configs: JSON files in `.github/hooks/` defining lifecycle automation
 - Use `user-invocable` and `disable-model-invocation` instead of the deprecated `infer` field
-- For cross-tool compatibility, also support `CLAUDE.md` and `.claude/` locations
 
 ## File Structure
 

.github/prompts/copilot-new-agent.prompt.md

@@ -62,14 +62,6 @@ When done, list the created file path and how to select the agent in the VS Code
 
 > **Deprecated:** `infer` is deprecated. Use `user-invocable` and `disable-model-invocation` instead.
 
-## Claude agent format (alternative)
-
-VS Code also supports the Claude agent format in `.claude/agents/`:
-- Uses plain `.md` files (not `.agent.md`)
-- `tools` is a comma-separated string (e.g., `"Read, Grep, Glob, Bash"`) instead of YAML array
-- Supports `disallowedTools` as comma-separated string
-- VS Code maps Claude tool names to corresponding VS Code tools
-
 ## Reference docs
 
 - Custom agents (VS Code): https://code.visualstudio.com/docs/copilot/customization/custom-agents

.github/prompts/copilot-new-instructions.prompt.md

@@ -24,8 +24,6 @@ VS Code supports multiple types of instructions files:
 | `.github/copilot-instructions.md` | Workspace root | All chat requests |
 | `*.instructions.md` | `.github/instructions/` or user profile | File-pattern scoped via `applyTo` |
 | `AGENTS.md` | Workspace root (or subfolders with experimental setting) | All agents in workspace |
-| `CLAUDE.md` | Workspace root, `.claude/`, or `~/.claude/` | Cross-tool compatibility |
-
 ## Requirements
 
 1. Create the file at the appropriate location:
@@ -56,12 +54,6 @@ If working with multiple AI agents, consider using `AGENTS.md` at the workspace
 - Applies to all chat requests in workspace
 - Experimental: Enable `chat.useNestedAgentsMdFiles` for subfolder-specific instructions
 
-## CLAUDE.md (cross-tool compatibility)
-
-For cross-tool compatibility with Claude Code:
-- `CLAUDE.md` at workspace root, `.claude/CLAUDE.md`, or `~/.claude/CLAUDE.md`
-- Enable with `chat.useClaudeMdFile` setting
-- VS Code also detects `.claude/rules` folder for instructions files
 
 When done, explain:
 - How this file interacts with `.github/copilot-instructions.md`

.github/skills/copilot-compatibility-checker/SKILL.md

@@ -100,7 +100,7 @@ When diagnosing issues, consult these sources for the latest information:
 | Agent Skills | `chat.useAgentSkills` | 1.108 | Stable |
 | Project skills (`.github/skills/`) | `chat.useAgentSkills` | 1.108 | Stable |
 | Personal skills (`~/.copilot/skills/`) | `chat.useAgentSkills` | 1.108 | Stable |
-| Alt skill locations (`.claude/skills/`, `.agents/skills/`) | `chat.useAgentSkills` | 1.108 | Stable |
+| Alt skill locations (`.agents/skills/`) | `chat.useAgentSkills` | 1.108 | Stable |
 | Custom skill locations | `chat.agentSkillsLocations` | 1.108 | Stable |
 
 ### Hooks (Lifecycle Automation)
@@ -109,7 +109,6 @@ When diagnosing issues, consult these sources for the latest information:
 |---------|---------|---------------|--------|
 | Workspace hooks (`.github/hooks/`) | `chat.hookFilesLocations` | Preview | **Preview** |
 | Agent-scoped hooks (frontmatter) | `chat.useCustomAgentHooks` | Preview | **Preview** |
-| Claude-compatible hooks (`.claude/settings.json`) | `chat.hookFilesLocations` | Preview | **Preview** |
 
 ### Agent Plugins
 
@@ -119,14 +118,6 @@ When diagnosing issues, consult these sources for the latest information:
 | Plugin marketplaces | `chat.plugins.marketplaces` | Preview | **Preview** |
 | Local plugins | `chat.plugins.paths` | Preview | **Preview** |
 
-### CLAUDE.md / Claude Compatibility
-
-| Feature | Setting | Since Version | Status |
-|---------|---------|---------------|--------|
-| `CLAUDE.md` instructions | `chat.useClaudeMdFile` | Stable | Stable |
-| `.claude/agents/` format | Auto-discovered | Stable | Stable |
-| `.claude/rules/` instructions | `chat.instructionsFilesLocations` | Stable | Stable |
-
 ### Prompt Files
 
 | Feature | Setting | Since Version | Status |
@@ -182,7 +173,6 @@ Check if the required files exist in the correct locations:
 | Agent Skills | `.github/skills/*/SKILL.md` |
 | Hook configs | `.github/hooks/*.json` |
 | AGENTS.md | Root or subfolders |
-| CLAUDE.md | Root, `.claude/`, or `~/.claude/` |
 
 ## Common Issues
 
@@ -238,7 +228,6 @@ Enable all experimental features:
   "chat.customAgentInSubagent.enabled": true,
   "chat.mcp.enabled": true,
   "chat.useCustomAgentHooks": true,
-  "chat.useClaudeMdFile": true,
   "chat.plugins.enabled": true,
   "chat.autopilot.enabled": true,
   "chat.mcp.discovery.enabled": true,

.github/skills/copilot-setup-audit/SKILL.md

@@ -59,7 +59,6 @@ Check for correct directory structure:
 | `.github/copilot-instructions.md` | Workspace-wide coding guidelines | **High** |
 | `.github/instructions/*.instructions.md` | File-type specific rules | Medium |
 | `AGENTS.md` (root) | Multi-agent workspace instructions | Optional |
-| `CLAUDE.md` (root, `.claude/`, `~/.claude/`) | Cross-tool compatibility | Optional |
 
 #### Instruction Quality Checks
 
@@ -85,8 +84,8 @@ Check for correct directory structure:
 
 #### Agent File Checks
 
-- [ ] All agents have `.agent.md` extension (or `.md` in `.claude/agents/`)
-- [ ] Agents are in `.github/agents/` directory (or `.claude/agents/` for Claude format)
+- [ ] All agents have `.agent.md` extension
+- [ ] Agents are in `.github/agents/` directory
 - [ ] YAML frontmatter is valid
 - [ ] `description` is present and descriptive
 - [ ] `name` is set (recommended)
@@ -189,9 +188,6 @@ Consider creating skills for:
 | Location | Scope |
 |----------|-------|
 | `.github/hooks/*.json` | Workspace (shared with team) |
-| `.claude/settings.json` | Workspace (Claude compatibility) |
-| `.claude/settings.local.json` | Local only (not committed) |
-| `~/.claude/settings.json` | User (all workspaces) |
 | Agent frontmatter `hooks:` | Agent-scoped (preview) |
 
 ### 7. Settings Configuration
@@ -218,7 +214,6 @@ Check for recommended settings:
   "chat.useNestedAgentsMdFiles": true,
   "chat.customAgentInSubagent.enabled": true,
   "chat.useCustomAgentHooks": true,
-  "chat.useClaudeMdFile": true,
   "chat.plugins.enabled": true,
   "chat.autopilot.enabled": true,
   "chat.mcp.discovery.enabled": true
@@ -240,8 +235,6 @@ Check for recommended settings:
 |------------|------------|
 | `.github/chatmodes/*.chatmode.md` | `.github/agents/*.agent.md` |
 | `*.instructions.md` at repo root | `.github/instructions/*.instructions.md` |
-| `.claude/skills/` | `.github/skills/` (recommended) |
-| `~/.claude/skills/` | `~/.copilot/skills/` (recommended) |
 
 #### Deprecated Settings
 

.github/skills/copilot-skill-builder/SKILL.md

@@ -22,10 +22,6 @@ Agent Skills are folders containing a `SKILL.md` file plus optional scripts, exa
 |------|----------|----------|
 | Project skills | `.github/skills/<skill-name>/` | Shared with the repository |
 | Personal skills | `~/.copilot/skills/<skill-name>/` | Private to your machine |
-| Alt project | `.claude/skills/<skill-name>/` | Cross-tool compatibility |
-| Alt project | `.agents/skills/<skill-name>/` | Cross-tool compatibility |
-| Alt personal | `~/.claude/skills/<skill-name>/` | Cross-tool compatibility |
-| Alt personal | `~/.agents/skills/<skill-name>/` | Cross-tool compatibility |
 
 ## SKILL.md file format
 

.vscode/settings.json

@@ -6,8 +6,7 @@
     "*.prompt.md": "markdown",
     "*.instructions.md": "markdown",
     "SKILL.md": "markdown",
-    "AGENTS.md": "markdown",
-    "CLAUDE.md": "markdown"
+    "AGENTS.md": "markdown"
   },
   "files.exclude": {
     "**/.git": true,

CHANGELOG.md

@@ -28,7 +28,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - feat: add hooks support — new `/copilot-new-hook` prompt template for lifecycle automation
 - feat: add agent plugins documentation across all skills
-- feat: add CLAUDE.md cross-tool compatibility support
 - feat: add `argument-hint`, `user-invocable`, `disable-model-invocation` fields to skill-builder
 - feat: add hooks section to setup-audit, compatibility-checker, and customization-selector skills
 

README.md

@@ -195,10 +195,6 @@ For **multi-agent** workspaces, consider:
 
 - `AGENTS.md` at the workspace root (enable with `chat.useAgentsMdFile` setting)
 
-For **cross-tool compatibility** with Claude Code:
-
-- `CLAUDE.md` at the workspace root (enable with `chat.useClaudeMdFile` setting)
-
 ## Keeping your repositories in sync
 
 Once you've integrated this blueprint into your projects, you can keep them updated using one of these strategies: