Skip to content

discoverability gate: suppress hints when fix is already in README#77

Merged
dpetrou-continua merged 2 commits into
mainfrom
dpetrou/discoverability-gate
Feb 23, 2026
Merged

discoverability gate: suppress hints when fix is already in README#77
dpetrou-continua merged 2 commits into
mainfrom
dpetrou/discoverability-gate

Conversation

@dpetrou-continua
Copy link
Copy Markdown
Contributor

Summary

  • Adds a discoverability gate that suppresses error-time hints when the fix is already documented in README.md or AGENTS.md
  • Value: eliminates the +10% slowdown on well-documented repos while preserving the −14% speedup on undocumented repos
  • Vibe-coded (benchmark-driven feature gating)

Testing

  • 26 unit tests (discoverability gate, substring matching, suppression/firing)
  • 48 benchmark sessions (ledgerkit + toolhub, r=3): gate correctly fires on ledgerkit (−14%), suppresses on toolhub (~0%)
  • All 171 tests pass

Scans README.md + AGENTS.md at session start. If a hint pattern's
fix is already documented (discoverabilityKeywords found), suppress it.

Results: ledgerkit −14% (preserved), toolhub +10% → ~0% (loss eliminated).
Gate correctly fires hints only where the fix is undiscoverable.
@dpetrou-continua dpetrou-continua merged commit 94cc3a5 into main Feb 23, 2026
2 checks passed
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