system-design

Generate a phased system design catalog with EventStorming and Mermaid diagrams.

1|1|Updated Mar 22, 2026
One-click install
npx skills add https://github.com/zzafergok/skills --skill system-design-zzafergok
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: system-design
Source: https://github.com/zzafergok/skills/tree/main/04-frontend-development/ux-researcher-designer
Command: npx skills add https://github.com/zzafergok/skills --skill system-design-zzafergok

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Translate vague requirements into a navigable, event-driven design catalog that guides system architecture using EventStorming, Mermaid diagrams, and phased thinking.

Core Features & Use Cases

  • EventStorming-driven design cataloging and visualization
  • Mermaid-based big-picture diagrams, process diagrams, and data models
  • Progressive elaboration through five phases: Requirements, Big Picture, Processes, Data/Flows, Integration
  • Ready-to-activate design guidance for new systems or major redesigns

Quick Start

Initiate a design session for a new system and I'll begin generating a design catalog using questions and diagrams.

Frequently Asked Questions about system-design

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

FAQPage Schema
How do I translate vague system requirements into an event-driven architecture?

To translate vague requirements into an event-driven architecture, this Skill uses EventStorming to identify design goals and constraints, producing a phased design catalog with Mermaid diagrams. It progressively elaborates system design across five phases.

What is the best way to visualize system design phases using Mermaid diagrams?

Visualizing system design phases with Mermaid diagrams is achieved by generating big-picture diagrams, process diagrams, and data models inline within a catalog README. This allows immediate preview of the event-driven architecture and flows.

How do I start an EventStorming session for a new system design?

To start an EventStorming session, you provide a brief for your new system. The Skill then initiates a design session, asking questions and generating a design catalog under docs/design-catalog using progressive elaboration.

Does the system design catalog include implementation details and code?

No, the system design catalog strictly maintains design-only artifacts and avoids implementation details. It focuses entirely on architectural design, event flows, and data models rather than code generation.

What are the five phases of progressive elaboration for system architecture?

The five phases of progressive elaboration for system architecture are Requirements, Big Picture, Processes, Data/Flows, and Integration. Each phase builds upon the previous to elaborate the event-driven design.

Can I use this for a major system redesign or only new projects?

You can use this EventStorming-driven design catalog for both new systems and major redesigns. It provides ready-to-activate design guidance to navigate architectural constraints and translate updated requirements into data flows.