oma-architecture

Analyze software architecture options and produce ADR artifacts with tradeoffs and risks.

46|2|Updated Mar 23, 2025
One-click install
npx skills add https://github.com/gracefullight/krds --skill oma-architecture-gracefullight
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: oma-architecture
Source: https://github.com/gracefullight/krds/tree/main/.agents/skills/oma-architecture
Command: npx skills add https://github.com/gracefullight/krds --skill oma-architecture-gracefullight

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you design and evaluate software architecture decisions by turning vague system design concerns into concrete options with documented risks, tradeoffs, assumptions, and validation steps.

Core Features & Use Cases

  • Architecture diagnosis and routing: clarifies whether the issue is an architecture problem and selects the lightest sufficient method.
  • Option comparison with explicit tradeoffs: compares materially different boundary and ownership approaches rather than superficial variations.
  • Risk- and quality-attribute-driven recommendations: supports ATAM-style scenario analysis, CBAM-style investment prioritization, and ADR-style final records.

Quick Start

Use oma-architecture to produce an architecture recommendation or ADR for your system-design question, including at least assumptions, tradeoffs, risks, and validation steps.

Frequently Asked Questions about oma-architecture

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

FAQPage Schema
How do I document software architecture decisions with explicit tradeoffs?▼

To document software architecture decisions with explicit tradeoffs, you generate an Architecture Decision Record (ADR) that captures assumptions, risks, validation steps, and a source-grounded recommendation comparing materially different boundary options.

What is the best way to choose between a monolith and service extraction for my system design?▼

Choosing between a monolith and service extraction requires a design-twice comparison of module boundaries and ownership tradeoffs. You evaluate quality attributes and apply cost/benefit framing to determine if decomposition is justified.

How do I prioritize refactoring investments in software architecture?▼

Prioritize refactoring investments by applying CBAM-style cost and benefit analysis to your architecture. This frames each potential refactor as an investment, weighing the architectural risks against the expected quality attribute improvements.

When do I need ATAM-style risk analysis for module boundaries?▼

You need ATAM-style risk analysis for module boundaries when evaluating tradeoff-heavy architectural choices. It clarifies whether a system design issue is truly an architectural problem and identifies quality attribute risks through scenario analysis.

Can I use this to compare superficially different architectural options?▼

No, this focuses on comparing materially different boundary and ownership approaches rather than superficial variations. It uses diagnostic routing to select the lightest sufficient method for evaluating your software architecture options.

Does architecture diagnosis help determine if a problem is actually a system design issue?▼

Yes, architecture diagnosis clarifies whether your concern is genuinely an architecture problem before analysis. It routes the issue to the lightest sufficient method, preventing unnecessary evaluation of non-architectural system design concerns.