Eve library

ISIS v2 Character Costume Variant Pack Canonical Requirements Brief

Guide

Revision 1

On this page

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
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