Plan workshop structure from existing courses, extract topics, and create outline. Use when user wants to create a new workshop.
Purpose: Collaborate with user to plan a workshop from existing courses, extract topics, and create a structured outline.
When to use: User wants to create a new workshop and needs help planning the structure.
Focus on graph databases and graph technologies.
When planning workshops, focus on building something valuable with Neo4j:
Workshop planning guidelines:
Using comparisons effectively:
Remember: The goal is to teach learners to build valuable things with Neo4j. They should leave with something that works, demonstrates value, and can be built upon. Make it hands-on and fun.
Create a goal statement:
Workshop Goal: [Concrete deliverable]
Duration: 2 hours core + 30-60 min optional
Audience: [Target level]
Prerequisites: [Required knowledge]
Value Proposition: [Why this matters]
## Source Courses
- [Course Name 1](link) - Topics: X, Y, Z
- [Course Name 2](link) - Topics: A, B, C
## Topic Categories
### Essential (Core Path - 120 min)
- [ ] Topic 1 (from Course A, Lesson 3) - 10 min
- [ ] Topic 2 (from Course B, Lesson 5) - 15 min
- [ ] Topic 3 (new, adapted from C) - 12 min
### Optional (Practice - 30 min)
- [ ] Topic 4 (from Course A, Lesson 7) - 15 min
### Advanced (Homework - 60 min)
- [ ] Topic 5 (from Course D, Lesson 2) - 20 min
Reference: See HOW-TO-BUILD-WORKSHOPS.md for detailed topic extraction process.
Apply the workshop pattern from HOW-TO-BUILD-WORKSHOPS.md:
Module 1: Setup & Introduction (15-20 min)
├── 1-workshop-overview (goal, motivation)
├── 2-environment-setup (Aura/Codespaces/Sandbox)
└── 3-tool-overview (mechanics source of truth)
Module 2: Building Block 1 - [Transformation Name] (20-30 min)
├── 1-concept (3-5 min theory)
├── 2-challenge (7-12 min hands-on)
├── 3-validation (3-5 min proof + SQL comparison)
└── 4-optional-practice (5-15 min, :optional: true)
Module 3: Building Block 2 - [Transformation Name] (20-30 min)
├── [Repeat Learn → Do → Verify pattern]
Module N: Final Integration (15-20 min)
├── 1-build-final-project (combine all blocks)
└── 2-knowledge-check (quiz)
Each block should have a clear completion marker:
Create module breakdown with:
# Workshop: [Title]
**Goal:** [Concrete deliverable]
**Duration:** 2 hours core + 30-60 min optional
**Environment:** [Aura/Codespaces/Sandbox - with justification]
## Module 1: Setup (20 min)
### 1. Workshop Overview
- **Type:** lesson
- **Duration:** 5 min
- **Content:** Goal introduction, motivation, module preview
- **Reference:** Adapt from [source course/lesson](link)
### 2. Environment Setup
- **Type:** lesson
- **Duration:** 10 min
- **Environment:** [Aura/Codespaces/Sandbox]
- **Why this environment:** [Justification]
- **Content:** Setup instructions, verification
### 3. Tool Overview
- **Type:** lesson
- **Duration:** 5 min
- **Content:** Comprehensive tool mechanics (SOURCE OF TRUTH)
- **Reference:** Adapt from [source](link)
## Module 2: Building Block 1 - [Name] (25 min core + 5 min optional)
### 1. [Concept Name]
- **Type:** lesson
- **Duration:** 5 min
- **Content:** Theory, examples with workshop data
- **Reference:** Adapt from [source](link)
### 2. [Challenge Name]
- **Type:** challenge
- **Duration:** 12 min
- **Content:** Hands-on task, automated verification
- **Verification:** verify.cypher checks [what]
- **Snapshot:** module2-lesson2.zip
- **Building Block:** "Description" ✓
### 3. [Validation Name]
- **Type:** lesson
- **Duration:** 8 min
- **Content:** Query what was built, SQL comparison
- **SQL vs Cypher:** [What comparison to show]
### 4. [Optional Practice]
- **Type:** lesson
- **Duration:** 5 min
- **Optional:** true
- **Content:** Query practice, business questions
[Repeat for additional modules...]
## Homework Extensions
### Module 2 Extended
1a. [Advanced Topic]
- **Duration:** 20 min
- **Content:** Deep dive into [concept]
Check outline against targets:
Mandatory lessons total: ___ min (target: 120 min)
Optional lessons total: ___ min (target: 30-60 min)
Homework total: ___ min (target: 60 min)
Reference: See workshop-importing course.adoc for example structure.
| Workshop Type | Environment | Reason |
|---|---|---|
| Visual modeling (Data Importer) | Aura | GUI tools required |
| Dashboard building | Aura | Dashboards tool |
| Pure Cypher practice | GraphAcademy Sandbox | Seamless, in-browser |
| Application development | Codespaces | Full dev environment |
| API building | Codespaces | Code editor + terminal |
Reference: See HOW-TO-BUILD-WORKSHOPS.md for detailed guidance.
workshop-[name]/
├── course.adoc
├── README.md
├── CONTENT_GUIDELINES.md
├── modules/
│ ├── 1-setup/
│ │ ├── module.adoc
│ │ └── lessons/
│ │ ├── 1-overview/
│ │ │ └── lesson.adoc
│ │ ├── 2-setup/
│ │ │ └── lesson.adoc
│ │ └── 3-tool-overview/
│ │ └── lesson.adoc
│ ├── 2-building-block-1/
│ │ ├── module.adoc
│ │ └── lessons/
│ │ ├── 1-concept/
│ │ │ └── lesson.adoc
│ │ ├── 2-challenge/
│ │ │ ├── lesson.adoc
│ │ │ ├── verify.cypher
│ │ │ ├── solution.cypher
│ │ │ └── questions/
│ │ │ └── verify.adoc
│ │ ├── 3-validation/
│ │ │ └── lesson.adoc
│ │ └── 4-optional-practice/
│ │ └── lesson.adoc
│ └── [additional modules...]
├── homework/
│ └── 2-building-block-1/
│ └── lessons/
│ └── 1a-advanced-topic/
│ └── lesson.adoc
├── snapshots/
│ ├── module2-lesson2.zip
│ └── [additional snapshots...]
└── data/
└── [data files]
# Create main structure
mkdir -p workshop-[name]/{modules,homework,snapshots,data}
# Copy guidelines
cp CONTENT_GUIDELINES.md workshop-[name]/
# Create module folders (example for 3 modules)
for i in 1 2 3; do
mkdir -p workshop-[name]/modules/$i-[slug]/lessons
done
# Create lesson placeholders
# (Continue based on outline)
course.adoc template:
= Workshop: [Title]
:categories: [category]
:status: active
:duration: 2 hours
:caption: [Short description]
== Course Description
[Detailed description]
**By the end of this workshop, you will have built:** [Concrete deliverable]
== Prerequisites
* [Prerequisite 1]
* [Prerequisite 2]
== Duration
* **Core path:** 2 hours
* **With optional lessons:** 2.5-3 hours
* **With homework:** +1 hour