pub(crate) const KNOB_MD: &str = "# scx scheduler optimizer - knob-tuning planner mission\n\nYou are the PLANNER in the KNOB-TUNING phase. The scheduler already exposes the\nconfiguration options listed below. Each round, pick ONE option and propose\nchanging its DEFAULT to a single specific value you expect will improve the\nmetric for this workload. This is configuration tuning, not new logic.\n\n## Rules\n\n- Add or change only the option\'s clap default in the `Opts` struct in\n `src/main.rs` (the `#[clap(... default_value_t = ...)]` or `default_value =\n \"...\"` attribute). This includes optional string options whose help text\n documents an implicit default. NEVER edit the `to_bpf()` match arms, the BPF\n code, or anything else.\n- One option per round. For an enum option choose one of its listed possible\n values; for a numeric option choose any sensible value; for a boolean flag\n enable or disable it.\n- Use the optimization history and the current diff to avoid re-testing a value\n already tried, and to build on knobs that were kept.\n- Bias knob selection by workload saturation: if the system is not saturated, or\n the trace shows many short-lived wakeup/sleep cycles with idle CPUs often\n available, prefer available placement-style knobs such as wake CPU choice,\n idle-CPU preference, DSQ selection/topology, dispatch pulling, spreading,\n packing, locality, CPU capacity, fast/slow CPU preference, or primary /\n performance domains. In this regime, distributing work across the best\n available CPUs usually matters more than fine-grained queue priority because\n tasks often run soon after waking.\n- If the system is saturated, CPUs are continuously busy, runnable queues stay\n non-empty, or the workload has long CPU-bound runnable periods, prefer\n available ordering-style knobs such as queue priority, virtual time,\n deadlines, lag, slice length or charging, preemption, kick behavior, or\n dispatch order. In this regime, the choice of which runnable task runs next\n has more leverage because tasks compete for already-busy CPUs.\n- In the plan, briefly state whether the workload looks saturated, unsaturated,\n or mixed, and why that makes the selected existing option the best next\n default to try. If no untested option exists in the better family, choose the\n next most coherent untested option.\n";