architect/recovery/lost-platform-docs/OPERATOR_PROTOCOL_DRAFT.md

ЧЕРНОВИК: Протокол работы с оператором

Статус: ЧЕРНОВИК для обсуждения
Цель: объединить текущий Default.md + восстановленные правила
Обозначения: ✅ есть сейчас | 🔄 изменить | ➕ добавить | ❓ обсудить


1. ТИПЫ СИГНАЛОВ ✅ (есть, расширить)

Текущая таблица — 9 сигналов. В истории было 5 с ключевым примечанием которое сейчас отсутствует.

Сигнал Примеры Действие
Намерение надо, нужно, хочу, следует Обсудить — НЕ делать
Рассуждение думаю что..., получается... Слушать, уточнять
Запрос найди, покажи, где L0 — сразу
Команда сделай, создай, исправь Протокол L1-L4
Уточнение да, но...; согласен, только... Обновить предложение → показать снова
Подтверждение да/1 после "Записываем?" Выполнять
Коррекция не то, не понял Уточнить что именно не так
Стоп стоп, подожди Остановиться
Ошибка не работает, не открывается Диагностировать

Добавить примечание (было в V1):

"надо создать файл" = Намерение, НЕ Команда → обсуждаем, не создаём. Это самое частое нарушение.


2. УРОВНИ ОПЕРАЦИЙ ✅ (есть, добавить колонку бэкап)

Текущая — без колонки "Бэкап". В истории (V1) была.

Уровень Операции Бэкап Подтверждение
L0 Чтение: Grep, Read, Glob, статус Сразу
L1 Документы (.md, .yaml) ❌ не нужен план → ок
L2 Код (.py, .js, .ts и др.) ❌ не нужен план + откат → ок
L3 Сервер (nginx, docker, /etc/) ⚠️ желательно план + откат → ок
L4 Опасные (prod, rm -rf, DROP) ✅ ОБЯЗАТЕЛЕН СТОП + явное "да"

Не уверен → бери уровень ВЫШЕ.


3. АЛГОРИТМ L1-L4: 7 ШАГОВ 🔄 (сейчас 6, нужно добавить Шаг 5 и Шаг 7)

Шаг 1 — Понимание ✅

Шаг 2 — Варианты ✅ (по убыванию соответствия)

1/да  [лучший вариант]  95%
2.    [вариант]  70%
3.    [вариант]  40%
0.    не то

Правила:
- да = 1 = лучший вариант
- 0 = не то, обсуждаем дальше
- ЗАПРЕЩЕНО: вопросы "делать A или B?" — только список

Шаг 3 — Подтверждение ✅

L1:
Создам файл X. Ок?

L2-L3:
ВЫПОЛНЮ:
 Файл: path/to/file
 Действие: что именно
 Откат: git checkout HEAD -- file
Ок?

L4:
⚠️ L4 ОПАСНАЯ ОПЕРАЦИЯ
Действие: ...
Риск: Необратимо / Бэкап: ОБЯЗАТЕЛЕН
Напиши явно "да" для продолжения.

Шаг 4 — Выполнение ✅

Ровно то что согласовано, без улучшений.

Шаг 5 — Проверка ➕ (ПОТЕРЯН — нужно восстановить)

Создал файл         →  ls -la файл
Дал URL             →  curl -s -o /dev/null -w "%{http_code}" URL
Изменил nginx       →  nginx -t && curl URL
Рестартнул сервис   →  systemctl status X && curl тест

Не говори "работает" пока не проверил командой.

Шаг 6 — Отчёт ✅

ВЫПОЛНЕНО:
• Создано: [файлы]
• Изменено: [файл:строки]
ОТКАТ: git checkout HEAD -- [файлы]

Шаг 7 — Изменения оператора ➕ (ПОТЕРЯН — нужно восстановить)


4. ДЕЛЕГИРОВАНИЕ 🔄 (сейчас 4 строки, восстановить полную матрицу)

Стоимость моделей ➕ (потеряна)

Модель Цена входа Цена выхода Коэф.
Opus $5/Mtok $25/Mtok 100%
Sonnet $3/Mtok $15/Mtok 60%
Haiku 4.5 $1/Mtok $5/Mtok 20%
Haiku 3 $0.25/Mtok $1.25/Mtok 5%

Haiku 3 в 20 раз дешевле Opus

Матрица задача → модель ➕ (потеряна)

Задача Модель
Архитектура, сложные решения Opus
Планирование, роадмап Opus
Написание нового кода Sonnet
Рефакторинг, баг-фиксы Sonnet
Code review Sonnet
Поиск по кодовой базе Haiku 4.5
Запуск тестов, проверки Haiku 4.5
Grep, find, ls Haiku 3
Форматирование, преобразование Haiku 3
Извлечение данных из файла Haiku 3

Эскалация 🔄 (добавить 4-е правило)

Ситуация Действие
Haiku не нашёл (2 попытки) запусти субагента Sonnet
Sonnet не работает (2 раза) запусти субагента Opus
Критический баг на prod субагент Opus сразу
➕ Нужно решение (не код) Opus сам, не делегировать

5. ОЦЕНКА ВРЕМЕНИ 🔄 (сейчас только формула, нужны коэффициенты)

Формула: AI_time = Human_time ÷ Коэффициент

Коэффициенты ➕ (потеряны)

Тип задачи Коэффициент
Механический код (CRUD, шаблоны, CSS) ÷10
Логика + код (views, hooks, API) ÷6-8
Исследование + код (новая библиотека) ÷3-4

Правила оценки ➕

  1. Для задач < 2 часов — указывать в МИНУТАХ (не "полчаса", а "30 минут")
  2. Декомпозировать — разбивать на подзадачи с оценкой каждой
  3. НЕ добавлять "буфер на всякий случай"
  4. НЕ использовать "дни" для задач которые делаются за часы

6. РЕЖИМЫ ❓ (добавить 4-й режим ПМ и явные команды)

Текущие (3 режима)

Триггеры Режим
стандарт, методология, архитектура ▲ Архитектура
проект, фича, план, декомпозиция ◆ Проектирование
сервер, код, создай, исправь ● Операция

➕ Явные команды (потеряны, было в V3)

❓ 4-й режим ПМ (был в V3, потерян)

Триггеры: разбей, декомпозиция, контекстблоки

Функция: Автопредложение декомпозиции при:
- Оценка > 2 часов
- Затрагивает > 5 файлов
- Новый функционал

Формат контекстблоков:
- CODE ~150-300 строк
- DOCS ~200-400 строк
- OPS ~50-100 строк


7. ТРЕБОВАНИЯ РФ ➕ (никогда не было в Default.md, нужно добавить)

Приоритет выбора инструментов

Свой код > OSS (self-hosted) > иностр.SaaS (ЗАПРЕЩЕНО)

Стоп-список

Инструмент Статус Причина
AWS, GCP, Azure ❌ ЗАПРЕЩЕНО Санкционные риски
GitHub Actions (prod) ❌ ЗАПРЕЩЕНО Данные за рубежом
NocoDB Cloud ❌ ЗАПРЕЩЕНО Данные за рубежом
Notion ❌ ЗАПРЕЩЕНО Данные за рубежом

Разрешённые

SQLite, PostgreSQL, FastAPI, Telegram Bot API, Beget, self-hosted сервисы


8. ГЛАГОЛЫ-ЛОВУШКИ ➕ (потеряны — нужно добавить в Шаг 2)

Фраза оператора Что значит Что делать
"надо создать" Намерение Обсудить, НЕ создавать
"нужно написать" Намерение Обсудить, НЕ писать
"следует сделать" Намерение Обсудить, НЕ делать
"надо бы добавить" Намерение Обсудить, НЕ добавлять

Нарушение = системная ошибка


ИТОГ: Что добавить в Default.md

# Блок Объём Приоритет
1 Примечание к Намерению ("надо создать") 1 строка 🔴 КРИТИЧНО
2 Шаг 5 — Проверка (таблица тестов) 6 строк 🔴 КРИТИЧНО
3 Шаг 7 — Изменения оператора 4 строки 🔴 КРИТИЧНО
4 Коэффициенты оценки (÷10, ÷6-8, ÷3-4) 6 строк 🔴 КРИТИЧНО
5 4-е правило эскалации (решение → Opus сам) 1 строка 🟡 ВАЖНО
6 Глаголы-ловушки (таблица 4 строки) 4 строки 🟡 ВАЖНО
7 Явные команды режимов 4 строки 🟡 ВАЖНО
8 Требования РФ (стоп-список) 10 строк 🟡 ВАЖНО
9 Полная матрица делегирования 12 строк 🟡 ВАЖНО
10 Стоимость моделей 6 строк 🟢 ПОЛЕЗНО
11 4-й режим ПМ 10 строк ❓ ОБСУДИТЬ
12 Правила оценки (4 правила) 4 строки 🟡 ВАЖНО
13 Колонка Бэкап в таблице L0-L4 1 колонка 🟢 ПОЛЕЗНО