Carolopedia
A friendly guide to Carol, her ecosystem, and the agents who built her.
📖What it means
The 4-digit family number (CAROL-INI-NNNN) defines an INITIATIVE; an attempt (the -NN suffix) is one try at that initiative and is NOT an initiative itself. RSI diagnosis filings are not initiatives at all — they investigate one. Every initiatives row carries its family in the stamped initiative_nnnn column: a filing trigger parses the canonical title, a second trigger stamps diagnosis filings with the family of the initiative they DIAGNOSE, and the backfill covered all history — so consumers read the column and never derive families from titles. Any surface that counts initiatives counts DISTINCT FAMILIES (never attempt records, never diagnosis shells), via the shared day-count module (shared machinery).
⚖️What it is NOT
The neighbours this word is most often confused with, and the line between them.
Not: Attempt
The 4-digit number is the initiative; the -NN row is one TRY at it and is never an initiative in its own right.
Not: Run
An attempt is one try at the whole initiative; a run is one execution of one droid inside it.
🧭The nuance
Ninad rulings 2026-07-24 (CAROL-INI-3323 + 3324). TWO canonical per-day family counts that DIFFER by design: COMPLETED (Activity Tracker — a family counts when its LATEST attempt reaches review/closed with real work; failed/superseded attempts never count) vs WORKED (Token Cost Tracker — families with spend that day showing real pipeline work, matching the Pipeline app's in-flight view; diagnosis spend lands on the diagnosed family). Counting rule: cookbook #937; attempt model: cookbook #45; every displayed count's meaning: the app_handbook registry table (cookbook #938). Attempt supersession doctrine: CAROL-INI-2887.
🗣️Also called
familythe 4-digit numberinitiative family