Use this workflow when /docs/course-description.md already exists.
2.1 Read the Course Description
Read /docs/course-description.md and analyze its contents against the quality criteria.
2.2 Course Description Quality Scoring System
Evaluate the course description using this 100-point scoring system:
| Element | Points | Criteria |
|---------|--------|----------|
| Title | 5 | Clear, descriptive course title present |
| Target Audience | 5 | Specific audience identified (e.g., "college undergraduate") |
| Prerequisites | 5 | Prerequisites listed or explicitly stated as "None" |
| Main Topics Covered | 10 | Comprehensive list of topics (ideally 5-10 topics) |
| Topics Excluded | 5 | Clear boundaries set for what's NOT covered |
| Learning Outcomes Header | 5 | Clear statement: "After this course, students will be able to..." |
| Remember Level | 10 | Multiple specific outcomes for remembering/recalling |
| Understand Level | 10 | Multiple specific outcomes for understanding/explaining |
| Apply Level | 10 | Multiple specific outcomes for applying/using |
| Analyze Level | 10 | Multiple specific outcomes for analyzing/breaking down |
| Evaluate Level | 10 | Multiple specific outcomes for evaluating/judging |
| Create Level | 10 | Multiple specific outcomes for creating/synthesizing; includes capstone ideas |
| Descriptive Context | 5 | Additional context about course importance, relevance, or value |
Scoring Guidelines:
- Award full points if element is complete and high-quality
- Award partial points if element is present but incomplete or vague
- Award 0 points if element is missing
- For Bloom's Taxonomy levels, require at least 3 specific, actionable outcomes for full points
2.3 Gap Analysis
Identify missing or weak elements:
- List each element that scored less than full points
- Explain what is missing or insufficient
- Indicate how the absence impacts learning graph generation
2.4 Improvement Suggestions
Provide specific, actionable recommendations:
- For missing elements: Suggest what should be added
- For weak elements: Provide examples of how to strengthen them
- For Bloom's Taxonomy outcomes: Recommend specific verbs and topics
- Prioritize suggestions that will have the most impact on reaching the goal of generating 200 concepts
2.5 Course Description Assessment Report
Use mkdir -p docs/learning-graph to create a learning-graph directory in the docs directory.
Generate a comprehensive quality report on the course description and write it to docs/learning-graph/course-description-assessment.md
- Overall Score: X/100
- Quality Rating:
- 90-100: Excellent - Ready for learning graph generation
- 75-89: Good - Minor improvements recommended
- 60-74: Adequate - Several improvements needed
- 40-59: Fair - Significant gaps to address
- 0-39: Poor - Major revision required
- Detailed Scoring Breakdown: Show points earned for each element
- Gap Analysis: List of missing or weak elements
- Improvement Suggestions: Prioritized recommendations
- Next Steps:
- If score β₯ 85: Ready to proceed with learning graph generation
- If score < 85: Recommend addressing specific gaps before generating learning graph
2.6 Update Course Description Metadata
In this section NAME is the name of the course taken from the course description.
QUALITY_SCORE is the score you computed for the course description.
If it does not exist, add the following yml metadata at the top of the docs/course-description.md file:
```yml
---
title: Course Description for Course NAME
description: A detailed course description for NAME including overview, topics covered and learning objectives in the format of the 2001 Bloom Taxonomy
quality_score: QUALITY_SCORE
---
```
2.7 Concept Generation Readiness
Assess whether the course description contains sufficient detail to generate 200 concepts:
- Evaluate topic breadth and depth
- Check if Bloom's Taxonomy outcomes suggest diverse concept types
- Estimate potential concept count based on current content
- Recommend additions if concept generation may fall short
Add course-description.md and and the course-description-assessment.md to mkdocs.yml Navigation
After the course-description.md file has been added to the /docs direction,
ask the user if the new file should be added to the mkdocs.yml file.
If the answer is yes, place the new file after the about.md file.
```yml
nav:
...
About: about.md
Course Description: course-description.md
...
Learning Graph:
Course Description Assessment: learning-graph/course-description-assessment.md
```
|