bmad-create-architecture

Create software architecture decision documents through collaborative step-by-step workflow.

Updated May 22, 2026
One-click install
npx skills add https://github.com/Asygnuz-S-A-S/one-star --skill bmad-create-architecture-asygnuz-s-a-s
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-create-architecture
Source: https://github.com/Asygnuz-S-A-S/one-star/tree/main/.claude/skills/bmad-create-architecture
Command: npx skills add https://github.com/Asygnuz-S-A-S/one-star --skill bmad-create-architecture-asygnuz-s-a-s

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI agents implementing a project often make inconsistent technical choices, causing conflicting code. This Skill guides you through a structured, collaborative workflow to produce a complete architecture decision document that serves as the single source of truth for implementation. ## Core Features & Use Cases - Guided 8-Step Workflow: Walks through initialization, project context analysis, starter template evaluation, core architectural decisions, implementation patterns, project structure, validation, and completion handoff. - Consistency Rules for AI Agents: Defines naming, structure, format, and communication patterns so multiple AI agents write compatible code. - Resumable State Tracking: Tracks progress in document frontmatter, detects existing work, and lets you resume or restart at any step. - Use Case: After writing a PRD for a new web app, run this workflow to decide the tech stack, database, API patterns, and project structure, producing an architecture.md that implementation agents follow exactly. ## Quick Start Ask the agent to create the technical architecture for your project based on your existing PRD document.

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 software architecture document with an AI agent?▼

Run this workflow after preparing a PRD. It guides you through eight steps covering context analysis, starter template selection, core decisions, consistency patterns, project structure, and validation, producing a complete architecture.md document.

What inputs does the architecture workflow require?▼

A PRD is mandatory; the workflow will not proceed without one. It also optionally discovers UX designs, research documents, project documentation, and project-context files to inform architectural decisions.

Can I resume an interrupted architecture workflow?▼

Yes. The workflow tracks completed steps in the document frontmatter. On reactivation it detects existing work and offers options to resume, continue to the next step, review remaining steps, or start over.

How does the workflow ensure AI agents write consistent code?▼

It defines implementation patterns covering naming conventions, file structure, API response formats, event naming, and error handling. These rules prevent different agents from making conflicting choices during implementation.

Does the workflow verify technology versions before deciding?▼

Yes. The starter template and decision steps mandate web searches to verify current versions and maintenance status of technologies, explicitly forbidding reliance on hardcoded version numbers.