Skip to content

docs(how-to): document grob_hint, classifier tuning, and simhash cache (Phase P)#271

Merged
Destynova2 merged 1 commit intomainfrom
docs/phase-p-howto
Apr 25, 2026
Merged

docs(how-to): document grob_hint, classifier tuning, and simhash cache (Phase P)#271
Destynova2 merged 1 commit intomainfrom
docs/phase-p-howto

Conversation

@Destynova2
Copy link
Copy Markdown
Contributor

Summary

Three Diátaxis how-to guides documenting the surfaces of Phase P (routing intelligence).

  • New `docs/how-to/use-grob-hint.md` — three hint surfaces (header / metadata / MCP) with priority order, per-surface examples, valid values, troubleshooting.
  • New `docs/how-to/configure-simhash-cache.md` — fuzzy cache concept, threshold tuning matrix, observability, trade-offs.
  • Extended `docs/how-to/auto-tune-routing.md` — new section Tune classifier weights via grob_configure + cross-links to the two new guides.

No code changes.

Style

Follows the existing docs/how-to/ conventions: H1 + bullets + H2 sections + code blocks, no YAML frontmatter (cf. `oauth-setup.md`, `dlp.md`).

Test plan

  • All prek pre-commit hooks green (lychee offline link check passed)
  • CI `docs-lint` green (auto-merge enabled below)

Note

The classifier tuning guide assumes #268 (T-P5a) merges first — that PR exposes `section=classifier` to `grob_configure`. The doc is forward-compatible: if it lands first, the example call returns unknown section until #268 ships.

…e (Phase P)

Three new how-to guides document the surfaces of the routing
intelligence (Phase P):

- New: use-grob-hint.md — three hint surfaces (header, metadata, MCP)
  with priority order and per-surface examples.
- New: configure-simhash-cache.md — fuzzy cache concept, threshold
  tuning matrix, observability, and trade-offs.
- Extended: auto-tune-routing.md — new section documenting how to tune
  classifier weights and thresholds via the grob_configure MCP tool;
  cross-links to the two new guides.

No code changes.
@Destynova2 Destynova2 enabled auto-merge April 25, 2026 18:34
@Destynova2 Destynova2 merged commit aeb5489 into main Apr 25, 2026
28 of 29 checks passed
@Destynova2 Destynova2 deleted the docs/phase-p-howto branch April 25, 2026 18: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.

1 participant