Example Question Family: Feedback Loop Closure

schema: capablio.question-family/v1
family_id: leadership.feedback.closes_loop
version: 1.0.0
status: pilot
source: capablio-core
owner: framework-leadership
construct_id: leadership.feedback_receptivity
definition: The leader makes their response to feedback visible by explaining what changed or why no change was made.
evidence_type: behavior_frequency

applicability:
  subject_roles: [manager, leader, executive]
  respondent_relationships: [self, manager, peer, direct_report]
  excluded_relationships: [customer]
  minimum_relationship_duration_days: 30

exposure:
  base:
    cadence_unit: MONTH
    skip_periods: 1
    period_count_basis: calendar_periods
    clock_start: presented_at
    scope: respondent_subject_family
    absolute_min_days_between_exposures: 21
    max_asks_per_rolling_90_days: 3
    no_response_counts_as_exposure: true

selection:
  anchor_eligible: true
  coverage_group: feedback_loop
  random_weight: 1.0
  mutually_exclusive_with:
    - leadership.feedback.closes_loop.alt_wording

pdp:
  eligible: true
  follow_up_families:
    - pdp.goal.action_state
    - pdp.goal.observer_change
  default_override:
    mode: force_next_once
    max_consecutive_surveys: 2
    follow_on_skip_periods: 1

reporting:
  polarity: positive
  minimum_group_n: 3
  exact_trend_keys:
    weekly: leadership.feedback.closes_loop.weekly.freq5
    monthly: leadership.feedback.closes_loop.monthly.freq5
    quarterly: leadership.feedback.closes_loop.quarterly.extent7
  cross_scale_normalized_display: true
  cross_scale_aggregation: false

variants:
  - variant_id: leadership.feedback.closes_loop.weekly.direct_report.en.v1
    cadence: WEEK
    observation_window_days: 7
    relationship: direct_report
    locale: en
    prompt: This week, my manager explained what changed after receiving feedback.
    scale_id: FREQUENCY_5
    not_observed: true
    not_applicable: true

  - variant_id: leadership.feedback.closes_loop.monthly.peer.en.v1
    cadence: MONTH
    observation_window_days: 30
    relationship: peer
    locale: en
    prompt: During the past month, this leader closed the loop after receiving feedback.
    scale_id: FREQUENCY_5
    not_observed: true
    not_applicable: true

  - variant_id: leadership.feedback.closes_loop.quarterly.manager.en.v1
    cadence: QUARTER
    observation_window_days: 90
    relationship: manager
    locale: en
    prompt: During the past quarter, this leader consistently explained what changed—or why it did not—after receiving feedback.
    scale_id: EXTENT_7
    not_observed: true
    not_applicable: true

Notes

• The family intentionally excludes customers.
• Weekly, monthly, and quarterly variants have different exact-trend keys.
• The normalized display may place them on a common visual range, but the system does not average them together.
• An active PDP may force the next eligible presentation once, then revert to a one-period skip.