faion-software-architect

Guide software architecture design with style selection and decision trees.

4|Updated Jan 16, 2026
One-click install
npx skills add https://github.com/faionfaion/faion-network --skill faion-software-architect
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: faion-software-architect
Source: https://github.com/faionfaion/faion-network/tree/main/skills/faion-software-architect
Command: npx skills add https://github.com/faionfaion/faion-network --skill faion-software-architect

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps you make informed decisions about system architecture, technology choices, and design patterns to build scalable, maintainable, and performant software systems.

Core Features & Use Cases

  • Architecture Style Selection: Guides you from monoliths to microservices based on team size and maturity.
  • Technology Stack Guidance: Recommends frameworks, databases, and cloud providers based on project needs.
  • Pattern Implementation: Provides insights into Clean Architecture, Hexagonal, DDD, and distributed patterns.
  • Use Case: You need to design a new e-commerce platform. This Skill will help you choose between a modular monolith or microservices, select a suitable database (e.g., PostgreSQL vs. MongoDB), and apply patterns like CQRS or Saga for complex workflows.

Quick Start

Use the faion-software-architect skill to help design the architecture for a new web application.

Frequently Asked Questions about faion-software-architect

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

FAQPage Schema
How do I choose between a modular monolith and microservices for my system design?

System design architecture style selection depends on your team size and DevOps maturity, guiding you from monoliths to modular monoliths or microservices. A modular monolith suits smaller teams, while microservices require higher DevOps maturity for scalable, maintainable software systems.

When do I need distributed system patterns like Saga, CQRS, or Event Sourcing?

You need distributed system patterns like Saga, CQRS, and Event Sourcing when managing complex workflows and data consistency in distributed architectures. These patterns guide pattern implementation for robust, scalable software architectures handling intricate operations.

What is the best way to document software architecture decisions for my team?

The best way to document software architecture decisions is by using Architecture Decision Records (ADRs) and the C4 model for visualization. These practices capture design rationale and communicate structural choices effectively across your engineering team.

How do I evaluate quality attributes during software architecture design?

You evaluate quality attributes during software architecture design using the ATAM method. This analysis helps assess performance, scalability, and maintainability, ensuring your selected architecture styles and patterns meet the necessary system requirements.

Does Domain-Driven Design (DDD) work with Clean Architecture and Hexagonal patterns?

Domain-Driven Design (DDD) works seamlessly with Clean Architecture, Hexagonal, and Onion patterns to isolate business logic. Combining these architectural patterns ensures your core domain remains robust, maintainable, and independent of external infrastructure concerns.

What's the best way to decide between PostgreSQL and MongoDB for a new web application?

The best way to decide between PostgreSQL and MongoDB is by evaluating your project's data structure needs. Technology stack guidance recommends relational databases for structured data and document databases for flexible schemas during system design.