# Discovery Behavior Reconciliation

> Capture unspecified or contradictory behavior and reconcile it into product decisions in the discovery workflow. Use when recording unspecified-behavior findings from the parity matrix and reconciling them into product-decision records via the reconciler role. Sixth stage, after parity and before the validation gate.

- Skill: `drmoisan/discovery-behavior-reconciliation` (Agent Skill)
- Install (CLI): `npx skillmds@latest add drmoisan/discovery-behavior-reconciliation`
- Raw SKILL.md: https://api.skillmd.com/api/skills/drmoisan/discovery-behavior-reconciliation/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-behavior-reconciliation

---


# Discovery Behavior Reconciliation

Runs the reconciliation stage of the discovery and parity-definition workflow.
It captures behavior that is unspecified or contradictory across the legacy
source, the runtime observations, and the parity matrix, then reconciles each
finding into a product decision. All domain specificity is read from the domain
profile at runtime.

## When to Use This Skill

- The parity matrix has flagged gaps or contradictions that need a documented
  resolution.
- You need product-decision records before the final validation gate.

## Prerequisites

- `discovery-parity-matrix` has completed.
- The domain profile is loaded and valid.

## Workflow

1. **Capture unspecified behavior.** Record each unspecified or contradictory
   behavior as a record conforming to the schema
   `schemas/discovery/v1/unspecified-behavior-record.schema.json`, citing the
   parity-matrix entry and evidence that surfaced it.

2. **Reconcile into product decisions.** For each captured record, produce a
   product-decision record conforming to the schema
   `schemas/discovery/v1/product-decision-record.schema.json`, stating the
   decision and its rationale.

3. **Route reconciliation.** Hand the records to the reconciler role for the
   reconciliation decision (see `## Worker Routing`).

## Worker Routing

- Worker: `requirements-reconciler`

The reconciler role decides how each unspecified or contradictory behavior is
resolved and records the outcome as a product decision.

## Validation

- Validate unspecified-behavior records with
  `dev.discovery.validate-unspecified-behavior`.
- Validate product-decision records with
  `dev.discovery.validate-product-decision`.
- 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

- Product-decision records complete the artifact set consumed by the final
  validation gate in `discovery-validate-artifacts`.