AGENTS.md

Правила работы с репозиторием

• docs/ содержит публикуемый контент сайта, а не внутреннюю документацию проекта. Не размещай там технические планы, архитектурные описания, отчёты о работе и инструкции для разработки или эксплуатации проекта.

• Исправляй причину проблемы. Явно указывай на противоречия и логические ошибки.

• Держись согласованной задачи и проверяемого результата. Не расширяй объём работ без обсуждения с пользователем.

• Проверяй фактический код и поведение. Документы в spec/ могут устаревать; они не задают обязательный процесс и не требуют создания новых документов.

• Создавай документацию только когда она помогает выполнить задачу или пользоваться результатом. Существующие документы можно исправлять на месте.

• Работай в основном checkout и отдельной ветке, созданной до первой записи. Worktree и pull request используй только по явному указанию пользователя. Не коммить напрямую в main и не отправляй feature-ветку в удалённый main.

• Сохраняй существующие незакоммиченные изменения, не относящиеся к задаче.

• Выполняй проверки, соответствующие изменению. Перед выпуском проверяй итоговый кандидат тестами и strict build. Повторяй проверки при изменении кандидата или появлении новых оснований, а не ради оформления документов.

• Push выполняй только по явному запросу: push main запускает публикацию. Первичная установка и переключение MCP, изменения production, настроек и доступов требуют отдельного разрешения. После активации разрешённый push допускает обычный rollout через настроенный CI с проверкой и rollback.

• В конце сообщай результат, выполненные проверки и оставшиеся препятствия. Указывай расход токенов, если он доступен; не придумывай точное число.