# Clarity

### Introduction

Clarity is Duvo's process documentation and analysis system. It helps you capture how work actually gets done — through video recordings, AI voice interviews, and documents — then uses AI to turn those captures into structured documentation with cost-benefit insights.

Whether you're onboarding new team members, evaluating automation opportunities, or standardizing operations, Clarity gives you a clear picture of your processes.

***

### Key Capabilities

* **Capture processes** via screen recordings, AI voice agent interviews, and uploaded documents
* **AI-powered video analysis** that extracts steps, systems used, and decision points
* **Automated documentation generation** with cost-benefit analysis
* **Industry-specific benchmarks** for retail, grocery, and CPG workflows
* **Sharing and collaboration** through public links

***

### Quick Start: End-to-End in 5 Steps

1. Open the **Clarity** section in the sidebar and click **New Process**. Give it a name that describes the workflow (e.g., "Monthly Inventory Count").
2. Add at least one capture — a voice interview, video recording, or document. See the step-by-step guides below.
3. Configure your team settings (company name, industry, team size, hourly rate) so Clarity can calculate cost-benefit figures.
4. Click **Start Analysis**. Clarity combines all captures and generates a structured process document with a BPMN diagram.
5. Review the output, edit the Transformation Guidance if needed, and share the process via a public link.

***

### How to Conduct a Voice Interview

A voice interview is a conversation with an AI agent that asks you questions about a process and records your answers automatically. This is the fastest way to capture process knowledge — no typing required.

1. Open the process you want to document.
2. Click **Add Content** and select **Start Voice Interview**.
3. Your browser will ask for microphone access. Click **Allow**.
4. Select your preferred interview language — English, Czech, French, German, Polish, or Spanish.
5. Click **Start** to begin the interview. The AI agent will introduce itself and start asking questions about the process.
6. Answer naturally. The agent will ask follow-up questions to capture details, decision points, and exceptions.
7. If you need to pause (e.g., someone walks in), click the **Mute** button. Click **Unmute** when you are ready to continue — the interview picks up where you left off.
8. When you have covered everything, click **End Interview**.
9. Click **Save Interview** to save your answers. A confirmation message appears once the interview is saved.

**Tips for a good interview:**

* Find a quiet space — background noise can affect the AI agent's ability to hear you.
* Describe the process as if you are explaining it to a new colleague.
* Mention specific tools, systems, and people involved at each step.
* If you make a mistake, just correct yourself — the AI will use the most recent version.

***

### How to Upload a Video Recording

Upload a screen recording or video walkthrough of someone performing the process. Clarity uses AI to analyze the video and extract individual steps, tools used, and decision points.

1. Open the process you want to document.
2. Click **Add Content** and select **Upload Video**.
3. Select or drag-and-drop your video file.
4. Wait for the upload and analysis to complete. Clarity processes the video automatically — this may take a few minutes depending on the video length.
5. Once analysis is done, the capture appears in the process with a summary of the extracted content.

**Supported formats:** MP4, MOV, WebM, MPEG, AVI, FLV, WMV, 3GP. **Maximum file size:** 2 GB.

**Tips for a good recording:**

* Record the entire process from start to finish, including any waiting or decision points.
* Use a screen recorder if the process happens on a computer — this captures the exact screens and clicks.
* Narrate what you are doing as you go ("Now I open the ERP system and navigate to Purchase Orders..."). Narration helps the AI produce a more accurate breakdown.

***

### How to Upload a Document

Attach an existing SOP, process guide, or reference material. Clarity extracts the text and uses it alongside other captures during analysis.

1. Open the process you want to document.
2. Click **Add Content** and select **Upload SOP**.
3. Select or drag-and-drop your document file.
4. Wait for the text extraction to complete. The capture appears in the process once it is ready.

**Supported formats:** PDF, TXT, Markdown (.md). **Maximum file size:** 10 MB.

***

### How to Invite Contributors

You can invite subject matter experts to add their own captures to a process — even if they do not have a Duvo account yet.

1. Open the process you want others to contribute to.
2. Click the **Invite** button.
3. Enter one or more email addresses and send the invitation. You can invite multiple people at once.
4. Each invitee receives an email with a link to the process.
5. When an invitee opens the link, they see a simplified view where they can start a voice interview or upload a video.
6. Their captures appear in the process alongside yours, grouped by contributor.

Invited users who are new to your team are automatically added with the **Clarity Member** role (see below).

***

### How to Generate and Review Documentation

Once you have added at least one capture and configured your team settings, you can generate the process documentation.

#### Generate

1. Open the process.
2. Click **Start Analysis**.
3. Clarity processes all captures and generates a structured document. A progress indicator shows which sections are being built.
4. Wait for generation to complete.

#### Navigate the output

The process view uses an immersive layout: the BPMN process diagram fills the full canvas, with a floating tab switcher overlaid on top. Select a tab to open a side panel alongside the diagram.

The diagram supports interactive navigation: use the controls overlaid on the canvas to zoom in, zoom out, fit the entire diagram to the view, or download the diagram as an SVG file. You can also pan by clicking and dragging the canvas.

| Tab                         | Content                                                           |
| --------------------------- | ----------------------------------------------------------------- |
| **Vision**                  | Where the process could go — what an optimized version looks like |
| **Overview**                | Summary of how the process works today                            |
| **Impact**                  | Projected financial impact and time savings                       |
| **Steps**                   | Step-by-step breakdown of each stage                              |
| **Risk & Vulnerabilities**  | Identified risks, gaps, and exception points                      |
| **Transformation Guidance** | Editable guidance that shapes the automation strategy             |

#### Share

1. Open the completed process.
2. Enable the **Share** toggle.
3. Copy the public link and send it to anyone — they do not need a Duvo account to view the documentation.

The shared view uses the same immersive layout as the private view.

***

### How to Regenerate Documentation

If you add new captures, want to incorporate feedback, or need a more thorough analysis, you can regenerate the documentation at any time.

1. Open the completed process.
2. Click **Regenerate Documentation**.
3. Optionally enter **Additional details** — any extra context or instructions that should inform the new documentation. This is useful when the existing captures do not tell the full story or when you want to emphasize specific aspects of the process.
4. Confirm the regeneration.

Regeneration replaces the existing documentation with a new version based on all captures and any additional details you provide. While documentation is regenerating, all tabs are disabled and the diagram canvas shows a loading state. Wait for generation to complete before switching tabs.

***

### Configure Team Settings

Before generating documentation, set up your team context so Clarity can provide accurate cost-benefit analysis.

1. Open **Settings** in your team space.
2. Navigate to the **Clarity** section.
3. Fill in the following fields:

| Setting      | Description                                                 |
| ------------ | ----------------------------------------------------------- |
| Company name | Your organization's name                                    |
| Industry     | Sector for relevant benchmarks (e.g., Retail, Grocery, CPG) |
| Team size    | Number of people involved in the process                    |
| Hourly rate  | Average labor cost for time calculations                    |
| Revenue      | Annual revenue for ROI context                              |
| Currency     | Your preferred currency for financial figures               |

These settings apply to all processes in the team and are used to calculate financial impact and time savings in the generated documentation.

***

### Process Statuses

Each process moves through the following stages:

| Status         | Meaning                                        |
| -------------- | ---------------------------------------------- |
| **Draft**      | Process created, no captures yet               |
| **Collecting** | Captures are being added and analyzed          |
| **Generating** | Documentation is being generated from captures |
| **Complete**   | Documentation is ready to review and share     |

***

### Clarity Member Role

Team members with the **Clarity Member** role have a focused, interview-only experience. When a Clarity Member opens a process:

* Only the voice interview option is shown — video upload and document upload are not available
* They can see and manage captures they have personally added
* Their captures are visible to process owners and admins alongside other contributions

This role is designed for subject matter experts who contribute process knowledge through interviews without needing full Clarity access. Admins can invite Clarity Members from team settings — enter one or more email addresses at once to send bulk invitations in a single step.

***

### Key Takeaway

Clarity turns informal knowledge — videos, voice interviews, and documents — into structured, actionable process documentation. Use it to understand how work gets done today and identify where automation can save time and cost.