CLN Wiki · CLN Semantics
Meaning in CLN CONCEPT
= how operator choice carries semantic load @ CLN Spec · Cognitive Ergonomics
SUMMARY click to copy as CLN
=In CLN, operator choice IS meaning — not the words alone
.same fact, different operator = different cognitive signal
.structure adds a second layer of information above content
.02 · Operator Semantics
→9 operators = 9 cognitive categories pre-loaded
.03 · Same Fact, Different Meaning
~"Revenue grew" under = vs ! vs ~ = 3 different statements
.05 · Structure IS Content
→indentation carries hierarchy — operator carries type — text carries fact
Operator first, words second. Double-click any line to anchor it. Right-click to tagmarry or record a decision.

01// Definition Concept
// ##MIC-DEF · What "meaning" means in CLN
=Meaning in CLN — the operator communicates the cognitive type of a fact, before the reader processes the words
.prose: meaning encoded in sentences — decoded linearly
.CLN: meaning encoded in structure — decoded pre-attentively
→brain reads operator column in ~200ms — before reading text
// ##MIC-TENSION · The core tension
~Tension: we are trained to put meaning in words
.CLN inverts this — operator IS the first word
.words narrow — operator orients
!choosing the wrong operator is the most common CLN error

02// Operator Semantics Reference
// ##MIC-OPS · Cognitive question each operator answers
=each operator answers a specific cognitive question
.brain asks the question before reading text
.operator answers it — text provides the specifics
Op Name Cognitive question answered Example
= Equals What is this? = CLN — notation for structured thinking
. Dot What do I do / what happened? . open the spec file · read §03
! Bang What can go wrong? ! prod deployment fails if env not set
? Question What is unknown / unclear? ? does this scale past 10k users
→ Arrow What follows / what is the result? → revenue grew 40% YoY
~ Tilde What is the unresolvable tension? ~ speed vs quality — can't maximise both
+ Plus What is the advantage? + no vendor lock-in
- Minus What is the cost / downside? - 3× higher infra cost in year 1
@ At Who / when / where / source? @ owner: Alex · due: 2024-12-01

03// Same Fact, Different Meaning Demo
// ##MIC-DEMO · Operator changes the statement entirely
~Same words — different operator = different cognitive statement
.the operator is not decoration — it changes what is being claimed
DEMO · "revenue grew 40% this quarter"
→ revenue grew 40% this quarter result / conclusion

= revenue grew 40% this quarter definition / baseline fact

! revenue grew 40% this quarter risk / warning signal

? revenue grew 40% this quarter unverified / open question

~ revenue grew 40% this quarter tension / paradox present
// ##MIC-MISTAKE · Most common error
!Most common error: using . for everything
.. is action/step — not a neutral bullet point
.treating . as default = losing all semantic signal
→result: CLN that looks structured but carries no meaning layer

04// Semantic Density Measure
// ##MIC-DENSITY · How CLN packs meaning per token
=Semantic Density — amount of cognitive signal per unit of text
.prose: low density — meaning diluted in connective tissue
.CLN: high density — operator carries type, text carries fact only
.no "however", "therefore", "it is worth noting" — operator replaces them
// ##MIC-COMPARISON · Prose vs CLN for the same thought
→Prose: "While the feature has merit, there are significant risks to consider, particularly around scalability."
→CLN equivalent — 3 lines, zero redundancy:
+feature has merit
!scalability risk — significant
~merit vs risk — not resolved yet
// ##MIC-GAIN
+CLN version: 3 facts, 3 cognitive types, zero ambiguity
+prose version: 1 sentence, 1 vague signal, multiple parsings possible
→density ratio: ~3× more cognitive signal per character in CLN

05// Structure IS Content Principle
// ##MIC-PRINCIPLE · The core claim
=In CLN, structure is not a container for content — it IS content
.3 information channels in every CLN line:
.channel 1: indentation level → hierarchy / relationship
.channel 2: operator → cognitive type of the fact
.channel 3: text → the specific fact itself
→prose has only channel 3 — CLN adds 2 structural channels on top
// ##MIC-RESULT · What this enables
+reader builds spatial map of content — not just linear stream
+scan reads the structure — only dive into text when needed
+Associative anchors form naturally — operator + level = unique address
// ##MIC-APPLY · How to apply this
→Before writing: ask "what TYPE is this fact?"
.definition → =
.risk → !
.open question → ?
.result → →
.tension → ~
→operator first — text second — this is how CLN meaning is made
◉ Anchor line
▤ #tagmarry
✎ Record decision