# ISIS v2 Canonical Asset Taxonomy

Date: 2026-02-23 Scope: WS01-001 canonical taxonomy spanning film, animation,
game-dev, marketing, and social outputs.

## Purpose

Define one canonical asset-family taxonomy for Isis so workflow expansion, API
contracts, RunPod specializations, and web UX parity can all target the same
production output classes.

## Source of Truth

- Machine-readable taxonomy:
  `docs/domains/isis/remediation-v2/ISIS_V2_ASSET_TAXONOMY.json`
- Validation script: `scripts/isis/validate-v2-asset-taxonomy.mjs`
- Renderer: `scripts/isis/render-v2-asset-taxonomy.mjs`

## Primary References

- Current Isis workflow catalog baseline. (libs/isis/workflows/src/workflows)
- Internal ComfyUI integration conventions.
  (docs/integrations/comfyui/workflows.md)
- Official ComfyUI tutorial domains (Image, Video, 3D, Audio, Utility,
  ControlNet). (https://docs.comfy.org/tutorials)
- Official ComfyUI example workflow corpus.
  (https://github.com/comfyanonymous/ComfyUI_examples)

## Canonical Domain Coverage

| Domain    | Asset Families |
| --------- | -------------: |
| film      |             10 |
| animation |             10 |
| game-dev  |             10 |
| marketing |             10 |
| social    |             10 |
| studio    |             15 |

## Output Classes

- `preview_image`
- `source_frames`
- `image_sequence`
- `video_master`
- `audio_master`
- `mesh_package`
- `texture_set`
- `sprite_sheet`
- `engine_bundle`
- `dcc_bundle`
- `metadata_manifest`
- `project_archive`

## Asset Families by Domain

### film

| Asset Family                                                     | Pipeline Stages              | Required Outputs                                                 | Modalities                               | Target Systems                           |
| ---------------------------------------------------------------- | ---------------------------- | ---------------------------------------------------------------- | ---------------------------------------- | ---------------------------------------- |
| `film-concept-art-suite` (Concept Art Suite)                     | ideation, preproduction      | preview_image, source_frames, metadata_manifest                  | image, metadata                          | photoshop, figma, shotgrid               |
| `film-storyboard-shot-sequence` (Storyboard Shot Sequence)       | preproduction                | preview_image, source_frames, metadata_manifest, project_archive | image, metadata, archive                 | storyboard-pro, shotgrid, premiere       |
| `film-previs-blocking-reel` (Previs Blocking Reel)               | preproduction, production    | video_master, image_sequence, metadata_manifest                  | video, image_sequence, metadata          | unreal-engine, blender, premiere         |
| `film-matte-painting-pack` (Matte Painting Pack)                 | production, postproduction   | preview_image, source_frames, image_sequence, metadata_manifest  | image, image_sequence, metadata          | nuke, after-effects, davinci-resolve     |
| `film-character-lookdev-sheet` (Character Lookdev Sheet)         | preproduction, production    | preview_image, source_frames, metadata_manifest                  | image, metadata                          | photoshop, maya, shotgrid                |
| `film-environment-lookdev-board` (Environment Lookdev Board)     | preproduction, production    | preview_image, source_frames, metadata_manifest                  | image, metadata                          | photoshop, unreal-engine, shotgrid       |
| `film-prop-lookdev-turntable` (Prop Lookdev Turntable)           | preproduction, production    | preview_image, video_master, mesh_package, metadata_manifest     | image, video, 3d, metadata               | blender, maya, substance-3d              |
| `film-vfx-element-library` (VFX Element Library)                 | production, postproduction   | image_sequence, video_master, metadata_manifest, project_archive | image_sequence, video, metadata, archive | nuke, after-effects, houdini             |
| `film-title-motion-graphics-kit` (Title and Motion Graphics Kit) | postproduction, distribution | video_master, source_frames, metadata_manifest, project_archive  | video, image, metadata, archive          | after-effects, premiere, davinci-resolve |
| `film-trailer-teaser-cut-kit` (Trailer and Teaser Cut Kit)       | postproduction, distribution | video_master, preview_image, audio_master, metadata_manifest     | video, image, audio, metadata            | premiere, media-encoder, youtube         |

### animation

| Asset Family                                                                | Pipeline Stages            | Required Outputs                                                 | Modalities                      | Target Systems                            |
| --------------------------------------------------------------------------- | -------------------------- | ---------------------------------------------------------------- | ------------------------------- | ----------------------------------------- |
| `anim-character-turnaround-pack` (Character Turnaround and Expression Pack) | ideation, preproduction    | preview_image, source_frames, metadata_manifest                  | image, metadata                 | toon-boom, photoshop, krita               |
| `anim-rig-reference-sheet` (Rig Reference Sheet)                            | preproduction, production  | preview_image, mesh_package, metadata_manifest                   | image, 3d, metadata             | maya, blender, houdini                    |
| `anim-layout-staging-board` (Layout and Staging Board)                      | preproduction              | preview_image, source_frames, metadata_manifest                  | image, metadata                 | storyboard-pro, shotgrid, blender         |
| `anim-animatic-shot-reel` (Animatic Shot Reel)                              | preproduction, production  | video_master, audio_master, metadata_manifest                    | video, audio, metadata          | premiere, davinci-resolve, shotgrid       |
| `anim-keyframe-sequence-pack` (Keyframe Sequence Pack)                      | production                 | image_sequence, source_frames, metadata_manifest                 | image_sequence, image, metadata | tvpaint, toon-boom, krita                 |
| `anim-inbetween-assist-pack` (Inbetween Assist Pack)                        | production                 | image_sequence, metadata_manifest                                | image_sequence, metadata        | toon-boom, open-toonz, tvpaint            |
| `anim-effects-pass-library` (Effects Animation Pass Library)                | production, postproduction | image_sequence, video_master, metadata_manifest                  | image_sequence, video, metadata | after-effects, houdini, nuke              |
| `anim-background-painting-pack` (Background Painting Pack)                  | preproduction, production  | preview_image, source_frames, metadata_manifest, project_archive | image, metadata, archive        | photoshop, krita, blender                 |
| `anim-lipsync-viseme-sheet` (Lipsync Viseme Sheet)                          | production, postproduction | source_frames, audio_master, metadata_manifest                   | image, audio, metadata          | toon-boom, adobe-character-animator, maya |
| `anim-style-bible-asset-pack` (Style Bible Asset Pack)                      | ideation, preproduction    | preview_image, source_frames, metadata_manifest, project_archive | image, metadata, archive        | confluence, shotgrid, figma               |

### game-dev

| Asset Family                                                       | Pipeline Stages            | Required Outputs                                                           | Modalities                             | Target Systems                           |
| ------------------------------------------------------------------ | -------------------------- | -------------------------------------------------------------------------- | -------------------------------------- | ---------------------------------------- |
| `game-character-game-ready-bundle` (Character Game-Ready Bundle)   | ideation, production       | preview_image, mesh_package, texture_set, engine_bundle, metadata_manifest | image, 3d, metadata                    | unreal-engine, unity, maya               |
| `game-npc-variant-pack` (NPC Variant Pack)                         | production                 | preview_image, mesh_package, texture_set, metadata_manifest                | image, 3d, metadata                    | unreal-engine, unity, substance-3d       |
| `game-hero-prop-weapon-bundle` (Hero Prop and Weapon Bundle)       | ideation, production       | preview_image, mesh_package, texture_set, metadata_manifest                | image, 3d, metadata                    | blender, maya, unreal-engine             |
| `game-environment-modular-kit` (Environment Modular Kit)           | ideation, production       | preview_image, mesh_package, texture_set, engine_bundle, metadata_manifest | image, 3d, metadata                    | unreal-engine, unity, blender            |
| `game-pbr-texture-material-set` (PBR Texture and Material Set)     | production                 | texture_set, metadata_manifest, project_archive                            | image, metadata, archive               | substance-3d, unreal-engine, unity       |
| `game-decal-signage-pack` (Decal and Signage Pack)                 | production                 | texture_set, preview_image, metadata_manifest                              | image, metadata                        | unreal-engine, unity, substance-3d       |
| `game-vfx-sprite-flipbook-pack` (VFX Sprite and Flipbook Pack)     | production                 | sprite_sheet, image_sequence, engine_bundle, metadata_manifest             | image, image_sequence, metadata        | unreal-engine, unity, niagara            |
| `game-ui-icon-hud-pack` (UI Icon and HUD Pack)                     | ideation, production       | preview_image, source_frames, engine_bundle, metadata_manifest             | image, metadata                        | figma, unreal-engine, unity              |
| `game-skybox-hdri-pack` (Skybox and HDRI Pack)                     | production                 | texture_set, preview_image, engine_bundle, metadata_manifest               | image, metadata                        | unreal-engine, unity, blender            |
| `game-cinematic-cutscene-shot-pack` (Cinematic Cutscene Shot Pack) | production, postproduction | video_master, image_sequence, audio_master, metadata_manifest              | video, image_sequence, audio, metadata | unreal-engine, premiere, davinci-resolve |

### marketing

| Asset Family                                                             | Pipeline Stages          | Required Outputs                                                 | Modalities                      | Target Systems                         |
| ------------------------------------------------------------------------ | ------------------------ | ---------------------------------------------------------------- | ------------------------------- | -------------------------------------- |
| `mkt-campaign-key-visual-suite` (Campaign Key Visual Suite)              | ideation, distribution   | preview_image, source_frames, metadata_manifest, project_archive | image, metadata, archive        | figma, photoshop, ad-manager           |
| `mkt-product-packshot-suite` (Product Packshot Suite)                    | production, distribution | preview_image, source_frames, metadata_manifest                  | image, metadata                 | shopify, amazon-a-plus, adobe-commerce |
| `mkt-ad-variant-matrix` (Ad Creative Variant Matrix)                     | production, distribution | preview_image, video_master, metadata_manifest                   | image, video, metadata          | meta-ads, google-ads, tiktok-ads       |
| `mkt-print-ooh-asset-pack` (Print and OOH Asset Pack)                    | production, distribution | source_frames, metadata_manifest, project_archive                | image, metadata, archive        | indesign, print-vendors, brand-portal  |
| `mkt-email-web-hero-kit` (Email and Web Hero Kit)                        | production, distribution | preview_image, source_frames, metadata_manifest                  | image, metadata                 | hubspot, mailchimp, webflow            |
| `mkt-brand-style-lock-template-pack` (Brand Style-Lock Template Pack)    | ideation, production     | preview_image, source_frames, metadata_manifest, project_archive | image, metadata, archive        | figma, canva-enterprise, adobe-cc      |
| `mkt-localization-variant-pack` (Localization Variant Pack)              | production, distribution | source_frames, preview_image, metadata_manifest, project_archive | image, metadata, archive        | smartling, lokalise, contentful        |
| `mkt-event-launch-countdown-kit` (Event Launch Countdown Kit)            | production, distribution | video_master, preview_image, metadata_manifest                   | video, image, metadata          | instagram, youtube, x                  |
| `mkt-explainer-motion-graphic-pack` (Explainer Motion Graphic Pack)      | production, distribution | video_master, audio_master, source_frames, metadata_manifest     | video, audio, image, metadata   | after-effects, premiere, youtube       |
| `mkt-influencer-collab-asset-pack` (Influencer Collaboration Asset Pack) | production, distribution | preview_image, video_master, metadata_manifest, project_archive  | image, video, metadata, archive | creator-platforms, dropbox, notion     |

### social

| Asset Family                                                               | Pipeline Stages          | Required Outputs                                                 | Modalities                      | Target Systems                    |
| -------------------------------------------------------------------------- | ------------------------ | ---------------------------------------------------------------- | ------------------------------- | --------------------------------- |
| `social-shortform-vertical-video-pack` (Short-Form Vertical Video Pack)    | production, distribution | video_master, audio_master, metadata_manifest                    | video, audio, metadata          | tiktok, instagram, youtube-shorts |
| `social-thumbnail-cover-pack` (Thumbnail and Cover Pack)                   | production, distribution | preview_image, source_frames, metadata_manifest                  | image, metadata                 | youtube, spotify, twitch          |
| `social-avatar-banner-identity-pack` (Avatar and Banner Identity Pack)     | ideation, distribution   | preview_image, source_frames, metadata_manifest, project_archive | image, metadata, archive        | x, discord, youtube               |
| `social-sticker-emote-pack` (Sticker and Emote Pack)                       | production, distribution | source_frames, metadata_manifest, project_archive                | image, metadata, archive        | discord, telegram, twitch         |
| `social-carousel-story-slide-pack` (Carousel and Story Slide Pack)         | production, distribution | source_frames, preview_image, metadata_manifest                  | image, metadata                 | instagram, linkedin, facebook     |
| `social-meme-remix-template-pack` (Meme and Remix Template Pack)           | ideation, distribution   | preview_image, source_frames, metadata_manifest                  | image, metadata                 | instagram, x, tiktok              |
| `social-livestream-overlay-scene-pack` (Livestream Overlay and Scene Pack) | production, distribution | video_master, source_frames, audio_master, metadata_manifest     | video, image, audio, metadata   | obs, streamlabs, twitch           |
| `social-ugc-recreation-template-pack` (UGC Recreation Template Pack)       | production, distribution | video_master, preview_image, metadata_manifest, project_archive  | video, image, metadata, archive | tiktok, instagram, creator-tools  |
| `social-community-challenge-prompt-pack` (Community Challenge Prompt Pack) | ideation, distribution   | preview_image, source_frames, metadata_manifest, project_archive | image, metadata, archive        | discord, reddit, community-hub    |
| `social-audio-hook-loop-pack` (Audio Hook and Loop Pack)                   | production, distribution | audio_master, metadata_manifest, project_archive                 | audio, metadata, archive        | capcut, premiere, tiktok          |

### studio

| Asset Family                                                        | Pipeline Stages              | Required Outputs                                | Modalities             | Target Systems        |
| ------------------------------------------------------------------- | ---------------------------- | ----------------------------------------------- | ---------------------- | --------------------- |
| `structure-controlled-still` (Structure-Controlled Still)           | ideation, production         | preview_image, metadata_manifest                | image, metadata        | oshun-studio, comfyui |
| `region-edited-still` (Region-Edited Still)                         | postproduction               | preview_image, metadata_manifest                | image, metadata        | oshun-studio, comfyui |
| `canvas-extended-still` (Canvas-Extended Still)                     | postproduction               | preview_image, metadata_manifest                | image, metadata        | oshun-studio, comfyui |
| `multi-region-composed-still` (Multi-Region Composed Still)         | ideation, production         | preview_image, metadata_manifest                | image, metadata        | oshun-studio, comfyui |
| `style-locked-variation-set` (Style-Locked Variation Set)           | ideation, production         | preview_image, source_frames, metadata_manifest | image, metadata        | oshun-studio, comfyui |
| `portrait-hero-image-bundle` (Portrait / Hero Image Bundle)         | production                   | preview_image, metadata_manifest                | image, metadata        | oshun-studio, comfyui |
| `contemplative-sacred-art-bundle` (Contemplative Sacred Art Bundle) | production                   | preview_image, metadata_manifest                | image, metadata        | oshun-studio, comfyui |
| `joint-av-scene` (Joint Audio-Video Scene)                          | production                   | video_master, audio_master, metadata_manifest   | video, audio, metadata | oshun-studio, comfyui |
| `keyframe-anchored-motion` (Keyframe-Anchored Motion Clip)          | production, postproduction   | video_master, metadata_manifest                 | video, metadata        | oshun-studio, comfyui |
| `long-form-segment` (Long-Form Video Segment)                       | production                   | video_master, metadata_manifest                 | video, metadata        | oshun-studio, comfyui |
| `contemplative-video-bundle` (Contemplative Video Bundle)           | production                   | video_master, metadata_manifest                 | video, metadata        | oshun-studio, comfyui |
| `joined-video-transition` (Joined Video Transition)                 | postproduction               | video_master, metadata_manifest                 | video, metadata        | oshun-studio, comfyui |
| `region-edited-video` (Region-Edited Video)                         | postproduction               | video_master, metadata_manifest                 | video, metadata        | oshun-studio, comfyui |
| `restored-video-master` (Restored Video Master)                     | postproduction, distribution | video_master, metadata_manifest                 | video, metadata        | oshun-studio, comfyui |
| `song-ledger-section` (Song Ledger Section)                         | production                   | audio_master, metadata_manifest                 | audio, metadata        | oshun-studio, comfyui |

## Governance Rules

1. New workflows must map to exactly one canonical asset family.
2. No asset family can be removed without a migration note and replacement
   mapping.
3. Required output classes are mandatory for certification (WS15+ gates).
4. Taxonomy modifications require cross-functional sign-off (platform + creative
   tech + product).

## Traceability

- Checklist item: `WS01-001`
- Epic: `docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_EPIC.md`
