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

1. 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.
2. 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 verify phase, a lint check, a template, or a hook when the install runs hooks); prefer a deterministic surface over prose the model can skip. Record it on the line - **Surface:** file: <path> | text: <literal line> or - **Surface:** verify: <phase>.
   • 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.