Producer review

What it is

The Producer review CLI is a local command line tool that scans your repo and generates a single prompt. You paste that prompt into Codex or Claude Code to get a plain English report on what the system does, where trust changes, and what to check before you ship.

If gate D or E fails, do not ship yet.

What you get

The report produced from the prompt includes:

A system map in plain language
Trust boundaries
Failure and recovery notes
Hard gates checklist
A short path forward

When to use it

Before a release that includes AI or automation
When you are unsure how data flows through the system
When a partner or customer asks for a risk review
After major refactors or new integrations
When you need a shared summary for non technical stakeholders

How it works

Download the zip and unzip it near the repo you want to review.
Run the Python script with your repo path, mode, and builder intent.
Open the generated PRODUCER_REVIEW_PROMPT.txt file.
Paste it into Codex or Claude Code and ask for the report.
Review the gates, fix issues, and document the next steps.

Quick run example:

python3 /path/to/producer-review-cli/producer_review.py --repo . --mode repo --builder-intent "What I think this system does"
python3 /path/to/producer-review-cli/producer_review.py --repo . --mode repo --builder-intent "What I think this system does" --out PRODUCER_REVIEW_PROMPT.txt --write-report-template
python3 /path/to/producer-review-cli/producer_review.py --repo . --mode pr --staged --builder-intent "What my change is supposed to do" --out PRODUCER_REVIEW_PROMPT.txt
python3 /path/to/producer-review-cli/producer_review.py --repo . --mode pr --base main --head feature/my-change --builder-intent "What my change is supposed to do" --out PRODUCER_REVIEW_PROMPT.txt

Privacy

This runs locally on your machine and does not upload your code. You decide what to paste into another tool.

Common questions

Do I need to know how to code

No. The report is written for builders who want clear guidance without digging into source files.

Does this send my code anywhere

No. The CLI runs on your machine and writes a prompt file. If you paste the prompt into another tool, that content is shared there.

Will it fix the code for me

No. It gives you a report and a short path forward so you can decide what to change.

What if a gate fails

Stop and resolve the issue or document a clear mitigation before moving forward.