software-architecture

Analyze and document software architecture decisions using ADRs.

Updated Feb 26, 2026
One-click install
npx skills add https://github.com/pitabwire/skills --skill software-architecture-pitabwire
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: software-architecture
Source: https://github.com/pitabwire/skills/tree/main/software-architecture
Command: npx skills add https://github.com/pitabwire/skills --skill software-architecture-pitabwire

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Master software architecture decisions with structured analysis, ADRs, and design reviews to guide scalable systems.

Core Features & Use Cases

  • Review architecture patterns (microservices, event-driven, DDD)
  • Document ADRs and architectural decisions with trade-off analysis
  • Assess scalability, resilience, and pattern compliance across projects

Quick Start

Describe and capture the proposed architecture in an ADR-ready format for immediate review.

Frequently Asked Questions about software-architecture

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

FAQPage Schema
How do I document software architecture decisions for microservices?

Document software architecture decisions using Architecture Decision Records to codify trade-offs. This captures context, evaluates maintainability and performance, and ensures decisions remain traceable across microservices projects.

What is the best way to analyze event-driven architecture trade-offs?

Analyzing event-driven architecture trade-offs involves applying structured design reviews to assess scalability and resilience. This ensures your event-driven patterns align with requirements and are evaluated for security and performance.

How do I write an ADR for domain-driven design?

Writing an ADR for domain-driven design involves documenting architectural decisions with explicit trade-off analysis. This validates that DDD patterns meet requirements and evaluates their impact on system maintainability.

When do I need to validate architecture patterns for scalability?

Validate architecture patterns for scalability when adopting complex designs like microservices or event-driven systems. This assesses pattern compliance, ensuring your architecture supports growth while maintaining resilience and performance.

Can I assess pattern compliance across existing software projects?

Yes, you can assess pattern compliance across existing projects by applying architectural design reviews. This evaluates whether current implementations align with intended patterns and checks for maintainability and security gaps.