skills.rest
ysuurme
ysuurmeCOMMUNITY
Explore all skills by this author →
GitHub

design-architecture

Design system architectures with D2 context maps and hexagonal boundaries.

Updated Mar 2, 2022
Search Tags:#domain-driven design#hexagonal architecture#security review#architecture design#bounded contexts#diagram-first#TDD invariants
One-click install
npx skills add https://github.com/ysuurme/azure_hello_world --skill design-architecture
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: design-architecture
Source: https://github.com/ysuurme/azure_hello_world/tree/main/.agents/skills/design-architecture
Command: npx skills add https://github.com/ysuurme/azure_hello_world --skill design-architecture

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you define macro-level system architecture—domain boundaries, data flows, and interaction contracts—so business logic stays vendor-neutral and operationally safe.

Core Features & Use Cases

  • Hexagonal/Clean boundary design: Enforces inward dependency flow with Ports and Adapters to keep the Domain independent from databases and frameworks.
  • DDD-ready modeling: Guides Entities, Value Objects, and thin application/use-case orchestration to prevent business logic leakage.
  • Operationally guarded architecture: Requires a maker-checker loop focused on security vulnerabilities and operational cost thresholds, plus testable invariants for graceful failure states.
  • Diagram-first output: Produces a D2 (or Mermaid fallback) context map that makes ports, adapters, and bounded contexts explicit.

Quick Start

Ask: "Design the architecture for a new payments sub-system, including bounded contexts, port/adaptor boundaries, and diagram-first context mapping with security and cost checks."

Frequently Asked Questions about design-architecture

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

FAQPage Schema
How do I design a clean architecture with bounded contexts and port/adapter boundaries?▼

Design clean architecture by enforcing hexagonal ports and adapters to keep domain logic vendor-neutral, guiding bounded contexts and diagram-first context mapping for new sub-systems.

What is the best way to refactor a monolith into modular components using domain-driven design?▼

Refactor monoliths into modular components by applying domain-driven design to map data flows across services, enforcing clean interaction contracts and bounded contexts with diagram-first outputs.

How does diagram-first architecture design generate context maps for cloud resources?▼

Diagram-first architecture design produces D2 or Mermaid context maps that explicitly map ports, adapters, and bounded contexts when planning data flows across services or cloud resources.

Can I enforce security review and operational cost checks during system architecture planning?▼

You can enforce security and cost checks during architecture planning through a maker-checker loop evaluating security vulnerabilities and operational cost thresholds alongside testable TDD invariants.

When do I need hexagonal architecture for planning new API feature sets?▼

You need hexagonal architecture for new API feature sets when isolating business logic from databases and frameworks to ensure inward dependency flow and zero-artifact vendor-neutral telemetry.

Related Skills

Explore More Software Engineering Skills→
TonyQ-AITonyQ-AI
9

domain-modeling

Extract core business concepts, entity relationships, and domain rules from requirement specifications.

Community
Intermediate
atilladenizatilladeniz
2

system-design

Generate Mermaid diagrams for system design and architecture visualization.

Community
Basic
sandeshbagmaresandeshbagmare

architecture-patterns

Provide architectural guidance for backend systems using Clean Architecture, Hexagonal Architecture, and Domain-Driven Design.

Community
Advanced
nimadorostkarnimadorostkar
25

cloud-architecture

Design secure, cost-optimized AWS infrastructure with least-privilege identity and network topology.

Community
Advanced