qe 0.9.0: /qe:workplan-roadmap — a project tracker drawn as mermaid flowcharts - #75
Merged
Conversation
…lowcharts The work-plan family's third skill, extracted from the hand run that drew the Lectures monorepo roadmap from its tracker (project-monorepo#30). It snapshots a tracker with the new scripts/workplan/tracker-snapshot.sh — direct sub-issues in plan order, Decision role from the native type or the QEP-6 body marker, every quoted line prefixed — diffs the snapshot against the roadmap's node index, reports structural changes only, and writes the file, commit and PR after approval. The tracker is never edited. Docs: README, using-skills and CATALOG rows; scripts/README; the family sentence in workplan and workplan-project; CHANGELOG 0.9.0. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
There was a problem hiding this comment.
🟡 Changes recommended
The new snapshot script’s Decision-role detection does not match the documented “body opens with Decision point” rule, risking incorrect roadmap structure inference.
Once you've addressed the issues Copilot identified, you can request another Copilot review.
Pull request overview
Adds a new workplan-* family skill, /qe:workplan-roadmap, to generate and maintain a repository-local ROADMAP.md (GitHub-rendered mermaid diagrams) from a project tracker, backed by a deterministic tracker snapshot script; bumps the qe plugin to 0.9.0 and updates catalog/docs to surface the new capability.
Changes:
- Introduces
/qe:workplan-roadmap(qe/skills/workplan-roadmap/SKILL.md) and its deterministic snapshot helper (qe/scripts/workplan/tracker-snapshot.sh). - Bumps plugin + marketplace versions to
0.9.0and records the release inqe/CHANGELOG.md. - Updates docs/indexes (
README.md,docs/using-skills.md,CATALOG.md, skill cross-links,qe/scripts/README.md) to include the new skill and script family.
File summaries
| File | Description |
|---|---|
| README.md | Adds /qe:workplan-roadmap to the top-level skill list. |
| qe/skills/workplan/SKILL.md | Updates family description to “three skills” and links the new skill. |
| qe/skills/workplan-roadmap/SKILL.md | New skill procedure and usage for generating/updating ROADMAP.md. |
| qe/skills/workplan-project/SKILL.md | Updates family description to “three skills” and links the new skill. |
| qe/scripts/workplan/tracker-snapshot.sh | New deterministic snapshot script for tracker + direct sub-issues. |
| qe/scripts/README.md | Documents the new workplan/ scripts subdirectory (needs minor punctuation fix). |
| qe/CHANGELOG.md | Adds 0.9.0 release entry describing the new skill. |
| qe/.claude-plugin/plugin.json | Bumps qe plugin version and extends description. |
| docs/using-skills.md | Updates skill count and adds a row for /qe:workplan-roadmap. |
| CATALOG.md | Lists /qe:workplan-roadmap and describes its validation status. |
| .claude-plugin/marketplace.json | Bumps marketplace qe entry version and extends description. |
Review details
- Files reviewed: 11/11 changed files
- Comments generated: 2
- Review effort level: Lite
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
… it; scripts README punctuation Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What this is
A third skill for the
workplan-*family,/qe:workplan-roadmap, extracted from a hand run: the roadmap drawn for the Lectures monorepo project from its tracker in project-monorepo#30 (merged 2026-09-02, members-only). Given a project tracker it draws or updates the project'sROADMAP.md— two GitHub-rendered mermaid flowcharts (the route: phases, decision gates and the pathways each gate can choose; and every sub-issue with its dependencies), a table of what each gate can decide, and a node index — and keeps the drawing in step with the tracker after a plan review. Tracked under #63.The shape of the skill
Deterministic half.
qe/scripts/workplan/tracker-snapshot.shdumps a tracker's header (state, type, visibility, stamp date, sub-issue counts), its body, and one record per direct sub-issue in tracker order — which under QEP-6 is plan order — with the role read asdecisionwhen the issue carries the org's nativeDecisiontype or the**Decision point**body marker. Every line quoted from GitHub is prefixed with|, the same boundaryfetch-copilot.shuses, so no body can forge a record header. Tested against a private tracker (project-monorepo#7, 23 children, all six decisions detected from the native type) and a public one (meta#358, 11 untyped children), plus the not-found and--helppaths.Judgement half. The SKILL.md procedure: snapshot → read the structure (phases and gates from the tracker body; edges only where a sub-issue body supports them, with the phrase noted) → compare against the roadmap's node index and classify each difference as structural or not → draft → write, commit and open the PR after approval. The one rule it enforces is the file's own: a roadmap shows structure, not status, so an item merely closing changes nothing — that is the tracker's and the dashboard's job, and a third copy of progress would drift first. It never edits the tracker; a roadmap that disagrees with the tracker is reported as a finding against the tracker.
Where the file lives. Beside the plan in the tracker's repository, never on the projects dashboard — C2 §2.2 withholds a private tracker's children from the public site, so a diagram naming them cannot go there. The skill says so, and notes the Pages caveat for private repos that publish a public site.
Changes
qe/skills/workplan-roadmap/SKILL.md— new.qe/scripts/workplan/tracker-snapshot.sh— new.qe0.8.0 → 0.9.0 inplugin.jsonand the marketplace entry, description extended;qe/CHANGELOG.md0.9.0 entry.workplanandworkplan-projectnow describe the family as three skills and link the third (the only edits to shipped skills).docs/using-skills.md(six skills) and CATALOG rows;qe/scripts/README.mdgains theworkplan/line.python scripts/validate.pypasses;check-version-bump.pyagainstorigin/mainreports the bump. Not done here: a run from an installed plugin (${CLAUDE_PLUGIN_ROOT}resolution of the script), which is the first-run validation #63 tracks. Naming:workplan-roadmapkeeps the family greppable next toworkplanandworkplan-project; if a verb form is preferred,draw-roadmapis the alternative and nothing else depends on the name.🤖 Generated with Claude Code