> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bono.network/llms.txt
> Use this file to discover all available pages before exploring further.

# Document Analysis

> Comprehensive AI-powered contract analysis with scoring and risk assessment

## Overview

Arbiter's document analysis system provides comprehensive AI-powered review of contracts and legal documents with:

* Structure extraction and section identification
* Multi-party perspective analysis
* Clause-level risk assessment
* Numerical scoring with configurable algorithms
* Executive summaries and insights

## Analysis Workflow

<Steps>
  <Step title="Upload Your Document">
    Upload a contract (PDF, DOCX, or TXT). Arbiter extracts text and identifies the document structure.
  </Step>

  <Step title="Structure Analysis">
    Click "Analyze Document" to start. AI extracts comprehensive metadata:

    **Document Structure**

    * Sections and hierarchy
    * Cross-references between sections

    **Parties**

    * All party names and roles
    * Party relationships

    **Key Dates**

    * Effective date
    * Expiration date
    * Term length
    * Auto-renewal provisions
    * Renewal notice periods

    **Financial Terms**

    * Contract value or value range
    * Currency
    * Payment terms and schedules

    **Legal Framework**

    * Governing law
    * Jurisdiction
    * Dispute resolution mechanism
    * Liability caps

    **Classifications**

    * Document type
    * Industry tags
    * Regulatory frameworks
    * Missing critical sections
  </Step>

  <Step title="Configure Analysis Options">
    Before running deeper analysis, configure your preferences:

    * **Advanced Reasoning**  -  Toggle for deeper AI analysis (\~1.5x tokens)
    * **GitLaw Research**  -  Enable to include case law and statutory references
  </Step>

  <Step title="Party Analysis">
    Select a party perspective and run analysis. Each section is evaluated for:

    * Clarity issues
    * Enforceability concerns
    * Risk factors
    * Party-specific advantages/disadvantages
  </Step>

  <Step title="Clause Analysis (Optional)">
    Deep dive into individual clauses with:

    * Specific issues identified
    * Suggested revisions
    * Risk ratings
  </Step>
</Steps>

## Analysis Modes

### Standard Analysis

* Fast, comprehensive review
* Single AI model
* Complete scoring and insights
* \~5 - 10 minutes for typical contracts

### Advanced Analysis

* Deeper reasoning and analysis
* Enhanced AI reasoning capabilities
* More detailed insights
* 1.5x token cost
* \~10 - 20 minutes for typical contracts

<Tip>
  Use **Advanced Mode** for complex contracts, high-stakes agreements, or when you need the most comprehensive analysis possible.
</Tip>

## Understanding Scores

Arbiter uses a **0 - 100 scoring system** across three dimensions:

### Clarity Score

Measures how clearly obligations, rights, and terms are expressed. Uses a weighted formula across five sub-components.

**Metrics analyzed:**

* **Undefined Terms** (25% weight)  -  Terms used throughout but never defined
* **Ambiguous Language** (25% weight)  -  Vague phrasing interpretable multiple ways
* **Inconsistencies** (20% weight)  -  Internal contradictions or conflicting statements
* **Structural Issues** (15% weight)  -  Problems with document organization, formatting, or cross-references
* **Factual Concerns** (15% weight)  -  Potentially incorrect or unverifiable factual claims

*Linguistic errors (grammar, spelling) are also factored into the structural component.*

### Enforceability Score

Assesses legal validity and enforceability of provisions. Evaluates whether clauses would hold up in court.

**Metrics analyzed:**

* **Problematic Provisions** (30% weight)  -  Clauses that may face enforceability challenges (e.g., penalty clauses, unconscionable terms)
* **Jurisdictional Issues** (25% weight)  -  Provisions that may conflict with local law or practice
* **Missing/Incomplete Elements** (25% weight)  -  Essential provisions that are absent or unfinished
* **Balance Assessment** (20% weight)  -  Significant asymmetry in rights and obligations, or one-sided provisions lacking mutuality

*An overall imbalance flag triggers a flat penalty; otherwise, individual one-sided provisions are counted.*

### Risk Score

Evaluates business and legal risks using a diminishing returns formula. Higher score = lower risk exposure.

**Metrics analyzed:**

* **Risk Items**  -  Each identified risk has a severity rating (1 - 5); cumulative weighted severity drives the base score
* **Unusual Provisions**  -  Atypical or surprising terms add a penalty (+4% exposure per item)
* **Safeguards**  -  Protective provisions provide mitigation ( - 3% exposure per item, max 20% reduction)

*Risk types include: financial, operational, legal, and reputational exposure.*

## Scoring Methodology

<AccordionGroup>
  <Accordion title="Normalization Algorithms">
    Arbiter offers three scoring approaches:

    **Fixed Window (Legacy)**

    * Static 1,000-word baseline
    * Simple and predictable
    * May not account for document length variations

    **Adaptive Window**

    * Adjusts baseline to actual document length
    * Fair comparison across different sized contracts
    * Recommended for most use cases

    **Adaptive + Bayesian (Default)**

    * Combines adaptive window with statistical smoothing
    * Prevents score instability in short sections
    * Most accurate for enterprise use
  </Accordion>

  <Accordion title="How Scores Are Calculated">
    1. **Metrics Extraction**  -  AI extracts 15 structured metric types (undefined terms, risks, safeguards, etc.) with exact text references
    2. **Rate Calculation**  -  Issue counts are normalized per effective window (typically 500 words) to fairly compare sections of different lengths
    3. **Sub-Score Computation**  -  Each pillar has weighted sub-components that start at 100 and deduct penalty points per normalized issue
    4. **Dampening**  -  Small sections (under 200 words) have dampened penalties; large sections (over 2000 words) have capped penalties
    5. **Quantization**  -  Raw scores are clipped to 0 - 100 and rounded to nearest 5 for consistency
    6. **Overall Score**  -  Equal-weighted average of Clarity, Enforceability, and Risk scores (33.3% each)
  </Accordion>
</AccordionGroup>

## Party Perspective Analysis

Arbiter analyzes contracts from each party's perspective:

<Steps>
  <Step title="Party Identification">
    AI automatically extracts all parties from the contract
  </Step>

  <Step title="Multi - Perspective Analysis">
    Each section is analyzed considering what's favorable/unfavorable for each party
  </Step>

  <Step title="Risk Matrix">
    View comparative scores showing how each section affects different parties
  </Step>
</Steps>

## Key Features

### Executive Summary

AI-generated overview covering:

* Overall assessment
* Key risks and opportunities
* Critical provisions
* Missing clauses
* Recommendations

### Metadata Extraction

Automatically identifies:

* Effective dates and expiration
* Contract value and payment terms
* Governing law and jurisdiction
* Auto-renewal provisions
* Notice periods

### Section Summaries

Each section includes:

* Plain language summary
* Key obligations and deadlines
* Restrictions and limitations
* Protective measures
* Compliance requirements

### Clause - Level Analysis

Deep review of individual clauses with:

* Specific issue identification
* Risk level assessment (Low, Medium, High)
* Suggested revisions
* Enforceability analysis

## Analysis Tabs

<Tabs>
  <Tab title="Section Analysis">
    Overview and risk scoring for each document section. Includes:

    * Section-by-section clarity, enforceability, and risk scores
    * Expandable analysis with detailed findings
    * Filter by category (definitions, obligations, termination, etc.)
    * Party perspective selector
  </Tab>

  <Tab title="Redlining">
    <Warning>This feature is being redesigned and will change in an upcoming release.</Warning>
    Clause-level edits and suggested revisions:

    * AI-generated redline suggestions
    * Track changes view (insertions in green, deletions in red)
    * Accept/reject individual changes
    * Batch apply or revert changes
  </Tab>

  <Tab title="Doc Intelligence">
    AI insights and document relationships:

    * Executive summary with key findings
    * Missing section detection
    * Regulatory framework identification
    * Cross-reference analysis
    * Industry classification
  </Tab>

  <Tab title="Export">
    PDF and DOCX output options:

    * Professional formatting with branding
    * Include/exclude specific sections
    * Track changes preserved in exports
    * Multiple export formats
  </Tab>
</Tabs>

## Advanced Features

### Redlining

<Warning>This feature is being redesigned and will change in an upcoming release.</Warning>

Apply AI-suggested revisions with track changes:

* **Redline Mode**  -  Shows insertions (green) and deletions (red)
* **Replace Mode**  -  Directly applies changes
* **Revert**  -  Undo applied changes
* **Export**  -  Download with track changes preserved

### Version Control

Git-style document versioning:

* Automatic saves on significant changes
* Manual version creation
* Compare any two versions
* Restore previous versions
* View change history with timestamps

### Document Intelligence

AI-powered insights including:

* Missing section detection
* Regulatory framework identification
* Industry classification
* Dispute resolution analysis
* Liability cap extraction

## Best Practices

<Card title="Start with Doc Intelligence" icon="map">
  Review the executive summary in the Doc Intelligence tab first to understand the contract's scope and key findings.
</Card>

<Card title="Compare Party Perspectives" icon="table">
  Use the party perspective selector in Section Analysis to identify provisions with different impacts per party.
</Card>

<Card title="Focus on Red Scores" icon="triangle-exclamation">
  Sections with scores below 60 (orange/red) need immediate attention.
</Card>

<Card title="Review Redlining Suggestions" icon="magnifying-glass">
  For critical sections, review the Redlining tab for specific clause-level issues and AI-suggested revisions.
</Card>

<Card title="Export for Clients" icon="file-export">
  Generate professional PDF reports with your analysis for client presentations.
</Card>

## Limitations

<Warning>
  **Token Consumption**  -  Analysis uses tokens based on document length and complexity. Token costs are displayed before you run analysis so there are no surprises.
</Warning>

<Info>
  **Large Documents**  -  Arbiter handles documents of any length. Larger documents will use more tokens and may take longer to process.
</Info>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Analysis stuck or taking too long">
    * Standard analysis: typically 5 - 10 minutes
    * Advanced analysis: typically 10 - 20 minutes
    * Check your internet connection
    * Refresh the page if stuck over 30 minutes
  </Accordion>

  <Accordion title="Scores seem incorrect">
    * Check which normalization method is selected (Settings → Scoring Methodology)
    * Try "Adaptive + Bayesian" for most accurate results
    * Review the scoring trace to see specific issues identified
  </Accordion>

  <Accordion title="Missing sections in analysis">
    * Some sections may be too short for meaningful analysis
    * Check if the document structure was correctly identified
    * Re-analyze with Advanced Mode for better section detection
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Document Drafter" icon="pen-to-square" href="/guides/document-drafter">
    Create contracts from scratch with AI
  </Card>

  <Card title="AI Research" icon="brain" href="/guides/ai-research">
    Research legal questions with multi-model AI
  </Card>
</CardGroup>