nw-design-patterns SKILL.md skillA

nw-design-patterns 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-design-patterns@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-design-patterns/SKILL.md
Versions recorded
3
Latest version
git:20260320.d98f3cb, committed Mar 20, 2026
First version recorded
Mar 17, 2026
Size
3,871 bytes
Repository stars
633
License
MIT

7 agentic design patterns with decision tree for choosing the right pattern for each agent type.

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

# Agentic Design Patterns

## Pattern Decision Tree

```
Is the agent doing a single focused task?
  YES -> Does it need self-evaluation?
    YES -> Reflection
    NO  -> ReAct (default for most agents)
  NO -> Is it coordinating multiple agents?
    YES -> Are tasks independent?
      YES -> Parallel Orchestration
      NO  -> Are tasks sequential with dependencies?
        YES -> Sequential Orchestration
        NO  -> Hierarchical (supervisor + workers)
    NO -> Is it routing to one of several specialists?
      YES -> Router
      NO  -> Does it need structured task decomposition?
        YES -> Planning
        NO  -> ReAct (default)
```

## 1. ReAct (Reason + Act)

General-purpose agents needing tool calling and iterative problem-solving.

**Loop**: Reason -> Select/execute action -> Observe result -> Repeat until done.
**When**: Default pattern. Most specialist agents.
**Examples**: software-crafter, researcher, troubleshooter.

## 2. Reflection

Agent must evaluate and iteratively improve its own output.

**Loop**: Generate -> Review against criteria -> Identify gaps -> Refine -> Validate threshold met.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add nwave-ai/nwave/nw-design-patterns@sha256:b7bfb731708da9c4

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_s2pdbk5ala2ceudi.svg)](https://markdownregistry.com/a/art_s2pdbk5ala2ceudi)

2 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 3,871 BA view · diff
git:20260318.e6a0e192026-03-18 e6a0e19 3,849 BA view · diff
git:20260317.1d161472026-03-17 1d16147 3,840 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 (3871 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_s2pdbk5ala2ceudi
GET https://markdownregistry.com/api/v1/resolve?ref=nwave-ai/nwave/nw-design-patterns
GET https://markdownregistry.com/api/v1/blob/b7bfb731708da9c485b5b3516495af45e8310db2a032b58186bddcca8320f22b

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.