Skip to content

Add and rank usage-based navigation hints by prompt similarity - #320

Open
sridhar-mani wants to merge 5 commits into
GoogleCloudPlatform:mainfrom
sridhar-mani:feat/usage-navigation-hints
Open

Add and rank usage-based navigation hints by prompt similarity#320
sridhar-mani wants to merge 5 commits into
GoogleCloudPlatform:mainfrom
sridhar-mani:feat/usage-navigation-hints

Conversation

@sridhar-mani

Copy link
Copy Markdown

Summary

Adds an optional usage.yaml file to OKF for advisory, usage-based navigation hints.

The file records which concepts have historically been useful for specific intents and conditions, along with usage counts. The reference implementation can use this information to rank likely-relevant concepts and improve navigation over time.

The change includes:

  • usage.yaml schema and specification updates
  • Usage recording and ranking in the reference implementation
  • CLI commands for recording and ranking usage
  • Agent tools for usage recording and ranking
  • Example usage-hint bundle
  • rapidfuzz for lightweight fuzzy matching

Usage metadata is advisory only and does not change the underlying source of truth. Existing OKF bundles remain valid without usage.yaml.

Related to #319

@google-cla

google-cla Bot commented Aug 20, 2026

Copy link
Copy Markdown

Thanks for your pull request! It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

View this failed invocation of the CLA check for more information.

For the most up to date status, view the checks section at the bottom of the pull request.

@sridhar-mani

sridhar-mani commented Aug 21, 2026

Copy link
Copy Markdown
Author

@nikhilk @libei check this implementation out and please suggest some insights into the implementations if possible.

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