adapter-parity-check

Category: Tools & Productivity | Uploader: matter-labs | Downloads: 0 | Version: v1.0（Latest）

Validate ethers and viem adapter parity for zksync-js when core or adapter behavior changes. Detect mismatches, enforce documented exceptions, and protect core-to-adapter contract consistency.

Changelog: Source: GitHub https://github.com/matter-labs/zksync-js

Directory Structure

Current level: .agents/skills/adapter-parity-check/

📁 agents/
- 📄 openai.yaml 602 B
📄 SKILL.md 1.9 KB

SKILL.md

---
name: adapter-parity-check
description: Validate ethers and viem adapter parity for zksync-js when core or adapter behavior changes. Detect mismatches, enforce documented exceptions, and protect core-to-adapter contract consistency.
metadata:
  short-description: Detect and gate ethers/viem behavior drift
---

# Adapter Parity Check

Use this skill to keep adapter behavior consistent with core abstractions.

## Use This Skill When

- Any change touches `src/core/**`
- Only one adapter is modified under `src/adapters/ethers/**` or `src/adapters/viem/**`
- A flow/resource change may alter user-visible behavior in adapters

Use explicit invocation as `$adapter-parity-check` when parity risk is high.

## Responsibilities

1. Build a touched-resource map from the diff.
2. Compare adapter parity for affected resources:

- method availability
- input/return shape expectations
- error semantics
- flow/status handling behavior

3. Identify mismatches and whether they are intentional.
4. Enforce explicit exception protocol when parity is intentionally divergent.

## Exception Protocol

If parity is intentionally not achieved, require an `Adapter Parity Exception` note with:

1. Rationale
2. Scope
3. Consumer impact
4. Follow-up issue or timeline
5. Docs note when user-facing behavior differs

## Guardrails

- Keep `src/core` adapter-agnostic.
- Do not accept one-adapter behavior changes without parity assessment.
- Do not hide parity exceptions in code comments only; require PR-level declaration.

## Output Format

Provide:

1. Parity matrix for touched resources
2. Mismatches found
3. Exception status (`none`, `required`, `provided`)
4. Required follow-up actions

## References

- [`llm/architecture-adapters-and-core.md`](../../../llm/architecture-adapters-and-core.md)
- [`llm/repo-context.md`](../../../llm/repo-context.md)
- [`llm/change-playbook.md`](../../../llm/change-playbook.md)
- [`AGENTS.md`](../../../AGENTS.md)

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

adapter-parity-check

Directory Structure

SKILL.md

Report

Notice