Предложение
Добавить в корень репозитория символическую ссылку AGENTS.md → CLAUDE.md, чтобы агентские инструкции имели один источник истины.
Зачем
Разные агенты ищут инструкции в разных файлах: Claude Code читает CLAUDE.md, а агенты в формате AGENTS (Codex, Kimi, OpenAI-совместимые) — AGENTS.md. Без единого источника содержимое расходится: один файл правят, второй устаревает.
Симлинк AGENTS.md → CLAUDE.md решает это структурно — оба имени указывают на один файл, дрейф невозможен by-design.
Реализация
ln -s CLAUDE.md AGENTS.md
git add AGENTS.md
git commit -m "chore: add AGENTS symlink"
(коммит уже подготовлен локально, но push в этот upstream-репо у меня нет прав — отсюда issue)
Обоснование
Подробный разбор подхода — в публикации: «AGENTS.md и CLAUDE.md — один источник истины для агентской среды»
https://systemsworld.club/t/agents-md-i-claude-md-odin-istochnik-istiny-dlya-agentskoj-sredy/39884
Предложение
Добавить в корень репозитория символическую ссылку
AGENTS.md → CLAUDE.md, чтобы агентские инструкции имели один источник истины.Зачем
Разные агенты ищут инструкции в разных файлах: Claude Code читает
CLAUDE.md, а агенты в формате AGENTS (Codex, Kimi, OpenAI-совместимые) —AGENTS.md. Без единого источника содержимое расходится: один файл правят, второй устаревает.Симлинк
AGENTS.md → CLAUDE.mdрешает это структурно — оба имени указывают на один файл, дрейф невозможен by-design.Реализация
ln -s CLAUDE.md AGENTS.md git add AGENTS.md git commit -m "chore: add AGENTS symlink"(коммит уже подготовлен локально, но push в этот upstream-репо у меня нет прав — отсюда issue)
Обоснование
Подробный разбор подхода — в публикации: «AGENTS.md и CLAUDE.md — один источник истины для агентской среды»
https://systemsworld.club/t/agents-md-i-claude-md-odin-istochnik-istiny-dlya-agentskoj-sredy/39884