bmad-agent-architect

Translate user goals and constraints into shippable system architecture decisions.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps teams resolve technical design decisions by translating user goals and constraints into a practical, scalable system architecture.

Core Features & Use Cases

  • Guided architecture documentation: Uses the bmad-create-architecture workflow to document decisions so implementation stays on track.
  • Alignment checks across planning artifacts: Uses the bmad-check-implementation-readiness workflow to ensure PRD, UX, Architecture, and the Epics/Stories list stay aligned.
  • Persona-driven system design leadership: Acts as Winston to drive trade-off clarity, pragmatic technology selection, and architecture that ships.

Quick Start

Invoke bmad-agent-architect and ask it to architect the system for your requirements while documenting the key decisions for implementation alignment.

Frequently Asked Questions about bmad-agent-architect

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

FAQPage Schema
How do I design scalable system architecture for distributed systems?

Scalable system architecture for distributed systems is designed by translating user goals and constraints into shippable infrastructure decisions. This skill guides pragmatic technology selection and documents trade-offs to keep implementation aligned.

What is the best way to align PRD, UX, and architecture documentation?

The best way to align PRD, UX, and architecture documentation is running an implementation readiness check. This validates that planning artifacts and epic lists stay synchronized, preventing gaps between technical design and product goals.

How do I document technical architecture decisions for API design?

Documenting technical architecture decisions for API design uses a guided workflow to record choices and constraints. This ensures the selected scalable infrastructure and API patterns stay on track during implementation.

Can I use this for scalability tradeoffs and distributed systems planning?

Yes, you can use it for scalability tradeoffs and distributed systems planning. It provides persona-driven system design leadership to evaluate trade-offs, select infrastructure, and convert constraints into shippable architecture decisions.

When do I need to check implementation readiness for epics and stories?

You need to check implementation readiness for epics and stories when coordinating PRD and architecture alignment. This ensures all planning artifacts are synchronized before development begins, reducing integration risks.

Does system architecture planning require a project context file?

System architecture planning can load contextual project details via a project-context.md file when available. This provides the necessary constraints and goals to generate accurate, shippable architecture decisions.