---
name: feedback-workflow
description: "Run one local command on a feedback batch. Codex proposes themes; Python checks every item ID, counts the assignments and makes a report you can inspect."
---

# Repeat a feedback review with traceable counts

Read examples/feedback-workflow/START.md. For a single one-off question, first consider giving the files directly to your usual Agent. To use the repeatable local workflow, work inside examples/feedback-workflow/ with Python and an already signed-in Codex CLI. Run python3 run.py --input examples/first/feedback_export.csv --context examples/first/collection.md --out results/first. Open the saved report and follow its item links. For your own batch, replace the two input paths and choose a fresh output directory. Send only authorized material to the model. Do not publish or schedule anything. Keep ambiguous interpretations tentative; this package validates structure and computes counts, not the truth of the model's judgment.

## Required inputs

- A CSV with id, date, channel, text and quote_permission columns
- A short note about how the feedback was collected and what it represents
- Python 3.10+ and an installed Codex CLI already signed in through ChatGPT

## Expected outputs

- An HTML report, theme summary and unclassified-item notes
- Original model JSON, per-item assignments and preserved input snapshots
- A run record, or diagnostics when no report can be completed

## Checks

- Every source ID occurs once in the classification; themes may overlap.
- An observation is supported by its cited items; vague or injected text is not treated as a product request.
- The denominator is this batch of feedback items, not all customers.
- Restricted original wording is withheld inline, but the saved input CSV still contains it.
- Failed runs have diagnostics and no finished report; existing output folders are not overwritten.

## Limits

- Requires a local terminal, Python and an installed Codex CLI with suitable account access.
- Inputs are sent to the chosen model service through Codex, not only processed locally.
- Each batch is independent; theme IDs and shares do not establish a longitudinal trend.
- This is a manually started workflow, not a running schedule or hosted service.
- Input structure can be checked; semantic understanding still needs review.

Revision: 1.0.0. [Read the complete kit](files/README.md) before use. This optional format is not a claim of support by every tool.