bmad-agent-architect

Provide senior architect guidance for designing scalable distributed systems.

Updated Apr 2, 2026
One-click install
npx skills add https://github.com/amitmishra-byldd/Bmad-Note-Maker --skill bmad-agent-architect-amitmishra-byldd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-agent-architect
Source: https://github.com/amitmishra-byldd/Bmad-Note-Maker/tree/main/_bmad/bmm/3-solutioning/bmad-agent-architect
Command: npx skills add https://github.com/amitmishra-byldd/Bmad-Note-Maker --skill bmad-agent-architect-amitmishra-byldd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides senior-level architectural guidance to help engineering teams make pragmatic, scalable technical decisions, align implementation with product goals, and avoid costly rework from poor design choices.

Core Features & Use Cases

  • Persona-driven advice: Act as "Winston," a senior system architect who balances vision with pragmatism and grounds recommendations in real-world trade-offs.
  • Guided workflows: Walk through documenting technical decisions, creating architecture artifacts, and checking implementation readiness by invoking dedicated capabilities like bmad-create-architecture and bmad-check-implementation-readiness.
  • Project-aware recommendations: Loads project configuration via bmad-init and optionally ingests project-context.md to tailor design choices, API patterns, and deployment strategies to the project's constraints.

Quick Start

Ask Winston to review your project's architecture and produce an architecture decision record, recommended components, and an implementation readiness checklist.

Frequently Asked Questions about bmad-agent-architect

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

FAQPage Schema
What is an architecture decision record and when do I need one for distributed systems?

Scalable system architecture balances technical vision with product constraints by evaluating real-world trade-offs. It guides pragmatic technology choices for API design and cloud infrastructure, ensuring implementation aligns with product goals without over-engineering.

How do I design scalable APIs for cloud infrastructure?

Design scalable APIs by applying senior architect guidance to your technical design review. This involves evaluating cloud infrastructure constraints, documenting API patterns in architecture artifacts, and creating an implementation readiness checklist to validate deployment strategies.

Can I tailor architecture recommendations to my existing project context?

Yes, architecture recommendations can be tailored to your project context. The system loads configuration via bmad-init and optionally ingests project-context.md to customize design choices, API patterns, and deployment strategies based on your specific project constraints.

What's the best way to check implementation readiness for a system design?

The best way to check implementation readiness is through a guided workflow that reviews your system design against documented technical decisions. This generates a checklist validating whether your architecture is ready for the engineering team to build.

Does this architecture guidance work for small engineering teams or only large-scale distributed systems?

Architecture guidance applies to both small teams and large-scale distributed systems. It grounds recommendations in real-world trade-offs and pragmatic technology choices, helping any engineering team align implementation with product goals regardless of scale.