Automations
Automations are AI-powered workflows that analyse documents and generate architectural outputs. They reduce the manual effort of creating architecture documentation, designs, and reviews.
Automation Types
Section titled “Automation Types”| Type | What It Does |
|---|---|
| New Design | Generate an architecture design from business requirements, standards, and existing context objects |
| Reverse Engineer | Extract architectural elements from existing system documentation |
| Forward Engineer | Generate implementation documentation from an architecture model |
| Design Review | Assess a technology design against best practices, requirements, or internal standards |
Providing Context
Section titled “Providing Context”Automations accept three kinds of input. Combine them to give the AI the richest possible context:
- Upload documents — PDF, DOCX, PPTX, TXT, MD, XML, or HTML files containing requirements, standards, or architecture documentation
- Add URLs — Web pages to fetch and analyse
- Select context objects — Existing objects from the Registry to provide architectural context
Running an Automation
Section titled “Running an Automation”- Navigate to Automations in the left sidebar.
- Select the automation type.
- Provide inputs (documents, URLs, context objects).
- Start the automation.
The automation runs as a background job. You can monitor its progress on the Jobs page.
What Automations Produce
Section titled “What Automations Produce”Depending on the type and inputs, an automation can generate:
- Architecture diagrams — Rendered from PlantUML in formats such as Cloud Architecture, Flowcharts, Sequence Diagrams, ERD, BPMN, Context Diagrams, and Component Diagrams
- Objects and associations — Extracted elements are created in the Registry for review
- Assessment summaries — For design reviews, a structured evaluation of gaps, risks, and recommendations
- Generated documents — Downloadable from the Jobs page
Reviewing Results
Section titled “Reviewing Results”After an automation completes, review the generated outputs on the Jobs page before they are committed to the Registry. This allows you to validate and adjust AI-generated content.
Token Usage
Section titled “Token Usage”Automations consume AI tokens. Each automation task costs 5 tokens from your account allowance. You can monitor your usage on the Usage page.