Help Docs/Science & Principles
All docs

Science & Principles

Goaliath uses a clear theory order: Perceptual Control Theory first, then Goal-Setting Theory, then Self-Determination Theory.

How to use this page

Use this as a practical map for why features exist and how to adjust behavior when progress stalls.

Theory order used in product decisions

  1. Perceptual Control Theory: identify the controlled variable, target level, and current error.
  2. Goal-Setting Theory: check capability, opportunity, and motivation constraints that block correction.
  3. Self-Determination Theory: tune autonomy, competence, and relatedness so effort is sustainable.

What good looks like

  • Goals have clear references and visible error-correction loops.
  • Plans address real capability or opportunity constraints.
  • Motivation support preserves agency and avoids pressure framing.

Common issues and fixes

  • Progress stalls: inspect control conflict before adding workload.
  • High effort, low output: reduce reference level or tighten feedback.
  • Motivation swings: increase autonomy and shorten execution cycles.

Related help

Documentation details

  • Last updated: February 16, 2026
  • Doc owner: Behavioral Science + Product Team
  • Source map: docs/behavioral-science/definitive-theory-map.md

Screenshot slot

Add a visual map linking major product areas to theory coverage.