bmad-architect

Design system architectures and document decisions with Architecture Decision Records.

2|Updated Apr 21, 2025
One-click install
npx skills add https://github.com/akvo/akvo-rag --skill bmad-architect-akvo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-architect
Source: https://github.com/akvo/akvo-rag/tree/main/.agent/skills/bmad-architect
Command: npx skills add https://github.com/akvo/akvo-rag --skill bmad-architect-akvo

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill assists in designing robust system architectures, making critical technology decisions, and documenting these choices through Architecture Decision Records (ADRs).

Core Features & Use Cases

  • System Architecture Design: Creates comprehensive architecture documents including diagrams, tech stack choices, component design, data models, security, and infrastructure.
  • ADR Creation: Generates structured ADRs for significant technical decisions.
  • Tech Stack Evaluation: Systematically evaluates technology options with clear criteria and rationale.
  • API and Data Modeling: Designs clear API contracts and efficient data models.
  • Architecture Review: Identifies potential issues in existing architectures like single points of failure or security vulnerabilities.
  • Use Case: When starting a new project, use this Skill to define the overall system design, select the appropriate database, and document the initial architectural decisions.

Quick Start

Use the bmad-architect skill to design the system architecture for a new e-commerce platform.

Frequently Asked Questions about bmad-architect

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

FAQPage Schema
How do I design and document system architecture for a new software project?

System architecture design defines your tech stack, component structure, data models, and infrastructure. You document these choices, including API contracts and security parameters, to create a comprehensive architecture blueprint for your new project.

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

An Architecture Decision Record (ADR) is a structured document capturing significant technical choices. You need an ADR to record the rationale and context for tech stack selections, ensuring system design decisions are transparent and traceable for future review.

How do I evaluate technology options for my tech stack?

Evaluating technology options requires systematically comparing frameworks against clear criteria and rationale. This process ensures your tech stack aligns with system design requirements, data modeling needs, and overall infrastructure goals before finalizing an architecture.

Can I use this to review existing architectures for security vulnerabilities?

Yes, architecture review identifies potential issues in existing architectures like single points of failure and security vulnerabilities. It evaluates your current system design, component interactions, and data models to surface structural weaknesses for remediation.

What's the best way to create API contracts and data models for system design?

The best way to create API contracts and data models is to design them concurrently within your system architecture. This ensures your API endpoints align perfectly with efficient data modeling and overall component infrastructure requirements.