skills.rest
sun2443
sun2443COMMUNITY
Explore all skills by this author →
GitHub

architecture

Create and evaluate architecture decision records as Markdown ADRs.

Updated Apr 8, 2026
Search Tags:#architecture#system design#adr#design documentation#trade-off analysis#technology selection#engineering decision-making
One-click install
npx skills add https://github.com/sun2443/designer-skills --skill architecture-sun2443
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architecture
Source: https://github.com/sun2443/designer-skills/tree/main/engineering/skills/architecture
Command: npx skills add https://github.com/sun2443/designer-skills --skill architecture-sun2443

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps teams make and communicate sound architecture decisions by capturing context, options, trade-offs, and consequences in an ADR format.

Core Features & Use Cases

  • ADR creation and evaluation: Produce a complete ADR when proposing a technical change, or review a design proposal using consistent reasoning.
  • Technology decision trade-offs: Compare alternatives (e.g., Kafka vs SQS) with explicit assessments across key dimensions.
  • System design collaboration: Use as a companion to system-design for requirements, scalability analysis, and trade-off evaluation.

Quick Start

Use /architecture Should we use Kafka or SQS for our event bus?

Frequently Asked Questions about architecture

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

FAQPage Schema
How do I create an architecture decision record for technology selection?▼

To create an architecture decision record, structure context, options, trade-offs, and consequences into a Markdown ADR with option comparison tables. Submit your decision scope to generate the document with specified sections.

What is the best way to document trade-offs for a system design proposal?▼

Documenting trade-offs for a system design proposal involves comparing alternatives with explicit assessments across key dimensions. This evaluates options like Kafka versus SQS by structuring context and consequences into an ADR format.

How do I evaluate engineering decisions when comparing technology alternatives?▼

Evaluate engineering decisions by applying consistent reasoning to review design proposals and compare technology alternatives. This process captures trade-offs and consequences to produce a clear architecture decision record.

Can I use this for system design collaboration and scalability analysis?▼

Yes, you can use it for system design collaboration by applying it to requirements, scalability analysis, and trade-off evaluation. It functions as a companion to system design for structuring engineering decision-making.

What should I provide to generate a complete ADR with comparison tables?▼

You must provide the user-defined decision or system scope via the argument-hint. This input drives the creation of the Markdown ADR, populating the specified sections and option comparison tables.

When do I need an ADR format for my architecture decisions?▼

You need an ADR format when proposing a technical change, selecting technologies, or designing components based on requirements and constraints. It helps teams make and communicate sound architecture decisions.

Related Skills

Explore More Software Engineering Skills→
abdullah1854abdullah1854
1

session-handoff

Generate Markdown Architectural Decision Records from structured inputs.

Community
Intermediate
pratikrath126pratikrath126
42

architecture

Organize architecture decisions using structured ADR templates and decision records.

Community
Advanced
AstrumonAstrumon

architecture-designer

Design system-level architectures and document decisions with ADRs and component diagrams.

Community
Advanced
arkbriararkbriar
32

sisyphus-design

Produce structured design documents with decision logs and change summaries.

Community
Advanced