Skip to main content
Settings
Search
Appearance
Theme Mode
About
Theme
Jekyll v3.10.0
Environment Production
Last Build
2026-06-26 22:29 UTC
Repository
bamr87/zer0-mistakes
Changelog Docs Jekyll
Current Environment Production
Build Time Jun 26, 22:29
Jekyll v3.10.0
Build env (JEKYLL_ENV) production
Quick Links
Page Location
Source Code
View on GitHub Edit in GitHub.dev
Configuration
Site Config _config.yml
Page Info
Layout default
Collection none
Path pages/roadmap.md
URL /roadmap/
Date 2026-04-18
Theme Skin
SVG Backgrounds
Layer Opacity
0.6
0.04
0.08

Roadmap

Development roadmap for the zer0-mistakes Jekyll theme — past releases, current focus, and future plans.

Estimated reading time: 13 minutes

Edit on GitHub

Roadmap

Past releases, current focus, and future plans for the zer0-mistakes Jekyll theme. All versions follow Semantic Versioning.

Single source of truth. This page and the README roadmap section are both rendered from _data/roadmap.yml. Edit that file (and run ./scripts/generate-roadmap.sh to refresh the README) to update the roadmap everywhere.

Last reviewed: 2026-06-16

Visual Timeline

gantt
    title zer0-mistakes Roadmap
    dateFormat YYYY-MM
    section Completed
    v0.17 ES6 Navigation :done, 2025-12, 2025-12
    v0.18 Site Search :done, 2026-01, 2026-01
    v0.19 Feature Discovery :done, 2026-01, 2026-01
    v0.20 Navigation Redesign :done, 2026-02, 2026-02
    v0.21 Env Switcher :done, 2026-02, 2026-03
    v0.22 AIEO & Customization :done, 2026-04, 2026-04
    v1.0 Modular Installer & First Stable :done, 2026-04, 2026-04
    v1.1 Copilot Agent Prompts :done, 2026-04, 2026-04
    v1.2 Bare-Minimum Starter :done, 2026-04, 2026-04
    v1.3 Obsidian Vault Integration :done, 2026-04, 2026-04
    v1.4 Obsidian Graph View :done, 2026-04, 2026-04
    v1.5 Example Posts & AI Previews :done, 2026-04, 2026-04
    v1.6 About Page & Search Cleanup :done, 2026-04, 2026-04
    v1.7 Build Performance & MathJax 3 :done, 2026-05, 2026-05
    v1.8 Design Tokens & Navigation Chrome :done, 2026-05, 2026-05
    v1.9 Installer v2 & Site Scraper :done, 2026-05, 2026-05
    v1.10 Roadmap Validation :done, 2026-06, 2026-06
    v1.11 Continuous-Evolution Loop :done, 2026-06, 2026-06
    v1.12 Headless Endpoints :done, 2026-06, 2026-06
    v1.13 Quality Framework — First Wave :done, 2026-06, 2026-06
    v1.14 Zer0-Mistake Quality Framework :done, 2026-06, 2026-06
    v1.15 Quality Framework Batch :done, 2026-06, 2026-06
    v1.16 AI Chat + Consumer Audit :done, 2026-06, 2026-06
    v1.17 A11y, Mermaid & Migration Tests :done, 2026-06, 2026-06
    v1.18 AI Content Reviewer :done, 2026-06, 2026-06
    section Current
    v1.19 Site Hardening & Polish :active, 2026-06, 2026-08
    section Future
    v2.0 CMS Integration :2026-06, 2026-08
    v2.1 i18n Support :2026-08, 2026-10
    v2.2 Advanced Analytics :2026-10, 2026-12
    v3.0 Stable LTS :milestone, 2027-02, 1d

Release Summary

Version Status Target Summary
v0.17 ✅ Completed 2025-12-15 ES6 modular navigation with auto-hide navbar, hover dropdowns, keyboard navigation, and touch gestures.
v0.18 ✅ Completed 2026-01-15 Client-side site search with a keyboard-shortcut search modal.
v0.19 ✅ Completed 2026-01-25 43 documented features with a comprehensive feature registry.
v0.20 ✅ Completed 2026-02-01 Local Docker publishing pipeline and CI variable abstraction.
v0.21 ✅ Completed 2026-02-01 Environment switcher, settings modal redesign, and RubyGems API-key auth.
v0.22 ✅ Completed 2026-04-21 AI Engine Optimization (AIEO), structured data, and visual customization tools.
v1.0 ✅ Completed 2026-04-20 First stable major release — the monolithic installer rewritten as a modular, spec-driven CLI.
v1.1 ✅ Completed 2026-04-21 Data-driven Copilot Agent prompt registry focused on frontend and CMS workflows.
v1.2 ✅ Completed 2026-04-22 Three-file remote-theme starter with an in-browser configuration wizard.
v1.3 ✅ Completed 2026-04-24 Edit content as an Obsidian vault with identical rendering on GitHub Pages.
v1.4 ✅ Completed 2026-04-25 Force-directed knowledge graph mirroring Obsidian’s local graph view.
v1.5 ✅ Completed 2026-04-29 Richer sample content and regenerated AI preview images.
v1.6 ✅ Completed 2026-04-29 Expanded About page and removal of the Algolia search dependency.
v1.7 ✅ Completed 2026-05-24 Significant Jekyll build speedups and a MathJax 3 inline-math fix.
v1.8 ✅ Completed 2026-05-25 Sass design-token system, refreshed navigation chrome, and a docs overhaul.
v1.9 ✅ Completed 2026-05-27 Modular installer v2 with deploy plugins, AI wizard pipeline, and a site scraper.
v1.10 ✅ Completed 2026-06-01 Roadmap integrity validation and catch-up milestones so the roadmap tracks the shipped gem.
v1.11 ✅ Completed 2026-06-01 Self-sustaining backlog loop so AI agents keep improving the repo between human sessions.
v1.12 ✅ Completed 2026-06-03 Machine-readable site endpoints for downstream sites and AI agents.
v1.13 ✅ Completed 2026-06-11 First shipped wave of the Zer0-Mistake Quality Framework: CI gate parity and DOM sanitization.
v1.14 ✅ Completed 2026-06-11 Second wave of the Zer0-Mistake Quality Framework: DOM sanitization hardening and workflow lint cleanup.
v1.15 ✅ Completed 2026-06-12 Quality framework batch: docs lint baseline, locale guard, strict site_generation, contribution templates, and YAML export fix.
v1.16 ✅ Completed 2026-06-12 AI chat widget (ZER0-060) and consumer audit tooling; render guard bug fixed.
v1.17 ✅ Completed 2026-06-12 Plugin unit specs, coverage baseline, config-page sync, WCAG 2.1 AA fixes, Mermaid on 12 more pages, and migration tests.
v1.18 ✅ Completed 2026-06-13 Two-tier AI content reviewer framework and chat GitHub action tools (issue/PR creation via Claude tool use).
v1.19 🚧 In Progress Current (1.19.x) Production config hardening, analytics privacy fix, landing-page opt-out flags, and a documentation freshness sweep.
v2.0 🗓 Planned Q3 2026 Headless CMS integration with a content API and admin dashboard.
v2.1 🗓 Planned Q4 2026 Multi-language content support with locale-aware routing.
v2.2 🗓 Planned Q4 2026 Visual theme customizer, A/B testing, and conversion funnels.
v3.0 🎯 Milestone Q1 2027 Stable public API, 90%+ test coverage, and long-term support commitment.

See the full CHANGELOG for detailed release notes.

Milestone Detail

v0.17 — ES6 Navigation

Status: ✅ Completed (2025-12-15)

ES6 modular navigation with auto-hide navbar, hover dropdowns, keyboard navigation, and touch gestures.

Highlights:

  • ES6 navigation modules
  • Auto-hide navbar on scroll
  • Hover dropdowns with keyboard navigation
  • Touch gestures for mobile

v0.18 — Site Search

Status: ✅ Completed (2026-01-15)

Client-side site search with a keyboard-shortcut search modal.

Highlights:

  • Client-side search index
  • Search modal with keyboard shortcuts
  • GitHub Pages compatible (no server required)

v0.19 — Feature Discovery

Status: ✅ Completed (2026-01-25)

43 documented features with a comprehensive feature registry.

Highlights:

  • Feature registry in _data/features.yml
  • User-facing feature pages
  • Cross-linked from documentation

v0.20 — Navigation Redesign

Status: ✅ Completed (2026-02-01)

Local Docker publishing pipeline and CI variable abstraction.

Highlights:

  • Local Docker publishing pipeline
  • CI variable abstraction
  • Navigation refactor

v0.21 — Env Switcher

Status: ✅ Completed (2026-02-01)

Environment switcher, settings modal redesign, and RubyGems API-key auth.

Highlights:

  • Environment switcher
  • Settings modal with tabs
  • RubyGems API-key authentication
  • Dependency updates

v0.22 — AIEO & Customization

Status: ✅ Completed (2026-04-21)

AI Engine Optimization (AIEO), structured data, and visual customization tools.

Highlights:

  • JSON-LD SoftwareApplication, WebPage, Person, and FAQPage schemas
  • Author E-E-A-T visibility block on the landing page
  • FAQ page with FAQPage schema and glossary with key term definitions
  • Skin editor with live color pickers and palette generator
  • Admin layout and configuration dashboards
  • Playwright visual regression tests
  • Vendored assets (Bootstrap, Icons, Mermaid — no runtime CDN)
  • Copilot Agent prompt button with data-driven prompt registry
  • Dynamic collection-based navigation fallback for zero-config sites

v1.0 — Modular Installer & First Stable

Status: ✅ Completed (2026-04-20)

First stable major release — the monolithic installer rewritten as a modular, spec-driven CLI.

Highlights:

  • Modular installer CLI (scripts/bin/install) with library modules
  • Declarative YAML profiles (full / minimal / fork / remote / github)
  • Pluggable deploy targets (GitHub Pages, Azure SWA, Docker)
  • wizard --ai, doctor, diagnose, and upgrade subcommands
  • Hardened version analyzer and release automation

v1.1 — Copilot Agent Prompts

Status: ✅ Completed (2026-04-21)

Data-driven Copilot Agent prompt registry focused on frontend and CMS workflows.

Highlights:

  • Prompt registry powering the Copilot Agent button
  • Frontend- and CMS-oriented prompt presets

v1.2 — Bare-Minimum Starter

Status: ✅ Completed (2026-04-22)

Three-file remote-theme starter with an in-browser configuration wizard.

Highlights:

  • welcome layout that detects unconfigured sites
  • Embedded setup wizard that generates a personalised _config.yml
  • Smarter unconfigured-site detection heuristics

v1.3 — Obsidian Vault Integration

Status: ✅ Completed (2026-04-24)

Edit content as an Obsidian vault with identical rendering on GitHub Pages.

Highlights:

  • Client-side wiki-link resolver (aliases, embeds, callouts, inline tags)
  • Server-side backlinks panel on note layouts
  • Optional Ruby converter for vanilla Jekyll forks

v1.4 — Obsidian Graph View

Status: ✅ Completed (2026-04-25)

Force-directed knowledge graph mirroring Obsidian’s local graph view.

Highlights:

  • Cytoscape.js graph at /docs/obsidian/graph/
  • Standalone collapsible local graph panel

v1.5 — Example Posts & AI Previews

Status: ✅ Completed (2026-04-29)

Richer sample content and regenerated AI preview images.

Highlights:

  • 12 example posts across Business, Development, Science, Technology, Tutorial, and World
  • All preview images regenerated with the GPT image model

v1.6 — About Page & Search Cleanup

Status: ✅ Completed (2026-04-29)

Expanded About page and removal of the Algolia search dependency.

Highlights:

  • About page with prerequisites, quick start, FAQ, and architecture diagram
  • Algolia removed in favor of the built-in client-side search
  • Jekyll build performance caching

v1.7 — Build Performance & MathJax 3

Status: ✅ Completed (2026-05-24)

Significant Jekyll build speedups and a MathJax 3 inline-math fix.

Highlights:

  • Conditional MathJax/Mermaid loading and richer Obsidian cache
  • jQuery removed from page loads
  • Profiled Docker build reduced from ~119s to ~87s

v1.8 — Design Tokens & Navigation Chrome

Status: ✅ Completed (2026-05-25)

Sass design-token system, refreshed navigation chrome, and a docs overhaul.

Highlights:

  • Sass token layers, component/layout partials, and skins
  • VS Code-style collapsible sidebar rail and TOC
  • Unified Playwright test tiers (smoke / snapshots / regression)
  • Design-system developer docs

v1.9 — Installer v2 & Site Scraper

Status: ✅ Completed (2026-05-27)

Modular installer v2 with deploy plugins, AI wizard pipeline, and a site scraper.

Highlights:

  • Installer deploy plugins and AI wizard apply pipeline
  • Site scraper — BFS-crawl any website into a zer0-mistakes site
  • Accessibility skin fixes (WCAG AA contrast); air default skin
  • Quickstart documentation rewrite with screenshots
  • Hardened one-line installer path

v1.10 — Roadmap Validation

Status: ✅ Completed (2026-06-01)

Roadmap integrity validation and catch-up milestones so the roadmap tracks the shipped gem.

Highlights:

  • generate-roadmap.rb --validate mode (status/section/version/date checks)
  • Catch-up milestones v1.0–1.9 recorded in the roadmap
  • README roadmap accuracy fixes

v1.11 — Continuous-Evolution Loop

Status: ✅ Completed (2026-06-01)

Self-sustaining backlog loop so AI agents keep improving the repo between human sessions.

Highlights:

  • _data/backlog.yml tactical task queue (single source of truth)
  • Backlog ↔ GitHub Issues sync workflow with schema validation
  • Auto-merge for low-risk (docs/deps/lint) PRs once CI is green
  • /repo-audit and /backlog-implement agent routines
  • Documentation maintenance system and consolidation

v1.12 — Headless Endpoints

Status: ✅ Completed (2026-06-03)

Machine-readable site endpoints for downstream sites and AI agents.

Highlights:

  • Auto-generated /search.json endpoint for downstream sites
  • Auto-generated /sitemap/ endpoint
  • Ruby gem and Mermaid dependency updates

v1.13 — Quality Framework — First Wave

Status: ✅ Completed (2026-06-11)

First shipped wave of the Zer0-Mistake Quality Framework: CI gate parity and DOM sanitization.

Highlights:

  • CI gate parity (T-012) — PRs run the full canonical test entrypoint, not a subset
  • Admin config-page DOM sanitization (T-009), Liquid + plugin layers
  • Release changelog single source of truth; workflow lint cleanup (T-017)
  • Gate-coverage controls contract documented in the workflows README

v1.14 — Zer0-Mistake Quality Framework

Status: ✅ Completed (2026-06-11)

Second wave of the Zer0-Mistake Quality Framework: DOM sanitization hardening and workflow lint cleanup.

Highlights:

  • Admin config-page Liquid sanitization layer (T-009 hardening) — protects GitHub Pages builds where the plugin filter is a no-op
  • version-bump.yml yamllint cleanup (T-017) — trailing spaces, bracket spacing, sequence indentation
  • Changelog tooling: update_changelog_file normalizes trailing newlines and folds stale Unreleased sections

v1.15 — Quality Framework Batch

Status: ✅ Completed (2026-06-12)

Quality framework batch: docs lint baseline, locale guard, strict site_generation, contribution templates, and YAML export fix.

Highlights:

  • Contribution templates (T-003): bug-report / feature-request forms, PR template with conventional-commit checklist
  • Docs lint baseline + gate re-armed (T-004/T-014): ~1,600 markdownlint violations fixed, both || true suppressions removed
  • Theme customizer YAML export fix (T-008): hex color values quoted; frozen regression test promoted to live
  • Locale-independence guard (T-015): validators run under LC_ALL=C in the lib test suite
  • Strict site_generation suite (T-016): jekyll build failures now fail the gate
  • Ruby gemspec floor raised to >= 3.2 to match modern dependency requirements

v1.16 — AI Chat + Consumer Audit

Status: ✅ Completed (2026-06-12)

AI chat widget (ZER0-060) and consumer audit tooling; render guard bug fixed.

Highlights:

  • AI Chat Assistant (ZER0-060): opt-in floating chat widget grounded in the current page with proxy-first auth
  • Consumer audit tooling and theme manifest for downstream site health checks
  • Chat render guard fix: Liquid assign truthy bug would have shown a dead FAB on every page
  • Locale independence in scripts/lib/frontmatter.sh (multibyte post YAML errors under C locale)

v1.17 — A11y, Mermaid & Migration Tests

Status: ✅ Completed (2026-06-12)

Plugin unit specs, coverage baseline, config-page sync, WCAG 2.1 AA fixes, Mermaid on 12 more pages, and migration tests.

Highlights:

  • Plugin unit specs (T-011): 19 Minitest specs for preview_image_generator, content_statistics_generator, admin_page_urls
  • Coverage baseline (T-005): structural survey at docs/development/coverage-baseline.md; T-019/T-020 follow-ups filed
  • Admin config-page sync (T-018): byte-synced copy, drift check in validate, Raw-YAML tab sanitized
  • Navbar & site WCAG 2.1 AA fixes (T-007): all axe-core violations resolved; three test.fixme blocks promoted to live tests
  • Mermaid on 12 more pages: missing mermaid: true front-matter flags added across the docs
  • Obsidian graph view restored at /docs/obsidian/graph/ (161 nodes, 269 edges)
  • Migration & theme-version coverage (T-019): test_migrate.sh (14 assertions) and ThemeVersionGeneratorTest

v1.18 — AI Content Reviewer

Status: ✅ Completed (2026-06-13)

Two-tier AI content reviewer framework and chat GitHub action tools (issue/PR creation via Claude tool use).

Highlights:

  • Deterministic reviewer tier (scripts/content-review.rb): scores Markdown files 0–100 per-collection; posts sticky PR comment
  • Claude Code agent tier (.claude/agents/content-reviewer.md): tone, clarity, consistency, accessibility review
  • AI Content Review workflow (.github/workflows/ai-content-review.yml): runs on every PR touching pages/**
  • Chat GitHub actions: file issues and open PRs via Claude tool use with in-chat confirmation cards
  • Chat proxy template (Cloudflare Worker + Node dev proxy) with OAuth and API-key auth modes
  • AI Chat rebuilt on the Claude Messages API (SSE streaming, claude-opus-4-8 default)

v1.19 — Site Hardening & Polish

Status: 🚧 In Progress  ·  Target: Current (1.19.x)

Production config hardening, analytics privacy fix, landing-page opt-out flags, and a documentation freshness sweep.

Highlights:

  • Config hardening: restored zer0-mistakes.com site identity + CNAME and the remote_theme contract (#174, #176)
  • Opt-out flags for RSS link and visible landing-page title (feat(home))
  • Analytics fix: GA/GTM load only in production, skipping dev hostnames
  • Documentation freshness sweep: broken cross-links repaired (T-004 follow-up)

v2.0 — CMS Integration

Status: 🗓 Planned  ·  Target: Q3 2026

Headless CMS integration with a content API and admin dashboard.

Highlights:

  • Headless CMS integration (Decap CMS or Tina)
  • Content API for programmatic access
  • Admin dashboard for content management
  • Draft preview workflow
  • Multi-author collaboration

v2.1 — i18n Support

Status: 🗓 Planned  ·  Target: Q4 2026

Multi-language content support with locale-aware routing.

Highlights:

  • Multi-language content support
  • Locale-aware routing
  • Translated UI strings via _data/ui-text.yml
  • Right-to-left (RTL) layout support

v2.2 — Advanced Analytics

Status: 🗓 Planned  ·  Target: Q4 2026

Visual theme customizer, A/B testing, and conversion funnels.

Highlights:

  • A/B testing framework
  • Conversion funnels
  • Heatmap visualization
  • Visual theme customizer enhancements

v3.0 — Stable LTS

Status: 🎯 Milestone  ·  Target: Q1 2027

Stable public API, 90%+ test coverage, and long-term support commitment.

Highlights:

  • Stable public API for theme customization
  • 90%+ automated test coverage
  • Migration guide from Minima and other themes
  • Performance benchmarks met
  • Security audit passed
  • Long-term support (LTS) commitment

How We Prioritize

Roadmap priorities are informed by:

  1. Community feedback — GitHub Issues and Discussions
  2. Usage analytics — privacy-compliant PostHog data on feature adoption
  3. Ecosystem changes — Jekyll, Bootstrap, and GitHub Pages updates
  4. Contributor interest — open feature requests that attract PRs

Want to influence the roadmap? Open a discussion with your use case, or propose an edit to _data/roadmap.yml directly.