# helloianneo/ian-handdrawn-ppt architecture

> Architecture diagram of the GitHub repository helloianneo/ian-handdrawn-ppt, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/helloianneo/ian-handdrawn-ppt
- Repository: https://github.com/helloianneo/ian-handdrawn-ppt

## Overview

Ian Handdrawn PPT is a Codex Skill that turns supplied material into planned, Chinese hand-drawn technical-explanation images—not editable slide files. Its documented workflow moves from intake through narrative and visual planning to per-page prompts, image generation, quality checks, and delivery. The graph reflects README-documented stages and the skill’s reference files; no source excerpts were provided, so internal call details and implementation beyond those documents are not inferred.

Main entry points: [`ian-handdrawn-ppt/SKILL.md`](https://github.com/helloianneo/ian-handdrawn-ppt/blob/main/ian-handdrawn-ppt/SKILL.md) (Image generation), [`ian-handdrawn-ppt/references/narrative-planning.md`](https://github.com/helloianneo/ian-handdrawn-ppt/blob/main/ian-handdrawn-ppt/references/narrative-planning.md) (Narrative plan), [`ian-handdrawn-ppt/references/slide-archetypes.md`](https://github.com/helloianneo/ian-handdrawn-ppt/blob/main/ian-handdrawn-ppt/references/slide-archetypes.md) (Slide archetypes), [`ian-handdrawn-ppt/references/output-quality.md`](https://github.com/helloianneo/ian-handdrawn-ppt/blob/main/ian-handdrawn-ppt/references/output-quality.md) (Output quality check)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_planning["Content planning"]
  node_skill["Skill instructions<br/>[SKILL.md]"]
  node_intake["Material intake<br/>[intake.md]"]
  node_narrative["Narrative plan"]
  node_archetypes["Slide archetypes"]
end

subgraph group_design["Visual design"]
  node_visualdna["Visual DNA<br/>[visual-dna-v6.md]"]
  node_tokens["Theme tokens<br/>[theme-tokens.json]"]
  node_promptpatterns["Prompt patterns<br/>[prompt-patterns.md]"]
end

subgraph group_production["Image production"]
  node_imagegen["Image generation<br/>[SKILL.md]"]
end

subgraph group_delivery["Output and review"]
  node_quality["Output quality check<br/>[output-quality.md]"]
  node_blueprint["Slide blueprint"]
  node_pages["PNG page images"]
  node_contact["Contact sheet"]
end

node_user(("Content creator"))
node_codex(("Codex agent"))
node_materials["Source material"]
node_imagemodel(("Image model"))

node_user -->|"invokes skill"| node_codex
node_user -->|"provides material"| node_materials
node_codex -->|"uses"| node_skill
node_skill -->|"guides intake"| node_intake
node_materials -->|"is assessed"| node_intake
node_intake -->|"informs planning"| node_narrative
node_narrative -->|"guides selection"| node_archetypes
node_archetypes -->|"sets page style"| node_visualdna
node_visualdna -.->|"uses tokens"| node_tokens
node_archetypes -->|"shapes prompts"| node_promptpatterns
node_promptpatterns -->|"guides generation"| node_imagegen
node_imagegen -->|"requests images"| node_imagemodel
node_imagegen -->|"checks results"| node_quality
node_narrative -->|"produces summary"| node_blueprint
node_quality -->|"approves pages"| node_pages
node_imagegen -->|"generates pages"| node_pages
node_pages -->|"assembled as"| node_contact
node_quality -->|"guides review"| node_pages

click node_skill "https://github.com/helloianneo/ian-handdrawn-ppt/blob/main/ian-handdrawn-ppt/SKILL.md"
click node_intake "https://github.com/helloianneo/ian-handdrawn-ppt/blob/main/ian-handdrawn-ppt/references/intake.md"
click node_narrative "https://github.com/helloianneo/ian-handdrawn-ppt/blob/main/ian-handdrawn-ppt/references/narrative-planning.md"
click node_archetypes "https://github.com/helloianneo/ian-handdrawn-ppt/blob/main/ian-handdrawn-ppt/references/slide-archetypes.md"
click node_visualdna "https://github.com/helloianneo/ian-handdrawn-ppt/blob/main/ian-handdrawn-ppt/references/visual-dna-v6.md"
click node_tokens "https://github.com/helloianneo/ian-handdrawn-ppt/blob/main/ian-handdrawn-ppt/assets/theme-tokens.json"
click node_promptpatterns "https://github.com/helloianneo/ian-handdrawn-ppt/blob/main/ian-handdrawn-ppt/references/prompt-patterns.md"
click node_imagegen "https://github.com/helloianneo/ian-handdrawn-ppt/blob/main/ian-handdrawn-ppt/SKILL.md"
click node_quality "https://github.com/helloianneo/ian-handdrawn-ppt/blob/main/ian-handdrawn-ppt/references/output-quality.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_intake,node_narrative,node_archetypes toneBlue
class node_visualdna,node_tokens,node_promptpatterns toneAmber
class node_imagegen toneMint
class node_quality,node_blueprint,node_pages,node_contact toneRose
class node_user,node_codex,node_materials,node_imagemodel toneIndigo
```

## Components

### Content planning

- [Skill instructions](https://github.com/helloianneo/ian-handdrawn-ppt/blob/main/ian-handdrawn-ppt/SKILL.md): `ian-handdrawn-ppt/SKILL.md`
- [Material intake](https://github.com/helloianneo/ian-handdrawn-ppt/blob/main/ian-handdrawn-ppt/references/intake.md): `ian-handdrawn-ppt/references/intake.md`
- [Narrative plan](https://github.com/helloianneo/ian-handdrawn-ppt/blob/main/ian-handdrawn-ppt/references/narrative-planning.md): `ian-handdrawn-ppt/references/narrative-planning.md`
- [Slide archetypes](https://github.com/helloianneo/ian-handdrawn-ppt/blob/main/ian-handdrawn-ppt/references/slide-archetypes.md): `ian-handdrawn-ppt/references/slide-archetypes.md`

### Visual design

- [Visual DNA](https://github.com/helloianneo/ian-handdrawn-ppt/blob/main/ian-handdrawn-ppt/references/visual-dna-v6.md): `ian-handdrawn-ppt/references/visual-dna-v6.md`
- [Theme tokens](https://github.com/helloianneo/ian-handdrawn-ppt/blob/main/ian-handdrawn-ppt/assets/theme-tokens.json): `ian-handdrawn-ppt/assets/theme-tokens.json`
- [Prompt patterns](https://github.com/helloianneo/ian-handdrawn-ppt/blob/main/ian-handdrawn-ppt/references/prompt-patterns.md): `ian-handdrawn-ppt/references/prompt-patterns.md`

### Image production

- [Image generation](https://github.com/helloianneo/ian-handdrawn-ppt/blob/main/ian-handdrawn-ppt/SKILL.md): `ian-handdrawn-ppt/SKILL.md`

### Output and review

- [Output quality check](https://github.com/helloianneo/ian-handdrawn-ppt/blob/main/ian-handdrawn-ppt/references/output-quality.md): `ian-handdrawn-ppt/references/output-quality.md`
- **Slide blueprint**
- **PNG page images**
- **Contact sheet**

### Other components

- **Content creator**
- **Codex agent**
- **Source material**
- **Image model**

## Connections

- Content creator → Codex agent: invokes skill (evidence: `README.md`)
- Content creator → Source material: provides material (evidence: `README.md`)
- Codex agent → Skill instructions: uses (evidence: `README.md`)
- Skill instructions → Material intake: guides intake (evidence: `README.md`)
- Source material → Material intake: is assessed (evidence: `README.md`)
- Material intake → Narrative plan: informs planning (evidence: `README.md`)
- Narrative plan → Slide archetypes: guides selection (evidence: `README.md`)
- Slide archetypes → Visual DNA: sets page style (evidence: `README.md`)
- Visual DNA → Theme tokens: uses tokens
- Slide archetypes → Prompt patterns: shapes prompts (evidence: `README.md`)
- Prompt patterns → Image generation: guides generation (evidence: `README.md`)
- Image generation → Image model: requests images (evidence: `README.md`)
- Image generation → Output quality check: checks results (evidence: `README.md`)
- Narrative plan → Slide blueprint: produces summary (evidence: `README.md`)
- Output quality check → PNG page images: approves pages (evidence: `README.md`)
- Image generation → PNG page images: generates pages (evidence: `README.md`)
- PNG page images → Contact sheet: assembled as (evidence: `README.md`)
- Output quality check → PNG page images: guides review (evidence: `README.md`)
