ШІ забуває твій проєкт? Збери короткий пакет контексту

Замість «продовжуй» — зрозумілий стан роботи

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

Пакет контексту — короткий документ, який дає цю опору. Він не додає моделі пам’ять і не гарантує правильного коду. Його завдання — зменшити кількість припущень, які доведеться виправляти.

Що залишити в документі

Опиши мету через дію користувача: «відвідувач знаходить послугу й надсилає заявку». Далі — поточний стан, одна наступна зміна, технічні межі та критерії. Якщо важлива незмінність реєстрації, напиши це прямо й назви сценарії, які потрібно повторно перевірити.

Anthropic описує context engineering як роботу з інформацією, доступною моделі в момент виконання задачі. Корисний контекст — це не просто довша історія: потрібно добирати релевантні інструкції, дані й результати. Наш шаблон нижче адаптує цей принцип до невеликого авторського проєкту.

ПАКЕТ КОНТЕКСТУ ПРОЄКТУ
Мета: [один результат для користувача]
Поточний стан: [що вже працює]
Середовище: [технології/браузер/обмеження]
Завдання цього кроку: [одна зміна]
Не змінювати: [працюючі сценарії]
Релевантні файли або фрагменти: [лише потрібне]
Критерії приймання: [3–5 спостережуваних перевірок]
Дані: [вигадані або знеособлені приклади]
Перед роботою: назви прогалини й важливі припущення.
Після роботи: покажи зміни, виконані перевірки й те, що не вдалося перевірити.
Не оголошуй тест пройденим, якщо ти його не запускав.

Приклад: додати FAQ й не зламати заявку

Мета — допомогти відвідувачу зрозуміти умови ремонту. Поточний стан — односторінковий сайт із працюючою формою. Наступна зміна — чотири запитання, відповіді розкриваються натисканням. Не змінювати — адресу надсилання, поля форми й її повідомлення про успіх.

Критерії: усі запитання доступні з клавіатури; текст не виходить за екран; форму можна заповнити після відкриття FAQ; якщо JavaScript не завантажився, відповіді все одно можна прочитати. Це конкретні спостереження, які легше перевірити, ніж загальне «зроби зручно».

Що не потрібно передавати

Не додавай паролі, API-ключі, приватні листування клієнта або повну базу користувачів. Для помилки форми достатньо знеособленого прикладу та тексту помилки. Якщо файл великий, почни з опису структури й релевантного фрагмента; не вирізай залежності, без яких поведінка незрозуміла.

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

Закривай кожну сесію короткою передачею

Попроси записати: що змінилося, які перевірки виконано, які залишилися, який наступний крок. Перечитай підсумок: помилка в ньому стане помилковим контекстом для наступної розмови. Відмічай рішення з датою, а скасовані вимоги прибирай або явно позначай як застарілі.

Якщо агент каже «перевірив на телефоні», попроси вказати середовище й сценарій. Зміна CSS не є доказом браузерного тесту. Такий підсумок дозволяє продовжити роботу без перебільшених звітів.

Де зберігати

Для маленького проєкту вистачить текстового файла поряд із кодом. Якщо працюєш із Git, зберігай його версії разом зі змінами. Відділяй сталі правила від тимчасового списку справ. Перед наступною задачею актуалізуй документ: давно не оновлений пакет може заважати більше, ніж допомагати.

Джерело й наступний крок

Anthropic: Effective context engineering for AI agents. Шаблон і приклад FAQ підготовлені редакцією. Далі перевір доступи агента або перетвори обсяг робіт на кошторис і завдання.