architect

Guide software architecture design and document technical decisions with ADRs.

20|1|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/krzysztofsurdy/code-virtuoso --skill architect-krzysztofsurdy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architect
Source: https://github.com/krzysztofsurdy/code-virtuoso/tree/main/skills/roles/architect
Command: npx skills add https://github.com/krzysztofsurdy/code-virtuoso --skill architect-krzysztofsurdy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a structured approach to designing software architecture, ensuring technical decisions are well-documented, scalable, and aligned with product requirements.

Core Features & Use Cases

  • System Design: Define component boundaries, data flows, and technology choices for new or existing systems.
  • API Contract Definition: Specify clear interfaces between different parts of the system.
  • Architecture Decision Records (ADRs): Document significant technical decisions with their rationale and trade-offs.
  • Use Case: When building a new microservice, use the Architect role to define its responsibilities, its API, and how it will interact with other services, documenting key decisions in ADRs.

Quick Start

Use the architect skill to design the system architecture for a new e-commerce platform.

Frequently Asked Questions about architect

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

FAQPage Schema
How do I document technical decisions and architectural trade-offs?

Document technical decisions by creating Architecture Decision Records (ADRs) that capture the rationale, context, and trade-offs of significant architectural choices. This ensures your system design remains well-documented and aligned with product requirements.

What is the best way to define API contracts and component boundaries?

The best way to define API contracts is to specify clear interfaces and data flows between different parts of the system. This structured approach ensures robust component boundaries and seamless interaction within your software architecture.

How do I design scalable system architecture for a new platform?

Design scalable system architecture by defining component boundaries, evaluating technology choices, and mapping out data flows. This structured process ensures your new platform meets scalability and product requirement demands.

Can I use this approach to evaluate technology choices for microservices?

Yes, you can evaluate technology choices for microservices by defining each service's responsibilities, its API contract, and how it will interact with other services. This evaluation supports architectural trade-off analysis and decision documentation.

When do I need to create Architecture Decision Records?

You need to create Architecture Decision Records when making significant technical decisions during software architecture design. ADRs document the decision rationale and trade-offs, ensuring technical choices are well-documented and scalable.

What are the limitations of relying solely on system design without documenting trade-offs?

Relying solely on system design without documenting trade-offs leads to undocumented architectural decisions. Without ADRs to capture rationale and technology evaluations, maintaining scalability and alignment with product requirements becomes difficult.