Improve a page’s wording and structure
Inspect query intent, answer placement, and supporting evidence, then return an explained rewrite.
When to use this workflow
“Rewrite this page so its answers are easier to find and support.”
Before fetching
Confirm current page text, target questions, readers, and allowed edit scope. Do not turn a writing assessment into a predicted citation probability or future rank.
Complete the CLI quickstart and confirm the workspace with orc workspace current --json. Replace example IDs, URLs, dates, and settings. Apply only approved mutations.
1. Read the target query and citation evidence
Read observed queries and answers to identify the required response, detail, and evidence.
orc fanout-queries list --type search --prompt-id YOUR_PROMPT_ID --json
orc answers list --prompt-id YOUR_PROMPT_ID --json
orc answers get YOUR_ANSWER_ID --json2. Quote the issue and rewrite it
Have the agent quote buried answers, ambiguous subjects, and unsupported claims. Show before, after, and rationale without changing product facts.
3. Prepare a comparable follow-up
Deliver replacement text and a change log. Keep the pre-publication assessment separate from measured citation or answer changes after publication.
Deliverable
Deliver the rewrite or patch, reasons, sources, and the prompts and conditions to measure again.
On fetch failure, retain the error and request scope. Do not count empty data, incomplete pagination, or missing permissions as a completed investigation.
Next steps
If a failure remains, report it and verify the fix, including this workflow and the failed step.