Living EA

Architecture knowledge management vs document knowledge bases: what is the difference?

Document knowledge bases store narrative for retrieval. Architecture knowledge management stores curated commitments about the IT estate — metamodel entities, relationships, and How/Why evidence — so humans and agents share one Context of Record.

·10 min read·

Side-by-side contrast of a document knowledge base of pages versus an architecture knowledge map of entities with evidence
Share this article

Document knowledge bases store narrative for people (and increasingly RAG) to retrieve. Architecture knowledge management stores curated commitments about the IT estate — metamodel entities, relationships, and How/Why evidence — so humans and agents share one Context of Record. Search phrases such as wiki vs EA repository, is Confluence enough for architecture, and architecture KM vs RAG all ask this distinction.

Two jobs that look alike

Both involve “knowledge” and “IT.” They fail for different reasons when conflated:

  • Document KB job — find the right page, policy, or HLD when someone already knows roughly what to search for.
  • Architecture KM job — answer landscape questions consistently (blast radius, ownership, technology use, capability coverage) from a governed model, not from whichever PDF ranked highest.

A practical taxonomy

Taxonomy: wiki, vector RAG, CMDB, classic EA repo, and Architecture Decision Workspace as architecture knowledge management
Choose the store by the job: find text, list assets, or own landscape meaning. Architecture KM is the last of these.

Comparison criteria evaluators can use

  • Unit of truth — page vs entity-in-metamodel.
  • Conflict handling — latest edit wins vs curated accept/reject of proposals.
  • Provenance — “found in doc X” vs evidence bound to a governed entity.
  • Ask behaviour — similar passages vs map-grounded answers with citations.
  • Agent readiness — private context packs per bot vs shared Context of Record (reduces Context Tax).

When you need both

Document KBs do not disappear. HLDs, policies, and runbooks remain evidence. Architecture KM shapes that evidence into the living map and generates documents as views of context rather than parallel private truths (generate docs from living context). The failure mode is treating the wiki as the architecture system of record.

How does DecisionPen implement architecture KM?

  • Metamodel-aware living map (LeanIX-aligned when needed).
  • Documents and notes bound as evidence to entities.
  • AI proposes; humans curate.
  • Enterprise Ask and artefacts from the Context of Record — not a chatbot bolted onto Confluence.

Trial DecisionPen beside your current wiki search: ask the same dependency question both ways and compare consistency and citations.

When is DecisionPen not the right tool?

If you only need intranet publishing, enterprise search, or freeform Visio / Lucid / BPMN drawing. DecisionPen is architecture knowledge management for the living landscape — not a CMS or drawing canvas.

What to read next

Frequently asked questions

What is architecture knowledge management?
The discipline of capturing, curating, and serving structured knowledge about the IT landscape — entities, relationships, and How/Why evidence — as a shared Context of Record for decisions and agents.
How does a document knowledge base differ from architecture KM?
A document KB optimises storage and retrieval of narrative (pages, PDFs, tickets). Architecture KM optimises governed commitments about what exists in the estate and why — with a metamodel, curation, and askable access.
Is vector RAG architecture knowledge management?
No. RAG improves retrieval over documents. It does not maintain a metamodel, resolve conflicts, or own landscape truth. Useful as a feeder into architecture KM, not as a substitute.
Where do CMDB and classic EA tools fit?
CMDBs emphasise operational inventory. Classic EA repositories emphasise structured What. Architecture KM requires both structure and living How/Why evidence with human curation — the Architecture Decision Workspace pattern.
How does DecisionPen support architecture KM?
DecisionPen is an Architecture Decision Workspace: metamodel map, evidence-bound entities, incremental discovery, curation, Enterprise Ask, and artefacts as views — architecture KM as product, not a wiki with a chatbot.
When is DecisionPen the wrong tool?
If you only need intranet publishing, enterprise search, or freeform diagramming. DecisionPen is for architecture knowledge management of the living landscape — not a CMS or Visio replacement.
Share this article

Prefer plain text? Markdown mirror for agents and readers.