С приходом AI-агентов в репозиториях начали появляться файлы: AGENTS.md, CLAUDE.md, GEMINI.md, COPILOT.md, CURSOR.md и другие.

Почти всегда они содержат одинаковые инструкции:

• правила кодстайла
• архитектурные ограничения
• команды сборки
• соглашения по Compose / Kotlin / Android

Один и тот же текст копируется в несколько файлов и начинает расходиться – в одном файле обновили инструкцию, в другом забыли. Агенты начинают работать по разным правилам.

Решение этого безобразия – использовать симлинки.

Что такое симлинк

GitHub показывает симлинки синим цветом и иконкой ссылки.

Симлинк (symbolic link) – это специальный файл-ссылка на другой файл.

CLAUDE.md -> AGENTS.md
GEMINI.md -> AGENTS.md

Физически инструкция хранится только в AGENTS.md. Остальные файлы являются ссылками на него.

Почему это удобно

Один источник истины:

AGENTS.md

Все агенты читают один и тот же документ, поэтому инструкции не дублируются, не расходятся между разными файлами и проще поддерживаются. В итоге Claude, Gemini и другие агенты работают по одинаковым правилам.