Commit e9c482c
committed
docs(workbench): move the improvement leads out of the reference tree, and correct them
`technical-documentation/` is reference — "describe, don't narrate", no plans, no
changelogs — and a list of leads with a run table and (fixed)/(not fixed) markers
is what that rule exists to keep out. It belongs next to the bench that produced
the measurements, so that is where it goes; what gets settled will go to
`decisions.md`, and the anti-overfitting guardrail lands in the bench README where
it will actually be read — at the moment someone touches the system prompt.
Corrections, from checking every claim against the code:
- The customScale lead opened on a false premise. `depthIsOverridden` is emitted by
the snapshot, explained by `zoomNote`, and `setZoom`'s description already says
word for word that passing `depth` clears the override. The real gap is narrower
and is now stated: it reaches the snapshot and the tool description, not the tool
RESULTS nor the system prompt.
- The whisper bullet was stale. The failure has reached a toast since the automatic
transcription landed — a commit that is an ancestor of this document's own first
commit. What survives is the developer-facing wording and the untested path.
- The zoom-grounding numbers were filed under "Mesuré". No oracle computes the
focus-to-cursor gap; it is a manual observation, and writing the missing oracle is
now the first lead of that section rather than an afterthought.
- 356 points became 148 two sections earlier. The lead that told the reader to
reduce the noise first was asking for work already done.
- Lossless became lossless within the 0.02 tolerance, the depth-to-scale "table"
became the legend announced to the model, "19 round trips" became 19 calls with
the note that `rounds` is the number that would prove the latency claim, and the
batch-tool lead now cites `replaceTimeline` — the repo's own precedent for
refusing a batch outright — instead of raising the risk hypothetically.
Every figure that no versioned artefact can reproduce now says so, once, at the top.1 parent 556b1f2 commit e9c482c
2 files changed
Lines changed: 205 additions & 36 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
3 | 3 | | |
4 | 4 | | |
5 | 5 | | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
6 | 9 | | |
7 | 10 | | |
8 | 11 | | |
| |||
391 | 394 | | |
392 | 395 | | |
393 | 396 | | |
| 397 | + | |
| 398 | + | |
| 399 | + | |
| 400 | + | |
| 401 | + | |
| 402 | + | |
| 403 | + | |
| 404 | + | |
| 405 | + | |
| 406 | + | |
| 407 | + | |
| 408 | + | |
| 409 | + | |
| 410 | + | |
394 | 411 | | |
395 | 412 | | |
396 | 413 | | |
| |||
0 commit comments