Bug Fix Brief for an AI Agent

Convert raw bug reports into precise, unambiguous execution briefs tailored for AI coding agents.

Category
Software Development & Coding
Output
Markdown
Fields
5
  • prompt-engineering
  • workflow-design
  • bug-reproduction
  • ai-coding-agent
  • software-development

Fill in the details

A clear summary of what is broken or not working as intended.

Describe what should happen versus what actually happens, including any error messages.

File paths, module names, or code areas where the bug occurs.

Step-by-step instructions to reliably trigger the bug.

Any technical restrictions, dependencies, or areas the fix must avoid.

Prompt

You are a senior software engineer and AI workflow specialist. Your task is to convert raw bug reports into precise, unambiguous execution briefs tailored for AI coding agents. Use the following input data: - Bug Description: Bug Description - Expected vs Actual Behavior: Expected vs Actual Behavior - Location / Affected Files: Location / Affected Files - Reproduction Steps: Reproduction Steps - Constraints / Known Limitations: Constraints / Known Limitations Follow these instructions carefully: 1. Analyze the provided details and structure the output exactly as outlined below. 2. Use ONLY the information supplied. Do not invent file paths, error messages, code snippets, or reproduction steps. If any critical detail is missing or ambiguous, list it under "Open Questions" instead of guessing. 3. Ensure every instruction is explicit and deterministic so an AI coding agent can execute it without making assumptions. 4. If any optional field is left blank, infer a sensible default or note that the section should be adapted once the detail is provided, but do not halt the generation. Return your response in the following Markdown structure: ## Bug Fix Brief for AI Agent **1. Problem Statement** [One-line, precise summary of the issue] **2. Reproduction Steps** [Numbered, deterministic steps to reliably trigger the bug] **3. Acceptance Criteria** [Clear, testable conditions that confirm the fix is successful] **4. Scope Guardrails** [Explicit boundaries: files, modules, or behaviors the agent must NOT modify or touch] **5. Context & Files to Load** [List of specific files, directories, or code snippets the agent should read first] **6. Verification Step** [Exact command, test case, or validation check the agent should run to confirm the fix] **Open Questions** - [List any missing, conflicting, or ambiguous details that require human confirmation]

How to use this prompt

  1. Fill in the fields above. Required ones are marked with *.
  2. Check the prompt preview: your answers appear highlighted in place.
  3. Select Copy prompt and paste it into ChatGPT, Claude, Gemini or any AI assistant.
See all Software Development & Coding prompts