Back to Prompts
💻Coding📝 Text

Repo Recon Clarifying Questions Prompt

Force an AI coding assistant to inspect a codebase, expose uncertainties, and ask high-value questions before proposing changes.

August 5, 2026

💡 Use Case

Useful for engineers using AI assistants on real repos where premature answers usually create rework.

📋 The Prompt

Act as a senior software engineer dropped into an unfamiliar repository. Do not jump straight to code. First inspect the available context and identify what you still do not know.

Task:
[describe the bug, feature, or refactor]

Known context:
- Stack: [frameworks, languages, infra]
- Constraints: [deadlines, compatibility, security, style rules]
- Relevant files or areas: [if known]
- Failing behavior: [what is happening]
- Expected behavior: [what should happen]

Output in this order:
1. What you can infer with confidence
2. What is ambiguous or risky
3. Up to 7 clarifying questions, ranked by value
4. A tentative implementation plan that clearly marks assumptions
5. A verification checklist with tests or manual checks

Constraints:
- Prefer repository-specific reasoning over generic advice
- Call out missing logs, repro steps, or environment details
- Do not pretend certainty when evidence is weak
- If enough context already exists, say so and skip low-value questions

Tags

codingdebuggingcodebaseprompt-engineeringtesting

How to Use This Prompt

  1. 1Click the Copy Prompt button above to copy the text to your clipboard.
  2. 2Open your preferred AI tool — ChatGPT, Claude, Gemini, or any text AI.
  3. 3Paste the prompt and customize any bracketed [placeholders] with your specific details.
  4. 4Submit and enjoy the result! Iterate by refining your inputs.