gh-bradleyboehmke-brads-marketplace-course-builder/commands/create-module-overview.md

---
description: Create a Canvas module overview document
---

# Create Module Overview

Generate a Canvas module overview document that summarizes the week's learning objectives, content, and activities.

## Interactive Workflow

This command uses a numbered-option interactive workflow to gather requirements and create the module overview.

### Step 1: Course Selection

Ask the user which course this module overview is for:

```
Which course is this module overview for?

[1] BANA 4080 (Intro to Data Mining - Undergraduate)
[2] BANA 6043 (Statistical Computing - Graduate)
[3] BANA 7075 (ML in Business - Graduate)

Please select an option by number:
```

Load the appropriate course profile.

### Step 2: Module Number

Ask what module/week this overview is for:

```
What module/week number is this overview for?
(e.g., 4, 6, 10)
```

### Step 3: Content References

Ask which content materials to include:

```
Which chapters should be referenced for this module?
(Provide chapter numbers or names, e.g., "Chapters 7-9" or "Control Flow, Functions")
```

Then ask:

```
Path to Tuesday lecture slides (or description of lecture topics):
(Press Enter to skip if not available)
```

Then ask:

```
Path to Thursday lab notebook (or description of lab activities):
(Press Enter to skip if not available)
```

### Step 4: Analyze Content

Read and analyze the provided materials:
- If chapter paths are provided, read the chapters to extract learning objectives and key concepts
- If slide path is provided, read the slides to understand lecture structure
- If lab path is provided, read the lab to understand hands-on activities
- Extract module title from content (e.g., "Control Flow, Iteration, and Functions")
- Identify learning objectives (aim for 5-8 measurable objectives)
- Extract key concepts and skills for "What You'll Learn This Week"
- Summarize Tuesday lecture and Thursday lab activities

### Step 5: Supplemental Files

Ask about supplemental files:

```
Are there any supplemental files or materials to include?
(e.g., companion notebooks, example code, additional resources)

[1] No, leave as "TBD"
[2] Yes, I'll provide details

Please select an option:
```

If option [2], ask:

```
Please list the supplemental files and materials to include:
(e.g., "Chapter 23 Logistic Regression Notebook: link", "Reading Quiz: Available Monday-Wednesday")
```

### Step 6: Generate Overview

Using the template at `/Users/b294776/Desktop/UC/uc-bana-4080/planning/templates/module_overview_template.md`, generate the module overview by:

1. Reading the template file
2. Replacing all `{PLACEHOLDERS}` with content extracted from analysis:
   - `{MODULE_NUMBER}` - Week/module number
   - `{MODULE_TITLE}` - Descriptive title extracted from content
   - `{MODULE_TOPIC_BLURB}` - 2-3 paragraph overview connecting technical content to business context
   - `{LEARNING_OBJECTIVE_X}` - Specific, measurable learning objectives (5-8 items)
   - `{KEY_POINT_X}` - Concise bullets highlighting skills/concepts from "What You'll Learn"
   - `{TUESDAY_LECTURE_TITLE}` - Title of Tuesday's lecture
   - `{TUESDAY_LECTURE_ACTIVITIES}` - 2-4 bullets describing lecture activities
   - `{THURSDAY_LAB_TITLE}` - Title of Thursday's lab
   - `{THURSDAY_LAB_ACTIVITIES}` - 2-4 bullets describing lab activities
   - Supplemental files section (TBD or user-provided content)

3. Ensure tone is:
   - Approachable and practical
   - Business-focused
   - Encouraging
   - Concrete with specific examples

4. Remove all HTML comments and guidance text from the final output

### Step 7: Present Draft

Display the complete generated overview to the user:

```
Here's the proposed module overview:

───────────────────────────────────────────
[Full generated overview text]
───────────────────────────────────────────

Does this look good?

[1] Yes, save this overview
[2] No, I'd like to make changes

Please select an option:
```

If option [2], ask:

```
What changes would you like me to make?
```

Then regenerate with the requested changes and present again.

### Step 8: Save Location

When user accepts the overview, ask where to save:

```
Where should I save the module overview?

[Suggested: /Users/b294776/Desktop/UC/uc-bana-4080/planning/canvas_docs/]

Please provide the directory path (or press Enter to use suggested path):
```

Then ask for filename:

```
What should I name the file?
[Suggested: week{X}_overview.md]

Please provide the filename (or press Enter to use suggested name):
```

Save the file and display confirmation.

### Step 9: Completion Message

```
✅ Module overview created successfully!

Location: [full path to created file]

The overview includes:
- Module topic introduction with business context
- {X} learning objectives
- "What You'll Learn This Week" summary
- Tuesday lecture and Thursday lab descriptions
- Supplemental files section

Next steps:
- Review the overview in your editor
- Copy and paste into Canvas module page
- Add any course-specific formatting or links
```

## What the Agent Does

The course-architect agent will:

**Analysis Phase:**
- Load appropriate course profile
- Read and analyze provided chapters, slides, and lab materials
- Extract key learning objectives from content
- Identify core concepts and skills
- Understand Tuesday lecture structure and activities
- Understand Thursday lab structure and activities

**Content Generation:**
- Read the module overview template
- Generate engaging 2-3 paragraph module topic introduction
- Create 5-8 specific, measurable learning objectives
- Write concise, business-focused "What You'll Learn" bullets
- Summarize Tuesday lecture activities (2-4 bullets)
- Summarize Thursday lab activities (2-4 bullets)
- Include supplemental files if provided
- Maintain consistent structure across all weeks

**Quality Assurance:**
- Ensure tone is approachable and business-focused
- Verify all placeholders are replaced
- Check that learning objectives are measurable
- Confirm activities are described concretely
- Remove all guidance comments
- Present for user review before saving

## Course-Specific Requirements

### BANA 4080 (Undergraduate)
- **Template:** Must use the provided template exactly
- **Tone:** Approachable, encouraging, practical
- **Business Context:** Strong emphasis on real-world business applications
- **Examples:** Concrete, relatable scenarios (customer data, marketing, retail)
- **Structure:** Consistent week-to-week format for Canvas

### BANA 6043 & 7075 (Graduate)
- **Tone:** More formal but still engaging
- **Business Context:** Advanced applications, research scenarios
- **Examples:** Complex business problems, industry case studies
- **Structure:** Adapt template to graduate-level expectations

## Template Structure

The overview follows this structure:

1. **Module Title**: Module X Overview: [Topic]
2. **Module Topic**: 2-3 paragraphs connecting technical content to business context
3. **Learning Objectives** (🎯): 5-8 measurable objectives with action verbs
4. **What You'll Learn This Week** (✅): Concise bullet list of key concepts/skills
5. **How You'll Practice** (🛠): Tuesday lecture + Thursday lab descriptions
6. **Lectures & Other Supplemental Files** (📂): Readings, assessments, notebooks, links

## Key Principles

**Content Extraction:**
- Learning objectives should align with chapter/lecture/lab content
- "What You'll Learn" should be concrete and specific
- Practice activities should emphasize hands-on application
- Business relevance should be clear throughout

**Writing Style:**
- Use active voice and action verbs
- Keep examples concrete and relatable
- Emphasize practical application over theory
- Maintain encouraging, supportive tone
- Connect concepts to career skills

**Quality Checks:**
- All placeholders filled with specific content
- No generic or vague statements
- Business context present throughout
- Consistent with course profile tone and standards
- User reviewed and approved before saving

## Skills Available to Agent

The agent has access to:
- **pedagogy**: General teaching principles for data science
- **content-templates**: Template structures and patterns
- **courses/bana-4080**: BANA 4080 course profile and standards
- **courses/bana-6043**: BANA 6043 course profile
- **courses/bana-7075**: BANA 7075 course profile

## Output

A complete markdown file ready for Canvas with:
- Professional module overview with business context
- Clear, measurable learning objectives (5-8 items)
- Concise "What You'll Learn" summary
- Detailed descriptions of Tuesday and Thursday activities
- Supplemental files section (TBD or populated)
- Consistent formatting and structure
- User-reviewed and approved content
- No template comments or guidance text

The overview should be immediately usable in Canvas with minimal additional editing.