convez.ai
SkillProdutividadeAvançado
deeparchi-ai

TOGAF Skill - Framework de Arquitetura Empresarial

deeparchi-ai/togaf-skill

Metodologia TOGAF ADM e melhores práticas de arquitetura empresarial

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill que implementa o framework TOGAF (The Open Group Architecture Framework) e a metodologia ADM (Architecture Development Method) para arquitetura empresarial. Fornece orientações práticas sobre fases do ADM, artefatos arquiteturais, modelos de referência e governança de arquitetura para auxiliar arquitetos em projetos de transformação organizacional.

Instalação

$npx convez-ai deeparchi-ai/togaf-skill

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
3
Forks
6
Acompanhando
0
Saúde
37%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Guiar equipes através das fases do ADM para desenvolvimento de arquitetura
  • Criar e estruturar artefatos arquiteturais (visão, business, dados, aplicações, tecnologia)
  • Estabelecer governança e princípios de arquitetura em organizações
  • Executar análises de gap entre arquitetura baseline e target
  • Mapear capacidades de negócio e definir roadmaps de transformação

Veredito

Skill robusto para profissionais de arquitetura empresarial que precisam operacionalizar TOGAF em projetos reais. Cobre completamente o ciclo ADM com artefatos estruturados, mas exige experiência prévia em arquitetura e governança para máxima efetividade.

README

A tradução para o português deste README ainda está na fila.

TOGAF Skill - 企业架构框架

概述

TOGAF (The Open Group Architecture Framework) 是业界最广泛使用的企业架构框架。本技能提供 TOGAF 方法论、ADM 流程、架构内容框架和最佳实践指南,帮助架构师高效开展企业架构工作。

何时使用

当用户需要:

  • 了解或应用 TOGAF 企业架构框架
  • 执行 ADM(架构开发方法)流程
  • 创建 TOGAF 架构制品和交付物
  • 设计架构视图和视角
  • 建立架构治理机制
  • 制定架构原则和标准

TOGAF 核心组件

┌─────────────────────────────────────────────────────────────────────┐
│                    TOGAF Architecture Framework                      │
├─────────────────────────────────────────────────────────────────────┤
│                                                                      │
│  ┌─────────────────────────────────────────────────────────────┐   │
│  │              ADM (Architecture Development Method)           │   │
│  │                                                               │   │
│  │    Preliminary ──► A.Vision ──► B.Business ──► C.IS ──►     │   │
│  │         │                                          │         │   │
│  │         │    Requirements ◄──► D.Technology ◄─────┘         │   │
│  │         │    Management          │                           │   │
│  │         │                        ▼                           │   │
│  │         └────── H.Change ◄── G.Gov ◄── F.Migration ◄──     │   │
│  │                                                     │         │   │
│  │                            E.Opportunities ◄───────┘         │   │
│  │                              & Solutions                      │   │
│  └─────────────────────────────────────────────────────────────┘   │
│                                                                      │
│  ┌────────────────┐  ┌────────────────┐  ┌────────────────────┐   │
│  │   Enterprise   │  │   Architecture │  │   Architecture     │   │
│  │   Continuum    │  │   Repository   │  │   Capability       │   │
│  └────────────────┘  └────────────────┘  └────────────────────┘   │
│                                                                      │
└─────────────────────────────────────────────────────────────────────┘

ADM 阶段详解

Preliminary Phase(预备阶段)

目的: 准备组织实施企业架构

主要活动:

  • 定义架构组织和治理框架
  • 确认架构原则
  • 选择并定制架构框架
  • 实施架构工具

关键交付物:

  • Architecture Principles(架构原则)
  • Organizational Model for EA(EA组织模型)
  • Tailored Architecture Framework(定制架构框架)
  • Architecture Repository(架构库)初始化

Phase A: Architecture Vision(架构愿景)

目的: 开发架构愿景,获得利益相关者批准

主要活动:

  • 建立架构项目
  • 识别利益相关者和关注点
  • 确认业务目标和驱动力
  • 定义范围和约束
  • 确认架构原则
  • 开发架构愿景

关键交付物:

  • Statement of Architecture Work(架构工作声明)
  • Architecture Vision(架构愿景)
  • Stakeholder Map Matrix(利益相关者矩阵)
  • Communications Plan(沟通计划)

Phase B: Business Architecture(业务架构)

目的: 描述基线和目标业务架构

主要活动:

  • 选择参考模型、视角和工具
  • 开发基线业务架构描述
  • 开发目标业务架构描述
  • 执行差距分析
  • 定义路线图组件

关键交付物:

  • Business Architecture Document(业务架构文档)
  • Business Process Models(业务流程模型)
  • Business Capability Map(业务能力地图)
  • Organization Map(组织架构图)

Phase C: Information Systems Architecture(信息系统架构)

目的: 描述数据和应用架构

C1: Data Architecture(数据架构)

主要活动:

  • 开发基线数据架构描述
  • 开发目标数据架构描述
  • 执行差距分析

关键交付物:

  • Data Architecture Document(数据架构文档)
  • Data Entity/Business Function Matrix(数据实体/业务功能矩阵)
  • Conceptual Data Model(概念数据模型)
  • Logical Data Model(逻辑数据模型)

C2: Application Architecture(应用架构)

主要活动:

  • 开发基线应用架构描述
  • 开发目标应用架构描述
  • 执行差距分析

关键交付物:

  • Application Architecture Document(应用架构文档)
  • Application Portfolio Catalog(应用组合目录)
  • Application Communication Diagram(应用通信图)
  • Application/Data Matrix(应用/数据矩阵)

Phase D: Technology Architecture(技术架构)

目的: 描述技术基础设施

主要活动:

  • 开发基线技术架构描述
  • 开发目标技术架构描述
  • 执行差距分析

关键交付物:

  • Technology Architecture Document(技术架构文档)
  • Technology Standards Catalog(技术标准目录)
  • Technology Portfolio Catalog(技术组合目录)
  • Environments and Locations Diagram(环境和位置图)

Phase E: Opportunities and Solutions(机会与解决方案)

目的: 进行实施规划,识别交付载体

主要活动:

  • 确定关键项目
  • 评估依赖关系
  • 确认路线图
  • 定义架构合同

关键交付物:

  • Implementation and Migration Strategy(实施和迁移策略)
  • Architecture Roadmap(架构路线图)
  • Work Packages(工作包)
  • Solution Building Blocks (SBBs)

Phase F: Migration Planning(迁移规划)

目的: 制定详细的实施和迁移计划

主要活动:

  • 协调迁移计划
  • 完成架构合同
  • 确定业务价值
  • 确认架构路线图

关键交付物:

  • Implementation and Migration Plan(实施和迁移计划)
  • Transition Architectures(过渡架构)
  • Implementation Governance Model(实施治理模型)

Phase G: Implementation Governance(实施治理)

目的: 确保架构实施符合规范

主要活动:

  • 确认实施范围
  • 识别部署计划
  • 执行企业架构合规审查
  • 执行实施后评审

关键交付物:

  • Architecture Contract(架构合同)
  • Compliance Assessments(合规评估)
  • Architecture-compliant Implemented Systems(符合架构的实施系统)

Phase H: Architecture Change Management(架构变更管理)

目的: 管理架构变更

主要活动:

  • 建立变更管理流程
  • 管理变更请求
  • 评估变更影响

关键交付物:

  • Architecture Updates(架构更新)
  • Change Requests(变更请求)
  • Assessment Reports(评估报告)

Requirements Management(需求管理)

目的: 贯穿 ADM 全程,管理架构需求

主要活动:

  • 识别和存储需求
  • 确定需求优先级
  • 管理需求变更

架构内容框架

Content Metamodel(内容元模型)

┌──────────────────────────────────────────────────────────────────────┐
│                      Architecture Content Metamodel                   │
├──────────────────────────────────────────────────────────────────────┤
│                                                                       │
│   ┌─────────────┐    ┌─────────────┐    ┌─────────────┐             │
│   │  Business   │    │   Data      │    │ Application │             │
│   │  Entities   │    │  Entities   │    │  Entities   │             │
│   ├─────────────┤    ├─────────────┤    ├─────────────┤             │
│   │ • Actor     │    │ • Data      │    │ • App       │             │
│   │ • Role      │    │   Entity    │    │   Component │             │
│   │ • Business  │    │ • Logical   │    │ • App       │             │
│   │   Service   │    │   Data      │    │   Service   │             │
│   │ • Process   │    │   Component │    │ • Interface │             │
│   │ • Function  │    │ • Physical  │    │             │             │
│   │ • Event     │    │   Data      │    │             │             │
│   │ • Product   │    │   Component │    │             │             │
│   │ • Contract  │    │             │    │             │             │
│   └─────────────┘    └─────────────┘    └─────────────┘             │
│                                                                       │
│   ┌─────────────┐    ┌─────────────────────────────────────────┐    │
│   │ Technology  │    │           Cross-Cutting Entities        │    │
│   │  Entities   │    ├─────────────────────────────────────────┤    │
│   ├─────────────┤    │ • Location    • Capability              │    │
│   │ • Platform  │    │ • Assumption  • Constraint              │    │
│   │   Service   │    │ • Requirement • Gap                     │    │
│   │ • Tech      │    │ • Principle   • Work Package            │    │
│   │   Component │    │ • Objective   • Standard                │    │
│   │ • Node      │    │ • Driver      • Goal                    │    │
│   └─────────────┘    └─────────────────────────────────────────┘    │
│                                                                       │
└──────────────────────────────────────────────────────────────────────┘

Building Blocks(构建块)

ABB - Architecture Building Block(架构构建块)

定义功能和内容的逻辑组件,与具体实现无关。

┌─────────────────────────────────────────────────────────────────────┐
│                        ABB 类型示例                                  │
├─────────────────────────────────────────────────────────────────────┤
│                                                                      │
│  Business ABBs:                                                      │
│  • Customer Onboarding Capability                                    │
│  • Payment Processing Capability                                     │
│  • Risk Assessment Capability                                        │
│                                                                      │
│  Data ABBs:                                                          │
│  • Customer Data Service                                             │
│  • Transaction Data Repository                                       │
│  • Reference Data Management                                         │
│                                                                      │
│  Application ABBs:                                                   │
│  • Identity Management Service                                       │
│  • Workflow Engine                                                   │
│  • API Gateway                                                       │
│                                                                      │
│  Technology ABBs:                                                    │
│  • Container Platform                                                │
│  • Message Queue Service                                             │
│  • Database Service                                                  │
│                                                                      │
└─────────────────────────────────────────────────────────────────────┘

SBB - Solution Building Block(解决方案构建块)

ABB 的具体实现,指定产品和技术。

┌─────────────────────────────────────────────────────────────────────┐
│                        SBB 示例(对应上述 ABBs)                      │
├─────────────────────────────────────────────────────────────────────┤
│                                                                      │
│  ABB: Container Platform                                             │
│  SBBs:                                                               │
│  • Kubernetes on AWS EKS                                             │
│  • Docker + Kubernetes on Azure AKS                                  │
│  • OpenShift Container Platform                                      │
│                                                                      │
│  ABB: Message Queue Service                                          │
│  SBBs:                                                               │
│  • Apache Kafka                                                      │
│  • RabbitMQ                                                          │
│  • AWS SQS                                                           │
│                                                                      │
│  ABB: API Gateway                                                    │
│  SBBs:                                                               │
│  • Kong Gateway                                                      │
│  • AWS API Gateway                                                   │
│  • Azure API Management                                              │
│                                                                      │
└─────────────────────────────────────────────────────────────────────┘

视图和视角

核心视角(Viewpoints)

视角用途利益相关者
Business Process Viewpoint展示业务流程和关联业务分析师、流程负责人
Application Behavior Viewpoint展示应用行为和交互应用架构师、开发者
Technology Deployment Viewpoint展示技术部署情况技术架构师、运维人员
Capability Map Viewpoint展示业务能力及其关系高管、战略规划人员
Information Map Viewpoint展示信息流动和存储数据架构师、信息管理人员
Migration Viewpoint展示迁移路径和阶段项目经理、架构师

视图类型

┌─────────────────────────────────────────────────────────────────────┐
│                         Architecture Views                           │
├─────────────────────────────────────────────────────────────────────┤
│                                                                      │
│  Strategic Views:                                                    │
│  ├── Business Model Canvas                                           │
│  ├── Capability Heat Map                                             │
│  └── Strategic Roadmap                                               │
│                                                                      │
│  Business Views:                                                     │
│  ├── Business Process Model                                          │
│  ├── Organization Chart                                              │
│  ├── Value Stream Map                                                │
│  └── Business Service Catalog                                        │
│                                                                      │
│  Information System Views:                                           │
│  ├── Application Landscape                                           │
│  ├── Data Flow Diagram                                               │
│  ├── Integration Map                                                 │
│  └── Application/Data Matrix                                         │
│                                                                      │
│  Technology Views:                                                   │
│  ├── Infrastructure Diagram                                          │
│  ├── Network Topology                                                │
│  ├── Deployment Diagram                                              │
│  └── Technology Standards Matrix                                     │
│                                                                      │
│  Cross-Cutting Views:                                                │
│  ├── Principles Catalog                                              │
│  ├── Standards Catalog                                               │
│  ├── Gap Analysis Matrix                                             │
│  └── Transition Architecture Roadmap                                 │
│                                                                      │
└─────────────────────────────────────────────────────────────────────┘

架构原则

原则结构

每个架构原则包含以下要素:

要素描述
Name(名称)简短的原则标题
Statement(声明)原则的正式描述
Rationale(依据)为什么采用这个原则
Implications(影响)原则对架构的具体影响

示例原则

┌─────────────────────────────────────────────────────────────────────┐
│                    Architecture Principle Example                    │
├─────────────────────────────────────────────────────────────────────┤
│                                                                      │
│  Name: Technology Independence                                       │
│  技术独立性                                                          │
│                                                                      │
│  Statement:                                                          │
│  架构设计应独立于特定技术和产品,使业务不被锁定于特定供应商。             │
│                                                                      │
│  Rationale:                                                          │
│  • 降低供应商锁定风险                                                 │
│  • 提高技术选型灵活性                                                 │
│  • 便于技术迁移和升级                                                 │
│                                                                      │
│  Implications:                                                       │
│  • 使用标准化协议和接口                                               │
│  • 采用开放标准                                                       │
│  • 设计抽象层隔离具体技术                                             │
│  • 避免深度集成特定产品专有功能                                        │
│                                                                      │
└─────────────────────────────────────────────────────────────────────┘

架构治理

治理框架

┌─────────────────────────────────────────────────────────────────────┐
│                    Architecture Governance Framework                 │
├─────────────────────────────────────────────────────────────────────┤
│                                                                      │
│  ┌─────────────────────────────────────────────────────────────┐   │
│  │                    Governance Principles                     │   │
│  │   • Accountability  • Transparency  • Consistency            │   │
│  └─────────────────────────────────────────────────────────────┘   │
│                              │                                       │
│  ┌─────────────────────────────────────────────────────────────┐   │
│  │                    Governance Organization                   │   │
│  │                                                               │   │
│  │   Architecture Board ──► Architecture Review Board           │   │
│  │         │                         │                           │   │
│  │         ▼                         ▼                           │   │
│  │   EA Team ◄────────────► Domain Architecture Teams           │   │
│  └─────────────────────────────────────────────────────────────┘   │
│                              │                                       │
│  ┌─────────────────────────────────────────────────────────────┐   │
│  │                    Governance Processes                      │   │
│  │                                                               │   │
│  │   • Architecture Compliance Review                           │   │
│  │   • Architecture Exception Process                           │   │
│  │   • Architecture Change Management                           │   │
│  │   • Architecture Communication                               │   │
│  └─────────────────────────────────────────────────────────────┘   │
│                                                                      │
└─────────────────────────────────────────────────────────────────────┘

合规评审清单

检查项描述
原则符合性是否遵循架构原则
标准符合性是否使用批准的技术标准
参考架构一致性是否与参考架构对齐
安全符合性是否满足安全要求
可重用性是否考虑组件重用
可互操作性是否支持系统互操作

架构库

Architecture Repository 结构

Architecture Repository
├── Architecture Metamodel
│   └── Content Metamodel Definition
├── Architecture Capability
│   ├── Skills Matrix
│   ├── Role Definitions
│   └── Training Materials
├── Architecture Landscape
│   ├── Baseline Architecture
│   │   ├── Business Architecture
│   │   ├── Data Architecture
│   │   ├── Application Architecture
│   │   └── Technology Architecture
│   └── Target Architecture
│       ├── Business Architecture
│       ├── Data Architecture
│       ├── Application Architecture
│       └── Technology Architecture
├── Standards Information Base
│   ├── Technology Standards
│   ├── Product Information
│   └── Vendor Information
├── Reference Library
│   ├── Reference Models
│   ├── Patterns
│   └── Templates
├── Governance Log
│   ├── Decision Log
│   ├── Compliance Assessments
│   └── Dispensations
└── Architecture Requirements Repository
    ├── Requirements
    ├── Constraints
    └── Assumptions

最佳实践

1. ADM 迭代应用

┌─────────────────────────────────────────────────────────────────────┐
│                     ADM Iteration Approaches                         │
├─────────────────────────────────────────────────────────────────────┤
│                                                                      │
│  Baseline-First:                                                     │
│  首先完整描述基线架构,然后开发目标架构                                  │
│  适用于:遗留系统现代化、架构整合项目                                    │
│                                                                      │
│  Target-First:                                                       │
│  首先定义目标架构,然后评估当前状态                                      │
│  适用于:新系统开发、数字化转型                                          │
│                                                                      │
│  Increment-Based:                                                    │
│  按能力域增量开发架构                                                   │
│  适用于:大型企业架构、敏捷交付环境                                      │
│                                                                      │
│  Top-Down:                                                           │
│  从业务架构开始,逐层向下开发                                           │
│  适用于:战略驱动的架构开发                                             │
│                                                                      │
│  Bottom-Up:                                                          │
│  从技术现状开始,向上整合                                               │
│  适用于:技术整合、基础设施优化                                          │
│                                                                      │
└─────────────────────────────────────────────────────────────────────┘

2. 利益相关者管理

利益相关者关注点沟通方式
CEO/CIO业务价值、战略对齐Executive Summary
业务负责人业务影响、时间表Business View
项目经理范围、进度、资源Roadmap, Work Packages
开发团队技术细节、接口规范Technical Specifications
运维团队部署、运维要求Deployment View
安全团队安全要求、风险Security Architecture

3. 敏捷与 TOGAF 结合

┌─────────────────────────────────────────────────────────────────────┐
│                    Agile + TOGAF Integration                         │
├─────────────────────────────────────────────────────────────────────┤
│                                                                      │
│  Architecture Runway:                                                │
│  ├── 提前 2-3 个 Sprint 准备架构决策                                   │
│  ├── 以 ABB 粒度定义架构                                               │
│  └── 在 Sprint 中实现 SBB                                             │
│                                                                      │
│  Just-Enough Architecture:                                           │
│  ├── 仅定义必要的架构约束                                               │
│  ├── 推迟非关键决策                                                    │
│  └── 允许设计在实现中演进                                               │
│                                                                      │
│  Architecture Governance in Agile:                                   │
│  ├── 将架构审查纳入 Sprint Review                                      │
│  ├── 架构师参与日常站会                                                 │
│  └── 使用 Architecture Backlog 管理架构工作                            │
│                                                                      │
└─────────────────────────────────────────────────────────────────────┘

资源文件

模板文件

  • assets/adm-phases.drawio - ADM 阶段流程图
  • assets/building-blocks-template.xlsx - 构建块模板

参考文档

  • references/adm-deliverables-guide.md - ADM 交付物指南
  • references/viewpoints-catalog.md - 视角目录
  • references/principles-template.md - 原则模板

脚本工具

  • scripts/validate-artifacts.js - 架构制品验证脚本

与其他框架的集成

TOGAF + ArchiMate

ArchiMate 是 TOGAF 推荐的建模语言,用于可视化架构内容:

TOGAF ADM PhaseArchiMate 视角
Business ArchitectureBusiness Layer Views
Application ArchitectureApplication Layer Views
Data ArchitecturePassive Structure Views
Technology ArchitectureTechnology Layer Views

TOGAF + BIAN

在银行业,可以结合 BIAN 框架:

  • 使用 BIAN Service Domains 作为业务能力定义
  • TOGAF ADM 提供架构开发流程
  • ArchiMate 用于架构建模

常见问题

Q1: 如何确定 ADM 的起点?

A: 根据项目需求选择:

  • 新组织/新业务:从 Preliminary 开始
  • 现有架构更新:从 Phase A 开始
  • 增量改进:可以直接进入相关架构阶段(B/C/D)

Q2: 如何处理 ADM 阶段的重叠?

A: ADM 是迭代的,阶段可以并行:

  • B/C/D 阶段可以迭代执行
  • Requirements Management 贯穿全程
  • 根据项目规模决定迭代粒度

Q3: 如何在敏捷环境中应用 TOGAF?

A:

  • 使用轻量级的 ADM 迭代
  • 聚焦于架构 Runway
  • 将架构工作融入 Sprint
  • 使用 Architecture Backlog

Q4: ABB 和 SBB 的关系?

A:

  • ABB 是逻辑定义,独立于实现
  • SBB 是 ABB 的具体实现
  • 一个 ABB 可以有多个 SBB 选项
  • 选择 SBB 时考虑:成本、能力、风险、战略对齐

更新日志

  • v1.0.0 (2025-01-24): 初始版本
    • TOGAF ADM 完整阶段描述
    • 架构内容框架
    • 构建块指南
    • 视图和视角
    • 架构治理框架
    • 最佳实践和集成指南

相关资源

Ver o original no GitHub

Bom para

Relacionados