AGENTS.md

Цей репозиторій призначений для тривалої роботи агента з написання коду. Мета — не максимізувати обсяг коду. Мета — залишити репозиторій у стані, в якому наступна сесія зможе продовжити роботу без жодних здогадок.

Робочий процес запуску

Перш ніж писати код:

1. Підтвердіть робочу директорію командою pwd.
2. Прочитайте claude-progress.md, щоб дізнатися про останній верифікований стан і наступний крок.
3. Прочитайте feature_list.json і оберіть незавершену функцію з найвищим пріоритетом.
4. Перегляньте останні коміти командою git log --oneline -5.
5. Запустіть ./init.sh.
6. Виконайте необхідну smoke-перевірку або наскрізну верифікацію, перш ніж розпочинати нову роботу.

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

Правила роботи

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

Обов'язкові артефакти

• feature_list.json: єдине джерело істини щодо стану функцій
• claude-progress.md: журнал сесій і поточний верифікований стан
• init.sh: стандартний шлях запуску та верифікації
• session-handoff.md: необов'язкова компактна передача стану для великих сесій

Визначення завершеності

Функція вважається завершеною лише тоді, коли виконані всі наступні умови:

• цільова поведінка реалізована
• необхідна верифікація дійсно запущена
• докази зафіксовані у feature_list.json або claude-progress.md
• репозиторій залишається готовим до перезапуску зі стандартного шляху запуску

Завершення сесії

Перш ніж закінчити сесію:

1. Оновіть claude-progress.md.
2. Оновіть feature_list.json.
3. Зафіксуйте будь-який невирішений ризик або блокер.
4. Зробіть коміт з описовим повідомленням, коли робота перебуває у безпечному стані.
5. Залиште репозиторій достатньо чистим, щоб наступна сесія могла одразу запустити ./init.sh.