CLN Operator · Reference
@
At
Metadata · Status · Owner · Source
"Who / when / where / what state?"
Operator CLN v2.1 Plain-text · Universal
01// @ — Definition

Annotates. Assigns ownership. Tags status. Cites sources.

Cognitive question answered: "Who / when / where / what state?"
One line = one semantic unit. The At operator tells the reader — before they read the content — that this line answers: Who / when / where / what state?
02// When to use it

Use @ for any metadata that contextualizes but doesn't change the content: owners, deadlines, sources, statuses, priorities. @ is the administrative layer.

When NOT to use it:
Don't use @ for content — use = or . for that. @ is pure metadata. A line with only @ information should be at indent level 2 under its parent.
03// Live Examples
Task management
@owner: devops — deadline: 2h
@priority: P0 — status: in-progress
@blocked by: #api-auth — cannot proceed until resolved
Research citation
@Stanford WFH study — Bloom et al. · 2015
@sample: 500 employees — CTRIP call center, 9 months
@domain: organizational psychology
Incident metadata
@started: 2026-02-21 14:32 UTC
@detected by: Datadog alert
@responders: ops-team — incident channel: #inc-checkout
04// Operator Pairs

Operators don't work in isolation — they form semantic pairs that together convey full cognitive structure:

== is the content · @ is the context around that content
.. is the task · @ is the owner, deadline, or status of that task
!! is the risk · @ is who owns the mitigation and by when