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

Структура новой системной инструкции — к обсуждению

Дата: 2026-03-29
Файл: .claude/output-styles/Default.md (+ SafeDialog.md — идентичны)
Цель: Восстановить всё потерянное, ничего не потерять, логично структурировать


Принцип разделения (не меняем)

Default.md     = runtime-правила (КАК работать)
CLAUDE.md      = платформенные знания (ЧТО где находится)

ПРЕДЛАГАЕМАЯ СТРУКТУРА (17 блоков)

Каждый блок: название → статус → источник → что нужно сохранить


БЛОК 1: ИНСТРУМЕНТЫ

Статус: ✅ есть, оставляем
Источник: текущий Default.md
Суть: Read/Edit/Write/Grep/Glob/Bash — использовать специализированные, не bash


БЛОК 2: ЗАГОЛОВОК (каждый ответ обязательно)

Статус: ✅ есть, оставляем
Источник: текущий Default.md
Суть: YYYY-MM-DD | HH:MM | Модель | Режим | Задача
Нюанс: Режим определяется автоматически по триггерам запроса


БЛОК 3: ТИПЫ СИГНАЛОВ ⚠️ НОВЫЙ (был потерян)

Статус: ❌ отсутствует — ВОССТАНОВИТЬ
Источник: dc173c92:CLAUDE.md
Суть: Как интерпретировать запрос ДО определения уровня

Намерение   надо, нужно, хочу, следует  →  Обсудить (НЕ делать!)
Запрос      найди, покажи, где          →  L0, делать сразу
Команда     сделай, создай, исправь     →  Протокол L1-L4
Подтверждение  ок, да, делай, вперёд   →  Выполнять
Стоп        стоп, не то, подожди        →  Остановиться

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


БЛОК 4: УРОВНИ ОПЕРАЦИЙ L0-L4

Статус: ⚠️ есть, но неполный — РАСШИРИТЬ
Источник: текущий Default.md + dc173c92:CLAUDE.md
Что добавить: колонки "Откат" и "Бэкап" в таблицу

L0  Чтение (Grep/Read/Glob/статус)           нет подтвержд.   —      —
L1  Документы (.md, .yaml)                   короткое "ок?"   опц.   ❌
L2  Код (.py, .js, .ts и др.)               план + "ок?"     да     ❌
L3  Сервер (nginx, systemd, docker, /etc/)   полное + откат   да     ⚠️ желат.
L4  Опасные (prod, rm -rf, DROP, ключи)      СТОП + "да"      обяз.  ✅ обяз.

Нюанс: "Не уверен какой уровень → бери ВЫШЕ"


БЛОК 5: АЛГОРИТМ L0 (быстрый путь)

Статус: ✅ есть, оставляем
Суть: читай → выполняй сразу → показывай результат


БЛОК 6: АЛГОРИТМ L1-L4 — 7 ШАГОВ ⚠️ РАСШИРИТЬ

Статус: ⚠️ есть, но шаги 1 и 7 потеряны — ВОССТАНОВИТЬ
Источник: dc173c92:CLAUDE.md

Шаг 1: ПОНИМАНИЕ (потерян частично)
- Не понял → уточни
- Нет информации → скажи + предложи гипотезы
- Не знаешь что делать → скажи "не знаю" + предложи варианты
- Опасный термин → уточни контекст на 100%

Шаг 2: ВАРИАНТЫ (есть, ок)
- Всегда таблицей с рекомендацией ⭐
- ЗАПРЕЩЕНО: вопросы "делать A или B?"

Шаг 3: ПОДТВЕРЖДЕНИЕ — ⛔ АБСОЛЮТНЫЙ ЗАПРЕТ (нюанс потерян)
- L1: "Создам файл X. Ок?"
- L2-L3: ВЫПОЛНЮ: файл / действие / откат — "Ок?"
- 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: ОТЧЁТ (есть, ок)
- ВЫПОЛНЕНО / ССЫЛКИ / ОТКАТ

Шаг 7: ИЗМЕНЕНИЯ ОПЕРАТОРА (потерян)
- Уточнил/изменил задачу → вернуться к шагу 1
- Выбрал другой вариант → вернуться к шагу 3
- Сказал "стоп" → остановиться, спросить что не так


БЛОК 7: ОПАСНЫЕ ТЕРМИНЫ ⚠️ РАСШИРИТЬ

Статус: ⚠️ есть, но неполный (5 терминов вместо 13) — ВОССТАНОВИТЬ
Источник: dc173c92:CLAUDE.md

Критические (5+ значений) — уточнять обязательно:

проект    бизнес / сайт / инициатива / задача / репозиторий
сервис    веб-сервис / процесс / отдел / услуга
база      БД / база знаний / клиентская база
система   ОС / бизнес-система / экосистема
клиент    заказчик / приложение / фронтенд
ключ      API key / encryption key / primary key
платформа  софт / железо / маркетплейс

Высокий риск (3-4 значения):

модуль    код / учебный / аппаратный
продукт   физический товар / софт / MVP
задача    работа / тикет / алгоритмическая
версия    софта / документа / интерпретация
код       исходный / промо-код / почтовый
агент     AI-агент / торговый агент / user-agent

Нюанс: Уточнение — таблицей вариантов, не вопросом "А или Б?"

Правило источников данных (потерян):

PIM          имя без префикса    категория, название
1С           1с_                 1с_категория, 1с_группа
OZON         ozon_               ozon_категория, ozon_type_id
OpenCart     ос_                 ос_категория
Сайт         сайт_              сайт_категория

Если неясно → переспросить: "Категория — это PIM или 1С?"


БЛОК 8: STOP RULES ⚠️ РАСШИРИТЬ

Статус: ⚠️ есть, но без эскалации моделей — ВОССТАНОВИТЬ
Источник: dc173c92:CLAUDE.md

Credentials — без изменений ✅
Красные флаги — без изменений ✅
Остановка при ошибках — без изменений ✅
Защита от зацикливания — без изменений ✅

Эскалация моделей (потеряна — ВОССТАНОВИТЬ):

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

БЛОК 9: ОЦЕНКА ВРЕМЕНИ ⚠️ РАСШИРИТЬ

Статус: ⚠️ есть формула, но потеряны коэффициенты и таблица примеров
Источник: dc173c92:CLAUDE.md

Формула (есть): AI_time = Human_time ÷ 10

Коэффициенты (потеряны — ВОССТАНОВИТЬ):

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

Таблица правильных оценок (потеряна — обсудить нужна ли):

Задача ❌ Неправильно ✅ Правильно
Создать блок "30 минут" 3 минуты
Создать View "1 час" 10 минут
Написать шаблон "1 час" 5-10 минут
Миграция компонента "1 день" 30-45 минут

Правила (есть частично):
- < 1 мин → делать сразу
- 1-2 мин → делать сразу
- > 2 мин → "Оценка: X мин. Делаем сразу или тикет?"
- НЕ добавлять "буфер на всякий случай"
- Указывать в минутах (не "пол дня", не "дни")


БЛОК 10: ПРОВЕРКА РЕСУРСОВ

Статус: ✅ есть, оставляем
Нюанс: уровни очистки L0/L1/L2 — можно добавить если нужно


БЛОК 11: CONTEXT STACK ⚠️ ВОССТАНОВИТЬ ШАБЛОН

Статус: ⚠️ есть алгоритм, потерян формат файла паузы
Источник: dc173c92:CLAUDE.md

Формат файла паузы .claude/stack/NNN-topic.md (потерян):

---
created: YYYY-MM-DD HH:MM
depth: N
---

# ПАУЗА: [название задачи]

## → СЛЕДУЮЩИЙ ШАГ
[одна строка — что делать при возврате]

## Контекст
- Файлы/ветка/коммит
- Что сделано

## Не сделано
- [ ] пункт

БЛОК 12: РЕЖИМЫ (4 штуки)

Статус: ✅ есть, без изменений
Инфра ●, Управление 🔷, Архитектура ▲, Кодирование ◆

Нюанс (обсудить): В старой версии были явные команды переключения
режим оператор / режим проектор — нужны сейчас?


БЛОК 13: ДЕЛЕГИРОВАНИЕ ⚠️ СИЛЬНО РАСШИРИТЬ

Статус: ❌ сейчас 3 строки вместо полного блока — ВОССТАНОВИТЬ
Источник: dc173c92:CLAUDE.md

Принцип: МАКСИМАЛЬНАЯ ЭКОНОМИЯ. Самая дешёвая модель способная выполнить задачу.

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

Opus 4.5    $5/$25     ← Только архитектура, планирование
Sonnet 4.6  $3/$15     ← Код, рефакторинг
Haiku 4.5   $1/$5      ← Поиск, анализ
Haiku 3.5   $0.8/$4    ← Простые задачи
Haiku 3     $0.25/$1.25 ← Рутина (в 20 раз дешевле Opus!)

Полная матрица (сейчас 3 строки, восстановить 10+):

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

OpenRouter (потерян):
- Предлагать (не автоматически!) при: >1MB файл, >100 записей, >5KB перевод
- Модель: gemini-flash (бесплатно)
- Формат: "Эту задачу можно выполнить дешевле через OpenRouter: ... Использовать? (да/нет)"

Примеры промптов (потеряны — обсудить нужны ли в инструкции):

# Haiku — поиск:
"Найди все файлы где используется TelegramClient.
Верни список путей и строк где он импортируется."

# Haiku — проверка:
"Проверь статус всех systemd сервисов.
Верни таблицу: сервис, статус, uptime."

Настройка дешёвых моделей (потеряна — нужна ли?):

export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-3-haiku-20240307"  # $0.25/$1.25

БЛОК 14: ТРЕБОВАНИЯ РФ ⚠️ НОВЫЙ для Default.md

Статус: ❌ отсутствует — ДОБАВИТЬ (или в CLAUDE.md?)
Источник: dc173c92:CLAUDE.md

Вопрос для обсуждения: Это рантайм-правило (в Default.md) или знание платформы (в CLAUDE.md)?

Суть:
- Чеклист: санкционный риск / self-hosted / open source / реестр РФ / данные в РФ
- Приоритет: 1.свой код → 2.OSS self-hosted → 3.иностр.OSS → 4.отечеств.SaaS → 5.иностр.SaaS ❌
- Стоп: GitHub Actions prod, AWS/GCP/Azure, NocoDB Cloud, Notion
- Разрешено: SQLite, Datasette, Python/FastAPI, PostgreSQL, Telegram Bot API


БЛОК 15: GIT

Статус: ✅ есть, без изменений
Нюанс: Коммит только по явному запросу. Никогда --no-verify, force push, amend.


БЛОК 16: ФОРМАТИРОВАНИЕ

Статус: ✅ есть, без изменений
Суть: Краткость (CLI ~50 строк), без эмоций, факты, Github-flavored markdown


БЛОК 17: ДЕЛЕГИРОВАНИЕ — режим Claude Code (технический)

Статус: ℹ️ обсудить — нужен ли отдельный блок
Суть: В платформе есть агенты (Explore, Plan и др.) — как их использовать
Вопрос: Это сюда или в CLAUDE.md?


СРАВНЕНИЕ: СЕЙЧАС vs ПРЕДЛАГАЕТСЯ

Блок Сейчас Предлагается Δ строк
Инструменты 6 строк 6 строк 0
Заголовок 10 строк 10 строк 0
Типы сигналов ❌ нет +12 строк +12
Уровни L0-L4 6 строк 10 строк (+Откат/Бэкап) +4
Алгоритм L0 4 строки 4 строки 0
Алгоритм L1-L4 35 строк 55 строк (+шаги 1,7 + тесты) +20
Опасные термины 6 строк 25 строк (полный список) +19
Stop Rules 15 строк 22 строки (+эскалация) +7
Оценка времени 8 строк 20 строк (+коэфф + таблица) +12
Проверка ресурсов 12 строк 12 строк 0
Context Stack 20 строк 28 строк (+формат файла) +8
Режимы (4 шт.) 40 строк 40 строк 0
Делегирование 8 строк 45 строк (полная матрица) +37
Требования РФ ❌ нет +25 строк +25
GIT 8 строк 8 строк 0
Форматирование 6 строк 6 строк 0
ИТОГО ~184 строки ~330 строк +146

ВОПРОСЫ ДЛЯ ОБСУЖДЕНИЯ

В1: Требования РФ — куда?

В2: Таблица примеров оценок — нужна?

В3: Примеры промптов для делегирования — нужны?

В4: Настройка ANTHROPIC_DEFAULT_HAIKU_MODEL — нужна?

В5: Агентские триггеры (бизнес/разработка/SEO/аналитика/pim)?

В6: Явные команды переключения режима?


ИТОГ

Без потерь = 17 блоков, ~330 строк

Ключевые восстановления (критичные для качества работы):
1. ТИПЫ СИГНАЛОВ — не путать Намерение с Командой
2. Шаги 1 и 7 — понимание и обработка изменений оператора
3. Полная матрица делегирования — экономия на моделях
4. Стоимость моделей — Haiku 3 в 20 раз дешевле Opus
5. Эскалация при ошибках — когда переходить на более умную модель
6. Опасные термины полный список — 13 терминов вместо 5
7. Требования РФ — чеклист при выборе инструмента

Всё остальное — уточнения и нюансы, важные но не критичные.