Skip to main content

Phase 6: Polish & Integration

By Amr

Final phase of quest development - content filling, network linking, and validation

Estimated reading time: 8 minutes

Edit on GitHub

🎯 Phase 6: Polish & Integration

Date Started: December 20, 2025 Phase: 6 of 6 (Final Phase) Focus: Content development, network linking, and quality assurance

📊 Current State Summary

Validation Results (December 20, 2025)

Metric Count
Total Quest Files ~131
Errors (Broken Dependencies) 165
Warnings 555
Orphaned Quests ~100+

Issue Categories

  1. Broken Dependencies (165 errors)
    • Placeholder links referencing non-existent quests
    • Template placeholder paths (e.g., /quests/level-XXXX-side-quest-1/)
    • Missing prerequisite quests
  2. Invalid Frontmatter (warnings)
    • Invalid quest_type values (e.g., “Integration Mastery”, “tool-mastery”)
    • Invalid difficulty formats
    • Invalid level formats (e.g., “001” instead of “0001”, “codex”)
    • Missing frontmatter in documentation files
  3. Orphaned Quests (~100)
    • Quests not referenced by any other quest
    • Need to be integrated into the quest network

🎯 Phase 6 Objectives

Primary Goals

  1. Fix Frontmatter Validation Errors
    • Standardize quest_type values
    • Fix difficulty format inconsistencies
    • Correct level format issues
    • Add frontmatter to documentation files
  2. Build Quest Network Connections
    • Remove placeholder dependency links
    • Create real quest relationships
    • Connect orphaned quests to the network
    • Build complete dependency graph
  3. Fill Placeholder Content
    • Write quest objectives
    • Create step-by-step instructions
    • Add code examples and demonstrations
    • Set draft: false for completed quests
  4. Update Documentation
    • Update home.md overworld map
    • Update main README.md
    • Update level READMEs with quest listings
    • Create skill tree visualizations

📋 Phase 6 Task Checklist

Week 1: Frontmatter Cleanup

Task 1.1: Fix Invalid quest_type Values

  • jekyll-mermaid-integration-quest.md - Change “Integration Mastery” to “main_quest”
  • testing-quests-with-recurrisive-questing.md - Change “language-learning” to “side_quest”
  • docker-mastery-example.md - Change “tool-mastery” to “main_quest”
  • github-pages-portal.md - Change “main” to “main_quest”
  • docs-in-a-row.md - Change “Project Building” to “main_quest”

Task 1.2: Fix Invalid difficulty Values

  • docs-in-a-row.md - Change “🟡 Intermediate” to “🟡 Medium”
  • edgar.md - Change “🟡 Medium → ⚔️ Epic” to single value

Task 1.3: Fix Invalid level Formats

  • github-pages-portal.md - Change “001” to “0001”
  • codex/world_map.md - Keep as “codex” but mark as reference
  • codex/glossary.md - Keep as “codex” but mark as reference
  • codex/*.md - Update all codex files with proper reference handling

Task 1.4: Add Frontmatter to Documentation

  • PHASE2_COMPLETE.md - Add basic frontmatter
  • PHASE3_COMPLETE.md - Add basic frontmatter
  • VALIDATION_FIXES_SUMMARY.md - Add basic frontmatter
  • codex/QUEST_ORGANIZATION_SUMMARY.md - Add basic frontmatter

Week 2: Dependency Cleanup

Task 2.1: Remove Placeholder Dependencies

Remove template placeholder links from all generated quests:

  • Remove /quests/level-XXXX-side-quest-1/ placeholders
  • Remove /quests/level-XXXX-side-quest-2/ placeholders
  • Remove /quests/level-XXXX-alternative-path/ placeholders
  • Remove /quests/level-XXXX-continuation/ placeholders

Task 2.2: Fix Specific Broken Dependencies

Level 0000:

  • Fix stating-the-stats.md dependencies
  • Fix hello-noob.md child_quests and sequel_quests

Level 0001:

  • Fix liquid-templating.md prerequisites
  • Fix jekyll-fundamentals.md prerequisites
  • Fix github-pages-basics.md prerequisites
  • Fix yaml-configuration.md unlocks

Level 0010:

  • Fix terminal-artificer-frontend-building.md parent and parallel quests
  • Fix prompt-engineering.md child and sequel quests

Level 0011:

  • Fix github-hidden-gem-code-search-quest.md references
  • Fix prompt-crystal-mastery-vscode-copilot-quest.md references

Week 3: Network Building

Build required_quests and unlocks_quests for level progression:

Level 0000 → Level 0001 → Level 0010 → Level 0011
    ↓           ↓            ↓            ↓
Level 0100 → Level 0101 → Level 0110 → Level 0111
    ↓           ↓            ↓            ↓
Level 1000 → Level 1001 → Level 1010 → Level 1011
    ↓           ↓            ↓            ↓
Level 1100 → Level 1101 → Level 1110 → Level 1111

Task 3.2: Connect Orphaned Quests

  • Review all orphaned quests
  • Determine appropriate parent/sibling relationships
  • Add to quest network via frontmatter

Task 3.3: Build Quest Maps

  • Create Mermaid diagrams for each level
  • Update level READMEs with quest maps
  • Update home.md overworld visualization

Week 4: Content Development

Task 4.1: Priority Content (High-Traffic Entry Points)

Foundation Quests (Level 0000):

  • hello-noob.md - Full content
  • begin-your-it-journey.md - Full content
  • terminal-fundamentals.md - Full content
  • git-basics.md - Full content

Web Fundamentals (Level 0001):

  • github-pages-basics.md - Full content
  • jekyll-fundamentals.md - Full content
  • markdown-mastery.md - Full content

Task 4.2: Update Quest Status

For each completed quest:

  • Set draft: false
  • Verify all sections complete
  • Test code examples
  • Validate internal links

Week 5: Documentation & Validation

Task 5.1: Update Home Page

  • Update home.md with complete quest listings
  • Add quest statistics
  • Create interactive overworld map
  • Add learning path recommendations

Task 5.2: Update Main README

  • Add quest system overview
  • Link to level READMEs
  • Add contributor guide for quests
  • Update project statistics

Task 5.3: Final Validation

  • Run quest network validator
  • Fix any remaining errors
  • Verify all links work
  • Test Jekyll build

🔧 Automation Scripts Needed

Script 1: Remove Placeholder Dependencies

#!/bin/bash
# scripts/cleanup-placeholder-deps.sh
# Removes template placeholder dependencies from quest frontmatter

QUEST_DIR="pages/_quests"

find "$QUEST_DIR" -name "*.md" -exec sed -i '' \
  -e '/level-XXXX-side-quest-1/d' \
  -e '/level-XXXX-side-quest-2/d' \
  -e '/level-XXXX-alternative-path/d' \
  -e '/level-XXXX-continuation/d' \
  {} \;

Script 2: Fix Quest Type Values

#!/usr/bin/env python3
# scripts/fix-quest-types.py
# Standardizes quest_type values in frontmatter

VALID_QUEST_TYPES = ['main_quest', 'side_quest', 'epic_quest', 'reference']

REPLACEMENTS = {
    'Integration Mastery': 'main_quest',
    'language-learning': 'side_quest',
    'tool-mastery': 'main_quest',
    'main': 'main_quest',
    'Project Building': 'main_quest',
}

Script 3: Generate Network Report

#!/bin/bash
# scripts/generate-network-report.sh
# Generates a summary of quest network connections

python3 scripts/validate-quest-network.py 2>&1 | \
  grep -E "(Total|Errors|Warnings|Orphaned)" > \
  pages/_quests/NETWORK_REPORT.md

📊 Success Criteria

Phase 6 Complete When:

  1. Zero Validation Errors
    • All frontmatter fields valid
    • All dependencies resolve
    • All permalinks correct
  2. No Orphaned Quests
    • Every quest connected to network
    • Clear progression paths defined
    • Parallel quest options available
  3. Entry Point Quests Complete
    • Level 0000 foundation quests have full content
    • Learning paths clearly defined
    • New users can start learning immediately
  4. Documentation Updated
    • home.md reflects current state
    • All level READMEs complete
    • Main README has quest overview
  5. Build Passes
    • Jekyll builds without errors
    • All internal links work
    • Site navigation functions correctly

📈 Progress Tracking

Task Category Total Complete Remaining
Frontmatter Fixes 15 0 15
Dependency Cleanup 50+ 0 50+
Network Building 16 levels 0 16
Content Development 10 priority 0 10
Documentation 5 docs 0 5

Overall Phase 6 Progress: 0%

🗓️ Timeline

Week Focus Area Deliverables
Week 1 Frontmatter Cleanup All frontmatter errors fixed
Week 2 Dependency Cleanup Placeholder deps removed
Week 3 Network Building Quest connections established
Week 4 Content Development Entry quests completed
Week 5 Documentation Final validation passes

Estimated Completion: January 2026

📚 Related Documentation

Status: 🚀 Phase 6 In Progress

We value your privacy

This website uses cookies and similar technologies to enhance your browsing experience, analyze traffic, and provide personalized content. Learn more in our Privacy Policy.