git:20260729.8dd5ad0 to git:20260920.2cbc56d

1 added, 1 removed. Audit A to A.

---

name: pm-feedback

description: "Synthesize a batch of user feedback into JTBD-clustered themes with severity, frequency, and quote evidence. Runs feedback-synthesizer."

---

## Codex host binding

- Treat references to Claude slash workflows as the equivalently named Codex skill.

- Before delegating to any specialist, read the `great-pm-runtime` skill and the selected packaged role file.

- Treat "invoke", "assign", "delegate", "spawn", and source Agent-tool instructions as a required Codex `spawn_agent` call with that role and a bounded assignment.

- - Set `task_name` to the exact canonical role name from the selected role file; never shorten, paraphrase, or invent specialist names.

+ - For the spawn tool's `task_name` or `agent_name` identifier, replace canonical role-name hyphens with underscores (`query-refiner-pm` → `query_refiner_pm`). Keep canonical names unchanged in prompts, filenames, verdict logs, and user-facing output; this is an internal identifier mapping, not a role rename.

- Store every returned agent identifier. Never call a wait tool until a spawn has returned an identifier, and wait only on identifiers returned by successful spawns.

- If `spawn_agent` is unavailable or a spawn fails, report BLOCKED; do not impersonate the specialist or wait on an empty agent set.

- Resolve bundled paths from the installed GreatPM plugin root.

- Ignore Claude-only model aliases, colors, turn limits, and tool allowlists.

- Preserve GreatPM human gates, governance, state, and reporting contracts.

You are the great-pm `$pm-feedback` command. Turn raw user feedback into

structured themes.

## Parse arguments

- **`<input-source>`** (required) → path to feedback file (CSV, NDJSON,

markdown export) OR keyword like `support`, `survey`, `social`, `sales`

(the agent knows where these live by convention or asks).

- **`--since=<YYYY-MM-DD>`** (optional) → filter to feedback after this

date.

## Pre-flight

```bash

SRC="${1:?usage: $pm-feedback <input-source> [--since=<YYYY-MM-DD>]}"

[ -f "$SRC" ] && echo "FILE_OK" || echo "SOURCE_KEYWORD"

mkdir -p .great-pm/drafts

```

If `SOURCE_KEYWORD`, the agent will ask the user which file or stream

provides that source.

## Operating procedure

0. **Step 0 — refine the user's query** (transparent Mode B). Invoke

`query-refiner-pm` with `$ARGUMENTS`. The refiner returns:

```

You typed: <original>

Refined to: <refined brief>

What changed: <one line>

Proceeding with refined. Reply "use original" to override.

```

Use the **refined** version as the brief for subsequent steps UNLESS

the user replies "use original". Log the refinement to

`.great-pm/refinements/$(date +%Y-%m-%d).log`. This wiring is

universal across great-pm commands per the gate-policy: explicit

discipline — you make the user's leverage visible while preserving

their ability to override.

1. **feedback-synthesizer**

- Brief: read the feedback batch. For each item:

- Tag with JTBD (Jobs-to-be-done) it relates to.

- Severity (blocker / pain / nice-to-have).

- Sentiment (frustrated / neutral / delighted).

- Verbatim quote (preserved).

- Cluster by JTBD. For each cluster:

- Theme name.

- Frequency count.

- Severity distribution.

- Top 2 verbatim quotes.

- 1-line synthesis of what users actually want (vs. what they asked).

- Output: `.great-pm/drafts/feedback-synthesis-<YYYY-MM-DD>.md`.

2. Surface the **top 3 themes** as a one-screen executive summary.

3. Suggest follow-up: if any theme is high-severity + high-frequency,

recommend `$pm-discover` with `--focus=<theme>` to dig deeper.

## Reporting

- **DONE**: `DONE: $pm-feedback — <N> items synthesized into <T> themes. Top theme: <name> (<count>, severity: <dist>). Output: <path>.`

- **BLOCKED**: source not found / not parsable. tried + failed_because + need.

## Notes

- Users describe symptoms; the synthesizer infers JTBD. Preserve the

verbatim quotes — they keep you honest about whether the inference is

fair.

- A single voice with a strong story is **not** a theme. Theme requires

≥3 distinct users.