system-design

Transform requirements into Mermaid-based design catalogs with EventStorming.

Updated Mar 3, 2026
One-click install
npx skills add https://github.com/jacexh/skills --skill system-design-jacexh
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: system-design
Source: https://github.com/jacexh/skills/tree/main/skills/system-design
Command: npx skills add https://github.com/jacexh/skills --skill system-design-jacexh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Transform vague requirements and informal ideas into a navigable, event-driven design catalog that teams can review and iterate on without making implementation assumptions.

Core Features & Use Cases

  • EventStorming-first workflow: Guides collaborative elicitation of domain events, commands, actors, systems, and hotspots to surface requirements and ambiguities.
  • Mermaid-native artifacts: Produces token-efficient visual artifacts (big-picture timelines, process diagrams, ERDs, state charts, sequences) stored in a standardized docs/design-catalog layout.
  • Use Case: Run a discovery session to convert stakeholder interviews into a reproducible design catalog that supports handoff to implementation planning.

Quick Start

Start a system-design session by announcing the intent, ask the first requirement question, and create docs/design-catalog/requirements.md with identified actors and constraints.

Frequently Asked Questions about system-design

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

FAQPage Schema
How do I turn vague requirements into a structured system architecture?▼

To convert vague requirements into system architecture, use EventStorming to elicit domain events and actors, then generate a standardized design catalog. This produces Mermaid diagrams and markdown files for progressive elaboration without implementation assumptions.

How does EventStorming work for software architecture planning?▼

EventStorming works by guiding collaborative elicitation of domain events, commands, actors, and systems to surface requirements and ambiguities. It enforces event-driven thinking and question-driven elicitation to produce high-level and detailed system artifacts for cross-functional workshops.

Can I generate Mermaid diagrams automatically from system requirements?▼

Yes, you can generate Mermaid-native artifacts automatically from requirements. The process produces token-efficient visual artifacts including big-picture timelines, process diagrams, ERDs, state charts, and sequence diagrams stored in a standardized docs/design-catalog directory layout.

Does this approach to system design require specific frameworks or dependencies?▼

This approach requires no specific frameworks or dependencies, focusing entirely on event-driven design thinking and Mermaid diagrams. It operates under non-implementation constraints, making it suitable for architecture planning and cross-functional workshops without locking you into specific technologies.

What is the best way to document data models and integration flows?▼

The best way to document data models and integration flows is to create a standardized docs/design-catalog directory with embedded Mermaid files. This includes separate subdirectories for processes, data models, and flows, producing reproducible artifacts that support handoff to implementation planning.

When should I not use event-driven design catalogs for architecture planning?▼

You should not use event-driven design catalogs when implementation details are already fully specified or when progressive elaboration of requirements is unnecessary. This approach deliberately enforces non-implementation constraints, making it unsuitable for projects needing immediate code generation rather than design exploration.