Clarity

Documentation Index

Fetch the complete documentation index at: https://docs.duvo.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

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, phone 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, phone 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 or shareable invite links for external contributors

---

​

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, phone 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 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. A dialog appears with three options:
   • Continue interview — return to the interview if you have more to share.
   • End interview — save the session and complete the interview.
   • Discard — permanently delete the recording and transcript. This cannot be undone.
9. Click End interview to save. The interview appears as a capture in the process once it is saved.

The AI agent may also end the interview proactively when it has gathered enough information. When this happens, the same dialog appears — choose Continue interview if you have more to add, or confirm by clicking End interview. 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 Schedule a Phone Interview

A phone interview lets Duvo call your mobile or landline to conduct the interview. This is useful when you are away from your computer, prefer speaking naturally without headphones, or want to capture process knowledge while doing something else.

1. Open the process you want to document.
2. Click Add Content and select Phone Interview.
3. Enter your phone number in international format with the country code and no spaces (for example, +14155552671).
4. Select your preferred interview language — English, Czech, French, German, Polish, or Spanish.
5. Click Call Me. A 3-second countdown starts — click Cancel if you need to abort before the call is placed.
6. Answer the call when your phone rings. Duvo will introduce itself and guide you through the interview with questions about the process.
7. Answer naturally. Speak as if you are explaining the process to a new colleague. The AI will ask follow-up questions to capture details, decision points, and exceptions.
8. When you have covered everything, say you are done or hang up.
9. After the call ends, the transcript is saved automatically and appears as a capture in the process.

Tips for a good phone interview:

• Find a quiet space before clicking Call Me — background noise affects transcription quality.
• Keep the process name in mind so you describe the right workflow.
• Mention specific tools, systems, and people involved at each step.

Note: Phone interviews are not available for Clarity Members. Clarity Members can use voice interviews from their browser.

---

​

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 Create a Client Invite Link

A client invite link lets you share a specific process with an external stakeholder — such as a client or vendor — without sending an individual email invitation or adding them to your team. Anyone with the link can open the process and contribute a voice interview.

1. Open the process you want to share.
2. Click the Invite button to open the sharing panel.
3. Select the Invite Link tab.
4. Click Create invite link. Duvo generates a unique, process-scoped token.
5. Copy the link and share it directly with the people you want to contribute — via email, Slack, or any other channel.
6. To invalidate the existing link and generate a new one, click Regenerate link.

People who open the invite link see a focused interview view where they can start a voice interview and contribute to the process. They do not gain access to the rest of your team workspace.

Note: Client invite links are process-scoped — each link is tied to a single process. If you want to invite people to a different process, generate a separate link from that process.

---

​

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.

​

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.

---

​

Inspect Processes from the CLI

Use the Duvo CLI when you need read-only terminal access to a Clarity process. The CLI can find processes, compare generated versions, review evidence citations, list gaps and extra capture requests, export Markdown briefs, and produce structured JSON for scripts or AI assistants. The Clarity CLI does not generate, promote, revert, or build automations. It is designed for inspection and analysis of process context that already exists in Clarity.

---

​

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.

---

​

Duplicating a Process

You can create a copy of any existing process using the duplicate action. This is useful when you want to start a new process based on an existing one, or when you need to make a variant without modifying the original. To duplicate a process:

1. From the Clarity section, find the process you want to copy.
2. Open the process card’s menu (three-dot icon).
3. Click Duplicate.

Duvo creates a new process named “Copy of [original name]” with:

• All captures from the original process (voice interviews, videos, and documents that were fully processed — any captures still recording or processing are skipped)
• The full message and generation history
• The same analysis, transformation guidance, and process breakdown

The duplicate starts as a Draft and its sharing settings are reset — it is private by default and you will need to re-enable sharing if required. Duplicating a process requires the Manager role or above.

---

​

Process Diagram Version History

The process diagram view includes a version history timeline in the bottom-right corner of the diagram canvas. This timeline lets you navigate between previously generated versions of the diagram and revert to an earlier one if needed. Version history is only visible to:

• The team member who created the process
• Users with the Manager role or above (Manager, Administrator, Owner)

Members, Builders, and Clarity Members who did not create the process cannot view or navigate its version history.

---

​

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:

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

---

​

Process Statuses

Each process moves through the following stages:

---

​

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.