Модули, кванты и артефакты

Если Ядра и Паттерны определяют области знаний, то модули и кванты определяют, что ваша база знаний производит, а артефакты - откуда появился контент.

В системе NOUZ-MCP база знаний — это живой конвейер. Модули и кванты отвечают за упаковку и поставку ваших знаний во внешний мир или фиксацию финальных, неизменяемых результатов.

---

⚙️ Модули

Модуль — это функциональный конвейер, «цех» или целевая точка выхода информации. Это система, которая имеет конечный продукт деятельности.

Модули могут быть самыми разными в зависимости от вашей сферы деятельности:

• Контент-модули: ТГ-канал, Личный блог, YouTube-проект.
• Проектные модули: Релиз_Приложения_v2, Запуск_Стартапа.
• Академические модули: Книга_По_Философии, Кандидатская_Диссертация.
• Инженерные модули: Архитектурный_Журнал.

Знак модуля

Знак модуля помогает агенту понять, какой доменный контекст применять к результатам этого конвейера.

Например, модуль ТГ-канал внутри паттерна Маркетинг может наследовать знак бизнес-ядра:

---
type: module
level: 3
sign: B
parents:
  - '[[Маркетинг]]'
parents_meta:
  - entity: Маркетинг
    link_type: hierarchy
---

Если модуль находится на стыке областей, знак может быть составным.

---

🌌 Кванты

Квант — это минимальная, неделимая и завершенная единица информации, принадлежащая конкретному модулю.

⚠️ Важное правило архитектуры: Квант — это зафиксированный результат работы конвейера.

Примеры квантов для разных модулей:

1. Для модуля ТГ-канал → Квант — это конкретный опубликованный пост.
2. Для модуля Книга → Квант — это готовая глава или утвержденный параграф.
3. Для модуля Архитектурный_Журнал → Квант — это принятое командой решение.
4. Для модуля Запуск_Стартапа → Квант — это закрытая и выполненная ключевая задача.

ИИ видит Кванты как историю транзакций вашего опыта. Благодаря этому агент всегда знает, что из ваших идей уже ушло в реальную жизнь (опубликовано, внедрено, сделано).

Знак кванта

Квант может иметь составной знак: форма материала + доменное ядро. Это нужно потому, что квант уже является завершенной единицей знания, но при этом он часто сохраняет форму изначального материала: гипотеза, спецификация, концепт, заметка.

---
type: quant
level: 4
sign: nB
artifact_sign: n
parents:
  - '[[ТГ-канал]]'
parents_meta:
  - entity: ТГ-канал
    link_type: hierarchy
---

В этом примере n показывает форму кванта как заметки или текстового результата, а B показывает доменную принадлежность. Если квант создан из гипотезы на стыке инженерии и бизнеса, знак может выглядеть как hBE: гипотеза + два смысловых ядра.

---

💎 Артефакты

Артефакт — это сырая единица информации. Они имеют прикладной характер, поэтому их нельзя приравнивать к теоретическим ядрам знаний. Каждый тип артефакта получает свой знак:

• Мимолетная мысль, инсайт или набросок.
• Дневниковые записи, логи событий, отчеты за день.
• Кусок исходного кода, скрипт или техническая конфигурация.
• Системный промпт для LLM-модели.
• Официальный документ, договор или регламент. Артефакты позволяют сохранять в базу любой хаотичный контекст, не боясь «замусорить» семантическую структуру.

Знак артефакта

У артефакта знак описывает прежде всего форму материала, а не его тему. Лог про маркетинг остается логом. Источник про физику остается источником. Черновик про архитектуру остается черновиком.

n — note / заметка
c — concept / понятие
r — reference / источник
l — log / лог
u — update / обновление
h — hypothesis / гипотеза
s — specification / спецификация

---

Переход от Артефакта к Кванту

Артефакт хранит фактуру: кто сказал, где это появилось, что было в источнике, какая была формулировка, какой был контекст. Квант появляется тогда, когда из этой фактуры извлечен устойчивый смысл.

Например:

L5 Лог разговора с пользователем — сырой источник
  ↳ из него извлечены:
     L4 Тезис: пользователь теряется на первом экране
     L4 Пост: почему onboarding должен объяснять следующий шаг
     L4 Задача: добавить подсказку после регистрации

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

В графе такой переход лучше фиксировать как derived_from.

parents_meta:
  - entity: Onboarding
    link_type: hierarchy
  - entity: Лог разговора с пользователем
    link_type: derived_from

hierarchy отвечает за место кванта в конвейере. derived_from сохраняет след: из какого артефакта, лога, источника или предыдущего решения этот квант появился.

Если квант вырос из нескольких материалов, оставьте ему один основной hierarchy-родитель, а источники перечислите отдельными derived_from-связями.

---

Дрейф базы

NOUZ-MCP разделяет ручное смысловое решение и вычисляемые знаки:

sign      — как пользователь понимает сущность
sign_auto — как текст похож на эталоны
core_mix  — что фактически накопилось снизу по иерархии

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

Тогда система может показать дрейф:

sign: B
core_mix: { E: 68, B: 32 }

Но это не повод сразу переписывать YAML. Это сигнал: конвейер начал производить другой тип знания. Пользователь может принять дрейф, разделить модуль, уточнить паттерн или оставить все как есть.

Главное: вы владелец онтологии, а автоматика показывает расхождение между задуманной структурой и фактической структурой базы.