Skip to content

Index the H2 2026 roadmap in the README guide list and the AGENTS.md docs/ tree #2002

Description

@cliffhall

Found by Copilot reviewing the v2.2.0 milestone merge (#1993). This is the deferred half of #1980 / #1981, which nothing was tracking.

#1981 added docs/inspector-roadmap-2026-h2.md and said so explicitly:

Index updates deferred. The docs-maintenance rule would normally have this PR also add the file to the root README.md guide list and the AGENTS.md docs/ tree. Both are deliberately left out to keep this diff to the document itself, and will follow separately.

"Separately" never got an issue, so the deferral had no way to come back. Meanwhile the file is now merged and shipping to main in the v2.2.0 release, undiscoverable from either index:

  • README.md:52-57 — the "Task-oriented guides live under docs/" list names four guides; the roadmap is absent.
  • AGENTS.md — the docs/ entry in the project tree reads (v1-to-v2-migration.md, mcp-server-configuration.md, mcp-app-review.md, launcher-config-consolidation-plan.md, images/), so the documented tree is stale.

Both are what the "Keep documentation files up to date" rule requires when a file is added.

Scope

  1. Add a bullet to the README guide list with a one-line description (the two-track structure — spec-following vs. chosen UX work — and the 🟢/🟡/🔴 tagging).
  2. Add inspector-roadmap-2026-h2.md to the docs/ line of the AGENTS.md project tree.

Nothing else — this is deliberately just the indexes the originating PR left out.

Activity

  1. added this to the v2.3.0 milestone on Aug 12, 2026
  2. added
    documentationImprovements or additions to documentation
    v2Issues and PRs for v2
    on Aug 12, 2026
  3. cliffhall commented on Aug 12, 2026

    @cliffhall
    MemberAuthor

    Triage: Priority Low (total 4)

    • Severity 2 — minor friction: the guide exists and is linkable, just not discoverable from either index
    • Urgency 2 — wanted eventually
    • Bonuses: none (no bug label; unassigned; no engagement)

    Board: #28, Status Todo, milestone v2.3.0.

  4. modified the milestones: v2.3.0, v2.4.0 on Aug 16, 2026
  5. modified the milestones: v2.4.0, v2.5.0 on Aug 24, 2026
  6. modified the milestones: v2.5.0, v2.6.0, v2.7.0 on Sep 1, 2026
  7. modified the milestones: v2.7.0, v2.8.0 on Sep 14, 2026
  8. self-assigned this
    on Sep 16, 2026
  9. cliffhall commented on Sep 16, 2026

    @cliffhall
    MemberAuthor

    refactoring of AGENTS.md and README.md obviate this request

  10. removed this from the v2.8.0 milestone on Sep 16, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

documentationImprovements or additions to documentationv2Issues and PRs for v2

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions