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
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
- Fill in the fields above. Required ones are marked with *.
- Check the prompt preview: your answers appear highlighted in place.
- Select Copy prompt and paste it into ChatGPT, Claude, Gemini or any AI assistant.
More Software Development & Coding prompts
- Caching Strategy DesignerDesign a robust, production-ready caching strategy for the specified feature, endpoint, or data flow.
- Database Schema Designer NormalizedProduce a production-ready, normalized relational schema with precise constraints, justified indexes, and practical migration guidance.
- Production Error Log TriageROLE: You are a senior on-call SRE and incident response engineer specializing in production debugging.
- Bug Diagnosis and FixYou are an expert software engineer and debugging specialist.
- Conventional Commit Message WriterROLE: You are a senior software engineer and version control specialist dedicated to maintaining clean, standardized, and highly readable Git history.
- Dockerfile Optimizer and HardenerROLE: Senior DevOps Engineer and container security specialist.