Living EA

How should humans review and curate AI-proposed architecture models?

Treat AI proposals as drafts with evidence: review in a queue to accept, edit, reject or defer; prioritise relationships and weak evidence; record rejections; measure trust. Curate-Don’t-Create — a trusted slice you would defend, not unsupervised 100% coverage.

·10 min read·

Architect reviewing a queue of AI-proposed architecture entities with accept, edit, reject and defer actions
Share this article

AI makes it cheap to produce architecture models. It does not make them true. Whether an AI-assisted landscape becomes an asset or a liability depends almost entirely on what happens between “proposed” and “canonical”. This post is about that step: how humans should review and curate AI-proposed models so trust rises with use. It sits alongside the capstone map of the AI loop and the post on modelling from structured and unstructured sources.

Why does AI-proposed architecture need human curation at all?

Because the failure modes are quiet. A model can hallucinate an integration, merge two similarly named systems, treat a deprecated design as current, or read a roadmap aspiration as fact. None of these look wrong on a diagram. Each one then flows into impact analysis, Enterprise Ask, generated artefacts, and — increasingly — the context that delivery agents act on.

That downstream reuse is the reason curation is not optional overhead. An unreviewed proposal that gets reused becomes a Context Tax bill later: the organisation discovers the error in a production change, not in a review.

What does a human-in-the-loop review queue look like?

A good queue is a work list of proposals, each with the evidence that produced it. For every item a reviewer should be able to answer three questions in seconds: what is being claimed, where did it come from, and what changes if I accept it?

  • Accept — the claim is right and sufficiently evidenced; it joins the living map.
  • Edit (or enrich) — mostly right; correct a name, relationship, or attribute, or add context the source lacked, then accept.
  • Reject — wrong, out of scope, or superseded. Record why, because a rejected claim is knowledge too — it stops the same mistake being re-litigated.
  • Defer — plausible but unproven. Park it as an open question rather than guessing.
Human-in-the-loop review queue: evidence-backed AI proposals ratified into the curated Context of Record
AI proposals are drafts until ratified. Accept, edit, reject or defer — and only then do they join the map.

What should reviewers check first?

Reviewing everything equally is how queues die. Prioritise by blast radius and by evidence strength:

  1. Relationships over attributes. A wrong integration edge changes impact analysis; a wrong description field rarely does.
  2. Weakly evidenced claims. A single passing mention is not an integration; a design section with a sequence description is.
  3. Conflicts between sources. Where two documents disagree, a human must decide which wins, and say so.
  4. New entities that look like existing ones. Resolve merges before they spread through the map.
  5. Lifecycle and ownership. Retirement and ownership changes are decisions, not facts to be inferred.

How do trust and governance work in practice?

Three practices make curation sustainable rather than heroic.

  • Named stewardship. Someone — an enterprise architect, a domain architect — owns the ratification of a domain. Without an owner, a queue becomes a backlog.
  • Evidence stays attached. A year later, “why does the map say this?” should open the original passage. That provenance is what survives audit and leadership challenge.
  • Trust is measured. Track the accept/edit/reject ratio, time-to-first-trusted-slice, and how often Ask cites curated entities. A very high accept rate with no edits can mean rubber stamping, not quality.

These are the same evaluation signals used in the working method from automated discovery to durable architecture context.

Should AI ever be allowed to auto-approve?

There is a tempting pitch: unsupervised, near-100% coverage of the estate. We would resist it. Coverage is easy to achieve and hard to trust; a repository filled without review recreates the hollow, untrusted EA tool in a faster timeframe. Where automation helps is around the gate: pre-sorting a queue, grouping similar proposals, surfacing conflicts, and highlighting gaps. The decision to make something canonical remains human.

That position underlies why EA must own enterprise context in the agentic era: the more agents consume the map, the more the ratification step matters.

How does DecisionPen support review and curation?

In DecisionPen, AI output does not write straight to the Context of Record. Proposals — entities, relationships, and enrichment from documents, dialogue, and a spreadsheet import — are queued with their bound evidence. Architects accept, edit, reject, or defer them, and only then do Enterprise Ask answers and generated artefacts draw on them. Gaps stay visible as gaps rather than being papered over. The mechanics are documented in incremental modelling, and the workspace in Architecture Decision Workspace.

Trial DecisionPen on one domain and review the first fifty proposals. Note what you edited and rejected: that is where your organisation’s modelling conventions and local knowledge live, and where curation earns its keep.

When is DecisionPen not the right tool?

If you want unsupervised, fully automated population with no human review, DecisionPen is deliberately not that. It is also not the right primary tool for freeform diagramming (Visio, Lucidchart), BPMN, a Copilot that only drafts text, or a CMDB used purely for operational asset tracking. If no one in your organisation can own curation of a domain, fix that first — any tool will otherwise accumulate drafts, not knowledge.

What to read next

Series index (AI in the Architecture Decision Workspace)

Frequently asked questions

How should humans review AI-proposed architecture models?
In a queue of evidence-backed proposals: accept, edit or enrich, reject, or defer each one — prioritising relationships, weakly evidenced claims, conflicts between sources and new entities that resemble existing ones.
Why can’t AI auto-approve its own proposals?
Errors are quiet — a hallucinated integration or a deprecated design read as current looks fine on a diagram — and they propagate into impact analysis, Ask and delivery-agent context. Coverage without review is untrusted coverage.
What should reviewers check first?
Relationships before attributes, then weakly evidenced claims, conflicting sources, possible duplicate entities, and lifecycle or ownership changes, which are decisions rather than facts to infer.
How do you measure whether curation is working?
Track the accept/edit/reject ratio, time-to-first-trusted-slice, how often Ask cites curated entities, and whether conflicting answers fall. A near-100% accept rate with no edits can signal rubber-stamping.
How does DecisionPen support review and curation?
AI output does not write straight to the Context of Record. Proposals from documents, dialogue and spreadsheet imports carry bound evidence; architects accept, edit, reject or defer them, and Enterprise Ask and artefacts then draw on the curated map.
When is DecisionPen the wrong tool?
If you want fully automated population with no human review, or your primary need is freeform diagramming, BPMN, Copilot-only drafting or CMDB-only asset tracking. And if no one can own curation of a domain, fix that first.
Share this article

Prefer plain text? Markdown mirror for agents and readers.