Drafts
🔮 Design future states of software architecture
Multiple drafts are only available on the Growth plan. Archiving drafts is a Scale Plan feature only.
Architecture design doesn’t end once you’ve modelled the current state — it’s a continuous, collaborative process. Ideas are proposed, reviewed, and approved, and decisions need to be tracked for context and learning.
Drafts let you explore future changes to your architecture without impacting the live model. Drafts exist in isolation, so edits don’t affect anything outside until merged. With drafts, you can group multiple diagrams and model updates into a single update for cohesive change management.
A quick run-through of how drafts work:
Watch the walk-through directly on Youtube.
Future state architecture
In software development, documenting and diagramming your current architecture helps teams understand how things work today. But progress requires proposing and discussing future changes.
Communicating the future state of your system(s) provides a shared vision of where the team is headed and how technical decisions align with business goals. Even as designs evolve, this clarity helps everyone understand the technical journey toward achieving those goals.
How to create Drafts
There are 2 ways to create a new Draft:
Inside a diagram, select the Draft button and hit 'New Draft'.
From the Draft table, select the New Draft button, name it and select the Diagram you want to modify.
Modifying a diagram with Drafts
Once you have created your draft, you can start making changes to the diagram, the model objects, tags or flows. Modify anything you'd like. Edits on model objects, connections, and diagrams (including layout edits) are treated as draft changes. Changes in a draft will default to future state.
Changes are added to the Diagram and Model summary at the top. Any changes should be visible in the top menu.
Drafts also work with Flows and Tags, meaning you can show the effects on user flows based on the changes you're making; you can propose new flows and highlight technology, risk, cost etc.
You are currently not able to change the Type of an object or the Parent inside a draft.
Model-based (multi-diagrams) drafts
Within the same draft, you can modify as many diagrams as you'd like.
From the Diagram view, select the Diagram button and click 'View all diagrams'. This will let you navigate to another diagram to make changes.
Edited diagrams are automatically added to the Diagrams change list at the top left of the navigation. See all model object changes in the draft under the new Model tab.
Creating multiple drafts in the same diagram
You can create as many drafts as you'd like with the same diagram. This can help you compare proposals with each other and your current design. Keep in mind that these drafts don't interact with each other. There are separate forks from the current model.
Drafts table
In the drafts table, you find a summary of all the drafts open and their statuses: In-progress, Merged and Archived.
From this table, you can:
View Drafts
Create a new draft
Archive or delete a draft
Review Changes
Once you're happy with your changes, you can review them by selecting the Changes drop-down. If you're in the diagram, clicking on a change will bring up that object if it's present.
You can also view all the model changes in the model tab.
Pull changes
A draft that's been worked on for a while may have drifted from the latest version. You can pull changes into your draft to get it back up to date with the latest by selecting the Pull Changes button.
Merge changes
Merge your draft when you agree to the proposed changes. A modal will appear with a list of changes and who proposed them.
Conflicts
You will not be able to merge your draft if there are any conflicts. In that case, you will see a red Merge conflicts button.
Fix the conflicts first and then merge again.
Happy drafting! 🧊
Last updated
Was this helpful?