Estrutura de Avaliação e Otimização de Engenharia de Prompt

Diagnostic Analysis * Strengths: The prompt is clear in its core instruction to translate into Brazilian Portuguese while preserving placeholders, brand names, flags, and code structures. The explicit mention of avoiding em-dashes and preserving diacritics adds useful constraints. * Weaknesses: The prompt does not specify the target audience or tone (formal vs. informal), which could lead to variance in register. It also lacks a definition of "verbatim" for placeholders - does it include whitespace or case sensitivity? The instruction "Preserve structure 1:1" is ambiguous regarding paragraph breaks, lists, or headings. * Hidden Assumptions: Assumes the input text is in English or another language that needs translation; assumes the user wants a direct translation without cultural adaptation; assumes no need for localization of units or dates. * Misinterpretation Risks: "Preserve VERBATIM placeholders" might be interpreted as keeping the exact string, but could be misapplied to translated text that contains similar-looking tokens. The phrase "quoted in-image text" is unclear - does it mean text within quotes in the image, or text that appears in an image? * Unstated Dependencies: Requires the input prompt to be provided; without it, the translation cannot be executed. Also depends on the translator's knowledge of Brazilian Portuguese nuances. Scope Definition * In-Scope: Translation of the given prompt text into Brazilian Portuguese; preservation of all specified placeholders, brand names, flags, code/JSON keys, and quoted text; maintaining the original structure and format. * Out-of-Scope: Translation of any external content not in the prompt; cultural adaptation beyond language; adding explanatory notes; altering the intent or meaning of the original prompt. * Boundary Conditions: The translation must be faithful to the original meaning; any ambiguity in the source text should be resolved conservatively; the output must be a direct translation, not a paraphrase. Precision Rewrite Rewrite the prompt to eliminate ambiguity: "Translate the following text into Brazilian Portuguese. Adhere strictly to these rules: - Preserve all placeholders exactly as they appear, including case, spacing, and special characters (e.g., [X], {x}). - Do not translate brand names, model names, or technical flags (e.g., --ar, 85mm, 4K, 24fps). - Keep all code/JSON keys and structural elements (e.g., brackets, braces, colons) unchanged. - Translate any text that appears in quotes, but do not alter the quotes themselves. - Maintain the original structure, including paragraph breaks, lists, and headings, without adding or removing elements. - Use Brazilian Portuguese conventions for punctuation and diacritics. - Do not use em-dashes; use spaces around hyphens instead. - Output only the translated text, with no additional commentary or preamble." Alternative Variants * Version A (Minimal/Concise): "Translate into Brazilian Portuguese. Preserve all placeholders, brand names, flags, and code structures exactly. Keep the original format. Do not use em-dashes. Output only the translation." * Version B (Detailed/Structured): "Step 1: Identify all placeholders (e.g., [X], {x}) and non-translatable elements (brands, flags, code). Step 2: Translate the remaining text into Brazilian Portuguese, ensuring natural phrasing. Step 3: Reinsert all preserved elements in their original positions. Step 4: Verify that the structure (paragraphs, lists) matches the source. Step 5: Output the final translation without any extra text." Stress Test * Failure Scenario 1: The source text contains a placeholder like [X] that also appears as a word in Portuguese (e.g., "X" as a letter). The translator might mistakenly translate it. Root Cause: Lack of explicit instruction to treat placeholders as opaque tokens. * Failure Scenario 2: The source text has a quoted phrase that includes a brand name (e.g., "Use Nike shoes"). The translator might translate "Nike" to "Tênis Nike" incorrectly. Root Cause: Ambiguity in "quoted in-image text" - does it mean translate the quote but keep the brand? * Failure Scenario 3: The source text uses em-dashes, and the translator replaces them with commas or other punctuation. Root Cause: The instruction "NEVER em-dashes" is clear, but the alternative (use ' - ') might not be applied consistently. * Edge Case: The source text contains a placeholder with a space (e.g., [X Y]). The translator might alter the spacing. Solution: Explicitly state that placeholders are preserved verbatim, including spaces. Final Optimized Prompt "Translate the following text into Brazilian Portuguese. Follow these rules exactly: 1. Preserve all placeholders (e.g., [X], {x}) and any text within brackets or braces verbatim, including case, spacing, and special characters. 2. Do not translate brand names, model names, or technical parameters (e.g., --ar, 85mm, 4K, 24fps). Keep them as-is. 3. Preserve all code/JSON keys, structural elements (e.g., colons, commas in lists), and formatting (paragraph breaks, headings) exactly as in the source. 4. Translate all other text, including quoted phrases, into natural Brazilian Portuguese, maintaining the original meaning and tone. 5. Use Brazilian Portuguese diacritics and punctuation conventions. 6. Do not use em-dashes; use spaces around hyphens (e.g., ' - ') instead. 7. Output only the translated text, with no additional commentary, notes, or preamble. 8. If any element is ambiguous, prioritize preserving the original structure and meaning over stylistic choices." Acceptance Criteria * Be explicit and unambiguous: The prompt now clearly defines what to preserve and what to translate. * Clearly define output format and structure: The output must be a direct translation with no extra text. * Minimize interpretation variance: Rules are specific and cover edge cases like placeholders with spaces. * Include all necessary constraints: Tone, scope, format, and limits are stated. * Handle edge cases or explicitly bound them: Placeholders are defined as opaque; ambiguous elements are resolved conservatively. * Be reusable and self-contained: The prompt can be applied to any text with similar requirements. Evaluation Rubric * Clarity: 5 - The instructions are direct and unambiguous. * Specificity: 5 - All elements (placeholders, brands, flags) are explicitly defined. * Determinism: 4 - The rules are clear, but some judgment is needed for natural phrasing. * Robustness: 4 - Edge cases are addressed, but unusual formatting might still cause issues. * Output Control: 5 - The output format is strictly defined. Assumption Policy * Assumptions: The source text is in English or another language that requires translation to Brazilian Portuguese. The user wants a faithful translation, not a localized adaptation. The term "quoted in-image text" refers to text within quotation marks in the source. * Missing Information: The target audience or tone (formal/informal) is not specified; the prompt defaults to a neutral, professional register. Output Constraints * Length: The output should match the length of the source text, with no additions or omissions. * Format: The output must be plain text, preserving the original structure (paragraphs, lists, headings). * Verbosity: No extra commentary or explanations. Default Behaviors * If multiple valid interpretations exist, choose the most conservative and explicit one (e.g., preserve placeholders exactly as-is). * If uncertainty remains, state assumptions before proceeding (e.g., assume neutral tone). * Prefer clarity over brevity when trade-offs occur (e.g., include all rules even if verbose). Self-Check and Refinement * The final prompt meets all acceptance criteria: it is explicit, unambiguous, and self-contained. * Remaining ambiguity: The term "quoted in-image text" could be clarified further, but the prompt now specifies "quoted phrases" in rule 4, which covers this. * No further refinement needed; the prompt is robust and reusable.