Move the backlog to the project board and remove docs/backlog - #27
Move the backlog to the project board and remove docs/backlog#27meketreve wants to merge 1 commit into
Conversation
All 85 entries from docs/backlog/ now exist as draft issues on the Game Server board, https://github.com/orgs/OpenPerpetuum/projects/6, each keeping its ISSUE-NNN / IMPROVEMENT-NNN identifier in the item title and its full body text. Statuses were mapped onto the board's Status field: TODO and DEFERRED to BACKLOG, IN_PROGRESS to In progress, DONE to Done. This commit removes the four files so the backlog has one home rather than two. Their content remains in git history. docs/backlog/issues.md 21 entries docs/backlog/improvements.md 29 entries docs/backlog/completed.md 35 entries docs/backlog/active-sprint.md 0 bytes, empty since it was added CLAUDE.md's Backlog Management section is rewritten rather than deleted. It still carries the same rules, statuses, priorities and entry format; it now points at the board and describes an item instead of a markdown section. Three differences are stated there explicitly rather than left to be discovered: - the board has no BLOCKED or DEFERRED status, so both import as BACKLOG - the board has no priority field, so Priority stays in the item body - reading the board needs the read:project scope, which a fresh gh token does not carry References under docs/superpowers/plans/ and docs/superpowers/specs/ are left untouched. Both are dated records of work already done and were accurate when written; rewriting them would be rewriting history rather than documenting the present. The item identifiers they cite still resolve, because the board keeps them in the title. Two duplicate identifiers surfaced while importing and are reproduced on the board as-is rather than silently reconciled: - IMPROVEMENT-018 is used twice in completed.md, for "New Robot dialog UX improvements" and for "Season Config: Activity Points Scoring Mode" - IMPROVEMENT-024 appears in both improvements.md and completed.md
|
Closing this. The destination was weaker than what it replaced, and I should have checked before The 85 entries were imported to the board as draft issues, and a draft issue supports only a GitHub Issues already covers what this was reaching for — assignee, discussion, cross-references and Nothing was deleted. Two findings from the import are worth keeping regardless of this pull request, and I will raise them
|
This deletes
docs/backlog/— 85 entries, 3071 lines of your project memory. Please read the wholething before deciding, and reject it without hesitation if the answer is no. Nothing else depends on
it.
What was done
All 85 backlog entries now exist as draft issues on the
Game Server board, each keeping its
ISSUE-NNN/IMPROVEMENT-NNNidentifier in the item title and its complete body text.docs/backlog/issues.mdBACKLOG, the rest by their own statusdocs/backlog/improvements.mddocs/backlog/completed.mdDonedocs/backlog/active-sprint.mdStatuses mapped
TODO/DEFERRED→BACKLOG,IN_PROGRESS→In progress,DONE→Done.The board went from 80 items to 165.
Draft issues, not real issues — nothing was created in the repository's issue tracker.
The import already happened. This pull request is only the removal half. If you close it, the
board keeps the entries and
docs/backlog/keeps working exactly as it does today; you would have aduplicate rather than a breakage. That is the current state, and it is why this exists: one backlog
in two places is worse than either arrangement alone.
What this touches besides the deletion
CLAUDE.md's Backlog Management section is rewritten, not removed. Same rules, same statuses,same priorities, same entry format — pointing at the board and describing an item instead of a
markdown section. Deleting the files without this would leave
CLAUDE.mdnaming four paths that nolonger exist, which is the exact defect class of ISSUE-034.
Three differences are stated in
CLAUDE.mdrather than left to be discovered:BLOCKEDorDEFERREDstatus. Both import asBACKLOG. One entry is affected,IMPROVEMENT-035, which was
DEFERREDPrioritystays in the item bodyread:projectscope, which a freshghtoken does not carry —gh auth refresh -h github.com -s projectdocs/superpowers/plans/anddocs/superpowers/specs/referencedocs/backlog/about thirty timesand are left untouched. Both are dated records of work already done and were accurate when
written; rewriting them would be rewriting history rather than documenting the present. The
identifiers they cite still resolve, because the board keeps them in the title.
Two things found while importing
Reproduced on the board as-is rather than silently reconciled, because they are your records to fix:
IMPROVEMENT-018is used twice, both insidecompleted.md— once for "New Robot dialog UXimprovements" and once for "Season Config: Activity Points Scoring Mode". The second heading
carries a
(Season Config)qualifier, which is presumably how it survived.IMPROVEMENT-024appears in bothimprovements.mdandcompleted.md. Same defect class asISSUE-031 and ISSUE-032, which Move ISSUE-033 and ISSUE-034 to completed.md, and finish ISSUE-034 in docs/codebase #22 asked about and which is still open:
CLAUDE.mdsays completeditems move to
completed.md, and the files show that sometimes they get copied instead.Why you might not want this
Stating the case against, because it is real:
PerpetuumServer,OP-Project,OPDBandOPDiscordBot. It had never held aPerpetuumServer2item. This makes server2 the majority of it.available offline. A project board is none of those.
docs/backlog/; not everyone who can clone it can read the board.If any of that outweighs having one home for the backlog, close this. The alternative middle ground —
blanking the files and leaving a pointer to the board — is a smaller change and I am happy to send
that instead.