docs: repoint dead development-stages.md links to v2 archive + milestone roadmap#175
Merged
Merged
Conversation
…one roadmap The 8-stage plan was archived to docs/archived/development-stages-v2-2026-04.md and docs/spec/plans/ no longer holds it; ~47 stale references across 16 files were broken. Repointed by context: - Historical stage content -> docs/archived/development-stages-v2-2026-04.md (42 refs: README, TODOS, threat-model, broker/operator guide, heima-gaps, post-v0.1, execution-plan, all wiki pages, and the CLI provision-error blob URLs in lib.rs + cli_tests.rs kept in sync). - Live 'current roadmap' pointers -> docs/spec/plans/milestones-roadmap.md (3 refs: README per-session protocol aligned to CLAUDE.md, arch.md, wiki Home roadmap row). arch.md uses the live roadmap rather than archived per the no-arch.md-links-to-archived rule. Also fixed the adjacent broken link in broker-and-operator-dev-guide.md: ./plans/issue-101-ci-auto-deploy.md (never existed) -> ../ci-setup.md. Left intentionally: execution-plan.md:5,157 'v2/plans/development-stages.md' are project-life SOURCE paths (the 759-line original), not in-repo links. Verified: markdown broken-relative-link scan shows 0 broken development-stages links and no new breakage (191->190); cargo check -p agentkeys-cli exits 0.
0e17308 to
ba369e5
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.
What & why
~47 markdown/doc links pointed at
docs/spec/plans/development-stages.md, which was archived todocs/archived/development-stages-v2-2026-04.md(anddocs/spec/plans/no longer holds it). They were broken; this PR repoints every one by context.Repointed by context
→
docs/archived/development-stages-v2-2026-04.md(historical 8-stage content — 42 refs):README.md,TODOS.md,threat-model-key-custody.md,broker-and-operator-dev-guide.md,heima-gaps-vs-desired-architecture.md,post-v0.1-future-work.md,execution-plan.md, all six wiki pages (Home, blockchain-tee-architecture, hosted-first, key-security, overview, serve-and-audit), and the CLI provision-error blob URLs inlib.rs(+ the mirrored literal incli_tests.rs, kept in sync).→
docs/spec/plans/milestones-roadmap.md(live "current roadmap" pointers — 3 refs): theREADME.mdper-session protocol (aligned to CLAUDE.md wording),arch.md, and the wiki Home "Product/roadmap reviewer" row.arch.mdpoints at the live roadmap rather than archived per CLAUDE.md's "arch.md never links intodocs/archived/" rule — the roadmap itself links onward to archived.Adjacent broken link also fixed:
broker-and-operator-dev-guide.md./plans/issue-101-ci-auto-deploy.md(never existed) →../ci-setup.md(the real CI auto-deploy doc for issue #101 / PR #102).Notable decisions
docs/spec/plans/milestones-roadmap.md(notdocs/plan/, which holds pre-code plans) — confirmed by CLAUDE.md and the file's own "replaces the v1/v2 staged development-stages.md plan" line.execution-plan.md:5,157v2/plans/development-stages.mdare project-life source paths (the 759-line original), not in-repo links.:351-358inkey-security.md) that don't map onto the condensed archived file.Verification
spec/plans/development-stagesreference remains outsidedocs/archived/.cargo check -p agentkeys-cli→ exit 0.🤖 Generated with Claude Code