Documentation

The Insight Language

A practical introduction to the Insight language: types, constructors, attributes, operators, enums, extensions, presentations, string literals, and object creation.

Read the doc

Built-in Archinsight Types

A reference to Archinsight’s built-in graph and C4 types, including elements, relationships, systems, containers, components, environments, deployments, and infrastructure.

Read the doc

Comments and Notes

Explains how to write source comments for model authors and attach notes that remain part of the linked architecture.

Read the doc

Annotations

Describes lifecycle annotations for planned and deprecated architecture, along with the legacy Graphviz styling annotation retained for compatibility.

Read the doc

Structuring an Insight Project

Explains how to organize an Insight project across definition, context, and environment files using imports, aliases, visibility rules, and extensions.

Read the doc

Building and Linking an Insight Project

Follows an Insight project from parsing and type construction through linking, diagnostics, graph introspection, queries, DOT generation, and image rendering.

Read the doc

Querying the Architecture Graph

Introduces the linked architecture graph and Archinsight’s Cypher-inspired query language, including matching, filtering, grouping, rollups, projections, and built-in scope variables.

Read the doc

C1: System Context

Explains C1 system-context modeling: context boundaries, systems, actors, external dependencies, high-level relationships, and the default context-wide view.

Read the doc

C2: Containers and Services

Explains how systems are divided into logical containers and services, how their relationships are owned and rolled up, and how C2 connects the logical model to deployment.

Read the doc

C3: Components

Covers component-level modeling inside containers and services, including responsibilities, dependency ownership, diagram scope, and relationship rollup to C2 and C1.

Read the doc

C4: Code

A C4 diagram opens one or more components and shows the code structures that implement them.

Read the doc

Deployment

A deployment model projects the logical architecture onto physical infrastructure. It focuses on a chosen element and the infrastructure immediately relevant to it.

Read the doc