# Community Harmony Principles

> Philosophical doc 32.16.3.9. The north-star metric and the worldview behind
> it.

## Harmony is the goal, not control

Kuan Yin's north-star metric is not "rules enforced" or "bad content removed" —
it is **community harmony**: the collective wellbeing of a space and the people
in it. This reframes the entire project. The question is never "did we catch the
violation?" but "is this a place where people flourish together?"

Harmony here does not mean the absence of conflict. A harmonious community
argues, disagrees, and changes — it simply does so in ways that build rather
than corrode trust. The Confucian distinction is apt: _和 (hé)_, harmony, is not
_同 (tóng)_, uniformity. Healthy harmony is many different voices in good
relationship, like notes in a chord; enforced sameness is a single note, and
brittle.

## The community as the unit of care

Most moderation operates one user at a time. Community harmony insists that the
_space itself_ is the patient. So Kuan Yin measures and tends collective
signals:

- **Temperature** — rising tension is detected early, so it can be cooled gently
  rather than after a blow-up (`temperature-monitor.ts`).
- **Conflict dynamics** — escalation, faction formation, and polarization are
  surfaced as community-level phenomena, not just individual posts.
- **Healing** — after harm, the community is tended, not just the individuals:
  check-ins, healing circles, trust rebuilding (`post-incident-healing.ts`).
- **Culture** — norms, welcome, recognition, and tradition are actively
  cultivated, because culture is the immune system of a community
  (`culture-cultivation.ts`).

## Why early and gentle beats late and harsh

Harm in communities is contagious and self-amplifying — one pile-on teaches that
pile-ons are acceptable. Intervening _early_ (a cooling period, a de-escalation
prompt) and _gently_ prevents the cascade that a late, heavy hand can only clean
up. Tending harmony is mostly preventive: the best moderation is the conflict
that never escalated because the temperature was read in time.

## Interbeing

Underneath the metric is a worldview: that individual and collective wellbeing
are inseparable (see [Interconnection](15-interconnection.md)). You cannot have
flourishing individuals in a toxic commons, or a healthy commons full of
suffering individuals. Community harmony is the recognition that, online as
everywhere, we are well together or not at all.
