Skip to content

Reviews & Statuses

Statuses communicate progress. Reviews make status changes auditable.

The non-obvious part of Modulos governance is that different objects use status differently:

  • controls use execution status and get approved via reviews
  • requirements use fulfillment status and become “ready for review” once controls are final

For the full model, see Governance Operating Model.

The diagram below shows how status changes, review decisions, and exports connect into an audit trail.

Concept-specific status

Different concepts have different status semantics:

The diagram below compares control execution and requirement fulfillment at a glance.

Controls

Controls track execution state: Not executed → Executed.

In practice, teams use reviews so the change is auditable:

  • the implementer requests a status change and assigns reviewers
  • reviewers approve or reject
  • the decision is stored and visible in the audit trail

Once a control is executed, it becomes audit-sensitive and edits are restricted to preserve integrity.

Requirements

Requirements track fulfillment state:

  • Not fulfilledFulfilled
  • optionally Out of scope or Archived

Requirements also have a separate ready for review signal. A requirement becomes ready for review once all linked controls are final, and the requirement owner can then mark it fulfilled.

Review workflow and “stale” decisions

Reviews are used to approve status changes for controls (and other reviewable objects such as assets).

A review represents a requested status change for a specific object, assigned to one or more reviewers.

In the current backend workflow:

  • a review stores the old status and the requested status
  • a reviewer can approve or reject
  • the first decision updates the object status
  • any other pending reviews for the same object are marked stale once a decision is made

This reduces ambiguity and preserves a single authoritative decision for each status change.

The diagram below shows the typical lifecycle of a review request and how “stale” decisions are handled.

Review request view showing an assigned status change request, review comment box, and approve or reject actions.
Reviews happen inside the object’s Comments and Logs: reviewers approve or reject and leave rationale as part of the audit trail. UI shown in light mode.
  1. 1
    Review request
    When a status change is requested, reviewers see a banner and can open the review.
  2. 2
    Review comment
    Capture rationale so auditors can follow the decision later.
  3. 3
    Approve or reject
    The decision applies the status change or keeps the prior status.
  4. 4
    Current state
    Status and reviewer assignment provide the context for the decision record.

How people use this in practice

Control execution: implement → review → execute

Typical workflow:

  1. An editor (or control owner) implements the control by completing components and attaching evidence.
  2. When ready, they request a status change to executed and choose one or more reviewers.
  3. Reviewers approve or reject in the control’s Comments and Logs.
  4. The decision becomes part of the audit trail.

Requirement fulfillment: ready for review → fulfill

Requirements do not use review requests.

Typical workflow:

  1. Controls mapped to the requirement are executed.
  2. The requirement becomes ready for review.
  3. The requirement owner validates that the linked controls and evidence satisfy the obligation.
  4. The requirement owner marks the requirement fulfilled.

Reopening work without losing integrity

In continuous governance, things change:

  • a system changes
  • a vendor changes
  • an incident reveals a missing control

Modulos is designed to allow reopening work while preserving the “why”:

  • reopening an executed control should be deliberate and explainable
  • when requirements are already ready for review, reverting controls requires an explicit reason