ADR-0020: AI-First Org Blueprint as Reference Architecture

Status

proposed

Context

По мере роста мультиагентной системы Synth Nova появляются вопросы, которые не покрываются существующими ADR:

• Как масштабировать текущую ADR-0003-Three-Tier-Hierarchy от ~5-10 агентов до 30-50 (горизонт 12 месяцев из Manifesto)?
• Какие архитектурные паттерны нужны когда scenarios становятся многошаговыми и кросс-функциональными?
• Как структурировать agent-to-agent communication когда прямых вызовов становится слишком много?
• Где граница между “agent решает” и “human решает” на strategic уровне (выше Three-Tier)?
• Как измерять качество агентов в production и закрывать loop обучения?

Нужен единый reference-документ, описывающий target architecture и operational patterns, на который можно ссылаться из конкретных ADR по мере реализации.

Constraint: Synth Nova — founder-driven company, не enterprise SaaS. Blueprint должен опираться на существующие принципы Manifesto (специализация, async, HITL, observability) и не тащить enterprise-overhead.

Decision

Принять Full Org — AI-First Blueprint как reference architecture для масштабирования агентной системы Synth Nova. Blueprint хранится как single reference document в 06-Business/ и декомпозируется по директориям vault’а (Architecture, Processes, Rules) по мере реализации конкретных паттернов через отдельные ADR.

Blueprint описывает универсальные абстракции (governance, HITL gateway, event-driven, criticality levels, observability, learning loops). Vertical-specific примеры (B2B SaaS CRM, enterprise sales) в blueprint — иллюстративные, не обязательные к применению.

Alternatives Considered

Option A: No blueprint, organic growth

Не принимать reference architecture. Добавлять ADR по мере возникновения конкретных вопросов, архитектура эмерджентна.

• Pros:
  • Нулевая overhead на поддержку reference
  • Архитектура точно соответствует реальным потребностям
  • Нет риска over-engineering преждевременно
• Cons:
  • Каждый ADR решает locally, без global context → inconsistency
  • Сложно onboard-ить новых агентов / collaborators без картины целого
  • Cross-cutting concerns (observability, HITL) проектируются изолированно → ретро-фит дорогой

Option B: Full adopt Blueprint as-is

Принять blueprint целиком, включая CRM-vertical specifics (Marketing/Sales/Commercial/etc.) и enterprise patterns (M&A, fundraise scenarios, enterprise legal).

• Pros:
  • Максимальное переиспользование существующего материала
  • Готовые scenarios можно сразу использовать
• Cons:
  • CRM-vertical не соответствует Synth Nova business (niche evaluation, market research, real estate)
  • Human-function empathy maps (CMO/CRO) неприменимы — Synth Nova не нанимает эти роли
  • Enterprise-overhead (SOC2, DPA, sales compensation) преждевременен для текущей фазы
  • Риск cargo-cult: применение паттернов потому что “так написано в blueprint”, не потому что нужно

Option C: Blueprint as reference, selective adaptation ← chosen

Принять blueprint как reference-документ в 06-Business/. Конкретные паттерны из blueprint реализуются через отдельные ADR по мере необходимости (ADR-0021+). Business-vertical примеры трактуются как illustrative.

• Pros:
  • Сохраняется ценность универсальных абстракций (governance, HITL, event-driven, observability)
  • Vertical-specific примеры остаются как reference, не обязательны к применению
  • Новые ADR могут ссылаться на blueprint для контекста вместо повторения
  • Incremental adoption — реализуем когда дозрели
  • Совместимо с Manifesto принципами и ADR-0003-Three-Tier-Hierarchy
• Cons:
  • Требует disciplined curation — blueprint не должен стать “свалкой идей”
  • Риск что часть blueprint никогда не будет реализована (wasted documentation)
  • Нужна явная пометка illustrative vs mandatory content
• Why chosen: Blueprint дал валидный universal framework, но Synth Nova vertical и phase слишком отличаются от CRM-example чтобы принимать целиком. Reference-модель позволяет извлечь ценность (абстракции) без tax (enterprise overhead).

Consequences

Positive:

• Единый reference для всех будущих ADR по архитектуре агентов
• Уменьшается дублирование контекста в каждом новом ADR
• Явная карта universal abstractions vs vertical-specific
• Новые агенты (в перспективе года — 30-50) проектируются с consistent patterns
• Decision Log получает clear lineage для последующих архитектурных решений

Negative / Trade-offs:

• Reference document (~10K слов) требует поддержки, риск устаревания
• Соблазн ссылаться на blueprint вместо решения конкретной задачи (“смотри в blueprint”)
• Может создать illusion of progress — blueprint описан, но ничего не реализовано
• Часть blueprint (M&A, enterprise scenarios) никогда не применима к Synth Nova

Mitigations:

• Blueprint помечается как #reference (не #constant) — явно живой документ
• Каждый конкретный паттерн реализуется через ADR-0021+, не “просто применяется из blueprint”
• Ежеквартальный review blueprint на relevance — удаление neприменимых секций
• В каждом blueprint-разделе явная пометка: [illustrative] vs [applicable]

Follow-ups

• Разместить reference document: [[Reference-Org-Blueprint]] в 06-Business/
• ADR-0021: HITL Gateway implementation (как конкретизация секции blueprint §20.x)
• ADR-0022: Criticality levels L1-L5 (расширение ADR-0003-Three-Tier-Hierarchy)
• ADR-0023: Event-Driven Agent Communication pattern
• ADR-0024: Observability & Learning Loops (outcome labeling → retro → tuning)
• Обновить _ADR-Index и Decision-Log
• Добавить Template-Scenario в 08-Templates/ для структурирования кросс-функциональных flow

References

• Manifesto — 8 принципов, на которых строится blueprint
• Codex — красные линии, blueprint не может их нарушать
• ADR-0003-Three-Tier-Hierarchy — существующая иерархия, blueprint дополняет strategic-слой
• Orchestration-Model — текущая механика оркестрации
• Memory-Model — существующий memory layer
• Policy-Layer — existing policy gating
• Reference-Org-Blueprint — сам blueprint (создаётся вместе с этим ADR)