Skip to content

docs(decisions): keep per-instrument axis, reject framework-adapter inversion#131

Merged
lesnik512 merged 1 commit into
mainfrom
chore/decision-per-instrument-axis
Jun 24, 2026
Merged

docs(decisions): keep per-instrument axis, reject framework-adapter inversion#131
lesnik512 merged 1 commit into
mainfrom
chore/decision-per-instrument-axis

Conversation

@lesnik512

Copy link
Copy Markdown
Member

What

Records a planning/decisions/ entry rejecting architecture-review candidate 3 (invert the instrument × framework matrix to per-framework adapters). Decision-only — no code change.

Why

The 2026-06-23 architecture review surfaced candidate 3. Grilling it showed the premise and payoff don't hold:

  • Framework-locality already exists at the file level — all of a framework's instrument subclasses live in its one bootstrapper file.
  • The shared depth is already hoisted into the base instruments (render_health_check_data(), provider setup, config validation); the per-framework subclasses hold only the genuinely-different binding.
  • The N×M bindings differ genuinely (imperative vs declarative-before-build vs broker-vs-app), so a uniform adapter interface would leak.
  • Deletion test fails for the inversion: it relocates the same N×M bindings, concentrating nothing.

The entry carries a Revisit trigger (bindings start converging, or a new framework shares an existing one's attach mechanism) so the decision is reopened only when the calculus actually changes — and a future review won't re-suggest it in the meantime.

🤖 Generated with Claude Code

…nversion

Records the rejection of architecture-review candidate 3 with its load-bearing
reason so future reviews don't re-suggest inverting the instrument x framework
matrix. Decision-only; no code change.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@lesnik512 lesnik512 merged commit bfb1c53 into main Jun 24, 2026
7 checks passed
@lesnik512 lesnik512 deleted the chore/decision-per-instrument-axis branch June 24, 2026 08:47
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