architecture

Guide architectural decisions through requirements analysis, trade-off evaluation, and ADR documentation.

1|Updated Dec 21, 2024
One-click install
npx skills add https://github.com/SergeiGolos/wod-wiki --skill architecture-sergeigolos
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architecture
Source: https://github.com/SergeiGolos/wod-wiki/tree/main/.agent/skills/architecture
Command: npx skills add https://github.com/SergeiGolos/wod-wiki --skill architecture-sergeigolos

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a structured framework for making sound architectural decisions, ensuring requirements are met, trade-offs are evaluated, and rationale is documented through Architecture Decision Records (ADRs).

Core Features & Use Cases

  • Requirements Analysis: Guides context discovery through a question hierarchy.
  • Trade-off Evaluation: Provides templates and frameworks for analyzing options.
  • Pattern Selection: Offers decision trees and references for choosing appropriate architectural patterns.
  • ADR Documentation: Standardizes the creation and storage of Architecture Decision Records.
  • Use Case: When designing a new microservice, use this Skill to systematically gather requirements, explore different communication patterns (e.g., REST vs. gRPC vs. event-driven), evaluate trade-offs, and document the final decision in an ADR.

Quick Start

Use the architecture skill to help document a new decision about data access patterns.

Frequently Asked Questions about architecture

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

FAQPage Schema
How do I document architectural decisions for system design?▼

Evaluate architectural trade-offs using provided templates and frameworks to analyze options. The framework guides systematic comparison of patterns, such as REST versus gRPC versus event-driven communication, to support informed decision-making.

What is the best way to choose architectural patterns for new features?▼

Choose architectural patterns using decision trees and pattern references within the framework. It guides context discovery through a question hierarchy to ensure selected patterns meet new feature requirements and technology stack constraints.

Can I use this framework for microservice communication pattern selection?▼

Yes, you can use this framework for microservice communication pattern selection. It systematically gathers requirements, explores options like REST versus gRPC versus event-driven, evaluates trade-offs, and documents the final pattern choice in an ADR.

When do I need an Architecture Decision Record for technology stack choices?▼

You need an Architecture Decision Record when making significant technology stack choices that require documented rationale. The framework standardizes ADR creation and storage to ensure requirements analysis and trade-off evaluation are recorded.

How does requirements analysis work for architectural decision-making?▼

Requirements analysis works by guiding context discovery through a structured question hierarchy. This process ensures all relevant system design constraints and feature requirements are gathered before evaluating trade-offs or selecting patterns.