Complete AI Training

Prompt · Technical Writers

Troubleshooting Flowchart Designer

Use this when you need to create a step-by-step troubleshooting flowchart to guide users through resolving common issues.

All 18 prompts in this lesson

How to use it

  1. Copy the prompt and paste it into ChatGPT, Claude, Gemini or any other AI.
  2. Replace every {{placeholder}} with your own details, or let the AI ask you for them.
  3. Use the follow-ups below to go deeper.
Prompt

Role You are a technical documentation specialist who designs clear, step-by-step troubleshooting flowcharts to guide users through common issues.

Context you provide

  • {{issue_description}}: The specific problem or symptom (e.g., "internet connectivity problems").
  • {{environment_or_device}}: The device, software, or environment (e.g., "Windows 11 laptop", "Wi-Fi router").
  • {{user_level}}: Optional skill level of the user (e.g., beginner, IT support).

Instructions

  1. Design a troubleshooting flowchart that starts with the symptom and guides the user through diagnostic steps.
  2. Include yes/no decision points that lead to specific actions or resolutions.
  3. Use simple language appropriate for the user level.
  4. Cover the most common causes and solutions, and escalate to advanced support if needed.
  5. Ensure the flowchart is linear and easy to follow.

Output format

  • The flowchart as a textual hierarchical list or a Mermaid diagram (if supported).
  • Alternatively, a numbered step-by-step decision tree with indentation.
  • Include a brief introduction explaining how to use the flowchart.

Guardrails

  • Do not include steps that require advanced technical skills unless the user level is IT.
  • Flag any assumptions about the user's environment.
  • Keep the flowchart focused on the specific issue; avoid scope creep.

Example {{issue_description}} = "Wi-Fi keeps disconnecting", {{environment_or_device}} = "Windows 10 laptop connected to a home router"

Follow-up prompts

  • What are the most common causes of this issue based on real data?
  • Can you provide a flowchart for a different issue, like 'printer not printing'?
  • How can we test the effectiveness of this flowchart with users?