# skills/agentic-workflows-that-read-the-room architecture

> Architecture diagram of the GitHub repository skills/agentic-workflows-that-read-the-room, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/skills/agentic-workflows-that-read-the-room
- Repository: https://github.com/skills/agentic-workflows-that-read-the-room

## Overview

This repository is an interactive GitHub Skills exercise: learners set up GitHub Agentic Workflows, build an agentic workflow that drafts updates to Mona’s website, and review its proposed changes in a pull request. The README documents the workflow’s inputs and outcome; workflow and site implementation details were not sampled, so connections beyond those documented are omitted.

Main entry points: [`.github/workflows`](https://github.com/skills/agentic-workflows-that-read-the-room/tree/main/.github/workflows) (Agentic workflow), [`.github/workflows/0-start-exercise.yml`](https://github.com/skills/agentic-workflows-that-read-the-room/blob/main/.github/workflows/0-start-exercise.yml) (Setup exercise), [`site/content/github-info.md`](https://github.com/skills/agentic-workflows-that-read-the-room/blob/main/site/content/github-info.md) (GitHub info content), [`.github/steps`](https://github.com/skills/agentic-workflows-that-read-the-room/tree/main/.github/steps) (Exercise lessons)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_exercise["Learning exercise"]
  node_lesson_steps["Exercise lessons<br/>[steps]"]
  node_setup_workflow["Setup exercise"]
  node_step_workflows["Lesson workflows<br/>[workflows]"]
end

subgraph group_automation["Agentic automation"]
  node_workflow_prompt["Workflow prompt"]
  node_agentic_workflow["Agentic workflow<br/>[workflows]"]
  node_pull_request["Proposed updates"]
end

subgraph group_website["Mona website"]
  node_mona_notes["Mona’s notes<br/>[mona-notes.md]"]
  node_site_content["GitHub info content<br/>[github-info.md]"]
  node_site["Mona’s website"]
end

node_learner(("Learner"))
node_actions{{"GitHub Actions"}}
node_copilot{{"GitHub Copilot"}}
node_blog["GitHub Blog"]
node_changelog["GitHub Changelog"]
node_reviewer(("PR reviewer"))

node_learner -->|"starts exercise"| node_setup_workflow
node_setup_workflow -->|"runs on"| node_actions
node_actions -->|"prepares lessons"| node_lesson_steps
node_learner -->|"follows"| node_lesson_steps
node_learner -->|"creates workflow"| node_step_workflows
node_step_workflows -->|"guides setup"| node_agentic_workflow
node_agentic_workflow -->|"uses"| node_copilot
node_agentic_workflow -->|"reads"| node_mona_notes
node_agentic_workflow -->|"reads"| node_blog
node_agentic_workflow -->|"reads"| node_changelog
node_agentic_workflow -->|"drafts updates"| node_site_content
node_site_content -->|"feeds website"| node_site
node_agentic_workflow -->|"opens"| node_pull_request
node_reviewer -->|"reviews"| node_pull_request
node_learner -->|"authors workflow"| node_workflow_prompt

click node_lesson_steps "https://github.com/skills/agentic-workflows-that-read-the-room/tree/main/.github/steps"
click node_setup_workflow "https://github.com/skills/agentic-workflows-that-read-the-room/blob/main/.github/workflows/0-start-exercise.yml"
click node_step_workflows "https://github.com/skills/agentic-workflows-that-read-the-room/tree/main/.github/workflows"
click node_workflow_prompt "https://github.com/skills/agentic-workflows-that-read-the-room/blob/main/.github/prompts/manage-mona-site.prompt.md"
click node_agentic_workflow "https://github.com/skills/agentic-workflows-that-read-the-room/tree/main/.github/workflows"
click node_mona_notes "https://github.com/skills/agentic-workflows-that-read-the-room/blob/main/notes/mona-notes.md"
click node_site_content "https://github.com/skills/agentic-workflows-that-read-the-room/blob/main/site/content/github-info.md"
click node_site "https://github.com/skills/agentic-workflows-that-read-the-room/tree/main/site/src"

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_lesson_steps,node_setup_workflow,node_step_workflows,node_reviewer toneBlue
class node_workflow_prompt,node_agentic_workflow,node_pull_request toneAmber
class node_mona_notes,node_site_content,node_site toneMint
class node_learner,node_actions,node_copilot,node_blog,node_changelog toneIndigo
```

## Components

### Learning exercise

- [Exercise lessons](https://github.com/skills/agentic-workflows-that-read-the-room/tree/main/.github/steps): `.github/steps`
- [Setup exercise](https://github.com/skills/agentic-workflows-that-read-the-room/blob/main/.github/workflows/0-start-exercise.yml): `.github/workflows/0-start-exercise.yml`
- [Lesson workflows](https://github.com/skills/agentic-workflows-that-read-the-room/tree/main/.github/workflows): `.github/workflows`

### Agentic automation

- [Workflow prompt](https://github.com/skills/agentic-workflows-that-read-the-room/blob/main/.github/prompts/manage-mona-site.prompt.md): `.github/prompts/manage-mona-site.prompt.md`
- [Agentic workflow](https://github.com/skills/agentic-workflows-that-read-the-room/tree/main/.github/workflows): `.github/workflows`
- **Proposed updates**

### Mona website

- [Mona’s notes](https://github.com/skills/agentic-workflows-that-read-the-room/blob/main/notes/mona-notes.md): `notes/mona-notes.md`
- [GitHub info content](https://github.com/skills/agentic-workflows-that-read-the-room/blob/main/site/content/github-info.md): `site/content/github-info.md`
- [Mona’s website](https://github.com/skills/agentic-workflows-that-read-the-room/tree/main/site/src): `site/src`

### Other components

- **Learner**
- **GitHub Actions**
- **GitHub Copilot**
- **GitHub Blog**
- **GitHub Changelog**
- **PR reviewer**

## Connections

- Learner → Setup exercise: starts exercise
- Setup exercise → GitHub Actions: runs on
- GitHub Actions → Exercise lessons: prepares lessons
- Learner → Exercise lessons: follows
- Learner → Lesson workflows: creates workflow
- Lesson workflows → Agentic workflow: guides setup
- Agentic workflow → GitHub Copilot: uses
- Agentic workflow → Mona’s notes: reads
- Agentic workflow → GitHub Blog: reads
- Agentic workflow → GitHub Changelog: reads
- Agentic workflow → GitHub info content: drafts updates
- GitHub info content → Mona’s website: feeds website
- Agentic workflow → Proposed updates: opens
- PR reviewer → Proposed updates: reviews
- Learner → Workflow prompt: authors workflow