An architecture team produces a detailed, framework-conformant target-state document, but when they present it to the executive steering committee, the executives can't tell from it what business risk is being reduced or what budget decision they're being asked to make. What likely went wrong, and how would you fix it?
answer
- deliverable = artifact tied to a specific audience/decision
- builder-view != owner-view
- executive artifact needs its own effort, not a shrunk technical doc
- single-artifact-for-all-audiences anti-pattern
- keep exec artifact synced with technical detail, not stale
basics
~20 sThe document was written for architects, not executives - too much technical detail, not enough plain statement of 'here's the risk, here's what it costs to fix, here's the decision we need from you.' Fix it by adding a short executive-level summary matched to what that audience actually needs to decide.
solid answer
~40 sMost EA frameworks distinguish between artifacts aimed at different audiences/perspectives (e.g., a strategic/owner-level view versus a detailed builder-level view), and the failure here is almost always a perspective mismatch: the team produced (or only produced) the detailed, builder-oriented deliverable and handed it to an audience that needs the summarized, decision-oriented deliverable instead. The fix isn't to write a better technical document - it's to produce a distinct executive-facing artifact, tied explicitly to the specific decision being requested (a budget approval, a risk acceptance, a go/no-go), using business language and quantified risk/cost, and treat it as a separate deliverable type rather than a simplified version of the technical one.
go deeper
Should recognize in plain terms that different audiences need different kinds of documents, and that executives generally need a short, decision-focused summary rather than technical diagrams.
Should identify the perspective/audience mismatch as the root cause and propose producing a distinct, business-language deliverable rather than simplifying the existing technical one.
Should describe the translation effort required (business stakeholder input, quantified risk/cost) and name at least one failure mode of getting the pairing wrong, such as artifacts drifting out of sync.
Should be able to set an organizational practice or template for deliverable types tied to audience and decision, and explain how to prevent both under-investment (single artifact for all audiences) and over-simplification (executive artifact disconnected from technical reality) at scale.
## The communication problem every framework hits Every EA framework that's been used at scale eventually has to solve the same communication problem: the people who need to authorize a decision (executives, a steering committee) are not the people who need to implement it (engineers, technical architects), and they need fundamentally different information to do their job. A framework's notion of 'viewpoints' or 'perspectives' exists precisely to force this separation explicitly rather than leaving it to whoever happens to be writing the document that week. In practice, this means the architecture repository should contain, for a given decision or system, more than one deliverable: - a **detailed, structurally accurate artifact** (data models, system diagrams, integration specs) for the people building or maintaining the thing; - a **distinct, much shorter artifact** for the people deciding whether to fund or approve it, stated in terms of business risk, cost, and choice, not technical structure. When a team produces only the former and expects it to also serve the latter audience, the executive committee is being asked to extract a decision from a document that was never designed to communicate one. ## Why teams fall into it Why this happens, and the problem it solves: architects, left to their own preferences, tend to default to the artifact type they find most natural to produce - usually the detailed technical one, because that's the artifact that actually captures the engineering reality they're managing day to day. Producing a genuinely separate executive artifact takes additional effort with no direct engineering payoff, so it's the deliverable most likely to be skipped or done as an afterthought - a slide deck thrown together the night before the steering committee meeting, mechanically copying diagrams from the technical document rather than reframing the content around the actual business question. The framework's discipline - explicitly requiring different deliverable types for different audiences as a first-class practice, not an optional nicety - exists specifically to counteract that default. ## What the second artifact costs Trade-offs: producing a genuinely audience-appropriate executive deliverable costs real time. It's not just a shorter version of the technical document; it requires translating technical risk into business terms, which often means the architect needs input from a business stakeholder to correctly characterize the cost of inaction in terms the executive audience cares about (revenue risk, compliance exposure, customer impact) rather than in terms the architect finds most natural (technical debt, coupling, latency). Skipping this translation is cheaper in the short term but produces exactly the failure in the scenario: decisions don't get made, or get made on ad hoc verbal explanation rather than the actual documented artifact, which erodes the value of maintaining the architecture repository at all, since the repository isn't actually driving the decisions it exists to support. Overcorrecting the other way - producing only glossy executive summaries with no underlying detailed artifact - creates a different failure: decisions get approved based on an oversimplified picture, and the technical team later discovers the approved plan didn't account for a real constraint that only would have surfaced in the detailed artifact. ## Failure modes in production Failure modes in production: 1. The most common variant of this failure is the **'single artifact, multiple audiences' anti-pattern** - one document gets reused unchanged for both technical review and executive approval, and it satisfies neither audience well: too detailed and jargon-heavy for executives to extract a decision, too summarized and hand-wavy for engineers to actually build from. 2. A related failure is **producing the executive artifact but disconnecting it from the technical one**, so the numbers or timeline in the executive summary silently diverge from what the detailed technical plan can actually support - the executive approves a budget based on a summary that was optimistically simplified, and the technical team later has to explain a shortfall against a commitment they never actually validated. 3. A third failure is producing the right artifact types but **the wrong cadence** - refreshing the detailed technical artifacts continuously as engineering reality changes, while letting the executive-facing artifact go stale, so leadership is making decisions off information that's a year out of date even though the underlying technical documentation is current. ## A worked example and its fix Concrete example: a retail company's architecture team produced a thorough, framework-conformant target-state document for consolidating three separate order-management systems into one, full of data-flow diagrams and integration specs, and presented that same document to the executive steering committee asking for migration budget. The committee couldn't determine from it: - which of the three current systems posed the greatest operational risk if left unconsolidated; - what the migration would cost in dollars versus what the status quo was costing in duplicated support effort; - what decision they were actually being asked to make versus simply being informed. The fix the team applied was to produce a **one-page decision brief** - three systems, estimated annual cost of maintaining each, quantified support-ticket volume as a risk proxy, and a specific dollar ask tied to a specific timeline - as a distinct deliverable explicitly derived from, but not identical to, the detailed technical document, and steering-committee approval followed within one meeting cycle once that artifact existed.
- How do you keep the executive-facing artifact from silently drifting out of sync with the detailed technical one?Treat the executive artifact as explicitly derived from the technical one rather than independently maintained - version them together, and whenever the technical plan changes materially (scope, timeline, cost), regenerate or explicitly re-review the executive summary as part of that same change, not on a separate schedule.
- Whose job is it to translate technical risk into business-risk language for the executive artifact?It shouldn't be the architect working alone - the strongest version pairs the architect (who knows the technical risk) with a business stakeholder or product owner (who knows what the business actually cares about, like revenue or compliance exposure), so the translation reflects real business priorities rather than the architect's guess at what executives want to hear.
- What's a warning sign that a team is falling into the 'single artifact, multiple audiences' anti-pattern?A telltale sign is an executive steering committee meeting where most of the discussion is spent explaining what a diagram means rather than discussing the actual decision, or where the committee asks a question the document's structure can't answer without someone verbally translating it on the spot. If the document has to be verbally re-explained every time, it isn't serving its stated audience.
It's like handing a building's full structural engineering blueprints to a homeowner who just wants to know 'how much will this cost and is it safe to live in during construction' - the blueprints are correct and necessary, but they answer the contractor's question, not the homeowner's, and someone still has to write the one-page summary that actually gets the homeowner to say yes.
saying these in an interview costs you the question
- Suggests the fix is just 'make the technical document shorter'
- Doesn't distinguish between audience-specific deliverable types as a deliberate practice
- Assumes executives should just learn to read technical architecture diagrams
- No mention of keeping the executive artifact synced with the underlying technical detail
- Treats producing an executive summary as a one-time afterthought rather than an ongoing artifact