Diagram Assistance

Diagram Assistance helps you extend and review a Diagram Set without guessing. It combines Built-in Suggestions, Coverage, and Review Impacts so you can see what to add, what changed elsewhere, and which diagrams still need attention across Architecture Diagrams and C4 Diagrams.

• Add from Set faster — surface related Systems, Services, Domains, and connectors already known through the Diagram Set and Repository bindings
• Review before you apply — suggestions are add-only and preview-first, while removals become review events instead of silent propagation
• Track Coverage — identify missing diagram candidates, reused entities, and layer gaps across the Diagram Set
• Use optional AI Assistance — explain suggestions and architecture tradeoffs when EnableDiagramAiAssistance is enabled

Important

Built-in Suggestions are the primary product experience and remain available without AI. AI Assistance is optional and never bypasses preview, review, or apply controls.

How Diagram Assistance Works

Diagram: Diagram Assistance combines Diagram Set facts and Repository bindings to power Built-in Suggestions. When EnableDiagramAiAssistance is enabled and an AI provider is configured, the same workspace also offers AI Assistance.

Where Diagram Assistance Appears

Built-in Suggestions

Built-in Suggestions are the core Diagram Assistance experience. They use Diagram Set structure, generated provenance, sibling diagrams, reused entities, and Repository bindings that already exist in Nodinite.

Add from Set

Use Add from Set when you want to populate the current diagram with safe, relevant additions instead of dragging every element manually.

Typical actions include:

• Add selected items
• Add all safe items
• Preview placement before you apply
• Dismiss a suggestion
• Mark an item as intentionally omitted

Coverage

Coverage shows whether the Diagram Set already tells a complete story across layers. It highlights missing diagram candidates such as:

• A central System in L1 with no L2 Container diagram
• A key Service in L2 with no L3 Component diagram
• Runtime participants with no Dynamic diagram
• Technical diagrams that still lack a stakeholder-friendly L1 or L0 view

Review Impacts

Review Impacts helps you understand which sibling diagrams may need attention after a change. Typical triggers include:

• A node or connector added to the current diagram
• A node removed from the current diagram
• A binding changed to a different System, Service, or Domain
• A diagram promoted from Draft to Active
• A Repository entity changed, was archived, or was removed

Diagram Assistance treats removals as review events. It does not auto-delete content across other diagrams.

Review States

Diagram Assistance can surface review states such as New, Acknowledged, Applied, Dismissed, Snoozed, Intentional divergence, and Stale so teams can distinguish deliberate differences from accidental drift.

Optional AI Assistance

When you enable EnableDiagramAiAssistance in the AI System Parameter and configure the provider in AI Assistant, Diagram Assistance adds an AI Assistance tab.

Note

AI Assistance complements Diagram Assistance. It does not replace the built-in experience, and it does not silently mutate diagrams.

Diagram Assistance vs Sync Diagram Links

Use the right tool for the job.

Example Workflow

1. Open a Draft diagram in the C4 Designer.
2. Review Built-in Suggestions and use Add from Set for safe additions.
3. Use Coverage to find missing diagram candidates for the same Diagram Set.
4. Check Review Impacts before you promote changes to Active.
5. If AI is enabled, open AI Assistance for explanations and next-diagram guidance.
6. Run Sync Diagram Links when you need to rebuild drill-through navigation across the whole set.

Next Step

• C4 Designer
• Sync Diagram Links
• Set up AI Assistant and MCP Endpoint

Related Topics

• Architecture Diagrams Overview
• AI System Parameter
• AI Assistant
• Sync Diagram Links
• Generate from Integration Landscape
• Repository Bindings