docs(wording): reframe alerts and report from verdict to inquiry (tiltak 2)
BRIEF-vurdering-v2.md tiltak 2: "design for the investigator, not the
validator". The hook alerts stated short conclusions a reader can only
accept or dismiss ("Rapid-fire: N consecutive fast interactions",
"possible stuck/spiral", "Consider a break").
Each alert in tool-tracker.mjs now follows the form the read-dominant
edit-ratio message introduced in 2c9e2de — observation, the counter-signal
that changes how to read it, then what to check:
- burst: names the interval and that edits were among the calls, and asks
whether each change was verified before the next
- edit ratio: carries the read percentage and asks what the remaining
calls are doing and whether the approach is converging
- soft warning: closes on framing instead of prescribing a break
- hard warning: asks the model to name its observations and ask what they
reflect; the required stop action is unchanged
commands/interaction-report.md gains the same rule for Observations and
trend reporting, plus an explicit "investigator, not validator" tone rule
and a "report the difference, not a label for it" rule.
Wording only — thresholds, heuristics, data model and required actions
are untouched. README examples and threshold-basis cells updated to match.
Tests first (Iron Law): 6 new/updated assertions on message text in
tests/tool-tracker.test.mjs and tests/interaction-report.test.mjs, red
before the change. node --test tests/*.test.mjs: 269 pass, 5 fail — the
pre-existing perf wall-clock cases only.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013U8ZH25KiMtts89yWRuVWD
This commit is contained in:
parent
2c9e2de00a
commit
86c3eae30c
6 changed files with 168 additions and 25 deletions
19
CHANGELOG.md
19
CHANGELOG.md
|
|
@ -4,6 +4,25 @@ All notable changes to this project will be documented in this file.
|
|||
|
||||
## [Unreleased]
|
||||
|
||||
### Changed
|
||||
|
||||
- **Alert and report wording moved from verdict to inquiry**
|
||||
(`docs/BRIEF-vurdering-v2.md` tiltak 2). The hook alerts stated short
|
||||
conclusions — "Rapid-fire: N consecutive fast interactions", "possible
|
||||
stuck/spiral", "Consider a break" — that a reader can only accept or
|
||||
dismiss. Each alert in `tool-tracker.mjs` now states the observation, the
|
||||
counter-signal that changes how to read it, and what to check: the burst
|
||||
alert asks whether each change was verified before the next; the edit-ratio
|
||||
alert carries the read percentage and asks what the remaining calls are
|
||||
doing; the soft warning closes on framing rather than a prescription; the
|
||||
hard warning asks the model to name its observations and ask what they
|
||||
reflect before suggesting stopping. `commands/interaction-report.md` gains
|
||||
the same rule for its Observations section and trend reporting: pair the
|
||||
number with the context that changes it, end in something to check, report
|
||||
both values and the delta rather than a label for the direction. Wording
|
||||
only — thresholds, heuristics, data model, and the required stop action are
|
||||
unchanged.
|
||||
|
||||
### Fixed
|
||||
|
||||
- **The burst and edit-ratio heuristics could not tell reading from editing**
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue