# saya-ch/sayareport architecture

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

- Interactive diagram: https://gitdiagram.com/saya-ch/sayareport
- Repository: https://github.com/saya-ch/sayareport

## Overview

SayaReport is a scheduled, personalized job-and-competition information report published as a static web page. Its documented workflow moves from prompt and operating guidance through research and verification, visual design, HTML generation and independent review, then deployment to GitHub Pages. The repository also includes design skill libraries used to support report production. The workflow links follow the README; sampled skill excerpts show selected search and design utilities, not the complete skill implementations.

Main entry points: [`PHASE-3.md`](https://github.com/saya-ch/sayareport/blob/main/PHASE-3.md) (Visual design), [`PHASE-4.md`](https://github.com/saya-ch/sayareport/blob/main/PHASE-4.md) (Generate and review), [`PHASE-5.md`](https://github.com/saya-ch/sayareport/blob/main/PHASE-5.md) (Deployment and wrap-up), [`skills/ui-ux-pro-max/ui-ux-pro-max/SKILL.md`](https://github.com/saya-ch/sayareport/blob/main/skills/ui-ux-pro-max/ui-ux-pro-max/SKILL.md) (UI/UX design library)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Report workflow"]
  node_prompt["Task prompt<br/>[PROMPT.md]"]
  node_guidance["Operating guidance<br/>[AGENT.md]"]
  node_phases["Phase guides<br/>[PHASE-1.md]"]
  node_checklist["Work checklist<br/>[CHECKLIST.md]"]
  node_research["Research and verify<br/>[PHASE-2.md]"]
  node_designstage["Visual design<br/>[PHASE-3.md]"]
  node_reportstage["Generate and review<br/>[PHASE-4.md]"]
  node_deploy["Deployment and wrap-up<br/>[PHASE-5.md]"]
end

subgraph group_design["Design skills"]
  node_pptskill["PPT design skill<br/>[SKILL.md]"]
  node_uiskill["UI/UX design library<br/>[SKILL.md]"]
  node_slidesearch["Slide design search<br/>[search-slides.py]"]
  node_designsystem["Design system generator<br/>[design_system.py]"]
  node_gsapskill["GSAP skill library<br/>[SKILL.md]"]
end

subgraph group_publication["Report publication"]
  node_report["Published report page<br/>[index.html]"]
  node_assets["Report assets"]
end

node_saya(("Saya agent"))
node_schedule(("Scheduled task"))
node_sources(("Information sources"))
node_reviewer(("Independent reviewer"))
node_pages["GitHub Pages"]

node_schedule -->|"starts task"| node_prompt
node_prompt -->|"guides"| node_saya
node_saya -->|"reads"| node_guidance
node_guidance -->|"routes work"| node_phases
node_saya -->|"tracks progress"| node_checklist
node_saya -->|"conducts research"| node_research
node_research -->|"searches and verifies"| node_sources
node_saya -->|"plans presentation"| node_designstage
node_designstage -->|"uses first"| node_pptskill
node_designstage -.->|"consults"| node_uiskill
node_designstage -.->|"consults"| node_gsapskill
node_uiskill -->|"includes"| node_slidesearch
node_uiskill -->|"includes"| node_designsystem
node_saya -->|"generates page"| node_reportstage
node_reportstage -->|"requests review"| node_reviewer
node_reportstage -->|"produces"| node_report
node_reportstage -->|"produces"| node_assets
node_saya -->|"deploys"| node_deploy
node_deploy -->|"publishes"| node_report
node_deploy -->|"publishes"| node_assets
node_deploy -->|"pushes to"| node_pages

click node_prompt "https://github.com/saya-ch/sayareport/blob/main/PROMPT.md"
click node_guidance "https://github.com/saya-ch/sayareport/blob/main/AGENT.md"
click node_phases "https://github.com/saya-ch/sayareport/blob/main/PHASE-1.md"
click node_checklist "https://github.com/saya-ch/sayareport/blob/main/CHECKLIST.md"
click node_research "https://github.com/saya-ch/sayareport/blob/main/PHASE-2.md"
click node_designstage "https://github.com/saya-ch/sayareport/blob/main/PHASE-3.md"
click node_pptskill "https://github.com/saya-ch/sayareport/blob/main/skills/guizang-ppt-skill/SKILL.md"
click node_uiskill "https://github.com/saya-ch/sayareport/blob/main/skills/ui-ux-pro-max/ui-ux-pro-max/SKILL.md"
click node_slidesearch "https://github.com/saya-ch/sayareport/blob/main/skills/ui-ux-pro-max/design-system/scripts/search-slides.py"
click node_designsystem "https://github.com/saya-ch/sayareport/blob/main/skills/ui-ux-pro-max/ui-ux-pro-max/scripts/design_system.py"
click node_gsapskill "https://github.com/saya-ch/sayareport/blob/main/skills/gsap-skills/gsap-core/SKILL.md"
click node_reportstage "https://github.com/saya-ch/sayareport/blob/main/PHASE-4.md"
click node_report "https://github.com/saya-ch/sayareport/blob/main/index.html"
click node_assets "https://github.com/saya-ch/sayareport/tree/main/assets"
click node_deploy "https://github.com/saya-ch/sayareport/blob/main/PHASE-5.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_prompt,node_guidance,node_phases,node_checklist,node_research,node_designstage,node_reportstage,node_deploy,node_reviewer toneBlue
class node_pptskill,node_uiskill,node_slidesearch,node_designsystem,node_gsapskill toneAmber
class node_report,node_assets toneMint
class node_saya,node_sources,node_pages toneIndigo
class node_schedule toneRose
```

## Components

### Report workflow

- [Task prompt](https://github.com/saya-ch/sayareport/blob/main/PROMPT.md): `PROMPT.md`
- [Operating guidance](https://github.com/saya-ch/sayareport/blob/main/AGENT.md): `AGENT.md`
- [Phase guides](https://github.com/saya-ch/sayareport/blob/main/PHASE-1.md): `PHASE-1.md`
- [Work checklist](https://github.com/saya-ch/sayareport/blob/main/CHECKLIST.md): `CHECKLIST.md`
- [Research and verify](https://github.com/saya-ch/sayareport/blob/main/PHASE-2.md): `PHASE-2.md`
- [Visual design](https://github.com/saya-ch/sayareport/blob/main/PHASE-3.md): `PHASE-3.md`
- [Generate and review](https://github.com/saya-ch/sayareport/blob/main/PHASE-4.md): `PHASE-4.md`
- [Deployment and wrap-up](https://github.com/saya-ch/sayareport/blob/main/PHASE-5.md): `PHASE-5.md`

### Design skills

- [PPT design skill](https://github.com/saya-ch/sayareport/blob/main/skills/guizang-ppt-skill/SKILL.md): `skills/guizang-ppt-skill/SKILL.md`
- [UI/UX design library](https://github.com/saya-ch/sayareport/blob/main/skills/ui-ux-pro-max/ui-ux-pro-max/SKILL.md): `skills/ui-ux-pro-max/ui-ux-pro-max/SKILL.md`
- [Slide design search](https://github.com/saya-ch/sayareport/blob/main/skills/ui-ux-pro-max/design-system/scripts/search-slides.py): `skills/ui-ux-pro-max/design-system/scripts/search-slides.py`
- [Design system generator](https://github.com/saya-ch/sayareport/blob/main/skills/ui-ux-pro-max/ui-ux-pro-max/scripts/design_system.py): `skills/ui-ux-pro-max/ui-ux-pro-max/scripts/design_system.py`
- [GSAP skill library](https://github.com/saya-ch/sayareport/blob/main/skills/gsap-skills/gsap-core/SKILL.md): `skills/gsap-skills/gsap-core/SKILL.md`

### Report publication

- [Published report page](https://github.com/saya-ch/sayareport/blob/main/index.html): `index.html`
- [Report assets](https://github.com/saya-ch/sayareport/tree/main/assets): `assets`

### Other components

- **Saya agent**
- **Scheduled task**
- **Information sources**
- **Independent reviewer**
- **GitHub Pages**

## Connections

- Scheduled task → Task prompt: starts task
- Task prompt → Saya agent: guides
- Saya agent → Operating guidance: reads
- Operating guidance → Phase guides: routes work
- Saya agent → Work checklist: tracks progress
- Saya agent → Research and verify: conducts research
- Research and verify → Information sources: searches and verifies
- Saya agent → Visual design: plans presentation
- Visual design → PPT design skill: uses first
- Visual design → UI/UX design library: consults
- Visual design → GSAP skill library: consults
- UI/UX design library → Slide design search: includes
- UI/UX design library → Design system generator: includes
- Saya agent → Generate and review: generates page
- Generate and review → Independent reviewer: requests review
- Generate and review → Published report page: produces
- Generate and review → Report assets: produces
- Saya agent → Deployment and wrap-up: deploys
- Deployment and wrap-up → Published report page: publishes
- Deployment and wrap-up → Report assets: publishes
- Deployment and wrap-up → GitHub Pages: pushes to