bmad-agent-architect

Adopts a system architect persona to produce technical architecture from PRD and UX inputs.

Updated Jul 9, 2026
One-click install
npx skills add https://github.com/unbakedcosmos/thumbnailer --skill bmad-agent-architect-unbakedcosmos
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-agent-architect
Source: https://github.com/unbakedcosmos/thumbnailer/tree/main/.claude/skills/bmad-agent-architect
Command: npx skills add https://github.com/unbakedcosmos/thumbnailer --skill bmad-agent-architect-unbakedcosmos

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams moving from product requirements to implementation often lack a consistent architectural voice, leading to misaligned PRDs, UX specs, and epics. This Skill activates Winston, a System Architect persona that converts requirements into technical architecture decisions and keeps planning artifacts aligned. ## Core Features & Use Cases - Persona Activation: Loads a customizable architect persona (role, identity, communication style, principles) from layered TOML configuration files with structural merge rules. - Architecture Menu: Dispatches capabilities like producing the architecture spine (bmad-architecture) and checking implementation readiness across PRD, UX, architecture, and epics. - Persistent Context: Loads project context files and org rules as session-long facts, greets the user in the configured language, and presents a numbered capability menu. - Use Case: After finishing a PRD and UX spec in the BMad Method, invoke this agent to produce the architecture spine and verify all planning artifacts are aligned before story breakdown. ## Quick Start Ask the agent to talk to Winston or request the architect to review your PRD and produce the technical architecture.

Frequently Asked Questions about bmad-agent-architect

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

FAQPage Schema
How do I activate the Winston system architect agent?▼

Ask to talk to Winston or request the architect in your message. The skill resolves its agent configuration, loads project context files, greets you by name, and presents a numbered menu of architecture capabilities.

What does the bmad-agent-architect skill do in the BMad Method?▼

It embodies a system architect persona during the solutioning phase, producing the architecture spine that keeps independently built units consistent and checking that PRD, UX, architecture, and epics are aligned.

How do I customize the architect persona and menu?▼

Create team overrides in _bmad/custom/bmad-agent-architect.toml or personal overrides in a .user.toml file. Scalars override, tables deep-merge, and menu items merge by code, letting you change style, principles, and capabilities.

What happens if the customization resolver script fails?▼

The skill falls back to manually reading the base customize.toml plus team and user override files, applying the same structural merge rules itself, so activation continues without the helper script.

When should I not use this architect agent?▼

Skip it when you need hands-on coding or story implementation rather than architecture decisions. It operates in the planning and solutioning phase, dispatching to architecture and readiness-check skills rather than writing production code.