Исправления в ветке main

This commit is contained in:
2026-10-22 12:42:32 +06:00
parent 933e5ccb58
commit 9b05edc263
31 changed files with 2433 additions and 114 deletions

50
AGENTS.md Normal file
View File

@@ -0,0 +1,50 @@
# Assistant Policy (MUST/SHOULD)
## 1) Scope and change discipline
- MUST вносить только целевые изменения, напрямую связанные с задачей.
- MUST ограничивать правки кодом и необходимыми связанными конфигурациями/ресурсами.
- MUST сохранять совместимость с текущими стилевыми и архитектурными решениями проекта.
- SHOULD выполнять минимально достаточный объём изменений.
- SHOULD избегать рефакторингов вне явного запроса.
## 2) Validation and testing
- MUST NOT запускать автотесты и автоматические проверки по собственной инициативе.
- MUST считать ручное тестирование основным способом валидации по умолчанию.
- MUST выполнять проверки только если:
- они явно запрошены пользователем; или
- они обязательны по локальным правилам установки/подготовки.
- SHOULD запускать только минимально необходимый набор проверок.
## 3) Code clarity
- MUST NOT добавлять комментарии в код без необходимости.
- SHOULD предпочитать понятные имена, прозрачную структуру и читаемые сигнатуры.
## 4) Work process
- MUST перед правками уточнять контекст в существующем коде.
- MUST принимать решения на основе локального контекста проекта, а не общих предположений.
- SHOULD сначала локализовать место изменения, затем вносить правку.
# LeanCTX usage policy
## 5) Tool selection
- SHOULD использовать ctx_tree/ctx_glob для обзора структуры проекта и выбора файлов.
- SHOULD использовать ctx_search для поиска символов и мест использования перед правками.
- SHOULD использовать ctx_read для точечного чтения только релевантных диапазонов.
- SHOULD использовать ctx_shell для команд с потенциально большим выводом.
- MUST использовать нативные инструменты, если LeanCTX не покрывает требуемую операцию.
## 6) Output discipline
- MUST NOT выводить целые файлы/директории, когда достаточно точечного фрагмента.
- SHOULD возвращать из диагностик только ошибки, предупреждения и ближайший релевантный контекст.
- SHOULD не включать полный успешный лог без необходимости.
## 7) Efficiency
- SHOULD группировать независимые чтения/поиски и выполнять их параллельно,
когда это не создаёт конфликтов и уменьшает число итераций.