Skip to content

chore(docs): delete stale mid-delivery markdown - #1574

Merged
ScriptedAlchemy merged 3 commits into
masterfrom
cursor/delete-stale-mid-delivery-docs-f4a3
Sep 21, 2026
Merged

ScriptedAlchemy merged 3 commits into
masterfrom
cursor/delete-stale-mid-delivery-docs-f4a3

Conversation

@ScriptedAlchemy

@ScriptedAlchemy ScriptedAlchemy commented Sep 18, 2026

Copy link
Copy Markdown
Owner

Summary

  • Delete unused docs/plans/tracedecay-v2/NEXT.md and other unreferenced mid-delivery markdown (archived dated plans, status audits, and superseded handoff notes).
  • Trim live pointers that still named NEXT.md as current delivery authority. 00-plan-set-index.md stays the roadmap.
  • Do not merge. Docs-only; no product behavior change.

Motivation

Zack confirmed NEXT.md is 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 (current origin/master after rebase; earlier tip 44acc8a1bc / Zack's 16033e8c34 had already moved).

research_remaining_work_20260904.md is 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 of NEXT.md remaining-work bullets; zero inbound references.
  • docs/plans/tracedecay-v2/audits/v2-implementation-audit-2026-08-14.md — dated RC gap register whose authority was NEXT.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 in 00-plan-set-index.md.
  • docs/superpowers/plans/v2/pr20-performance.md — same archived measurement-framework note; zero inbound references.

Pointer trims (files kept): AGENTS.md dropped the NEXT.md outcomes 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 edit NEXT.md. docs/superpowers/plans/2026-08-01-test-support-features.md no 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 old src/ paths, but it is not stamped superseded.
  • docs/superpowers/plans/2026-08-01-test-support-features.md — still describes the live test-helpers feature 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.md and root README.md were not touched (they do not mention NEXT.md). AGENTS.md was trimmed only to drop the NEXT.md clause.
  • Numbered docs/plans/tracedecay-v2/ plans (0040, README, RUST-METAPROGRAMMING.md) stay. 00-plan-set-index.md is still the roadmap, including plans that banner themselves as landed.
  • CHANGELOG.md, SECURITY.md, CONTRIBUTING.md, CODE_OF_CONDUCT.md, docs/USER-GUIDE.md, and docs/dashboard.md were not edited. docs/V2-OPERATING-MODEL.md lost only the NEXT.md status sentence.
  • Unreferenced but still descriptive product docs were not treated as dead: LCM payload/compression docs, memory-curation and self-improving contracts, rebrand policy, release automation, host integration notes, trust-decay, and similar.
  • Three Rust comments still say NEXT.md (queries.rs clause 8, a markdown-outline example, a fact-merge test comment). They are historical comments, not doc links, and were left alone.

Test plan

  • Filename search of root *.md and docs/**/*.md before deletion (snapshot.json ignored as a tree dump).
  • After the edit, no remaining NEXT.md mention in Markdown.
  • cargo nextest / clippy not run: documentation-only deletions and pointer trims.
  • CHANGELOG not updated: no user-facing product change.

Checklist

  • No secrets, credentials, or .env files included
  • No breaking product changes
  • CHANGELOG.md not updated (docs cleanup only)
Open in Web Open in Cursor 

@changeset-bot

changeset-bot Bot commented Sep 18, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: 3a2dfba

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

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>
@cursor
cursor Bot force-pushed the cursor/delete-stale-mid-delivery-docs-f4a3 branch from d39396d to a961439 Compare September 18, 2026 00:03
# 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
@ScriptedAlchemy

Copy link
Copy Markdown
Owner Author

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.

@ScriptedAlchemy
ScriptedAlchemy merged commit 94e60b6 into master Sep 21, 2026
26 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants