software-architect

Design, analyze, and document system architectures with ADRs and C4 descriptions.

Updated Feb 13, 2026
One-click install
npx skills add https://github.com/lev-os/lev-content --skill software-architect-lev-os
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: software-architect
Source: https://github.com/lev-os/lev-content/tree/main/sources/skills/arch
Command: npx skills add https://github.com/lev-os/lev-content --skill software-architect-lev-os

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a structured approach to designing, analyzing, and reviewing software architecture, ensuring systems meet quality attributes and business goals through rigorous trade-off analysis.

Core Features & Use Cases

  • Architectural Analysis: Evaluate systems based on quality attributes, trade-offs, and drivers.
  • Decision Documentation: Generate Architecture Decision Records (ADRs) and C4 model descriptions.
  • Code Review: Assess code quality, identify risks, and suggest fitness functions during PR reviews.
  • Use Case: When designing a new microservice, use this Skill to elicit quality attributes, explore candidate approaches, document trade-offs, and generate an ADR.

Quick Start

Analyze the architecture for a new e-commerce platform, focusing on scalability and security.

Frequently Asked Questions about software-architect

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

FAQPage Schema
How do I document software architecture trade-offs and design decisions?

To document software architecture trade-offs, you can generate Architecture Decision Records (ADRs) that capture the context, decision, and consequences. This Skill provides a systematic framework to elicit quality attributes, explore candidate approaches, and formalize the resulting trade-off analysis into structured ADR artifacts.

Can I use C4 model descriptions to analyze and review system architecture?

Yes, you can generate C4 model descriptions to analyze and review system architecture. This Skill supports creating these structured descriptions to visualize system context, containers, components, and code levels, facilitating architectural analysis and ensuring designs meet business goals.

How do I assess quality attributes during a code or PR review?

You assess quality attributes during a code or PR review by evaluating code quality, identifying architectural risks, and suggesting fitness functions. This Skill provides a framework to review pull requests against architectural principles and verify adherence to specified quality attributes.

What is the best way to elicit quality attributes for a new microservice design?

The best way to elicit quality attributes for a new microservice is using a systematic architectural framework. This Skill facilitates quality attribute elicitation and trade-off analysis, ensuring your microservice design meets scalability, security, and other business goals before implementation.

Does this architectural analysis framework support generating fitness functions?

Yes, this architectural analysis framework supports generating fitness functions. It assesses code quality and adherence to architectural principles during reviews, allowing you to define and suggest fitness functions that continuously validate your system architecture against established quality attributes.

When should I use ADRs instead of general software design documentation?

You should use ADRs instead of general software design documentation when you need to rigorously capture specific architectural decisions and their trade-offs. This Skill focuses on generating Architecture Decision Records to document the context, decision drivers, and consequences of your architectural choices.