[English](/docs/senar) | **Русский**

# Что такое SENAR?

<!-- doc-map: reader=user; zone=getting-started -->

SENAR (Supervised Engineering & Normative AI Regulation) — открытый инженерный стандарт, определяющий как AI-агенты должны работать над программными проектами. Думайте о нём как о строительном кодексе для AI-разработки — набор правил, которые делают работу агента предсказуемой, проверяемой и безопасной.

**Полная спецификация:** [senar.tech](https://senar.tech) | [GitHub](https://github.com/Kibertum/SENAR)

TAUSIK (**Т**ехнический **А**гент **У**нифицированного **С**опровождения, **И**нспекции и **К**онтроля) — эталонная реализация SENAR. Каждое правило, описанное ниже, применяется TAUSIK автоматически — вам не нужно читать спецификацию, чтобы использовать фреймворк.

---

## Какую проблему решает SENAR

ИИ-агенты для программирования мощные, но ненадёжные. Без структуры они:

- Начинают писать код, не определив что значит «готово»
- Заявляют что задача выполнена, не запуская тесты
- Забывают всё между сессиями
- Пробуют один и тот же неработающий подход три раза подряд

AGENTS.md и .cursorrules — это рекомендации, которые агент может проигнорировать. SENAR обеспечивает **принудительный контроль**: жёсткие блокировки, которые физически не дают агенту пропустить шаги.

## Ключевые концепции

### Quality Gates

Два контрольных пункта, которые должна пройти каждая задача:

**QG-0 — Context Gate (перед началом работы):**
- Задача должна иметь чётко сформулированную цель
- Критерии приёмки должны быть записаны — что считается «готово»
- Обязателен хотя бы один негативный сценарий (что происходит при ошибке, некорректном вводе и т.д.)
- Для задач, связанных с безопасностью (авторизация, платежи, персональные данные), выводится предупреждение, если нет критериев безопасности

**QG-2 — Implementation Gate (перед закрытием задачи):**
- Каждый критерий приёмки должен иметь задокументированное подтверждение (вывод тестов, шаги проверки)
- Все шаги плана должны быть выполнены
- Автоматические проверки должны пройти (тесты, линтеры — в зависимости от стека)

Эти quality gates — **жёсткие блокировки**: агент буквально не может продолжить, не выполнив требования. Никакого `--force`, никакого обхода.

> **Почему QG-0 и QG-2, а не QG-1?** Нумерация следует спецификации SENAR: QG-0 срабатывает при старте задачи (до начала работы), QG-2 — при завершении (после всей работы). QG-1 зарезервирован в спецификации для промежуточной проверки, но пока не реализован.

### Управление сессиями

Рабочие сессии имеют структуру:

- **Старт сессии** — загрузка контекста из предыдущей работы (что сделано, что заблокировано, что не сработало)
- **Давление контекста** — время сессии, вызовы с последнего чекпоинта и тишина журнала печатаются советом с измеренным основанием; старт задачи они не блокируют (1.10).
- **Контрольные точки** — периодические снимки контекста, чтобы ничего не потерялось при сбое сессии
- **Конец сессии** — сохранение передачи: что выполнено, что не закончено, какие решения приняты

### Отслеживание тупиков

Когда агент пробует подход и он не работает — он записывает тупик: что пробовали и почему не сработало. В следующей сессии, когда возникает похожая задача, агент видит неудачный подход и не повторяет его.

### Метрики

Шесть метрик отслеживаются автоматически, без ручного ввода:

| Метрика | Что измеряет |
|---------|--------------|
| **Производительность** | Задач завершено за сессию |
| **Доля успеха с первой попытки** | % задач, решённых без повторных заходов |
| **Уровень пропущенных дефектов** | % задач, в которых потом нашли дефект |
| **Время выполнения** | Среднее время от создания задачи до завершения |
| **Доля тупиков** | Доля тупиков относительно общего числа задач |
| **Стоимость задачи** | Среднее время по уровню сложности |

Эти метрики помогают ответить: работает ли агент эффективно или тратит время на повторы и тупики?

## Что вы заметите на практике

При использовании TAUSIK SENAR проявляется так:

1. **Агент всегда спрашивает "что считается готовым?"** перед написанием кода — это QG-0
2. **Агент не может закрыть задачу, просто сказав "готово"** — он должен показать подтверждение по каждому критерию — это QG-2
3. **Начало новой сессии загружает предыдущий контекст** — вы не объясняете проект с нуля
4. **Неудачные подходы запоминаются** — агент не будет пробовать одно и то же сломанное решение дважды
5. **Длинные сессии получают предупреждение** — после 3 часов агент предложит сохранить контрольную точку

## Правила SENAR кратко

| Правило | Что говорит | Как TAUSIK применяет |
|---------|------------|----------------------|
| Rule 1 | Нет кода без задачи | Хук блокирует редактирование файлов без активной задачи |
| Rule 2 | Определить границы задачи | `scope_write_gate`/`bash_write_gate` блокируют запись вне `scope_paths`; QG-0 жёстко блокирует старт medium/complex без scope |
| Rule 3 | Проверять по критериям | QG-0 + QG-2 совместный контроль |
| Rule 4 | Внешнее состязательное ревью | `risk_l3_trigger` блокирует закрытие с тонким доказательством до записи L3-ревью; ревьюер — сепаратный субагент `tausik-external-reviewer` |
| Rule 5 | Контрольный список верификации | Жёсткий гейт для тиров substantial/deep, чьи AC не ссылаются на существующий тест; ниже — эскалирующий warning |
| Rule 6 | Планировать откат | Поле `rollback_plan`: QG-0 блокирует старт medium/complex без плана отката; `task done` предупреждает |
| Rule 7 | Найти первопричину дефектов | Предупреждение если в задаче-дефекте нет первопричины |
| Rule 8 | Фиксировать знания | Предупреждение при закрытии если не записаны решения и закономерности |
| Rule 9.2 | Длительность сессии | Сигнал: совет выше порога `session_max_minutes`, без отказа (1.10) |
| Rule 9.3 | Периодические контрольные точки | Сигнал: счёт вызовов с последнего handoff выводится из журнала, совет выше `checkpoint_calls` |
| Rule 9.4 | Документировать тупики | Специальный инструмент + напоминания в скиллах |
| Rule 9.5 | Периодический аудит | Автопроверка при старте сессии |

> **О правилах 4–6.** С **v1.5** они применяются как жёсткие блокировки: **Rule 4** (внешнее состязательное ревью — сепаратный по модели, read-only субагент гейтит закрытия с тонким доказательством), **Rule 5** (контрольный список верификации — жёсткий гейт для планировочных тиров substantial/deep, совещательный ниже) и **Rule 6** (планирование отката — QG-0 блокирует новые medium/complex-задачи без задокументированного плана отката). Полная таблица enforcement — в [Матрице соответствия SENAR](https://github.com/Kibertum/tausik-core/blob/v1.11.0/docs/ru/senar-compliance-matrix.md).

**Полная матрица соответствия:** [Матрица соответствия SENAR](https://github.com/Kibertum/tausik-core/blob/v1.11.0/docs/ru/senar-compliance-matrix.md)

---

## Что дальше

- **[Быстрый старт](/ru/docs/quickstart)** — настроить TAUSIK за 10-15 минут
- **[Рабочий процесс](/ru/docs/workflow)** — как выглядит типичный рабочий день
- **[Матрица соответствия SENAR](https://github.com/Kibertum/tausik-core/blob/v1.11.0/docs/ru/senar-compliance-matrix.md)** — детальный статус по каждому правилу
