The most common failure is a reviewer that hands back a rewritten draft. You lose the ability to see what changed, you lose the location of each problem, and you introduce new unreviewed text. Prevent it with an explicit output contract.
You are a disclosure reviewer. You do not edit, rewrite, summarize
or praise. You return findings only.
Draft: <<<DRAFT>>>
Checklist, apply every item to every paragraph:
1. Secrets: keys, tokens, connection strings, internal hostnames,
private emails, phone numbers, customer identifiers.
2. Internal names: any of these strings, case-insensitive:
[BANNED_TERMS]. Also flag capitalized names that look like
unreleased products or internal projects.
3. Claims: superlatives, competitor comparisons, performance
numbers, dates, "first" claims. For each, state what evidence
would be needed.
4. Tone: sarcasm, blame aimed at a person or team, promises of
support, jokes at a third party's expense.
5. Missing context: undefined acronyms, metrics with no period,
relative time references with no anchor.
Return a table with exactly these columns:
category | quoted text (max 20 words) | paragraph number |
why it is a risk | suggested fix as an instruction, not rewritten prose
If a category has no findings, write the category name and "none".
Do not output anything outside the table.
Three design choices in that prompt matter more than the wording.
First, quote and locate. A finding without a location costs the human reviewer a search. A finding with a 20-word quote and a paragraph number takes seconds to verify.
Second, fix as instruction. "Replace the account number with a placeholder" is actionable. A rewritten sentence is a new draft that nobody reviewed.
Third, one pass, one job. Combining accuracy, structure and style in one pass risks letting accuracy issues slip through, which is why documentation reviewers are advised to separate those checks (Document360). The same logic applies here: run the disclosure pass on its own, then a separate edit pass if you want one.
There is a useful experiment on prompt style worth knowing about. A case study comparing three prompting strategies on the same artifact found that contrastive prompting, which asks the model what a correct review would catch and what a naive review would miss, surfaced 67% of the unique critical issues, while a heavily negative "do not do this" prompt found 8% (Trilogy AI). The takeaway for a disclosure reviewer is to describe what a good finding looks like, with an example, rather than pile up prohibitions. One line does the job:
A good finding looks like this:
secrets | "sk-live-4f2a...c9" | paragraph 6 | live API key |
replace with a redacted placeholder
A bad finding looks like this: "Consider reviewing the tone."
The same literature on structured prompts treats the prompt itself as a versioned artifact kept alongside the material it governs, which is the right habit for a review checklist that will be reused (Martin Fowler). Store the checklist in the repo next to the draft template and treat changes as reviewed changes.
Two operational notes. Long drafts should be chunked by section with a stable paragraph numbering scheme, because a reviewer given a 6,000-word draft starts summarizing. And empty results are a signal, not proof: a reviewer that finds nothing on a draft you know contains a placeholder is broken, so seed a test draft with deliberate violations and check that each category fires.