marketing-shibata50/claude-code-ultimate-guide
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs: add Multi-IDE Configuration Sync pattern (v3.20.9)

Browse source 
Added comprehensive documentation for maintaining consistent AI instructions
across multiple coding tools (Claude Code, Cursor, Copilot, etc.).

Changes:
- guide/ai-ecosystem.md: New "Multi-IDE Configuration Sync" section (L1256-1329)
  - Problem statement with config file comparison table
  - Solution 1: Native @import for Claude Code (recommended)
  - Solution 2: Script-based generation for multi-IDE teams (bash example)
  - AGENTS.md support status clarification + workaround (symlink)
  - Compatibility matrix with external tool references
- machine-readable/reference.yaml: Added 2 index entries
  - ai_ecosystem_multi_ide_sync: guide/ai-ecosystem.md:1256
  - agents_md_support_status: guide/ai-ecosystem.md:1322
- CHANGELOG.md: Documented addition in [Unreleased] section
- VERSION: Bumped from 3.20.8 to 3.20.9 (patch)
- Auto-synced version across README, cheatsheet, ultimate-guide

Total: +91 insertions, -8 deletions (74 lines net content addition)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
Florian BRUNIAUX 2026-02-02 09:04:00 +01:00
parent d5375e32a5
commit 0bb116cd2c
7 changed files with 91 additions and 8 deletions
Download patch file Download diff file Expand all files Collapse all files

74
guide/ai-ecosystem.md
View file

@ -1253,6 +1253,80 @@ Cursor's `.cursor/rules` can mirror your CLAUDE.md:
- Components use render props for flexibility
```
### Multi-IDE Configuration Sync
When your team uses multiple AI coding tools (Claude Code + Cursor + Copilot), maintaining consistent conventions across all tools becomes a challenge.
#### The Problem
| Tool | Config File | Format |
|------|-------------|--------|
| Claude Code | `CLAUDE.md` | Markdown + @imports |
| Cursor | `.cursorrules` | Plain markdown |
| Codex/ChatGPT | `AGENTS.md` | AGENTS.md standard |
| Copilot | `.github/copilot-instructions.md` | GitHub-specific |
**Without sync**: Each file drifts independently → inconsistent AI behavior across tools.
#### Solution 1: Native @import (Recommended for Claude Code)
Claude Code supports `@path/to/file.md` imports natively:
```markdown
# CLAUDE.md
@docs/conventions/coding-standards.md
@docs/conventions/architecture.md
```
**Pros**: Native, no build step, maintained by Anthropic
**Cons**: Cursor/.cursorrules doesn't support @import
#### Solution 2: Script-Based Generation (Multi-IDE Teams)
For teams needing **identical conventions across all IDEs**:
```
docs/ai-instructions/ # Source of truth
├── core.md # Shared conventions
├── claude-specific.md # Claude Code additions
├── cursor-specific.md # Cursor additions
└── codex-specific.md # AGENTS.md additions
↓ sync script (bash/node)
CLAUDE.md = core + claude-specific
.cursorrules = core + cursor-specific
AGENTS.md = core + codex-specific
```
**Example sync script** (bash):
```bash
#!/bin/bash
CORE="docs/ai-instructions/core.md"
cat "$CORE" > CLAUDE.md
echo -e "\n---\n" >> CLAUDE.md
cat "docs/ai-instructions/claude-specific.md" >> CLAUDE.md
cat "$CORE" > .cursorrules
echo -e "\n---\n" >> .cursorrules
cat "docs/ai-instructions/cursor-specific.md" >> .cursorrules
```
**When to use this approach**:
- Team with mixed IDE preferences (Claude Code + Cursor + VS Code)
- Need to enforce identical conventions across all tools
- CI/CD validation of AI instructions
#### ⚠️ AGENTS.md Support Status
**Claude Code does NOT natively support AGENTS.md** ([GitHub issue #6235](https://github.com/anthropics/claude-code/issues/6235), 171 comments, still open as of Feb 2026).
**Workaround**: Symlink `ln -s AGENTS.md .claude/CLAUDE.md`
The AGENTS.md standard is supported by: Cursor, Windsurf, Cline, GitHub Copilot. See [AI Coding Agents Matrix](https://coding-agents-matrix.dev) for full compatibility.
### Export from IDE to Claude
When you need Claude's deeper analysis:

4
guide/cheatsheet.md
View file

@ -6,7 +6,7 @@
**Written with**: Claude (Anthropic)
**Version**: 3.20.8 | **Last Updated**: January 2026
**Version**: 3.20.9 | **Last Updated**: January 2026
---
@ -484,4 +484,4 @@ where.exe claude; claude doctor; claude mcp list
**Author**: Florian BRUNIAUX | [@Méthode Aristote](https://methode-aristote.fr) | Written with Claude
*Last updated: January 2026 | Version 3.20.8*
*Last updated: January 2026 | Version 3.20.9*

4
guide/ultimate-guide.md
View file

@ -10,7 +10,7 @@
**Last updated**: January 2026
**Version**: 3.20.8
**Version**: 3.20.9
---
@ -16438,4 +16438,4 @@ We'll evaluate and add it to this section if it meets quality criteria.
**Contributions**: Issues and PRs welcome.
**Last updated**: January 2026 | **Version**: 3.20.8
**Last updated**: January 2026 | **Version**: 3.20.9