User guide/Writing with AI

CHAPTER 25

Confirmation Cards and Safe Writes

Review structured changes before they reach project data.

On this page

When a request would modify prose, titles, outlines, settings, or chapters, the Agent should present a structured candidate and a relevant action such as write, append, replace selection, save outline, create record, accept, skip, rewrite, or comment.

The card should identify the target, before/after difference, affected scope, write conditions, sources, review state, and undo path. If a request could mean either discussion or writing, clarify the intent first.

If the action is missing, verify that the prompt names both target and operation, wait for the run, reload the saved conversation, retry, then send a short explicit instruction. Keep the screenshot, task time, and model name if it still fails. Avoid manually replacing a whole chapter, which loses the diff and audit trail.

After confirmation

Follow the write through three stages: the formal write, persisted readback, and knowledge synchronization. The task is complete only after the official content can be read back and its required synchronization finishes. If prose is already written but knowledge synchronization fails, use the preserved recovery action to retry synchronization. Do not regenerate the prose or repeat the create action. After reopening the project, recovery should still refer to the original task and leave only one official copy.

Still need a hand?

Send your version and steps so we can take a look.