Skip to content

docs(roadmap): mark decision-to-code-proximity Achieved [roadmap:decision-to-code-proximity]#287

Merged
tcballard merged 2 commits into
mainfrom
claude/batch-1-residual-followups-cj4dbx
Jul 3, 2026
Merged

docs(roadmap): mark decision-to-code-proximity Achieved [roadmap:decision-to-code-proximity]#287
tcballard merged 2 commits into
mainfrom
claude/batch-1-residual-followups-cj4dbx

Conversation

@tcballard

@tcballard tcballard commented Jul 3, 2026

Copy link
Copy Markdown
Collaborator

Summary

Closing hygiene for the now-complete decision-to-code-proximity programme (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:

Roadmap / ADR Trace

  • rac/roadmaps/decision-to-code-proximity.md — the roadmap being closed out
  • adr-061 — Roadmaps Carry an "Achieved" Terminal Lifecycle Status
  • adr-076 — CalVer releases: the changelog entry is renamed to the release heading when the next release is cut

Scope

Included

  • Roadmap Status: Planned → Achieved, prose updated to a delivery summary (which initiative shipped what, over which surfaces).
  • rac-path-decisions-lookup Status: Proposed → Accepted, with a delivery note (the rac decisions-for CLI and the find_decisions MCP path argument).
  • A CHANGELOG ## Unreleased section: the ## Applies To code-scope declaration and its validation finding, rac decisions-for, the additive find_decisions path argument, and the Explorer /decisions-for command — framed by user impact.

Excluded

  • No code or behaviour changes; corpus and changelog only.
  • No release cut — the Unreleased heading is renamed to a CalVer version when the maintainer publishes (per verify_release, ADR-076).

Product / Architecture Decisions

  • Documentation trail, for the record. The programme's what/why already lives in the corpus (roadmap, the two requirements, the code-scope-consumption design, the four dogfooded evidence ADRs) and its usage in the docs (docs/relationships.md code-scope section, docs/cli.md decisions-for). The one gap was the changelog — added here as Unreleased so 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 --validate stays clean).

Verification

Ran

  • rac validate rac/PASS — 373 valid, 0 invalid (roadmap now Achieved, requirement now Accepted).
  • rac relationships rac/ --validate → exit 0; rac review rac/ → no priority 1–2 findings.
  • pytest tests/test_release_version.py → 25 passed (the Unreleased heading is inert to changelog_has_entry, which matches a ## <version> heading; the real-file check runs only at release with a version).

Review Path

  1. rac/roadmaps/decision-to-code-proximity.md — the status flip and delivery summary.
  2. rac/requirements/rac-path-decisions-lookup.md — the missed Accepted flip.
  3. CHANGELOG.md — the Unreleased section.

Notes For Reviewer

Implementation Process

Implemented with AI assistance; the status flip was requested and the changelog capture confirmed by the maintainer.

tcballard added 2 commits July 3, 2026 19:55
…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).
@tcballard
tcballard merged commit 82af824 into main Jul 3, 2026
9 checks passed
@tcballard
tcballard deleted the claude/batch-1-residual-followups-cj4dbx branch July 3, 2026 20:13
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.

1 participant