Archyl features: from repository to a maintained C4 model

Interactive C4 diagrams, AI-powered architecture discovery, Architecture as Code DSL, change requests, MCP server, releases, technology radar, and more.

Powerful features for modern architecture documentation

Everything you need to visualize, document, and maintain your software architecture

AI-Powered Discovery

Let AI document your architecture

Connect your repository and let our AI analyze your codebase to automatically discover and document architectural elements, relationships, and patterns.

Automatic code analysis

Component detection

Relationship mapping

Technology stack identification

Architecture as Code

Define your architecture in YAML

Declare your entire C4 architecture in a single archyl.yaml file. Check it into your repository, sync it from CI/CD pipelines, and keep diagrams in sync with your codebase — fully version-controlled and declarative.

Declarative YAML schema for all C4 levels

CI/CD sync via GitHub Actions, GitLab CI, or REST API

Export any project to archyl.yaml

JSON Schema for IDE autocomplete

Monorepo support via include

Technologies, ADRs, releases, and events in one file

Architecture Drift Score

Is your documentation telling the truth?

Measure how accurately your C4 model reflects your actual codebase with a single 0-100% health score. The lightweight analysis checks file paths, directory structure, and element existence in seconds — no AI, fully deterministic. Track trends over time, enforce thresholds in CI with the official GitHub Action, and get Slack alerts when drift accelerates.

0-100% accuracy score computed in seconds (no AI, no file content fetched)

Validates systems, containers, components, code elements, and relationships

File path existence check — verifies documented code elements still exist

Fuzzy name matching — FrontendWebApp matches frontend/ directory

Score trend tracking with historical reports

Official GitHub Action with configurable quality gate threshold

MCP tools: compute, query, and trend drift scores from AI agents

Webhook events: drift.score_computed and drift.score_degraded alerts

Architecture Decision Records

Track every decision

Document architectural decisions in context. Link ADRs directly to the components they affect and maintain a complete history of your architecture's evolution.

Structured decision format

Link to architecture elements

Import from Git repositories

Status tracking and history

Project Documentation

Everything in one place

Write and manage Markdown documentation directly linked to your architecture. Import existing docs from your repository and keep everything synchronized.

Link to architecture elements

Import from Git repositories

Full-text search

Define and visualize your API surface

Import and visualize your API specifications alongside your architecture. Support for OpenAPI/Swagger, GraphQL schemas, Protocol Buffer definitions, and AsyncAPI specs — all linked to your C4 model elements. Visualize event channels to map your event-driven communication flows.

OpenAPI / Swagger specification viewer

GraphQL schema explorer

gRPC / Protocol Buffer definitions

AsyncAPI specification support

Event channels visualization

Link contracts to architecture elements

User & Data Flows

Visualize interactions

Document how data and users flow through your system. Create step-by-step flow diagrams that show exactly how different parts of your architecture interact.

Step-by-step flow visualization

Public share & embed links

Interactive flow diagrams

Link to architecture elements

Architecture Change Requests

Pull requests for your architecture

Propose, review, and merge architecture changes just like code. With requests-only mode, every C4 model modification must go through a structured review process before being applied.