audit-feedback-loop

name	audit-feedback-loop
description	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.
license	CC-BY-4.0
compatibility	Requires a feedback store keyed by stable text anchors; no external dependency
metadata	{"version":"1.0","enforcement_level":"L1","status":"template","incident_refs":"feedback-silent-delete","params":"action:enum(add,list,resolve)"}

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