Replace punitive "violation" language with constructive alternatives in agent prompts

UAT feedback flagged the use of "violations", "violates", etc. as feeling
accusatory. Replaced all instances with constructive terms ("issues",
"doesn't align with", "doesn't meet") and added an explicit instruction
to all 5 agent prompt templates to avoid this language in output.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
michael 2026-02-19 09:18:52 -06:00
parent 4a684e7757
commit 265bf08470
5 changed files with 10 additions and 5 deletions

View file

@ -136,7 +136,7 @@ IMPORTANT: Do NOT include page numbers, document names, or source citations in y
RAG Status Guidelines:
- **Green**: Fully compliant with brand guidelines, no issues
- **Amber**: Minor deviations that should be addressed but don't severely impact brand integrity
- **Red**: Significant brand guideline violations that must be fixed before use
- **Red**: Significant brand guideline issues that must be fixed before use
If the proof is nonsensical, not a marketing material, or cannot be analyzed, set analysisStatus to 'low_confidence'.
@ -147,6 +147,7 @@ If the proof is nonsensical, not a marketing material, or cannot be analyzed, se
- Start with the issue, then the recommendation
- Example: "Logo placement incorrect (bottom-left) - move to top-right corner per guidelines"
- IMPORTANT: Use British English spelling throughout all output (e.g. "authorised" not "authorized", "colour" not "color", "capitalise" not "capitalize", "organised" not "organized", "centre" not "center", "analysed" not "analyzed").
- IMPORTANT: Never use the words "violation", "violates", or "violated" in your output. Use constructive alternatives such as "issue", "doesn't align with", "doesn't meet", or "conflicts with".
"""
# Determine if revision fields should be included

View file

@ -129,7 +129,7 @@ IMPORTANT: Do NOT include page numbers, document names, or source citations in y
RAG Status Guidelines:
- **Green**: Fully aligned with best practices, optimized for the channel
- **Amber**: Minor improvements could enhance performance but content is acceptable
- **Red**: Significant best practice violations that will impact content effectiveness
- **Red**: Significant best practice issues that will impact content effectiveness
If the proof is nonsensical, not a marketing material, or cannot be analyzed, set analysisStatus to 'low_confidence'.
@ -140,6 +140,7 @@ If the proof is nonsensical, not a marketing material, or cannot be analyzed, se
- Start with the issue, then the recommendation
- Example: "CTA placement below fold - move above fold for better visibility"
- IMPORTANT: Use British English spelling throughout all output (e.g. "authorised" not "authorized", "colour" not "color", "capitalise" not "capitalize", "organised" not "organized", "centre" not "center", "analysed" not "analyzed").
- IMPORTANT: Never use the words "violation", "violates", or "violated" in your output. Use constructive alternatives such as "issue", "doesn't align with", "doesn't meet", or "conflicts with".
"""
# Determine if revision fields should be included

View file

@ -148,6 +148,7 @@ If the proof is nonsensical, not a marketing material, or cannot be analyzed, se
- Start with the issue, then the specification requirement
- Example: "Image resolution 72dpi - increase to minimum 150dpi for print quality"
- IMPORTANT: Use British English spelling throughout all output (e.g. "authorised" not "authorized", "colour" not "color", "capitalise" not "capitalize", "organised" not "organized", "centre" not "center", "analysed" not "analyzed").
- IMPORTANT: Never use the words "violation", "violates", or "violated" in your output. Use constructive alternatives such as "issue", "doesn't align with", "doesn't meet", or "conflicts with".
"""
# Determine if revision fields should be included

View file

@ -148,6 +148,7 @@ Your summary should:
- Do NOT include page numbers, document names, or source citations. Keep all feedback self-contained and actionable.
- For 'Passed': briefly note any amber items in 1-2 bullets
- IMPORTANT: Use British English spelling throughout all output (e.g. "authorised" not "authorized", "colour" not "color", "capitalise" not "capitalize", "organised" not "organized", "centre" not "center", "analysed" not "analyzed").
- IMPORTANT: Never use the words "violation", "violates", or "violated" in your output. Use constructive alternatives such as "issue", "doesn't align with", "doesn't meet", or "conflicts with".
{revision_context}
Here are the specialist reviews:
{self._format_reviews(reviews)}

View file

@ -115,7 +115,7 @@ Analyze the uploaded proof for legal compliance, checking:
4. **Regulatory Compliance**:
- Does the content comply with FCA regulations (if applicable)?
- Are there any ASA/CAP code violations?
- Are there any ASA/CAP code issues?
- Is representative APR shown where required?
5. **Terms and Conditions**:
@ -137,8 +137,8 @@ IMPORTANT: You must include the following fields in your JSON response:
RAG Status Guidelines:
- **Green**: Fully compliant with legal requirements, no issues
- **Amber**: Minor issues that need attention but not critical violations
- **Red**: Significant legal or regulatory violations that must be addressed
- **Amber**: Minor issues that need attention but are not critical
- **Red**: Significant legal or regulatory issues that must be addressed
If the proof is nonsensical, not a marketing material, or cannot be analyzed, set analysisStatus to 'low_confidence'.
@ -150,6 +150,7 @@ If the proof is nonsensical, not a marketing material, or cannot be analyzed, se
- Start with the issue, then the requirement
- Example: "Missing APR disclaimer - add representative APR per FCA requirements"
- IMPORTANT: Use British English spelling throughout all output (e.g. "authorised" not "authorized", "colour" not "color", "capitalise" not "capitalize", "organised" not "organized", "centre" not "center", "analysed" not "analyzed").
- IMPORTANT: Never use the words "violation", "violates", or "violated" in your output. Use constructive alternatives such as "issue", "doesn't align with", "doesn't meet", or "conflicts with".
"""
# Determine if revision fields should be included