step 2

Author: wtobis-splunk

.github/instructions/assignments.instructions.md

@@ -0,0 +1,27 @@
+---
+applyTo: "assignments/**/*.md"
+---
+
+# Assignment Markdown Structure Guidelines
+
+All assignment markdown files should follow these guidelines:
+
+## 1. Template Usage
+
+- Assignment markdown files must follow the structure in [`templates/assignment-template.md`](../../templates/assignment-template.md).
+- The assignment must be created as a `README.md` file
+- Do not remove or skip required sections from the template.
+
+## 2. Section Guidance
+
+The section headers should reflect the structure in the template, including the exact icon usage.
+
+- **Title**: Replace `[Assignment Title]` with a short, descriptive name (e.g., `Python Basics`, `Loops and Conditionals`, `Functions and Modules`).
+- **Objective**: Write 1-2 sentences summarizing what the student will learn or accomplish. Focus on the main skills or concepts.
+- **Tasks**: For each task:
+   - Use a specific, action-oriented task name
+   - In the Description, clearly state what the student must do.
+   - In Requirements, use bullet points to list the expected outcomes or features. Be specific and measurable
+   - Provide example input/output in code blocks if helpful.
+
+Do not include extra sections unless explicitly specified.

assignments/games-in-python/README.md

@@ -1,19 +1,45 @@
 
-# 🎮 Hangman Game Challenge
 
-Build the classic word-guessing game using Python strings, loops, and user input.
+# 🎮 Assignment: Hangman Game Challenge
 
-## � What You'll Build
+## 🎯 Objective
 
-Create a Hangman game where players guess letters to reveal a hidden word before running out of attempts.
+Build a classic Hangman game in Python to practice string manipulation, loops, conditionals, and user input. You will learn how to manage game state and interact with users through the console.
 
-**Skills practiced:** String manipulation, loops, conditionals, random selection
+## 📝 Tasks
 
-## ✅ Must Have's
+### 🛠️	Create the Hangman Game
 
-Your game must:
-- Randomly select words from a predefined list
-- Accept letter guesses and show current progress (_ _ _ format)
-- Track incorrect guesses remaining
-- End when word is guessed or attempts exhausted
-- Display win/lose messages
+#### Description
+Develop a Hangman game where the player tries to guess a hidden word by suggesting letters within a limited number of attempts.
+
+#### Requirements
+Completed program should:
+
+- Randomly select a word from a predefined list
+- Accept letter guesses from the user and display current progress (e.g., `_ a _ _ m a n`)
+- Track and display the number of incorrect guesses remaining
+- End the game when the word is fully guessed or attempts run out
+- Show a win message if the player guesses the word, or a lose message if they run out of attempts
+
+**Example:**
+```python
+Word: _ a _ _ m a n
+Guesses left: 3
+Guess a letter: g
+Word: g a _ _ m a n
+Guesses left: 3
+...
+```
+
+### 🛠️	Enhance User Experience
+
+#### Description
+Add features to make the game more engaging and user-friendly.
+
+#### Requirements
+Completed program should:
+
+- Prevent repeated guesses of the same letter
+- Display all guessed letters so far
+- Handle invalid input gracefully (e.g., non-letter characters)