Enterprise ArchitectureZachman Framework

Zachman Framework Artifacts and Deliverables: Complete Documentation Checklist

TT
TopicTrick Team
Zachman Framework Artifacts and Deliverables: Complete Documentation Checklist

Zachman Framework Artifacts and Deliverables: Complete Documentation Checklist

Many enterprises struggle with Zachman because they don't know what artifacts to create. Is it just descriptions? Diagrams? Code? This post provides a complete checklist of deliverables for each of the 36 cells.


What Are Zachman Artifacts?

Artifacts are the documentation and models produced at each cell of the Zachman matrix. They represent what that particular row/column perspective produces.

For example:

  • Planner/What cell might produce: Business entity list (what are we trying to track?)
  • Owner/What cell might produce: Current data inventory (what data do we actually have?)
  • Designer/What cell might produce: Logical data model (ER diagram)
  • Builder/What cell might produce: Database schema (DDL scripts)

Complete Zachman Artifacts Checklist

Row 1: Planner (Strategic Scope)

ColumnArtifactDescriptionPagesFormat
WhatBusiness Entity ListEntities in scope (customer, product, order, etc.)2-5Table/List
HowBusiness Process ModelHigh-level business processes, value chain3-8Diagram (BPMN)
WhereGeographic ScopeCountries, regions, data residency requirements1-3Map/Table
WhoStakeholder AnalysisExecutives, business units, key roles2-4Matrix
WhenStrategic TimelineMulti-year roadmap, milestones2-5Gantt chart
WhyBusiness StrategyMission, vision, strategic objectives, ROI5-10Narrative

Row 2: Owner (Current State)

ColumnArtifactDescriptionPagesFormat
WhatData InventoryDatabases, tables, record counts, quality metrics5-15Spreadsheet
HowProcess As-IsCurrent workflows, manual steps, pain points10-20Process maps
WhereInfrastructure As-IsCurrent datacenters, servers, networks3-8Diagram
WhoOrganizational StructureReporting hierarchy, roles, responsibilities2-5Org chart
WhenCurrent SLAsUptime, batch schedules, response times2-4Table
WhyBusiness ImpactRevenue by product, churn, customer satisfaction3-5Dashboard

Row 3: Designer (Target Architecture)

ColumnArtifactDescriptionPagesFormat
WhatLogical Data ModelER diagram (normalized), entities, relationships5-15Diagram
HowTarget Business ArchitectureFuture workflows, process automation, integration10-20BPMN diagram
WhereTarget System ArchitectureCloud/on-prem, regions, zones, DR strategy5-10Architecture diagram
WhoTarget Organizational ModelFuture roles, responsibilities, training needs3-8Org chart + matrix
WhenTarget Timeline & SLAsDesired batch schedules, response times, uptime2-4Table
WhyRequirements & ConstraintsFunctional requirements, non-functional (performance, security)15-30Requirements doc

Row 4: Builder (Implementation Design)

ColumnArtifactDescriptionPagesFormat
WhatPhysical Database SchemaDDL for target RDBMS/NoSQL, indexes, partitions10-20SQL/YAML
HowAPI SpecificationsREST/GraphQL endpoints, request/response, error codes20-40OpenAPI/Swagger
WhereInfrastructure SpecificationsCloud services (EC2, RDS, etc.), sizing, regions10-20Terraform/CloudFormation
WhoAccess Control DesignRBAC, service accounts, security groups5-10IAM policies
WhenJob Schedule DesignCron jobs, event handlers, batch job specifications5-10Job definitions
WhyConfiguration DesignEnvironment variables, feature flags, policies5-15YAML/JSON configs

Row 5: Sub-Contractor (Implementation)

ColumnArtifactDescriptionPagesFormat
WhatDatabase ScriptsRunnable DDL, seed data, migration scripts50-200+SQL/Python
HowApplication CodeSource code, tests, documentation1000+ linesGitHub repo
WhereDeployment AutomationTerraform, Kubernetes manifests, Docker100-500 linesInfrastructure-as-code
WhoProvisioning ScriptsUser creation, access provisioning automation50-200 linesPython/Bash
WhenJob ImplementationsScheduled jobs, event handlers, message consumers100-500 linesPython/Java/Node.js
WhyPolicy & Config CodeFeature flags, compliance rules, security policies50-200 linesPython/YAML

Row 6: Enterprise (Live System)

ColumnArtifactDescriptionFormatUpdate Frequency
WhatLive Data MetricsRecord counts, growth, quality, storage usageDashboardDaily
HowOperational MetricsThroughput, latency, success rates, errorsDashboardReal-time
WhereInfrastructure StatusUptime, CPU/memory utilization, geographic distributionDashboardReal-time
WhoUser Activity ReportActive users, access patterns, provisioning queueReportDaily
WhenJob Execution ReportScheduled job status, SLA compliance, latencyReportDaily
WhyBusiness MetricsRevenue, churn, NPS, cost, efficiencyDashboardMonthly

Documentation Standards

Standard Template for Each Artifact

Title: Clear, descriptive title (e.g., "Customer Entity Definition")

Purpose: Why does this artifact exist? Who uses it?

Scope: What's included/excluded? What assumptions are made?

Content: The actual artifact (diagram, table, code, etc.)

Assumptions: What is assumed to be true?

Dependencies: What other artifacts does this depend on?

Owner: Who maintains this artifact?

Version: Version number, last updated date

Review Status: Draft / Under Review / Approved / Archived


Validation Checklist: Have You Completed Zachman?

Row 1 (Planner)

  • Business entity list defined
  • Business processes mapped
  • Geographic scope documented
  • Key stakeholders identified
  • Strategic timeline (roadmap)
  • ROI and business case documented

Row 2 (Owner)

  • Current data inventory completed
  • As-is process maps documented
  • Current infrastructure documented
  • Organizational structure clear
  • Current SLAs identified
  • Business metrics/KPIs baseline measured

Row 3 (Designer)

  • Logical data model created
  • Target processes designed
  • System architecture designed
  • Target org structure defined
  • Target SLAs/requirements specified
  • Functional & non-functional requirements detailed

Row 4 (Builder)

  • Database schema designed for specific tech
  • APIs specified (OpenAPI format)
  • Infrastructure designed (cloud services selected)
  • Access control designed (RBAC)
  • Job schedules designed
  • Configurations designed

Row 5 (Sub-Contractor)

  • Database scripts created and tested
  • Application source code written
  • Deployment automation created
  • Provisioning scripts written
  • Job implementations coded
  • Policies encoded (as code)

Row 6 (Enterprise)

  • Live metrics dashboard operational
  • Monitoring alerts configured
  • Operational reports automated
  • SLA tracking live
  • Business metrics tracked

Common Mistakes in Zachman Artifacts

  1. Too much detail too early: Don't specify exact database column names in Row 1. That belongs in Row 4.

  2. Mixing rows: Designer row should not contain Java code (that's Sub-Contractor). Keep rows distinct.

  3. No version control: Artifacts should be in git (or doc system with version history).

  4. Outdated artifacts: Artifacts become stale. Update them when reality changes.

  5. No review process: Artifacts should be reviewed by stakeholders before approval.


Artifact Ownership & Lifecycle

ArtifactOwnerReview CyclesArchival
StrategyCTO/CISOAnnualKeep forever
Current stateOperationsQuarterlyUpdate when things change
Target architectureArchitectsAnnualKeep for historical reference
Technical specsTech leadsPer sprint/quarterKeep for implementation reference
CodeDevelopersContinuous (git)Keep in git indefinitely
Operational metricsOperationsDaily/weeklyKeep 1-2 years for trending

Artifact Approval Flow

text
Draft (created)
   ↓
Under Review (shared with stakeholders)
   ↓
Comments/feedback collected
   ↓
Revisions made
   ↓
Approved (signed off by owner)
   ↓
Published (shared with teams)
   ↓
Implementation (teams use artifact)
   ↓
Reality (actual system deployed)
   ↓
Archive (when superseded by new artifact)

Key Takeaways

  1. Each Zachman cell produces artifacts: Tangible documentation/models.

  2. Artifacts evolve by row: Different level of detail at each row.

  3. Artifacts must be maintained: Version control, review cycles, ownership.

  4. Validation: Checkl that all 36 cells have artifacts (or explicitly excluded).

  5. Artifacts communicate: They're not for architects alone; they guide implementation teams.


Next Steps

  • Create artifact inventory for your enterprise (which ones do you have? which are missing?)
  • Define governance (who owns which artifacts? update cycles?)
  • Implement version control (git or document management system)

Complete Zachman artifacts ensure nothing is overlooked and everyone understands the architecture.


Meta Keywords: Zachman artifacts, deliverables, documentation, architecture governance, templates.