Use the app

Run the customer journey

The App separates evidence collection from human judgement. Automated evidence produces an indicative result; review completes the selected scope; publication creates the immutable report used for governance and comparison.

1. Prepare the assessment

Open Assess → Prepare assessment. Work through the six setup steps:

  1. Name the assessment, state why it exists and name its owners.
  2. Choose every visible workspace or a specific workspace selection, then set the historical lookback.
  3. Choose all seven pillars or the subset relevant to this review.
  4. Review where automated and human evidence will come from.
  5. Optionally record target posture and target date by pillar.
  6. Confirm the summary.

Use a saved definition for recurring governance. Use a custom run only for a deliberate one-off question.

2. Collect automated evidence

Select Run assessment in the header. The scope dialog starts with the current saved definition and lets you narrow pillars or choose a custom workspace scope. Check the summary at the bottom before selecting Start assessment.

Collection reads only what the scanning identity is allowed to read. A missing grant, absent system table or unreadable API becomes a visible measurement gap attached to the affected requirements.

Only one scan runs at a time. You may move around the App while it runs; the header preserves progress and routes you into review when collection completes.

3. Read the indicative result

The Dashboard remains the permanent state-of-the-estate entry point. After automated collection it shows:

Dashboard with indicative posture, coverage and actionable recommendations

An unanswered or unmeasured requirement is excluded from posture; it is not treated as passing. A pillar with too little evidence is shown as not assessed rather than receiving a misleading confident score.

4. Supply human evidence and review pillars

Open Assess → Review. Each selected pillar separates:

Review flow separating measured evidence from remaining human decisions

Select the named answer action, record the outcome, provide the evidence or rationale requested, identify the accountable owner and set the next review date. The record button enables only when the required fields are complete; this prevents an outcome with no support from entering the report.

When every requirement needed by a pillar is settled, choose one of two explicit decisions:

Skipping is not passing. The report preserves the decision and its coverage consequence.

5. Publish the report

After every selected pillar has a decision, publish the review. Publication freezes one final result against the run, assessment definition fingerprint, methodology version, evidence and reviewer decisions.

The report includes an executive summary, scope and confidence, posture by pillar, material risks, measurement gaps, improvement progress and every requirement considered. Use Print for a customer-ready PDF or the header Export control for machine-readable records.

Published architecture review with scope, posture and open work

Publication does not delete or overwrite the indicative result. It establishes the reviewed result that the Dashboard and later comparisons use.

6. Investigate an unmet requirement

Open a recommendation from the Dashboard, a pillar or Findings. Investigation is requirement-led:

  1. Select an unmet or partly met requirement.
  2. Read Do this, Why, Where, Owner and Verify.
  3. Inspect the observed and expected evidence and its confidence limits.
  4. Use the affected-resource list and exact Databricks deep links when the evidence names resources.
  5. Open the full Estate only when architecture relationships help answer the selected requirement.
  6. Write an append-only note for context that should remain with the requirement.
Investigation workbench showing one requirement, its action and affected resources

Scope-wide controls deliberately do not fill the canvas with unrelated resources. Their inspector explains the policy or share being measured and gives the closure plan instead.

7. Create and run an improvement plan

From Investigation, choose Create improvement plan. A plan groups work around an outcome; actions carry the executable commitments.

For every action, record:

Improvement action with owner, verification condition and current standing

Move work through draft, planned, in progress, blocked, done or cancelled using Update status. Marking an action done does not change a requirement's outcome. A later assessment verifies it; if the requirement is still unmet, the action is shown as contradicted.

Use Send this plan to share the plan record and Close the plan only when no further active action belongs in it.

8. Record decisions and exceptions

These records remain separate from verified improvement work so a report can distinguish “fixed,” “accepted” and “not yet addressed.”

9. Operate the cycle

Open Operate → Next actions for the recurring queue. It prioritises open reviews, contradicted actions, overdue work, expiring exceptions and partial scheduled runs, while keeping settled history out of the way.

Operating view showing the items that need attention now

Use Runs for exact collection history, Months for closed reporting periods, Retention for lifecycle policy, Audit trail for who did what, and Diagnostics for dependency health.

Read scores correctly

Next

Look up every page →