// угода
AGENTS.md
Як Codex має поводитися в цьому репозиторії.
Для користувачів Codex CLI
AGENTS.md каже Codex, як працювати.
Але не що там є.
AGENTS.md встановлює робочу угоду. MCP дозволяє Codex дотягнутися до інструментів. Maguyva — це MCP-сервер, що дає Codex доступну для запитів карту вашого репозиторію, тож перша правка — це не здогадка про структуру файлів.
Тариф Free: 3 репозиторії, До 50 тис. проіндексованих рядків репозиторію, без картки.
AGENTS.md — це угода. MCP — це канал. Maguyva — це карта.Шаруватий стек
Чотири ідеї. У кожної своя робота.
// транспорт
MCP
Як Codex дотягується до зовнішніх інструментів і контексту.
// кодова база
Maguyva
MCP-сервер, що повертає обґрунтовані факти про репозиторій.
// хто платить
Робочі середовища, а не місця
Агенти не платять за місця. Переглянути ціни
AGENTS.md — це робоча угода. Користуйтеся нею.
Постійні інструкції належать у AGENTS.md. Це правильне місце для:
- Команд збірки, тестування й лінту, які має запускати Codex.
- Обмежень “завжди роби X / ніколи не роби Y”, прив'язаних до директорії.
- Конвенцій найменувань і переваг щодо рефакторингу.
- Посилань на канонічні журнали рішень і нотатки з архітектури.
Тримайте це стисло. Обмежуйте область. Комітьте.
Але AGENTS.md ніколи не задумувався як індекс, який можна опитати, для кожного символу, файлу й місця виклику у вашому репозиторії.
Де сам по собі AGENTS.md стає статичним у масштабі
Чотири режими відмови, по одному на картку.
// угоди — це не індекс
Сказати Codex як працювати — не те саме, що сказати що існує. Перша правка в незнайомому пакеті — це здогадка про шляхи файлів і назви функцій. AGENTS.md не може перелічити кожен символ, і ви б цього й не хотіли.
// документ розходиться з кодом
Блок AGENTS.md, що описує топологію ваших черг, правильний, поки хтось не додасть нового споживача. Тепер джерело істини — код, а документ упевнено застарів. Codex читає не той.
// перейменування — це задача для графа
На запитання «що посилається на цей клас?» не відповість markdown-файл. Codex або grep'ає й молиться по всьому монорепозиторію, або просить вас вставити місця виклику в чат.
// вікна контексту не безкоштовні
Напихання AGENTS.md, поки Codex «не знатиме достатньо», з'їдає токени, які мали б піти на міркування. Після кількох кілобайтів ви обмінюєте якість відповіді на обсяг статичного контексту.
Як три шари поєднуються
Користувачі Codex вже мислять у цій формі. Сторінка має зробити це очевидним.
AGENTS.md
угоди
як поводиться Codex
MCP
канал
як він дотягується
Maguyva
факти про кодову базу
що він бачить
- AGENTS.md як Codex поводиться в цьому репозиторії.
- MCP як Codex дотягується до інструментів і контексту. (специфікація)
- Maguyva що бачить Codex, коли ставить запитання кодовій базі. Семантичний, AST, граф і текстовий пошук повертаються зі шляхами до файлів і номерами рядків.
AGENTS.md каже Codex як працювати.
Maguyva дає Codex те, від чого відштовхнутися.
Три робочі процеси
Специфічно для Codex. Обґрунтовано реальним графом викликів, а не grep'ом Codex.
// workflow 01
Перейменуйте спільний клас, спершу знайшовши всі залежні
codex> перейменуй PaymentClient → BillingClient graph::callers(PaymentClient) 12 посилань у 7 пакетах graph::importers(src/payments/client.ts) 9 імпортерів graph::extends(PaymentClient) 2 підкласи (RetryClient, MockClient) → Codex пропонує міграцію з 21 правки з переліком файлів прямо тут. [exit 0]
Codex запитує в Maguyva залежних перед тим, як почати редагувати. Список міграції повертається обґрунтованим реальним графом, а не пам'яттю Codex.
// workflow 02
Знайти реальну реалізацію, а не тестову заглушку
codex> як normalizePhoneNumber обробляє E.164? semantic::query("normalize phone E.164") src/util/phone.ts:88 normalizePhoneNumber() ← реальна реалізація test/util/phone.spec.ts:14 jest.mock(...) ← заглушка [exit 0]
Назви брешуть. Моки затіняють реальний код. Maguyva ранжує реальну реалізацію вище за тестовий мок.
// workflow 03
Перевірте радіус ураження перед рефакторингом
codex> що викликає QueueDispatcher.publish? graph::callers(QueueDispatcher.publish) 3 in src/billing/* 1 in src/audit/* 1 in src/notifications/* [exit 0]
Місця виклику з різних пакетів з'являються прямо в результаті. Diff обґрунтований реальними імпортерами, а не grep'ом Codex.
Налаштування в Codex CLI
Три кроки. Тариф Free: 3 репозиторії, До 50 тис. проіндексованих рядків репозиторію, без картки.
// step 01
Проіндексуйте репозиторій на maguyva.ai
Оберіть той, який добре знаєте, щоб можна було перевірити відповіді.
// step 02
Додайте Maguyva як MCP-сервер у конфігурації Codex
$ export MAGUYVA_API_KEY=mgv_xxxx $ codex mcp add maguyva --url https://maguyva.tools/mcp \ --bearer-token-env-var MAGUYVA_API_KEY # equivalent ~/.codex/config.toml [mcp_servers.maguyva] url = "https://maguyva.tools/mcp" bearer_token_env_var = "MAGUYVA_API_KEY"// step 03
Поставте одне запитання, відповідь на яке вже знаєте
Не починайте одразу з усієї компанії. Почніть з одного репозиторію й одного перевірюваного запитання.