Workflow Feedback To Closure

---
name: workflow-feedback-to-closure
description: >
  Turn raw feedback — bug reports, review comments, Sentry, QA, audit output —
  into deduplicated durable tickets and drive each to verified closure. Use when
  "triage this feedback", "turn these reports into tickets", "process the bug
  backlog", or "close the loop".
license: MIT
---

# workflow-feedback-to-closure — Signal → Ticket → Verified Closure

**Degree of freedom: MIXED.** Cluster, severity, and cut-line `[HIGH freedom]`;
normalize → persist → live-verify-before-close `[LOW freedom — run exactly]`.

Feedback dies in three ways: it is never captured, it is captured twice, or it
is "fixed" but never verified in production. This skill prevents all three by
forcing every signal through capture → dedupe → durable ticket → fix →
live-verified closure.

> **A ticket is closed only when the fix is verified where the user hit it —
> not when a PR merges.** No signal is dropped silently; each ends as done,
> deduped, tracked, or explicitly won't-fix with a reason.

## How to reason

1. **Normalize** — every signal into the common shape
2. **Dedupe** — one defect, one ticket; search tracker first
3. **Ticket** — another engineer could repro from the card
4. **Close** — verified where the user hit it, not at merge

## Worked example

> **Normalize:** Sentry `quoteCart` TypeError + QA note "checkout dies on missing product" + one support email.
> **Dedupe:** same deleted-SKU path; existing `#412` is the canonical; attach all three sources.
> **Ticket:** repro steps + acceptance "deleted SKU → inline error, HTTP 200".
> **Close:** `workflow-fix-and-ship` lands the fix; Playwright on prod-like + Sentry quiet → `verified`.

## Self-critique before reporting

- **No silent drop** — every signal is done, deduped, tracked, or won't-fix
- **Dedupe first** — no second ticket for a known defect
- **Close ≠ merge** — `verified` only after live proof
- **Right owner** — one isolated bug already scoped → `workflow-fix-and-ship`; release+watch → `workflow-ship-and-observe`

## Phase 0 — Gather and normalize  [LOW freedom — run exactly]

Collect every incoming signal for this pass and record its source:

- user reports / support messages / app-store reviews
- Sentry issues and alerts (`search_issues`, `analyze_issue_with_seer`)
- QA, exploratory, and red-team findings (`test-qa`, `test-exploratory`, `test-red-team`)
- audit outputs (`audit-*`, `plan-*` reports)
- PR review comments and bot findings
- production logs and advisors (`get_logs`, `get_advisors`)

Normalize each into a common shape: `{ source, raw, symptom, suspected area,
severity signal, first/last seen, evidence link }`. Do not fix anything yet.

## Phase 1 — Dedupe and cluster  [HIGH freedom]

1. Cluster signals that describe the same underlying defect (same stack trace,
   same flow, same root symptom). One defect = one ticket, with all reporting
   sources attached as evidence.
2. **Dedupe against what already exists** before creating anything: search the
   issue tracker (`gh issue list`/search), `.cursor/` state files, and existing
   Sentry issue links. Link duplicates to the canonical item; never open a
   second ticket for a known defect.
3. Separate genuine defects from feature requests and from "working as
   intended" — route the latter two out, with a note, rather than forcing them
   into the fix pipeline.

## Phase 2 — Write durable, reproducible tickets  [HIGH freedom]

For each unique defect, produce a ticket that a different engineer could act on:

```md
### <concise title>
Sources: <Sentry link, report ids, review, audit finding>
Severity: Critical | High | Medium | Low   Impact: <who/how many>
Environment: <where observed>
Repro:
1. <step>
Expected: <...>   Actual: <...>
Suspected area: <file/module/endpoint>
Acceptance: <observable proof the fix works>
```

Persist the batch to `.cursor/feedback-closure-state.md` and, when a tracker is
in use, create/label the corresponding issues (`gh issue create`). The state
file is the source of truth if context compacts.

```md
# Feedback → Closure: <batch/date>
Tracker: <gh repo / none>

## Tickets
- [ ] <id/title> — severity — status: open|in-progress|fixed|verified|wont-fix
      dedupe: <canonical or "unique"> — acceptance: <proof>

## Duplicates merged
- <signal> → <canonical id>

## Not a defect (routed out)
- <signal> — <feature request / by design> — <where routed>

## Evidence
- <ticket>: <fix + verification result>
```

## Phase 3 — Prioritize  [HIGH freedom]

Rank by impact × severity ÷ effort. Critical production crashes and data-loss
paths first, then broad UX breakage, then degraded experiences, then cosmetics.
Present the ranked list; for large batches confirm the cut line with the user.

## Phase 4 — Fix through the right skill  [LOW freedom — hand off]

Drive each ticket to a fix using the matching workflow — do not improvise:

- reproducible bug from a report/Sentry → `workflow-fix-and-ship`
- a plan's connected deferrals / parked work → `complete-everything`
- FE/BE contract or 4xx/5xx mismatch → `debug-fe-be-integration`
- security/validation finding → the relevant `plan-*` remediation after approval
- whole-repo health debt → `workflow-green-repo`

Add a regression test that would have caught the defect. Update the ticket
status to `fixed` (not `verified`) when the code lands.

## Phase 5 — Verify and close  [LOW freedom — run exactly]

- Verify each fix **where the user hit it**: live flow via `test-playwright`,
  the failing query re-run, or the production signal confirmed gone after
  deploy (pair with `workflow-ship-and-observe` when a release is required).
- Only then set the ticket to `verified` and resolve the linked Sentry issue /
  close the tracker issue. Closing before live verification is forbidden.
- A defect that cannot be reproduced or verified is marked `needs-info` with the
  precise missing detail — not silently closed.

## Phase 6 — Report  [LOW freedom — do not skip]

```md
## Feedback → Closure — report (<date>)
Signals in: <n>  Unique defects: <n>  Duplicates merged: <n>
### Closed (verified live)
| Ticket | Severity | Fix (file) | Verified |
### In progress / deferred (tracked, with owner or reason)
### Routed out (feature request / by design)
### Won't-fix (justified)
```

Leave `.cursor/feedback-closure-state.md` as the audit trail unless asked to
remove it.

## Related

- `workflow-fix-and-ship` — the per-bug fix→verify→ship lifecycle
- `complete-everything` — close a plan's connected parked work
- `iterate-post-launch` — mine production signals proactively
- `workflow-ship-and-observe` — verify fixes live and watch stability
- `debug-sentry-monitor` — triage and resolve Sentry issues
- `verification-before-completion` — a ticket closes at verified, not merged