Skip to content

Bricks and Trust Indicators (Admin Guide)

This guide covers the accountability layer: Bricks (quarterly commitments) and Trust Indicators / Trust Pulse (the KPIs and their readings). Both are operated by Perpetum admins; family and internal roles mostly read them.

The Bricks admin: quarterly commitments with their workflow status

The Bricks admin: quarterly commitments with their workflow status (Illustrative, from the IS4 preview environment.)

Who can do this: - Bricks (create, edit, move status, record outcome, roll over): L2 / L3. - Strikes: L3 only. - Trust Pulse: L2 / L3 draft; publish / withdraw is L3-only and currently Phase-4-gated (drafts only in Phase 3).


Part 1: Bricks

A Brick is a single quarterly commitment. It carries two distinct fields, never merged:

  • Workflow Status (while the quarter is open): Being Negotiated, On Track, At Risk, Paused, Completed.
  • Outcome (recorded at quarter close): Completed, Not Completed, Paused.

On Track / At Risk are workflow states only; they are never recorded as an Outcome.

flowchart LR
  Req["Requested by a<br/>room leader or owner"] --> BN[Being Negotiated]
  BN -->|admin confirms| OT[On Track]
  OT <--> AR[At Risk]
  OT --> PA[Paused]
  OT --> CO[Completed]
  CO --> CLOSE{{Quarter close:<br/>record Outcome}}
  AR --> CLOSE
  PA --> CLOSE
  CLOSE --> O1[Completed]
  CLOSE --> O2[Not Completed]
  CLOSE --> O3[Paused]

1. The request queue

A Brick starts as a request from a room leader or owner.

  1. Open Brick queue (/admin/bricks/queue).
  2. Review each requested Brick (the proposed title, room, owner).
  3. Accept a request to bring it into the system as a Brick in the Being Negotiated state (the original request row is kept for history). Or reject it.

A Brick is only ever created in the system by L2 or L3. A request is not a write; acceptance is what creates the Brick.

2. Create, edit, and move a Brick

On the Bricks surface (/admin/bricks):

  • Create a Brick: name it, set its room, due date, Room Leader, and Support.
  • Edit its details.
  • Move its Workflow Status through the quarter: Being Negotiated, then On Track once negotiation confirms it, At Risk if it slips, Paused if held, Completed when finished.

3. Close the quarter

At quarter end, open Close quarter (/admin/bricks/close-quarter):

  1. The surface lists the quarter's unfinished Bricks.
  2. For each, record the Outcome: Completed, Not Completed, or Paused.
  3. Optionally roll over an approved unfinished Brick into the next quarter.

Outcomes are reversible. An admin can revise a recorded Outcome at any time, including correcting one set in error.

4. Strikes (L3 only)

When an unfinished Brick is not approved for rollover, Perpetum L3 may issue a strike.

  1. Open Strikes (/admin/strikes). (L3 only.)
  2. Use Issue strike to record one; use Clear to remove one.

5. How Bricks appear to the family

  • My Bricks on a person's Dashboard: their own Bricks with the current Workflow Status pill.
  • Bricks for this room on the Room Page: every Brick from that room, with status and review date.
  • LG / RG see their own and others' Bricks (transparency). IA / IE see Bricks only when the module is toggled on for them.

Part 2: Trust Indicators and Trust Pulse

Trust Pulse authoring (/admin/trust-pulse): the four-state readings, drafted by L2/L3

Trust Pulse authoring (/admin/trust-pulse): the four-state readings, drafted by L2/L3 (Illustrative, from the IS4 preview environment.)

  • A Trust Indicator is a KPI (the named thing tracked: attendance, action-item closure, backup-leader designated, and so on).
  • A Trust Pulse is the reading on it, in one of four fixed states: Healthy, Needs Attention, Needs Intervention, Paused.

6. Author Trust Indicators

Open Trust Indicators (/admin/trust-indicators) to author the room-level and person-level indicators. These are the named KPIs that then carry readings.

7. Author and publish Trust Pulse readings

Open Trust Pulse (/admin/trust-pulse):

  1. L2 or L3 drafts a reading by hand for a room or person indicator (Healthy / Needs Attention / Needs Intervention / Paused). In the current phase, readings are admin-curated by hand; nothing is computed automatically.
  2. Submit for L3 review moves a draft to "Awaiting L3 review."
  3. L3 publishes the reading (publish and withdraw are L3-only).

Phase note: automated Trust Pulse computation and formal publication unlock in Phase 4. Publish / withdraw are L3-only and Phase-4-gated, so today L2/L3 author drafts and submit for review; readings are not auto-computed or auto-published.

8. How Trust Pulse appears to the family

  • Room Page (full card): the room Trust Pulse pill, and each Trust Indicator row with its Trust Pulse pill.
  • Public Room Card: indicator names only, no Trust Pulse pill (the public card shows the System Care Protocol pill only).
  • Individual Dashboard mini-cards: the person's individual Trust Pulse readings.
  • Next Generation and In-Laws see Trust Indicator names only, never the pills.

9. Quick troubleshooting

Symptom Likely cause Fix
Cannot create a Brick Not L2/L3 Brick creation is L2/L3
A requested Brick is not live Request accepted but still Being Negotiated Move it to On Track once negotiation confirms it
Cannot issue a strike Strikes are L3-only Use an L3 account on the Strikes surface
Cannot publish a Trust Pulse reading Publish is L3-only and Phase-4-gated L2/L3 draft and submit for review; L3 publishes (Phase 4)
Trust Pulse not auto-updating By design in this phase Readings are admin-curated by hand until Phase 4
NG / IL cannot see Trust Pulse pills By design They see indicator names only, never the pills
Brick status looks inconsistent across views Known enum cleanup (issue #28) Canonical statuses are Being Negotiated / On Track / At Risk / Paused / Completed