← Back to library

Solutions Architect

Architecture docs, C4 diagrams, and honest trade-offs.

AvailableProduct & Engineeringv1.0.12

About this persona

Elicits requirements and measurable NFRs (ISO 25010), writes solution architecture documents with C4 diagrams, plans strangler-fig migrations, evaluates options with weighted trade-off analysis, and records decisions as Nygard-format ADRs. Every design is framed as a proposal, never as approved.

What it does

  • Measurable NFRs against ISO 25010
  • Solution architecture documents with C4 diagrams
  • Strangler-fig migration plans
  • Weighted trade-off analysis across technology options
  • Nygard-format architecture decision records

Commands and examples

Every capability below is a skill in the plugin. Run it directly with its namespaced slash command, or just describe what you want in plain language and the matching skill activates on its own, both work.

Get help and onboarding

Run this any time in Claude Code. It explains the persona and how to run any capability below.

/solutions-architect:help-sa

Discovering requirements

Elicits business and technical requirements with clarifying questions, defines non-functional requirements as measurable ISO 25010 quality-attribute scenarios, and maps stakeholder priorities and conflicts.

Run it directly

/solutions-architect:discovering-requirements

Or just describe what you want

Help me capture requirements and NFRs for this system from this problem statement: [paste problem statement].

Designing solutions

Drafts arc42-style solution architecture documents traceable to requirements, produces C4 context and container diagrams, and plans migration and integration roadmaps.

Run it directly

/solutions-architect:designing-solutions

Or just describe what you want

Draft a solution architecture document and a C4 container diagram for this system: [describe system and requirements].

Evaluating and deciding

Builds weighted technology and vendor evaluation matrices, runs explicit trade-off analysis, and writes Nygard-format architecture decision records.

Run it directly

/solutions-architect:evaluating-and-deciding

Or just describe what you want

Compare these two message queue options against our NFRs and write an ADR for the decision: [list options and NFRs].

Install in Claude Code

/plugin marketplace add roleplugin/personas-marketplace
/plugin install solutions-architect@personas-marketplace

Requires an active subscription. Prefer not to use GitHub? Download the zip from your library instead.

How to use it

Install the persona, then either ask Claude for the kind of work it covers in plain language, or run a capability directly as its namespaced slash command, /solutions-architect:<skill-name>. Every RolePlugin persona also ships a built-in help guide, /solutions-architect:help-sa, so you can run it any time to see what the persona can do and how to work with it.