solution-architect

Q: How do I install solution-architect?

Run npx skills add https://github.com/404kidwiz/claude-supercode-skills --skill solution-architect in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/solution-architect/ (personal) or .claude/skills/solution-architect/ (project).

by 404kidwizBusiness & Finance

Expert in designing high-level enterprise solutions. Specializes in TOGAF adaptation, trade-off analysis, and aligning technology with business strategy.

Installs: 272
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/404kidwiz/claude-supercode-skills --skill solution-architect

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads solution-architect automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Solution Architect

Purpose

Provides expertise in designing enterprise-scale solutions that align technology with business objectives. Specializes in architecture frameworks, trade-off analysis, technology selection, and ensuring solutions meet functional and non-functional requirements.

When to Use

Designing end-to-end solution architecture for new initiatives
Evaluating technology options and making selection decisions
Creating architecture decision records (ADRs)
Ensuring solutions meet enterprise architecture standards
Analyzing trade-offs between competing approaches
Designing integration patterns between systems
Translating business requirements into technical architecture
Conducting architecture reviews and assessments

Quick Start

Invoke this skill when:

Designing end-to-end solution architecture for new initiatives
Evaluating technology options and making selection decisions
Creating architecture decision records (ADRs)
Ensuring solutions meet enterprise architecture standards
Analyzing trade-offs between competing approaches

Do NOT invoke when:

Implementing code changes → use appropriate developer skill
Designing cloud infrastructure → use cloud-architect
Reviewing code quality → use code-reviewer
Managing project execution → use project-manager

Decision Framework

Architecture Decision?
├── Technology Selection → Build evaluation matrix + PoC
├── Integration Pattern → Sync/Async + coupling analysis
├── Data Architecture → Consistency + availability trade-offs
├── Security Architecture → Defense in depth + compliance
├── Scalability → Horizontal/vertical + bottleneck analysis
└── Cost Optimization → Build vs buy + TCO analysis

Core Workflows

1. Solution Design Process

Gather and analyze business requirements
Identify key functional and non-functional requirements
Map to existing enterprise architecture patterns
Design candidate architectures (2-3 options)
Evaluate trade-offs using weighted criteria
Document decisions in ADRs with rationale
Create implementation roadmap with phases

2. Architecture Decision Record

State the decision context and problem
List considered alternatives
Document decision drivers and criteria
Explain chosen option with justification
Note consequences and trade-offs
Record related decisions and dependencies

3. Technology Evaluation

Define evaluation criteria from requirements
Weight criteria by business importance
Score candidates against each criterion
Conduct proof-of-concept for top candidates
Assess vendor viability and support
Calculate total cost of ownership
Document recommendation with rationale

Best Practices

Start with business outcomes, not technology preferences
Document decisions and rationale in ADRs
Consider total cost of ownership, not just initial cost
Design for change; isolate volatile components
Validate assumptions early with prototypes
Engage stakeholders throughout design process

Anti-Patterns

Technology-first thinking → Start from business requirements
Analysis paralysis → Time-box decisions, use reversibility
Ivory tower architecture → Collaborate with implementation teams
Ignoring NFRs → Address security, scalability, operability early
Vendor lock-in blindness → Evaluate portability and exit costs

FAQ

What does the solution-architect skill do?

Expert in designing high-level enterprise solutions. Specializes in TOGAF adaptation, trade-off analysis, and aligning technology with business strategy.

How do I install solution-architect?

Run npx skills add https://github.com/404kidwiz/claude-supercode-skills --skill solution-architect in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/solution-architect/ (personal) or .claude/skills/solution-architect/ (project).

Which AI agents can use solution-architect?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is solution-architect safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains solution-architect?

It is published by 404kidwiz in 404kidwiz/claude-supercode-skills. It has 272 recorded installs.