architecture-design

Design system architectures with data models, API contracts, and ADRs.

285|39|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/shawnpang/startup-founder-skills --skill architecture-design-shawnpang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-design
Source: https://github.com/shawnpang/startup-founder-skills/tree/main/skills/architecture-design
Command: npx skills add https://github.com/shawnpang/startup-founder-skills --skill architecture-design-shawnpang

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architecture Design helps engineers design, evaluate, and document robust system architectures, including boundaries, data models, API contracts, infrastructure topology, database choices, and dependency analysis, with ADRs and architecture reviews.

Core Features & Use Cases

  • Architecture assessment & pattern detection: identify layering patterns (monolith, modular monolith, microservices) and highlight issues.
  • Data modeling & API contracts: define entity ownership, endpoints, request/response schemas, and versioning.
  • Diagrams & ADRs generation: produce Mermaid/PlantUML diagrams and Architecture Decision Records for traceability.
  • Use cases include evaluating a new product, choosing monolith vs microservices, performing capacity planning, and documenting system decisions.

Quick Start

Create a modular monolith architecture plan for a new product, including domain modules, data model, API contracts, and an ADR draft.

Frequently Asked Questions about architecture-design

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

FAQPage Schema
How do I decide between a monolith and microservices for a new product?

System architecture decisions between monolith and microservices are evaluated by assessing product scale, domain module boundaries, and capacity constraints to determine the optimal pattern. The skill highlights architectural issues and recommends the appropriate layering structure for your context.

What is the best way to document architecture decisions for traceability?

Architecture Decision Records (ADRs) provide traceability by capturing system architecture choices with clear ownership and versioning. This skill generates ADR drafts alongside Mermaid or PlantUML diagrams to document infrastructure topology and data model rationale.

How do I define API contracts and data models for a modular monolith?

API contracts and data models are defined by establishing entity ownership, endpoints, request and response schemas, and versioning rules. This skill evaluates your modular monolith boundaries to produce explicit API specifications and structured data modeling guidelines.

Can I generate system architecture diagrams automatically from my design?

System architecture diagrams can be generated automatically using Mermaid or PlantUML syntax to visualize infrastructure topology and module dependencies. This skill produces diagrams directly from your architecture assessment to illustrate layering patterns and data flows.

Does this architecture design skill work for early-stage startup products?

Architecture design for early-stage startup products is supported by evaluating initial capacity planning, risk evaluation, and infrastructure topology choices. It satisfies startup requirements for architecture assessment and system design without enforcing premature microservices complexity.