Docs·2ac88ac·Updated Apr 9, 2026·48 ADRs
Back

Trust Questions

Trust Questions

The trust model questionnaire that founders answer when creating a community is not hardcoded into the app — it lives in the database as a set of questions and choices, each with a config_delta that describes which configuration fields the answer affects.


How It Works

When a community is created (or a founder revisits the trust model), they answer a series of questions. Each answer maps to one or more configuration fields. The system merges all selected answers in display_order ascending order to produce the final CommunityConfig.

This merge strategy means later questions (higher display_order) can override earlier ones. Question 6 (request_curation, display_order 50) intentionally overrides the request_approval_required value that Question 2 (new_member_warmth) may have set — the founder's explicit curation preference wins.


The Six Questions

#Slugdisplay_orderWhat it configures
1who_is_this_for10Visibility mode, join approval, member cap, outsider response
2new_member_warmth20New member karma lockout days, initial request approval
3relationship_style30Trust depth/breadth weights
4asking_for_help40Karma splits (helper vs. requestor)
5generosity_memory45Karma and trust decay half-lives
6request_curation50Request approval required (final override)

Config Delta Pattern

Each choice stores a config_delta — a partial CommunityConfig object. When an answer is selected, its delta is merged into the running config. This means:

  • A choice can set multiple fields at once
  • Later questions override earlier ones for any overlapping fields
  • Unanswered questions contribute no delta (safe default)

Example: choosing admin_review for Q6 sets { request_approval_required: true }, overriding whatever Q2 set.


Admin Management

Platform admins can manage questions and choices via the admin UI at /admin/trust-questions. From there, you can:

  • Edit question text, subtext, and display order
  • Toggle questions active/inactive
  • Edit choice labels, descriptions, and config_delta values
  • Add new choices or questions

Changes take effect immediately for new community creation flows. Existing communities are unaffected until they revisit their trust model.


API

The questions endpoint is public (no auth required for reading):

GET /communities/trust-questions

Returns all active questions ordered by display_order, each with their active choices.

Admin operations (create/update/delete) require an admin JWT.