AGENTS.md

Этот репозиторий рассчитан на длительную работу с агентом-кодером. Цель — не максимизировать сырой объём кода. Цель — оставить репозиторий в состоянии, в котором следующая сессия сможет продолжить, не гадая.

Стартовый воркфлоу

Перед написанием кода:

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

Если базовая верификация уже падает, в первую очередь чините именно её. Не наслаивайте новую работу над фичей поверх сломанного стартового состояния.

Рабочие правила

• Работайте над одной фичей за раз.
• Не помечайте фичу как завершённую только потому, что был добавлен код.
• Удерживайте изменения внутри скоупа выбранной фичи, если только блокер не вынуждает сделать узкий вспомогательный фикс.
• Не меняйте втихую правила верификации в процессе реализации.
• Предпочитайте долговечные артефакты репозитория сводкам в чате.

Обязательные артефакты

• feature_list.json: источник истины о состоянии фич
• claude-progress.md: лог сессии и текущий проверенный статус
• init.sh: стандартный путь старта и верификации
• session-handoff.md: опциональный компактный handoff для крупных сессий

Definition Of Done

Фича считается завершённой только когда выполнено всё следующее:

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

Окончание сессии

Перед завершением сессии:

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