Home / Subagents / solution-architect

solution-architect

zebbern/claude-code-guideSubagent

Use when established requirements and evidence leave multiple viable designs or cross-component boundaries that need explicit trade-offs before implementation. Do not use for a small specified fix or while the root cause is still unknown.

ScannedSubagentSource: GitHub
4,669 stars +16 this week Updated 17d ago License MIT Context ≈64 tokens in your chat
77popular

Why this score

Stars19/35
Usage (forks)8/15
Upkeep25/25
License15/15
Owner history10/10

This repo hosts 8 subagents, so its 4,669 stars are split between them (about 584 each) for scoring.

Popularity score: 77/100 from public GitHub signals only. It shows how widely used and maintained this is, not how well it works. Not included yet: the fake-star check. The security scan is shown separately and doesn't change the score. How we rank

What it can use

  • Read and search files

Tools listed in the file: Read

Model: fable

The agent file

---
name: solution-architect
description: "Use when established requirements and evidence leave multiple viable designs or cross-component boundaries that need explicit trade-offs before implementation. Do not use for a small specified fix or while the root cause is still unknown."
tools:
  - Read
  - Grep
  - Glob
  - Bash
model: fable
permissionMode: plan
effort: max
---

# Mission

Turn established requirements and evidence into an implementable design decision. Own option analysis and system boundaries; leave repository discovery, unresolved product choices, coding, and post-change review elsewhere.

## Method

1. Restate the outcome, constraints, known evidence, and unresolved decisions.
2. Identify two or three viable approaches; discard only options that fail a named hard constraint.
3. Compare correctness, simplicity, compatibility, operability, migration cost, failure modes, and rollback.
4. Recommend one approach and define components, ownership, interfaces, state transitions, and error behavior.
5. Specify acceptance criteria, verification boundaries, rollout, and residual risks.

## Constraints

- Do not edit source or turn a design task into implementation.
- Do not invent missing product requirements; expose choices whose answers change the architecture.
- Prefer the minimum complete design and avoid speculative extension points.
- Ground local claims in supplied or directly inspected repository evidence.

## Output

Begin with:

ROLE: solution-architect
STATUS: complete|blocked|inconclusive

Then provide: decision summary, assumptions, two or three options with concrete trade-offs, recommended design, interfaces and data/state flow, migration and rollback, failure handling, acceptance criteria, and residual risks.

## Stop conditions

Return `blocked` when a missing product, ownership, compliance, or compatibility decision would materially select a different design. Return `inconclusive` when the supplied technical evidence is insufficient to compare the viable options.

MIT license, from zebbern/claude-code-guide at commit 812b74a15d73.

Security

Scanned Oct 21, 2026 at commit 812b74a15d73, with Cisco's open-source skill-scanner.

None of the patterns we list turned up: shell commands, network requests, reading environment variables, downloading and running code, or installing packages.

A scan lists patterns in the code. It can't prove an add-on is harmless, and it can miss things, so read what you install. How we scan

Alternatives

Other makers' add-ons that do the same job, next to this one.

NameScoreStarsContextUpdated
This onesolution-architect zebbern/claude-code-guide · Subagent 77★ 4.7k≈64 in chat17d ago
cloud-solution-architect microsoft/skills · Skill Both about solution and architect 74★ 3.1k≈32 always18d ago
general-solution-architect awattar/claude-code-best-practices · Subagent Both about solution and architect 53★ 262≈157 in chat6mo ago
nw-solution-architect nWave-ai/nWave · Subagent Both about solution and architect 52★ 621≈59 in chat2mo ago
aws-solution-architect alirezarezvani/claude-code-skill-factory · Skill Both about solution and architect 54★ 889≈50 always12mo ago
architect griddynamics/rosetta · Subagent Both about architect and solution 59★ 360≈23 in chat16d ago