Create ArchiMate enterprise architecture diagrams using PlantUML stdlib macros. Best for TOGAF viewpoints, layered EA modeling (Business/Application/Technology), motivation analysis, and migration planning.
The ArchiMate AI skill enables users to generate comprehensive enterprise architecture diagrams using PlantUML macros specifically designed for ArchiMate standards. It simplifies the creation of structured diagrams for organizations, allowing architects and analysts to visually represent business processes, applications, technology infrastructure, motivation elements, and strategic considerations. By using this skill, users can automate diagram creation and maintain consistency with TOGAF viewpoints and layered enterprise architecture models, reducing the manual effort typically involved in mapping complex organizational structures and interactions.
This skill provides a wide range of macros for all major ArchiMate layers, including Business, Application, Technology, Motivation, and Strategy. Each macro corresponds to a specific ArchiMate element, such as actors, roles, processes, services, goals, or devices, and supports clear labeling and relationships. Diagrams are organized into layers using rectangles and relationships are easily defined with directional suffixes. The skill enforces critical syntax rules, such as starting diagrams with `@startuml`, ending with `@enduml`, and including the ArchiMate macros file before use, ensuring that all diagrams render correctly when processed by PlantUML.
Typical use cases include enterprise architecture planning, migration planning, motivation analysis, and layered modeling of business, application, and technology components. It is particularly useful for TOGAF practitioners, business analysts, solution architects, and enterprise architects who need to document and communicate complex system structures. The skill is also suitable for teams adopting standardized visualizations for strategic decision-making, providing a consistent and reusable framework for creating professional diagrams across different platforms and documentation environments.
Begin with a PlantUML code block using plantuml or puml, include the ArchiMate macros with `!include <archimate/Archimate>`, and then declare elements using the provided macros.
Diagrams can be rendered in any environment that supports PlantUML, including Markdown Viewer extensions on Chrome, Edge, Firefox, and VS Code.
While it's possible to declare elements individually, grouping them into layers using `rectangle "Layer" { ... }` is recommended for clarity and adherence to ArchiMate standards.
Relationships must use the provided `Rel_Type` macros with optional directional suffixes such as `_Up`, `_Down`, `_Left`, `_Right` to control directionality.
No additional software is required beyond a PlantUML-compatible renderer and the ArchiMate macros file included in the skill.
Quick Setup:
.claude/skills/Repository
markdown-viewer/skills