architecture-advisor

Recommend .NET application architectures via a structured requirements questionnaire.

1|Updated Mar 27, 2026
One-click install
npx skills add https://github.com/Maj3D10/Training-Platform --skill architecture-advisor-maj3d10
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-advisor
Source: https://github.com/Maj3D10/Training-Platform/tree/main/.agent/skills/architecture-advisor
Command: npx skills add https://github.com/Maj3D10/Training-Platform --skill architecture-advisor-maj3d10

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents building a .NET system with the wrong architecture by collecting project context and recommending the best-fit option before any scaffolding or restructuring decisions are made.

Core Features & Use Cases

  • Architecture-first guidance: Runs a structured questionnaire across domain complexity, team setup, system lifetime/scale, compliance needs, existing codebase, and integration complexity.
  • Evidence-based recommendations: Selects among Vertical Slice Architecture, Clean Architecture, DDD + Clean Architecture, or Modular Monolith using a decision matrix and conflict-resolution rules.
  • Actionable next steps: Explains when to evolve the architecture over time and provides anti-pattern examples (e.g., applying Clean Architecture to simple CRUD).
  • Use Case: When starting a new .NET project or restructuring an existing one, the skill helps you decide how to organize features and boundaries so the codebase remains maintainable as complexity grows.

Quick Start

Load the architecture-advisor skill and ask it: "Which architecture should I use for my new .NET project, and why?"

Frequently Asked Questions about architecture-advisor

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

FAQPage Schema
How do I choose the right .NET architecture for my project?

Choosing the right .NET architecture requires assessing domain complexity, team size, system lifetime, and integration patterns. A structured questionnaire evaluates these requirements to recommend the best-fit architecture, preventing misaligned structural decisions before scaffolding begins.

When should I use Vertical Slice Architecture instead of Clean Architecture?

Vertical Slice Architecture suits simple applications where Clean Architecture introduces unnecessary ceremony. Use Clean Architecture or DDD + Clean Architecture when domain complexity, compliance boundaries, and system scale demand stricter separation of concerns and explicit domain boundaries.

What is a Modular Monolith and when is it recommended for .NET?

A Modular Monolith is an architectural style organizing a single deployment into independent modules. It is recommended for .NET projects needing strict module boundaries and domain isolation without the operational complexity of distributed microservices.

Can I use DDD with Clean Architecture for a complex .NET system?

Yes, DDD + Clean Architecture is explicitly recommended for complex .NET systems. It combines strict domain-driven design boundaries for complex business logic with the dependency inversion and layered structure of Clean Architecture to maintain long-term maintainability.

Why does applying Clean Architecture to simple CRUD operations cause problems?

Applying Clean Architecture to simple CRUD operations introduces unnecessary abstraction layers and boilerplate, creating an anti-pattern. It overcomplicates basic data access, reducing development speed without providing meaningful architectural benefits for straightforward domain logic.