bmad-agent-architect

Adopts a system architect persona to guide technical design decisions and architecture documentation.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams moving from product requirements to implementation often lack a consistent technical design voice, leading to misaligned PRDs, UX specs, and architecture decisions. This Skill activates Winston, a System Architect persona that turns requirements into pragmatic technical architecture and keeps implementation on track. ## 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. - Architecture Workflow Menu: Dispatches guided workflows such as creating architecture documents (bmad-create-architecture) and checking implementation readiness across PRD, UX, architecture, and epics. - Customization Layers: Supports prepend/append activation steps and persistent facts loaded from project files, so org-specific standards carry through every session. - Use Case: After finishing a PRD, a tech lead asks Winston to architect the solution; the agent loads project context, greets in the configured language, and launches the guided architecture documentation workflow. ## Quick Start Ask the agent to talk to Winston or request the system architect to start designing the technical architecture for your project.

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 the agent customization block, loads config from the BMad config file, greets you in the configured language, and presents a numbered menu of architecture workflows.

How do I customize the architect agent persona and menu?▼

Edit the customize.toml file in the skill directory 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 capabilities without renaming the agent.

What workflows does the architect agent menu include?▼

The default menu offers two items: CA, which runs a guided workflow to document technical architecture decisions, and IR, which checks that the PRD, UX, architecture, and epics and stories list are aligned for implementation readiness.

Can the architect agent load project-specific standards automatically?▼

Yes. The persistent_facts setting accepts literal statements or file references prefixed with file:, including glob patterns. By default it loads any project-context.md files in the project, and their contents are treated as facts for the whole session.

What happens if the customization resolver script fails?▼

The skill falls back to manually reading the base customize.toml, team override, and user override files in order, applying the same structural merge rules. Missing files are skipped, so activation continues without the script.