Maintenance: parked ideas and session state move to the tracker; README stops repeating the other docs - #44
Merged
Merged
Conversation
…ME stops repeating the other docs FUTURE-IDEAS.md is retired: each parked idea is now a low-priority enhancement issue carrying its merit assessment (#36-#41), the benchmarking-programme note is #42, and the naming-convention entry is absorbed by the consolidation proposal #43. All pointers to the file now point at the label query. NEXT-SESSION.md (gitignored scratch) is retired in favour of workplan issues with sub-issues per QEP-2 -- #25 already holds the state -- so AGENTS.md and .gitignore drop the convention. README.md loses its copies of the doc map, the layout tree, and the validate/version-bump details, pointing instead at AGENTS.md and developing-skills.md where those are canonical; the qe blurb now says check-style is scaffolding rather than implying it runs. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
There was a problem hiding this comment.
Pull request overview
Maintenance/doc hygiene update that moves “parked ideas” and session state out of repo-root scratch/docs and into the tracker, while deduplicating README content so repo-level docs each own their stated topics.
Changes:
- Retires
FUTURE-IDEAS.md(and removes it from the MyST site TOC), updating references to point at the low-priority enhancement label query instead. - Retires the
NEXT-SESSION.mdscratch-file convention (and removes the.gitignoreentry), updating contributor guidance to use workplan issues/sub-issues in the tracker. - Rewrites README sections (Documentation/Layout/Contributing) to link to canonical docs instead of restating them.
Reviewed changes
Copilot reviewed 6 out of 7 changed files in this pull request and generated 1 comment.
Show a summary per file
| File | Description |
|---|---|
| README.md | Deduplicates repo guidance; points to canonical docs and tracker queries; clarifies qe scaffolding status in prose. |
| myst.yml | Removes FUTURE-IDEAS.md from the rendered docs site TOC. |
| FUTURE-IDEAS.md | Deleted; content moved to tracker issues per PR description. |
| docs/developing-skills.md | Updates “ideas” pointer from FUTURE-IDEAS.md to the low-priority enhancement issue query. |
| CATALOG.md | Updates “ideas” pointer from FUTURE-IDEAS.md to the low-priority enhancement issue query. |
| AGENTS.md | Updates doc map + conventions to point session state/parked ideas to the tracker instead of scratch files. |
| .gitignore | Removes NEXT-SESSION.md ignore rule now that the convention is retired. |
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
…paragraph below it Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
16 tasks
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.
Maintenance round, 2026-08-13. Repo-level files only, so no version bump is due.
FUTURE-IDEAS.md → the tracker
Each parked idea was assessed one by one and moved to its own issue, labelled
enhancement+low-priority(QEP-2 label names, created here ahead of the meta#358 rollout solabels syncwill conform rather than collide). The issue bodies carry the original evidence plus a dated merit assessment, so deleting the file loses nothing:The file's Rejected list is preserved here for the record: per-measurement skills (
cold-start,sweep-bench,scaling-curve) are measurements rather than workflows and live as scripts inside the benchmark plugin; typo/grammar skills are too trivial to need a skill;track-runtimeis workstream C's job (see #42).All references to the file (README, AGENTS, CATALOG, developing-skills, myst.yml) now point at the label query.
NEXT-SESSION.md retired
Session state now lives in workplan issues with sub-issues as tasks, per QEP-2 practice — #25 already holds it, revised more recently than the scratch file needed. AGENTS.md states the new convention and the
.gitignoreentry is gone. (The scratch file's remaining unique content — the gotchas — is already in the shipped docs or in #25.)README deduplication
README kept restating what other files own: the doc map (AGENTS.md), the repo layout tree (developing-skills § Repo layout), and the validate.py + version-bump details (developing-skills § Versioning and releases, AGENTS § Working in this repo). Those sections are now pointers, and the
qeblurb no longer impliescheck-styleruns — it is merged scaffolding, as CATALOG says. README still owns what the doc map assigns it: what the marketplace is, and installation.🤖 Generated with Claude Code