> ## Documentation Index
> Fetch the complete documentation index at: https://help.rytz.com.au/llms.txt
> Use this file to discover all available pages before exploring further.

# Improve an existing draft

> Upload or paste an affidavit you've already started. The platform runs a multi-aspect AI audit — coherent theory, priority findings, paragraph-by-paragraph analysis, annexure opportunities, concession advisories, missing evidence, disclosure check.

import { Steps, Step, Frame, Note, Tip, Warning, CardGroup, Card, Check } from '@mintlify/components'

The **Improve** path is for when you have something on the page already — a draft you wrote in a Word document, a previous affidavit you want to update, or text from a lawyer you want to refine. The platform reads it, runs a structured audit across seven dimensions, and produces an annotated, prioritised review.

Route: `app.rytz.com.au/affidavit-preparation/improve`.

## Before you start

<Check>
  * [ ] You have a draft ready — at minimum, a few paragraphs of factual content
  * [ ] Your Master Case File reflects the current matter (so the AI can ground its analysis)
  * [ ] Your Evidence Portfolio has the items you intend to annexure
</Check>

The audit takes 30–90 seconds depending on draft length. The output is a long, dense review — set aside 30–45 minutes to read it carefully and another hour or two to action it.

## The seven audit dimensions

The platform audits your draft against seven separate lenses:

<CardGroup cols={2}>
  <Card title="Coherent theory" icon="diagram-project">
    Does your affidavit tell one consistent story? An affidavit that shifts focus, contradicts itself between paragraphs, or jumps between unrelated topics is harder to follow and easier to undermine.
  </Card>

  <Card title="Priority findings" icon="ranking-star">
    Which of your facts are the strongest? The audit identifies the 3–5 paragraphs that carry the most weight given the orders you're seeking and flags whether they're prominent enough.
  </Card>

  <Card title="Paragraph-by-paragraph analysis" icon="list-ol">
    For each paragraph, the audit identifies admissibility issues (hearsay, opinion, irrelevance), proposes plain-English rewrites, and flags whether annexure support would strengthen it.
  </Card>

  <Card title="Annexure opportunities" icon="paperclip">
    Where in your text could a specific evidence item become an annexure? The audit cross-references your Evidence Portfolio and suggests labels (JL-1, JL-2, ...) for un-annexed assertions.
  </Card>

  <Card title="Concession advisories" icon="handshake">
    Some facts are stronger if you concede them upfront rather than have the other side raise them. The audit flags candidates and explains the reasoning. Concessions are strategic — you decide whether to take the advice.
  </Card>

  <Card title="Missing evidence signals" icon="circle-exclamation">
    The audit identifies factual claims you've made that have no corresponding evidence in your Portfolio, and flags them for follow-up — either find evidence, soften the claim, or remove it.
  </Card>

  <Card title="Disclosure check" icon="shield-check">
    Are you over-disclosing (sensitive material that doesn't need to be in this affidavit)? Under-disclosing (material you're obliged to disclose but haven't)? The check helps avoid both.
  </Card>
</CardGroup>

## Running the audit

<Steps>
  <Step title="Open the Improve surface">
    From the Affidavit Preparation hub, click the **Improve an existing draft** card. Or go directly to `app.rytz.com.au/affidavit-preparation/improve`.
  </Step>

  <Step title="Provide the draft">
    Two paths:

    * **Upload** — DOCX, PDF, or plain text. The platform reads the document, extracts paragraphs, and notes any existing exhibit references.
    * **Paste** — paste the text into the editor. Best for shorter drafts or when you've drafted in Notion / Apple Notes / a chat thread.

    The platform handles both. For DOCX, formatting is preserved on extraction so the audit can see your structure.
  </Step>

  <Step title="Confirm context">
    The platform asks three questions before running the audit:

    * **What stage is this affidavit for?** Initiating Application, Interim hearing, Trial, or other. The stage shapes what "good" looks like.
    * **What orders are you seeking?** Brief description (parenting orders, property orders, both). The audit weighs paragraphs by relevance to the orders.
    * **What's already filed?** Any prior affidavits in this matter, by either party. The audit checks for inconsistency or unhelpful repetition.

    Most of this is auto-populated from your Master Case File. Confirm or correct.
  </Step>

  <Step title="Click 'Run audit'">
    The audit takes 30–90 seconds. While it runs, the screen shows the seven dimensions populating progressively. Don't navigate away — the audit is a single transaction.
  </Step>

  <Step title="Read the output">
    The output is structured by dimension:

    * **Headline summary** — 3–5 sentences, the audit's overall verdict
    * **Coherent theory** — narrative arc analysis
    * **Priority findings** — top 3–5 strongest paragraphs, top 3–5 weakest
    * **Paragraph-by-paragraph** — annotated review, paragraph-by-paragraph; click any paragraph to expand the analysis
    * **Annexure opportunities** — proposed exhibit additions
    * **Concession advisories** — strategic-concession candidates
    * **Missing evidence** — claims without supporting evidence
    * **Disclosure check** — over-disclosure / under-disclosure flags

    Read the headline first, then jump straight to Priority findings + Paragraph-by-paragraph. Those two combined typically drive 80% of the rewrite.
  </Step>

  <Step title="Action the recommendations">
    The audit is read-only. Actioning means going back to the source draft (Word, the platform's [Interactive editor](/affidavits/interactive-editor), or your starting document) and applying the recommendations.

    For platform users, the audit links directly into the Interactive editor with each recommendation marked as a line-level suggestion you can accept, reject, or modify.
  </Step>

  <Step title="Re-audit after material changes">
    After you've applied 5–10 substantial changes, re-run the audit. The previous audit is preserved (under audit history); the new one shows progress.

    A useful target: hit "no priority findings flagged as weak" + "no missing-evidence signals" before you swear and file.
  </Step>
</Steps>

## Reading the output well

A few practices that pay off:

<Tip>
  **Read the headline last, not first.** The headline summary is a synthesis. If you read it first, you anchor on the verdict and read the dimensions defensively. If you read the dimensions first, you form your own view, then check the headline against it. The latter is more useful.
</Tip>

<Tip>
  **Look at the weakest paragraphs first, not the strongest.** Strong paragraphs need light editing. Weak paragraphs are where the affidavit either gets stronger or gets thrown out. The platform sorts findings by impact for this reason.
</Tip>

<Tip>
  **Take concession advisories seriously, but don't act blindly.** A concession can disarm an obvious counter-argument. It can also lock in a bad fact prematurely. The audit explains its reasoning; weigh it against your matter's specifics.
</Tip>

## What the audit will not do

A clear boundary:

* **It will not check facts.** "Lucy left the children unsupervised on 14 March" — the audit cannot tell you whether that's true. It can only check whether you've supplied corresponding evidence.
* **It will not assess your matter strategy.** Whether to pursue interim orders, whether to seek FDR exemption, whether to settle — these are not affidavit-audit questions.
* **It will not write the affidavit for you.** Recommendations are suggestions. You decide what to apply, modify, or ignore. The deponent (you) is responsible for every word.
* **It will not catch every issue.** A senior family-law solicitor reading the same draft would catch things the audit doesn't. For high-stakes affidavits (final hearings, contested matters, FV-substantial matters), get human review before swearing.

## Common patterns the audit surfaces

| Pattern                                       | What it usually means                                                                                                                                  |
| --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Many paragraphs flagged for hearsay           | First-time deponents instinctively recount what others have said. The fix is "I observed \[...]" not "Lucy told me \[...]"                             |
| Strong opinion language flagged               | "Lucy is unreliable" is opinion. "On 14 March, 22 March, and 5 April Lucy did not arrive at the agreed changeover time" is fact.                       |
| Long paragraphs flagged for length            | The Family Law Rules favour short numbered paragraphs (one fact, one paragraph). Audit flags paragraphs above 4–5 lines.                               |
| Annexure opportunities clustered around dates | You've made factual claims with specific dates but haven't supplied corresponding evidence. The Portfolio probably has the items — link them.          |
| Disclosure under-flagged                      | Particularly common for financial affidavits. The Family Law Rules' disclosure obligations are extensive — the audit checks against the standard list. |

## What's next

<CardGroup cols={2}>
  <Card title="Interactive editor" icon="pen-nib" href="/affidavits/interactive-editor">
    Apply audit recommendations inline with paragraph-level AI suggestions.
  </Card>

  <Card title="Create from scratch" icon="pen" href="/affidavits/create-from-scratch">
    For your next affidavit, consider starting in the wizard rather than auditing later.
  </Card>

  <Card title="Bundles for court" icon="folder-open" href="/evidence/bundles-for-court">
    Once the affidavit is final, bundle the annexures into a court-ready PDF.
  </Card>

  <Card title="Affidavit overview" icon="circle-info" href="/affidavits/overview">
    Step back to the framing — what affidavits are, why they're hard.
  </Card>
</CardGroup>
