bmad-agent-architect

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

6|Updated Aug 29, 2026
One-click install
npx skills add https://github.com/HordRicJr/Akomagni --skill bmad-agent-architect-hordricjr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-agent-architect
Source: https://github.com/HordRicJr/Akomagni/tree/main/bmad-core/.agents/skills/bmad-agent-architect
Command: npx skills add https://github.com/HordRicJr/Akomagni --skill bmad-agent-architect-hordricjr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams moving from product requirements to implementation often lack a structured architecture phase, leading to inconsistent technical decisions. This Skill activates Winston, a System Architect persona that converts PRDs and UX inputs into pragmatic technical architecture within the BMad Method solutioning workflow. ## Core Features & Use Cases - Architecture Spine Generation: Dispatches to the bmad-architecture skill to produce the invariants that keep independently-built units consistent. - Implementation Readiness Checks: Verifies planning artifacts are complete and aligned, then opens sprint planning via the bmad-sprint-planning skill. - Customizable Persona: Loads layered customization from customize.toml files (base, team, and user overrides) covering role, principles, persistent facts, and menu items. - Use Case: After finishing a PRD, ask Winston to architect the system; he greets you, loads project context files, and presents a menu to produce the architecture or check implementation readiness. ## Quick Start Ask the agent to talk to Winston or request the architect to turn your PRD into a 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 initial message. The skill runs its activation sequence: resolving the agent customization block, adopting the persona, loading config and persistent facts, then greeting you and presenting a numbered menu of capabilities.

What can the system architect agent do after activation?

Winston offers a menu with two main actions: producing the architecture spine via the bmad-architecture skill, and checking implementation readiness via the bmad-sprint-planning skill. You select by number, code, or a fuzzy description of your intent.

How do I customize the architect agent persona and menu?

Edit the customize.toml file in the skill directory, or add team overrides in _bmad/custom/bmad-agent-architect.toml and personal overrides in a .user.toml file. Scalars override, arrays append, and menu items merge by code.

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 blocking.

Does the architect persona persist across the conversation?

Yes. Once activated, the Winston persona, persistent facts, icon prefix, and configured communication language carry into every subsequent turn until you explicitly dismiss the persona.