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

# Рабочий процесс

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

TAUSIK рассчитан на работу в паре: инженер пишет в свободной форме, ИИ-агент
интерпретирует и выполняет. Никаких специальных команд запоминать не нужно —
просто описывайте что хотите сделать.

## Типичный рабочий день

### Утро: начало работы

Напишите агенту:

```
начинай работу
```

Агент откроет сессию, покажет что было сделано в прошлый раз, какие задачи в работе,
и предложит чем заняться. Если есть незавершённые задачи — предложит продолжить.

### Работа над задачей

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

```
добавь тёмную тему в настройки пользователя
```

Агент создаст задачу, сформулирует критерии приёмки и начнёт работу.

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

```
давай спланируем миграцию с REST на GraphQL
```

Агент создаст задачу с детальным планом, разобьёт на шаги,
оценит сложность и предложит начать.

### Проверка и завершение

Когда работа сделана:

```
готово, проверь и сохрани
```

Агент проверит код по 28-пунктному контрольному списку, прогонит тесты и quality gates,
убедится что все критерии приёмки выполнены, и предложит зафиксировать изменения.

### Конец дня

```
на сегодня всё
```

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

## Два режима работы

### Быстрый (для мелких задач)

```
Инженер: "начинай работу"             → /start (открывает сессию)
Инженер: "исправь ошибку с JWT"        → /plan (создаёт задачу, планирует)
Инженер: "готово"                      → /ship (проверяет, фиксирует)
```

### Полный (для сложных задач)

```
Инженер: "начинай"                     → /start (контекст, метрики)
Инженер: "спланируй рефакторинг API"   → /plan (задача + план + AC)
Инженер: "приступай"                   → /task (QG-0, начало работы)
  ... работа, прогресс, тупики ...
Инженер: "проверь код"                 → /review (28-пунктный контрольный список)
Инженер: "прогони тесты"              → /test
Инженер: "закрывай и сохраняй"         → /ship (QG-2, quality gates, фиксация)
Инженер: "на сегодня всё"             → /end (метрики, передача контекста)
```

## Quality Gates

TAUSIK автоматически проверяет качество в двух точках:

**При старте задачи (QG-0):**
- Цель задачи сформулирована
- Критерии приёмки записаны — и что-то говорят: шаблоны (`<...>`, `[UPPER]`, `{{...}}`), нераскрытый `$(...)`, TODO/TBD, пустая таблица и «работает корректно» удаляются до подсчёта; меньше 3 слов цели или 5 слов критериев — отказ
- **Блокирует** если в критериях нет негативного сценария (ошибка, отказ, некорректный ввод)
- Предупреждает для задач безопасности (авторизация, оплата, персональные данные) без критериев безопасности
- Предупреждает если не определена область изменений (что менять / что не трогать)

**При завершении задачи (QG-2):**
- Каждый критерий приёмки проверен с доказательством
- Все шаги плана выполнены
- Тесты проходят (pytest, ruff, и другие проверки по стеку)
- Предупреждает если не задокументированы знания

Эти ворота нельзя обойти — агент не сможет начать работу без цели
и не сможет закрыть задачу без проверки.

### Когда quality gates блокируют

**QG-0 блокирует старт задачи:**
- Нет цели → добавьте: `task update <slug> --goal "..."`
- Нет критериев приёмки → добавьте: `task update <slug> --acceptance-criteria "..."`
- Цель или AC — заглушка («the acceptance criteria have 0 word(s) of substance») → напишите, что проверяется и как
- Нет негативного сценария в AC → добавьте критерий вроде «Возвращает ошибку при невалидном вводе»
- Сессия выше порога совета — это совет, а не отказ: сохраните состояние через `/checkpoint` или передайте работу через `/end`
- Бюджет host thread отделён от времени сессии. Native-сигналы Codex по ответам/input/context на advisory автоматически сохраняют checkpoint и дают промпт нового окна; hard запрещает продолжение. Повторное открытие TAUSIK в том же host thread не сбрасывает бюджет. Отсутствующий native usage показывается как unavailable и работает fail-open.

**QG-2 блокирует закрытие задачи:**
- AC не проверены → залогируйте: `task log <slug> "AC verified: 1. ... ✓ 2. ... ✓"`
- Тесты падают → исправьте код, тесты запустятся автоматически при следующем `task done`
- Шаги плана не завершены → отметьте: `task step <slug> <N>` или обновите план

Агент обрабатывает большинство ситуаций автоматически. Если quality gate блокирует — агент сообщит, что именно не хватает и как исправить.

## Хуки — автоматический контроль

Помимо quality gates, TAUSIK использует хуки Claude Code для контроля в реальном времени:

- **Нет кода без задачи** — попытка редактировать файл без активной задачи блокируется
- **Фильтр опасных команд** — `rm -rf`, `DROP TABLE`, `git reset --hard` блокируются
- **Отправка в репозиторий только через /ship** — прямой `git push` блокируется
- **Автоформатирование** — код форматируется автоматически после каждого изменения (ruff, prettier, gofmt)

Подробнее: **[Хуки](/ru/docs/hooks)**

## Память проекта

TAUSIK сохраняет знания между сессиями. Агент автоматически:

- **Записывает решения** — почему выбрали bcrypt, а не argon2
- **Документирует тупики** — что пробовали и почему не сработало
- **Фиксирует закономерности** — формат ошибок API, соглашения об именовании
- **Передаёт контекст** — передача для следующей сессии

Эти знания загружаются при каждом `/start` и `/task` — агент не повторяет
ошибки предыдущих сессий.

## Метрики

TAUSIK автоматически считает:

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

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

## Работа нескольких агентов

TAUSIK поддерживает одновременную работу нескольких ИИ-агентов над одним проектом:

- **Захват задач** — `task claim <slug>` блокирует задачу за конкретным агентом. Другие видят её как занятую и берут другую. `task unclaim <slug>` снимает блокировку.
- **Без конфликтов** — каждый агент работает над своей захваченной задачей. `task next --agent <id>` атомарно захватывает и запускает лучшую свободную задачу.
- **Параллельная запись** — база SQLite работает в режиме WAL (Write-Ahead Logging), поэтому несколько агентов могут читать и писать одновременно без блокировок.
- **Общие знания** — все агенты используют одну память проекта, решения и тупики. Что узнал один агент — сразу видят остальные.

Специальной настройки не требуется. Просто запустите несколько сессий агентов в одной директории проекта.

## Что дальше

- **[Хуки](/ru/docs/hooks)** — автоматический контроль: блокировка, фильтр команд, автоформатирование
- **[Навыки](/ru/docs/skills)** — полный список того, что умеет агент
- **[CLI-команды](https://github.com/Kibertum/tausik-core/blob/v1.11.0/docs/ru/cli.md)** — если хотите управлять TAUSIK из терминала
- **[Архитектура](/ru/docs/architecture)** — как устроен фреймворк внутри
