Improving documents

Improve a document reviews a PRD, spec or brief for strategy, structure, clarity and completeness, then suggests specific text changes. Bring the document in from your computer, Google Drive, SharePoint or the clipboard, or let ChatPRD review a Google Doc in place and publish its suggestions straight into the Doc.

Open Improve a document

Any of these opens the Get document feedback page at app.chatprd.ai/improve-doc:

• On the new chat screen, click Help me improve an existing document.
• In the document editor header, click Improve.
• Go to the link directly. Older /doc links redirect here.

Bring in your document

Pick where the document comes from:

For pasted text and imported files, check the content, then click Get feedback. Nothing is added to your sidebar until you do. To review a Google Doc in place, skip to Review a Google Doc.

Understand the analysis

ChatPRD scores your document on four dimensions, and you can watch each step as it runs:

• Strategy: problem definition, solution strength and value proposition.
• Structure: headings, sections and how the document is organized.
• Clarity: sentence complexity and plain language.
• Completeness: missing sections and content gaps.

When the analysis is done, you get:

• An overall score out of 10, with a summary of strengths and areas to improve.
• Top priorities: the three changes that will make the biggest difference.
• Category scores for each dimension, with specific recommendations.

Review suggestions

Click View suggestions to see specific text changes, organized by section. Each suggestion explains what to improve and why, with a diff of the original text (red) and the suggested replacement (green). Use Show diff and Hide diff to expand or collapse it, and tick suggestions off as you review them. When you're done, click Save and continue.

Review a Google Doc

1. Click Review in Google Docs and choose the Doc. You need edit access to it, and Google Drive must be connected.
2. The review starts on its own. The Doc appears as one continuous page, and the ChatPRD review panel shows an overall score, a score for each category, and a list of suggestions.
3. Each suggestion is anchored to the exact passage it's about, highlighted on the page. Comments your collaborators already left in Google Docs are highlighted in yellow so you can see them in context.

Publish suggestions to the Doc

• Publish one: click Suggest edit or Comment on a card, or Edit first to change the wording before it goes out.
• Publish all: click Publish all to send everything that's left. Items publish one at a time, and each card turns green (Suggested in Google Docs or Commented in Google Docs) with a View link.

ChatPRD re-checks the Doc before every publish, so suggestions land in the right place even if someone is editing at the same time. Where Google won't accept a suggested edit, ChatPRD posts it as a comment with your wording. If ChatPRD can't confirm that Google received something, the card says Check Google Docs, and the item is never sent twice.

Add your own feedback

Select any text on the page and click Comment on this to write your own comment or suggested edit, then click Publish to Google Docs. Card status survives a page refresh, but leaving the page clears it.

Tips for best results

• Include the full document for the most complete feedback.
• Use clear section headings so ChatPRD can follow the structure.
• Start with the top priorities for the biggest improvement.
• Use the diff view to see exactly what each suggestion changes.