solution-architect

Design system architecture and generate ADRs, API contracts, and project scaffolds.

171|49|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/nagisanzenin/claude-code-production-grade-plugin --skill solution-architect-nagisanzenin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: solution-architect
Source: https://github.com/nagisanzenin/claude-code-production-grade-plugin/tree/main/skills/solution-architect
Command: npx skills add https://github.com/nagisanzenin/claude-code-production-grade-plugin --skill solution-architect-nagisanzenin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the process of designing system architecture, from initial business requirements to a scaffolded, production-ready codebase, ensuring the architecture is tailored to specific project constraints.

Core Features & Use Cases

  • Constraint-Driven Design: Derives architecture based on scale, team size, budget, and compliance needs.
  • Full Lifecycle Support: Covers discovery, architecture design, tech stack selection, API contract generation, data modeling, and project scaffolding.
  • Use Case: When starting a new SaaS product, use this Skill to determine the optimal tech stack, define API endpoints, design the database schema, and generate the initial project structure, all documented in Architecture Decision Records (ADRs).

Quick Start

Use the solution-architect skill to design the architecture for a new SaaS product based on the provided business requirements document.

Frequently Asked Questions about solution-architect

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I design production-grade system architecture from business requirements?

To design production-grade system architecture, you analyze project constraints like scale, team, and budget to generate deliverables including ADRs, system diagrams, API contracts, and data models. This process derives the architecture directly from your specific project limitations and business needs.

How do I generate API contracts and data models for a new SaaS product?

Generating API contracts and data models involves analyzing your project constraints and producing OpenAPI, gRPC, AsyncAPI definitions, ERDs, and SQL migrations. The output adapts to your selected tech stack and scales according to your team size and compliance requirements.

Does this architecture design approach support both Express and Meticulous discovery modes?

Yes, this architecture design approach supports multiple engagement modes from Express to Meticulous. These modes adapt the discovery depth and output detail, allowing you to balance the thoroughness of architecture generation against your project timeline.

What's the best way to scaffold a project root with services and configuration files?

The best way to scaffold a project root with services and libraries is to derive the structure from constraint-driven architecture design. This method generates your initial project configuration files and service directories based on the documented architecture decisions and selected tech stack.

Can I use architecture decision records to document tech stack selection for a new project?

Yes, you can use Architecture Decision Records to document tech stack selection for a new project. The system architecture design process generates ADRs alongside system diagrams and data models, ensuring every technology choice is justified by your specific scale, budget, and compliance constraints.

When should I not use automated system architecture design for my software project?

You should not use automated system architecture design when your project lacks defined business requirements or clear constraints like scale and budget. The process relies heavily on analyzing these specific project parameters to generate tailored architecture deliverables and scaffold the codebase.