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.