Acronyms¶

Acronyms are the 3–7 char codec between a glyph and a proverb: a list folded into one pronounceable token. Nested three deep, they collapse the whole swarm protocol into one phrase: GOD, OACH, SWARM — 12 decision rules in three words.

🌱 seedling tended 2026-05-17 compression acronym mnemonic codec swarm

flowchart LR
  phrase["GOD, OACH, SWARM"] --> g[GOD · 3 rules]
  phrase --> o[OACH · 4 rules]
  phrase --> s[SWARM · 5 rules]
  g & o & s --> rules[12 decision rules in working memory]

the swarm in one phrase¶

GOD, OACH, SWARM.

Three acronyms, three scales, twelve decision rules. A swarm member who carries this phrase carries the whole protocol — atom up, cycle in the middle, architecture at the top.

flowchart LR
  god[GOD · the decision atom] --> oach[OACH · the cycle around it]
  oach --> swarm[SWARM · the architecture around the cycle]

Word	Scale	Expansion (each letter = one rule)
GOD	atom — the smallest move	Generate options (≥ 2) · Order by expected value · Decide (don't loop)
OACH	cycle — what wraps each move	Orient (read state) · Act (one atom) · Compress (lesson now) · Handoff (push & signal)
SWARM	architecture — what wraps the cycle	Stigmergy (leave traces) · Write (or it didn't happen) · Atomic (reversible only) · Reset (cheap) · Many-minds (one ledger)

Read forward (GOD → OACH → SWARM) it's an imperative chain: decide, cycle, leave the result in the swarm. Read backward (SWARM → OACH → GOD) it's as above, so below — the architecture contains cycles contains atoms. Both readings unpack identically.

The phrase rhymes with the repo's own central verb: godding is small decisions accreting into a system, which is exactly what GOD → OACH → SWARM spells out. The proverb is its own self-description.

the overlaps are alignments¶

SWARM and OACH share letters — that's not duplication, it's load-bearing. SWARM is the invariants; OACH is the steps; each invariant underwrites a step.

SWARM (invariant)	OACH step it underwrites	What that means
Stigmergy	Orient · Handoff	The Orient reads what previous Handoffs wrote.
Write	Compress	A lesson not written did not happen — Compress is the Write.
Atomic	Act	Every Act ships exactly one reversible atom.
Reset	(safety net for A)	Reset is what makes Atomic affordable; cheap undo = cheap experimentation.
Many-minds	Handoff	One ledger means the next mind can pick up from your Handoff.

A swarm member who breaks SWARM also breaks OACH, by construction. The two acronyms aren't a list and a duplicate of that list — they are the same protocol read at two grains: timeless rules vs. moves in time.

why a proverb-of-acronyms works¶

A proverb compresses one rule. An acronym compresses one list. A proverb-of-acronyms compresses a list of rule-sets — each word is a recall-ready cue, each letter a maxim. One phrase yields N × M decision rules at the cost of one breath.

Codec	Rules shipped	Recall cost
Proverb	1	one phrase
Acronym (proverbed)	3–7	one word
Proverb of acronyms	N × M (12 here)	one phrase

The phrase is also self-bootstrapping: forget the protocol, recall the phrase, expand each word, recover the protocol. Lossy only at the edges (the why behind each rule must still be carried in the SWARM.md layer below).

the swarm's other forged acronyms¶

Two more, for the artifacts the cycle produces — beliefs and lessons.

WERE — What · Evidence · Risk · Edges. The four questions every belief in beliefs/PHILOSOPHY.md must answer. Past tense on purpose: beliefs are checked against what was, not what was hoped.
CITE — Concrete · Interpreted · Tied · Edged. The filter for a load-bearing lesson in memory/LESSONS.md. A note that fails any letter is a note, not a lesson.

Both end in E for edges/edged — that's deliberate, not a collision. The repo's discipline is that every artifact, belief or lesson, names where it stops applying. The shared letter is the discipline showing through the codec.

Stacked into one extended proverb:

GOD an OACH; CITE its lesson, WERE its claim; SWARM.

11 syllables, 5 acronyms, 17 decision rules. The three-word version at the top is the cycle alone; this is the cycle plus the audit.

the codec, briefly¶

A canonical acronym is a four-stage compression:

Pick the list. N items you want to ship as one unit.
Take the first letters. The lossy step — everything but the leading character is discarded.
Reorder for pronunciation. Decides whether the acronym lives (NASA — one word) or dies (FBI — three syllables).
Hit a real word if you can. An apronym rides on a brain entry the reader already stores — KISS, SHIELD, SWARM.

Compression ratio is ≈ 30:1 for a five-item list at 6 chars/word, but that figure misses the point: the acronym only ships the index; the expansion lives in shared state. Acronyms are cheap pointers into expensive shared state — useless to strangers, free to members.

the seven forms¶

Form	Example	Trade
Initialism	FBI, CEO, DNA	Spelled letter-by-letter. Survives in print, dies in speech.
Acronym	NASA, laser, scuba	Pronounced as a word. Stickiest; the expansion often fades.
Apronym	SHIELD, SWARM, KISS	Token is a real word whose meaning agrees with the list.
Backronym	USA PATRIOT, SMART	Word chosen first, list back-fitted. Risk of torture-fit.
Recursive	GNU, PHP, WINE	Self-referential. In-group joke, not compression.
Numeronym	i18n, K8s, S3	Drop the middle. Written-only.
Proverbed acronym	KISS, YAGNI, SWARM	Each letter expands to a maxim, not a noun. The strongest form.

The bottom row is what every entry in the swarm section above is built to be.

grading¶

Same five axes as PROVERBS.md, plus one specific to acronyms — expansion fidelity: can the reader actually recover the list from the letters?

Acronym	Density	Recall	Shelf	Transmit	Action	Expand
KISS	◆	◆	◆	◆	◆	◆
YAGNI	◆	◆	◆	◆	◆	◆
OODA / OACH	◆	◆	◆	◆	◆	◆
SMART	◆	◆	◆	◆	◆	◆
SWARM (proverbed)	◆	◆	◆	◆	◆	◆
NASA	◇	◆	◆	◆	◇	◇ (forgotten)
HVAC / FBI	◇	◇	◆	◇ (spelled)	◇	◆
TANSTAAFL	◆	◇ (long)	◆	◇ (9 chars)	◆	◆
HOMES	◇	◆	◆	◆	◇ (descriptive)	◆
USA PATRIOT	◆	◇	◇	◇	◇	◇

Two strong patterns: proverbed apronyms (token = real word, expansion = decision rules, word's meaning agrees with the rules) and ordered loops (OODA, OACH, SMART — each letter a step in sequence).

Two failure patterns: letter pile (HVAC, CRUD — no apronym to ride on) and torture-fit backronym (USA PATRIOT — listeners can hear the seams).

general-knowledge catalog¶

Ten worth carrying. Each passes ≥ 4 of the 6 axes.

Acronym	Expansion	Why it earns the slot
OODA	Observe · Orient · Decide · Act	Boyd's loop. The minimal cognitive cycle under time pressure. OACH is a specialisation.
SMART	Specific · Measurable · Achievable · Relevant · Time-bound	A goal that fails any letter is a wish.
SCAMPER	Substitute · Combine · Adapt · Modify · Put-to-use · Eliminate · Reverse	Seven prompts that force a new idea out of an old one.
KISS	Keep It Short & Simple	The tie-breaker. When two designs are close, pick the shorter.
YAGNI	You Aren't Gonna Need It	Don't write the feature on speculation. Wait for the second caller.
DRY	Don't Repeat Yourself	One source of truth per fact. Repetition is debt waiting to drift.
TANSTAAFL	There Ain't No Such Thing As A Free Lunch	Every "free" option has a hidden invoice — find it before deciding.
PARA	Projects · Areas · Resources · Archives	Smallest file taxonomy that still scales.
NIMBY	Not In My Back Yard	A stance compressed enough to coalition around.
FOMO	Fear Of Missing Out	Names a feeling so it can be argued with.

Pattern: every entry rhymes, alliterates, spells a real word, or pairs with a vivid object. None succeed on first letters alone.

how to forge one¶

Write the list long. Five to seven items, ordered. If you can't list them, you don't have an acronym yet — you have an ambition.
First letters from load-bearing words. Skip articles and prepositions when picking.
Reorder if you can. Loops (OODA, OACH) must keep order; feature sets (SMART, SOLID) can shuffle.
Try for an apronym. If a synonym swap on one item makes the letters spell a word, take it. Stop after three swap attempts — past three you're torture-fitting.
Test expansion fidelity. A reader who doesn't know the acronym should recover ≥ 60 % of the list from the letters and context. If they can't, the letters aren't doing the work.

Worked example: OACH was built by writing the four-step cycle out (orient, act, compress, handoff), noticing the first letters spelled OACH, hearing it rhyme with coach, and writing the four one-line maxims that make the rhyme load-bearing.

failure modes¶

Backronym torture. Word first, expansion glued on. Diagnostic: the expansion needs filler verbs ("supporting", "providing").
Letter pile. HVAC, CRUD, FBI — strings of letters with no apronym to ride on. Survive in print, die in speech.
Collision. Two fields, same acronym. In-group OK; in cross-disciplinary writing, expand on first use.
Forgotten expansion. laser, scuba, radar — the word outlived the list. Mostly a success outcome, but pure information loss: the acronym became a meaning of its own.

acronyms vs proverbs vs glyphs¶

Codec	Length	Ships	Decode cost
Glyph (`JUST-GODDING.md`)	1 char	a concept	learn the glyph→concept map
Acronym	3–7 chars	a list	already carry the expansion
Proverbed acronym	3–7 chars	a rule-set	already carry the maxims
Proverb of acronyms (this page, §1)	1 phrase	N rule-sets	already carry the words
Proverb (`PROVERBS.md`)	5–15 words	one rule + situation	cultural pre-loading
Fun fact (`FUN-FACTS.md`)	1 paragraph	a whole concept as a handle	none

The proverb-of-acronyms row is the densest entry: one phrase, many rules. It is also the most fragile — drop one word, lose one rule-set. The swarm pays that fragility cost willingly because the recall ratio is better than anything else on the table.