Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased

Added

• /tags/ and /categories/ index pages — every tag and category chip on the site linked to /tags/#<slug> or /categories/#<slug> (2,406 links), and both pages were 404. pages/tags.md and pages/categories.md now render one anchored section per term via _includes/content/taxonomy-index.html: plain Liquid, GitHub Pages-safe, one sorted pass, under 1 s of build time. Collections get a tag section too, because the theme’s collection badge links there
• Bashcrawl quest hub rewrite — pages/_quests/0000/bashcrawl/README.md fully rewritten with Mermaid dungeon map, chapter guide table, quick-start command, and play-mode reference; links to all 10 side-quests
• Bashcrawl launcher script v3.0.0 — pages/_quests/0000/bashcrawl/bash_crawl.sh with tutorial/agent subcommands, --quest <chamber> flag, and 7-option interactive menu
• 10 Bashcrawl side-quests — Full dungeon coverage: entrance, workshop, cellar, armoury, chamber, hidden-chapel, vault, scrap, rift, and agent-mode; all score 92 % on the quest validator (0 errors, 0 warnings)
• Quest network graph data — assets/data/quest-network.json and _data/quests/network.yml generated by scripts/quest/build-quest-network.py (150 nodes, 63 edges)
• Quest dependency graph include — _includes/content/quest-graph.html: JS-driven Mermaid flowchart, filterable by level ({% include content/quest-graph.html level="0001" %})
• Quest backlinks include — _includes/content/quest-backlinks.html: lists quests that depend on the current page, loaded from the quest network JSON
• Quest network builder script — scripts/quest/build-quest-network.py scans all quest frontmatter and produces the node/edge JSON and YAML files
• Quest permalink audit prompt — .github/prompts/quest-permalink-audit.prompt.md for auditing and repairing quest permalink conventions

• Quest permalink migration script — scripts/quest/migrate-permalinks.py batch-migrates all quest files to canonical permalink format

• Canonical frontmatter reference — .github/FRONTMATTER.md documents the required schema for .prompt.md and .instructions.md files
• Posts authoring standards — pages/_posts/README.md documents directory layout, file naming, required frontmatter, validation tooling, link hygiene, draft lifecycle, and the cleanup metrics history (#239)
• Posts CI workflow — .github/workflows/posts-markdown-lint.yml runs markdownlint-cli2 on PRs touching pages/_posts/**; supports manual --fix mode (#239)
• Posts-scoped lint config — pages/_posts/.markdownlint.json extends repo-root config, disabling MD025/MD036/MD040/MD060 and widening MD033 allowed elements for legitimate blog-content patterns (#239)
• Frontmatter auto-fix script — scripts/validation/fix-frontmatter.py idempotently fills missing date (from filename), categories (from folder), and description (from first prose paragraph) (#239)
• External link-rot baseline — link-check-results/posts-external-baseline.md catalogs 18 known-broken external links with status and remediation strategy (#239)

• AI-generated preview images — 11 DALL-E previews under assets/images/previews/ for devops/ posts that previously had empty preview: fields (#239)

• New Post: foundational-ci-cd-pipelines-github-vscode-extensions.md (pages/_posts/devops/) - Tutorial on building production-ready CI/CD pipelines for VS Code extensions with GitHub Actions, covering linting, testing, building, and automated Marketplace publishing
• Lychee Configuration (.lychee.toml) - Declarative configuration for lychee link checker with cross-run caching, performance tuning, and URL exclusions
• Broken Links Baseline (link-check-results/broken_links_baseline.json) - Baseline of known broken links for delta-based AI analysis

• Preview Images - Generated preview banner for the new CI/CD pipelines blog post (original + enhanced variant)

• New Post: terminal-bash-finance-accounting.md (pages/_posts/business/) - Comprehensive blog post targeting finance and accounting professionals, teaching terminal and bash scripting through relatable spreadsheet analogies. Includes real-world month-end automation script, Excel-to-Bash translation table, and links to Terminal Fundamentals, Bashcrawl, and Bashrun quests.

• Resource Codex (pages/_quests/0000/bashcrawl/README.md) - Added links to the Bash Cheatsheet and Complete BASH Reference in the bashcrawl quest.

• Practical Application Section (pages/_docs/terminal/bash-complete-reference.md) - Added links to interactive quests (bashcrawl and bash-run) to practice bash commands.

• Complete BASH Reference (pages/_docs/terminal/bash-complete-reference.md) - Exhaustive 4600+ line GNU Bash reference covering built-in commands, parameter expansion, arrays, string manipulation, arithmetic, conditionals, loops, functions, process control, text processing, networking, and advanced scripting techniques
• Docs navigation entry (_data/navigation/docs.yml) - Added “Complete BASH Reference” link under Terminal section

• Cursor command (.cursor/commands/commit-publish.md) - Workflow command aligned with IT-Journey commit/publish standards

• Quest Registry (scripts/quest/quest_registry.py) - New single source of truth for quest level metadata including level order, tier groupings, canonical metadata, and permalink utilities
• Git Basics Quest Enhancement (pages/_quests/0000/git-basics.md) - Major content expansion:
  • Added Mermaid diagrams: quest network position, three areas flowchart, branch lifecycle, local-remote sync, undo decision flowchart, and full quest flow
  • Added Chapter 4: “Undoing Mistakes — The Time-Travel Spells” covering restore, reset, and revert
  • Added checkpoints with validation commands and knowledge checks for Chapters 1–3
  • Replaced generic challenges with structured Implementation Challenges (Chronicle Keeper, Branch Weaver, Remote Ranger)
  • Added Boss Battle: “The Git Gauntlet” — a multi-phase capstone exercise with verification script
  • Expanded Quest Rewards with achievement badges, skills unlocked, and journey progress
  • Enhanced References section with categorized resources (documentation, interactive, quick references)
• Quest Validation CI Workflow (quest-validation.yml) - New GitHub Actions workflow for automated quest validation on PRs and pushes

• Full Audit Report (test/quest-validator/full-audit-report.json) - Comprehensive quest audit results (136 quests, 0 errors, 93.9% avg score)

• _includes/components/powered-by.html - New reusable component for displaying “Powered by” technology cards
  • Bootstrap 5 responsive card grid (1 column mobile, 3 columns desktop)
  • Graceful handling of empty/null version numbers
  • Dynamic Bootstrap icons support
• _includes/components/README.md - Documentation for the new components directory
• site.resources configuration block - External resource links for GitHub, RubyGems, Docker Hub
• scripts/quest/update-quest-home.py - Generate and inject an auto-updated quest index into pages/_quests/home.md.
• _data/navigation/README.md - New documentation for navigation schema with zer0-mistakes v0.17+ compatibility notes

Phase 5: Master Tier Quest Generation (Levels 1100-1111)

• 32 New Quests: Complete Master Tier quest generation across 4 levels
  • Level 1100 - Data Engineering (5 new quests):
    • apache-spark.md - Big Data Processing with Spark
    • data-quality.md - Data Quality & Validation
    • data-warehousing.md - Data Warehouse Design
    • etl-pipeline-design.md - ETL Pipeline Architecture
    • stream-processing.md - Real-time Data Streams
  • Level 1101 - Machine Learning & AI (8 new quests):
    • ai-ethics.md - Responsible AI Development
    • computer-vision.md - Image & Video Analysis
    • deep-learning-frameworks.md - TensorFlow & PyTorch
    • ml-fundamentals.md - Machine Learning Basics
    • mlops.md - ML Operations & Deployment
    • natural-language-processing.md - NLP Fundamentals
    • neural-networks.md - Deep Learning Architecture
    • python-data-science.md - Python for Data Science
  • Level 1110 - Architecture & Design (7 new quests):
    • api-gateway-patterns.md - API Gateway Design
    • design-patterns.md - Software Design Patterns
    • domain-driven-design.md - DDD Principles
    • event-driven-design.md - Event-Driven Architecture
    • microservices-architecture.md - Microservices Design
    • scaling-strategies.md - Horizontal & Vertical Scaling
    • system-design-interviews.md - System Design Practice
  • Level 1111 - Leadership & Innovation (8 new quests):
    • architecture-reviews.md - Technical Review Process
    • building-technical-communities.md - Community Building
    • career-advancement.md - IT Career Growth
    • innovation-rnd.md - R&D Leadership
    • mentorship-programs.md - Mentoring Skills
    • open-source-contribution.md - OSS Contribution
    • tech-speaking-writing.md - Technical Communication
    • technical-leadership.md - Tech Lead Skills

Quest Validation Improvements

• Quest Template Update: Added fmContentType: quest field to .frontmatter/templates/quests.md
• Validation Rules Documentation: Added comprehensive validation rules section to .github/instructions/quest.instructions.md including:
  • Required frontmatter fields table
  • Enhanced fields table
  • Content structure validation requirements
  • Difficulty level guidelines
  • Binary level system reference
  • Validation commands and score thresholds
  • Common issues and fixes guide

Phase 4: Expert Tier Quest Generation (Phases 1-4 Complete)

• 72 New Placeholder Quests: Complete quest generation across 4 phases
  • Phase 2 - Apprentice Tier (Levels 0000-0011): 17 quests
    • Level 0000: terminal-fundamentals.md, git-basics.md, markdown-mastery.md
    • Level 0001: github-pages-basics.md, jekyll-fundamentals.md, liquid-templating.md, yaml-configuration.md, git-workflow-mastery.md
    • Level 0010: advanced-markdown.md, css-styling-basics.md, javascript-fundamentals.md, bootstrap-framework.md
    • Level 0011: advanced-git-workflows.md, jekyll-plugins.md, seo-optimization.md, analytics-integration.md, custom-domains.md
  • Phase 3 - Journeyman Tier (Levels 0100-0111): 36 quests
    • Level 0100: container-fundamentals.md, docker-compose-orchestration.md
    • Level 0101: 8 CI/CD quests (cicd-fundamentals.md, github-actions-basics.md, testing-integration.md, etc.)
    • Level 0110 (NEW): 8 database quests (database-fundamentals.md, sql-mastery.md, data-modeling.md, etc.)
    • Level 0111 (NEW): 7 API quests (api-fundamentals.md, rest-principles.md, api-authentication.md, etc.)
  • Phase 4 - Expert Tier (Levels 1000-1011): 19 quests
    • Level 1000 (NEW): 6 cloud quests (cloud-computing-fundamentals.md, aws-essentials.md, infrastructure-as-code.md)
    • Level 1001 (NEW): 4 Kubernetes quests (kubernetes-fundamentals.md, k8s-pods-workloads.md, k8s-services-networking.md, k8s-config-secrets.md)
    • Level 1010: 5 monitoring quests (monitoring-fundamentals.md, prometheus-grafana.md, elk-stack.md, distributed-tracing.md, alerting-systems.md)
    • Level 1011: 5 security quests (security-fundamentals.md, threat-modeling.md, secure-coding.md, penetration-testing.md, compliance-standards.md)

Quest Infrastructure & Automation

• Quest Generation Script: scripts/generate-placeholder-quest.sh - Automated quest file generation from templates
• Quest Validator: scripts/validate-quest-network.py - Python-based frontmatter and network validation
• Quest Tools Wrapper: scripts/quest-tools.sh - Docker wrapper for validation tools
• Quest Templates: pages/_quests/templates/ directory with main-quest-template.md and level-readme-template.md
• Docker Validation Environment: Multi-service setup in docker-compose.yml with quest-validator and quest-network-validator services
• Python Dependencies: scripts/requirements.txt for PyYAML and validation tools

Quest Documentation

• QUEST_BUILD_PLAN.md: 14-week roadmap for complete quest system (6 phases, 97 quests)
• PHASE1_COMPLETE.md: Infrastructure phase documentation
• PHASE2_COMPLETE.md: Apprentice Tier (17 quests) completion summary
• PHASE3_COMPLETE.md: Journeyman Tier (36 quests) completion summary
• PHASE4_COMPLETE.md: Expert Tier (19 quests) completion summary with technical coverage breakdown
• VALIDATION_FIXES_SUMMARY.md: Documentation of 44 frontmatter validation fixes across 58 original quests

Other Additions

• Preview images for various quests in assets/images/previews/
• README.md files: Added README.md to all level directories (0000, 0001, 0010, 0011, 0100, 0101, 1010, 1011, 1100, 1110)
• inventory/README.md: New directory for learner progress tracking (future feature)
• tools/README.md: Collection documentation for cross-level tool quests
• Directory Structure section: Added comprehensive structure documentation to main quests README.md
• Binary Level System table: Complete 16-level table (0000-1111) with status indicators and reserved levels

Changed

• Normalized quest permalinks — All 173 quest files migrated to canonical /quests/XXXX/[side-quests/]slug/ hierarchy; old URLs preserved in redirect_from: for backward compatibility
• Quest validator updated — test/quest-validator/quest_validator.py now enforces the canonical permalink regex and validates dir-level consistency
• Quest CI workflow updated — full-audit job now regenerates and drift-checks quest-network.json on every scheduled or manual run

• AGENTS.md and copilot-instructions.md updated — Quest permalink convention documented as canonical gotcha with migration commands

• Level 0000 README — Updated Bashcrawl cross-reference link from stale /quests/0000/bashcrawl/ to canonical /quests/0000/bashcrawl/

• .github/ instructions and prompts slashed — .github/instructions/*.md and .github/prompts/*.md compressed ~70%: removed generic AI-padding, duplicate examples, and motivational filler; kept only actionable rules and one canonical example per concept. All files tightened to ≤200 lines.
• .github/instructions/DONTREADME.md removed — 235-line fantasy filler with no inbound references; superseded by tightened instruction set.
• Posts mass cleanup (8-phase, #239):
  • Files: 124 → 86 (+ 34 stub/draft posts moved to pages/_drafts/)
  • Frontmatter valid: 73/124 (59%) → 86/86 (100%)
  • Frontmatter errors: 102 → 0
  • SEO score (avg): 54.5 → 65.5
  • Markdownlint issues: 1,790 → 21 (98.8% reduction)
  • Internal links: 0/287 broken (verified via lychee --offline --base _site)
• Posts directory layout — All posts now reside in 13 kebab-case category folders (e.g. ai-machine-learning/, creative-experimental/); previous folder names with spaces and & renamed via git mv to preserve history

• Frontmatter normalized — Auto-filled date, categories, and description across the collection per posts.instructions.md schema

• Layout Rename: journals → articles - Renamed layout references across all post instructions, prompt templates, SEO templates, documentation standards, architecture docs, and quest content for consistency with _config.yml default
• Dev Performance: Incremental Builds (_config_dev.yml) - Added incremental build support, reduced plugin set, disabled preview image generation during development for faster iteration
• Docker Dev Environment (docker-compose.yml) - Added --incremental flag to Jekyll serve command and persistent jekyll-cache volume for faster rebuilds
• Preview Generator (_plugins/preview_generator.rb) - Skip preview generation during incremental builds to avoid full rebuild overhead
• Quest YAML Formatting (pages/_quests/0101/jekyll-quest-tracking.md) - Normalized YAML indentation and quoting for consistency

• Post Metadata (pages/_posts/devops/2026-03-07-foundational-ci-cd-pipelines-github-vscode-extensions.md) - Updated lastmod, removed duplicate layout field

• Link Health Guardian v3.0 (scripts/validation/link-checker.py) - Major rewrite:
  • Dual engine support: lychee (primary, via .lychee.toml) or curl (fallback)
  • Persistent caching via .lycheecache for cross-run URL skip
  • Incremental --changed-only mode for fast PR checks
  • Delta-only AI analysis (only new broken links sent to AI)
  • Multi-provider AI support (OpenAI, Anthropic, or none via --ai-provider)
  • --include-site flag for opt-in _site/ scanning
  • Timing instrumentation for performance tracking
• Link Checker Workflow (.github/workflows/link-checker.yml) - Simplified and optimized:
  • Added pull_request trigger with fast incremental check (changed files only, no AI)
  • Removed redundant Friday schedule (keep Monday only)
  • Added AI provider selection (OpenAI, Anthropic, or none)
  • Removed obsolete input options (timeout, ai-analysis toggle)
• Preview Image Generator Plugin (_plugins/preview_image_generator.rb) - Fixed has_preview? to reject non-path strings (text descriptions) and added multi-candidate file path checking for both absolute and relative paths
• Preview Image Script (scripts/generation/generate-preview-images.sh) - Added --enhance mode for AI-powered image improvement with configurable model, fidelity, and format options; fixed PROJECT_ROOT path resolution
• Scripts README (scripts/README.md) - Updated Link Health Guardian documentation for v3.0 features, configuration options, and dual-engine architecture

• Guardian Script (test/hyperlink-guardian/scripts/guardian.sh) - Marked as deprecated in favor of link-checker.py --engine curl

• Consolidated Bash Cheatsheets (pages/_notes/cheetsheets/bash-cheatsheet.md) - Merged duplicate bash cheatsheets into a single file and updated frontmatter with related quests.
• Bashcrawl Quest Enhancement (pages/_quests/0000/bashcrawl/README.md) - Upgraded to a main quest with enhanced frontmatter (level: '0000', quest_type: main_quest), added quest dependencies, and updated the setup guide to clone from bamr87/bashcrawl.

• Bash-run Side Quest (pages/_quests/0000/bash-run.md) - Updated frontmatter to correctly point to bashcrawl as its parent/required quest and added resource links.

• Quests home page (pages/_quests/home.md) - Added mermaid: true front matter to enable Mermaid diagram rendering

• Docs library index (pages/_docs/index.md) - Added Terminal section listing available reference guides

• CI/CD Token Standardization - Renamed PAT_TOKEN secret to GITHUB_PAT across all workflows and documentation for consistency:
  • ai-content-review.yml — 3 references updated
  • dependency-checker.yml — 2 references updated (also switched checkout token from GITHUB_TOKEN to GITHUB_PAT for write permissions)
  • frontmatter-validation.yml — 2 references updated
  • action-triggers.md quest — 1 reference updated
  • Blog posts updated to reflect new token naming
  • PRD.md — Issue descriptions updated
• Quest Validator v2.0.0 (test/quest-validator/quest_validator.py) - Major upgrade:
  • Added placeholder content detection (brackets, TODO/TBD, lorem ipsum)
  • Added --exclude-drafts and --fail-threshold CLI options
  • Enhanced permalink validation supporting multiple valid patterns
  • Improved scoring with complete vs placeholder quest classification
  • Added JSON report output support for CI integration
• Placeholder Dependency Remover (scripts/quest/remove-placeholder-deps.py) - Improved regex patterns to dynamically match any level (e.g., level-\d{4}-side-quest-\d+) instead of hardcoded level lists
• Quest Frontmatter Enhancements (93 quest files across all levels) - Comprehensive frontmatter improvements:
  • Level 0000 quests: Added quest_line, quest_arc, quest_dependencies, quest_relationships, learning_paths, structured prerequisites (knowledge/system requirements), structured rewards (badges/skills/progression points), expanded quest objectives and content sections
  • Levels 0001–1111 quests: Removed placeholder dependency values (side-quest-1, alternative-path, continuation) replaced with empty arrays for accurate relationship tracking
• _config.yml - Updated powered_by configuration:
  • Removed Algolia (not currently in use)
  • Updated jQuery version to 3.7
  • Updated MathJax version to 3.2
  • Added Docker to powered_by list
  • Fixed jQuery capitalization

• pages/_quests/home.md - Added auto-generated quest index section with markers and refreshed lastmod.

• Quest README: Updated pages/_quests/README.md:
  • Removed “Coming Soon” labels from levels 1101 and 1111
  • Added links to all new quests in levels 1100-1111
  • Updated quest counts and completion status

Quest System Status Update

• Total Quests: 162 quests (130 previous + 32 new)
• Levels Complete: 16 of 16 levels (100%) ✅
• Phases Complete: 5 of 6 phases (83%)
  • Phase 5: Master Tier ✅ (NEW)

Quest Frontmatter Standardization

• 44 Frontmatter Validation Fixes: Systematic fixes across 58 original quest files
  • Added missing level field to all quests following binary format (0000-1111)
  • Added missing quest_type field (main_quest, side_quest, bonus_quest, epic_quest, reference)
  • Added missing difficulty field (🟢 Easy, 🟡 Medium, 🔴 Hard, ⚔️ Epic, 📚 Reference)
  • Added missing estimated_time field with proper format
  • Standardized permalink field structure
  • Added missing title and description fields
  • Fixed invalid difficulty values and quest types
  • Fixed invalid level formats to 4-digit binary

Docker Infrastructure Updates

• Dockerfile: Added Python 3.11 venv setup at /opt/venv for quest validation
• docker-compose.yml: Added multi-service validation environment
  • quest-validator service for individual quest validation
  • quest-network-validator service for network-wide validation
  • Shared volume mounts for scripts and quest directories

Quest System Status

• Total Quests: 130 quests (58 original + 72 generated)
• Levels Complete: 12 of 16 levels (75%)
  • Original levels: 0000, 0001, 0010, 0011, 0100, 0101, 1100, 1110
  • New levels: 0110, 0111, 1000, 1001, 1010, 1011
• Phases Complete: 4 of 6 phases (67%)
  • Phase 1: Infrastructure ✅
  • Phase 2: Apprentice Tier ✅
  • Phase 3: Journeyman Tier ✅
  • Phase 4: Expert Tier ✅
  • Phase 5: Master Tier (pending)
  • Phase 6: Polish & Integration (pending)

Major Quest Reorganization

• init_world/ → 0000/ (Foundation & Init World)
• lvl_000/ → 0000/ (merged with init_world content)
• lvl_001/ → 0001/ (Journeyman Challenges)
• lvl_0010/ → 0010/ (Terminal Enhancement)
• frontend/ → 0100/ (Frontend & Docker)
• Tool quests → tools/ directory
• Quest examples → codex/ directory
• File Naming: Removed date prefixes from all quest files (e.g., 2024-05-28-bash-run.md → bash-run.md)
• Code Files: Moved script/code examples from level root directories to subdirectories (scripts/, examples/)
• Updated paths: All internal quest links updated to new binary-coded paths in README.md and home.md
• Updated scripts/lib/preview_generator.py for enhanced preview generation
• Updated test/quest-validator/requirements.txt for validator dependencies

Removed

• Vendored preview-image generators — _plugins/preview_image_generator.rb, scripts/lib/preview_generator.py and scripts/generation/generate-preview-images.sh are retired; the zer0-image-generator gem (~> 0.6, bundle exec jekyll preview-images) covers every option they had, and preview_images: in _config.yml is its one config block. The _config_dev.yml / _config_ci.yml preview_images: overrides went with the plugin that read them.

• Empty Duplicate Post (pages/_posts/2025-07-10-github-actions-authentication-fix-2025-07-10.md) - Removed empty duplicate of existing post in devops/ subdirectory

• Legacy directory structure (init_world/, lvl_000/, lvl_001/, lvl_0010/, frontend/, examples/)
• Date prefixes from 75+ quest files
• Duplicate 0000/tools/ directory (consolidated to root tools/)

Fixed

• Quest preview paths — 164 quests used preview: images/previews/… without a leading slash, which the theme joined onto /assets as /assetsimages/previews/… (404 for the hero background and og:image). They now start with /images/, like the rest of the site, and so does the SEO frontmatter template
• Homepage stats and preview images — the stats row rendered 0 until a scroll-triggered count-up ran, so no-JS visitors, screenshots, and anyone who had not scrolled it into view saw four zeros. Real values are now rendered server-side (quests = non-draft fmContentType: quest floored to tens, levels/tiers from _data/quests/), and the count-up is skipped for reduced motion. The tier cards and gallery referenced 8 .png previews that only exist as .webp (12 broken images per load); they now point at the .webp files
• Quest nav copy and missing page headings — the quest trail said “No prerequisite” right above each quest’s own “Quest Prerequisites” list. It now reads “No prior experience needed” on level 0000 quests (13, including hello-noob) and “No required quest” elsewhere (101). /search/ and /sitemap/ had no h1 (axe page-has-heading-one); their headings are now h1

• 173 quest files with non-canonical permalink formats (/quests/level-XXXX-slug/, /quests/side-quest-slug/) migrated to ^/quests/[01]{4}/[side-quests/]slug/$ format

• Broken Jekyll docs link — https://jekyllrb.com/docs/deployment/methods/ → https://jekyllrb.com/docs/deployment/ in devops/2025-11-17-deploying-jekyll-sites-to-azure-cloud.md (#239)

• Link Check Results - Cleaned up oversized lychee_results.json (reduced ~128K lines of stale data) and regenerated analysis reports

• Bashcrawl Launcher (pages/_quests/0000/bashcrawl/bash_crawl.sh) - Rewrote the script to properly clone the bashcrawl repository and execute entrance.sh, removing unreachable code and adding error handling.

• dependency-checker.yml — Replaced nested YAML-unsafe heredoc labels (ISSUE_EOF) with standard EOF, removed fragile continue-on-error, fixed backtick quoting in markdown code fences, removed unnecessary label creation step
• frontmatter-validation.yml — Removed unused DateTimeEncoder class and redundant date import
• link-checker.yml — Removed broken float-to-integer truncation of success_rate variable; bash [[ -ge ]] already handles integer comparison

• prd-sync.yml — Fixed YAML block scalar indentation that broke workflow parsing, removed unnecessary issues: write permission

• fmContentType Field: Added missing fmContentType: quest to 35 quest files:
  • All 32 new quests in levels 1100-1111
  • 3 existing quests: edgar.md, sec-edgar.md, the-temple-of-templates.md
• Jekyll Build Error: Fixed invalid preview field in 2 blog posts:
  • 2025-06-29-planting-seeds-software-evolution.md - Changed text to image path
  • 2025-07-09-fixing-github-actions-bash-compatibility-ai-evolution-engine.md - Changed text to image path

Updated

Navigation Schema Migration (zer0-mistakes v0.17+)

Complete migration of all navigation files to new schema format.

• _data/navigation/about.yml - Changed sublinks to children, fixed icon format to bi-* prefix
• _data/navigation/main.yml - Changed sublinks to children, added Bootstrap Icons to all items
• _data/navigation/home.yml - Changed sublinks to children, fixed icon format
• _data/navigation/docs.yml - Changed sublinks to children, added icons, fixed icon prefix
• _data/navigation/quickstart.yml - Changed sublinks to children, added icons
• _data/navigation/posts.yml - Changed sublinks to children, fixed all icons to use bi-* format, removed empty sublinks: []
• _data/navigation/quests.yml - Changed sublinks to children, fixed icons to use bi-* format
• _data/navigation/notebooks.yml - Changed sublinks to children, fixed icon format
• _data/navigation/hobbies.yml - Changed sublinks to children, added icon

Documentation

• scripts/quest/README.md - Added front matter and documented quest index generation script usage.

Migration Notes

• Quest permalinks may have changed - update any external references
• Binary level directories (0000-1110) replace legacy naming convention
• Code examples now live in subdirectories within level folders

[2.2.0] - 2026-03-21

Added

• Contributor Profile System — Complete gamified RPG contributor profiles with character sheets, achievement walls, stats panels, and CSS styling (#167)
• Contributor Quest Line — 6 new quests: forge-your-character, avatar-forge, badge-collector, contribution-calendar, stats-dashboard, profile-themes (#168)
• Bash-Run Quest Rewrite — Rewrote bash-run quest (bashrun → bashcrawl) with improved educational content (#168)
• Contributor GitHub Actions Workflow — Automated contributor profile updates via CI/CD (#167)
• Contributor Generation Scripts — Makefile targets and generation scripts for contributor stats (#167)
• Advanced Version Control Quest — Level 1100 quest teaching semantic versioning, branch strategies, PR orchestration, and release management using real-world examples

Changed

• Script Relocation — Moved generate_statistics.rb, generate_statistics.sh, update_statistics.sh from _data/ to scripts/generation/ for better project organization (#166)
• Path References Updated — Updated Makefile, AGENTS.md, _data/README.md, scripts/README.md, pages/stats.md, and stating-the-stats quest to use new script paths (#166)
• Quest Validator — Added --config / -c CLI argument to respect Jekyll _config.yml default values, preventing false validation failures for fields with collection-level defaults (#169)
• YAML Anchor Handling — Quest validator now handles YAML anchors/aliases via regex fallback parser (#169)
• About Navigation — Added Contributors link to about navigation menu (#167)
• Quests README and Navigation — Updated quest collection docs with new contributor quest line (#168)

Removed

• Obsolete Data Files — Removed _data/SOLUTION_SUMMARY.md and _data/github-actions-example.yml (#166)

Fixed

• Quest Validator False Positives — Skips required field errors for fields that have _config.yml defaults (e.g., layout), resolving 142/142 quest validation (#169)

[2.5.0] - 2025-01-27

Added

Quest Network Validation & Fixes (Phase 6)

Complete quest network validation and frontmatter standardization across all 147 quests.

• scripts/fix-quest-frontmatter.py - New automated frontmatter fixer script
  • Removes placeholder dependencies (unlocks_quests, prerequisites)
  • Adds missing required fields (difficulty, estimated_time, quest_type)
  • Normalizes quest_type and difficulty values to valid options
  • Dry-run mode for safe previewing
  • Fixed 284 issues across 90 files
• pages/_quests/lvl_0110/README.md - New level README (Advanced Quests I)
• pages/_quests/lvl_0111/README.md - New level README (Advanced Quests II)
• pages/_quests/lvl_1000/README.md - New level README (Expert Quests I)
• pages/_quests/lvl_1001/README.md - New level README (Expert Quests II)
• pages/_quests/docs/ - New documentation directory for phase plans

Documentation

• pages/_quests/PHASE6_PLAN.md - Detailed Phase 6 execution plan with 5-week timeline
• pages/_quests/docs/PHASE1-5_COMPLETE.md - Archived phase completion summary
• pages/_quests/docs/VALIDATION_FIXES_SUMMARY.md - Archived validation fixes summary

Changed

Quest Frontmatter Standardization (~120 files)

• Removed all placeholder unlocks_quests and prerequisites references
• Added missing difficulty fields with contextually appropriate values
• Added missing estimated_time fields
• Normalized quest_type values to valid options (main_quest, side_quest, epic_quest, bonus_quest, reference)
• Normalized difficulty values to valid options (🟢 Easy, 🟡 Medium, 🔴 Hard, ⚔️ Epic)
• Fixed duplicate frontmatter keys in sec-edgar.md
• Cleared broken inter-quest dependencies (314 → 0 broken deps)

Validation System

• scripts/validate-quest-network.py - Updated to exclude /docs/ directory from scanning
• pages/_quests/QUEST_BUILD_PLAN.md - Updated with Phase 6 status, quest counts, and version 2.0.0

Fixed

• 318 validation errors → 0 errors - Complete quest network integrity
• Removed 314 broken dependency references
• Fixed invalid quest_type values (guide → reference, etc.)
• Fixed invalid difficulty values (intermediate → 🟡 Medium, etc.)
• Fixed sec-edgar.md missing title and duplicate description fields

Validation Results

• Total Quests: 147
• Complete Quests: 29
• Broken Dependencies: 0
• Errors: 0
• Warnings: 444 (non-blocking orphan quests - expected during development)

[2.4.1] - 2025-12-28

Added

• _data/navigation/quests.yml - New navigation file for quest collection with all levels (0000-0101)
• _data/navigation/notebooks.yml - New navigation file for notes/cheatsheets collection

Changed

Navigation System Alignment

• _data/navigation/main.yml - Fixed broken /zer0/ link, reorganized sections (Quick-Start, Journey, Library, Notebook, About)
• _data/navigation/about.yml - Removed non-existent pages (/about/approach, /about/license, /about/terms)
• _data/navigation/docs.yml - Complete rewrite to match actual _docs collection content
• _data/navigation/hobbies.yml - Simplified to existing /hobbies/ page only
• _data/navigation/home.yml - Fixed broken /roadmap/ reference, added Journey section
• _data/navigation/posts.yml - Removed broken entries, added Business category
• _data/navigation/quickstart.yml - Removed non-existent platform-specific pages

Sidebar Configuration

• _config.yml - Updated sidebar nav settings: _quests collection uses quests nav, _notes uses notebooks, added _notebooks collection scope
• pages/_about/settings/_config.yml - Synced with main config changes

Documentation

• _data/README.md - Added comprehensive navigation files table and sidebar modes documentation

[2.4.0] - 2025-12-20

Added

SEO & Content Automation Scripts (Ruby)

Three new Ruby automation scripts for Docker/Jekyll environment:

• scripts/frontmatter-validator.rb - Comprehensive frontmatter validation
  • Multi-type validation (posts, quests, docs, notes)
  • SEO scoring system (0-100 points)
  • JSON report export
  • CLI options for filtering and verbose output
  • Validates 343 files with 91.5% validity rate
• scripts/ctr-report-generator.rb - SEO/CTR report generation
  • Baseline metrics from Google Search Console
  • Weekly review template generation
  • Opportunities analysis for improvement
  • CSV parsing and JSON export
• scripts/content-freshness-check.rb - Content age tracking
  • Freshness categories (fresh/aging/stale/critical/unknown)
  • Content health scoring (56.2% current health)
  • Priority-ranked action items
  • Markdown and JSON report exports
  • Content-type specific thresholds

SEO Data & Reports

• TODO/seo/data/frontmatter-report.json - Full validation report (343 files)
• TODO/seo/data/seo-metrics.json - SEO baseline metrics
• TODO/seo/data/freshness-report.json - Content freshness data
• TODO/seo/reports/weekly-review-2025-12-20.md - Weekly review template
• TODO/seo/reports/content-freshness-2025-12-20.md - Freshness report

Changed

• TODO Status Dashboard: Updated TODO/STATUS.md with Automation category at 100% completion
• TODO README: Updated TODO/README.md with completed automation scripts and usage examples
• Scripts README: Added comprehensive SEO Automation section with usage examples

Documentation

• Updated scripts/README.md with SEO & Content Automation section
• Added usage examples for all three Ruby scripts
• Documented SEO scoring methodology and freshness thresholds

[2.3.0] - 2025-12-20

Added

Comprehensive SEO Optimization Project (4 Phases)

• Phase 1 - Quick Wins: Optimized 6 high-impression pages with proper titles, meta descriptions, and canonical URLs
• Phase 2 - Systematic Quest SEO: Updated 88 quest files with proper SEO frontmatter
  • Added descriptive titles with primary keywords (e.g., “Docker Containerization Mastery” vs “Docker Quest”)
  • Added unique meta descriptions (150-160 chars) explaining learning outcomes
  • Added structured tags and keywords for discoverability
  • Fixed placeholder values like [Descriptive Subtitle], [main-tech], [skill-category]
• Phase 3 - High-Demand Content: Created 3 new SEO-optimized articles targeting search gaps
  • pages/_docs/terminal/terminal-shortcuts-cheat-sheet.md - Comprehensive terminal shortcuts reference
  • pages/_posts/devops/2025-12-20-docker-beginners-tutorial.md - Docker beginner tutorial
  • pages/_posts/tools & environment/2025-12-20-essential-vscode-extensions-developers.md - VS Code extensions guide
• Phase 4 - Monitoring Infrastructure: Set up tracking systems for ongoing SEO health
  • TODO/seo/MONITORING_DASHBOARD.md - Weekly tracking templates, GSC checklists, A/B testing log
  • scripts/seo-tracker.py - Python CLI for baseline reports, weekly templates, opportunity analysis
  • TODO/seo/TRACKING.md - Performance metrics and baseline data

TODO System Reorganization

• Created TODO/STATUS.md - Central dashboard for all project work
• Created TODO/seo/ - Dedicated SEO project directory with structured files
• Created TODO/templates/ - Reusable templates for different task types
• Created TODO/ARCHIVE/ - Storage for completed project documentation
• Created .github/instructions/todo.instructions.md - AI agent guidelines for TODO management

Changed

• Roadmap Update: Refreshed roadmap.md with current priorities and timeline
• Quest Frontmatter Standardization: All 88 quest files now follow consistent SEO-optimized format

Removed

• Deleted obsolete TODO files: TODO/SEO_OPTIMIZATION_PLAN.md, TODO/QUICK_ACTIONS.md, TODO/TRACKING_TEMPLATE.md

[2.2.0] - 2025-11-29

Added

• PRD Machine Docker Integration: Added prd-machine service to docker-compose.yml for containerized PRD generation
• New Quest: 2025-11-29-prd-codex-mastering-product-reality-distillation.md - Level 0011 educational quest teaching Product Requirements Documents and PRD Machine usage with fantasy RPG theme
• PRD Machine CLI: Python-based tool (scripts/prd-machine/prd-machine.py) with three commands:
  • sync - Generate/update PRD.md from repository signals
  • status - Check PRD health and freshness
  • conflicts - Detect and display PRD conflicts

Changed

• PRD Content Refactor: Regenerated PRD.md to document the IT-Journey platform instead of self-referential PRD Machine documentation
• PRD Section Generators: Updated all section generators in prd-machine.py to output IT-Journey focused content (WHY, MVPs, Key Signals, etc.)

Documentation

• Updated pages/_quests/README.md with new PRD Codex quest entry
• PRD Machine README at scripts/prd-machine/README.md provides complete usage guide

  Changed

Content Organization Improvements (2025-12-17)

• Consolidated Blog Post Index: Replaced multiple duplicate post index files with a unified pages/posts.md
  • Removed redundant files: pages/_posts/2000-01-01-index.md, pages/_posts/README.md
  • Removed duplicate home section files: pages/_posts/home/2025-11-16-blog-posts-it-journey.md, pages/_posts/home/2025-11-16-posts.md
  • Created new unified post index at pages/posts.md with improved table-based category overview
  • Enhanced structure with better organization and visual layout
  • Updated frontmatter with current timestamp and version 2.0.0

Fixed

Link Health Improvements (2025-12-11)

• Removed Broken Internal References:
  • Removed /zer0/ bookmark from pages/home.md (404 error)
  • Updated quest example in stating-the-stats.md from /blog/ to /posts/
• Enhanced Link Checker Configuration:
  • Excluded _site/preview/ directory to eliminate ~15,000 false positives
  • Excluded work/ directory from link checking
  • Added exclusion patterns for rate-limited URLs (GitHub blob URLs, Reddit share buttons)
  • Reduced total link checks from 152K to 78K (48% reduction in noise)
  • Reduced broken link reports from 19,877 to 10,680 (46% reduction)
  • Reduced unique broken URLs from 2,173 to 1,696 (22% reduction)
• Added Comprehensive Link Analysis Documentation:
  • link-check-results/ANALYSIS_SUMMARY.md - Statistical analysis of link health
  • link-check-results/FIXES_APPLIED.md - Detailed documentation of fixes and remaining issues
  • link-check-results/detailed_analysis.md - Automated link failure analysis
  • link-check-results/ai_analysis.md - AI-powered link health insights

Added

AI-Generated Quest Preview Images (2025-12-01)

• 107 New Preview Images: AI-generated preview images for all quest levels using DALL-E 3
  • Level 0000-1111 README banners with consistent retro pixel art style
  • Individual quest preview images for 100+ quests
  • Images stored in assets/images/previews/

Enhanced Preview Generator Script

• New Feature: Batch Processing - Process multiple files with --batch N flag
• New Feature: Rate Limiting - Token bucket rate limiter for API calls (5 req/min default)
• New Feature: Logging Support - File logging with --log-file flag
• New Feature: Interrupt Handling - Graceful shutdown on Ctrl+C with progress preservation
• New Feature: Progress Tracking - Real-time progress bar and ETA during batch generation
• New Feature: Retry Logic - Automatic retries with exponential backoff for API failures

Fixed

• Jekyll Build Error: Added work/ directory to Jekyll exclude list to prevent symlink errors from local Python virtual environments

Quest Collection Layout System

• New Layout: quest-collection.html - Dynamic layout for displaying quests grouped by binary level tiers (Apprentice, Adventurer, Warrior, Master)
• New Include: quest-card.html - Reusable quest card component with data attributes for filtering
• New Include: quest-filters.html - Interactive filtering UI with JavaScript for quest type, difficulty, level, technology, and search
• New Include: quest-stats.html - Statistics display component showing quest counts by type and difficulty
• New Include: quest_card.html - Alternative quest card with BEM-style CSS classes
• New Include: quest_grid.html - Grid layout component for quest collections
• New Include: quest_stats.html - Alternative statistics component with time estimation

New Quest

• Side Quest: jekyll-quest-tracking.md (Level 0101, 🔴 Hard, 4-6 hours)
  • Master Jekyll’s collection system by building a quest tracking interface
  • Covers: Liquid templating, JavaScript filtering, Python automation
  • Includes 5 chapters and 4 mastery challenges
  • Complete with Mermaid diagrams for quest network and implementation flow

Automation Scripts

• New Script: update_level_readmes.py - Python script to ensure consistent frontmatter across level README files
  • Adds missing layout: quest-collection, level, and categories fields
  • Uses regex to detect 4-digit binary level directories

Changed

• Quest Index: Updated pages/_quests/README.md to use quest-collection layout
• Level READMEs: All level README files (0000-1111) updated with consistent frontmatter:
  • Added layout: quest-collection for dynamic quest display
  • Added level field matching directory name
  • Added categories: quests for proper collection filtering
• Level 0101 README: Added new Jekyll Quest Tracking side quest entry with updated Mermaid diagram

Fixed

• Integer/String Sorting: Quest filters now handle mixed Integer/String level values by coercing to strings before sorting

2.1.0 - 2025-11-26

Added

• New Quest: 2025-11-26-prompt-crystal-mastery-vscode-copilot-quest.md - Comprehensive VS Code Copilot prompt engineering quest with RCTF patterns, few-shot prompting, and reusable template creation
• New Post: 2025-11-26-mastering-prompt-engineering-vscode-copilot.md - Tutorial companion to the prompt engineering quest
• New Prompt Template: commit-publish.prompt.md - Complete release pipeline workflow for semantic versioning and publishing
• Enhanced Prompt: draft-article.prompt.md v2.0.0 - Major upgrade with RCTF pattern, Kaizen-driven structure, intake checklists, and quality gates
• CRUSH Workflow System: Added .crush/workflows/CRUSH_WORKFLOW_SYSTEM_SUMMARY.md documentation

Changed

• Documentation Reorganization: Moved summary files from repository root to organized /docs/ subdirectories:
  • ABOUT_REORGANIZATION_SUMMARY.md → docs/architecture/
  • QUEST_TEMPLATE_ENHANCEMENT_SUMMARY.md → docs/standards/
  • DEPENDENCY_UPDATE_SUMMARY.md → docs/workflows/
  • LINK_CONSOLIDATION_SUMMARY.md → docs/workflows/
• Updated docs/README.md with links to newly organized documentation (v1.1.0)
• Updated .gitignore to exclude log files from root directory and logs/*.log

Removed

• Cleaned up repository root:
  • Removed .seed.md (seed content moved to proper locations)
  • Removed .github/workflows/blank.yml (unused workflow)
  • Removed prompts/seed.prompt.yml and prompts/seed_prompt.md (consolidated)
  • Removed test-mermaid.html (moved to test/ directory)
  • Removed various log files (add-date-prefixes.log, post-organization.log)

Fixed

• Improved .gitignore patterns to prevent log file accumulation in repository

2.0.0 - 2025-11-16

Changed

• BREAKING: Weekly Post Organization workflow now creates pull requests instead of directly committing to main branch
  • This change requires manual review and approval of automated post organization changes
  • PRs are automatically labeled and assigned for review
  • Provides safety and traceability for all automated content changes

Migration Notes

• Existing workflow behavior: Posts were automatically organized and committed to main
• New workflow behavior: Posts are organized and a PR is created for review
• Action required: Review and merge PRs created by the workflow
• No script changes required: organize-posts.py and organize-posts.sh work as-is

Technical Details

• Workflow: .github/workflows/organize-posts-weekly.yml
• Implementation: Uses standard GitHub Actions (git commands + GitHub CLI)
• Branch pattern: automated/organize-posts-{run_id}
• PR configuration:
  • Title: 🤖 Weekly Post Organization - {run_id}
  • Labels: automated, content-organization, posts
  • Assignee: bamr87
  • Includes: Workflow link, change summary, next steps

Documentation

• Consolidated workflow documentation in docs/workflows/ORGANIZE_POSTS_WORKFLOW.md
• Includes: Process flow, implementation details, testing guide, troubleshooting
• Removed temporary documentation files from repository root

1.0.0 - 2025-11-16

Initial Release

• Weekly Post Organization workflow with direct commit to main branch
• Automated organization of posts by section using frontmatter metadata
• Automated archiving of posts older than configurable threshold
• Scheduled execution every Sunday at 2 AM UTC
• Manual trigger with dry-run option

Changelog Maintenance

This changelog is manually maintained. When making changes:

1. Add new entries under [Unreleased] section
2. Use categories: Added, Changed, Deprecated, Removed, Fixed, Security
3. Include migration notes for breaking changes
4. Link to relevant documentation
5. Move [Unreleased] items to a new version section when releasing

Version Numbering

• Major version (X.0.0): Breaking changes that require user action
• Minor version (0.X.0): New features, non-breaking changes
• Patch version (0.0.X): Bug fixes, documentation updates

Theme Fixes (2025-12-12)

Fixed - Theme Social Button URLs

• Pull Request: zer0-mistakes#15
• Branch: fix/social-button-urls
• Commit: 866e26b

Changes

• Fixed social sharing buttons to use production URLs instead of localhost
• Updated _includes/content/intro.html: Reddit, LinkedIn, Twitter, copy link buttons
• Updated _layouts/notebook.html: Twitter, LinkedIn, email share buttons
• Replaced https://it-journey.dev/CHANGELOG/ with https://it-journey.dev/CHANGELOG/

Impact

• Resolves 353 unique broken URLs (20.8% of all broken link types)
• Eliminates false positives in link health checks
• Social buttons now work correctly in all environments
• Expected 46% reduction in unique broken URL types after theme merge

Documentation

• Created link-check-results/THEME_FIXES.md with comprehensive details
• Technical implementation notes and testing procedures included
• Deployment process and expected improvements documented