# liyue-aigc/xianxia-visual-director architecture

> Architecture diagram of the GitHub repository liyue-aigc/xianxia-visual-director, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/liyue-aigc/xianxia-visual-director
- Repository: https://github.com/liyue-aigc/xianxia-visual-director

## Overview

This repository is an Agent Skill for turning a scene idea, existing prompt, or visual reference into a structured cinematic xianxia image-prompt package. The documented workflow locks parameters, selects scene and style routes, applies shared visual rules, and produces a director’s plan, prompt, negative constraints, and variations. The README documents the capabilities and route relationships; no source excerpts were provided, so internal call-level relationships cannot be verified.

Main entry points: [`xianxia-visual-director/SKILL.md`](https://github.com/liyue-aigc/xianxia-visual-director/blob/main/xianxia-visual-director/SKILL.md) (Director skill), [`xianxia-visual-director/references/xianxia-master-rules.md`](https://github.com/liyue-aigc/xianxia-visual-director/blob/main/xianxia-visual-director/references/xianxia-master-rules.md) (Shared rules), [`xianxia-visual-director/references/celestial-realm-route.md`](https://github.com/liyue-aigc/xianxia-visual-director/blob/main/xianxia-visual-director/references/celestial-realm-route.md) (Scene routes), [`xianxia-visual-director/references/eastern-sky-megastructure-style.md`](https://github.com/liyue-aigc/xianxia-visual-director/blob/main/xianxia-visual-director/references/eastern-sky-megastructure-style.md) (Style routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Prompt workflow"]
  node_skill["Director skill<br/>[SKILL.md]"]
  node_parameters["Parameter lock<br/>[SKILL.md]"]
  node_director_plan["Director plan<br/>[SKILL.md]"]
  node_prompt["Image prompt<br/>[SKILL.md]"]
  node_constraints["Negative constraints<br/>[SKILL.md]"]
  node_variations["Derived directions<br/>[SKILL.md]"]
end

subgraph group_routing["Visual routing"]
  node_scene_routes["Scene routes"]
  node_style_routes["Style routes"]
  node_grand_realm["Grand-realm canon"]
end

subgraph group_direction["Visual direction"]
  node_master_rules["Shared rules"]
  node_composition["Composition and light"]
  node_visual_dna["Visual identity<br/>[visual-dna.md]"]
  node_aspect_ratios["Aspect ratios<br/>[aspect-ratios.md]"]
end

subgraph group_reference["Reference guidance"]
  node_examples["Prompt examples<br/>[prompt-examples.md]"]
end

node_creator(("User"))
node_video_director["Video director skill"]

node_creator -->|"provides concept"| node_skill
node_skill -->|"locks parameters"| node_parameters
node_skill -->|"selects scene"| node_scene_routes
node_skill -->|"selects style"| node_style_routes
node_scene_routes -->|"inherits rules"| node_master_rules
node_style_routes -->|"inherits rules"| node_master_rules
node_grand_realm -->|"inherits rules"| node_master_rules
node_skill -->|"produces"| node_director_plan
node_skill -->|"produces"| node_prompt
node_skill -->|"produces"| node_constraints
node_skill -->|"produces"| node_variations
node_skill -.->|"pairs with"| node_video_director

click node_skill "https://github.com/liyue-aigc/xianxia-visual-director/blob/main/xianxia-visual-director/SKILL.md"
click node_parameters "https://github.com/liyue-aigc/xianxia-visual-director/blob/main/xianxia-visual-director/SKILL.md"
click node_director_plan "https://github.com/liyue-aigc/xianxia-visual-director/blob/main/xianxia-visual-director/SKILL.md"
click node_prompt "https://github.com/liyue-aigc/xianxia-visual-director/blob/main/xianxia-visual-director/SKILL.md"
click node_constraints "https://github.com/liyue-aigc/xianxia-visual-director/blob/main/xianxia-visual-director/SKILL.md"
click node_variations "https://github.com/liyue-aigc/xianxia-visual-director/blob/main/xianxia-visual-director/SKILL.md"
click node_scene_routes "https://github.com/liyue-aigc/xianxia-visual-director/blob/main/xianxia-visual-director/references/celestial-realm-route.md"
click node_style_routes "https://github.com/liyue-aigc/xianxia-visual-director/blob/main/xianxia-visual-director/references/eastern-sky-megastructure-style.md"
click node_grand_realm "https://github.com/liyue-aigc/xianxia-visual-director/blob/main/xianxia-visual-director/references/celestial-grand-realm-canon.md"
click node_master_rules "https://github.com/liyue-aigc/xianxia-visual-director/blob/main/xianxia-visual-director/references/xianxia-master-rules.md"
click node_composition "https://github.com/liyue-aigc/xianxia-visual-director/blob/main/xianxia-visual-director/references/composition-color-light.md"
click node_visual_dna "https://github.com/liyue-aigc/xianxia-visual-director/blob/main/xianxia-visual-director/references/visual-dna.md"
click node_aspect_ratios "https://github.com/liyue-aigc/xianxia-visual-director/blob/main/xianxia-visual-director/references/aspect-ratios.md"
click node_examples "https://github.com/liyue-aigc/xianxia-visual-director/blob/main/xianxia-visual-director/references/prompt-examples.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_skill,node_parameters,node_director_plan,node_prompt,node_constraints,node_variations,node_creator toneBlue
class node_scene_routes,node_style_routes,node_grand_realm toneAmber
class node_master_rules,node_composition,node_visual_dna,node_aspect_ratios toneMint
class node_examples toneRose
class node_video_director toneIndigo
```

## Components

### Prompt workflow

- [Director skill](https://github.com/liyue-aigc/xianxia-visual-director/blob/main/xianxia-visual-director/SKILL.md): `xianxia-visual-director/SKILL.md`
- [Parameter lock](https://github.com/liyue-aigc/xianxia-visual-director/blob/main/xianxia-visual-director/SKILL.md): `xianxia-visual-director/SKILL.md`
- [Director plan](https://github.com/liyue-aigc/xianxia-visual-director/blob/main/xianxia-visual-director/SKILL.md): `xianxia-visual-director/SKILL.md`
- [Image prompt](https://github.com/liyue-aigc/xianxia-visual-director/blob/main/xianxia-visual-director/SKILL.md): `xianxia-visual-director/SKILL.md`
- [Negative constraints](https://github.com/liyue-aigc/xianxia-visual-director/blob/main/xianxia-visual-director/SKILL.md): `xianxia-visual-director/SKILL.md`
- [Derived directions](https://github.com/liyue-aigc/xianxia-visual-director/blob/main/xianxia-visual-director/SKILL.md): `xianxia-visual-director/SKILL.md`

### Visual routing

- [Scene routes](https://github.com/liyue-aigc/xianxia-visual-director/blob/main/xianxia-visual-director/references/celestial-realm-route.md): `xianxia-visual-director/references/celestial-realm-route.md`
- [Style routes](https://github.com/liyue-aigc/xianxia-visual-director/blob/main/xianxia-visual-director/references/eastern-sky-megastructure-style.md): `xianxia-visual-director/references/eastern-sky-megastructure-style.md`
- [Grand-realm canon](https://github.com/liyue-aigc/xianxia-visual-director/blob/main/xianxia-visual-director/references/celestial-grand-realm-canon.md): `xianxia-visual-director/references/celestial-grand-realm-canon.md`

### Visual direction

- [Shared rules](https://github.com/liyue-aigc/xianxia-visual-director/blob/main/xianxia-visual-director/references/xianxia-master-rules.md): `xianxia-visual-director/references/xianxia-master-rules.md`
- [Composition and light](https://github.com/liyue-aigc/xianxia-visual-director/blob/main/xianxia-visual-director/references/composition-color-light.md): `xianxia-visual-director/references/composition-color-light.md`
- [Visual identity](https://github.com/liyue-aigc/xianxia-visual-director/blob/main/xianxia-visual-director/references/visual-dna.md): `xianxia-visual-director/references/visual-dna.md`
- [Aspect ratios](https://github.com/liyue-aigc/xianxia-visual-director/blob/main/xianxia-visual-director/references/aspect-ratios.md): `xianxia-visual-director/references/aspect-ratios.md`

### Reference guidance

- [Prompt examples](https://github.com/liyue-aigc/xianxia-visual-director/blob/main/xianxia-visual-director/references/prompt-examples.md): `xianxia-visual-director/references/prompt-examples.md`

### Other components

- **User**
- **Video director skill**

## Connections

- User → Director skill: provides concept (evidence: `README.md`)
- Director skill → Parameter lock: locks parameters (evidence: `README.md`)
- Director skill → Scene routes: selects scene (evidence: `README.md`)
- Director skill → Style routes: selects style (evidence: `README.md`)
- Scene routes → Shared rules: inherits rules (evidence: `README.md`)
- Style routes → Shared rules: inherits rules (evidence: `README.md`)
- Grand-realm canon → Shared rules: inherits rules (evidence: `README.md`)
- Director skill → Director plan: produces (evidence: `README.md`)
- Director skill → Image prompt: produces (evidence: `README.md`)
- Director skill → Negative constraints: produces (evidence: `README.md`)
- Director skill → Derived directions: produces (evidence: `README.md`)
- Director skill → Video director skill: pairs with (evidence: `README.md`)