Skip to content
Sadie

Brief

A brief sits above raw feed items and below a full wiki entry. Where a wiki entry is meant to compound across months, a brief is scoped to a moment. The question a brief answers: given the current wave of discourse around a theme, what does it mean for you, given what you already know?

Every brief has a title, a one-sentence summary, a short body, and two anchor sets. anchorWikiIds point to the wiki entries the brief draws on (the “what you already know” side). sourceFeedItemIds point to the feed items that supplied the fresh signal (the “what’s happening now” side).

Status

Section titled “Status”

draft, published, or filed. Most briefs arrive published. You can file a brief to promote its insight back into the wiki. Filing either adds evidence to an existing entry or seeds a new one, with promotedFrom: 'brief' recorded on the resulting entry.

Generation

Section titled “Generation”

Sadie runs the brief generator on a cadence you control. The compiler takes a snapshot of recent feed items, clusters them by theme, and for each cluster with sufficient signal generates a brief anchored to the relevant wiki entries.

Two tuning knobs that matter, both adjustable in Settings and both under the self-evolution layer’s control:

  • briefClusterMinSize is the minimum number of feed items that must be present before a cluster counts as a brief-worthy moment
  • briefMaxPerRefresh is the cap on briefs produced per compile run, so a busy news day does not flood Today

The prose register is shaped by the briefTone prompt slot in Settings.

Policy-gated

Section titled “Policy-gated”

Every brief passes through the policy engine before insertion. Title, summary, and body are linted independently. Rewrite policies apply substitutions in place. Warn policies are recorded silently. If any block policy fires on any of the three fields, the brief is suppressed entirely and a dismissed activity row is logged. No draft quietly slips past a rule you asked Sadie to keep.

Briefs are temporary

Section titled “Briefs are temporary”

Briefs do not replace or override wiki entries. They are synthesis artifacts. Useful right now, promotable when they reveal something durable, safely disposable otherwise.

See also

Section titled “See also”