# Discovery Parity Matrix

> Produce or refresh the parity matrix in the discovery workflow. Use when building the parity matrix from feature contracts and runtime characterization evidence and routing parity reasoning to the parity role. Fifth stage, after runtime characterization and before behavior reconciliation.

- Skill: `drmoisan/discovery-parity-matrix` (Agent Skill)
- Install (CLI): `npx skillmds@latest add drmoisan/discovery-parity-matrix`
- Raw SKILL.md: https://api.skillmd.com/api/skills/drmoisan/discovery-parity-matrix/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: drmoisan (https://skillmd.com/u/drmoisan)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/drmoisan/discovery-parity-matrix

---


# Discovery Parity Matrix

Runs the parity stage of the discovery and parity-definition workflow. It
produces or refreshes the parity matrix by comparing the feature contracts
against the runtime characterization scenarios, so the workflow can measure how
closely the modern target reproduces the legacy behavior. All domain specificity
is read from the domain profile at runtime.

## When to Use This Skill

- Feature contracts and runtime characterization scenarios both exist.
- You need a current parity matrix before reconciling unspecified behavior.

## Prerequisites

- `discovery-coverage-ledger` and `discovery-runtime-characterization` have
  completed.
- The domain profile is loaded and valid.

## Workflow

1. **Consume upstream artifacts.** Read the feature contracts (schema
   `schemas/discovery/v1/feature-contract.schema.json`) and the runtime
   characterization scenarios (schema
   `schemas/discovery/v1/runtime-characterization-scenario.schema.json`).

2. **Produce or refresh the parity matrix.** Build the parity matrix conforming
   to the schema `schemas/discovery/v1/parity-matrix.schema.json`, mapping each
   feature contract to its characterized behavior and its current parity state.
   When the matrix already exists, refresh it in place from the latest upstream
   artifacts.

3. **Route parity reasoning.** Hand the matrix to the parity role for reasoning
   about gaps and states (see `## Worker Routing`).

## Worker Routing

- Worker: `legacy-parity-analyst`

The parity role reasons about each parity-matrix entry, classifying parity state
and flagging gaps for behavior reconciliation.

## Validation

- Validate the parity matrix with `dev.discovery.validate-parity-matrix`.
- An empty error list is a pass. On any error, follow the direction in
  `discovery-validate-artifacts`.

## Referenced Skills

- `discovery-workflow` — stage order and the canonical Referenced Contracts
  registry.
- `discovery-validate-artifacts` — pass/fail semantics and error routing.

## Notes

- Parity gaps flagged here are the primary input to
  `discovery-behavior-reconciliation`.