Zachman Analysis
When to Use This Skill
Use this skill when you need to:
- Analyze architecture from a specific stakeholder perspective
- Ensure complete coverage across different viewpoints
- Check which architectural aspects are documented
- Understand what questions each perspective asks
Keywords: zachman, viewpoint, perspective, interrogative, what, how, where, who, when, why, planner, owner, designer, builder
Zachman Framework 3.0 Overview
The Zachman Framework is a 6x6 ontology for classifying enterprise architecture artifacts. It's a classification schema (taxonomy), not a methodology.
Key insight: TOGAF tells you how to create architecture. Zachman tells you how to organize what you create.
The Matrix
Columns (Interrogatives)
Each column answers a fundamental question:
| Column | Interrogative | Focus | Artifacts | | --- | --- | --- | --- | | 1 | What (Data) | Things of interest | Data models, entity lists | | 2 | How (Function) | Processes and transformations | Process flows, use cases | | 3 | Where (Network) | Locations and distribution | Network diagrams, site maps | | 4 | Who (People) | Roles and responsibilities | Org charts, RACI matrices | | 5 | When (Time) | Events and schedules | Timelines, event models | | 6 | Why (Motivation) | Goals and constraints | Business drivers, rules |
Rows (Perspectives)
Each row represents a stakeholder level with increasing detail:
| Row | Perspective | Audience | Level | | --- | --- | --- | --- | | 1 | Planner/Executive | Board, C-suite | Scope/Context | | 2 | Owner/Business | Business managers | Business model | | 3 | Designer/Architect | Solution architects | Logical design | | 4 | Builder/Engineer | Developers, engineers | Physical design | | 5 | Subcontractor/Technician | Implementers | Detailed specs | | 6 | User/Operations | End users, operators | Running system |
Critical Limitation: Code Extraction Capabilities
IMPORTANT: Not all Zachman perspectives can be extracted from code analysis.
| Row | Perspective | Code Extraction | Notes | | --- | --- | --- | --- | | 1 | Planner | Cannot extract | Requires strategic context, executive input | | 2 | Owner | Cannot extract | Requires business documentation, stakeholder interviews | | 3 | Designer | Partial | Can infer structure; design rationale missing | | 4 | Builder | Strong | Technologies, specs visible in code | | 5 | Subcontractor | Strong | Configurations, implementations in code | | 6 | User | Limited | Requires runtime data, deployment configs |
What This Means
- Rows 4-5: This plugin can analyze code and extract useful information
- Rows 1-3: This plugin can guide structured interviews and documentation review, but cannot generate content from code alone
- Row 6: Requires access to running systems and operational data
Using the Matrix
For Coverage Checking
Use the matrix as a checklist to ensure documentation completeness:
What How Where Who When Why
Planner [ ] [ ] [ ] [ ] [ ] [ ]
Owner [ ] [ ] [ ] [ ] [ ] [ ]
Designer [ ] [ ] [ ] [ ] [ ] [ ]
Builder [x] [x] [x] [ ] [ ] [ ]
Subcontr [x] [x] [x] [ ] [ ] [ ]
User [ ] [ ] [ ] [ ] [ ] [ ]
For Specific Analysis
To analyze a specific cell:
- Identify the row (stakeholder perspective)
- Identify the column (interrogative)
- Determine if code extraction is possible
- If rows 1-3: Guide human input gathering
- If rows 4-6: Analyze codebase for relevant information
Cell Examples
Row 4 (Builder) Examples
| Column | Question | Code Analysis Can Find | | --- | --- | --- | | What | What data structures? | Models, schemas, types | | How | How is it built? | Algorithms, patterns | | Where | Where does it run? | Deployment configs | | Who | Who maintains it? | Git history, CODEOWNERS | | When | When does it execute? | Schedulers, triggers | | Why | Why this approach? | ADRs, comments |
Row 1 (Planner) Examples - Require Human Input
| Column | Question | Requires | | --- | --- | --- | | What | What are business entities? | Business glossary | | How | What are core processes? | Process documentation | | Where | Where do we operate? | Business geography | | Who | What is the org structure? | Org chart | | When | What are business cycles? | Business calendar | | Why | What are strategic goals? | Strategy documents |
Wizard Mode
If you're unsure which row/column to use:
Step 1: Who's the audience?
- Executives → Row 1 (Planner)
- Business managers → Row 2 (Owner)
- Architects → Row 3 (Designer)
- Developers → Row 4 (Builder)
- Implementers → Row 5 (Subcontractor)
- Operations → Row 6 (User)
Step 2: What question?
- About data/things → Column 1 (What)
- About processes → Column 2 (How)
- About locations → Column 3 (Where)
- About people/roles → Column 4 (Who)
- About timing/events → Column 5 (When)
- About goals/rules → Column 6 (Why)
Practical Application
Minimum Viable Coverage
For most projects, ensure at least:
- Row 3, Column 1-2 (Designer: What & How) - Architecture diagrams
- Row 4, Column 1-2 (Builder: What & How) - Technical specs
- Row 4, Column 6 (Builder: Why) - ADRs
Comprehensive Coverage
For enterprise-scale work:
- All cells for rows 3-5
- Key cells for rows 1-2 (with stakeholder input)
Memory References
For detailed limitations, see references/zachman-limitations.md.
For the complete matrix, see references/zachman-overview.md.
Version History
- v1.0.0 (2025-12-05): Initial release
- Zachman Framework 3.0 matrix documentation
- Critical limitation: code extraction capabilities by row
- Wizard mode for row/column selection
- Practical application and minimum viable coverage
Last Updated
Date: 2025-12-05 Model: claude-opus-4-5-20251101