skills.rest
meaningfy-ws
meaningfy-wsOFFICIAL
Explore all skills by this author →
WebsiteGitHub

solution-architecture

Design and document enterprise systems using contract-first and specification-first methods.

2|1|Updated Jan 4, 2026
Search Tags:#architecture#ADR#UML#C4#ArchiMate#LinkML#Enterprise Architect
One-click install
npx skills add https://github.com/meaningfy-ws/agent-skills --skill solution-architecture-meaningfy-ws
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: solution-architecture
Source: https://github.com/meaningfy-ws/agent-skills/tree/main/skills/architecture
Command: npx skills add https://github.com/meaningfy-ws/agent-skills --skill solution-architecture-meaningfy-ws

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps architecture teams design, document, and validate complex systems using contract-first, documentation-first, and specification-first approaches, ensuring traceability from business drivers to technical implementation.

Core Features & Use Cases

  • C4-based modeling: Context, Container, Component, and Code views complemented by ArchiMate and UML notations.
  • ADR-driven decisions: Architecture decisions organized by C4 level and linked to deliverables.
  • Deliverables orchestration: Models in Enterprise Architect (Sparks), architecture documents, and formal data structures (LinkML, OpenAPI/AsyncAPI).
  • Contract-first design: Specifications in OpenAPI, AsyncAPI, and LinkML are the canonical contracts behind diagrams and code.

Quick Start

Define your architecture goals, identify drivers, create ADRs, craft specifications, and build models following the project structure.

Frequently Asked Questions about solution-architecture

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I document architecture decisions using ADRs with C4 models?▼

You can document architecture decisions by creating ADRs organized by C4 level and linking them to deliverables. This approach traces decisions from business drivers through context, container, component, and code views to formal artifacts.

What is contract-first architecture design and how does it work with OpenAPI and LinkML?▼

Contract-first design uses OpenAPI, AsyncAPI, and LinkML specifications as canonical contracts behind diagrams and code. This method ensures formal data structures and specifications drive the architecture artifacts directly.

How do I create enterprise architecture models in Enterprise Architect using ArchiMate and UML?▼

Enterprise architecture models are created using ArchiMate and UML notations complemented by C4 views. The skill orchestrates these models in Enterprise Architect (Sparks) alongside architecture documents to produce traceable deliverables.

Does this approach support specification-first architecture design for enterprise systems?▼

Yes, specification-first design is fully supported. The skill relies on OpenAPI, AsyncAPI, and LinkML specifications as canonical contracts, guiding architecture teams from business drivers to formal, production-ready artifacts.

Can I use C4 modeling for enterprise system architecture documentation?▼

C4-based modeling supports context, container, component, and code views for enterprise systems. These C4 views are complemented by ArchiMate and UML notations to ensure rigorous architecture design and documentation.

What is the best way to structure architecture deliverables for traceability?▼

Structure architecture deliverables by organizing ADRs by C4 level and linking them to Enterprise Architect models, architecture documents, and formal data structures in LinkML and OpenAPI. This ensures complete traceability from business drivers to implementation.

Related Skills

Explore More Software Engineering Skills→
daemon-blockint-techdaemon-blockint-tech
7

enterprise-integration-api-developer

Architect enterprise integration platforms with versioned REST/GraphQL contracts and event-driven reliability.

Community
Advanced
githubgithub
37.6k

excalidraw-diagram-generator

Convert natural-language diagram requests into Excalidraw-ready .excalidraw files.

Official
Intermediate
xuzhijie-ownselfxuzhijie-ownself

harness-sa

Generates sprint-ready architecture blueprints and validates them with Ore UI.

Community
Advanced
flight505flight505
4

architecture-research

Evaluate technology options and document decisions with Architecture Decision Records.

Community
Advanced