Generated: 2026-08-02T16:03:34.307Z Checklist: MXA-0325 (ISIS2-00523) Asset
Family: material-pbr-pack Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to
2026-10-30)
Objective#
Define a canonical implementation contract for material-pbr-pack so physically
based material generation, contract exposure, operational rollout, and quality
certification execute with measurable, release-gated criteria.
Scope#
In Scope#
- Workflow family requirements spanning baseline, conditioned, and consistency-locked variants.
- Control, consistency, output package, and surface parity requirements for albedo/normal/roughness/metallic-centric generation.
- Success metrics and explicit failure criteria tied to Matrix A delivery tickets.
Out of Scope#
- Implementation details for non-material-pbr-pack asset families.
- Provider-specific low-level node wiring beyond declared dependency/control contracts.
Baseline Assessment#
- Related baseline workflow count: 5
- Missing required controls in related baseline: ipadapter-style, ipadapter-composition, controlnet-pose, controlnet-canny, controlnet-lineart
- Current control-mode pass rate (global baseline): 81.58%
- Current required control quality average (selected controls): 0.975
Existing Related Workflows#
| Workflow ID | Asset Family | Output Profile | Controls |
|---|---|---|---|
3d-texture |
game-pbr-texture-material-set |
game-ready-3d-profile |
camera-lock, color-script-lock, controlnet-depth, controlnet-normal, controlnet-tile, depth-constraint, identity-adapter, latent-reuse, model-lock, palette-lock, pose-constraint, prompt-template-lock, reference-ensemble, sampler-scheduler-lock, scene-lock, seed-lock, style-anchor, style-lock, temporal-lock, wardrobe-lock |
artifact-reconstruction |
film-prop-lookdev-turntable |
game-ready-3d-profile |
camera-lock, camera-path-guide, controlnet-depth, controlnet-normal, depth-constraint, identity-adapter, latent-reuse, lens-profile-lock, model-lock, palette-lock, pose-constraint, reference-ensemble, sampler-scheduler-lock, scene-lock, seed-lock, style-anchor, temporal-lock, wardrobe-lock |
background-removal |
mkt-product-packshot-suite |
image-single-profile |
camera-lock, color-script-lock, controlnet-inpaint, controlnet-segmentation, depth-constraint, identity-adapter, latent-reuse, model-lock, palette-lock, pose-constraint, prompt-template-lock, reference-ensemble, sampler-scheduler-lock, scene-lock, seed-lock, style-anchor, style-lock, temporal-lock, wardrobe-lock |
environment-map |
game-skybox-hdri-pack |
game-ready-3d-profile |
camera-lock, color-script-lock, controlnet-depth, depth-constraint, identity-adapter, latent-reuse, lens-profile-lock, model-lock, palette-lock, pose-constraint, prompt-template-lock, reference-ensemble, sampler-scheduler-lock, scene-lock, seed-lock, style-anchor, style-lock, temporal-lock, wardrobe-lock |
mandala-3d |
game-pbr-texture-material-set |
game-ready-3d-profile |
camera-lock, color-script-lock, controlnet-depth, controlnet-normal, controlnet-tile, depth-constraint, identity-adapter, latent-reuse, lens-profile-lock, model-lock, palette-lock, pose-constraint, prompt-template-lock, reference-ensemble, sampler-scheduler-lock, scene-lock, seed-lock, style-anchor, style-lock, temporal-lock, wardrobe-lock |
Canonical Requirements#
Output Package Contract Baseline#
| Output Class | Required Package Classes |
|---|---|
preview_image |
preview, metadata, manifest |
source_frames |
source-frames, metadata, manifest |
metadata_manifest |
metadata, manifest |
Required Controls#
| Control | Category | Coverage Baseline | Quality Baseline |
|---|---|---|---|
seed-lock |
determinism | 5 workflows | 1.000 |
sampler-scheduler-lock |
determinism | 5 workflows | 1.000 |
model-lock |
determinism | 5 workflows | 1.000 |
prompt-template-lock |
determinism | 4 workflows | 1.000 |
style-lock |
style-and-identity | 4 workflows | 1.000 |
color-script-lock |
style-and-identity | 4 workflows | 1.000 |
ipadapter-style |
reference-guidance | 0 workflows | 0.900 |
ipadapter-composition |
reference-guidance | 0 workflows | 0.900 |
controlnet-pose |
spatial-guidance | 0 workflows | 1.000 |
controlnet-depth |
spatial-guidance | 4 workflows | 1.000 |
controlnet-segmentation |
spatial-guidance | 1 workflows | 1.000 |
controlnet-normal |
spatial-guidance | 3 workflows | 1.000 |
controlnet-canny |
spatial-guidance | 0 workflows | 0.950 |
controlnet-lineart |
spatial-guidance | 0 workflows | 0.950 |
lens-profile-lock |
camera-and-motion | 3 workflows | 0.925 |
Functional Requirements#
| ID | Checklist | Requirement |
|---|---|---|
F-000 |
MXA-0325 |
Publish a canonical, machine-readable requirements brief for material-pbr-pack that defines scope, constraints, success metrics, and failure criteria. |
F-001 |
MXA-0326 |
Design baseline workflow graph for material-pbr-pack with deterministic defaults. |
F-002 |
MXA-0327 |
Design image-conditioned variant workflow for material-pbr-pack. |
F-003 |
MXA-0328 |
Design control-conditioned variant workflow for material-pbr-pack (pose/depth/segmentation where applicable). |
F-004 |
MXA-0329 |
Design consistency-locked variant workflow for material-pbr-pack with continuity profile support. |
F-005 |
MXA-0330 |
Define model/node dependency manifest for material-pbr-pack workflows. |
F-006 |
MXA-0331 |
Define output package contract for material-pbr-pack including file naming and metadata manifest. |
F-007 |
MXA-0332 |
Add workflow templates and presets for material-pbr-pack production tiers (draft/final/hero). |
F-008 |
MXA-0333 |
Expose material-pbr-pack workflows via generation API with typed request contracts. |
F-009 |
MXA-0334 |
Expose material-pbr-pack workflows via SDK with end-to-end examples. |
F-010 |
MXA-0335 |
Expose material-pbr-pack workflows in web UI with ergonomic form controls and validation. |
F-011 |
MXA-0336 |
Implement side-by-side comparison tools for material-pbr-pack outputs. |
F-012 |
MXA-0337 |
Map material-pbr-pack workflows to RunPod endpoint classes and sizing policies. |
F-013 |
MXA-0338 |
Add material-pbr-pack cost estimation and budget guardrails. |
F-014 |
MXA-0339 |
Add material-pbr-pack quality evaluator and threshold-based acceptance gate. |
F-015 |
MXA-0340 |
Add material-pbr-pack regression tests and golden datasets. |
F-016 |
MXA-0341 |
Add material-pbr-pack external integration recipe for downstream tools/systems. |
F-017 |
MXA-0342 |
Publish material-pbr-pack operator and creator documentation with troubleshooting. |
Non-Functional Requirements#
| ID | Title | Verification |
|---|---|---|
NF-001 |
Deterministic replay reliability | Replay the approved golden set over two independent runs and compute reproducibility pass ratio. |
NF-002 |
Control coverage completeness | Run contract and UX coverage checks against control IDs: seed-lock, style-lock, color-script-lock, ipadapter-style, ipadapter-composition, controlnet-pose, controlnet-depth, controlnet-segmentation, controlnet-normal, controlnet-canny, controlnet-lineart, lens-profile-lock. |
NF-003 |
Output package integrity | Validate output package contract and checksum manifest presence for each golden output. |
NF-004 |
Operational budget guardrails | Evaluate p95 runtime/cost telemetry against policy thresholds and enforce rejection when guardrails fail. |
NF-005 |
External integration readiness | Pass external integration cookbook examples and operator runbook smoke checks. |
Success Metrics#
| Metric | Target | Baseline | Linked Checklist IDs |
|---|---|---|---|
SM-001 |
>= 4 certified workflows (baseline, image-conditioned, control-conditioned, consistency-locked). | 0 workflows currently mapped to material-pbr-pack. |
MXA-0326, MXA-0327, MXA-0328, MXA-0329, MXA-0340 |
SM-002 |
17/17 downstream tickets DONE by milestone end date. | 17/17 downstream tickets are DONE at report generation. | MXA-0326, MXA-0327, MXA-0328, MXA-0329, MXA-0330, MXA-0331, MXA-0332, MXA-0333, MXA-0334, MXA-0335, MXA-0336, MXA-0337, MXA-0338, MXA-0339, MXA-0340, MXA-0341, MXA-0342 |
SM-003 |
15/15 required controls implemented and exposed. | 10/15 controls currently evidenced in related baseline workflows. | MXA-0328, MXA-0333, MXA-0334, MXA-0335 |
SM-004 |
Average required-control quality score >= 0.75. | Current benchmark baseline: 0.975. | MXA-0339, MXA-0340 |
SM-005 |
normal_map_angular_error_p95 <= 12deg, roughness_mae <= 0.06, and metallic_binary_accuracy >= 0.97. | Not yet measured for material-pbr-pack baseline (family not implemented). | MXA-0329, MXA-0339, MXA-0340 |
SM-006 |
tile_seam_delta <= 0.03 and tile_repeat_artifact_rate <= 0.05. | Not yet measured for material-pbr-pack baseline (family not implemented). | MXA-0329, MXA-0339, MXA-0340 |
SM-007 |
100% of outputs include package classes required by preview_image, source_frames, and metadata_manifest mappings. |
No dedicated material-pbr-pack output package contract is currently published. | MXA-0331, MXA-0340 |
SM-008 |
Typed request/response support and user-facing controls available across generation API, SDK, and web UI with zero schema drift. | Material-pbr-pack family not yet exposed on API/SDK/UI surfaces. | MXA-0333, MXA-0334, MXA-0335 |
Failure Criteria#
| Criterion | Trigger | Severity | Required Response |
|---|---|---|---|
FC-001 |
Any of baseline, image-conditioned, control-conditioned, or consistency-locked variants is absent or uncertified. | high | Block promotion and complete missing variant tickets before reopening certification. |
FC-002 |
Any required control ID is missing from workflow metadata or is not exposed consistently in API/SDK/UI. | high | Fail contract parity checks and block release until missing control contracts and UI exposure are restored. |
FC-003 |
PBR channel fidelity or tileability metrics fail acceptance thresholds across approved golden datasets. | high | Reject quality gate, retune material workflow parameters/models, and rerun regression benchmark until thresholds pass. |
FC-004 |
Generated outputs are missing required package classes or manifest/checksum artifacts. | high | Fail output package validation and block external integrations until packaging contract is restored. |
FC-005 |
Cost estimation or runtime sizing exceeds approved guardrails without explicit override policy. | medium | Apply hard-fail guardrail behavior and reclassify endpoint sizing before allowing additional runs. |
FC-006 |
Golden dataset or regression suite detects perceptual drift above accepted threshold. | high | Mark build as non-releasable, investigate drift root cause, and refresh certification evidence only after pass. |
Downstream Delivery Map#
| Ticket | Checklist | Status | Title |
|---|---|---|---|
ISIS2-00524 |
MXA-0326 |
DONE | Design baseline workflow graph for material-pbr-pack with deterministic defaults. |
ISIS2-00525 |
MXA-0327 |
DONE | Design image-conditioned variant workflow for material-pbr-pack. |
ISIS2-00526 |
MXA-0328 |
DONE | Design control-conditioned variant workflow for material-pbr-pack (pose/depth/segmentation where applicable). |
ISIS2-00527 |
MXA-0329 |
DONE | Design consistency-locked variant workflow for material-pbr-pack with continuity profile support. |
ISIS2-00528 |
MXA-0330 |
DONE | Define model/node dependency manifest for material-pbr-pack workflows. |
ISIS2-00529 |
MXA-0331 |
DONE | Define output package contract for material-pbr-pack including file naming and metadata manifest. |
ISIS2-00530 |
MXA-0332 |
DONE | Add workflow templates and presets for material-pbr-pack production tiers (draft/final/hero). |
ISIS2-00531 |
MXA-0333 |
DONE | Expose material-pbr-pack workflows via generation API with typed request contracts. |
ISIS2-00532 |
MXA-0334 |
DONE | Expose material-pbr-pack workflows via SDK with end-to-end examples. |
ISIS2-00533 |
MXA-0335 |
DONE | Expose material-pbr-pack workflows in web UI with ergonomic form controls and validation. |
ISIS2-00534 |
MXA-0336 |
DONE | Implement side-by-side comparison tools for material-pbr-pack outputs. |
ISIS2-00535 |
MXA-0337 |
DONE | Map material-pbr-pack workflows to RunPod endpoint classes and sizing policies. |
ISIS2-00536 |
MXA-0338 |
DONE | Add material-pbr-pack cost estimation and budget guardrails. |
ISIS2-00537 |
MXA-0339 |
DONE | Add material-pbr-pack quality evaluator and threshold-based acceptance gate. |
ISIS2-00538 |
MXA-0340 |
DONE | Add material-pbr-pack regression tests and golden datasets. |
ISIS2-00539 |
MXA-0341 |
DONE | Add material-pbr-pack external integration recipe for downstream tools/systems. |
ISIS2-00540 |
MXA-0342 |
DONE | Publish material-pbr-pack operator and creator documentation with troubleshooting. |
Traceability#
- Checklist item:
MXA-0325 - Ticket key:
ISIS2-00523 - Source references:
docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.jsondocs/domains/isis/remediation-v2/ISIS_V2_ASSET_TAXONOMY.jsondocs/domains/isis/remediation-v2/ISIS_V2_CONTROL_TAXONOMY.jsondocs/domains/isis/remediation-v2/ISIS_V2_CONSISTENCY_TAXONOMY.jsondocs/domains/isis/remediation-v2/ISIS_V2_OUTPUT_PACKAGE_TAXONOMY.jsonlibs/isis/workflows/src/metadata/workflow-taxonomy-registry.jsondocs/domains/isis/remediation-v2/ISIS_V2_BENCHMARK_DASHBOARD.jsonISIS_TODOS_2.md