Skip to content

Phase 1 Infrastructure - Quick Reference

✅ Completed Infrastructure

Templates Created

  • ✅ pages/_quests/templates/main-quest-template.md - Comprehensive main quest template
  • ✅ pages/_quests/templates/level-readme-template.md - Level directory README template
  • ✅ pages/_quests/templates/README.md - Templates documentation

Scripts Created

  • ✅ scripts/quest/generate-placeholder-quest.sh - Automated quest generation
  • ✅ scripts/quest/validate-quest-network.py - Quest network validation
  • ✅ Both scripts made executable

Documentation Created

  • ✅ pages/_quests/QUEST_BUILD_PLAN.md - Complete build plan for all 97+ quests
  • ✅ Templates usage guide with examples
  • ✅ Validation checklist

🚀 Quick Start Commands

Generate a New Quest

# Basic usage
./scripts/quest/generate-placeholder-quest.sh 0110 database-fundamentals "Database Design Fundamentals"

# With options
./scripts/quest/generate-placeholder-quest.sh 0110 sql-mastery "SQL Sorcery" \
  --difficulty medium \
  --time "45-60 minutes" \
  --tech sql \
  --skill data-engineering

# Preview without creating (dry run)
./scripts/quest/generate-placeholder-quest.sh 1101 ml-basics "ML Fundamentals" --dry-run

Validate Quest Network

# Run validation
python3 scripts/quest/validate-quest-network.py

# Should output:
# - Quest statistics
# - Errors (if any)
# - Warnings (if any)
# - Overall pass/fail status

Create New Level Directory

# Create directory
mkdir -p pages/_quests/0110

# Copy level README template
cp pages/_quests/templates/level-readme-template.md pages/_quests/0110/README.md

# Edit the README to customize for the level

📋 Next Steps - Phase 2

Apprentice Tier Completion (Weeks 2-3)

Level 0000 - Foundation (3 quests needed)

./scripts/quest/generate-placeholder-quest.sh 0000 file-system-navigation "File System Navigation" \
  --difficulty easy --time "20-30 minutes" --tech bash --skill fundamentals

./scripts/quest/generate-placeholder-quest.sh 0000 package-manager-mastery "Package Manager Mastery" \
  --difficulty easy --time "30-40 minutes" --tech package-managers --skill fundamentals

./scripts/quest/generate-placeholder-quest.sh 0000 environment-variables "Environment Variables" \
  --difficulty easy --time "25-35 minutes" --tech bash --skill fundamentals

Level 0001 - Web Fundamentals (5 quests needed)

./scripts/quest/generate-placeholder-quest.sh 0001 html-foundations "HTML Foundations" \
  --difficulty easy --time "40-50 minutes" --tech html --skill frontend

./scripts/quest/generate-placeholder-quest.sh 0001 css-styling "CSS Styling" \
  --difficulty easy --time "45-60 minutes" --tech css --skill frontend

./scripts/quest/generate-placeholder-quest.sh 0001 javascript-basics "JavaScript Basics" \
  --difficulty medium --time "60-90 minutes" --tech javascript --skill frontend

./scripts/quest/generate-placeholder-quest.sh 0001 responsive-design "Responsive Design" \
  --difficulty medium --time "50-70 minutes" --tech css --skill frontend

./scripts/quest/generate-placeholder-quest.sh 0001 static-site-generators "Static Site Generators" \
  --difficulty medium --time "45-60 minutes" --tech jekyll --skill frontend

Level 0010 - Terminal Mastery (4 quests needed)

./scripts/quest/generate-placeholder-quest.sh 0010 advanced-shell-scripting "Advanced Shell Scripting" \
  --difficulty medium --time "60-90 minutes" --tech bash --skill terminal

./scripts/quest/generate-placeholder-quest.sh 0010 regular-expressions "Regular Expressions" \
  --difficulty medium --time "45-60 minutes" --tech regex --skill terminal

./scripts/quest/generate-placeholder-quest.sh 0010 terminal-multiplexing "Terminal Multiplexing" \
  --difficulty medium --time "40-50 minutes" --tech tmux --skill terminal

./scripts/quest/generate-placeholder-quest.sh 0010 ssh-remote-connections "SSH & Remote Connections" \
  --difficulty medium --time "50-60 minutes" --tech ssh --skill terminal

Level 0011 - AI-Assisted Dev (5 quests needed)

./scripts/quest/generate-placeholder-quest.sh 0011 chatgpt-developers "ChatGPT for Developers" \
  --difficulty easy --time "30-45 minutes" --tech ai --skill ai-assisted

./scripts/quest/generate-placeholder-quest.sh 0011 claude-coding "Claude for Coding" \
  --difficulty easy --time "30-45 minutes" --tech ai --skill ai-assisted

./scripts/quest/generate-placeholder-quest.sh 0011 ai-code-review "AI Code Review" \
  --difficulty medium --time "40-50 minutes" --tech ai --skill ai-assisted

./scripts/quest/generate-placeholder-quest.sh 0011 prompt-engineering-code "Prompt Engineering for Code" \
  --difficulty medium --time "45-60 minutes" --tech ai --skill ai-assisted

./scripts/quest/generate-placeholder-quest.sh 0011 ai-powered-debugging "AI-Powered Debugging" \
  --difficulty medium --time "50-70 minutes" --tech ai --skill ai-assisted

🔍 Validation Workflow

After creating quests: 1. Generate quest files 2. Edit content in generated markdown files 3. Update level README 4. Run validation: python3 scripts/quest/validate-quest-network.py 5. Fix any errors or warnings 6. Set draft: false when ready 7. Commit with conventional format: feat(quest): add [quest-name]

📊 Progress Tracking

Phase 1 Completion Status

  • Quest templates created
  • Level README template created
  • Quest generation script
  • Validation script
  • Documentation complete
  • Quest hierarchy documentation (in progress)

Ready for Phase 2

All infrastructure is in place to begin creating placeholder quests!

🎯 Testing the Infrastructure

Test Quest Generation

# Test with a real example
./scripts/quest/generate-placeholder-quest.sh 0000 test-quest "Test Quest" \
  --difficulty easy \
  --time "15 minutes" \
  --tech test \
  --skill test

# Check if file was created
ls -la pages/_quests/0000/test-quest.md

# View the generated content
cat pages/_quests/0000/test-quest.md

# Clean up test
rm pages/_quests/0000/test-quest.md

Test Validation Script

# Run validator on current quest network
python3 scripts/quest/validate-quest-network.py

# Check exit code
echo $?
# 0 = success, 1 = validation failed

📚 Reference Documentation

  • Complete Build Plan: pages/_quests/QUEST_BUILD_PLAN.md
  • Templates Guide: pages/_quests/templates/README.md
  • Quest Instructions: .github/instructions/quest.instructions.md
  • Main README: pages/_quests/README.md
  • Overworld Map: pages/_quests/home.md

🤝 Getting Help

If you encounter issues: 1. Check template README: pages/_quests/templates/README.md 2. Review build plan: pages/_quests/QUEST_BUILD_PLAN.md 3. Run validation: python3 scripts/quest/validate-quest-network.py 4. Check quest instructions: .github/instructions/quest.instructions.md

Phase 1 Status: ✅ Complete Ready for Phase 2: Yes Next Action: Begin creating placeholder quests for Apprentice Tier (Levels 0000-0011)