# Требования к инструментам и план их разработки

**Статус:** проект концепции на 17 сентября 2026 года. Ниже описаны требования и варианты реализации. Наличие работающей системы, коннекторов или промышленного исполнения не заявляется. [HTML-демонстрация](demo.html) служит прототипом для обсуждения; её возможности и ограничения должны быть обозначены в самом интерфейсе.

Связанные материалы: [методология](methodology.md), [состав результата](index.md), [проверка источников и возможностей существующих продуктов](../source-check.md). Конкретная бизнес-модель — экземпляр применения метода, а не сам метод и не программный продукт. Агро, салон и продуктовая работа нужны как контрастные примеры, а не как обязательная последовательность внедрения.

## 1. Предмет инструментария

Инструменты должны помогать создавать, использовать и пересматривать управленческие модели: от постановки вопроса до оценки последствий принятого решения. Минимальность относится к сложности исполнения, а не к исключению части цикла.

Не требуется заранее строить собственные хранилище данных, BI, систему задач и статистическую платформу. Инструмент может связывать их результаты с определениями, основаниями и решениями. Приоритет получает операция, которую трудно выполнять надёжно, а не функция, эффектно выглядящая на диаграмме.

| Возможность | Методологическая операция и выход | Требование к приёмке |
|---|---|---|
| Постановка и конструирование | Вопрос, контекст, результаты, процессы и ограничения → модель ситуации, кандидаты показателей, основания отбора | Выбранные измерения связаны с вопросом; неизвестное и отклонённые варианты не исчезают |
| Определения и связи | Согласование смысла → реестр определений и явно типизированных отношений | Процесс не превращается в число; формула отличается от гипотезы влияния; один показатель переиспользуется без дублирования фактов |
| Данные и расчёты | Источники и определения → значения, расчёт и сведения о качестве | Указаны популяция, окно, версия и состояние значения; результат можно восстановить; несовместимые агрегаты не смешиваются |
| Обсуждение и решение | Альтернативы, данные, допущения → выбор с основанием и условиями пересмотра | Видны разногласия, принятые ограничения и использованные версии; комментарий не считается апрувом |
| Цели и контроль поведения | Желаемый результат и полномочия → цель, защитные ограничения, реакция; при необходимости отдельный стимул | Проверки соответствуют типу цели; задано поведение при нарушении; заполненность checklist не объявляется доказательством управляемости |
| Сценарии и эффект | Возможные действия и дизайн сравнения → ожидаемые последствия, затем оценка результата | Единицы согласованы, эффекты не дублируются; наблюдение, арифметический вклад и причинный вывод различимы |
| Исполнение | Решение и разрешённые действия → задачи, результаты выполнения, отклонения | Исполнение связано с решением; закрытая задача не получает автоматически статус подтверждённого эффекта |
| Сопровождение | Изменившиеся знания, определения и условия → новая версия, затронутые записи, проверки и исключения | История сохраняется; неподдерживаемое или устаревшее явно обозначено; смысловой вопрос не маскируется успешной машинной проверкой |

## 2. Минимальная логическая архитектура

Предлагается пять логических частей. Это границы ответственности, а не обязательные сервисы или таблицы базы данных.

**Общий пакет модели.** Хранит вопрос и контекст, определения измерений, связи, ссылки на данные и основания, цели, решения, действия и оценки результата. Единство логическое: физически записи могут находиться в нескольких системах с согласованными идентификаторами и источниками истины. Смысловые различия обязательны; каждое не требует отдельного класса. Например, процесс допустимо представить структурной записью или группировкой со стабильной ссылкой. Неиспользуемые стимулы, вероятности и причинные модели создавать не нужно.

**Операции метода.** Создают и изменяют пакет: предложить показатель, уточнить определение, получить значения, сравнить действия, принять решение, зафиксировать выполнение, пересмотреть оценку. Для каждой определены вход, выход, допустимые переходы, проверки и требуемые полномочия. Черновик может быть неполным; допуск к расчёту или исполнению проверяется отдельно.

**Проверки и вычисления.** Проверяют ссылки, типы, единицы, окна, агрегации, версии и применимые правила. Результаты разделяются на ошибку, предупреждение и вопрос для содержательного рассмотрения. Неподдерживаемый вычислительный цикл не запускается; смысловая обратная связь может сохраняться с лагом без обещания расчёта. Исключение из правила не делает неверную арифметику корректной.

**Представления и совместная работа.** Таблица, карточка, дерево, граф, сценарий и журнал показывают согласованные части одного пакета. Вид обозначает контекст, версию и скрытые зависимости. Для выбора действия важнее доступ к определению, основаниям и неопределённости, чем количество редактируемых блоков.

**Адаптеры и исполнение.** Импортируют результаты существующих систем, вызывают разрешённые расчёты и связывают решения с выполнением. Внешняя система может оставаться источником истины; инструмент хранит идентификатор, версию и необходимое для проверки происхождение. Где проходит граница, указывается для каждого вида данных.

Профиль применения задаёт детализацию, типы целей, проверки, ритм пересмотра и допустимые методы оценки. Профиль версионируется, имеет область применимости и примеры. Он не вправе отменять различие факта и прогноза, скрывать несовместимость единиц или объявлять причинность наличием ребра.

## 3. Открытый формат, версии и воспроизводимость

Открытость здесь означает документированное представление данных и возможность переноса, а не публичный доступ к сведениям бизнеса. Требования:

- Устойчивые идентификаторы; явные ссылки между определением, значением, целью, решением, действием и оценкой. Один объект в двух видах остаётся одним объектом.
- Экспорт включает смысл: определения, типы связей, версии, контекст, состояния и основания. Изображение дерева или выгрузка названий недостаточны.
- Версии методологии, профиля, формата, модели, определения и набора данных различимы в той мере, в какой влияют на результат. Их не обязательно реализовывать отдельными подсистемами.
- Опубликованный расчёт ссылается на использованные определения, формулы, данные, план и допущения. Снимок либо гарантированно доступная неизменяемая версия позволяют его восстановить; ссылка на изменяемую страницу этого не обеспечивает.
- Пересмотр определения, цели или метода оценки не переписывает прошлое молча. Обозначаются затронутые результаты и необходимость пересчёта.
- Перенос между версиями имеет правила миграции. Неподдерживаемое расширение сохраняется без интерпретации или явно отклоняется; незаметная потеря смысла недопустима.
- Пропуск, неизвестное, незрелое окно, предварительный факт и прогноз не превращаются в подтверждённый ноль.

Приёмочный сценарий: экспортировать пакет, открыть его независимым исполнителем, восстановить выбранное решение и расчёт, затем изменить определение и показать обе версии. Объём сохраняемых исходных данных определяется доступом и условиями воспроизводимости; инструмент не должен обещать восстановление недоступных данных.

## 4. Ручное, интерфейсное и LLM-исполнение

Ручной шаблон, UI и LLM должны использовать одинаковые определения, операции и правила сохранения результатов. Различается способ ввода и выполнения. Ручной ввод данных допустим с источником и статусом. Ручная правка проходит те же применимые проверки; результат LLM не получает привилегированный статус из-за уверенного объяснения. Наличие ID, версии и заполненных полей помогает проверке, но не исключает содержательной ошибки.

LLM может готовить определения, варианты связей, контрпримеры, изменения, отчёты и действия. Содержательное предложение имеет происхождение и статус черновика до предусмотренной проверки. Вид проверки определяется операцией: вычисление проверяется расчётом; изменение смысла — содержательным рассмотрением; принятие риска — решением уполномоченного человека. Разрешённая механика может выполняться автоматически без повторного апрува каждого шага.

Право редактировать черновик, утверждать изменение и исполнять действие необходимо различать. Мандат на исполнение задаёт область, ограничения и условия остановки. Уже принятое решение не нужно повторно согласовывать, пока действие остаётся в его границах. Выход за границы создаёт вопрос для нового решения. Система сохраняет, кто и на каком основании разрешил действие; текст модели «одобрено» разрешением не является.

Для внешнего расчёта нужен договор: входы и их версии, контекст, метод и допущения, параметры, выходы, диагностика и ограничения вывода. Причинный результат без описанного сравнения не принимается как доказательство эффекта. Если точное повторение стохастического расчёта невозможно, фиксируются условия и допустимые пределы воспроизведения; сохранённый текст LLM не заменяет основания утверждения.

## 5. Ядро, расширения и варианты исполнения

**Ядро:** связанный пакет, простые формы работы, обсуждение с возражениями и принятием поправок, явные состояния, проверки структуры и нужных вычислений, журнал решений, связь с исполнением и оценкой. Оно поддерживает полный цикл на небольшом объёме данных. Цели и оценки входят в язык метода, но конкретный экземпляр не обязан содержать численную цель, стимул или причинную оценку.

Три допустимых исполнения:

1. **Шаблоны и таблицы:** проверяют понятность операций и воспроизводимость без разработки приложения.
2. **Связующий инструмент:** добавляет общие определения, версии, проверки и прослеживаемость поверх существующих систем.
3. **Самостоятельное приложение:** объединяет устойчивые повторяющиеся операции, когда предыдущие способы создают подтверждённые ограничения.

Расширения вводятся по потребности: коннекторы — при существенной цене ручного переноса; совместный графический редактор — при трудностях обсуждения; статистические методы — при подходящем вопросе и данных; портфельный расчёт — при общих ресурсах и взаимодействиях; отраслевые библиотеки — после проверки переносимости; LLM-оркестрация — при стабильных операциях и проверяемых выходах.

Выбор «готовое / интеграция / разработка» проводится на одинаковых операционных сценариях. Проверяются сохранение смысла при переносе, версия и происхождение результата, исполнительные права, ограничения и стоимость сопровождения. Готовое подходит, если закрывает операции без существенных искажений; интеграция — если разрыв находится между уже работающими системами; разработка — если необходимая операция остаётся неподдержанной и ценность подтверждена. Маркетинговое описание функции требует испытания. Текущие границы сведений о поставщиках приведены в [аудите](../source-check.md).

## 6. Этапы разработки с проверяемыми выходами

Пилот проверяет разработанную концепцию и не заменяет её. Последовательность допускает возвраты, если испытание выявляет проблему предыдущего этапа.

| Этап | Проверяемый выход | Условие перехода |
|---|---|---|
| **1. Спецификация методологии** | Цель, границы, словарь, операции, профили, правила качества, границы автоматизации | Для требования понятно, какую проблему оно решает; универсальное отделено от контекстного; ключевые противоречия устранены |
| **2. Рабочие артефакты и договоры** | Шаблоны пакета, входы/выходы операций, правила версий и проверок, договор внешнего расчёта | Независимый участник может пройти от вопроса до пересмотра; места недостающих данных и человеческого решения обозначены |
| **3. Прототип механики** | Демонстрация полного цикла, изменения определения, общих объектов, неизвестного и истории | Можно выполнить сценарии; реализованное поведение отделено от имитации и будущих требований. Понятный экран не объявляется доказательством полезности метода |
| **4. Проверка переносимости и передачи** | Контрастные примеры, отрицательные сценарии, модели другой группы, список дефектов инструкции | Различия выражаются содержанием и обоснованными профилями; заранее внесённые дефекты обнаруживаются; расхождения объяснимы |
| **5. Испытание с реальными решениями** | Воспроизводимые данные и расчёты, принятые действия, наблюдение последствий и затрат сопровождения | Видно, помог ли метод выбрать, ограничить или пересмотреть действие; неопределённые и отрицательные результаты сохранены |
| **6. Пересмотр и развитие инструментов** | Новая версия метода, подтверждённые границы применимости, приоритеты автоматизации и интеграций | Автоматизируются устойчивые операции с измеримой пользой; стоимость сопровождения и ограничения учтены |

Общие проверочные сценарии: преобразование единиц не меняет вывод; доли и уникальные значения агрегируются корректно; один эффект не складывается несколько раз; изменение версии сохраняет историю; обратная связь не вызывает бесконечный пересчёт; полномочия не расширяются незаметно; неизвестное и исключение имеют явное продолжение процесса.

Разработка считается успешной по качеству и стоимости выполнения управленческих операций. Количество деревьев, записей, экранов или автоматически сгенерированных предложений само по себе таким результатом не является.
