docs(specs): fix README.md spec-number index drift and resolve collisions#6312
Merged
Conversation
…ions specs/README.md's Feature Docs table had drifted from the actual specs/ directory numbers across ~38 entries (017-056 range, off by one to two). Additionally three spec numbers were double-assigned on disk (016, 057, 058). Renumber the newer directory in each colliding pair (016-agent- feedback -> 054-agent-feedback, 057-agent-persistence -> 078-agent- persistence, 058-plugins -> 079-plugins) and update every cross-reference across specs/, AGENTS.md files, CHANGELOG.md, and rustdoc comments. Also correct a batch of rustdoc citations that mistakenly referenced "spec 064" (the permanent durable-execution slot) when they meant the MemGuard type-aware-retrieval spec at 004-memory/004-16; the collision was already flagged as a known issue in that spec's own info-callout. Closes #6308
bug-ops
enabled auto-merge (squash)
July 16, 2026 16:38
bug-ops
force-pushed
the
fix/6308-specs-readme-drift
branch
from
July 16, 2026 16:38
eba2bcb to
f1be670
Compare
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.
Summary
specs/README.md's Feature Docs table had drifted from the actualspecs/directory numbers across ~38 entries (the 017–056 range, off by one to two) — a contributor following the documented index would land on the wrong spec or a 404.016(agent-feedback / output-filtering),057(agent-persistence / autoskill-versioned-merging),058(plugins / autoskill-query-rewriting). Renumbered the newer/less-cross-referenced directory in each pair —016-agent-feedback→054-agent-feedback(fills a pre-existing gap),057-agent-persistence→078-agent-persistence,058-plugins→079-plugins— and updated every cross-reference (specs/, AGENTS.md files, CHANGELOG.md path mentions, spec wikilinks). The AutoSkill A1–A6 (056–061) and Gonka/SpeculationEngine numbering runs were kept intact since they're internally cross-referenced by number in code and other specs.zeph-config,zeph-context,zeph-memory,zeph-agent-context,zeph-common,zeph-core, andsrc/init/mod.rsthat mistakenly citedspec 064(the permanent durable-execution slot) when they meant the MemGuard type-aware-retrieval spec at004-memory/004-16-memory-type-aware-retrieval.md— a naming collision that spec's own info-callout already flagged as a known issue "for a future doc-only follow-up." Left the legitimate durable-executionspec 064/spec-064citations in the same files untouched.018-index→017-indexreference inspecs/MOC-specs.md.078-agent-persistenceand079-pluginsspecs.specs/064-durable-execution/spec.mdto reflect that the collisions it flagged as out-of-scope are now resolved.Docs-only change — no runtime logic modified, only doc/rustdoc comment text and directory names.
Closes #6308
Test plan
cargo +nightly fmt --checkcargo clippy --profile ci --workspace --all-targets --features "desktop,ide,server,chat,pdf,scheduler,testing" -- -D warningscargo nextest run --config-file .github/nextest.toml --workspace --features "desktop,ide,server,chat,pdf,scheduler" --lib --bins(13792 passed; one unrelated timing-based concurrency test flaked once under load, confirmed passing in isolation and on a clean re-run of the full suite)RUSTFLAGS="-D warnings" RUSTDOCFLAGS="--deny rustdoc::broken_intra_doc_links" cargo doc --no-deps --workspace --features desktop,ide,server,chat,pdf,schedulergitleaks protect --staged --no-banner --redactspecs/README.mdresolves to an existing file