# Isis Material PBR Pack Side-by-Side Comparison Tools Runbook

Last Updated: 2026-03-01  
Scope: `MXA-0336` side-by-side comparison tooling for `material-pbr-pack`
outputs.

## Purpose

Generate and validate the canonical comparison-tooling artifact for
`material-pbr-pack` output review in the consistency workspace, including
profile-aware filtering, dimension presets, and
material-category/subtype/surface-age/albedo/roughness/metallic/normal/microdetail/macro-pattern/tileability/uv/displacement/lighting-context/platform/render-intent/color-script/material-finish/material-control/style/continuity/control-alignment/reference-alignment/lens/texture-resolution/channel-pack/seam-suppression/seed
scoring metrics.

## Artifacts

- `docs/domains/isis/remediation-v2/ISIS_V2_MATERIAL_PBR_PACK_SIDE_BY_SIDE_COMPARISON_TOOLS.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_MATERIAL_PBR_PACK_SIDE_BY_SIDE_COMPARISON_TOOLS.md`

## Generator

```bash
node scripts/isis/generate-v2-material-pbr-pack-side-by-side-comparison-tools.mjs
```

Options:

- `--report-date=YYYY-MM-DD` (default: current UTC date)

## Validator

```bash
node scripts/isis/validate-v2-material-pbr-pack-side-by-side-comparison-tools.mjs
```

## Source Inputs

- `docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_MATERIAL_PBR_PACK_REQUIREMENTS_BRIEF.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_MATERIAL_PBR_PACK_WEB_UI_CONTROLS_VALIDATION.json`
- `apps/isis/web/src/pages/OutputComparisonWorkspacePage.tsx`
- `apps/isis/web/src/pages/OutputComparisonWorkspacePage.spec.tsx`
- `apps/isis/web/src/pages/output-consistency-utils.ts`
- `apps/isis/web/src/pages/output-consistency-utils.spec.ts`
- `apps/isis/web/src/pages/material-pbr-pack-comparison-utils.ts`
- `apps/isis/web/src/pages/material-pbr-pack-comparison-utils.spec.ts`

## Operational Cadence

1. Regenerate when material-pbr-pack comparison profile routing, dimensions, or
   metrics change.
2. Validate before closing downstream RunPod/cost/quality tickets that depend on
   stable side-by-side comparison evidence.
3. Keep material-pbr-pack comparison behavior synchronized with workflow
   API/SDK/UI typed contract fields and run-form enforcement.

## Related Artifacts

- `apps/isis/web/src/pages/OutputComparisonWorkspacePage.tsx`
- `apps/isis/web/src/pages/material-pbr-pack-comparison-utils.ts`
- `docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_BACKLOG.md`
