# beyondtahir/beyondartist architecture

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

- Interactive diagram: https://gitdiagram.com/beyondtahir/beyondartist
- Repository: https://github.com/beyondtahir/beyondartist

## Overview

BeyondArtist is a portable AI design skill: it inserts a designer-and-artist workflow between a user’s brief and finished creative work, using the host’s image, browsing, and vision tools. Its principal flow covers context and memory, research and direction, concept creation, visual review, and delivery/learning. Autopilot adds video context, competitor-feed comparison, pixel-level checks, typesetting, and a delivery pack. The README documents these product relationships; sampled Python excerpts show local retrieval, private memory operations, and Autopilot capabilities, but not all command-to-command wiring.

Main entry points: [`skills/beyondartist/scripts/autopilot.py`](https://github.com/beyondtahir/beyondartist/blob/main/skills/beyondartist/scripts/autopilot.py) (Autopilot workflow), [`skills/beyondartist/references/execution-and-critique.md`](https://github.com/beyondtahir/beyondartist/blob/main/skills/beyondartist/references/execution-and-critique.md) (Artist execution), [`skills/beyondartist/SKILL.md`](https://github.com/beyondtahir/beyondartist/blob/main/skills/beyondartist/SKILL.md) (Skill workflow), [`skills/beyondartist/references/research-and-offline.md`](https://github.com/beyondtahir/beyondartist/blob/main/skills/beyondartist/references/research-and-offline.md) (Category research)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_creative["Creative workflow"]
  node_skill["Skill workflow<br/>[SKILL.md]"]
  node_intake["Brief and context"]
  node_research["Category research"]
  node_design["Design direction<br/>[art-direction.md]"]
  node_execution["Artist execution"]
  node_review["Pixel review"]
  node_delivery["Delivery and learning<br/>[creative-system.md]"]
end

subgraph group_autopilot["Autopilot tools"]
  node_autopilot["Autopilot workflow<br/>[autopilot.py]"]
  node_video["Video context<br/>[autopilot.py]"]
  node_feed["Feed Test<br/>[autopilot.py]"]
  node_gate["Quality Gate<br/>[autopilot.py]"]
  node_typeset["Exact typesetting<br/>[autopilot.py]"]
  node_pack["Delivery pack<br/>[autopilot.py]"]
end

subgraph group_memory["Memory system"]
  node_shared[("Design Memory")]
  node_personal[("Private memory<br/>[user_memory.py]")]
end

subgraph group_host["Host integrations"]
  node_hosttools["Host creative tools"]
  node_video_service["Video sources"]
  node_localfiles[("Local artwork")]
end

node_user(("Creator"))

node_user -->|"invokes"| node_skill
node_skill -->|"understands brief"| node_intake
node_intake -->|"retrieves context"| node_personal
node_skill -->|"classifies and researches"| node_research
node_research -->|"retrieves studies"| node_shared
node_research -->|"informs direction"| node_design
node_design -->|"hands off constraints"| node_execution
node_execution -->|"uses tools"| node_hosttools
node_execution -->|"creates artwork"| node_review
node_review -->|"guides repairs"| node_execution
node_review -->|"approves pixels"| node_delivery
node_delivery -->|"updates memory"| node_personal
node_user -->|"starts from link"| node_autopilot
node_autopilot -->|"reads job"| node_video
node_video -->|"fetches details"| node_video_service
node_autopilot -->|"uses taste history"| node_personal
node_autopilot -->|"compares candidates"| node_feed
node_feed -->|"reads thumbnails"| node_localfiles
node_autopilot -->|"checks finished pixels"| node_gate
node_gate -->|"measures artwork"| node_localfiles
node_autopilot -->|"sets exact text"| node_typeset
node_autopilot -->|"prepares delivery"| node_pack

click node_skill "https://github.com/beyondtahir/beyondartist/blob/main/skills/beyondartist/SKILL.md"
click node_intake "https://github.com/beyondtahir/beyondartist/blob/main/skills/beyondartist/references/intake-and-brief.md"
click node_research "https://github.com/beyondtahir/beyondartist/blob/main/skills/beyondartist/references/research-and-offline.md"
click node_design "https://github.com/beyondtahir/beyondartist/blob/main/skills/beyondartist/references/art-direction.md"
click node_execution "https://github.com/beyondtahir/beyondartist/blob/main/skills/beyondartist/references/execution-and-critique.md"
click node_review "https://github.com/beyondtahir/beyondartist/blob/main/skills/beyondartist/references/execution-and-critique.md"
click node_delivery "https://github.com/beyondtahir/beyondartist/blob/main/skills/beyondartist/references/creative-system.md"
click node_autopilot "https://github.com/beyondtahir/beyondartist/blob/main/skills/beyondartist/scripts/autopilot.py"
click node_video "https://github.com/beyondtahir/beyondartist/blob/main/skills/beyondartist/scripts/autopilot.py"
click node_feed "https://github.com/beyondtahir/beyondartist/blob/main/skills/beyondartist/scripts/autopilot.py"
click node_gate "https://github.com/beyondtahir/beyondartist/blob/main/skills/beyondartist/scripts/autopilot.py"
click node_typeset "https://github.com/beyondtahir/beyondartist/blob/main/skills/beyondartist/scripts/autopilot.py"
click node_pack "https://github.com/beyondtahir/beyondartist/blob/main/skills/beyondartist/scripts/autopilot.py"
click node_shared "https://github.com/beyondtahir/beyondartist/blob/main/skills/beyondartist/scripts/retrieve_library.py"
click node_personal "https://github.com/beyondtahir/beyondartist/blob/main/skills/beyondartist/scripts/user_memory.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_skill,node_intake,node_research,node_design,node_execution,node_review,node_delivery toneBlue
class node_autopilot,node_video,node_feed,node_gate,node_typeset,node_pack toneAmber
class node_shared,node_personal toneMint
class node_hosttools,node_video_service,node_localfiles toneRose
class node_user toneIndigo
```

## Components

### Creative workflow

- [Skill workflow](https://github.com/beyondtahir/beyondartist/blob/main/skills/beyondartist/SKILL.md): `skills/beyondartist/SKILL.md`
- [Brief and context](https://github.com/beyondtahir/beyondartist/blob/main/skills/beyondartist/references/intake-and-brief.md): `skills/beyondartist/references/intake-and-brief.md`
- [Category research](https://github.com/beyondtahir/beyondartist/blob/main/skills/beyondartist/references/research-and-offline.md): `skills/beyondartist/references/research-and-offline.md`
- [Design direction](https://github.com/beyondtahir/beyondartist/blob/main/skills/beyondartist/references/art-direction.md): `skills/beyondartist/references/art-direction.md`
- [Artist execution](https://github.com/beyondtahir/beyondartist/blob/main/skills/beyondartist/references/execution-and-critique.md): `skills/beyondartist/references/execution-and-critique.md`
- [Pixel review](https://github.com/beyondtahir/beyondartist/blob/main/skills/beyondartist/references/execution-and-critique.md): `skills/beyondartist/references/execution-and-critique.md`
- [Delivery and learning](https://github.com/beyondtahir/beyondartist/blob/main/skills/beyondartist/references/creative-system.md): `skills/beyondartist/references/creative-system.md`

### Autopilot tools

- [Autopilot workflow](https://github.com/beyondtahir/beyondartist/blob/main/skills/beyondartist/scripts/autopilot.py): `skills/beyondartist/scripts/autopilot.py`
- [Video context](https://github.com/beyondtahir/beyondartist/blob/main/skills/beyondartist/scripts/autopilot.py): `skills/beyondartist/scripts/autopilot.py`
- [Feed Test](https://github.com/beyondtahir/beyondartist/blob/main/skills/beyondartist/scripts/autopilot.py): `skills/beyondartist/scripts/autopilot.py`
- [Quality Gate](https://github.com/beyondtahir/beyondartist/blob/main/skills/beyondartist/scripts/autopilot.py): `skills/beyondartist/scripts/autopilot.py`
- [Exact typesetting](https://github.com/beyondtahir/beyondartist/blob/main/skills/beyondartist/scripts/autopilot.py): `skills/beyondartist/scripts/autopilot.py`
- [Delivery pack](https://github.com/beyondtahir/beyondartist/blob/main/skills/beyondartist/scripts/autopilot.py): `skills/beyondartist/scripts/autopilot.py`

### Memory system

- [Design Memory](https://github.com/beyondtahir/beyondartist/blob/main/skills/beyondartist/scripts/retrieve_library.py): `skills/beyondartist/scripts/retrieve_library.py`
- [Private memory](https://github.com/beyondtahir/beyondartist/blob/main/skills/beyondartist/scripts/user_memory.py): `skills/beyondartist/scripts/user_memory.py`

### Host integrations

- **Host creative tools**
- **Video sources**
- **Local artwork**

### Other components

- **Creator**

## Connections

- Creator → Skill workflow: invokes (evidence: `README.md`)
- Skill workflow → Brief and context: understands brief (evidence: `README.md`)
- Brief and context → Private memory: retrieves context (evidence: `README.md`)
- Skill workflow → Category research: classifies and researches (evidence: `README.md`)
- Category research → Design Memory: retrieves studies (evidence: `README.md`)
- Category research → Design direction: informs direction (evidence: `README.md`)
- Design direction → Artist execution: hands off constraints (evidence: `README.md`)
- Artist execution → Host creative tools: uses tools (evidence: `README.md`)
- Artist execution → Pixel review: creates artwork (evidence: `README.md`)
- Pixel review → Artist execution: guides repairs (evidence: `README.md`)
- Pixel review → Delivery and learning: approves pixels (evidence: `README.md`)
- Delivery and learning → Private memory: updates memory (evidence: `README.md`)
- Creator → Autopilot workflow: starts from link (evidence: `README.md`)
- Autopilot workflow → Video context: reads job (evidence: `README.md`)
- Video context → Video sources: fetches details (evidence: `skills/beyondartist/scripts/autopilot.py`)
- Autopilot workflow → Private memory: uses taste history (evidence: `README.md`)
- Autopilot workflow → Feed Test: compares candidates (evidence: `README.md`)
- Feed Test → Local artwork: reads thumbnails (evidence: `skills/beyondartist/scripts/autopilot.py`)
- Autopilot workflow → Quality Gate: checks finished pixels (evidence: `README.md`)
- Quality Gate → Local artwork: measures artwork (evidence: `skills/beyondartist/scripts/autopilot.py`)
- Autopilot workflow → Exact typesetting: sets exact text (evidence: `README.md`)
- Autopilot workflow → Delivery pack: prepares delivery (evidence: `README.md`)
