Imported from artdealer13/Magnolia-Studio (AGENTS.md). Install upstream with npx skills add artdealer13/Magnolia-Studio. Copyright stays with the author.

AGENTS.md — Строгий регламент для AI-агентов

Этот файл обязателен для любого агента, который вносит изменения в проект.

1) Scope Lock

Перед работой зафиксируй:

• цель задачи (1-2 предложения),
• список файлов, которые можно менять,
• критерий готовности (что должно быть зелёным).

Если по ходу нужно выйти за scope — сначала согласовать с пользователем.

2) Zero-Hallucination Protocol

• Не придумывать несуществующие функции/эндпоинты/файлы.
• Любой вывод о проекте делать только после чтения кода.
• Если данных недостаточно — спросить, а не додумывать.

3) Safety Gates (обязательно)

• Для изменений в app/language_detector.py, app/synthesis.py или app/tts_service.py:
  • сначала тест-кейс (или обновление существующего),
  • затем код,
  • затем ./scripts/safe_check.sh.
• Для изменений сегментации mixed:
  • обновить tests/data/mixed_golden_cases.json при изменении ожидаемых цепочек,
  • убедиться, что tests/test_mixed_golden_set.py проходит.
• Для изменений маршрутов API (tts_service.py):
  • обновить или создать тест в tests/test_api.py.

4) Minimal Diff Rule

• Только целевые правки.
• Не трогать стиль/формат несвязанных файлов.
• Не объединять в один PR несвязанные изменения.
• Запрещён over-engineering: никаких новых слоёв/абстракций/зависимостей без прямого запроса.

4.1) Red Zone: language_detector.py, synthesis.py и tts_service.py

Для этих трёх модулей действует усиленный режим:

• Только bugfix или строго запрошенное поведение, без «улучшений архитектуры».
• Максимально узкий дифф: менять только необходимые строки.
• Любая правка должна быть защищена тестом на конкретный регресс.
• Для tts_service.py: не трогать инициализацию/зависимости; изменения только маршрутов или обработки ошибок.
• Если правка тянет «цепочку улучшений» — остановиться и предложить минимальный безопасный вариант.

5) Definition of Done

Задача считается завершённой, только если:

1. выполнены критерии пользователя,
2. пройдены нужные тесты/чеки,
3. в отчёте указаны изменённые файлы и результат проверок.

6) Быстрый старт строгого режима

Перед каждой новой задачей вставляй в начало чата готовый префикс:

• prompts/STRICT_CHAT_PREFIX.md

Это снижает риск «творческих» отклонений и фиксирует narrow-scope поведение с первого сообщения.