Skip to content

Linked.Archi Toolbox

A pipeline of open-source tools that converts enterprise architecture models from various notations into a unified RDF knowledge graph, then generates documentation, visualisations, and AI-queryable interfaces from it.

The Pipeline

1. Converters

Transform source formats into RDF (TriG/Turtle) aligned to the https://meta.linked.archi/ ontology namespaces:

Converter Input Description
converters/archimate/ ArchiMate Exchange XML Elements, relationships, views
converters/bpmn/ BPMN 2.0.2 XML CMOF-complete, full DI/BPMNDI geometry
converters/plantuml/ PlantUML .puml Class, component, sequence, use case diagrams

All converters share the same conventions: - Named graphs: semantic, views, provenance - Dual-typing with arch:Element / arch:QualifiedRelationship - SKOS labels (skos:prefLabel) and notations (skos:notation) - YAML type-mapping override mechanism for custom ontology alignment

2. Generators

Consume the RDF output and produce human/machine-readable artefacts:

Generator Output Description
generators/rdf2docs/ Markdown + static HTML AI context document and per-IRI HTML pages for LLM Q&A and IRI dereferencing
generators/cap-map-gen/ Self-contained HTML Interactive D3 capability map with YAML overlays for ownership, maturity, and market variants

3. Visualisation

vis/linked-archi-static-navigator-v2/ — a static React SPA for browsing the RDF model:

  • Type facets and label search
  • Deep-linkable resource pages per IRI
  • Full-screen graph explorer (D3 force layout)
  • SPARQL workbench (client-side via Comunica)
  • Builds static landing pages per IRI for S3/CloudFront/GitHub Pages hosting

4. AI Enablement

ai-enablement/linked-archi-mcp/ — an MCP server (TypeScript + oxigraph SPARQL engine) that loads RDF files and exposes the graph to AI agents:

  • Tools: query-graph, list-elements, get-element, get-relationships, graph-stats
  • Prompts: impact-analysis, architecture-overview, explore-ontology
  • Compatible with Claude Desktop and Amazon Q Developer
  • Supports ArchiMate, BPMN, PlantUML, LeanIX, Backstage, and LinkML-derived ontologies

Core Idea

Any architecture model (ArchiMate, BPMN, PlantUML) gets converted to the same RDF shape, making the entire landscape:

  • Queryable via SPARQL
  • Navigable via a static web UI
  • Reasoned over by AI agents

— all from a single coherent graph aligned to the Linked.Archi foundational ontology.

Repository Structure

flowchart TD
    subgraph tools["tools/"]
        subgraph converters["converters/"]
            am["archimate/ — ArchiMate Exchange XML → RDF"]
            bpmn["bpmn/ — BPMN 2.0.2 XML → RDF"]
            puml["plantuml/ — PlantUML → RDF"]
        end
        subgraph generators["generators/"]
            r2d["rdf2docs/ — RDF → AI context docs + static HTML"]
            cmg["cap-map-gen/ — RDF → interactive capability map HTML"]
        end
        subgraph vis["vis/"]
            nav["linked-archi-static-navigator-v2/ — Static RDF browser SPA"]
        end
        subgraph ai["ai-enablement/"]
            mcp["linked-archi-mcp/ — MCP server for AI agent access"]
        end
        oss["oss-tools/ — Supporting tools and semantic data models"]
    end