---
name: New Feedback
slug: new-feedback
category: Automation
description: New Feedback logs a harness lesson or post-incident note so the system improves, not just the current bug. Use it after a correction, human intervention, or repeated re-derivation to capture a bounded fix and non-regression check.
github: "https://github.com/PromptPartner/agentsmith/tree/master/skills/new-feedback"
language: Python
stars: 185
forks: 5
install: "npx degit https://github.com/PromptPartner/agentsmith/tree/master/skills/new-feedback ~/.claude/skills/new-feedback"
installs_to: ~/.claude/skills/new-feedback
source_path: skills/new-feedback/SKILL.md
collection_size: 13
category_size: 2032
collection_url: "https://dirskills.com/collections/PromptPartner/agentsmith"
added: 2026-09-06T05:20:49.463Z
last_synced: 2026-09-06T05:20:49.463Z
canonical_url: "https://dirskills.com/skills/new-feedback"
---

# New Feedback

New Feedback logs a harness lesson or post-incident note so the system improves, not just the current bug. Use it after a correction, human intervention, or repeated re-derivation to capture a bounded fix and non-regression check.

**Install:**

```bash
npx degit https://github.com/PromptPartner/agentsmith/tree/master/skills/new-feedback ~/.claude/skills/new-feedback
```

## README

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