Marketplace

zachman-analysis

Apply Zachman Framework perspective analysis with honest limitations. Analyze architecture from specific row/column perspectives.

allowed_tools: Read, Glob, Grep

$ Installieren

git clone https://github.com/melodic-software/claude-code-plugins /tmp/claude-code-plugins && cp -r /tmp/claude-code-plugins/plugins/enterprise-architecture/skills/zachman-analysis ~/.claude/skills/claude-code-plugins

// tip: Run this command in your terminal to install the skill


name: zachman-analysis description: Apply Zachman Framework perspective analysis with honest limitations. Analyze architecture from specific row/column perspectives. allowed-tools: Read, Glob, Grep

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:

ColumnInterrogativeFocusArtifacts
1What (Data)Things of interestData models, entity lists
2How (Function)Processes and transformationsProcess flows, use cases
3Where (Network)Locations and distributionNetwork diagrams, site maps
4Who (People)Roles and responsibilitiesOrg charts, RACI matrices
5When (Time)Events and schedulesTimelines, event models
6Why (Motivation)Goals and constraintsBusiness drivers, rules

Rows (Perspectives)

Each row represents a stakeholder level with increasing detail:

RowPerspectiveAudienceLevel
1Planner/ExecutiveBoard, C-suiteScope/Context
2Owner/BusinessBusiness managersBusiness model
3Designer/ArchitectSolution architectsLogical design
4Builder/EngineerDevelopers, engineersPhysical design
5Subcontractor/TechnicianImplementersDetailed specs
6User/OperationsEnd users, operatorsRunning system

Critical Limitation: Code Extraction Capabilities

IMPORTANT: Not all Zachman perspectives can be extracted from code analysis.

RowPerspectiveCode ExtractionNotes
1PlannerCannot extractRequires strategic context, executive input
2OwnerCannot extractRequires business documentation, stakeholder interviews
3DesignerPartialCan infer structure; design rationale missing
4BuilderStrongTechnologies, specs visible in code
5SubcontractorStrongConfigurations, implementations in code
6UserLimitedRequires 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:

  1. Identify the row (stakeholder perspective)
  2. Identify the column (interrogative)
  3. Determine if code extraction is possible
  4. If rows 1-3: Guide human input gathering
  5. If rows 4-6: Analyze codebase for relevant information

Cell Examples

Row 4 (Builder) Examples

ColumnQuestionCode Analysis Can Find
WhatWhat data structures?Models, schemas, types
HowHow is it built?Algorithms, patterns
WhereWhere does it run?Deployment configs
WhoWho maintains it?Git history, CODEOWNERS
WhenWhen does it execute?Schedulers, triggers
WhyWhy this approach?ADRs, comments

Row 1 (Planner) Examples - Require Human Input

ColumnQuestionRequires
WhatWhat are business entities?Business glossary
HowWhat are core processes?Process documentation
WhereWhere do we operate?Business geography
WhoWhat is the org structure?Org chart
WhenWhat are business cycles?Business calendar
WhyWhat 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

Repository

melodic-software
melodic-software
Author
melodic-software/claude-code-plugins/plugins/enterprise-architecture/skills/zachman-analysis
3
Stars
0
Forks
Updated4d ago
Added1w ago