Automated Landscape Modelling

How do you turn unstructured data into an enterprise architecture model?

The mechanics behind document-first EA: collect sources, extract candidate entities, resolve aliases and duplicates, map findings to a metamodel, bind evidence and confidence, and curate the result into a living model.

·11 min read·

Unstructured HLDs, PDFs, meeting transcripts and diagrams being extracted into a governed enterprise architecture model
Share this article

Why summarisation is not modelling

Ask a general AI assistant to summarise an HLD and it may produce a fluent overview. That is useful, but an architecture model must answer more demanding questions: Is “Payments Hub” the same entity as “PYMTHUB”? Is an integration synchronous or batch? Does this capability depend on that application? Which source supports the claim, and has an architect accepted it?

Modelling requires identity, types, relationships, provenance and governance. The six-step pipeline below makes those requirements explicit.

Step 1: Collect relevant, bounded sources

Start with a domain, capability or system of interest rather than the entire document estate. Useful sources include HLDs, ADRs, PDFs, wiki pages, interface documents, runbooks, diagrams, migration plans and meeting transcripts.

Boundaries matter. A smaller, relevant corpus produces better entity resolution and gives curators a realistic review queue.

Step 2: Extract candidate entities and relationships

Six-step pipeline from unstructured sources to a living enterprise architecture model
Turning prose into architecture requires entity resolution, metamodel mapping, evidence and human curation — not summarisation alone.

The system identifies candidate applications, capabilities, business processes, technologies, data stores, actors and integrations. It also looks for verbs and design statements that imply relationships: uses, depends on, publishes to, is hosted on, replaces and supports.

At this stage, the output is a proposal — not truth.

Step 3: Resolve aliases, duplicates and conflicts

Enterprises rarely name things consistently. One document says “Customer Payments Hub,” another says “Payments Orchestrator,” and a CMDB may contain “PYMTHUB.” Acronyms, project names, vendor products and renamed platforms must be reconciled.

  • Match likely aliases and present them for confirmation.
  • Merge duplicate candidates without erasing source history.
  • Keep conflicting statements visible instead of averaging them.
  • Record uncertainty where the evidence is weak or dated.

Step 4: Map candidates to the EA metamodel

A list of extracted nouns is not a model. Each accepted candidate needs a valid architectural type and relationships that make sense: a capability is realised by processes or applications; an application uses technology; an interface connects producers and consumers.

DecisionPen uses this metamodel-aware step so the result can support landscape views, impact analysis and future governance — including LeanIX-aligned modelling where an organisation uses that structure.

Step 5: Bind evidence and confidence

Every important model element should answer, “Why do we believe this?” Preserve the supporting document, transcript passage, diagram or expert statement. Distinguish:

  • Observed: present in an authoritative inventory or operational source.
  • Documented: explicitly described in design or decision material.
  • Inferred: proposed from patterns or indirect evidence.
  • Curated: reviewed and accepted by an accountable human.

That separation prevents a plausible inference from masquerading as a verified operational fact.

Step 6: Curate into a living model

Architects and subject-matter experts accept, edit, reject or defer proposals. Accepted elements become available for landscape views, impact questions and artefact generation. Rejected proposals are also valuable because they stop the same weak inference returning unquestioned.

Where structured inventories fit

If you already have a CMDB or application catalogue, use it to improve identity resolution. Import the structured entities first, match documents to them, and create new entities only where the evidence exposes something missing. That is the workflow in enriching EA factsheets with unstructured documents.

How does DecisionPen solve this?

DecisionPen implements the pipeline as incremental modelling. It ingests documents, transcripts and natural-language descriptions; proposes metamodel-aware entities and relationships; binds supporting evidence; and supports human curation before information joins the living map.

The result is more than a generated picture. It is an Architecture Decision Workspace that can be interrogated through Enterprise Ask and used to generate documents and diagram images from curated context.

Try DecisionPen with one design document and one transcript, then judge the proposal and evidence quality for yourself.

When is DecisionPen not the right tool?

If you only need a document summary, use a general Copilot. If you need freeform BPMN or diagram drawing, use a drawing tool. DecisionPen is for teams that need the extracted knowledge to become a governed, reusable architecture model.

Frequently asked questions

Can an LLM turn documents into an enterprise architecture model?
An LLM can help extract candidate entities, attributes and relationships, but a trustworthy model also needs alias and duplicate resolution, metamodel validation, source-evidence binding, conflict handling and human curation.
What types of unstructured data are useful for EA modelling?
HLDs, ADRs, PDFs, wiki pages, interface specifications, runbooks, migration plans, architecture diagrams, meeting transcripts, workshop notes and carefully captured expert narratives are all useful when they are matched to entities and retained as evidence.
How does DecisionPen turn unstructured data into a model?
DecisionPen ingests documents, transcripts and natural-language descriptions; proposes applications, capabilities, technologies, integrations and relationships against its metamodel; binds supporting evidence; and lets architects accept, edit, reject or defer proposals before they become part of the living model.
When is DecisionPen the wrong tool?
If you only need document summarisation, a general writing Copilot, or freeform BPMN and diagram drawing. DecisionPen is for building and using a curated architecture model, not merely chatting with files.
Share this article

Prefer plain text? Markdown mirror for agents and readers.