Skip to content

name: todo-backlog-sync description: Keep the repository backlog in sync across todo-backlog.yaml, TODO.MD, the publication PDF include, and backlog-facing workflow docs whenever TODOs or roadmap summaries change.

Todo Backlog Sync

Use this skill when the task touches repository TODOs, backlog summaries, the publication backlog table, or any workflow that regenerates those surfaces.

Required Flow

  1. Treat todo-backlog.yaml as the single editable source of truth.
  2. Regenerate the derived surfaces with make todo-sync.
  3. If the publication surface is in scope, run make paper-build so the committed PDF and banner match the latest backlog table.
  4. Keep README.md, utilities/README.md, publication/README.md, and AGENTS.md aligned when the workflow or utility surface changes.
  5. Keep the publication workflow able to rebuild the table from source instead of relying on stale committed output.

Validation

  • Run uv run pytest tests/test_utilities.py tests/test_repository_rag_bdd.py.
  • Run any targeted backlog, CLI, or publication surface tests you changed.
  • Run make verify-surfaces.
  • Run make paper-build when the publication table or article changed.
  • Update the latest docs/audit/*.md note when verification status changes.