bmad-agent-architect

Adopts a system architect persona to produce technical architecture from product requirements.

1|Updated Sep 18, 2026
One-click install
npx skills add https://github.com/PastaSus/egg-defender --skill bmad-agent-architect-pastasus
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-agent-architect
Source: https://github.com/PastaSus/egg-defender/tree/main/.agents/skills/bmad-agent-architect
Command: npx skills add https://github.com/PastaSus/egg-defender --skill bmad-agent-architect-pastasus

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams moving from product requirements to implementation often lack a consistent architectural voice, leading to ad-hoc technical decisions. This Skill activates Winston, a System Architect persona that converts PRDs and UX inputs into pragmatic technical architecture during the BMad Method solutioning phase. ## Core Features & Use Cases - Persona Activation: Loads a customizable architect identity with configurable role, communication style, principles, and persistent facts merged from base, team, and user TOML files. - Menu-Driven Capabilities: Presents a numbered menu that dispatches to architecture production (bmad-architecture) or implementation readiness checks (bmad-sprint-planning). - Customization Layering: Supports structural merging of overrides via customize.toml files so teams can adjust persona behavior without changing the core agent. - Use Case: After finishing a PRD, a team lead asks Winston to architect the solution; the agent greets them, loads project config, and dispatches the architecture workflow to produce the architecture spine. ## Quick Start Ask the agent to talk to Winston or request the architect to start designing your system's 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 persona?

Ask to talk to Winston or request the architect in your message. The skill runs its activation sequence: resolving the agent customization block, loading config, greeting you, and presenting a numbered capability menu.

How do I customize the architect agent's persona and menu?

Edit the customize.toml file or add team and user override TOML files under the project's _bmad/custom directory. Scalars override, arrays append, and menu items merge by code, letting you change role, principles, and menu entries without editing the base skill.

What capabilities does the architect agent menu provide?

The default menu offers two items: CA produces the architecture spine via the bmad-architecture skill, and IR checks implementation readiness via bmad-sprint-planning. You can add or replace entries through customization files.

What happens if the customization resolver script fails?

The skill falls back to manually reading the three TOML files in base, team, then user order and applies the same structural merge rules itself. Missing files are skipped, so activation continues without the script.

Can the architect agent load project-specific facts automatically?

Yes, the persistent_facts array in customize.toml accepts literal sentences or file: prefixed paths and globs under the project root. Referenced file contents are loaded as foundational context for the entire session.