Workflow Collaboration

Workflow collaboration helps you work safely on a flow when other teammates are also making changes. Instead of overwriting updates silently, Phonely notifies you when a newer remote version is available and gives you tools to compare your current draft with the incoming changes before deciding what to do next. Use this when:

• More than one person is editing the same workflow
• You have local edits open and a teammate saves a newer version
• You want to review exactly what changed before loading the latest version

This is especially useful for prompt-heavy flows, routing changes, and shared agents where multiple people may be updating the same nodes.

​

How Workflow Collaboration works

When Phonely detects that a teammate has made newer changes to the same flow, a collaboration banner appears at the top of the Flow Editor. The banner shows that:

• New remote updates are available
• Who made the remote update
• Actions you can take next

​

Collaboration banner

When remote updates are detected, Phonely displays a banner across the top of the workflow canvas. The banner includes:

​

Review Flow Changes

Click review changes from the collaboration banner to open the review flow changes modal. This is where you compare your current local draft with the incoming remote version side by side.

​

Local Draft vs. Remote Updates

At the top of the modal, the comparison is split into two sides: **Local Draft - **This is your current local version of the flow the draft open in your editor. **Remote Updates -**This is the newer version saved remotely by your teammate. This layout makes it easy to compare your current work with the incoming version before taking action.

​

Modified Nodes

Below the headers, Phonely lists the nodes that changed under modified nodes. Each changed node appears by name and shows how many fields inside that node were modified. To inspect the difference, click the modified node entry to expand it and review the changed content. Each modified node includes a badge showing how many fields changed.

​

Simple mode

In simple mode, Phonely shows a readable, side-by-side summary of the change. If the changed text is long, click Show more to expand the full content, or Show less to collapse it again. This view is designed for readability. It is best when you want to understand prompt or content changes without reading raw structured data. In simple mode, changed content is displayed side by side in a more human-readable format. For example, if a prompt node changed, you may see readable content such as:

• Objective
• Steps
• Guidelines

The left side shows the local content and the right side shows the incoming remote content. This makes it easy to compare edits such as:

• Added or removed wording
• Revised instructions
• Prompt clarifications
• Small text changes inside an existing node

When a changed field contains long content, Phonely may initially show a shortened preview. Use:

• Show more to expand the full content
• Show less to collapse it again

This is especially useful for long prompts, multi-step instructions, or nodes with detailed guidelines.

​

Advanced mode

You can also switch from the simplified view to a more technical comparison by turning on the Advanced toggle. This opens a Git-style JSON diff so you can inspect the exact structured field changes line by line. To return to the easier, readable comparison, toggle back to Simple view. Advanced mode is described as: This mode is useful when you want to inspect the exact structured data that changed. In Advanced mode, the changed node is displayed as a side-by-side structured diff. This includes fields such as:

• name
• instructions
• prompt
• exitconditions
• variables

Changed lines are highlighted in a Git-style diff layout so you can see the precise field-level difference. Use Advanced mode when:

• You want exact field-level differences
• You are reviewing configuration-heavy changes
• You need to verify raw node data
• You are comfortable reading structured diff output
• The change is too subtle to rely only on the readable summary

Use Simple mode when you want a faster, easier review of content changes.

​

Actions you can take after reviewing

After inspecting the differences, return to the collaboration banner and choose the next step.

​

Apply Latest

Use Apply Latest when you want to load the remote version directly. Choose this when:

• the remote update is the version you want to continue with
• you do not need to preserve your current local draft separately
• you have already reviewed the changes and are ready to switch

This updates your editor to the newest shared version.

​

Save Local & Load Latest

Use Save Local & Load Latest when you want to keep your current local work before switching to the remote version. Choose this when:

• you have local edits you do not want to lose
• you want to preserve your draft before loading the newest shared version
• you want to compare or reuse your local work later

This is the safer choice when you have already made meaningful changes in your editor.

​

Review Changes again before deciding

If you are unsure which version to keep, use Review Changes first. This is especially important when:

• the changed node affects prompt instructions
• more than one contributor is editing the same flow
• the latest update may affect logic, routing, or behavior

​

A typical collaboration workflow

A common workflow looks like this:

1. You open a shared workflow and start editing.
2. Another teammate makes changes to the same flow.
3. Phonely detects the new remote version.
4. A collaboration banner appears at the top of the editor.
5. You click Review Changes.
6. The Review Flow Changes modal opens.
7. You compare:
   • Local Draft
   • Remote Updates
8. You inspect the changed node under Modified Nodes.
9. You review the differences in Simple mode.
10. If needed, you switch to Advanced mode for a structured diff.
11. After reviewing, you choose:

• Apply Latest, or
• Save Local & Load Latest

This prevents accidental overwrites and makes shared editing much safer.