bd-solution-architect

Design system architectures and write Architecture Decision Records.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/bitsydarel/BDSkills --skill bd-solution-architect
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bd-solution-architect
Source: https://github.com/bitsydarel/BDSkills/tree/main/plugins/bd-solution-architect/skills/bd-solution-architect
Command: npx skills add https://github.com/bitsydarel/BDSkills --skill bd-solution-architect

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill tackles the complexity of software architecture by providing structured workflows for designing systems, documenting decisions, and ensuring architectural integrity, regardless of the chosen style.

Core Features & Use Cases

  • System Design: Create architecture overviews, component designs, and database architectures.
  • Decision Records: Write Architecture Decision Records (ADRs) to capture the "why" behind choices.
  • Quality Attributes: Define and assess quality attributes like testability, modifiability, and scalability.
  • Use Case: A team is deciding between microservices and a modular monolith. This Skill can help them design the architecture overview, document the decision in an ADR, and define quality attribute scenarios for both options.

Quick Start

Use the bd-solution-architect skill to design the architecture overview for a new e-commerce platform.

Frequently Asked Questions about bd-solution-architect

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

FAQPage Schema
How do I design system architecture for a new software platform?

To design system architecture, you can generate architecture overviews, component designs, and database architectures. This process structures your platform by translating quality criteria into system-specific components, regardless of whether you use microservices or a modular monolith.

What is an Architecture Decision Record and when do I need one?

An Architecture Decision Record (ADR) captures the why behind architectural choices. You need ADRs to document decisions when evaluating styles like Clean Architecture or Hexagonal, ensuring your team understands the rationale behind structural choices.

How do I define quality attribute scenarios for software architecture?

Defining quality attribute scenarios involves specifying and assessing testability, modifiability, and scalability metrics. This skill translates these attributes into system-specific fitness functions to evaluate your architecture against desired quality benchmarks.

Can I use this to decide between a microservices and a modular monolith architecture?

Yes, you can evaluate microservices versus a modular monolith by designing architecture overviews for both. This skill helps you compare options by documenting the decision in an ADR and defining quality attribute scenarios for each approach.

Does this approach support Clean Architecture and Hexagonal design patterns?

Yes, this approach supports Clean Architecture and Hexagonal design patterns. It evaluates and produces architecture regardless of style, adapting criteria to system-specific components for your chosen pattern.

What is the best way to document architectural fitness functions?

The best way to document architectural fitness functions is to specify them as concrete scenarios that validate quality attributes. This skill defines these functions to continuously verify modifiability, testability, and scalability during system evolution.