Docs Configuration

attention.json

The team's rules for ranking and interruptions, committed in .teamtrail/attention.json.

Without the file, the defaults apply. Personal choices (channel, quiet hours) live elsewhere: see Personal settings.

#Example

json
{
  "v": 1,
  "interrupt": 70,
  "digestMinutes": 120,
  "weights": {
    "knowledge": 20,
    "policy": 70
  }
}

#Keys

KeyTypeDefault
v1requiredFile format version.
interruptnumber 0–20070Items scoring at or above this notify actively; the rest wait in the list and the digest.
digestMinutesminutes 0–1008060How often Slack sends each trail's digest of non-urgent items, re-read live; 0 turns it off.
weightsobject of kind → 0–100see belowHow much each kind counts. Kinds you leave out keep their default.

#Default weights

KindWeightKindWeight
question60integration45
blocked60stalled40
reroute60overlap40
brief55hitl-ready35
approval50flag35
policy50reroute-suggested30
knowledge15

An item's score starts at half its kind's weight, then adds urgency, held tickets, an idle agent and age. With the defaults, a blocking question with an idle agent scores exactly 70, so it interrupts. See Waiting on you for the full rules.

#Errors

A broken attention.json never stops the list: each bad value falls back to its default, and every problem is shown in Settings → Attention. (policy.json also falls back, to its strict defaults; verification.json doesn't, because running no checks would let unchecked work through.)

text
unknown kind "chat" in "weights" (one of question, blocked, reroute, …)
"interrupt" must be a number from 0 to 200