Provide advice on consolidating AI instruction files

[Copilot]

User raised concern about root directory clutter from multiple AI instruction files (.clinerules, .cursorrules, .windsurfrules, AGENT.md, CLAUDE.md, GEMINI.md, etc.).

Response provided

Suggested three approaches for consolidating AI instruction files:

1. Dedicated directory (.ai/ or .agents/) - Move all AI instruction files to a single location
2. .github/ consolidation - Treat as GitHub config, create .github/ai-instructions/ subdirectory
3. Dotfile unification - Convert all to dotfiles for reduced visibility

Recommended option 1 for cleaner root directory and centralized management, with caveat to verify AI tools support non-standard paths.

No code changes made - awaiting user decision on preferred approach.

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[hakatashi]

@copilot I saw your comment... but, AI coding tools requires specific file name and structure for instruction files. for example, CLAUDE.md should be in the project's root directory to be discovered from Claude Code CLI tool.

[Copilot]

@copilot I saw your comment... but, AI coding tools requires specific file name and structure for instruction files. for example, CLAUDE.md should be in the project's root directory to be discovered f...

その通りですね。各AIツールが特定のファイル名と配置を要求する場合、統合は難しいです。

その場合、現状のまま受け入れるか、以下の妥協案が考えられます:

1. ドキュメントで整理: README.mdにAI指示ファイルのセクションを追加し、各ファイルの目的を明記する
2. .gitignoreの活用: 開発者個人用の設定ファイル(.cursorrulesなど)は.gitignoreに追加してリポジトリから除外する
3. 命名規則の統一: 可能な範囲で、プレフィックスやサフィックスを統一する(例: AI_* または *.ai.md)

ただし、各ツールの仕様上の制約があるため、完全な解決は難しそうです。現実的には、ルートディレクトリに複数のAI指示ファイルが存在することを許容するのが最も実用的かもしれません。