Як заощадити до 90% контексту LLM: Специфікація компактних документів (AI Context Protocol)

💡 Усі статті, обговорення, новини про AI — в одному місці. Приєднуйтесь до AI спільноти!

Кожен розробник, який активно використовує сучасні великі мовні моделі (LLM, як-от Claude, GPT чи Gemini) для програмування у довгих сесіях, рано чи пізно стикається з невидимим, але дуже дорогим бар’єром — «податком на спогади».

Практика показує: коли ви починаєте нову робочу сесію та намагаєтеся ввести ШІ в курс справи, лише одне перше повідомлення з аналізом архітектури та кодової бази може миттєво поглинути понад 25% усього ліміту контекстного вікна. Ші витрачає колосальний обсяг пам’яті не на написання коду чи розв’язання поточної задачі, а на банальне відновлення в пам’яті стану проекту.

Щоб розв’язати цю проблему, було розроблено AI Context Protocol (AIP) — специфікацію компактних технічних документів, оптимізованих спеціально під особливості токенізації та логіку мислення сучасних ШІ-моделей.

Філософія підходу: Навігаційна карта замість коду

Компактні документи для ШІ — це не заміна читання живого коду, а високоточна навігаційна карта. Вони вказують моделі, «що читати і де», позбавляючи її необхідності аналізувати тисячі рядків вихідних файлів.

Протокол базується на трьох основних документах у корені репозиторію:

1. FUNCTION_PASSPORTS_AI.md (Паспорти функцій)

Це суворий сигнатурний реєстр усіх ключових функцій та модулів системи. Для кожної функції фіксується:

• Точна сигнатура мови програмування.
• Діапазон рядків та хэш останнього комміту, що гарантує актуальність інформації.
• Статус працездатності: ✓ (перевірено), ⚠ (потребує актуалізації), ✗ (застаріло).
• Побічні ефекти (теги effects: читання/запис БД, робота з файлами тощо).
• Карта викликів (calls та called_by із зазначенням конкретних рядків у коді).
• Контракт поведінки та формат повернення значення при помилках.

2. ARCHITECTURE_SNAPSHOT_AI.md (Архітектурний знімок)

Цей документ описує глобальну формулу виконання запитів, структуру системного кешу (снапшоту), правила взаємодії шарів системи та суворий перелік заборонених залежностей. ШІ звіряється з цим файлом перед ухваленням будь-яких архітектурних рішень.

3. STATE_INDEX_AI.md та HANDOFF-звіти

Журнал завершення робочих сесій. Кожна сесія завершується фіксацією файлу HANDOFF_YYYY-MM-DDTHH-MM.md, де вказуються змінені контракти, статус верифікації коду та чіткі інструкції для наступної моделі. STATE_INDEX_AI.md акумулює ці зміни у форматі однорядкових індексів для швидкого пошуку рішення, що виключає читання всього довгого прозового журналу розробки.

Завдяки чому досягається покращення роботи ШІ та економія токенів?

1. Гранична щільність змісту (Semantic Density)

Звичайна технічна документація для людей містить занадто багато розмовної мови, вежливих конструкцій та довгих пояснень. ШІ-моделям це заважає.

• Як це працює в AIP: Документи використовують максимально стислі, стандартизовані теги та ASCII-маркери. Наприклад, замість опису «функція робить вибірку з бази даних та не має побічних ефектів» використовується один дешевий тег [DB-R]. ШІ миттєво зчитує сутність за частки мілісекунди.

2. Оптимізація під фізичну токенізацію (ASCII-гігієна)

Токенізатори сучасних LLM (особливо сімейства Claude та GPT) оптимізовані під англійську мову.

• Як це працює в AIP: Специфікація вимагає вести всі компактні документи англійською мовою та використовувати виключно прості символи (наприклад, ✓, ✗, ⚠, →, ←). Оскільки один символ кирилиці або складний Unicode-смайл може кодуватися як 2–4 окремих токени, перехід на чисту англійську та базовий ASCII фізично зменшує вартість передачі інформації у 3–4 рази.

3. Ліниве завантаження контексту (Lazy Loading)

Коли ШІ намагається розібратися, як працює один компонент системи, він починає лавиноподібно відкривати пов’язані файли, швидко забиваючи пам’ять сесії.

• Як це працює в AIP: Завдяки наявності карти викликів (calls та called_by) у паспортах функцій, модель бачить взаємозв’язки компонентів ще до того, як завантажить їхній вихідний код. Модель звертається до живого коду точково — лише коли потрібно внести фізичні зміни.

4. Проектування без галюцинацій завдяки контрактам

Значна частина лімітів повідомлень у чатах витрачається на цикли «спробуй знову»: ШІ генерує код з помилкою -> розробник повертає помилку -> ШІ виправляється.

• Як це працює в AIP: У паспортах функцій чітко задокументовані контракти та обмеження (наприклад, assumes '?' occurs only as a parameter placeholder або поведінка на кшталт fail: [] on execution failure). Модель одразу отримує точні обмеження і створює працездатний та сумісний код з першої спроби, заощаджуючи ваші повідомлення та час.

5. Інкрементні оновлення замість повної перезаписи

Кожна нова сесія розробника отримує не всю історію розробки та гігабайти коду, а лише знімок архітектури, поточний статус та паспорти тих функцій, які були зачеплені останніми змінами.

Ефект від впровадження у цифрах

Висновок

AI Context Protocol змінює ставлення до пам’яті ШІ-асистента, перетворюючи її з бездонного смітника на цінний ресурс, яким можна ефективно керувати. Такий підхід до «гігієни контексту» дозволяє розробникам створювати складні системи у синергії з моделями штучного інтелекту, не втрачаючи фокус у довгих сесіях та заощаджуючи бюджет на використання API.