docs(roadmap): mark decision-to-code-proximity Achieved [roadmap:decision-to-code-proximity]#287
Merged
Merged
Conversation
…sion-to-code-proximity] All three initiatives shipped (#274/#275/#276), so the roadmap moves to its terminal Achieved status (ADR-061) with a delivery summary. Also flips rac-path-decisions-lookup Proposed -> Accepted — missed when Initiative 2 landed (#275); its CLI subcommand and MCP path argument are delivered.
…dmap:decision-to-code-proximity] Adds an Unreleased section capturing the programme's user-visible changes: the `## Applies To` code-scope declaration and its validation, the `rac decisions-for` lookup, the additive `find_decisions` MCP path argument, and the Explorer `/decisions-for` command. Renamed to the release heading when the next CalVer release is cut (ADR-076).
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
Closing hygiene for the now-complete
decision-to-code-proximityprogramme (epic #273, all three initiatives merged via #284/#285/#286): move the roadmap to its terminal lifecycle status, correct a missed requirement status, and record the user-visible changes in the changelog.Changes:
Achieved(ADR-061) with a delivery summary of the three initiatives.rac-path-decisions-lookup→Accepted— it shipped in decision-to-code-proximity: path→decisions lookup — CLI subcommand plus additive find_decisions path argument #275 but was leftProposed.Unreleasedsection capturing the programme's user-visible surface.Roadmap / ADR Trace
rac/roadmaps/decision-to-code-proximity.md— the roadmap being closed outadr-061— Roadmaps Carry an "Achieved" Terminal Lifecycle Statusadr-076— CalVer releases: the changelog entry is renamed to the release heading when the next release is cutScope
Included
Status: Planned → Achieved, prose updated to a delivery summary (which initiative shipped what, over which surfaces).rac-path-decisions-lookupStatus: Proposed → Accepted, with a delivery note (therac decisions-forCLI and thefind_decisionsMCPpathargument).## Unreleasedsection: the## Applies Tocode-scope declaration and its validation finding,rac decisions-for, the additivefind_decisionspathargument, and the Explorer/decisions-forcommand — framed by user impact.Excluded
Unreleasedheading is renamed to a CalVer version when the maintainer publishes (perverify_release, ADR-076).Product / Architecture Decisions
code-scope-consumptiondesign, the four dogfooded evidence ADRs) and its usage in the docs (docs/relationships.mdcode-scope section,docs/cli.mddecisions-for). The one gap was the changelog — added here asUnreleasedso a user scanning release notes sees the capability, consistent with the file's stated "spirit of Keep a Changelog."Achieved, not closed-and-gone. Per ADR-061 an achieved roadmap is a live terminal record — still valid to reference — so no inbound reference to it becomes a retired-target finding (rac relationships --validatestays clean).Verification
Ran
rac validate rac/→PASS — 373 valid, 0 invalid(roadmap nowAchieved, requirement nowAccepted).rac relationships rac/ --validate→ exit0;rac review rac/→ no priority 1–2 findings.pytest tests/test_release_version.py→ 25 passed (theUnreleasedheading is inert tochangelog_has_entry, which matches a## <version>heading; the real-file check runs only at release with a version).Review Path
rac/roadmaps/decision-to-code-proximity.md— the status flip and delivery summary.rac/requirements/rac-path-decisions-lookup.md— the missedAcceptedflip.CHANGELOG.md— theUnreleasedsection.Notes For Reviewer
## Unreleasedto the CalVer version heading when the next release is cut;verify_releasewill then find the entry.Implementation Process
Implemented with AI assistance; the status flip was requested and the changelog capture confirmed by the maintainer.