Skip to content

Edit and Lock the Design

The generated design is a starting point with an audit trail, not a verdict. When you know better than the model (and you often will), edit the design directly; your changes are first-class decisions that the platform preserves and accounts for.

Make an Edit

  1. On the Architecture tab, open Edit design.
  2. Change what you need: set a component's technology, add or remove components, and adjust data flows (endpoints, protocols).
  3. Save. The design re-evaluates immediately, so compliance results and the diagrams reflect your edit without a full re-run.

What a Lock Means

Every component you set is locked: marked as an architect override and shown with an override chip on its card and in the component detail panel. Locks have two effects:

  • AI re-runs preserve them. However many times the design regenerates, your locked choices override the model's output. The scope guard treats locked additions as architect decisions and never quarantines them.
  • Approval requires risk sign-off. An architect-modified design carries human judgment the automated checks did not choose, so the readiness board requires an accept-risk sign-off before approval, with separation of duties enforced. See Risk Sign-off.

Edit or Re-run?

Prefer a re-run (optionally with Preserve scope) when the problem is something the loop can fix from findings, and an edit when the decision is genuinely yours: a mandated product, a known constraint the inputs cannot express, a correction to the model's reading of your estate. Edits are for decisions, not for chasing the model's formatting.

The Design Object Model, Briefly

Edits play by the same semantic rules as generation. Only internal capability slots take a catalog technology; external systems and a legacy system being migrated off keep their stated technology and are never gaps; people are actors, not components. The full rules live in the design object model and apply to every surface: gap counting, delivery planning, drift, and diagrams.

Where Edits Are Visible

Surface What You See
Component card / detail panel "Architect override" chip; your technology and note
Readiness board Risk sign-off required while unsigned
Scope Guard card Locked items pass as architect decisions
Audit log The edit, the editor, and the time