# theindomitable/gta6-clipper architecture

> Architecture diagram of the GitHub repository theindomitable/gta6-clipper, 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/theindomitable/gta6-clipper
- Repository: https://github.com/theindomitable/gta6-clipper

## Overview

GTA 6 Reel Factory discovers public ideas, plans and learns from performance, then writes and renders rights-checked vertical Reels. The graph follows the documented daily workflow and keeps live capture as a separate capability. README statements support the main orchestration stages; source-index references support selected module links. Several stages are unsampled, so their documented connections are cited to the README rather than inferred from filenames.

Main entry points: [`run_pipeline.py`](https://github.com/theindomitable/gta6-clipper/blob/master/run_pipeline.py) (Run orchestration), [`discover.py`](https://github.com/theindomitable/gta6-clipper/blob/master/discover.py) (Idea discovery), [`creators.py`](https://github.com/theindomitable/gta6-clipper/blob/master/creators.py) (Creator research), [`clip_pipeline.py`](https://github.com/theindomitable/gta6-clipper/blob/master/clip_pipeline.py) (Video rendering)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_planning["Planning &amp; Learning"]
  node_rank["Purpose rankings"]
  node_winner["Winner playbook<br/>[winner_engine.py]"]
  node_creative["Creative direction<br/>[creative_engine.py]"]
  node_strategy["Content strategy"]
  node_learning["Performance learning<br/>[learning.py]"]
end

subgraph group_discovery["Discovery &amp; Rights"]
  node_creator["Creator research<br/>[creators.py]"]
  node_discover["Idea discovery<br/>[discover.py]"]
  node_miner["Clip mining<br/>[reel_miner.py]"]
  node_factcheck["Fact checking<br/>[fact_check.py]"]
  node_provenance["Rights provenance<br/>[provenance.py]"]
  node_live["Live capture<br/>[live_capture.py]"]
end

subgraph group_production["Reel Production"]
  node_writer["Script writing<br/>[voice_text.py]"]
  node_voiceover["Voiceover<br/>[voiceover.py]"]
  node_render["Video rendering<br/>[clip_pipeline.py]"]
  node_packaging["Reel packaging<br/>[packaging.py]"]
end

subgraph group_runtime["Runtime &amp; Integrations"]
  node_pipeline["Run orchestration<br/>[run_pipeline.py]"]
  node_kick["Kick public API<br/>[kick.py]"]
  node_commons["Commons search<br/>[commons.py]"]
  node_recall[("Recall memory<br/>[memory.py]")]
  node_io["File persistence<br/>[io.py]"]
  node_config["Configuration<br/>[config.py]"]
end

node_creator_actor(("Operator"))
node_platforms["Public platforms"]
node_output["Published Reel"]

node_creator_actor -.->|"starts run"| node_pipeline
node_pipeline -->|"requests ideas"| node_discover
node_discover -->|"researches creators"| node_creator
node_discover -->|"loads profiles"| node_rank
node_discover -->|"builds playbook"| node_winner
node_discover -->|"builds brief"| node_creative
node_creator -.->|"searches metadata"| node_platforms
node_discover -.->|"finds public ideas"| node_platforms
node_pipeline -->|"uses plan"| node_strategy
node_strategy -.->|"stores philosophy"| node_recall
node_learning -->|"updates profiles"| node_rank
node_learning -.->|"syncs learning"| node_recall
node_pipeline -->|"mines selected idea"| node_miner
node_pipeline -->|"requests script"| node_writer
node_writer -->|"checks claims"| node_factcheck
node_pipeline -.->|"verifies selection"| node_factcheck
node_pipeline -->|"enforces rights"| node_provenance
node_pipeline -->|"renders clip"| node_render
node_render -.->|"adds narration"| node_voiceover
node_pipeline -->|"packages reel"| node_packaging
node_render -.->|"produces video"| node_output
node_pipeline -.->|"learns outcomes"| node_learning
node_live -->|"checks live feeds"| node_kick
node_live -.->|"captures streams"| node_platforms
node_pipeline -->|"reads settings"| node_config
node_io -.->|"loads settings"| node_config
node_creator -->|"uses profiles"| node_rank
node_discover -.->|"writes selection"| node_io
node_commons -.->|"supplies source metadata"| node_provenance

click node_creator "https://github.com/theindomitable/gta6-clipper/blob/master/creators.py"
click node_discover "https://github.com/theindomitable/gta6-clipper/blob/master/discover.py"
click node_rank "https://github.com/theindomitable/gta6-clipper/blob/master/src/reelfactory/services/purpose_rankings.py"
click node_winner "https://github.com/theindomitable/gta6-clipper/blob/master/src/reelfactory/services/winner_engine.py"
click node_creative "https://github.com/theindomitable/gta6-clipper/blob/master/src/reelfactory/services/creative_engine.py"
click node_strategy "https://github.com/theindomitable/gta6-clipper/blob/master/content_strategy.py"
click node_learning "https://github.com/theindomitable/gta6-clipper/blob/master/learning.py"
click node_pipeline "https://github.com/theindomitable/gta6-clipper/blob/master/run_pipeline.py"
click node_miner "https://github.com/theindomitable/gta6-clipper/blob/master/reel_miner.py"
click node_factcheck "https://github.com/theindomitable/gta6-clipper/blob/master/fact_check.py"
click node_provenance "https://github.com/theindomitable/gta6-clipper/blob/master/src/reelfactory/provenance.py"
click node_writer "https://github.com/theindomitable/gta6-clipper/blob/master/voice_text.py"
click node_voiceover "https://github.com/theindomitable/gta6-clipper/blob/master/voiceover.py"
click node_render "https://github.com/theindomitable/gta6-clipper/blob/master/clip_pipeline.py"
click node_packaging "https://github.com/theindomitable/gta6-clipper/blob/master/packaging.py"
click node_live "https://github.com/theindomitable/gta6-clipper/blob/master/live_capture.py"
click node_kick "https://github.com/theindomitable/gta6-clipper/blob/master/src/reelfactory/adapters/kick.py"
click node_commons "https://github.com/theindomitable/gta6-clipper/blob/master/src/reelfactory/adapters/commons.py"
click node_recall "https://github.com/theindomitable/gta6-clipper/blob/master/src/reelfactory/adapters/memory.py"
click node_io "https://github.com/theindomitable/gta6-clipper/blob/master/src/reelfactory/io.py"
click node_config "https://github.com/theindomitable/gta6-clipper/blob/master/config.py"

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_rank,node_winner,node_creative,node_strategy,node_learning toneBlue
class node_creator,node_discover,node_miner,node_factcheck,node_provenance,node_live toneAmber
class node_writer,node_voiceover,node_render,node_packaging toneMint
class node_pipeline,node_kick,node_commons,node_recall,node_io,node_config toneRose
class node_creator_actor,node_platforms,node_output toneIndigo
```

## Components

### Planning & Learning

- [Purpose rankings](https://github.com/theindomitable/gta6-clipper/blob/master/src/reelfactory/services/purpose_rankings.py): `src/reelfactory/services/purpose_rankings.py`
- [Winner playbook](https://github.com/theindomitable/gta6-clipper/blob/master/src/reelfactory/services/winner_engine.py): `src/reelfactory/services/winner_engine.py`
- [Creative direction](https://github.com/theindomitable/gta6-clipper/blob/master/src/reelfactory/services/creative_engine.py): `src/reelfactory/services/creative_engine.py`
- [Content strategy](https://github.com/theindomitable/gta6-clipper/blob/master/content_strategy.py): `content_strategy.py`
- [Performance learning](https://github.com/theindomitable/gta6-clipper/blob/master/learning.py): `learning.py`

### Discovery & Rights

- [Creator research](https://github.com/theindomitable/gta6-clipper/blob/master/creators.py): `creators.py`
- [Idea discovery](https://github.com/theindomitable/gta6-clipper/blob/master/discover.py): `discover.py`
- [Clip mining](https://github.com/theindomitable/gta6-clipper/blob/master/reel_miner.py): `reel_miner.py`
- [Fact checking](https://github.com/theindomitable/gta6-clipper/blob/master/fact_check.py): `fact_check.py`
- [Rights provenance](https://github.com/theindomitable/gta6-clipper/blob/master/src/reelfactory/provenance.py): `src/reelfactory/provenance.py`
- [Live capture](https://github.com/theindomitable/gta6-clipper/blob/master/live_capture.py): `live_capture.py`

### Reel Production

- [Script writing](https://github.com/theindomitable/gta6-clipper/blob/master/voice_text.py): `voice_text.py`
- [Voiceover](https://github.com/theindomitable/gta6-clipper/blob/master/voiceover.py): `voiceover.py`
- [Video rendering](https://github.com/theindomitable/gta6-clipper/blob/master/clip_pipeline.py): `clip_pipeline.py`
- [Reel packaging](https://github.com/theindomitable/gta6-clipper/blob/master/packaging.py): `packaging.py`

### Runtime & Integrations

- [Run orchestration](https://github.com/theindomitable/gta6-clipper/blob/master/run_pipeline.py): `run_pipeline.py`
- [Kick public API](https://github.com/theindomitable/gta6-clipper/blob/master/src/reelfactory/adapters/kick.py): `src/reelfactory/adapters/kick.py`
- [Commons search](https://github.com/theindomitable/gta6-clipper/blob/master/src/reelfactory/adapters/commons.py): `src/reelfactory/adapters/commons.py`
- [Recall memory](https://github.com/theindomitable/gta6-clipper/blob/master/src/reelfactory/adapters/memory.py): `src/reelfactory/adapters/memory.py`
- [File persistence](https://github.com/theindomitable/gta6-clipper/blob/master/src/reelfactory/io.py): `src/reelfactory/io.py`
- [Configuration](https://github.com/theindomitable/gta6-clipper/blob/master/config.py): `config.py`

### Other components

- **Operator**
- **Public platforms**
- **Published Reel**

## Connections

- Operator → Run orchestration: starts run
- Run orchestration → Idea discovery: requests ideas
- Idea discovery → Creator research: researches creators (evidence: `discover.py`)
- Idea discovery → Purpose rankings: loads profiles (evidence: `discover.py`)
- Idea discovery → Winner playbook: builds playbook (evidence: `discover.py`)
- Idea discovery → Creative direction: builds brief (evidence: `discover.py`)
- Creator research → Public platforms: searches metadata (evidence: `creators.py`)
- Idea discovery → Public platforms: finds public ideas
- Run orchestration → Content strategy: uses plan (evidence: `run_pipeline.py`)
- Content strategy → Recall memory: stores philosophy
- Performance learning → Purpose rankings: updates profiles (evidence: `src/reelfactory/services/purpose_rankings.py`)
- Performance learning → Recall memory: syncs learning
- Run orchestration → Clip mining: mines selected idea
- Run orchestration → Script writing: requests script
- Script writing → Fact checking: checks claims (evidence: `voice_text.py`)
- Run orchestration → Fact checking: verifies selection
- Run orchestration → Rights provenance: enforces rights (evidence: `run_pipeline.py`)
- Run orchestration → Video rendering: renders clip
- Video rendering → Voiceover: adds narration (evidence: `clip_pipeline.py`)
- Run orchestration → Reel packaging: packages reel
- Video rendering → Published Reel: produces video
- Run orchestration → Performance learning: learns outcomes
- Live capture → Kick public API: checks live feeds (evidence: `live_capture.py`)
- Live capture → Public platforms: captures streams
- Run orchestration → Configuration: reads settings (evidence: `run_pipeline.py`)
- File persistence → Configuration: loads settings
- Creator research → Purpose rankings: uses profiles (evidence: `creators.py`)
- Idea discovery → File persistence: writes selection
- Commons search → Rights provenance: supplies source metadata
