architecture

Analyzes requirements, evaluates trade-offs, and generates ADR documentation for software architecture.

Updated Mar 7, 2026
One-click install
npx skills add https://github.com/devon87warren-afk/eboss-monorepo --skill architecture-devon87warren-afk
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architecture
Source: https://github.com/devon87warren-afk/eboss-monorepo/tree/main/apps/manager/.agent/skills/architecture
Command: npx skills add https://github.com/devon87warren-afk/eboss-monorepo --skill architecture-devon87warren-afk

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a structured framework for making sound architectural decisions, ensuring that requirements are met, trade-offs are evaluated, and decisions are well-documented through Architecture Decision Records (ADRs).

Core Features & Use Cases

  • Requirements Analysis: Guides the process of understanding project needs.
  • Trade-off Evaluation: Provides methods for comparing different architectural options.
  • ADR Documentation: Facilitates the creation of clear, concise ADRs to capture rationale.
  • Use Case: When designing a new microservice, use this Skill to analyze different communication patterns (e.g., REST vs. gRPC vs. message queues) and document the chosen approach with its justifications and accepted trade-offs.

Quick Start

Use the architecture skill to analyze trade-offs for a new service's data access layer.

Frequently Asked Questions about architecture

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

FAQPage Schema
How do I evaluate trade-offs when making a system design decision?▼

To evaluate trade-offs in system design, use a structured architectural decision-making framework to analyze project requirements, compare different patterns, and document the justifications for your chosen approach.

What is the best way to document architectural decisions for a new microservice?▼

The best way to document architectural decisions is by creating Architecture Decision Records (ADRs) that capture the requirements analysis, evaluated trade-offs, and the rationale for your system design choices.

How do I choose between REST and gRPC for my service communication pattern?▼

Choosing between REST and gRPC involves using a decision tree framework to analyze your service's specific communication requirements and evaluate the trade-offs of each pattern before documenting the final choice in an ADR.

When do I need to use Architecture Decision Records in software development?▼

You need to use Architecture Decision Records whenever you make significant system design choices, ensuring that your architectural patterns, requirements analysis, and trade-off evaluations are structured and justifiable for future reference.

Can I use a decision-making framework for selecting data access patterns?▼

Yes, you can use an architectural decision-making framework to analyze trade-offs for a new service's data access layer, guiding your pattern selection and providing templates to document the final design choice.

What should I include in an ADR template to justify my architectural patterns?▼

An ADR template should include sections for requirements analysis, trade-off evaluation, pattern selection guidelines, and the specific justifications for the architectural decisions made during your system design process.