---
name: live-runner
description: Запуск скриптов, серверов, тестов, билдов на лету. Реалтайм-мониторинг, точечная остановка процессов, отладка по ходу выполнения. Триггеры: «запусти», «прогони», «проверь», «почини», «останови», «посмотри логи», «на ходу», «реалтайм», «realtime», «на лету», «мониторь», «отслеживай», «проверяй в процессе».
---

# Live Runner — запуск и управление процессами на лету

## Контекст

ИИ не ждёт. Запускает скрипты/серверы/тесты/билды сразу. Мониторит вывод в реальном времени. Ловит ошибки, чинит, перезапускает. Точечно останавливает процессы по PID/имени.

## Алгоритм

### 1. Запуск
- `run_shell_command` — нужный скрипт/команда
- `is_background: true` — серверы, watchers, долгие процессы
- `is_background: false` — одноразовые команды (тесты, линтеры, билды)
- `timeout` — явно указывай для долгих операций

### 2. Мониторинг
- Читай вывод **по ходу**, не после завершения
- Отслеживай: ошибки, порты, утечки памяти, краши, зависания
- При background-процессах — периодически проверяй статус

### 3. Остановка
- `kill <PID>` — конкретный процесс по PID
- `pkill -f <pattern>` — по имени/паттерну
- `tmux kill-pane` / `kill-session` — при tmux-воркерах
- НЕ убивай всё подряд — точечно

### 4. Отладка на лету
1. Ошибка → читай логи
2. Диагноз → находишь причину
3. Фикс → правишь код/конфиг
4. Перезапуск → повторяешь проверку
5. Цикл до успеха

### 5. Прогон тестов/линтеров/билдов
- Всегда после изменений
- Упал тест → фикс → rerun
- Не пропускай, не надейся «на глаз»

### 6. Фиксация паттернов
Успешно отладил процесс? → запиши в скилл:
- Как запускать X
- Что мониторить
- Как останавливать
- Типичные баги и их фиксы

## Триггеры

«запусти», «прогони», «проверь», «почини», «останови», «посмотри логи», «на ходу», «реалтайм», «realtime», «на лету», «мониторь», «отслеживай», «проверяй в процессе»

## Примеры

✅ **Правильно:**
```
run_shell_command: "npm run dev", is_background: true
→ мониторю вывод
→ вижу ошибку порта 3000
→ kill PID, меняю порт, перезапуск
→ проверка — работает
```

❌ **Неправильно:**
```
run_shell_command: "npm run dev", is_background: true
→ жду 5 минут
→ «сервер запущен» (не проверил вывод, он упал)
```

## Ссылки
- AGENTS.md правило #18