skills.rest
yuridefranca
yuridefrancaCOMMUNITY
Explore all skills by this author →
GitHub

system-designer

Design system architecture for new features and system changes.

Updated Apr 10, 2026
Search Tags:#architecture#scalability#concurrency#api-design#system-design#data-model#event-flow
One-click install
npx skills add https://github.com/yuridefranca/ai-prompts --skill system-designer-yuridefranca
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: system-designer
Source: https://github.com/yuridefranca/ai-prompts/tree/main/src/skills/system-designer
Command: npx skills add https://github.com/yuridefranca/ai-prompts --skill system-designer-yuridefranca

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The System Designer skill removes uncertainty and manual guesswork when turning approved product specifications into concrete technical designs by producing domain models, data schemas, API contracts, event flows, concurrency strategies, and scaling plans.

Core Features & Use Cases

  • Domain Modeling: Identify new entities, value objects, aggregates, and domain events and map them to existing bounded contexts.
  • Data & Migration Design: Propose database schema changes, indexes, and migration strategies that preserve backward compatibility.
  • API & Event Flow Definitions: Define request/response schemas, status codes, and text-based event flow diagrams for synchronous and asynchronous interactions.
  • Concurrency & Scaling Planning: Recommend locking, idempotency, caching, async processing, and sharding strategies to meet performance targets.
  • Use Case: Translate an approved feature spec into a deliverable system design that developers and architects can implement and estimate.

Quick Start

Design a system architecture for a new checkout discount feature including domain model changes, database migration strategy, REST API contracts, event flow, concurrency considerations, and a scaling approach.

Frequently Asked Questions about system-designer

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

FAQPage Schema
How do I design system architecture for a new feature?▼

To design system architecture for a new feature, you translate an approved product specification into domain models, database migration strategies, API contracts, event flows, concurrency strategies, and scaling plans for web services and distributed systems.

What is the best way to define API contracts and event flows for distributed systems?▼

Defining API contracts and event flows involves specifying request and response schemas, status codes, and text-based event flow diagrams for both synchronous and asynchronous interactions to ensure clear communication across distributed system components.

How do I plan database schema changes and migration strategies for web services?▼

Planning database schema changes requires proposing specific schema updates, indexes, and migration strategies that preserve backward compatibility while mapping new entities and value objects to existing bounded contexts within the domain model.

What concurrency and scaling strategies should I use for high-performance system design?▼

Concurrency and scaling strategies for system design include recommending locking, idempotency, caching, asynchronous processing, and sharding approaches to meet specific performance targets and handle high throughput in distributed systems.

When do I need to update domain models and bounded contexts during system design?▼

You need to update domain models and bounded contexts during system design when identifying new entities, value objects, aggregates, and domain events is required to accurately map structural changes to the existing software architecture.

Related Skills

Explore More Software Engineering Skills→
rikdcrikdc
2

specify

Converts design documents into technical specifications with data models and API contracts.

Community
Basic
VinedineVinedine
2

c4-document-system

Generates technical architecture documentation from Structurizr DSL definitions and source code repositories.

Community
Advanced
nntan90nntan90
4

api-test

Validate REST and GraphQL APIs by testing endpoints, schemas, and contracts.

Community
Advanced
ntaksh42ntaksh42
1

plantuml-diagram

Generate UML class, sequence, activity, and component diagrams from PlantUML syntax.

Community
Basic