plano/docs/source/concepts
Syed Hashmi ae629d3635
docs: reframe signals intro around the improvement flywheel
Addresses review feedback on #910:

- Replace the triage-only framing at the top with an instrument -> sample
  & triage -> construct data -> optimize -> deploy flywheel that explains
  why signals matter, not just what they surface. Paper's 82% / 1.52x
  numbers move into step 2 of the flywheel where they belong.
- Remove the 'Signals vs Response Quality' section. Per review, signals
  and response quality overlap rather than complement each other, so the
  comparison is misleading.
- Borrow the per-category summaries and leaf-type descriptions verbatim
  from the katanemo/signals reference implementation (module docstrings)
  so the documentation and the detector contract stay in sync. Drops the
  hand-crafted examples that were not strictly accurate (e.g. 'semantic
  overlap is high' for rephrase, 'user explicitly corrects the agent'
  for correction).

Made-with: Cursor
2026-04-24 10:59:37 -07:00
..
includes Rename all arch references to plano (#745) 2026-02-13 15:16:56 -08:00
llm_providers Add first-class Xiaomi provider support (#863) 2026-04-04 09:58:36 -07:00
agents.rst Update docs to Plano (#639) 2025-12-23 17:14:50 -08:00
filter_chain.rst add output filter chain (#822) 2026-03-18 17:58:20 -07:00
listeners.rst add output filter chain (#822) 2026-03-18 17:58:20 -07:00
prompt_target.rst Overhaul demos directory: cleanup, restructure, and standardize configs (#760) 2026-02-17 03:09:28 -08:00
signals.rst docs: reframe signals intro around the improvement flywheel 2026-04-24 10:59:37 -07:00