Capablio

Capablio Adaptive Feedback Framework

Version: 0.1 concept pack Date: 2026-07-16 Status: Product and domain architecture for review, not a validated psychometric instrument

Updated

Purpose

This pack describes a more robust Capablio framework for continuous, multi-rater feedback and personal development. It is designed around five requirements:

  1. Question packs that can run daily, weekly, monthly, quarterly, annually, or on events.
  2. Per-question re-ask cooldowns expressed as a number of cadence periods to skip.
  3. PDP-driven overrides that may shorten a cooldown or force a question into the next eligible survey.
  4. Constrained rotation of questions and bundles so surveys stay short while eligible content eventually reaches full coverage.
  5. Tenant-specific questions, bundles, policies, schedules, and governance.

Thomas 360 is treated as an importable external baseline, not as the governing data model. The framework preserves Thomas-compatible concepts such as multi-rater relationships, a 1–7 scale, Not Observed, competency grouping, comments, and PDP themes, while supporting a much richer longitudinal model.

Core product decision

The stable measurement unit is not an exact sentence. It is a Question Family attached to a stable Construct. A family can have variants for different cadences, observation windows, roles, respondent relationships, languages, and scales.

Example:

  • Construct: feedback loop closure
  • Weekly direct-report variant: “This week, my manager explained what changed after receiving feedback.”
  • Quarterly peer variant: “During the past quarter, this leader consistently closed the loop after receiving feedback.”
  • Annual self variant: “Over the past year, I regularly communicated what I changed after receiving feedback.”

This preserves conceptual continuity without forcing a daily question to use annual-review wording.

Important terminology

  • Cadence: how often a survey window is created.
  • Exposure cooldown: how many complete cadence periods must be skipped before the same question can be presented again.
  • Data retention: how long response data is stored. This is a privacy setting and must never share the same field or implementation as exposure cooldown.
  • Subject seat: a person whose development and longitudinal record are managed. Respondents and external raters should not consume paid seats.
  • Anchor item: a stable item repeated on a predictable cadence for trend continuity.
  • Rotating item: an eligible item selected by the coverage engine.
  • PDP item: an item selected or forced because it is linked to an active development objective.

A normal recurring survey should use a constrained mix rather than pure randomness:

  • 20–30% anchors for trend continuity
  • 40–60% rotating items for coverage
  • 10–30% PDP or event-triggered items
  • Optional open text, normally no more than one prompt

Daily surveys should usually contain one or two state questions. Weekly surveys should usually contain three to five questions. Leadership 360 questions should not be asked daily.

Pack map

File Purpose
00_assumptions_and_decisions.md Scope, principles, terminology, and non-goals
01_product_architecture.md Product capabilities, personas, and workflows
02_domain_model.md Core entities and invariants
03_question_architecture.md Construct, family, variant, scale, and metadata design
04_pack_format.md Proposed Markdown pack format and validation rules
05_cadence_and_cooldown.md Period calculations, skip semantics, and exposure ledger
06_survey_assembly_engine.md Candidate filtering, quota filling, bundle selection, and coverage
07_pdp_adaptive_loop.md PDP states, recurrence overrides, and safeguards
08_tenant_customization_and_governance.md Tenant overlays, publishing, roles, and versioning
09_thomas_compatibility.md Thomas import and crosswalk strategy
10_analytics_scoring_and_reporting.md Aggregation, trends, coverage, and report design
11_privacy_security_and_data_retention.md Anonymity, privacy, deletion, and tenant isolation
12_integrations_api_events.md API, events, channels, HRIS, and import/export
13_competitor_landscape.md Current competitor and pricing research
14_pricing_and_entitlements.md Recommended plans, prices, and feature limits
15_mvp_roadmap.md Phased implementation and acceptance criteria
16_open_questions.md Decisions still requiring product validation
packs/ Illustrative cadence and domain question packs
examples/ Example question-family and tenant-overlay definitions

How to use this pack

  1. Review 00, 03, 05, 06, and 07 first; they contain the main architectural decisions.
  2. Run a product workshop against 16_open_questions.md.
  3. Convert the selected Markdown schema to JSON Schema or Protocol Buffers before implementation.
  4. Pilot packs with real organizations before describing them as validated or benchmarkable.
  5. Keep commercial entitlements separate from software release flags and tenant policy settings.

Design warning

“Eventually achieve 100% question coverage” is only possible when the available survey slots are sufficient for the eligible question and bundle inventory. The platform must calculate feasibility and show the projected completion period. It must not promise 100% coverage under an impossible quota.