Knowledge-first архитектура
Архитектуру можно описать одной фразой:
Архитектура определяется не слоями кода, а градиентом доступа к знанию — от концептуального (граф) к физическому (код).
Три источника правды
Формально система делится на три уровня памяти:
| Память | Где живёт | Отвечает на вопрос |
|---|---|---|
| Conceptual Memory | граф знаний (HelixDB): сущности, связи, правила, инварианты, ownership | почему так устроено |
| Structural Memory | репозиторий: пакеты, функции, интерфейсы, SQL, handlers | как реализовано |
| Execution Memory | runtime: события, логи, состояние очередей, метрики, кеши | что произошло |
Ключ — не в слоях, а в том, где агент берёт истину.
Conceptual Dependency Gradient
Чем «ниже» агент, тем меньше он обращается к графу и больше к файлам:
Domain Agent → 90% Helix / 10% code
Application Agent → 50% Helix / 50% code
Infra Agent → 10% Helix / 90% code
Отсюда правило: агент не имеет права получать знания не из своего уровня без эскалации вверх. Запрещено «сквозное чтение кода» (grep all repository → собрать контекст → принять решение). Вместо этого инфра-агент просит application-агента, тот — domain-агента, и только domain-агент читает граф.
Knowledge Gravity
Можно ввести метрику:
Knowledge Gravity = насколько сильно концепт удерживается в графе знаний.
- высокий gravity → живёт в графе, почти не отражается в коде напрямую;
- средний → частично материализован;
- низкий → полностью в коде (infra-детали).
Radius of Knowledge Access
Агенты распределяются не по слоям, а по радиусу знания:
Radius 0 → Code-only agent (infra)
Radius 1 → Application agent (mixed)
Radius 2 → Domain agent (граф-heavy)
Radius 3 → Architecture steward (граф-native)
Получается не multi-agent system, а knowledge attenuation system — знание «размывается» по мере приближения к коду.
Knowledge vs Projection
Тогда две роли кода уточняются: код — это самая низкоразрешающая проекция знания.
KNOWLEDGE LAYER (граф): Concept, Rule, Constraint, Ownership, Decision
↓
PROJECTION LAYER: CLI, Web, API, Worker, Integration
↓
IMPLEMENTATION LAYER: код, SQL, HTTP, runtime
CLI и Web не добавляют доменных знаний — они создают проекцию. Это объясняет старую проблему: разные интерфейсы (CLI/Web) принадлежат не домену, а projection space, и не должны влиять на доменную модель.
Финальная формулировка
Граф хранит смысл системы. Код хранит её физическую проекцию. А агенты существуют как фильтры между уровнями понимания.
Источники
- Синтез из обсуждения; опирается на What Is Code? и Fragments: June 16, 2026
- HelixDB — концептуальная память (граф знаний)