/new-feedback

name: new-feedback
description: Log a harness lesson / post-incident so the SYSTEM improves, not just this one bug — fires on "log a harness lesson", "post-incident", "we should make this less likely", System-Evolution moments. Part of the Agentsmith harness; scaffolds a numbered docs/feedback/NNNN-*.md with the five-stage template (R9 — numbers are never reused).
compatibility: Requires filesystem access; the fast path requires the cross-platform Agentsmith CLI.

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 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`.