Skip to content

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

  • 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 ({% raw %}{% 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

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

Changed

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

Fixed

  • 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

Added

  • 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)

Changed

  • .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

Fixed

  • 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)

[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)

Unreleased - 2026-03-08

Changed

  • 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

Removed

  • 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

Unreleased - 2026-03-07

Added

  • 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)

Changed

  • 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

Fixed

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

Unreleased - 2026-02-23

Added

  • 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.

Unreleased - 2026-02-22

Added

  • 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.

Changed

  • 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.

Fixed

  • 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.

Unreleased - 2026-02-21

Added

  • 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

Changed

  • 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

Unreleased - 2026-02-16

Added

  • 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)

Changed

  • 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

Fixed

  • 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

[Previous Unreleased]

Added

  • 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)

Changed

  • 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

[Unreleased - Previous]

Added

  • _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

Changed

  • _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

Changed

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

Updated

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.

[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

  • _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
  • _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

  • 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

[Previous Unreleased]

Added

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

Fixed

  • 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

Changed

  • 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)

Added

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

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

  • 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/)

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.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

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 {{ page.url | absolute_url }} with {{ site.url | append: page.url }}

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