chore(docs): delete stale mid-delivery markdown - #1574
Conversation
|
Remove unused NEXT.md, archived dated plans, and unreferenced status leftovers. Trim pointers that treated NEXT.md as current delivery authority. Co-authored-by: Zack Jackson <ScriptedAlchemy@users.noreply.github.com>
d39396d to
a961439
Compare
# Conflicts: # docs/plans/2026-02-26-codegraph-rust-implementation-plan.md # docs/plans/2026-02-26-codegraph-rust-port-design.md # docs/plans/2026-02-26-multi-language-implementation-plan.md # docs/plans/2026-02-26-multi-language-support-design.md # docs/plans/2026-07-01-macos-launchd-daemon-support.md # docs/plans/2026-07-04-tool-cli-args-agent-ergonomics.md # docs/plans/tracedecay-v2/NEXT.md # docs/plans/tracedecay-v2/audits/ci-triage-plan-2026-08-14.md # docs/plans/tracedecay-v2/audits/lane-staleness-2026-08-13.md # docs/plans/tracedecay-v2/audits/v2-implementation-audit-2026-08-14.md # docs/superpowers/plans/2026-07-31-one-shot-crate-split.md # docs/superpowers/plans/2026-08-08-v2-rc-recovery.md # docs/superpowers/plans/2026-08-23-pr663-agent-handoff-prompt.md # docs/superpowers/plans/2026-08-23-pr663-performance-recovery.md # docs/superpowers/plans/v2/pr16-remote-brain.md # docs/superpowers/plans/v2/pr18-public-sdks.md # docs/superpowers/plans/v2/pr20-performance.md
|
Parked for an owner decision, not closed. This PR deletes docs/plans/tracedecay-v2/NEXT.md, which the profile-managed skill tracedecay-v2-pr4-task1-domain-boundary names as its plan of record, and edits AGENTS.md and docs/V2-OPERATING-MODEL.md. 25 of its 26 target files are still on master, so the 9,526-line cleanup is real and unlanded. It needs a call on the plan-of-record file before a rebase is worth doing. |
Summary
docs/plans/tracedecay-v2/NEXT.mdand other unreferenced mid-delivery markdown (archived dated plans, status audits, and superseded handoff notes).NEXT.mdas current delivery authority.00-plan-set-index.mdstays the roadmap.Motivation
Zack confirmed
NEXT.mdis unused. The file and several sibling leftovers still presented themselves as delivery status after PR #707. This removes the ones that are clearly dead and lists the rest instead of guessing.Base SHA:
1e454fffb8f913b6d25bb8efec5b02b82fb69b14(currentorigin/masterafter rebase; earlier tip44acc8a1bc/ Zack's16033e8c34had already moved).research_remaining_work_20260904.mdis not on this tip, so it was not deleted.Changes
Deleted
docs/plans/tracedecay-v2/NEXT.md— confirmed unused outcomes ledger; last reconciled as a post-feat: TraceDecay V2 delivery (PR8–PR13) + daemon performance, memory, and reliability overhaul #707 snapshot.docs/plans/2026-02-26-codegraph-rust-implementation-plan.md— archived pre-V2 implementation plan; banner says it is not authority; zero inbound references.docs/plans/2026-02-26-codegraph-rust-port-design.md— archived sibling design of the same port; zero inbound references.docs/plans/2026-02-26-multi-language-implementation-plan.md— archived Go/Java implementation plan; current requirements are the V2 plan set; zero inbound references.docs/plans/2026-02-26-multi-language-support-design.md— archived sibling design; zero inbound references.docs/plans/2026-07-01-macos-launchd-daemon-support.md— archived implementation plan (Target branch: main); zero inbound references.docs/plans/2026-07-04-tool-cli-args-agent-ergonomics.md— archived status of a landed CLI-args branch (PR Support stdin for tool args #286); zero inbound references.docs/plans/2026-08-08-v2-rc-recovery-design.md— stamped “reconciled into NEXT.md”; not implementation authority; zero inbound references.docs/plans/tracedecay-v2/audits/ci-triage-plan-2026-08-14.md— one-run CI classification on the redesign branch; zero inbound references.docs/plans/tracedecay-v2/audits/lane-staleness-2026-08-13.md— staleness audit ofNEXT.mdremaining-work bullets; zero inbound references.docs/plans/tracedecay-v2/audits/v2-implementation-audit-2026-08-14.md— dated RC gap register whose authority wasNEXT.md; zero inbound references.docs/superpowers/plans/2026-08-08-v2-rc-recovery.md— same reconciliation banner as the design; its only inbound reference was that design.docs/superpowers/plans/2026-08-23-pr663-agent-handoff-prompt.md— copy-paste handoff for PR perf(runtime): simplify PR 421 hot paths and shared digest authority #663 onto a redesign branch; only referenced its sibling plan.docs/superpowers/plans/2026-08-23-pr663-performance-recovery.md— same closed PR-perf(runtime): simplify PR 421 hot paths and shared digest authority #663 choreography; only referenced by the handoff prompt.docs/superpowers/plans/2026-07-31-one-shot-crate-split.md— banner says superseded by landing on 2026-08-14; only referenced by the test-helpers note, which was updated.docs/superpowers/plans/v2/pr16-remote-brain.md— archived PR provenance, “not current requirements”; zero inbound references.docs/superpowers/plans/v2/pr18-public-sdks.md— same archived PR provenance; zero inbound references.docs/superpowers/plans/v2/pr19-cutover-runtime.md— same; fresh-store policy already lives in00-plan-set-index.md.docs/superpowers/plans/v2/pr20-performance.md— same archived measurement-framework note; zero inbound references.Pointer trims (files kept):
AGENTS.mddropped theNEXT.mdoutcomes clause;docs/V2-OPERATING-MODEL.md,docs/plans/tracedecay-v2/00-plan-set-index.md,docs/plans/tracedecay-v2/README.md, plan 24, and plan 39 no longer tell readers to consult or editNEXT.md.docs/superpowers/plans/2026-08-01-test-support-features.mdno longer names the deleted crate-split file.Ambiguous — left alone
dogfood-journey.md— dated test(product): dogfood the installed model-free product #1281 journey log with no filename references; instruction was to list it, not delete it. Code mentions “dogfood journey” as a phrase, not this file.docs/plans/LEXICAL-ARTIFACT-SIZE-DECISION.md— 2026-09-13 measurement memo that records options and says no decision was made.docs/superpowers/plans/2026-06-29-tracedecay-followups.md— unchecked follow-up plan against oldsrc/paths, but it is not stamped superseded.docs/superpowers/plans/2026-08-01-test-support-features.md— still describes the livetest-helpersfeature convention.docs/superpowers/plans/2026-08-03-rust-library-maintenance-reduction.md— still marked queued behind the V2 landing wave.docs/superpowers/plans/2026-08-24-code-index-text-catchup-pipeline.md— approved implementation plan; only referenced by its spec.docs/superpowers/specs/2026-08-24-code-index-text-catchup-pipeline-design.md— approved lexical catch-up design that may still describe shipping behavior.docs/superpowers/plans/2026-08-25-root-package-relocation.md— plan for the move that already shipped; only referenced by its spec.docs/superpowers/specs/2026-08-25-root-package-relocation-design.md— still explains the current virtual-workspace layout.docs/RUNTIME-BLOCKING-IO-AUDIT.md— unreferenced by filename, but it documents a shipping defect class rather than a status ledger.docs/development/brain-renderer-qualification.md— dated qualification observation, not a remaining-work list.docs/development/runtime-performance.md— current harness description, not a delivery snapshot.docs/MCP-extensions.md— unreferenced candidate-tool notes; not stamped dead.docs/AGENT-MEMORY-INTERCEPTION.md— research/design proposal; not a status leftover.docs/ROOT-LEXICAL-CANDIDATE-READ-DECISION.md— open retrieval decision (options, no choice).docs/ROOT-DERIVED-RECORD-READ-DECISION.md— sibling decision memo still cited by the lexical candidate note.Notable files left alone
CLAUDE.mdand rootREADME.mdwere not touched (they do not mentionNEXT.md).AGENTS.mdwas trimmed only to drop theNEXT.mdclause.docs/plans/tracedecay-v2/plans (00–40, README,RUST-METAPROGRAMMING.md) stay.00-plan-set-index.mdis still the roadmap, including plans that banner themselves as landed.CHANGELOG.md,SECURITY.md,CONTRIBUTING.md,CODE_OF_CONDUCT.md,docs/USER-GUIDE.md, anddocs/dashboard.mdwere not edited.docs/V2-OPERATING-MODEL.mdlost only theNEXT.mdstatus sentence.NEXT.md(queries.rsclause 8, a markdown-outline example, a fact-merge test comment). They are historical comments, not doc links, and were left alone.Test plan
*.mdanddocs/**/*.mdbefore deletion (snapshot.json ignored as a tree dump).NEXT.mdmention in Markdown.cargo nextest/ clippy not run: documentation-only deletions and pointer trims.Checklist
.envfiles includedCHANGELOG.mdnot updated (docs cleanup only)