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, documents, and images — 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.

​

Roles and process ownership

Builders, Managers, Administrators, and Owners can create Clarity processes. Builders can rename and edit the guidance and generated content of any process they can access in their team, including processes created by someone else. A Builder can delete only a process they created. Managers and above can delete any team process and manage team-wide settings and process structure. Generation, sharing, visibility, and access remain with the process creator or a Manager. Clarity Members contribute browser interviews but cannot edit generated process content.

​

Key Capabilities

• Capture processes via screen recordings, AI voice Agent interviews, phone interviews, uploaded documents, and process images
• 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

​

Capture a Process

Clarity supports five capture methods. Pick the one that fits how the knowledge lives today — or combine several on the same process.

​

Exclude an unhelpful capture

Clarity keeps captures available for review even when they should not influence the process. An excluded capture stays visible with an Excluded badge, but Duvo leaves it out of future analysis, briefing updates, evidence selection, and Process Landscape generation.

• Before an interview starts or while it is running, choose Not my process when you cannot provide useful knowledge about the process. If you confirm before recording, Duvo skips microphone and screen access and creates an excluded capture. If you confirm during an interview, Duvo ends the interview and excludes the saved capture.
• Duvo may exclude an interview automatically only when the interview contains no useful process knowledge and the Agent is highly confident. The standard end-interview dialog still appears, so you can continue, complete, or discard the interview as usual.
• The capture’s creator or a team Manager, Administrator, or Owner can choose Exclude from analysis from a completed process capture’s menu. Organization Admins, Owners, and Executives can do the same for organization landscape captures.
• Hover over the Excluded badge to see who excluded the capture and why. If you can manage the capture, the badge also reveals an X control. Select it and confirm to include the capture in future analysis again.

This behavior applies to captures attached to a process and to interviews collected for Process Landscape. Exclusion does not delete the recording or transcript.

​

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.

​

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. 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.

​

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

​

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. Pan by clicking and dragging the canvas or scrolling with two fingers on a trackpad. Pinch or hold Command/Control while scrolling to zoom. You can also move around a long process from the keyboard. Select the canvas, then use the arrow keys to pan step by step, hold Shift with an arrow key to move further, Page Up and Page Down to move a screen at a time, Home to jump back to the start of the process, End to jump to the last step, and the plus and minus keys to zoom. The overview map in the bottom-left corner shows where you are in the whole process; click or drag inside it to move the view.

​

Share

The shared view uses the same immersive layout as the private view. It always shows the Current Process. When you choose to share a live Transformation Proposal that matches that version of the Current Process, recipients can switch between both views from the top of the page.

---

​

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 below and the capture requests in 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

​

Fill in missing information

When the Transformation Proposal has steps that need more detail, those steps are flagged. Where the people who mapped the process give enough signal, Duvo also suggests who is best placed to fill each gap in a follow-up interview, with a short reason. Managers can assign that person to the flagged step in one click. To provide what’s missing:

​

Link an Agent to a Step

Each step can name the Agent that runs it, so a process says who does the work and not only what the work is. It works on both views: on the Current Process the Agent is the one running that step today, and on the Transformation Proposal it is the one proposed to run it. One Agent can run several steps; a step names at most one Agent.

​

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

​

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. Organization Admins, Owners, and Executives see the complete folder hierarchy. Other members see the processes they can access without folder names. A Restricted content notice shows how many processes are hidden in each restricted-only branch and tells members to ask an admin for access.
• 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.
• Assign process people — Managers can assign people to processes for teams they manage. Organization Admins, Owners, and Executives can assign people across their organization scope. Access is checked for every selected process and team before any assignments are made.
• 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.

​

Landscape interviews

Voice interviews started from Process Landscape stay at the organization level. Duvo first asks what work, outcomes, and decisions the participant is responsible for. It then uses one interview approach for the rest of the conversation:

• Strategic perspective — connects company goals to measurements and KPIs, value drivers, high-level contributing processes, and the relationships between those processes.
• Process-owner perspective — follows a natural walkthrough of the participant’s area to discover high-level process purpose, boundaries, ownership, and dependencies.

The participant’s description of their responsibilities determines the approach, even when their job title or existing context suggests something else. The interview does not switch approaches partway through. Landscape interviews may ask once for the frequency and approximate end-to-end duration of a high-level process, but they do not collect individual task or step timing. They also do not collect detailed process steps, systems, inputs and outputs, or exceptions; add a capture to the relevant process when that level of detail is needed.

​

Key Capabilities

• Ask Duvo across the organization — Start a chat from an organization page to compare the accessible Process Landscape across teams, including ownership, coverage, duplication, relationships, and gaps. Duvo reports how many processes and teams it considered and warns when the landscape is too large to read in full. Organization-wide answers use landscape summaries; open a process when you need its captures or interview evidence.
• See the full hierarchy on the map — for organization Admins, Owners, and Executives, the map view draws each area as an outlined region with its folders nested inside, split into value chain and support rows. Deeper folders appear as section labels above their processes. Other members see their accessible processes without the restricted folder structure.
• See which processes matter most: High priority is visually emphasized on the map. High, Medium, and Low priorities appear in the tree and process details. Open a process and read the Priority section in its details for the reason behind the ranking and when it was assessed. Duvo assesses priorities automatically. Managers can override or clear priorities for processes owned by teams they manage; organization Admins, Owners, and Executives can do this across the organization. Select Not set to clear a priority and return the process to the unassessed state.
• Maintain the organization skeleton — organization Admins, Owners, and Executives can move areas and folders, change their order, add sub-areas, and delete areas and folders they no longer need — from the tree and from the map alike. Deleting an area never deletes the processes inside it; they move to Unsorted.
• 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.
• Accept or decline proposed areas and folders — a proposed area or folder shows a Proposed badge and, when selected, the reason it was suggested. Organization Admins, Owners, and Executives can accept it into the landscape or decline it — from the hover actions on its row in the tree, from Accept suggestion in its details, or from its region menu on the map. A proposed area or folder stays proposed until acceptance succeeds, so moving or renaming it first does not confirm it. Declining an area or folder that already holds content also removes the suggested items inside it; the processes inside are not deleted and move to Unsorted.
• 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.
• Reassign a process to another team — organization Admins, Owners, and Executives can change the assigned team on a process. The process moves to the new team together with its interviews, captures, and invite links, and open ownership suggestions for it are cleared. Wait for any capture recording or upload in progress to finish before moving the process.
• 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.
• Assign people across processes — select up to 20 accepted processes and choose Assign people to review and save the assignments together.
• 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, in the tree or on the map, to move the whole selection into another area at once.

​

How to use it

To move a single process to a different team, open it and click the Assigned team row in the Overview area, then pick the new owner. Reassignment is available to organization Admins, Owners, and Executives.

​

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 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.

​

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: Duvo creates a new process named “Copy of [original name]” with:

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

​

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. Team members with access to a process can review its version history. Builders and above can save, promote, revert, and remove editable drafts for any process they can access in their team.

​

Configure Team Settings

Before generating documentation, set up your team context so Clarity can provide accurate cost-benefit analysis. 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 browser interview and is the language Clarity writes the generated current process, transformation proposal, and chat edits in — English, Czech, French, German, Hungarian, Polish, Portuguese (Brazil), Portuguese (Portugal), Slovak, Spanish (Mexico), Spanish (Spain), or Ukrainian. Phone interviews use the languages available in the phone interview form.

​

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 browser interview option is shown. It supports voice or screen sharing; phone interviews and file uploads 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, documents, and images — 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