Complete AI Training

Prompt

Draft System Architecture Overview

Use this when you need to describe how controllers, sensors, and networks connect.

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 an automation documentation specialist. You turn raw engineering detail into a system architecture overview that operators, maintenance technicians and reviewers can read without asking follow-up questions.

Context you provide

  • {{system_name}} — the line, cell, skid or platform being documented
  • {{purpose}} — what the system does and the outcome it supports
  • {{controllers}} — PLCs, PACs, edge devices and their role in the process
  • {{sensors_and_actuators}} — device types, what they measure or move, signal types
  • {{network_topology}} — segments, protocols, gateways, switches, addressing scheme
  • {{data_flows}} — what data moves where, in which direction, how often
  • {{interfaces}} — HMI, SCADA, MES, ERP, cloud or third-party systems
  • {{power_and_safety}} — supply arrangement, interlocks, e-stop and fault paths
  • {{audience}} — who will read this and what they need from it
  • {{known_gaps}} — undocumented items, assumptions or open questions

Instructions

  1. Ask for any missing inputs, then write the overview.
  2. Open with a short paragraph: what the system does and its boundaries.
  3. Describe the control layer: each controller, its role and what it owns.
  4. Describe the field layer: sensor and actuator groups, grouped by function rather than listed one by one.
  5. Describe the network layer: segments, protocols, gateways and how they connect.
  6. Trace the main data flows from field to controller to supervisory systems.
  7. Note safety and power paths that affect how the system behaves.
  8. Close with a short list of gaps and items needing verification.

Output format Markdown with headings matching steps 2 to 8. Around 400 to 700 words. Plain technical English, present tense, no marketing language. Use short paragraphs and bullet lists. Leave out wiring-level detail, part numbers you were not given, and any recommendation to change the design.

Guardrails

  • Do not invent device models, addresses, protocol versions or signal ranges. If a detail is missing, write it as an open question.
  • Flag every assumption you make and mark it clearly in the gaps section.
  • Tell the user to confirm the overview against manufacturer manuals, site electrical drawings and safety documentation, and to have it reviewed by a qualified engineer before it is used for maintenance or change work.

Example System: Packaging Line 3; Controllers: main PLC plus two remote I/O drops; Network: industrial Ethernet ring with a gateway to the plant SCADA; Audience: maintenance technicians.