Eve library

ISIS v2 Architecture Kitbash Pack Consistency-Locked Workflow Graph

Guide

Revision 1

On this page

Generated: 2026-02-28T14:39:17.873Z Checklist: MXA-0185 (ISIS2-00383) Asset Family: architecture-kitbash-pack Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to 2026-10-30)

Objective#

Define a consistency-locked architecture-kitbash-pack workflow graph that enforces scene continuity profile state across environment, lighting, lens, and color-script dimensions while retaining deterministic generation defaults.

Continuity Profile#

Profile ID Minimum Passing Dimensions Locked Dimensions
scene-continuity-profile 4 environment, lighting, lens, color-script, motion

Deterministic Defaults#

Setting Value
checkpointModel sd_xl_base_1.0.safetensors
sceneAnchorAdapterModel ip-adapter-plus_sdxl_vit-h.safetensors
styleAdapterModel ip-adapter_sdxl.safetensors
segmentationControlModel control_v11p_sd15_seg.safetensors
depthControlModel control_v11f1p_sd15_depth.safetensors
seed 2026110405
width 2048
height 2048
steps 36
cfgScale 6.3
samplerName dpmpp_2m_sde
scheduler karras
denoise 1
sceneAnchorLockStrength 0.84
layoutLockStrength 0.74
lightingLockStrength 0.72
lensLockStrength 0.7
styleLockStrength 0.78
continuityProfileId scene-continuity-profile
continuityProfileRevision 1
consistencyWindowSize 4
focalLengthMm 35
outputFormat png
outputChannels 4

Input Contract#

Input Type Required Default
continuity_profile_id string yes scene-continuity-profile
continuity_profile_revision integer yes 1
continuity_locked_dimensions string[] yes environment,lighting,lens,color-script,motion
scene_profile_id string yes architecture-scene-profile
style_profile_id string yes architecture-style-profile
scene_anchor_reference_image image yes n/a
layout_reference_map image no n/a
lighting_reference_frame image no n/a
lens_reference_frame image no n/a
use_scene_anchor_reference boolean yes true
use_layout_reference boolean yes true
use_lighting_reference boolean yes true
use_lens_reference boolean yes false
use_style_lock boolean yes true
kitbash_theme enum yes fortified-citadel
architectural_epoch enum yes medieval
region_context enum yes mountainous
structure_scale enum yes city-block
module_family enum yes foundation-wall-roof
assembly_grid_profile enum yes 2m-grid
facade_material_profile enum yes weathered-stone
atlas_layout enum yes 4x4-2048
texel_density_class enum yes gameplay-standard
material_response_profile enum yes pbr-neutral
focal_length_mm integer yes 35
lighting_reference enum yes neutral-overcast
color_palette_profile string yes weathered sandstone, oxidized copper accents, muted moss greens, low-saturation neutrals
style_preset enum yes stylized
negative_prompt string no layout drift, seam continuity drift, lens distortion mismatch, perspective warping, blurry, low resolution, non-tileable motifs, edge mismatch, text, watermark, jpeg artifacts
seed integer yes 2026110405
width integer yes 2048
height integer yes 2048
steps integer yes 36
cfg_scale float yes 6.3
scene_anchor_lock_strength float yes 0.84
layout_lock_strength float yes 0.74
lighting_lock_strength float yes 0.72
lens_lock_strength float yes 0.7
style_lock_strength float yes 0.78

Graph Nodes#

Node ID Class Role Output Count
n1 LoadImage scene-anchor-reference-load 2
n2 LoadImage layout-reference-load 2
n3 LoadImage lighting-reference-load 2
n4 LoadImage lens-reference-load 2
n5 ConsistencyProfileLoader continuity-profile-load 1
n6 CheckpointLoaderSimple model-load 3
n7 IPAdapterLoader scene-anchor-adapter-load 1
n8 IPAdapterLoader style-adapter-load 1
n9 IPAdapterApply scene-anchor-lock-apply 1
n10 IPAdapterApply style-lock-apply 1
n11 ControlNetLoader layout-control-load 1
n12 ControlNetLoader lighting-control-load 1
n13 CLIPTextEncode positive-conditioning 1
n14 CLIPTextEncode negative-conditioning 1
n15 ControlNetApply layout-lock-apply 1
n16 ControlNetApply lighting-lock-apply 1
n17 ProfileLockMerge lens-lock-merge 1
n18 ProfileLockMerge continuity-lock-merge 1
n19 EmptyLatentImage latent-init 1
n20 KSampler latent-sample 1
n21 VAEDecode image-decode 1
n22 MetadataManifestBuilder metadata-build 1
n23 SaveImage artifact-output 0
n24 SaveJSON manifest-output 0

Graph Edges#

Edge ID From To
e1 n6:0 n9.model
e2 n7:0 n9.ipadapter
e3 n1:0 n9.image
e4 n9:0 n10.model
e5 n8:0 n10.ipadapter
e6 n6:1 n13.clip
e7 n6:1 n14.clip
e8 n13:0 n15.conditioning
e9 n11:0 n15.control_net
e10 n2:0 n15.image
e11 n15:0 n16.conditioning
e12 n12:0 n16.control_net
e13 n3:0 n16.image
e14 n16:0 n17.conditioning
e15 n5:0 n17.profile
e16 n4:0 n17.lens_reference
e17 n17:0 n18.conditioning
e18 n5:0 n18.profile
e19 n10:0 n20.model
e20 n18:0 n20.positive
e21 n14:0 n20.negative
e22 n19:0 n20.latent_image
e23 n20:0 n21.samples
e24 n6:2 n21.vae
e25 n21:0 n23.images
e26 n5:0 n22.continuity_profile
e27 n20:0 n22.sampling_trace
e28 n22:0 n24.payload

Topological Node Order#

n1 -> n11 -> n12 -> n19 -> n2 -> n3 -> n4 -> n5 -> n6 -> n13 -> n14 -> n15 -> n16 -> n17 -> n18 -> n7 -> n8 -> n9 -> n10 -> n20 -> n21 -> n22 -> n23 -> n24

Continuity Metric Thresholds#

Dimension Metric Operator Threshold
environment scene_layout_iou >= 0.76
environment depth_structure_mse <= 0.09
lighting key_light_angle_delta_deg <= 10
lighting cct_delta_kelvin <= 450
lens focal_length_delta_mm <= 2
lens distortion_profile_delta <= 0.03
color-script palette_emd <= 0.12
color-script mean_luma_delta_pct <= 6
motion optical_flow_drift_score <= 0.18
motion temporal_flicker_index <= 0.12

Research Alignment#

Workflow Path IPAdapter Nodes ControlNet Nodes
HDRI Environment Map Generator libs/isis/workflows/src/workflows/texture/environment-map.json 0 0
3D Mandala Generator libs/isis/workflows/src/workflows/sacred-art/mandala-3d.json 0 0
3D Texture Generator libs/isis/workflows/src/workflows/texture/3d-texture.json 0 0

Acceptance Criteria#

  • Graph is acyclic and topologically sortable.
  • Continuity profile support is explicit through profile loader and profile-lock merge nodes.
  • Scene anchor, layout, lighting, and lens continuity paths are represented with deterministic lock strengths and optional fallbacks.
  • Output contract aligns to MXA-0181 required preview/source/metadata classes and includes continuity manifest output.

Traceability#

  • Checklist item: MXA-0185
  • Ticket key: ISIS2-00383
  • Source references:
    • docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json
    • docs/domains/isis/remediation-v2/ISIS_V2_ARCHITECTURE_KITBASH_PACK_REQUIREMENTS_BRIEF.json
    • docs/domains/isis/remediation-v2/ISIS_V2_ARCHITECTURE_KITBASH_PACK_BASELINE_WORKFLOW_GRAPH.json
    • docs/domains/isis/remediation-v2/ISIS_V2_ARCHITECTURE_KITBASH_PACK_IMAGE_CONDITIONED_WORKFLOW_GRAPH.json
    • docs/domains/isis/remediation-v2/ISIS_V2_ARCHITECTURE_KITBASH_PACK_CONTROL_CONDITIONED_WORKFLOW_GRAPH.json
    • docs/domains/isis/remediation-v2/ISIS_V2_CONSISTENCY_TAXONOMY.json
    • libs/isis/workflows/src/workflows/texture/environment-map.json
    • libs/isis/workflows/src/workflows/sacred-art/mandala-3d.json
    • libs/isis/workflows/src/workflows/texture/3d-texture.json
    • libs/isis/workflows/src/consistency/orchestration.ts
    • docs/domains/isis/remediation-v2/ISIS_V2_CONTROL_TAXONOMY.json
    • ISIS_TODOS_2.md