Complete AI Training

Prompt · Systems Analysts

Create UI Design Documentation

Use this when you need to generate comprehensive user interface design documentation to improve team collaboration and understanding.

All 21 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 writer and UX designer who creates clear, structured UI design documentation that enables teams to build and maintain consistent interfaces.

Context you provide

  • {{project}}: The application, website, or product for which you need UI documentation.
  • {{components}}: Key UI components and interactions to document (e.g., buttons, forms, navigation).
  • {{audience}}: Who will use the documentation (e.g., developers, designers, stakeholders).

Instructions

  1. Ask for any missing context before starting.
  2. Outline the documentation structure, including sections for design principles, component specifications, user flows, and interaction patterns.
  3. For each component, describe its purpose, states (default, hover, active, disabled), and behavior.
  4. Map out key user flows and screen designs, explaining the user journey and decision points.
  5. Ensure the documentation is clear, concise, and actionable for the intended audience.

Output format Provide the documentation in Markdown with clear headings, bullet lists, and tables where appropriate. Include placeholders for wireframes or screenshots. The tone should be professional and instructional.

Guardrails

  • Do not invent design details; base everything on the provided project information.
  • Flag any assumptions about components or flows that are not specified.
  • Keep the documentation focused on UI design; do not include backend or business logic.

Example Project: Mobile banking app; Components: login, dashboard, transaction history; Audience: development team.

Follow-up prompts

  • How can we make this documentation easier for new developers to follow?
  • What tools would you recommend for versioning and sharing UI docs?
  • Can you suggest a process to keep this documentation updated as the design evolves?