# Audit Feedback Loop

> Maintains an anchored-text feedback inbox for a knowledge store where every item attaches to an exact text anchor, carries an explicit resolution state, and is never silently deleted. Use when collecting, triaging, or resolving review feedback on extracted or generated pages.

- Skill: `vamseeachanta/audit-feedback-loop` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add vamseeachanta/audit-feedback-loop`
- Raw SKILL.md: https://api.skillmd.com/api/skills/vamseeachanta/audit-feedback-loop/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Security
- License: CC-BY-4.0
- Author: vamseeachanta (https://skillmd.com/u/vamseeachanta)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/vamseeachanta/audit-feedback-loop

---


# audit-feedback-loop

> Template skill (doc 08). Feedback that is deleted on resolution loses the
> audit trail that makes a knowledge store defensible. Every item is anchored
> and state-tracked instead.

## Trigger
`/audit-feedback <add|list|resolve> [args]`

## Preconditions
- A feedback store exists keyed by **stable text anchors** (page + quoted span or
  stable id) that survive edits well enough to re-resolve.
- The pages under review are committed (or staged) so anchors point at durable text.

## Closed-set resolution states
`open` → `acknowledged` → `resolved` | `wontfix` | `superseded`
(Never `deleted`. A resolved item is *closed with a reason*, kept for audit.)

## Steps
- **add:** attach feedback to an **exact text anchor** (page + quoted span or
  stable id), not "somewhere on this page." Record author + timestamp + initial
  state `open`.
- **list:** show items filtered by state/anchor; surface stale `open`/`acknowledged`
  items past an age threshold.
- **resolve:** move an item to a terminal state **with a reason and a link to the
  change** (PR/commit) that addressed it. The item stays in the record.

## Verification
- Every item has an anchor that still resolves to existing text (a validator can
  flag orphaned anchors after edits).
- No item is ever removed; state transitions are append-only.

## Cleanup
- n/a — non-deletion is the point.

## Incident appendix
| Rule | Why |
|---|---|
| Anchored to exact text | Vague feedback can't be verified as addressed |
| Never silently delete | Resolved-with-reason preserves the audit trail |