Architecture as Code · Git-first · MCP-native

Архитектура
в Git.

Один .agl файл — diagrams, docs, code stubs и IaC. Декларативный DSL, 4 уровня абстракции, 46 MCP-tools, VS Code и Cursor.

DSL · YAML-like 4 layers 46 MCP tools drift detection VS Code · Cursor · Claude

Запросить демо Что генерируется

$ brew install iam-solution/agl

Git-first · нет SaaS lock-in ≤ 5% loss roundtrip On-prem из коробки

            
            architecture.agl
            validated · 46 tools available
          
# Acme payments platform
enterprise acme:
  solution payments:
    system checkout:
      tech: "Go 1.22 · gRPC"
      team: "payments-core"

      service api-gateway:
        port: 8443
        protocol: "https/2"

      service payment-worker:
        replicas: 6
        link api-gateway: "grpc · mTLS"

      data tx-ledger:
        kind: "PostgreSQL · append-only"
        retention: 2557  # 7 years
→ C4 diagrams
→ ADR docs
→ Go stubs
→ Terraform

Value · four pillars

Один источник истины,
четыре последствия.

Архитектура живёт рядом с кодом, версионируется в Git, валидируется CI и порождает все производные артефакты.

01 · single source

Архитектура — один файл

Не Confluence, не draw.io, не Visio. Один .agl рядом с кодом. PR, review, rebase, blame.

02 · validation

CI-валидация

Семантические правила: разрешённые связи, layers, ownership, политики. CI блокирует PR при нарушении.

03 · generation

Артефакты из источника

C4, ArchiMate, Mermaid, Terraform, Go-stubs, ADR-docs. Регенерируются автоматически на каждое изменение.

04 · ai-native

MCP-native

46 MCP-tools для AI-агентов: read, mutate, validate, generate. Cursor и Claude видят архитектуру как код.

Четыре уровня абстракции

От enterprise до сервиса.
В одной грамматике.

Стратегический архитектор, solution architect и тимлид — все работают в одном файле. Уровень определяет видимость и набор сущностей.

L1 · Enterprise

Линейные бизнес-функции, capability map, contexts

Strategic architect · ownership, portfolio, регуляторные ограничения

capabilities · contexts

L2 · Solution

Программы / solutions, системы и интеграции между ними

Solution architect · цели программы, ключевые системы

solutions · systems

L3 · System

Сервисы, данные, links, протоколы

System architect · границы сервисов, контракты, потоки

services · data · links

L4 · Software

Модули, технологии, deployment

Tech lead / engineer · libraries, runtime, инфраструктурные детали

modules · runtime · deploy

Generation fan-out

Один источник.
Четыре класса артефактов.

Архитектура — это код. Из неё генерируются диаграммы, документация, code-stubs и инфраструктурные шаблоны. Регенерация — на каждом commit.

architecture.agl

single source of truth

⇒

diagrams

C4 · ArchiMate · Mermaid · PlantUML · BPMN · draw.io

docs

ADR templates · API specs · runbooks · onboarding

code

Go stubs · gRPC protos · OpenAPI · CDK constructs

iac

Terraform · Pulumi · Helm · k8s manifests

C4 model ArchiMate 3.x Mermaid PlantUML BPMN 2.0 draw.io Graphviz / dot D2

MCP / IDE · 46 tools available

AI видит вашу архитектуру
как код.

Все 46 инструментов сгруппированы по ролям. Cursor, Claude Desktop и VS Code-расширение подключаются через стандартный MCP-протокол.

agl.get_system

agl.list_services

agl.find_links

agl.search

agl.diff_revisions

diagrams9

agl.render_c4

agl.render_mermaid

agl.render_archimate

agl.export_drawio

agl.bpmn_flow

mutating14

agl.add_service

agl.link_services

agl.set_owner

agl.migrate_layer

agl.refactor_split

docs7

agl.gen_adr

agl.gen_runbook

agl.gen_onboarding

agl.gen_openapi

agl.gen_index

feedback4

agl.validate

agl.lint_layers

agl.check_drift

agl.policy_audit

VS Code extension Cursor integration Claude Desktop JetBrains plugin · beta

Drift detection · code ↔ architecture

Когда код расходится с архитектурой —
IDE подсвечивает.

LSP-расширение читает .agl и сравнивает с реальным кодом. Drift показывается прямо в gutter, как diagnostic. CI блокирует merge при расхождении.

checkout/handler.go

14func New(cfg Config) *Handler {

15W cli := grpc.Dial(cfg.PaymentAddr)

16E fraud := http.NewClient(cfg.FraudURL)

17 return &Handler{cli, fraud}

18}

diagnostic · line 15

Link not declared in architecture

Code calls payment-service, но в checkout/architecture.agl такой link отсутствует. Добавьте в DSL или удалите из кода.

drift · severity error

Code ≠ Architecture

HTTP-вызов fraud-service нарушает разрешённые transport-протоколы для слоя checkout. Архитектура требует gRPC. CI блокирует merge.

Позиционирование · vs the market

Не SaaS EA tool.
Не «diagrams only».

LeanIX и Ardoq — SaaS с lock-in. Structurizr — только модель C4. AGL — Git-first, four-layer, plus IaC и code generation.

	LeanIX	Ardoq	Structurizr	draw.io / Mermaid	AGL · IAM.Solution
Git-first, text-source	— SaaS	— SaaS	✓ DSL	~ форматы	✓ git-native DSL
4 уровня абстракции	✓ EA-метамодель	✓ flexible	~ только C4	— нет модели	✓ enterprise → software
Генерация diagrams / docs / code / IaC	~ diagrams + docs	~ diagrams + docs	~ только diagrams	~ только diagrams	✓ все 4 класса
Drift detection	— нет	~ интеграции	— нет	— нет	✓ LSP + CI
MCP / AI-native	— нет	— нет	— нет	— нет	✓ 46 tools
On-prem · sovereign	~ enterprise plan	~ enterprise plan	✓ self-hosted	✓ локально	✓ из коробки
Roundtrip с Mermaid / draw.io	— нет	— нет	~ односторонне	— нет	✓ ≤ 5% loss

Pricing · OSS + Pro + Enterprise

Open-source ядро.
Платите за enterprise-фичи.

CLI и базовая генерация — бесплатно навсегда. Платите за MCP-сервер, drift, multi-repo и SSO/RBAC.

Open-source

OSS · CLI + DSL

0 ₽

forever · BSL-1.1

agl-cli, agl-fmt, agl-validate
Генерация C4 / Mermaid / Terraform
VS Code расширение базовое
Self-host, без лимитов

Recommended

Pro · per-seat

от 8 000 ₽

/ разработчик / месяц

MCP-сервер (46 tools)
Cursor / Claude Desktop
Drift detection
Multi-repo workspaces
Priority support

Enterprise

On-prem · dedicated

от 4,2 М ₽

/ год · от 100 seat

On-prem MCP сервер
SSO · RBAC · audit
Custom policies / linters
SLA · 24/7
152-ФЗ, реестр отеч. ПО

FAQ

Архитекторы часто спрашивают.

Чем DSL .agl лучше YAML / JSON?+

AGL — domain-specific. Знает про слои, links, ownership, policies. Линтер ловит запрещённые связи между слоями, циклы и потерянные refs. YAML — generic; всё это надо строить с нуля.

Можно ли импортировать существующие diagrams?+

Да. Roundtrip-конвертеры из Mermaid, PlantUML, draw.io, C4-PlantUML. Семантические потери ≤ 5% измеряются на тестовом корпусе. Метаданные, которые не выражаются в источнике, сохраняются в комментариях.

Что с monorepo и multi-repo?+

Pro-тариф добавляет workspace-конфиг с несколькими репозиториями. Каждый владеет своим L4, общий L1–L2 хранится в platform-репо. Drift проверяется на каждый pull-request.

Drift detection — как именно работает?+

Статический анализ кода (Go AST, TypeScript AST, OpenAPI) сравнивается с заявленными в .agl services и links. LSP подсвечивает несовпадения в IDE, CI блокирует merge. Можно whitelist'ить временные исключения с TTL.

Это open-source или закрытый продукт?+

CLI, DSL-парсер, генераторы — open-source под BSL-1.1 (после 4 лет переходит в Apache). MCP-сервер, drift, multi-repo, enterprise-фичи — закрытые, в подписке Pro / Enterprise.

Pilot · 30 дней Pro бесплатно

Установите CLI,
опишите один сервис в .agl.

За 30 минут — первый граф C4 из вашего описания. За 30 дней — drift detection в CI и MCP-агенты, работающие с архитектурой как с кодом.

contact@iamsolution.ru IAM.Core → экосистема

Архитектура в Git.

Один источник истины,четыре последствия.