nw-architectural-styles-tradeoffs SKILL.md skillA

nw-architectural-styles-tradeoffs from nwave-ai/nwave is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add nwave-ai/nwave/nw-architectural-styles-tradeoffs@git:20260320.d98f3cb

Pins git:20260320.d98f3cb in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
nwave-ai/nwave
Path
nWave/skills/nw-architectural-styles-tradeoffs/SKILL.md
Versions recorded
3
Latest version
git:20260320.d98f3cb, committed Mar 20, 2026
First version recorded
Mar 17, 2026
Size
10,622 bytes
Repository stars
633
License
MIT

Architectural style selection decision matrices, trade-off analysis, structural enforcement rules, and combination patterns. Load when choosing or evaluating architecture styles.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Architectural Styles: Selection and Trade-offs

## Style Selection Decision Tree

Start here. Answer the dominant driver, follow to recommended style.

```
Is the domain complex with rich business rules?
  YES -> Do you need infrastructure independence and high testability?
    YES -> Hexagonal / Clean / Onion (functionally equivalent, different terminology)
    NO  -> Is the domain well-understood with clear module boundaries?
      YES -> Modular Monolith (single deployment, structured boundaries)
      NO  -> Layered Architecture (simple, well-known, fast to start)
  NO -> Is this a feature-heavy application with independent feature teams?
    YES -> Vertical Slice (per-feature organization, CQRS-friendly)
    NO  -> Do you need independent deployment and scaling per capability?
      YES -> Can the team handle distributed system operational complexity?
        YES -> Microservices
        NO  -> Modular Monolith (extract to services later)
      NO  -> Is the primary concern async workflows or event-driven processing?
        YES -> Event-Driven Architecture
        NO  -> Is this a data processing pipeline?
          YES -> Pipe and Filter
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add nwave-ai/nwave/nw-architectural-styles-tradeoffs@sha256:c7ea53f3af39669e

The line at the top of this page pins the label git:20260320.d98f3cb, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_fwozgoutksmra4m4.svg)](https://markdownregistry.com/a/art_fwozgoutksmra4m4)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 3 versions of this file, between Mar 17, 2026 and Mar 20, 2026, about one every day.

versioncommittedcommitsizeaudit
git:20260320.d98f3cb latest2026-03-20 d98f3cb 10,622 BA view · diff
git:20260318.e6a0e192026-03-18 e6a0e19 10,600 BA view · diff
git:20260317.1d161472026-03-17 1d16147 10,591 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (10622 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

nwave-ai/nwave · 633 stars · license MIT · pushed 2026-11-07 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_fwozgoutksmra4m4
GET https://markdownregistry.com/api/v1/resolve?ref=nwave-ai/nwave/nw-architectural-styles-tradeoffs
GET https://markdownregistry.com/api/v1/blob/c7ea53f3af39669e5f5af0ede98194ffabea7d3daa7595605bcf7658dfb51272

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from nwave-ai/nwave

nw-ab-agent-template SKILL.md skill
nwave-ai/nwave · nWave/skills/nw-ab-agent-template/SKILL.md · KNOWLEDGE — the canonical agent-spec template (frontmatter + body skeleton). Reference loaded by the create/migrate…
git:20261102.c67d57b · audit A · 633 stars
nw-ab-anti-patterns SKILL.md skill
nwave-ai/nwave · nWave/skills/nw-ab-anti-patterns/SKILL.md · KNOWLEDGE — agent/skill/command anti-pattern catalog with fixes. Reference scanned by validate-spec; no sequence.
git:20261102.c67d57b · audit A · 633 stars
nw-ab-create-agent SKILL.md skill
nwave-ai/nwave · nWave/skills/nw-ab-create-agent/SKILL.md · PROCEDURE — create a NEW agent via the 5-phase workflow (ANALYZE→DESIGN→CREATE→VALIDATE→REFINE). Trigger: build a new…
git:20261102.c67d57b · audit A · 633 stars
nw-ab-critique-dimensions SKILL.md skill
nwave-ai/nwave · nWave/skills/nw-ab-critique-dimensions/SKILL.md · Review dimensions for validating agent quality - template compliance, safety, testing, and priority validation
git:20260320.d98f3cb · audit A · 633 stars
nw-ab-examples SKILL.md skill
nwave-ai/nwave · nWave/skills/nw-ab-examples/SKILL.md · KNOWLEDGE — canonical worked examples for agent creation, migration, and command optimization. Reference for the…
git:20261102.c67d57b · audit A · 633 stars
nw-ab-house-style SKILL.md skill
nwave-ai/nwave · nWave/skills/nw-ab-house-style/SKILL.md · KNOWLEDGE — caveman-native authoring house style + by-construction guarantees (Reasoning Mandate injection…
git:20261102.c67d57b · audit A · 633 stars
nw-ab-merge-agents SKILL.md skill
nwave-ai/nwave · nWave/skills/nw-ab-merge-agents/SKILL.md · PROCEDURE — merge agent B into agent A, relocating skills and cleaning up all references. Trigger: two agents must…
git:20261102.c67d57b · audit A · 633 stars
nw-ab-migrate-monolith SKILL.md skill
nwave-ai/nwave · nWave/skills/nw-ab-migrate-monolith/SKILL.md · PROCEDURE — migrate one legacy monolithic agent to a lean core plus routed skills. Trigger: an existing agent has…
git:20261102.c67d57b · audit A · 633 stars
nw-ab-optimize-command SKILL.md skill
nwave-ai/nwave · nWave/skills/nw-ab-optimize-command/SKILL.md · PROCEDURE — optimize a bloated command file to a lean declarative definition (forge.md pattern). Trigger: a command…
git:20261102.c67d57b · audit A · 633 stars
nw-ab-optimize-skill SKILL.md skill
nwave-ai/nwave · nWave/skills/nw-ab-optimize-skill/SKILL.md · PROCEDURE — optimize one requested existing skill. Measures multi-trigger, duplication, and resident-context debt…
git:20261102.c67d57b · audit A · 633 stars
nw-ab-validate-spec SKILL.md skill
nwave-ai/nwave · nWave/skills/nw-ab-validate-spec/SKILL.md · PROCEDURE — validate an EXISTING agent spec against the nw-ab-validation-checklist. Trigger: checking a spec for…
git:20261102.c67d57b · audit A · 633 stars
nw-ab-validation-checklist SKILL.md skill
nwave-ai/nwave · nWave/skills/nw-ab-validation-checklist/SKILL.md · KNOWLEDGE (data) — the agent-spec validation checklist. The item definitions the validate-spec procedure RUNS against…
git:20261102.c67d57b · audit A · 633 stars

Every file in nwave-ai/nwave

Browse by kind, by grade A, or by owner.