system-architect

Design system architecture and record architecture decisions for services, APIs, and data models.

2|1|Updated May 17, 2026
One-click install
npx skills add https://github.com/rakibulism/agent-skills-os --skill system-architect-rakibulism
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: system-architect
Source: https://github.com/rakibulism/agent-skills-os/tree/main/skills/system-architect
Command: npx skills add https://github.com/rakibulism/agent-skills-os --skill system-architect-rakibulism

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you design a system, service, or API with the right boundaries, data model, and failure handling for the actual requirements in front of you. It also helps you make and justify architecture decisions when you need to choose between technologies or patterns.

Core Features & Use Cases

  • System Design: Defines service boundaries, data ownership, API surfaces, and consistency choices for new components.
  • Architecture Decisions: Produces an ADR that compares options, explains trade-offs, and records the final choice.
  • Operational Fit: Accounts for team size, latency needs, scale assumptions, and failure modes instead of over-engineering for hypothetical futures.
  • Use Case: Use this Skill when deciding between Kafka and SQS, planning a new backend service, or documenting why one architecture fits your constraints better than another.

Quick Start

Ask for a system design or ADR for your requirements, including constraints, scale, and any options you want compared.

Frequently Asked Questions about system-architect

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

FAQPage Schema
How do I document architecture decisions for trade-off analysis?

To document architecture decisions, generate an Architecture Decision Record (ADR) that compares options, explains trade-offs, and records the final choice based on your explicit requirements and constraints.

What is the best way to define service boundaries and data ownership for a new backend service?

Defining service boundaries and data ownership requires a system design approach that accounts for your actual team size, latency needs, and failure modes rather than over-engineering for hypothetical futures.

How do I choose between Kafka and SQS for system design?

Choosing between Kafka and SQS involves comparing the technologies against your specific constraints, scale assumptions, and consistency choices to produce a right-sized, failure-aware recommendation.

Can I design an API surface and data model without providing explicit requirements?

Designing an API surface and data model requires explicit requirements and optional alternatives to produce right-sized recommendations; without them, the architectural trade-offs cannot be accurately evaluated.

When do I need an ADR instead of a general system design?

You need an ADR when justifying architecture decisions between specific technologies or patterns, whereas a general system design defines service boundaries, API surfaces, and data models for new components.

Does this approach to system design account for failure modes and operational fit?

Yes, this system design approach accounts for operational fit by evaluating team size, latency needs, scale assumptions, and failure modes to prevent over-engineering for hypothetical futures.