[
  {"slug":"quickstart","title":"Explore a working architecture","summary":"Open the demo, drill into a level, and follow a runtime flow.","prerequisites":"A current browser. No account required.","outcome":"You can explain the example's components and one connection.","permission":"Free local use; demo edits are not server publications.","steps":["Open the demo using the example link below. This is separate from your saved browser draft.","Choose Fit using the zoom percentage so the current level is visible.","Open a container with its open button or by double-clicking it. Use Back to return.","Select a flow to inspect its label, direction and speed.","Export any changes you want to keep before leaving the demo."],"reference":"/guide#quick-start","example":"/app?diagram=demo","caution":"Do not treat a successful demo visit as proof that account or organization workflows are enabled."},
  {"slug":"first-diagram","title":"Create your first diagram","summary":"Import a small API-to-database model, change a label, and export it.","prerequisites":"A browser and a backup export of any current work.","outcome":"An editable two-component diagram with one labeled flow.","permission":"No account required for local editing and export.","steps":["Export your current diagram first if you want a separate backup.","Open the editor and choose Import. Copy the example below into the source field.","Import the source. The import becomes an unpublished copy, not an update to the original server diagram.","Select the API node and change its label in the inspector.","Choose Export and save a portable JSON, YAML or Markdown file."],"reference":"/guide#editor","example":"/app","fixture":true,"caution":"Local storage is tied to this browser and site. Export important work before clearing browser data."},
  {"slug":"hierarchy","title":"Navigate hierarchy and shared views","summary":"Distinguish containment from a named view and return to the parent level.","prerequisites":"A diagram with a container, such as the worked demo.","outcome":"You can open and leave a level without changing containment.","permission":"Local editing is free. Server changes require write access.","steps":["Open the demo and select a container.","Open its deeper level. Without a custom view, this level follows its contained children.","Use Back or the breadcrumb to return to the previous level.","Choose Compose view when you need an independent board or a selection of existing nodes.","Use contained children restores the default relationship for that entry; export a backup before restructuring views."],"reference":"/guide#levels","example":"/app?diagram=demo","caution":"A shared view within a diagram is not a workspace-wide reusable entity. Those are different capabilities."},
  {"slug":"flows","title":"Explain a runtime flow","summary":"Connect two services and inspect direction, speed and labels.","prerequisites":"Two nodes in an editable diagram; the example below supplies both.","outcome":"One labeled relationship whose direction you can explain.","permission":"Local editing is free; published updates require write access.","steps":["Import the example into a backed-up local editor.","Select the existing API-to-database path to inspect it.","Change its label, direction or animation speed in the inspector.","To add a relationship, choose Connect, select a source node, then a different destination.","Export the source and confirm the relationship is represented in the flows array or Flows section."],"reference":"/guide#markdown","example":"/app","fixture":true,"caution":"Reduced-motion preferences can make flows static. Direction and labels remain useful without animation."},
  {"slug":"save-and-recover","title":"Save, publish and recover work","summary":"Know which copy lives in your browser and which copy was published.","prerequisites":"A local diagram. An active signed-in account is needed for publishing.","outcome":"You keep a portable backup and can reopen an owned server copy after publishing.","permission":"Free personal publishing; organization publishing requires its permissions.","steps":["Export a portable file before making a risky change.","Local edits are saved to this browser. Reopen the editor in the same browser to resume the draft.","Sign in and choose Publish to create or update the owned server copy. Wait for the success message.","Open My diagrams and reopen the published diagram to check the server copy.","If a local draft is missing, import your exported backup as a new unpublished copy."],"reference":"/guide#publishing","example":"/app","fixture":true,"caution":"Server revision restore is gated and is not promised as a generally available recovery path. Do not delete browser data before backing up."},
  {"slug":"sharing","title":"Share a diagram for review","summary":"Publish privately, choose public or email access, and verify the recipient view.","prerequisites":"A signed-in owner and a successfully published diagram.","outcome":"An intended reviewer can view the diagram with the access you chose.","permission":"Personal owners can manage public and email viewing access. Organization policy can restrict sharing.","steps":["Create and publish the small example below rather than using private architecture for a first test.","Open the diagram's sharing controls.","For a public link, enable public visibility. Anyone with that URL can read it.","For private email sharing, add the intended address. The recipient must sign in with the matching email.","Save access, then verify the URL with a separate authorized recipient session. To revoke access, remove the recipient or disable public visibility and save again."],"reference":"/guide#publishing","example":"/app","fixture":true,"caution":"Email sharing grants view access; do not assume it sends an invitation email or gives editing rights."},
  {"slug":"workspaces-and-roles","title":"Understand workspace access","summary":"Identify personal versus organization ownership and the role needed for a task.","prerequisites":"An existing provisioned organization and a signed-in member for organization tasks.","outcome":"You know when to ask an organization owner for access.","permission":"Personal accounts do not currently create organizations themselves. Paid provisioning is contact-sales.","steps":["Open Profile and inspect the organizations available to your account.","Confirm the diagram belongs to the intended personal account or organization before publishing.","Viewers read authorized diagrams; commenters review; editors can change organization diagrams.","Owners and admins manage membership and policies. Ask one of them when your task requires a role you do not have.","Check the capability status before relying on enterprise identity or governance in a production rollout."],"reference":"/guide#organizations","example":"/app?diagram=demo","caution":"The demo is a viewing exercise, not proof of organization provisioning. Self-service workspace setup and verified enterprise rollout remain separate release work."},
  {"slug":"import-export","title":"Round-trip a portable model","summary":"Import Markdown, export JSON, and inspect the same nodes and flows.","prerequisites":"A browser and a backup of existing work.","outcome":"Two nodes and one flow survive a portable export and re-import.","permission":"Local import/export needs no account.","steps":["Copy the example below and import it through the editor's Import control.","Choose Export and select JSON. Save the file.","Inspect the file for the api and db node IDs and the requests flow.","Import that exported file. It becomes a new unpublished copy with server identity removed.","Choose Fit and confirm both nodes and their connecting flow are present."],"reference":"/guide#formats","example":"/app","fixture":true,"caution":"GIF is a presentation export, not an editable model import. Use Markdown, JSON or YAML for round trips."},
  {"slug":"templates","title":"Start from a template safely","summary":"Download the multi-cloud starter and make an unpublished working copy.","prerequisites":"A browser and an export of work you want to keep.","outcome":"A new local copy of the Confluent, GitOps and multi-cloud starter.","permission":"Template download and local editing are free.","steps":["Export your current work first.","Download the starter from the example link below.","Open the editor and choose Import, then select the downloaded JSON file.","Choose Fit and inspect the entry level before opening a container.","Change the title to describe your own example, then export the result or sign in and publish."],"reference":"/guide#formats","example":"/templates/confluent-gitops-multicloud.json","caution":"A template is an example, not a security-reviewed deployment design. Replace example details before using it as real architecture documentation."},
  {"slug":"agent-connection","title":"Connect an agent with a personal key","summary":"Create a key, connect to MCP, discover shapes, and validate a small model.","prerequisites":"An active account and an MCP client that supports authenticated HTTP servers.","outcome":"Your agent can discover shapes and work with an authorized diagram.","permission":"Personal keys inherit their owner's access. A key does not bypass organization permissions.","steps":["Open the MCP setup page, sign in, and create a personal key. Store it privately; it is shown once.","Configure your client's HTTP MCP server using the endpoint and authentication instructions on that page.","Ask the agent to call list_shapes for the exact service types it needs.","Ask it to create the small example below, retain the returned diagram ID, and validate it.","Use patch_diagram for small changes. Revoke a key from the key-management interface when it is no longer needed."],"reference":"/guide#mcp","example":"/mcp","fixture":true,"caution":"Do not paste keys into diagrams, support messages or public source. Client configuration syntax differs; use your client's documented secret mechanism."},
  {"slug":"troubleshooting","title":"Troubleshoot an import or missing flow","summary":"Check identifiers, endpoints and access before retrying.","prerequisites":"The source or diagram that failed, with a backup copy.","outcome":"You can isolate a source problem from an account or service problem.","permission":"Local checks require no account. Publishing requires an active account.","steps":["Try importing the small example below to establish that the editor works.","Check that every ID in your source is unique and begins with a letter; use only letters, digits, underscores and hyphens.","For a missing flow, check that from and to refer to different existing node IDs.","Use Fit, then open the appropriate level: a valid relationship may belong to another view.","If publishing fails, keep a local export, check sign-in and write access, and contact support with the error message, browser and reproduction steps. Exclude private source and credentials."],"reference":"/guide#troubleshooting","example":"/app","fixture":true,"caution":"Retrying a failed request is not proof it succeeded. Verify the server copy before discarding local work."},
  {"slug":"shortcuts-accessibility","title":"Navigate with keyboard and reduced motion","summary":"Focus nodes, open levels and use editing shortcuts without relying on animation.","prerequisites":"A keyboard and the demo or an editable diagram.","outcome":"You can select a node, open a level and return using keyboard controls.","permission":"Viewing and local drafting require no account.","steps":["Use Tab to focus a node or flow, then Enter or Space to select it.","Use the focused container's open control to enter its level; use Back to return.","Press / to search shapes, C for Connect, and Escape to cancel the current mode.","Use Delete or Backspace only when you intend to remove the selected item. Undo restores a recent local edit.","Enable reduced motion in your browser or operating system. Read flow labels and direction rather than relying on animated signals."],"reference":"/guide#editor","example":"/app?diagram=demo","caution":"Shortcuts should not be used while typing into text fields. Full accessibility acceptance is tracked separately from this task guide."}
]