The "Golden Requirements"

Regardless of the activity type, include these requirements in your prompt:

1. Pedagogical Context

• Grade level
• Subject
• Topic
• Curriculum (e.g., CAPS)
• Learning objectives
• Prior knowledge
• Intended classroom use (introduction, practice, revision, assessment)

2. User Experience (UX)

• Clear instructions
• Responsive layout
• Touch-friendly controls
• Keyboard accessibility
• Consistent navigation
• Readable fonts and colours

3. Game Mechanics

• Scoring system
• Levels or progression
• Immediate feedback
• Hints and scaffolding
• Rewards (badges, stars, confetti)
• Replayability
• Randomisation to keep each play session fresh

4. Educational Quality

• Curriculum-aligned questions
• Appropriate difficulty progression
• Meaningful feedback explaining why an answer is correct or incorrect
• Opportunities for practice and mastery
• Reflection or summary at the end

5. Technical Requirements

• Single standalone HTML file
• All HTML, CSS, and JavaScript embedded
• Vanilla HTML/CSS/JavaScript (no React, Vue, Angular, or Node.js)
• Works completely offline after download
• Responsive across desktop, tablet, and mobile
• No external assets unless explicitly requested
• Clean, well-commented code

6. Visual Design

• Modern, colourful interface
• Smooth animations (CSS or optional GSAP if internet access is acceptable)
• Consistent iconography
• Engaging transitions
• Celebration animations for success
• High contrast and accessible colour choices

7. Teacher Features

• Reset activity button
• Customisable questions or data (where practical)
• Printable answer key or summary
• Optional teacher mode for demonstrations
• Easy to modify for other topics