architecture

Guide architectural decisions with requirements analysis, trade-off evaluation, and ADR documentation.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/ntdev204/rai_ws --skill architecture-ntdev204
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture
Source: https://github.com/ntdev204/rai_ws/tree/main/.agent/skills/architecture
Command: npx skills add https://github.com/ntdev204/rai_ws --skill architecture-ntdev204

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a framework for making sound architectural decisions, ensuring systems are scalable, maintainable, and meet business requirements by guiding through requirements analysis, trade-off evaluation, and documentation.

Core Features & Use Cases

  • Requirements Analysis: Helps identify key project constraints and scale factors.
  • Pattern Selection: Offers guidance on choosing appropriate architectural patterns (e.g., Microservices, DDD, Repository).
  • Trade-off Documentation: Facilitates the creation of Architecture Decision Records (ADRs) to capture rationale and accepted trade-offs.
  • Use Case: When starting a new project, use this Skill to systematically gather requirements, evaluate different architectural approaches, and document the final decision with clear reasoning.

Quick Start

Use the architecture skill to help design the system architecture for a new SaaS product.

Frequently Asked Questions about architecture

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

FAQPage Schema
What is an Architecture Decision Record and when do I need one for system design?

An Architecture Decision Record (ADR) documents architectural decisions, rationale, and accepted trade-offs. You need ADRs when designing systems to ensure maintainability and provide clear reasoning for selected design patterns. This framework guides you through creating them.

How do I evaluate architectural trade-offs and select the right design patterns?

Evaluate architectural trade-offs by analyzing project requirements and scale factors against a pattern selection tree. This framework guides you through comparing approaches like Microservices or Domain-Driven Design to select patterns that best fit your system constraints.

How to document system architecture decisions for a new SaaS product?

Document system architecture by systematically gathering requirements, evaluating different architectural approaches, and using ADR templates. This framework ensures your final decisions for SaaS products are documented with clear reasoning and accepted trade-offs.

Can I use this framework for both MVP and enterprise-level application architecture?

Yes, you can use this architectural decision-making framework for projects ranging from MVPs to enterprise-level applications. It adapts context discovery and pattern selection to evaluate system constraints appropriately regardless of project scale.

What's the best way to analyze requirements and constraints for system architecture design?

The best way to analyze requirements for system architecture is using a structured framework for context discovery. It helps identify key project constraints, scale factors, and business requirements to ensure your system design is robust and maintainable.