bmad-agent-architect

Adopts a system architect persona that produces technical architecture from product requirements.

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

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 into pragmatic technical architecture with documented trade-offs. ## Core Features & Use Cases - Persona Activation: Loads a customizable architect identity (role, communication style, principles) from layered TOML configuration files with base, team, and user overrides. - Architecture Menu: Dispatches capabilities such as producing the architecture spine (invariants keeping independently-built units consistent) and checking implementation readiness before sprint planning. - Persistent Context: Loads project knowledge files and persistent facts at activation so architectural guidance stays grounded in the actual project. - Use Case: A product team finishing a PRD asks Winston to architect the solution; the agent greets them, loads project context, and dispatches the architecture workflow to produce the technical design. ## Quick Start Ask the agent to talk to Winston and help architect your product requirements into a technical design.

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?

Invoke the skill by asking to talk to Winston or requesting the architect. On activation it resolves the agent configuration, adopts the architect persona, loads project context, greets you, and presents a numbered capability menu.

What can the system architect agent do?

It produces the architecture spine defining invariants that keep independently-built units consistent, and checks implementation readiness by verifying planning artifacts are complete and aligned before sprint planning begins.

How do I customize the architect agent persona?

Edit the customize.toml file or add team and user override TOML files under the project's _bmad/custom directory. Scalars override, tables deep-merge, and arrays append following the BMad structural merge rules.

Does the architect agent work without project configuration files?

Yes, missing configuration files are skipped during activation. The agent falls back to defaults in customize.toml and can still adopt the persona, though project-specific context like persistent facts will not be loaded.

What happens if the customization resolver script fails?

The skill falls back to manually reading the three TOML files in base, team, and user order, applying the same structural merge rules as the resolver script to build the agent configuration.