adapter-conformance-check

Audits provider-adapter integration points for Nexus Gateway specification and wiring compliance.

21|3|Updated May 26, 2026
One-click install
npx skills add https://github.com/AlphaBitCore/nexus-gateway --skill adapter-conformance-check
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adapter-conformance-check
Source: https://github.com/AlphaBitCore/nexus-gateway/tree/main/.claude/skills/adapter-conformance-check
Command: npx skills add https://github.com/AlphaBitCore/nexus-gateway --skill adapter-conformance-check

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Walk the seven-step audit to ensure adapter codecs and dispatch logic stay within architectural contracts. It detects leakage of per-adapter details into the generic spec_adapter dispatcher, missing canonicalization before PrepareBody, hand-rolled error envelopes, untouched prefix-lists without empirical evidence, and missing PassthroughRewrite wiring.

Core Features & Use Cases

  • Provides a structured, repeatable audit aligned with provider-adapter-architecture rules.
  • Prevents drift when adding or refactoring adapters by validating canonicalization, error handling, and wiring.
  • Use Case: before submitting a PR that touches adapters, run the audit to surface conformance violations and apply fixes.

Quick Start

Run the seven-step audit before starting any adapter-related changes in the repository.

Frequently Asked Questions about adapter-conformance-check

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

FAQPage Schema
How do I audit provider adapters for architecture conformance before submitting a PR?

Adapter conformance auditing detects leakage of per-adapter details into generic dispatchers, missing canonicalization before PrepareBody, hand-rolled error envelopes, and missing PassthroughRewrite wiring to prevent architectural drift.

What is adapter conformance checking and when do I need it?

Adapter conformance checking is an audit process enforcing provider-adapter integration contracts within a gateway dispatcher. You need it when adding or refactoring adapters to detect logic drift and validate canonicalization, error handling, and wiring.

Why does per-adapter logic leak into the generic spec_adapter dispatcher?

Per-adapter logic leaks into the generic spec_adapter dispatcher when architectural contracts are violated during code changes. Auditing integration points and dispatch logic detects this drift, ensuring canonicalization and proper error handling are maintained.

How do I enforce canonicalization and error envelopes in provider adapters?

To enforce canonicalization and error envelopes in provider adapters, apply a structured audit verifying proper data transformation before PrepareBody and validating standardized error handling to prevent hand-rolled envelopes.

Does the adapter conformance audit work on existing spec_* provider packages?

Yes, the adapter conformance audit analyzes code paths under spec_* provider packages and the core dispatcher. It detects untouched prefix-lists without empirical evidence and validates existing wiring against architectural contracts.