> ## 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. # Clarity > Capture, organize, and improve process documentation with 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, 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. Clarity is built into Duvo — there's no separate setup. Open the Clarity section in the sidebar and create your first process to get started. ## 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 people outside your team ## Quick Start: End-to-End in 5 Steps Open the **Clarity** section in the sidebar and click **New Process**. Give it a name that describes the workflow (e.g., "Monthly Inventory Count"). Add a voice interview, phone interview, video recording, or document. See the step-by-step guides below. Set your company name, industry, team size, hourly rate, and language so Clarity can calculate cost-benefit figures and work in your preferred language. Click **Start Analysis**. Clarity combines all captures and generates a structured process document with a BPMN diagram. Review the output, edit the Transformation Guidance if needed, and share the process via a public link. ## Capture a Process Clarity supports four capture methods. Pick the one that fits how the knowledge lives today — or combine several on the same process. 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. Open the process you want to document. Click **Add Content** and select **Interview**. Your browser will ask for microphone access. Click **Allow**. Select your preferred interview language — English, Czech, French, German, Polish, Portuguese, or Spanish. Your team's default Clarity language is preselected; change it here if this interview needs a different one. Click **Start** to begin the interview. The AI agent will introduce itself and start asking questions about the process. Answer naturally. The agent will ask follow-up questions to capture details, decision points, and exceptions. If the agent feels too slow or too fast, click the **Voice speed** button in the interview controls and drag the slider — Slower, Normal, Faster, or Fast. The new pace takes effect as soon as you close the menu, without interrupting the interview. (Shown only when the interview voice supports speed adjustment.) 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. 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. 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. 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. Open the process you want to document. Click **Add Content** and select **Phone Interview**. Enter your phone number in international format with the country code and no spaces (for example, +14155552671). Select your preferred interview language — English, Czech, French, German, Polish, Portuguese, or Spanish. Click **Call Me**. A 3-second countdown starts — click **Cancel** if you need to abort before the call is placed. Answer the call when your phone rings. Duvo will introduce itself and guide you through the interview with questions about the process. 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. When you have covered everything, say you are done or hang up. 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. Phone interviews are not available for Clarity Members. Clarity Members can use voice interviews from their browser. 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. Open the process you want to document. Click **Add Content** and select **Upload Video**. Select or drag-and-drop your video file. Wait for the upload and analysis to complete. Clarity processes the video automatically — this may take a few minutes depending on the video length. 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. Attach an existing AOP, process guide, or reference material. Clarity extracts the text and uses it alongside other captures during analysis. Open the process you want to document. Click **Add Content** and select **Upload AOP**. Select or drag-and-drop your document file. 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 People You can invite subject matter experts to add their own captures to a process — even if they do not have a Duvo account yet. Open the process you want others to contribute to. Click the **Invite** button. Enter one or more email addresses and send the invitation. You can invite multiple people at once. Each invitee receives an email with a link to the process. When an invitee opens the link, they see a simplified view where they can start a voice interview or upload a video. Their captures appear in the process alongside yours, grouped by person. 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. Open the process you want to share. Click the **Invite** button to open the sharing panel. Select the **Invite Link** tab. Click **Create invite link**. Duvo generates a unique, process-scoped token. Copy the link and share it directly with the people you want to contribute — via email, Slack, or any other channel. 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. 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 Open the process. Click **Start Analysis**. Clarity processes all captures and generates a structured document. A progress indicator shows which sections are being built. 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 — revenue recovered, cost avoided, and risk reduced — with confidence rating and supporting assumptions | | **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 Open the completed process. Enable the **Share** toggle. 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 Clarity Handles Conflicting Inputs When you add several captures to a process, they will not always agree. Two interviewees may describe the same workflow differently, or an uploaded AOP may not match what someone explains in an interview. Clarity does not pick a winner automatically — there is no fixed priority order that ranks one source above another. Instead, Clarity treats every capture as **evidence**: * **Inputs are evidence, not authority.** Clarity does not assume an AOP outranks an interview, or that one interviewee is more correct than another. It weighs what each capture describes rather than deferring to a single source. * **Conflicting versions are surfaced with attribution.** When two captures describe a step differently, Clarity shows both versions and where each one came from, so you can see who said what rather than silently merging them into one account. * **Conflicts in decision logic are flagged.** Disagreements that affect decision points, branching, or escalation paths are flagged as high-priority, because that is where an unresolved conflict has the largest impact on how the process actually runs. * **The team is prompted to align.** Rather than auto-resolving a conflict, Clarity prompts your team to agree on a single standard for the process, so the documented version reflects a real decision instead of a guess. * **Extra capture clarifies missing detail.** When a step lacks enough detail to automate — often because the captures conflict or leave a gap — Clarity asks for an extra capture to clarify it. See [Fill in missing information](#fill-in-missing-information) below and the capture requests in [Organize processes](#organize-processes). This keeps the generated documentation honest about where the source material disagrees, and puts the decision about the single correct version in your team's hands. *** ## Edit and Ask with Clarity Chat Clarity Chat lets you ask questions about a process and make changes to it through a simple chat — without editing anything by hand. It works on both the **Current Process** and the **Transformation Proposal**. ### What you can do * **Ask about the process** — for example, "Why is this step a risk?", "Where are we leaking margin?", or "What would change if we automated this?" * **Edit the process** — add, reword, or remove steps, or refine the Transformation Proposal, just by describing what you want. * **Fill in missing information** — when a step is flagged as needing more detail, Duvo asks you one focused question at a time and updates the process from your answers. * **Review before you accept** — every change appears as a preview, with added text highlighted and removed text struck through, so you see exactly what will change before applying it. ### How to use it Open a completed process. Find the **Ask Duvo** box at the bottom of the diagram. Type what you want, or pick one of the suggestions — **Edit the process**, **Ask about the process**, or **Add missing information**. Duvo reads the process and replies. For an edit, it shows a preview of the changes on the diagram and in the step details. Review the proposed changes. Accept them to apply, or keep chatting to adjust. To stop a response while Duvo is working, click the stop button next to the message box. ### Fill in missing information When the Transformation Proposal has steps that need more detail, those steps are flagged. To provide what's missing: Open the flagged step and choose **Answer in chat** from its menu, or click **Add missing information** in the chat. Duvo asks one question at a time about a single step. Answer in your own words — there are no fixed choices, and you can skip a question. Once you've covered the gaps, Duvo proposes a single update for you to review and accept. Clarity Chat works on the generated process. Generate the documentation first (see above) before you start chatting. ## Organize the Process Library The team library has three views, switchable from the toolbar: * **Folders** (default) — collapsible folders your team owns, plus an **Unfiled** section holding every process without a folder. * **Ungrouped** — one flat grid of all processes. * **Organization** — a read-only view grouping your team's processes by their Process Landscape areas, with an **Unclassified** section for processes the landscape has not placed yet. ### Key Capabilities * **Team-owned folders** — create, rename, reorder, and delete folders (team managers and above). Deleting a folder never deletes processes; they return to Unfiled. Any team member can move processes between folders. * **Set up from landscape** — one click creates a folder for each landscape area that contains your team's processes. These folders follow the area's name until you rename them; renaming makes the name permanently yours. Folder changes never modify the landscape itself. * **Suggestions** — an unfiled process that the landscape has classified shows a **Suggested** chip on its card. Click the chip to file it, or use **File all suggested** on the Unfiled section header to file every suggested process at once. * **Focused browsing** — search, status filters, and **My processes** always show flat results across all folders; clear them to return to your folder view. ### How to use it Open **Clarity** and use the view switcher above the library to choose **Folders**, **Ungrouped**, or **Organization**. In the Folders view, choose **Set up from landscape** to start from your operating model, or **New folder** for a custom grouping such as "Q3 priorities". Open a process card's menu and choose **Move to folder**, or click a card's **Suggested** chip to accept the landscape's placement. Switch to **Organization** to see the same processes grouped by their landscape areas — useful for checking how your team's work maps to the operating model. A process lives in at most one folder. For cross-cutting groupings, use labels in the Process Landscape instead. ## Organize processes The Clarity library follows the same hierarchy shown in Process Landscape. Open a folder to review the processes grouped under that part of your operating model. For organizations where Process Landscape is enabled, access works as follows: * **Open and understand the landscape** — All organization members can open **Process Landscape**. Folders and capabilities form the visible organization skeleton. Inaccessible processes appear as **Restricted process**; only granted processes render in full. * **Maintain process nodes** — Managers can maintain process nodes for teams they manage. Organization Executives, Owners, and Admins can maintain the skeleton and all process nodes. * **Generate the landscape** — Only organization Executives and Owners can generate **Process Landscape**. * **Assign ownership** — Process ownership assignment remains limited to organization Admins, Owners, and Executives. Process Landscape generation organizes your organization’s existing processes into a company landscape. Captures add optional context for grouping and summaries, but existing processes are the source of truth. Generation also suggests high-confidence relationships across teams: directional handoffs, shared steps, and process variants. Suggested relationships include a short explanation in the process sidebar. Review each suggestion there, then confirm it or remove it; relationships that people already confirmed remain unchanged when the landscape is generated again. ### Key Capabilities * **See the full hierarchy on the map** — the map view draws each area as an outlined region with its folders nested inside, split into value chain and support rows, so the map matches the tree structure. Deeper folders appear as section labels above their processes. * **Maintain the organization skeleton** — organization Admins, Owners, and Executives can move areas and folders, change their order, and add sub-areas. * **Maintain team processes** — managers can add, edit, move, and remove process nodes for teams they manage. Organization Admins, Owners, and Executives can maintain process nodes across all teams. * **Review proposed processes on the map** — proposed processes appear as dashed cards. Click one to open its details. Organization Admins, Owners, and Executives can assign its owning team or remove it. * **Review ownership suggestions** — managers can review team assignment suggestions for processes owned by teams they manage. Organization Admins, Owners, and Executives can review suggestions across the organization. * **Review process relationships** — suggested handoffs, shared steps, and process variants appear with an explanation in the process sidebar. Confirm useful suggestions or remove incorrect ones. * **Add processes manually** — managers can add a missing process for a team they manage and describe it. Organization Admins, Owners, and Executives can also assign the team that owns it. * **Track process people** — add real people by email or placeholders by name, with an optional role tag for each process. * **Accept or dismiss suggestions** — managers can review capture and team assignment suggestions for teams they manage. Organization Admins, Owners, and Executives can review suggestions across the organization. * **Assign capture requests** — choose the teammate who should provide the missing interview or capture. * **Notify the assignee** — accepted capture suggestions become open capture requests, and the assigned teammate receives the same notification used for extra capture. * **Select multiple processes** — tick the checkbox on each process, or the checkbox in the toolbar to select all, to act on several at once. * **Assign or remove in bulk** — organization Admins, Owners, and Executives can assign selected processes to one team. Managers can remove selected process nodes for teams they manage. * **Reorganize together** — drag any selected process to move the whole selection into another area at once. ### How to use it Open **Clarity** and go to **Process Landscape**. Select a process or area with suggestions. To add a missing process for a team you manage, open an area's action menu, click **Add process**, then enter the process name and an optional description. Organization Admins, Owners, and Executives can also choose the owner team. Review team assignment suggestions in the sidebar's **Overview** area. Managers can accept or dismiss suggestions for processes owned by teams they manage. Organization Admins, Owners, and Executives can review suggestions across the organization. Under **People** in that same **Overview** area, add a person by email to invite them to that process, or add a placeholder name such as "John from Finance" when you do not have an email yet. Add or edit the optional role tag when you want to record how that person relates to the process. In **Captures**, review capture suggestions and choose **Request capture** to create an open request. Use the assignment picker to choose the teammate who should provide the capture. Switch to the **Map** view to see areas and folders laid out as nested regions. Click a process card — including a dashed proposed card — to open its details. Organization Admins, Owners, and Executives can hover over an area or folder name and open its menu to move it earlier or later or add a sub-area. Managers can add and maintain process nodes for teams they manage. People added by email show **Pending** until the invitation is accepted. Placeholder people do not receive an invitation and do not create a Duvo account. To act on several processes at once, tick the checkbox on each process you want. Organization Admins, Owners, and Executives can use the toolbar to assign them to one team. Managers can remove selected process nodes for teams they manage. You can also drag selected process nodes for teams you manage to move the whole selection into another area. ### Process tags Process tags help your organization mark and find related processes in the Landscape. Tags are shared across the whole organization, so the same tags are available to every team. * Tags appear on process nodes in the Landscape. * Managers and above (and organization admins) create, edit, and delete tags; everyone in your organization can see them. * Tags are managed by people: add or remove them directly on a process, or ask Duvo in chat to do it for you. Duvo never adds or removes tags on its own. ### When to use it Use Process Landscape suggestions after sorting new captures, importing process material, or reviewing an L1-L4 area where ownership or missing context is still unclear. ## Inspect Processes from the CLI Use the [Duvo CLI](/cli/clarity) when you need terminal access to a Clarity process. The CLI can find processes, compare generated versions, review evidence citations, list gaps and extra capture requests, import Miro exports, create interview invite links, export Markdown briefs, and produce structured JSON for scripts or AI assistants. The Clarity CLI also exposes public write commands for generating, promoting, reverting, postprocessing, and building automations from Clarity process context. ## 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. Open the completed process. Click **Regenerate Documentation**. 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. 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: From the **Clarity** section, find the process you want to copy. Open the process card's menu (three-dot icon). 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. Open **Settings** in your team space. Navigate to the **Clarity** section. 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 | | Language | Default language for interviews and generated processes | These settings apply to all processes in the team and are used to calculate financial impact in the generated documentation. The Language setting is preselected for every new interview and is the language Clarity writes the generated current process, transformation proposal, and chat edits in — English, Czech, French, German, Polish, Portuguese, or Spanish. ## Process Statuses Each process moves through the following stages: ```mermaid theme={"dark"} stateDiagram-v2 [*] --> Draft Draft --> Collecting Collecting --> Generating Generating --> Complete Complete --> Generating: Regenerate documentation Complete --> [*] ``` | 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. ## Next steps Use the Duvo CLI for terminal access to Clarity processes — compare versions, export briefs, and produce structured JSON. Turn Duvo's sorting pass into clear ownership and follow-up capture work across your operating model.