# ISIS v2 Character Costume Variant Pack Canonical Requirements Brief

Generated: 2026-02-26T05:17:41.661Z Checklist: `MXA-0055` (ISIS2-00253) Asset
Family: `character-costume-variant-pack` Phase: Phase 4 | Milestone: M3 Launch
(2026-07-27 to 2026-10-30)

## Objective

Define a canonical implementation contract for `character-costume-variant-pack`
so workflow design, contract exposure, operational rollout, and quality
certification execute with measurable, release-gated criteria.

## Scope

### In Scope

- Workflow family requirements spanning orthographic baseline, conditioned, and
  consistency-locked costume variants.
- Control, consistency, output package, and surface parity requirements.
- Success metrics and explicit failure criteria tied to Matrix A delivery
  tickets.

### Out of Scope

- Implementation details for non-character asset families.
- Provider-specific low-level node wiring beyond declared dependency/control
  contracts.

## Baseline Assessment

- Related baseline workflow count: 19
- Missing required controls in related baseline: none
- Current control-mode pass rate (global baseline): 0.00%
- Current required control quality average (selected controls): 0.293

### Existing Related Workflows

| Workflow ID              | Asset Family                         | Output Profile         | Controls                                                                                                                                                                                                                                                  |
| ------------------------ | ------------------------------------ | ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `consistent-character`   | `social-avatar-banner-identity-pack` | `image-single-profile` | seed-lock, sampler-scheduler-lock, model-lock, prompt-template-lock, controlnet-pose, ipadapter-face, identity-lock, style-lock, color-script-lock                                                                                                        |
| `cosmetic-layer`         | `social-avatar-banner-identity-pack` | `image-single-profile` | seed-lock, sampler-scheduler-lock, model-lock, prompt-template-lock, style-lock, identity-lock, ipadapter-face                                                                                                                                            |
| `face-swap`              | `social-avatar-banner-identity-pack` | `image-single-profile` | seed-lock, sampler-scheduler-lock, model-lock, prompt-template-lock, controlnet-segmentation, controlnet-inpaint, ipadapter-face, identity-lock, style-lock                                                                                               |
| `spiritual-teacher`      | `film-character-lookdev-sheet`       | `image-single-profile` | seed-lock, sampler-scheduler-lock, model-lock, prompt-template-lock, style-lock, identity-lock, ipadapter-face                                                                                                                                            |
| `fractal-art-fusion`     | `mkt-brand-style-lock-template-pack` | `image-single-profile` | seed-lock, sampler-scheduler-lock, model-lock, prompt-template-lock, style-lock, color-script-lock                                                                                                                                                        |
| `buddhist-thangka`       | `mkt-brand-style-lock-template-pack` | `image-single-profile` | seed-lock, sampler-scheduler-lock, model-lock, prompt-template-lock, style-lock, color-script-lock                                                                                                                                                        |
| `celtic-knotwork`        | `mkt-brand-style-lock-template-pack` | `image-single-profile` | seed-lock, sampler-scheduler-lock, model-lock, prompt-template-lock, style-lock, color-script-lock                                                                                                                                                        |
| `christian-icon`         | `mkt-brand-style-lock-template-pack` | `image-single-profile` | seed-lock, sampler-scheduler-lock, model-lock, prompt-template-lock, style-lock, color-script-lock                                                                                                                                                        |
| `consciousness-map`      | `mkt-brand-style-lock-template-pack` | `image-single-profile` | seed-lock, sampler-scheduler-lock, model-lock, prompt-template-lock, style-lock, color-script-lock                                                                                                                                                        |
| `egyptian-hieratic`      | `mkt-brand-style-lock-template-pack` | `image-single-profile` | seed-lock, sampler-scheduler-lock, model-lock, prompt-template-lock, style-lock, color-script-lock                                                                                                                                                        |
| `hindu-deity`            | `mkt-brand-style-lock-template-pack` | `image-single-profile` | seed-lock, sampler-scheduler-lock, model-lock, prompt-template-lock, style-lock, color-script-lock                                                                                                                                                        |
| `islamic-geometric`      | `mkt-brand-style-lock-template-pack` | `image-single-profile` | seed-lock, sampler-scheduler-lock, model-lock, prompt-template-lock, style-lock, color-script-lock                                                                                                                                                        |
| `mandala-generator`      | `mkt-brand-style-lock-template-pack` | `image-single-profile` | seed-lock, sampler-scheduler-lock, model-lock, prompt-template-lock, style-lock, color-script-lock                                                                                                                                                        |
| `mandala-personalized`   | `mkt-brand-style-lock-template-pack` | `image-single-profile` | seed-lock, sampler-scheduler-lock, model-lock, prompt-template-lock, style-lock, color-script-lock                                                                                                                                                        |
| `shamanic-vision`        | `mkt-brand-style-lock-template-pack` | `image-single-profile` | seed-lock, sampler-scheduler-lock, model-lock, prompt-template-lock, style-lock, color-script-lock                                                                                                                                                        |
| `visionary-art`          | `mkt-brand-style-lock-template-pack` | `image-single-profile` | seed-lock, sampler-scheduler-lock, model-lock, prompt-template-lock, style-lock, color-script-lock                                                                                                                                                        |
| `yantra-generator`       | `mkt-brand-style-lock-template-pack` | `image-single-profile` | seed-lock, sampler-scheduler-lock, model-lock, prompt-template-lock, style-lock, color-script-lock                                                                                                                                                        |
| `style-transfer`         | `mkt-brand-style-lock-template-pack` | `image-single-profile` | seed-lock, sampler-scheduler-lock, model-lock, prompt-template-lock, ipadapter-style, style-lock, color-script-lock                                                                                                                                       |
| `animatediff-controlnet` | `film-previs-blocking-reel`          | `video-master-profile` | seed-lock, sampler-scheduler-lock, model-lock, prompt-template-lock, controlnet-pose, controlnet-depth, controlnet-segmentation, camera-path-guide, motion-vector-lock, temporal-lock, keyframe-anchor-lock, style-lock, identity-lock, color-script-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        | 19 workflows      | 0.420            |
| `sampler-scheduler-lock`  | determinism        | 19 workflows      | 0.450            |
| `model-lock`              | determinism        | 19 workflows      | 0.420            |
| `prompt-template-lock`    | determinism        | 19 workflows      | 0.425            |
| `style-lock`              | style-and-identity | 19 workflows      | 0.450            |
| `identity-lock`           | style-and-identity | 5 workflows       | 0.113            |
| `color-script-lock`       | style-and-identity | 16 workflows      | 0.450            |
| `ipadapter-style`         | reference-guidance | 1 workflows       | 0.050            |
| `controlnet-pose`         | spatial-guidance   | 2 workflows       | 0.150            |
| `controlnet-depth`        | spatial-guidance   | 1 workflows       | 0.150            |
| `controlnet-segmentation` | spatial-guidance   | 2 workflows       | 0.150            |

### Functional Requirements

| ID      | Checklist  | Requirement                                                                                                                                                           |
| ------- | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `F-000` | `MXA-0055` | Publish a canonical, machine-readable requirements brief for `character-costume-variant-pack` that defines scope, constraints, success metrics, and failure criteria. |
| `F-001` | `MXA-0056` | Design baseline workflow graph for `character-costume-variant-pack` with deterministic defaults.                                                                      |
| `F-002` | `MXA-0057` | Design image-conditioned variant workflow for `character-costume-variant-pack`.                                                                                       |
| `F-003` | `MXA-0058` | Design control-conditioned variant workflow for `character-costume-variant-pack` (pose/depth/segmentation where applicable).                                          |
| `F-004` | `MXA-0059` | Design consistency-locked variant workflow for `character-costume-variant-pack` with continuity profile support.                                                      |
| `F-005` | `MXA-0060` | Define model/node dependency manifest for `character-costume-variant-pack` workflows.                                                                                 |
| `F-006` | `MXA-0061` | Define output package contract for `character-costume-variant-pack` including file naming and metadata manifest.                                                      |
| `F-007` | `MXA-0062` | Add workflow templates and presets for `character-costume-variant-pack` production tiers (draft/final/hero).                                                          |
| `F-008` | `MXA-0063` | Expose `character-costume-variant-pack` workflows via generation API with typed request contracts.                                                                    |
| `F-009` | `MXA-0064` | Expose `character-costume-variant-pack` workflows via SDK with end-to-end examples.                                                                                   |
| `F-010` | `MXA-0065` | Expose `character-costume-variant-pack` workflows in web UI with ergonomic form controls and validation.                                                              |
| `F-011` | `MXA-0066` | Implement side-by-side comparison tools for `character-costume-variant-pack` outputs.                                                                                 |
| `F-012` | `MXA-0067` | Map `character-costume-variant-pack` workflows to RunPod endpoint classes and sizing policies.                                                                        |
| `F-013` | `MXA-0068` | Add `character-costume-variant-pack` cost estimation and budget guardrails.                                                                                           |
| `F-014` | `MXA-0069` | Add `character-costume-variant-pack` quality evaluator and threshold-based acceptance gate.                                                                           |
| `F-015` | `MXA-0070` | Add `character-costume-variant-pack` regression tests and golden datasets.                                                                                            |
| `F-016` | `MXA-0071` | Add `character-costume-variant-pack` external integration recipe for downstream tools/systems.                                                                        |
| `F-017` | `MXA-0072` | Publish `character-costume-variant-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, identity-lock, color-script-lock, ipadapter-style, controlnet-pose, controlnet-depth, controlnet-segmentation. |
| `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 `character-costume-variant-pack`.                           | `MXA-0056`, `MXA-0057`, `MXA-0058`, `MXA-0059`, `MXA-0070`                                                                                                                                                 |
| `SM-002` | 17/17 downstream tickets DONE by milestone end date.                                                                             | 0/17 downstream tickets are DONE at report generation.                                      | `MXA-0056`, `MXA-0057`, `MXA-0058`, `MXA-0059`, `MXA-0060`, `MXA-0061`, `MXA-0062`, `MXA-0063`, `MXA-0064`, `MXA-0065`, `MXA-0066`, `MXA-0067`, `MXA-0068`, `MXA-0069`, `MXA-0070`, `MXA-0071`, `MXA-0072` |
| `SM-003` | 11/11 required controls implemented and exposed.                                                                                 | 11/11 controls currently evidenced in related baseline workflows.                           | `MXA-0058`, `MXA-0063`, `MXA-0064`, `MXA-0065`                                                                                                                                                             |
| `SM-004` | Average required-control quality score >= 0.75.                                                                                  | Current benchmark baseline: 0.293.                                                          | `MXA-0069`, `MXA-0070`                                                                                                                                                                                     |
| `SM-005` | face_embedding_cosine_similarity >= 0.82 and facial_landmark_drift_px <= 12.                                                     | Not yet measured for character-costume-variant-pack baseline (family not implemented).      | `MXA-0059`, `MXA-0069`, `MXA-0070`                                                                                                                                                                         |
| `SM-006` | garment_attribute_match_ratio >= 0.90 and wardrobe_palette_delta_e <= 7.5.                                                       | Not yet measured for character-costume-variant-pack baseline (family not implemented).      | `MXA-0059`, `MXA-0069`, `MXA-0070`                                                                                                                                                                         |
| `SM-007` | 100% of outputs include package classes required by `preview_image`, `source_frames`, and `metadata_manifest` mappings.          | No dedicated character-costume-variant-pack output package contract is currently published. | `MXA-0061`, `MXA-0070`                                                                                                                                                                                     |
| `SM-008` | Typed request/response support and user-facing controls available across generation API, SDK, and web UI with zero schema drift. | `character-costume-variant-pack` family not yet exposed on API/SDK/UI surfaces.             | `MXA-0063`, `MXA-0064`, `MXA-0065`                                                                                                                                                                         |

## 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`  | Identity or wardrobe continuity metrics fail taxonomy thresholds across approved golden datasets.                 | high     | Reject quality gate, retune workflows/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-00254` | `MXA-0056` | TODO   | Design baseline workflow graph for `character-costume-variant-pack` with deterministic defaults.                             |
| `ISIS2-00255` | `MXA-0057` | TODO   | Design image-conditioned variant workflow for `character-costume-variant-pack`.                                              |
| `ISIS2-00256` | `MXA-0058` | TODO   | Design control-conditioned variant workflow for `character-costume-variant-pack` (pose/depth/segmentation where applicable). |
| `ISIS2-00257` | `MXA-0059` | TODO   | Design consistency-locked variant workflow for `character-costume-variant-pack` with continuity profile support.             |
| `ISIS2-00258` | `MXA-0060` | TODO   | Define model/node dependency manifest for `character-costume-variant-pack` workflows.                                        |
| `ISIS2-00259` | `MXA-0061` | TODO   | Define output package contract for `character-costume-variant-pack` including file naming and metadata manifest.             |
| `ISIS2-00260` | `MXA-0062` | TODO   | Add workflow templates and presets for `character-costume-variant-pack` production tiers (draft/final/hero).                 |
| `ISIS2-00261` | `MXA-0063` | TODO   | Expose `character-costume-variant-pack` workflows via generation API with typed request contracts.                           |
| `ISIS2-00262` | `MXA-0064` | TODO   | Expose `character-costume-variant-pack` workflows via SDK with end-to-end examples.                                          |
| `ISIS2-00263` | `MXA-0065` | TODO   | Expose `character-costume-variant-pack` workflows in web UI with ergonomic form controls and validation.                     |
| `ISIS2-00264` | `MXA-0066` | TODO   | Implement side-by-side comparison tools for `character-costume-variant-pack` outputs.                                        |
| `ISIS2-00265` | `MXA-0067` | TODO   | Map `character-costume-variant-pack` workflows to RunPod endpoint classes and sizing policies.                               |
| `ISIS2-00266` | `MXA-0068` | TODO   | Add `character-costume-variant-pack` cost estimation and budget guardrails.                                                  |
| `ISIS2-00267` | `MXA-0069` | TODO   | Add `character-costume-variant-pack` quality evaluator and threshold-based acceptance gate.                                  |
| `ISIS2-00268` | `MXA-0070` | TODO   | Add `character-costume-variant-pack` regression tests and golden datasets.                                                   |
| `ISIS2-00269` | `MXA-0071` | TODO   | Add `character-costume-variant-pack` external integration recipe for downstream tools/systems.                               |
| `ISIS2-00270` | `MXA-0072` | TODO   | Publish `character-costume-variant-pack` operator and creator documentation with troubleshooting.                            |

## Traceability

- Checklist item: `MXA-0055`
- Ticket key: `ISIS2-00253`
- Source references:
  - `docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_ASSET_TAXONOMY.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_CONTROL_TAXONOMY.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_CONSISTENCY_TAXONOMY.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_OUTPUT_PACKAGE_TAXONOMY.json`
  - `libs/isis/workflows/src/metadata/workflow-taxonomy-registry.json`
  - `docs/domains/isis/remediation-v2/ISIS_V2_BENCHMARK_DASHBOARD.json`
  - `ISIS_TODOS_2.md`
