New feedback note (harness post-incident)
The point is not to fix THIS bug — it's to change the SYSTEM so this whole CLASS is less likely (core/60). Small, specific, traceable to the incident.
When this fires
You were corrected on something a rule could have prevented; you iterated more than you should have; a human stepped in; you re-derived a decision a past session already made. After fixing the immediate thing, capture the lesson.
Absence gate
Before filing or implementing a missing-item defect, confirm absence with an exact, count-based, or untruncated result. Truncated, paginated, filtered, or summarized search output is incomplete evidence.
Fast path — if the Agentsmith CLI is available
Run agentsmith new-feedback "short symptom" — use .agentsmith/agentsmith on macOS/Linux or
.agentsmith\\agentsmith.cmd on Windows when the command is not on PATH. It computes the next number and writes
docs/feedback/NNNN-<slug>.md with the five-stage template, Status open.
Fallback — no CLI
- Next number = (highest existing
docs/feedback/NNNN-*.md+ 1), zero-padded to 4 digits. Numbers are never reused (R9), even if an old entry was archived. - Create
docs/feedback/NNNN-<slug>.md(Status: open) with the five stages:- Evidence / symptom — what was observed, quoted.
- Failure mechanism — WHY the system allowed it (missing rule / vague instruction / absent guardrail / unreached tool / noisy context — almost never "the model was dumb").
- Bounded edit — the smallest change that prevents the whole class.
- Named surface — exactly where it lands (a core rule, a hook, a verify phase, a template); prefer a deterministic surface over prose the model can skip.
- Non-regression — the check that stays red on recurrence. Until it's real, Status stays open.
Report
Name the file, then land the bounded edit on its named surface and flip Status to applied.