CLN Wiki · CLN Semantics
Cognitive Categories CONCEPT
SUMMARY
click to copy as CLN
=Cognitive Category — mental type of a fact, assigned before writing it down
.CLN has 9 categories — each mapped to one operator
.classification is a cognitive act — forces clarity before expression
.02 · The 9 Categories
→Definition · Action · Risk · Unknown · Result · Tension · Pro · Con · Meta
.03 · Classify First
!writing before classifying = prose — meaning stays implicit
.05 · Operator as Act
→choosing an operator IS a micro-decision — forces cognitive work upfront
What TYPE is this fact? Ask before you write.
Double-click any line to anchor it.
Right-click to tagmarry or record a decision.
01//
Definition
Concept
// ##CC-DEF · What a cognitive category is
=Cognitive Category — the mental type of a piece of information, independent of its content
."the server crashed" is content
."this is a risk" is a cognitive category
→CLN forces the writer to identify the category — then express the content
// ##CC-CONTRAST · Why prose doesn't do this
~Prose buries category inside language — reader must infer it
."notably, the server crashed" → risk? result? definition?
.reader wastes cognitive load parsing type — not processing fact
!in CLN, ! the server crashed — zero ambiguity about category
// ##CC-WHY · Why this matters
→category assignment is the act of understanding — not decoration
.if you can't assign a category — you don't fully understand the fact yet
.ambiguous category = ambiguous thinking
02//
The 9 Categories
Reference
// ##CC-NINE · Complete category map
=CLN maps 9 cognitive categories — one operator per category
.categories are universal — apply to any domain or language
.they were not invented — they were observed from how thinking already works
=
Definition
What is this?
.
Action / Step
What to do?
!
Risk / Warning
What can go wrong?
?
Unknown
What don't we know?
→
Result / Conclusion
What follows?
~
Tension
What is unresolvable?
+
Pro / Advantage
What works in favour?
-
Con / Cost
What works against?
@
Metadata
Who / when / where / source?
// ##CC-GAPS · What about everything else?
?What if a fact doesn't fit neatly into one category?
→that ambiguity is information — it means the thought needs more work
.force-fit to nearest category — write the line — refine later
!leaving it uncategorised is the worst option — it disappears in prose
03//
Classify First
Practice
// ##CC-CF · The classify-first workflow
=Classify First — decide the operator before writing the line content
.prose workflow: write thought → category implicit in phrasing
.CLN workflow: identify category → select operator → write content
→the pause between "what type?" and "what content?" is where thinking happens
DEMO · the same thought — prose vs classify-first CLN
Prose (no classification)
CLN (classify-first)
The new caching layer improved response time but there are concerns about memory usage especially under peak load. → category unclear
+ caching layer → response time improved
! memory usage — concern under peak load
? threshold before memory becomes critical
// ##CC-CF-GAIN · What classify-first produces
+1 prose sentence → 3 typed CLN lines
+categories are now scannable — reader finds risks by scanning !
+hidden unknown surfaced — prose buried the ? entirely
→classify-first doesn't just format thought — it completes it
04//
Cost of No Category
Risk
// ##CC-COST · What happens without category assignment
!Uncategorised facts are cognitively invisible at scan speed
.reader cannot risk-scan — must read everything
.reader cannot action-scan — tasks hidden in narrative
.unknowns are not surfaced — open questions stay open silently
!
Risks stay in prose — not actionable until disaster
?
Unknowns are never surfaced — assumed resolved
.
Actions buried — accountability diffused
~
Tensions invisible — decisions made without acknowledging trade-offs
+
Advantages not credited — can't compare options structurally
// ##CC-PARADOX · The fluency paradox
~Well-written prose feels complete — but categories are missing
.fluency creates illusion of clarity — prose camouflage
.CLN breaks the illusion — forces each fact to earn its category
!if you can't assign an operator — you may not understand the fact
05//
Operator as Act
Principle
// ##CC-ACT · Choosing an operator is a cognitive act
=Selecting an operator is not formatting — it is a micro-decision
.you ask: "is this a risk, a result, or a tension?"
.that question forces clarity — sometimes surfaces disagreement
→two people who pick different operators for the same fact — see it differently
// ##CC-ACT-VAL · Why this is valuable
+CLN makes thinking visible at the point of writing
+operator disagreement = productive conflict — surfaces assumptions
+operator consistency across a team = shared mental model
.when everyone uses ! for risk — risk scanning works across all docs
// ##CC-ACT-LOOP · The full loop
→encounter fact → ask "what type?" → select operator → write line
.this loop is Operator Thinking — the core CLN habit
.once automatic — writing becomes structured at the point of thought
→9 categories · 9 operators · one cognitive act per line