Skip to content

Consolidate Markdown backlog process and validation

Summary

Consolidated the Markdown backlog workflow into a durable operator runbook and tightened local validation so common backlog drift is caught before commit.

The process remains GitHub-primary for migrated future-roadmap items: GitHub issues and the eMule BB Roadmap project own workflow state, while local Markdown records remain engineering specs and evidence.

Completed Work

  • Added docs/reference/BACKLOG-PROCESS.md as the repeatable runbook for creating, updating, validating, and closing backlog items.
  • Linked the runbook from the repo README, documentation index, docs policy, and active backlog index.
  • Extended scripts/docs-item-taxonomy-check.py to validate active item required front matter, filename/front-matter ID alignment, and active index table ordering.
  • Reordered the active Features table so the stricter ordering check passes.

Validation

  • git diff --cached --check
  • python scripts\docs-item-taxonomy-check.py
  • python scripts\github-roadmap-check.py
  • python scripts\github-roadmap-check.py --github

Implementation is recorded by the tooling commit that adds this item.