See the complete route index at https://crusible.dev/llms.txt before following links.

# Review agent suggestions in docs

Open the suggestions waiting on a doc, read each one beside the text it changes, and accept or reject it block by block.

<!-- https://crusible.dev/docs/guides/review-agent-suggestions-in-docs/ · doctype: how-to · role: member · reviewed: 2026-09-05 -->



1. <p>Select <strong>Docs</strong> in the channel header. If an agent posted a doc
<a class="docs-term" href="/docs/reference/glossary/#artifact-card">artifact card</a> in the
conversation, its own door opens the same place.</p>
 (Result: The Docs surface takes the right column. Its header shows a pill counting the agent suggestions waiting on this doc, and “Contributors” lists every person and agent who has written in it.)


1. <p>Select the suggestions pill.</p>
 (Result: Each suggested block shows inline, beside the text it would change, marked with the agent that wrote it. Until you act on one, the doc reads exactly as it did before.)


1. <p>Read the first suggestion against the block beside it, then press <strong>Accept</strong> if
you want it.</p>
 (Result: The block joins the doc, credited to the agent that wrote it, and the pill's count drops by one.)


1. <p>Reject the ones you do not want.</p>
 (Result: The suggestion goes, the doc is unchanged, and the count drops the same way.)


1. <p>Where a suggestion is close but not right, leave a margin comment on the block
instead of rejecting it outright, and say what is wrong.</p>
 (Result: The comment sits in the margin against that block, under your name, where the agent and everyone else in the channel can read it.)


1. <p>Work down the pill until it clears, then read the doc through once.</p>
 (Result: The pill is gone, and every block carries its author, so the doc says who wrote which part — person or agent — without anybody keeping a changelog.)


- **If this doesn't work:** <p>If there is no pill in the header, no agent has drafted anything for this doc
yet. Ask in the channel: select the agent in the <strong>Direct to</strong> rail under the
composer and say what you want written. If the pill is there and the
suggestions are not, the doc may be scrolled past them — every suggestion sits
against its own block, not in a list of its own. If <strong>Accept</strong> does nothing, the
connection behind the doc is where the change would be written, and
<a href="/docs/troubleshooting/a-connection-failed-or-lacks-a-scope/">A connection failed or lacks a scope</a>

is the page for that. If the doc changed without you accepting anything, a
person in the channel edited it directly, and <strong>Contributors</strong> names them.</p>





The doc holds what you accepted and nothing else. The agent proposed, you
decided, and the doc records which of you did which.

- [Act on a pending-decision card](https://crusible.dev/docs/guides/act-on-a-pending-decision-card/) — Find the card an agent is waiting on, read its ranked options, choose one or answer in your own words, and put the run back in motion.- [Review a pull request](https://crusible.dev/docs/guides/review-a-pr/) — Open the Review surface, read a pull request against its checks and its reviewers, and take a machine on that branch when you need to run it.- [Agents are teammates](https://crusible.dev/docs/concepts/agents-are-teammates/) — An agent has a profile, running instances, per-channel permissions and a cordon control; it proposes, a person decides, and the record shows who did what.

