bmad-create-architecture

Creates a structured architecture decision document from a PRD and project requirements.

Updated Apr 23, 2026
One-click install
npx skills add https://github.com/ncptuan/stock_backtest_project --skill bmad-create-architecture-ncptuan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-create-architecture
Source: https://github.com/ncptuan/stock_backtest_project/tree/main/.claude/skills/bmad-create-architecture
Command: npx skills add https://github.com/ncptuan/stock_backtest_project --skill bmad-create-architecture-ncptuan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams turn product requirements into a structured architecture document that AI agents and developers can implement consistently. It reduces ambiguity in technical decisions, project structure, and coding patterns that would otherwise lead to conflicting implementations.

Core Features & Use Cases

  • Collaborative architecture workflow: Guides the user through initialization, context analysis, starter selection, core decisions, implementation patterns, project structure, validation, and handoff.
  • Consistency-focused decision making: Captures naming conventions, API formats, structure rules, and process patterns so multiple AI agents can build compatible code.
  • Workflow recovery and continuation: Detects existing architecture work, summarizes progress, and resumes from the appropriate step.
  • Use Case: When a team has a PRD and wants a complete solution design before implementation, this Skill produces an architecture document with validated decisions, mapped requirements, and a concrete project tree.

Quick Start

Ask the AI to use bmad-create-architecture to create a technical architecture from your PRD and guide you step by step through the solution design.

Frequently Asked Questions about bmad-create-architecture

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

FAQPage Schema
How do I create a technical architecture from product requirements?

A solution design workflow transforms product requirements into a structured architecture decision document by analyzing project context, evaluating starter templates, and defining implementation patterns. It ensures multiple developers build compatible code.

How do I ensure consistent implementation across multiple AI agents?

Capturing naming conventions, API formats, structure rules, and process patterns in a shared architecture decision document enforces documented consistency rules across multiple AI agents and developers.

What is the best way to define project structure before coding?

A collaborative architecture workflow defines project structure by producing a concrete project tree with mapped requirements and validated technical decisions, reducing ambiguity before implementation begins.

Can I resume an architecture design workflow if I stop halfway through?

Architecture design workflows maintaining workflow state in frontmatter can detect existing work, summarize progress, and resume from the appropriate step using collaborative step-gated progression.

Do I need a PRD to start creating architecture decisions?

A PRD is required as input to create architecture decisions, as the solution design workflow analyzes product requirements to generate validated technical planning documents and implementation patterns.

When do I need a structured architecture decision document?

A structured architecture decision document is needed when teams have a PRD and want a complete solution design before implementation, reducing ambiguity in technical decisions that cause conflicting implementations.