nw-algebraic-design-protocol SKILL.md skillA

nw-algebraic-design-protocol 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-algebraic-design-protocol@git:20261102.c67d57b

Pins git:20261102.c67d57b 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-algebraic-design-protocol/SKILL.md
Versions recorded
1
Latest version
git:20261102.c67d57b, committed Nov 2, 2026
Size
9,527 bytes
Repository stars
633
License
MIT

The METHOD for finding a design — name observations and equality before constructors, then follow any contradiction to the type or observation that causes it. Use when a design decision is contested, a law has exceptions, a census or model keeps producing wrong answers, or a representation change must preserve meaning. Complements nw-fp-algebra-driven-design, which catalogues the structures; this says how to arrive at one and what to do when it breaks.

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

# Algebraic Design Protocol

`nw-fp-algebra-driven-design` catalogues structures; this finds a design and
traces a false law. Load both for a compositional core; load this alone for a
design that keeps giving wrong answers.

**nWave sequencing choice.** State observations/equality before an algebra;
this is project synthesis, not a universal ADD claim.

**Cross-layer authority (ADR-SSOT-002 §6a).** One language-agnostic procedure
for declared target-boundary layers: domain, application/ports, adapter/
integration, infrastructure/recovery. `targets[].boundary`/`contract-shape`
sets applicability without a persisted field. OO/FP catalogues are projections,
never competitors.

## 1. Observations and equality, before anything else

State what a user can meaningfully **observe**. Then define `x ≈ y` as agreement
under that observation set — never structural equality chosen because it was easy
to implement.

Inventory each observation, its result type, and **what it cannot distinguish**.
That last column is the one that pays: a Boolean result is usually too weak the
moment composition needs the remaining input or state.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add nwave-ai/nwave/nw-algebraic-design-protocol@sha256:787e297a97426ff5

The line at the top of this page pins the label git:20261102.c67d57b, 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_bxe5uszysgcdwiqb.svg)](https://markdownregistry.com/a/art_bxe5uszysgcdwiqb)

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

Versions

The registry has recorded 1 version of this file, committed on Nov 2, 2026.

versioncommittedcommitsizeaudit
git:20261102.c67d57b latest2026-11-02 c67d57b 9,527 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 (9527 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_bxe5uszysgcdwiqb
GET https://markdownregistry.com/api/v1/resolve?ref=nwave-ai/nwave/nw-algebraic-design-protocol
GET https://markdownregistry.com/api/v1/blob/787e297a97426ff504417cac9ecc2bf3f5e2c7ba5c18e613566e3ac11cb86cf3

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.