Existing AI Config Files

How Aspect Code works with your existing AI instruction files.

Supported files

Aspect Code automatically detects and reads these existing AI configuration files:


FileTool
.cursorrulesCursor
CLAUDE.mdClaude Code
.windsurfrulesWindsurf
GEMINI.mdGemini
CONVENTIONS.mdVarious
.github/copilot-instructions.mdGitHub Copilot

When these files exist, Aspect Code reads their content and ensures the generated AGENTS.md complements rather than duplicates what's already there.

How deduplication works

Aspect Code parses your existing instruction files to understand what rules and conventions you've already documented. The generated AGENTS.md then:


  • Skips rules that are already covered in your existing files
  • Adds architecture-level insights that your existing files don't cover (hub modules, blast radius, co-edit clusters)
  • References your existing files so AI assistants know to read them too

  • This means you can adopt Aspect Code without rewriting or abandoning your existing setup.