Skip to content

docs: state the support boundaries, ADR outcomes and baseline lifecycle - #416

Merged
Reefact merged 1 commit into
mainfrom
claude/adr-implementation-reference-detail
Aug 10, 2026
Merged

docs: state the support boundaries, ADR outcomes and baseline lifecycle#416
Reefact merged 1 commit into
mainfrom
claude/adr-implementation-reference-detail

Conversation

@Reefact

@Reefact Reefact commented Aug 10, 2026

Copy link
Copy Markdown
Owner

Summary

Gives three contracts the ADR implementation reference already described in prose the shape they are actually read in — two tables and a numbered lifecycle. Salvaged from the abandoned agent/extract-adr-specifications branch, whose separate specification pages this reference had already superseded.

Type of change

  • Documentation

Changes

  • Tooling runtime floor — add a per-artifact table of build target and supported host boundary, so the netstandard2.0 / analyzer / net8.0 split is readable at a glance instead of reconstructed from two paragraphs.
  • ADR pull-request check — add a table of the four outcomes (no decision, create, supersede, alert) and the action each requires, plus the one-line statement that an agent drafts and only the maintainer accepts.
  • GenDoc catalog compatibility — add the four steps a baseline goes through, and the rule that it is generated only by fce catalog update.

The analyzer row points at RoslynFloorVersion rather than restating the version: the reference already declares that property the single source of truth, and a copied number drifts.

Testing

Documentation-only change; no code is touched, so the build and test commands were not run for this branch. What was verified instead — every factual claim added here was re-checked against the current tree:

  • the seven projects' TargetFramework values;
  • the roll-forward policies (Major on the CLI, LatestMajor on the worker, none on GenDoc);
  • RoslynFloorVersion, RoslynFloorTests and build/Net472TestFloor.props;
  • the fce catalog update and fce catalog diff registrations in CliApplication.

Structural checks: English and French are symmetric (121 lines, 9 sections, 2 tables, 1 numbered list each), the four new tables are well-formed, and all 30 relative links resolve.

Documentation

  • README / doc/ updated
  • French translation updated — both language versions changed in this pull request

Architecture decisions

  • No architectural decision in this pull request

This is implementation mechanics, which is what the reference exists to hold; no decision is recorded, changed or contradicted.

Related issues

None.


🤖 Generated with Claude Code

https://claude.ai/code/session_01JLxWJd3puHgDCdQoSiCgZC


Generated by Claude Code

The reference described these three in prose that a reader had to
reconstruct. Give each the shape it is actually read in: a per-artifact
table of build target and supported host, a table of the four ADR-check
outcomes and the action each requires, and the four steps a GenDoc
baseline goes through.

Salvaged from agent/extract-adr-specifications, whose separate
specification pages this reference had already superseded. Every claim was
re-verified against the current tree: target frameworks, roll-forward
policies, RoslynFloorVersion, and the fce catalog subcommands.
@Reefact
Reefact force-pushed the claude/adr-implementation-reference-detail branch from dd44852 to 0fd3097 Compare August 10, 2026 19:33
@Reefact
Reefact enabled auto-merge (rebase) August 10, 2026 19:34
@Reefact
Reefact merged commit a3772ca into main Aug 10, 2026
24 checks passed
@Reefact
Reefact deleted the claude/adr-implementation-reference-detail branch August 10, 2026 19:38
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