Prompt

Writing & EditingPromptIn a pack

Documentation Information Architecture Redesign by User Need

Restructures a sprawling documentation site around what readers are trying to do — tutorials, how-to guides, reference and explanation kept separate — with a new navigation, page inventory mapping, redirects and a migration plan.

  • Role-Based
  • Step-by-Step
  • Constraints
  • Structured Output

Opening lines · ~347 words in full

ROLE: You are a documentation architect who has rescued docs sites that grew page by page with no plan. You organise content by the reader's need at that moment — learning, doing, looking up, or understanding — and you never break inbound links during a move.

CONTEXT: The product and its main …

Written by the PromptCorrectly team© 2026 PromptCorrectly · All rights reserved

How to use it

  1. Read it, then replace anything in [BRACKETS] with your details — the more concrete the context, the sharper the answer.
  2. Copy it (or download the .md) and paste it into the AI you already use — it knows your work, so that is where the prompt does the most.
  3. Want a sharper answer? Ask the AI to check its own draft against your brief before it replies — that is self-critique prompting.

Techniques in this prompt

Role-Based

Assigns the model an expert persona so it adopts the right vocabulary, depth, and standards for the task.

Learn this technique
Step-by-Step

Forces explicit intermediate reasoning instead of jumping to a conclusion, which improves accuracy on hard tasks.

Learn this technique
Constraints

Sets the rules and boundaries — tone, length, what to avoid — that keep the output on-target.

Learn this technique
Structured Output

Pins the response to a defined structure so it drops straight into your workflow.

Learn this technique

Works with

Any chat AI — ChatGPT, Claude, Gemini, Copilot, Grok, Mistral or a local model. The structure does the work, so you are not tied to one vendor or one model version.

New to structured prompts? Start with how to prompt AI, the RCTCO prompt framework this prompt is built on, and role prompting examples.

More in Writing & Editing

Governance Forum Thread Summary for Busy VotersSummarises a long, heated governance forum thread into positions, evidence, open questions and what a vote would change — fair to every side — so voters decide on substance, not volume.Portfolio Project Captions, Titles and Alt TextWrites tight titles, grid captions, one-line outcomes and accessible alt text for every project in your portfolio so a reviewer understands each piece at a glance.Write a LinkedIn Recommendation for a Colleague That Says SomethingWrites a specific LinkedIn recommendation for a colleague, manager or report from one real story, in three lengths, with the right relationship label and nothing you cannot stand behind.Our Story Page for an Owner-Run or Family BusinessTurns an owner's real history, values and people into an honest, warm story page for a small business website, ending in a clear reason for the reader to visit or get in touch.