# jdhruv14/line-art-animation architecture

> Architecture diagram of the GitHub repository jdhruv14/line-art-animation, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jdhruv14/line-art-animation
- Repository: https://github.com/jdhruv14/line-art-animation

## Overview

line-art-animation combines a Claude skill for creating and checking animated line-art scenes with a dependency-free TypeScript SVG animation library and two runnable examples. The main workflow starts with a creation or reference-matching request, uses the skill’s style and motion guidance to build a scene from the library, then checks motion and can capture video. The village demonstrates time-of-day changes and interactive scene elements; the walker demonstrates a single reactive figure. Library behavior is supported by sampled source; example and skill relationships are documented in the README, so unsampled internals are represented at directory level.

Main entry points: [`SKILL.md`](https://github.com/jdhruv14/line-art-animation/blob/main/SKILL.md) (Scene Workflow), [`examples/village`](https://github.com/jdhruv14/line-art-animation/tree/main/examples/village) (Interactive Village), [`lib/ink.ts`](https://github.com/jdhruv14/line-art-animation/blob/main/lib/ink.ts) (SVG Drawing), [`lib/gait.ts`](https://github.com/jdhruv14/line-art-animation/blob/main/lib/gait.ts) (Gait Solver)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_skill["Creation Skill"]
  node_skill_workflow["Scene Workflow<br/>[SKILL.md]"]
  node_style_guide["Style Rules<br/>[style.md]"]
  node_motion_guide["Motion Guide<br/>[motion.md]"]
  node_scene_guide["Scene Guide<br/>[scenes.md]"]
  node_matching_guide["Clip Matching<br/>[matching.md]"]
  node_verification_guide["Motion Checks<br/>[verify.md]"]
  node_video_guide["Video Guide<br/>[video.md]"]
end

subgraph group_library["Animation Library"]
  node_ink["SVG Drawing<br/>[ink.ts]"]
  node_gait["Gait Solver<br/>[gait.ts]"]
  node_motion["Motion Physics<br/>[motion.ts]"]
  node_daynight["Day-Night Palette<br/>[daynight.ts]"]
end

subgraph group_examples["Runnable Examples"]
  node_walker["Reactive Walker<br/>[walker.ts]"]
  node_village["Interactive Village"]
end

node_creator(("Creator"))

node_creator -->|"requests scene"| node_skill_workflow
node_skill_workflow -->|"uses rules"| node_style_guide
node_skill_workflow -->|"uses guidance"| node_motion_guide
node_skill_workflow -->|"uses guidance"| node_scene_guide
node_skill_workflow -->|"matches references"| node_matching_guide
node_skill_workflow -->|"checks motion"| node_verification_guide
node_skill_workflow -->|"renders video"| node_video_guide
node_skill_workflow -->|"copies library"| node_ink
node_gait -->|"uses types"| node_ink
node_walker -->|"draws with"| node_ink
node_walker -->|"animates with"| node_gait
node_village -->|"draws with"| node_ink
node_village -->|"animates figures"| node_gait
node_village -->|"supports interactions"| node_motion
node_village -->|"changes palette"| node_daynight

click node_skill_workflow "https://github.com/jdhruv14/line-art-animation/blob/main/SKILL.md"
click node_style_guide "https://github.com/jdhruv14/line-art-animation/blob/main/references/style.md"
click node_motion_guide "https://github.com/jdhruv14/line-art-animation/blob/main/references/motion.md"
click node_scene_guide "https://github.com/jdhruv14/line-art-animation/blob/main/references/scenes.md"
click node_matching_guide "https://github.com/jdhruv14/line-art-animation/blob/main/references/matching.md"
click node_verification_guide "https://github.com/jdhruv14/line-art-animation/blob/main/references/verify.md"
click node_video_guide "https://github.com/jdhruv14/line-art-animation/blob/main/references/video.md"
click node_ink "https://github.com/jdhruv14/line-art-animation/blob/main/lib/ink.ts"
click node_gait "https://github.com/jdhruv14/line-art-animation/blob/main/lib/gait.ts"
click node_motion "https://github.com/jdhruv14/line-art-animation/blob/main/lib/motion.ts"
click node_daynight "https://github.com/jdhruv14/line-art-animation/blob/main/lib/daynight.ts"
click node_walker "https://github.com/jdhruv14/line-art-animation/blob/main/examples/walker/walker.ts"
click node_village "https://github.com/jdhruv14/line-art-animation/tree/main/examples/village"

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_workflow,node_style_guide,node_motion_guide,node_scene_guide,node_matching_guide,node_verification_guide,node_video_guide toneBlue
class node_ink,node_gait,node_motion,node_daynight toneAmber
class node_walker,node_village toneMint
class node_creator toneIndigo
```

## Components

### Creation Skill

- [Scene Workflow](https://github.com/jdhruv14/line-art-animation/blob/main/SKILL.md): `SKILL.md`
- [Style Rules](https://github.com/jdhruv14/line-art-animation/blob/main/references/style.md): `references/style.md`
- [Motion Guide](https://github.com/jdhruv14/line-art-animation/blob/main/references/motion.md): `references/motion.md`
- [Scene Guide](https://github.com/jdhruv14/line-art-animation/blob/main/references/scenes.md): `references/scenes.md`
- [Clip Matching](https://github.com/jdhruv14/line-art-animation/blob/main/references/matching.md): `references/matching.md`
- [Motion Checks](https://github.com/jdhruv14/line-art-animation/blob/main/references/verify.md): `references/verify.md`
- [Video Guide](https://github.com/jdhruv14/line-art-animation/blob/main/references/video.md): `references/video.md`

### Animation Library

- [SVG Drawing](https://github.com/jdhruv14/line-art-animation/blob/main/lib/ink.ts): `lib/ink.ts`
- [Gait Solver](https://github.com/jdhruv14/line-art-animation/blob/main/lib/gait.ts): `lib/gait.ts`
- [Motion Physics](https://github.com/jdhruv14/line-art-animation/blob/main/lib/motion.ts): `lib/motion.ts`
- [Day-Night Palette](https://github.com/jdhruv14/line-art-animation/blob/main/lib/daynight.ts): `lib/daynight.ts`

### Runnable Examples

- [Reactive Walker](https://github.com/jdhruv14/line-art-animation/blob/main/examples/walker/walker.ts): `examples/walker/walker.ts`
- [Interactive Village](https://github.com/jdhruv14/line-art-animation/tree/main/examples/village): `examples/village`

### Other components

- **Creator**

## Connections

- Creator → Scene Workflow: requests scene (evidence: `README.md`)
- Scene Workflow → Style Rules: uses rules (evidence: `README.md`)
- Scene Workflow → Motion Guide: uses guidance (evidence: `README.md`)
- Scene Workflow → Scene Guide: uses guidance (evidence: `README.md`)
- Scene Workflow → Clip Matching: matches references (evidence: `README.md`)
- Scene Workflow → Motion Checks: checks motion (evidence: `README.md`)
- Scene Workflow → Video Guide: renders video (evidence: `README.md`)
- Scene Workflow → SVG Drawing: copies library (evidence: `README.md`)
- Gait Solver → SVG Drawing: uses types (evidence: `lib/gait.ts`)
- Reactive Walker → SVG Drawing: draws with (evidence: `README.md`)
- Reactive Walker → Gait Solver: animates with (evidence: `README.md`)
- Interactive Village → SVG Drawing: draws with (evidence: `README.md`)
- Interactive Village → Gait Solver: animates figures (evidence: `README.md`)
- Interactive Village → Motion Physics: supports interactions (evidence: `README.md`)
- Interactive Village → Day-Night Palette: changes palette (evidence: `README.md`)
