This guide does two things: first the theory in full — each framework in detail: origin, structure, core concepts, what it produces — then the practice: which parts earn their keep, where frameworks pay off, and four worked case studies. Because before judging what's ceremony and what's value, you need to know what each framework actually contains.
The oldest EA framework, born from a 1987 IBM Systems Journal paper. Zachman observed that complex engineering disciplines (aircraft, buildings) describe one product from multiple perspectives, each answering different questions — and that information systems needed the same discipline. The result is a 6×6 classification matrix: it tells you what kinds of descriptions exist, never how or in what order to produce them.
Columns are the interrogatives — What (data), How (function), Where (network), Who (people), When (time), Why (motivation). Rows are audiences, from the executive setting scope down to the running enterprise. Each cell holds one primitive model. The key rule: moving down a row is a transformation of perspective, not just "more detail" — the owner's business-entity model and the architect's logical data model are different models of the same thing.
| Perspective ↓ / Question → | What (data) | How (function) | Where (network) | Who (people) | When (time) | Why (motivation) |
|---|---|---|---|---|---|---|
| Executivescope contexts | List of things important to the business | List of processes | List of locations | List of organizations | List of events & cycles | List of goals & strategies |
| Business managementbusiness concepts | Semantic / business entity model | Business process model | Business logistics network | Workflow & org model | Master schedule | Business plan |
| Architectsystem logic | Logical data model | Application architecture | Distributed system architecture | Human-interface architecture | Processing structure | Business rule model |
| Engineertechnology physics | Physical data model | System design | Technology architecture | Presentation architecture | Control structure | Rule design |
| Techniciantool components | Data definitions (DDL) | Programs | Network configuration | Security & access definitions | Timing definitions | Rule specifications |
| Enterprisethe running instance | Actual data | Working functions | Physical networks | Trained people | Executed schedules | Enforced rules |
| Year | Milestone | What changed |
|---|---|---|
| 1987 | "A Framework for Information Systems Architecture" (IBM Systems Journal) | The original paper — only three columns (data, function, network), inspired by how construction and aerospace document one product from many perspectives |
| 1992 | Sowa & Zachman extension | Added the Who / When / Why columns, completing the six interrogatives |
| 2011 | Version 3.0 — "The Zachman Framework for Enterprise Architecture" | Rebranded as an enterprise ontology; row names shifted from builder-metaphor roles (Planner, Owner, Designer, Builder, Subcontractor) to audience perspectives (Executive, Business Management, Architect, Engineer, Technician) |
| # | Rule | Why it matters |
|---|---|---|
| 1 | Columns have no order | What is not more important than Why; the grid is a classification, not a sequence |
| 2 | Each column has one simple, generic model | The What column is always entities-and-relationships, whatever the row |
| 3 | Each cell's model is unique | A logical data model is not a physical data model with less detail — it's a different model |
| 4 | Each row is a distinct, complete perspective | Every row describes the whole enterprise, from one audience's point of view |
| 5 | Each cell is unique — no cell substitutes for another | 36 cells, 36 different primitive models |
| 6 | Composite of all cells in one row = complete model from that perspective | Real-world deliverables are composites assembled from primitives |
| 7 | The logic is recursive | The same grid can classify descriptions of a whole enterprise, one division, or one system |
Zachman names the movement down the rows reification — the process by which an abstract idea becomes a running instance: Identification (executive names what matters) → Definition (business management defines the concepts) → Representation (architect represents them as system logic) → Specification (engineer specifies the technology) → Configuration (technician configures the tools) → Instantiation (the enterprise runs). Each arrow is a translation between audiences, and every translation is a place where intent can be lost — which is exactly where architects add value.
| Perspective | The "What" cell contains |
|---|---|
| Executive | A list: customers, orders, products, suppliers, payments — the things the business must keep track of |
| Business management | A business entity model: a Customer places Orders; an Order contains Products; a Payment settles an Order — with business definitions ("an Order exists once checkout completes") |
| Architect | A logical data model: normalized entities, attributes, keys — ORDER(order_id, customer_id, status, placed_at), independent of any database engine |
| Engineer | A physical data model: PostgreSQL tables, indexes, partitioning strategy for the orders table, read replicas |
| Technician | The actual DDL, migration scripts, connection pool configuration |
| Enterprise | The production data itself — 14 million order rows and counting |
Read the column bottom-up and you get audit traceability: which executive concern does this table serve? Read it top-down and you get impact analysis: if the business redefines "Order", what breaks? This column trace — not the full grid — is how Zachman gets used in anger (see Case study 04 below).
The most widely adopted EA framework. Where Zachman classifies, TOGAF prescribes a process: the Architecture Development Method (ADM), a repeatable cycle for taking an enterprise from a current state to a target state with governance along the way. It covers four architecture domains — Business, Data, Application, Technology (BDAT) — and TOGAF 10 restructured the content into a small stable core plus extended guidance so it can be adopted piecemeal.
| Phase | Purpose | Key outputs |
|---|---|---|
| Preliminary | Establish the architecture capability itself — scope, principles, tailoring, tools | Architecture principles, tailored framework, governance setup |
| A · Architecture Vision | Scope the engagement, identify stakeholders and their concerns, get sponsorship | Statement of Architecture Work, Architecture Vision, stakeholder map |
| B · Business Architecture | Baseline and target for the business layer: capabilities, processes, organization | Business architecture (baseline + target), gap analysis |
| C · Information Systems | Two sub-architectures: Data (what information, where mastered) and Application (which systems, how they interact) | Data & application architectures (baseline + target), gaps |
| D · Technology Architecture | Platforms, infrastructure, networks that host the application layer | Technology architecture (baseline + target), gaps |
| E · Opportunities & Solutions | Consolidate all gaps into work packages; define transition architectures (plateaus) | Work packages, transition architectures, high-level roadmap |
| F · Migration Planning | Cost, prioritize, and schedule — turn the roadmap into a funded plan | Implementation & Migration Plan, finalized roadmap |
| G · Implementation Governance | Ensure delivery projects conform to the architecture | Architecture contracts, compliance reviews, dispensations (waivers) |
| H · Architecture Change Management | Watch for drift and changed conditions; decide when a new ADM cycle is needed | Change requests, updated architecture |
| Requirements Mgmt | The hub of the cycle — requirements flow into and out of every phase continuously | Requirements repository, impact assessments |
| Term | Meaning | Example |
|---|---|---|
| Deliverable | A contractually specified, formally reviewed work product — what a phase hands over | Architecture Definition Document, Implementation & Migration Plan |
| Artifact | A single architectural description inside a deliverable — TOGAF sorts them into catalogs (lists), matrices (relationships), and diagrams (pictures) | Application Portfolio catalog, Application/Function matrix, Application Communication diagram |
| Architecture Building Block (ABB) | A capability specification — what is needed, technology-neutral | "An event streaming platform with replay and ordering guarantees" |
| Solution Building Block (SBB) | The concrete implementation that realizes an ABB | "Apache Kafka on AWS MSK, 3 brokers, us-east-1" |
The ABB → SBB distinction is TOGAF's quiet masterstroke: phases B–D specify ABBs, phase E maps them to SBBs. Keeping the two apart is what lets you change vendors without rewriting the architecture.
A TOGAF principle has four mandatory parts — Name, Statement, Rationale, Implications. The implications are what separate a principle from a poster on the wall:
| Name | Buy before build before extend |
| Statement | We adopt commercial or open-source products unmodified before building custom software, and we never fork what we adopt. |
| Rationale | Custom code is a liability with a permanent maintenance tail; our differentiation is in logistics, not software infrastructure. |
| Implications | Every build decision needs a documented buy evaluation first (record it as an ADR). Product selection weight shifts toward configurability. Some "perfect fit" requirements will be renegotiated rather than built. |
Keep 5–10 principles, no more. When two principles conflict on a real decision (they will), the resolution is an ADR — and that's the system working, not failing.
Every domain phase (B, C, D) ends the same way: draw a matrix with baseline building blocks as rows, target building blocks as columns. Where a baseline block maps to a target block — carried forward (possibly upgraded). A baseline row with no target column — eliminated (deliberately, or you've found an accidental omission). A target column with no baseline row — new, and every "new" cell is a gap that must land in a work package in Phase E. The discipline isn't the matrix; it's that nothing gets eliminated or created by accident.
| Mechanism | What it is |
|---|---|
| Architecture Review Board | The standing body that approves architectures, hears exceptions, and owns the principles. Small (5–7), senior, with real veto power — or it's theater |
| Architecture Contract | The agreement between the architecture function and an implementing project: what will be built, which standards apply, what conformance will be checked |
| Compliance assessment | TOGAF's graded scale — Irrelevant → Consistent → Compliant → Conformant → Fully conformant → Non-conformant. The grades matter: most healthy projects are "compliant" (follows the spirit, some features unimplemented), and demanding "fully conformant" everywhere is how ARBs lose the room |
| Dispensation (waiver) | A time-boxed, recorded permission to deviate — with an owner and an expiry. An honest waiver log is worth more than a clean compliance report; it's your technical-debt register at the architecture level |
The ADM diagram looks like a waterfall; the standard itself says it isn't. It runs as nested loops: an Architecture Capability iteration (Preliminary + A) when the practice itself changes, an Architecture Development iteration (B–D) that cycles as understanding improves, a Transition Planning iteration (E–F) as plans meet budget reality, and an Architecture Governance loop (G–H) that runs continuously. The Landscape is also layered by altitude — strategic (the whole enterprise, low detail), segment (one business area), capability (one capability increment, high detail) — and a full ADM cycle can run at any of the three. A two-week capability-level cycle is still TOGAF.
The standard notation for enterprise architecture — what UML is to software design, ArchiMate is to the enterprise. It defines a precise vocabulary of elements and relationships across layers, so a model means the same thing to every reader. TOGAF says when to model; ArchiMate says how to draw it.
| Layer | Question it answers | Typical elements |
|---|---|---|
| Motivation | Why does the architecture exist? | Stakeholder, driver, goal, outcome, requirement, principle |
| Strategy | What courses of action and capabilities get us there? | Capability, resource, course of action, value stream |
| Business | How does the business operate? | Business actor, role, process, service, function, business object |
| Application | Which systems support the business? | Application component, application service, interface, data object |
| Technology | What infrastructure runs the applications? | Node, device, system software, network, artifact |
| Physical | What physical machinery and facilities are involved? | Equipment, facility, distribution network, material |
| Implementation & Migration | How do we get from here to there? | Work package, deliverable, plateau, gap |
Each layer is crossed with three aspects: active structure (who/what acts), behavior (what happens), and passive structure (what is acted upon). This layer × aspect grid is ArchiMate's quiet homage to Zachman.
Every ArchiMate layer repeats one service-oriented pattern: internal active structure (a component, a team) is assigned to internal behavior (a process, a function), which realizes an externally visible service, exposed through an interface, which serves the layer above. That's why the language composes so cleanly across layers: the business layer consumes application services; the application layer consumes technology services. Once you see the pattern, you can model anything in it — and spot models that break it (an app "serving" another app's database directly, say) at a glance.
| Viewpoint | Question it answers | For whom |
|---|---|---|
| Organization | Who is structured how? | Executives, HR, PMO |
| Business Process Cooperation | How do processes interact end-to-end? | Process owners, ops managers |
| Capability Map | What does the business do? | Executives, strategy, portfolio |
| Application Cooperation | Which apps talk to which, and how? | Solution architects, integration teams |
| Application Usage | Which business processes use which apps? | Business analysts, app owners |
| Technology | What infrastructure exists and what runs on it? | Infrastructure & platform teams |
| Layered | The whole stack, all layers, realization links vertical | Architects — the "one slide" of EA |
| Motivation | Which goals and requirements drive what? | Sponsors, business owners |
| Implementation & Migration | Which work packages deliver which plateaus? | Program managers, transformation leads |
Goal "Reduce claim settlement time" (motivation) is realized by capability "Claims Management" (strategy) ← realized by business process "Handle claim" performed by role "Claims handler" (business) ← served by application service "Claims processing service" realized by component "ClaimCenter" (application) ← served by technology service "Container platform" realized by node "AKS cluster" (technology). One connected chain — so when someone proposes retiring ClaimCenter, the model answers instantly: which process stalls, which capability degrades, which goal is at risk. That query is the business case for maintaining the model.
| Language | Scope | Granularity | Use it for |
|---|---|---|---|
| ArchiMate | Whole enterprise, all layers | Coarse — architecture-level only, deliberately ~60 element types not 250 | Landscapes, capability maps, cross-layer impact |
| UML | One system's software design | Fine — classes, sequences, states | Detailed design inside a component (C4 level 4 territory) |
| BPMN | One process, executable detail | Fine — tasks, gateways, events, swimlanes | Process automation and workflow engines; an ArchiMate business process can "link" to the BPMN that details it |
Born as a reaction to two failure modes: meaningless boxes-and-lines on whiteboards, and heavyweight UML nobody maintains. C4 describes one software system at four zoom levels — "Google Maps for your codebase" — with strict notation hygiene so every diagram is self-explanatory.
| Level | Shows | Audience | Elements |
|---|---|---|---|
| 1 · System Context | The system as one box, its users, and neighboring systems | Everyone, including non-technical | Person, software system, external system |
| 2 · Container | The deployable/runnable units inside the system — web app, SPA, API, database, message broker (not Docker containers) | Technical people, in and around the team | Container (with technology stated) |
| 3 · Component | The major building blocks inside one container and their responsibilities | Developers working on that container | Component |
| 4 · Code | Classes/functions inside one component | Rarely drawn — the IDE generates it better | UML class diagram, etc. |
C4's real contribution isn't the diagrams; it's the shared abstraction model: a person uses a software system, which is made of containers, which are made of components, which are made of code — connected by relationships. Agree on those words first and any notation works; skip that agreement and no notation saves you. This is why a team fluent in C4 can whiteboard coherently: they're not sharing a drawing style, they're sharing a vocabulary.
| Level | Include | Leave out | Classic mistake |
|---|---|---|---|
| Context | Your system (one box), every user type, every external system you integrate with | Any internals, any technology names | Drawing internals because "context feels too simple" — simple is the point; this is the diagram executives keep |
| Container | Every separately deployable/runnable unit + datastores + technology choices, and the protocols between them | Classes, modules, infrastructure details (that's the deployment diagram) | Confusing containers with Docker containers — a database is a container; a Kubernetes pod is deployment detail |
| Component | The major structural building blocks of one container and their responsibilities | Every class — a component is a cohesive unit (a service, a repository, a module), not a file | Drawing it for every container "for completeness" — draw it only where the internal structure is genuinely non-obvious |
| Code | Nothing, usually — let the IDE generate it on demand | — | Hand-maintaining class diagrams that are stale by the next commit |
workspace "Checkout" {
model {
customer = person "Customer" "Buys products online"
checkout = softwareSystem "Checkout System" {
spa = container "Checkout SPA" "Cart & payment UI" "React"
api = container "Checkout API" "Order orchestration" "Spring Boot"
db = container "Orders DB" "Order storage" "PostgreSQL" "Database"
events = container "Event Bus" "Order events" "Kafka"
}
stripe = softwareSystem "Stripe" "Payment provider" "External"
customer -> spa "Uses" "HTTPS"
spa -> api "Calls" "JSON/HTTPS"
api -> db "Reads from / writes to" "JDBC"
api -> events "Publishes events to" "Kafka protocol"
api -> stripe "Charges cards via" "REST"
}
views {
systemContext checkout "Context" { include * autolayout lr }
container checkout "Containers" { include * autolayout lr }
}
}
One model, two views — and the point is what happens next: rename
api once and every view updates; add a container and the context diagram
doesn't change (right altitude, no noise). The file lives in Git, so architecture
changes show up in pull requests next to the code that caused them.
Two complementary open templates. arc42 answers "how do we document a system?" with twelve sections, each answering exactly one question. ADRs (Architecture Decision Records) answer "why is it built this way?" — one significant decision per file, written when the decision is made, immutable afterwards.
| § | Section | The question it answers |
|---|---|---|
| 1 | Introduction & Goals | What is this system for, and what are the top 3–5 quality goals? |
| 2 | Constraints | What is fixed and non-negotiable (tech, org, regulation)? |
| 3 | Context & Scope | What's inside vs. outside, and who/what do we talk to? |
| 4 | Solution Strategy | What are the fundamental decisions and approaches, in half a page? |
| 5 | Building Block View | How is the system statically decomposed? (embed the C4 diagrams here) |
| 6 | Runtime View | How do the blocks interact in the important scenarios? |
| 7 | Deployment View | Where does it run — hardware, environments, mapping? |
| 8 | Crosscutting Concepts | What patterns apply everywhere (security, persistence, logging)? |
| 9 | Architecture Decisions | Which significant decisions were made? (the ADR log lives here) |
| 10 | Quality Requirements | What does "good" mean, as measurable scenarios? |
| 11 | Risks & Technical Debt | What could hurt us, and what do we already owe? |
| 12 | Glossary | What do our terms mean? (the ubiquitous-language contract) |
arc42's sharpest discipline: a quality goal isn't an adjective, it's a scenario — stimulus → environment → response → measure. The measure is what makes it testable, and testable is what makes it architecture rather than aspiration:
| Quality | Scenario | Measure |
|---|---|---|
| Performance | A customer submits an order during peak load (1,000 concurrent users) | Order confirmed in < 200 ms at p95 |
| Availability | One availability zone fails during business hours | Checkout continues; ≤ 30 s of elevated errors; zero data loss |
| Maintainability | A new payment method must be added | Shipped by one team in ≤ 2 weeks with no change to the order core |
| Security | A stolen session token is replayed from a new device | Token rejected; re-authentication forced; alert raised within 1 min |
Pick the top 3–5 and rank them (§1.2) — an architecture that optimizes everything optimizes nothing. The full scenario catalog lives in §10 as a tree: quality attribute → refinement → concrete scenarios.
§5 is hierarchical white-box / black-box decomposition. Level 1: the whole system as a white box — show its top-level building blocks (these are your C4 containers) and, for each, a black-box description: responsibility, interfaces, quality characteristics. Level 2: open only the blocks that are complex or risky enough to warrant it — each becomes its own white box (C4 components). Level 3 is rare. Two rules keep it honest: every white box needs a stated decomposition rationale (by domain? by team? by rate of change?), and you stop decomposing when the next level would only restate the code.
proposed → written before or during the decision, circulated for reviewaccepted → the record of what we're doing and whysuperseded by ADR-NNNN → the old record stays; the log is the historydeprecated / rejected — rejected ADRs are kept too: "we considered and declined" saves the next person the same detourdocs/adr/0001-use-postgres.md — numbered, kebab-case, immutable numberingThree more names you'll meet in job specs and RFPs — each real, each with a legitimate niche, each worth understanding properly even if you never adopt it.
Born from the Clinger-Cohen Act (1996), which legally required US federal agencies to maintain an IT architecture. FEAF's core is a set of shared reference models — a common taxonomy so that spending and systems can be compared across agencies and duplicates consolidated. That purpose (compare & consolidate at portfolio scale) is why it looks bureaucratic from a delivery seat: it isn't for building systems, it's for governing thousands of them.
| Reference model | Classifies | The question it standardizes |
|---|---|---|
| PRM · Performance | Outcomes and measures | What results does this investment produce? |
| BRM · Business | Functions and services of government | What business function is this — and who else already does it? |
| DRM · Data | Data description, context, sharing | What information is this, and how is it exchanged? |
| ARM · Application | Application components & interfaces | What software capabilities exist and overlap? |
| IRM · Infrastructure | Platforms, networks, facilities | What does it run on? |
| SRM · Security | Controls and their placement | How is it protected, consistently? |
DoDAF (US Department of Defense) organizes architecture descriptions into viewpoint families, each a set of prescribed views. Its center of gravity is interoperability: forcing hundreds of contractors' systems to document themselves the same way so they can be integrated and compared. MODAF was the UK's adaptation; both now converge on the NATO Architecture Framework (NAF). If you work in defense, aerospace, or national-scale public safety, the RFP will name these and compliance is non-negotiable; outside those worlds you'll never see them.
| Family | Name | Describes |
|---|---|---|
| AV | All Viewpoint | Scope, context, dictionary for the whole architecture description |
| CV | Capability | Capabilities, their taxonomy, phasing and dependencies |
| OV | Operational | Operational activities, nodes, information exchanges — the mission, technology-free |
| SV / SvcV | Systems / Services | The systems and services that realize the operational views, and their interfaces |
| DIV | Data & Information | Conceptual → logical → physical data models |
| StdV | Standards | Applicable technical standards and forecasts |
| PV | Project | Programs/projects delivering the capabilities |
Worth stealing even outside defense: the OV/SV split — describe the mission without technology first, then map systems onto it — is the same discipline as capability-before-application, enforced by contract.
The Business Architecture Guild's body of knowledge (with its own certification, CBA). Its premise: the business can and should be modeled independently of IT — then IT maps onto it. Four core artifact types interlock:
| Artifact | What it captures | How it's used |
|---|---|---|
| Capability map | What the business does (not how, not who) — Level 1: ~7–10 top capabilities; Level 2: their decompositions; Level 3: working detail. Stable across re-orgs because it ignores the org chart | The anchor for everything: heat-map it by investment, maturity, or pain to make portfolio arguments on one page |
| Value stream | End-to-end stages that deliver value to a stakeholder ("Acquire product: browse → select → pay → receive") | Cross-mapped to capabilities: which capabilities enable each stage — connecting what we do to why anyone cares |
| Information map | The business's core information concepts and their relationships, in business language | Feeds data architecture; arbitrates naming wars ("what exactly is an 'account'?") |
| Organization map | Business units mapped to the capabilities they perform | Exposes duplication ("three units all doing collections") and orphan capabilities nobody owns |
Heat mapping is the signature move: color the capability map by any lens — strategic importance, current maturity, IT spend, incident volume — and misalignment becomes visible to a board in seconds ("our most strategic capability has our weakest systems"). In TOGAF terms all of this slots into Phase B; in this skill it's Mode 4's foundation.
That's the theory. Now the practice: full-ceremony adoption — every phase, every deliverable — is rare and usually collapses under its own weight. The value is delivered through a handful of living artifacts, not through framework compliance. Practitioners steal the useful parts and quietly ignore the rest.
| Framework | Practical value | Verdict |
|---|---|---|
| Zachman | The mental model. When a stakeholder says “this diagram doesn't help me,” you've usually given a row-1 audience a row-4 artifact. | 30-min lens |
| TOGAF ADM | ADM as a scoping checklist, the baseline→target→gap spine, the shared governance vocabulary — and, bluntly, the certification as a hiring filter. | Borrow the spine |
| ArchiMate 3.x | Arguably more useful day-to-day than TOGAF itself: realization links answer “which capabilities break if we retire this app?” | Use in anger |
| C4 model | The diagrams developers actually read. Context + Container answer 90% of questions; stop there unless asked. | Default choice |
| arc42 + ADRs | The best value-to-ceremony ratio in the whole space. ADRs make decisions defensible two years later when someone asks “why Kafka?” | Highest ROI |
| FEAF / DoDAF / MODAF | Essential if you sell into government or defense — the RFP will name them. Otherwise you will likely never touch them. | Niche / mandated |
| Gartner / “pragmatic EA” | The attitude is the takeaway: measure EA by decisions influenced and money saved, not by models produced. | Attitude, not artifact |
| BIZBOK capability maps | The one-page capability map is the anchor artifact for portfolio rationalization: “we have four apps doing customer onboarding — why?” | Steal the map |
Where this skill sits: it deliberately builds on the four with the highest practical yield — C4, ArchiMate, TOGAF ADM, and arc42 + ADRs — and treats the rest as context you should recognize, not ceremony you should perform.
EA doesn't pay off evenly. These are the recurring situations where the artifacts genuinely change decisions — and for four of them, the full engagement is worked through below: trigger, artifact pipeline, and what “done” looks like.
Done looks like: every app has a disposition and a plateau; every platform choice has an ADR; the refactored systems have target-state C4 diagrams in their repos.
Done looks like: a capability map both CTOs sign, every duplicate resolved to a disposition with a date, and the contested decisions written down so they stay decided.
Done looks like: a new engineer reaches productive context in a day from the C4 diagrams and the decision log — without a single meeting.
Done looks like: one navigable chain from regulation text to the component that deletes the data — each hop an artifact you already maintain, not a document written for the audit.
Each of these looks like diligence from the inside. From the outside, it's why “enterprise architecture” has a reputation problem.
An EA team producing models nobody asked for, disconnected from delivery teams. The models are correct and irrelevant.
Attach every artifact to a live decision: a migration, a purchase, a review.
Attempting to fill the full Zachman matrix. Completeness becomes the goal; the map outgrows the territory and is stale before it's finished.
Use Zachman as a lens — trace one column when a question demands it.
Running all ten TOGAF phases with full deliverables for a change that needed a two-page vision and three ADRs. Rigor should scale with stakes.
Tailor: pick the phases the risk justifies, skip the rest deliberately.
Thoroughness as a failure mode: an arc42 doc so complete that nobody reads it, so it answers no one's questions and rots quietly.
Write LEAN or ESSENTIAL; let the reader's questions pull detail in.
The same system called “Billing Engine” in one diagram and “Invoice Service” in another. The most common EA defect — it silently breaks traceability.
Stable IDs, reused everywhere — one model under every diagram, doc, and ADR.
Architecture drawn in a slide tool, redrawn slightly differently for every meeting. No source of truth, so every version is equally wrong.
Diagrams as code, versioned in the repo next to what they describe.
Everything named on this page — capability maps, TIME scoring, C4 diagrams, arc42 docs, ADRs — is what the skill actually produces. Install it and ask in plain language.
/plugin marketplace add gauravs19/enterprise-architecture-skill /plugin install enterprise-architecture@gauravs19-skills