MOOLLM
"Many-Voiced Object-Oriented LLM — the system that explains itself."
What Is It?
The moollm skill is the spirit and constitution of MOOLLM itself. It's the top-level help agent that can:
- Explain what MOOLLM is
- Answer "what can I do?"
- Navigate users to relevant skills
- Articulate the philosophy
- Show the constitution
- Recommend approaches for tasks
When confused, invoke this skill.
The Core Ideas
Many-Voiced
MOOLLM doesn't use a single LLM perspective. It simulates multiple agents debating within a single call:
- Committees of personas with opposing views
- Deliberation forced by Robert's Rules
- Evaluation by independent assessors
- The debate produces wisdom, not statistics
Filesystem as World Model
Directories are rooms. Files are objects:
examples/adventure-4/
├── pub/ # A room
│ ├── ROOM.yml # Room properties
│ ├── pie-table.yml # An object
│ └── cat-cave/ # Nested room
├── characters/ # Metaphysical room
└── ADVENTURE.yml # Game state
Play-Learn-Lift
The methodology:
- PLAY — Explore freely, try things, fail safely
- LEARN — Notice patterns, document what works
- LIFT — Share as reusable skills
Skills as Prototypes
Skills are documented capabilities that can be:
- Instantiated into specific contexts
- Composed with other skills
- Inherited (multiple inheritance)
- Evolved through play
Protocol
When invoked, this skill should:
- Assess what the user needs
- If lost → provide orientation
- If asking "what can I do?" → show relevant capabilities
- If asking about philosophy → explain core concepts
- If asking about skills → navigate to skill system
- Always be helpful, welcoming, and clear
Constitutional File Map (kernel/)
kernel/README.md — index and navigation for kernel docs
kernel/constitution-core.md — core constitution and invariants
kernel/constitution-template.md — template for new constitutions
kernel/ARCHITECTURE.md — system architecture overview
kernel/context-assembly-protocol.md — context assembly rules
kernel/memory-management-protocol.md — memory, limits, persistence
kernel/event-logging-protocol.md — logging and provenance
kernel/tool-calling-protocol.md — tool usage contract
kernel/self-healing-protocol.md — recovery and repair behaviors
kernel/DIRECTORY-AS-OBJECT.md — directory as object model
kernel/SELFISH-COM-IMPLEMENTATION.md — SELF lineage in practice
kernel/INTEREST-GATES.yml — attention gating rules
kernel/NAMING.yml — top-level naming policy
kernel/naming/NAMING.yml — detailed naming rules
kernel/naming/NAMING-K-LINES.yml — K-line naming standards
kernel/naming/NAMING-CONSTELLATIONS.yml — constellation naming
kernel/naming/NAMING-COMPILATION.yml — compiled name patterns
kernel/naming/NAMING-PATH-VARIABLES.yml — path variable rules
kernel/naming/NAMING-RELATIONSHIPS.yml — relationship naming
kernel/naming/URLS.yml — URL conventions
kernel/drivers/README.md — driver index
kernel/drivers/cursor.yml — Cursor-specific driver
kernel/drivers/generic.yml — baseline driver
kernel/drivers/custom.yml — site-specific overrides
kernel/drivers/claude-code.yml — Claude Code driver
kernel/drivers/antigravity.yml — experimental driver
Local Runtime Files (.moollm/)
These are gitignored runtime files for session state, scratch, and logs.
.moollm/working-set.yml — current focus and active files
.moollm/hot.yml — priority hints
.moollm/cold.yml — cold-start state
.moollm/startup.yml — startup context
.moollm/output.md — append-only output log
.moollm/session-log.md — append-only session log
.moollm/bootstrap-probe.yml — bootstrap probes and checks
Cursor Boot Optimization (cursor-mirror)
Use cursor-mirror to inspect boot state, reduce context bloat, and verify setup.
Commands (need composer ID):
tree — list sessions/composers
status — quick health check
tail --limit 50 — recent messages
timeline <composer> — full event sequence
thinking <composer> — reasoning blocks
tools <composer> — tool call history
grep <pattern> — search transcripts
Use this to:
- confirm which bootstrap ran
- locate missing context
- triage performance issues
- audit tool-call provenance
Plan: MOOLLM Linter, Mirror, Compiler
Phase 0 — Meta Inhale (Planning Only)
- Inventory the repository structure and file types.
- Define categories: essential, primary, secondary, hidden.
- Establish ignore rules (build output, caches, temp files, editor artifacts).
- Identify canonical docs to preserve: top-level
README.md, designs/, docs/.
- Map root entry points to their authoritative specs (skills, kernels, protocols).
- Reverse-engineer the root
README.md into a structured spec:
- Purpose
- Audience
- Sections
- Source references
- Link strategy
- Define a report format for validation output:
- Structural warnings
- Missing declarations
- Naming consistency
- Cross-link integrity
- Define "what to hide" for human-facing outputs (noise, duplication, low-signal).
- Define "what to surface" for quick navigation (skills index, starting points).
- Define sister-script scope: lint, mirror, compile.
- Write a sister-script design brief (no code yet).
Inputs
- User questions about MOOLLM
- Requests for help or navigation
- Philosophical inquiries
Outputs
- Clear explanations
- Skill recommendations
- Navigation guidance
- Philosophy articulation
Dovetails With
Protocol Symbol
MOOLLM-HELP
Invoke when: User is confused, lost, or wants to understand the system.
See: PROTOCOLS.yml
1---
2name: moollm
3description: "The soul of MOOLLM — self-explanation, help, navigation, philosophy"
4license: MIT
5tier: 0
6allowed-tools: [read_file, list_dir]
7protocol: MOOLLM-HELP
8related: [leela-ai, plain-text, room, yaml-jazz, skill, k-lines, play-learn-lift, sister-script, sniffable-python, society-of-mind, adversarial-committee, constructionism, postel, speed-of-light, representation-ethics, incarnation, adventure, needs, prototype]
9tags: [moollm, meta, help, philosophy, navigation, foundational]
10metadata:
11 source: https://skillmd.com/skills/majiayu000/moollm
12---
13
14# MOOLLM
15
16> *"Many-Voiced Object-Oriented LLM — the system that explains itself."*
17
18---
19
20## What Is It?
21
22The **moollm** skill is the spirit and constitution of MOOLLM itself. It's the top-level help agent that can:
23
24- Explain what MOOLLM is
25- Answer "what can I do?"
26- Navigate users to relevant skills
27- Articulate the philosophy
28- Show the constitution
29- Recommend approaches for tasks
30
31When confused, invoke this skill.
32
33## The Core Ideas
34
35### Many-Voiced
36
37MOOLLM doesn't use a single LLM perspective. It simulates **multiple agents debating** within a single call:
38
39- Committees of personas with opposing views
40- Deliberation forced by Robert's Rules
41- Evaluation by independent assessors
42- The debate produces wisdom, not statistics
43
44### Filesystem as World Model
45
46Directories are rooms. Files are objects:
47
48```
49examples/adventure-4/
50├── pub/ # A room
51│ ├── ROOM.yml # Room properties
52│ ├── pie-table.yml # An object
53│ └── cat-cave/ # Nested room
54├── characters/ # Metaphysical room
55└── ADVENTURE.yml # Game state
56```
57
58### Play-Learn-Lift
59
60The methodology:
61
621. **PLAY** — Explore freely, try things, fail safely
632. **LEARN** — Notice patterns, document what works
643. **LIFT** — Share as reusable skills
65
66### Skills as Prototypes
67
68Skills are documented capabilities that can be:
69- Instantiated into specific contexts
70- Composed with other skills
71- Inherited (multiple inheritance)
72- Evolved through play
73
74## Protocol
75
76When invoked, this skill should:
77
781. Assess what the user needs
792. If lost → provide orientation
803. If asking "what can I do?" → show relevant capabilities
814. If asking about philosophy → explain core concepts
825. If asking about skills → navigate to skill system
836. Always be helpful, welcoming, and clear
84
85## Constitutional File Map (kernel/)
86
87- `kernel/README.md` — index and navigation for kernel docs
88- `kernel/constitution-core.md` — core constitution and invariants
89- `kernel/constitution-template.md` — template for new constitutions
90- `kernel/ARCHITECTURE.md` — system architecture overview
91- `kernel/context-assembly-protocol.md` — context assembly rules
92- `kernel/memory-management-protocol.md` — memory, limits, persistence
93- `kernel/event-logging-protocol.md` — logging and provenance
94- `kernel/tool-calling-protocol.md` — tool usage contract
95- `kernel/self-healing-protocol.md` — recovery and repair behaviors
96- `kernel/DIRECTORY-AS-OBJECT.md` — directory as object model
97- `kernel/SELFISH-COM-IMPLEMENTATION.md` — SELF lineage in practice
98- `kernel/INTEREST-GATES.yml` — attention gating rules
99- `kernel/NAMING.yml` — top-level naming policy
100- `kernel/naming/NAMING.yml` — detailed naming rules
101- `kernel/naming/NAMING-K-LINES.yml` — K-line naming standards
102- `kernel/naming/NAMING-CONSTELLATIONS.yml` — constellation naming
103- `kernel/naming/NAMING-COMPILATION.yml` — compiled name patterns
104- `kernel/naming/NAMING-PATH-VARIABLES.yml` — path variable rules
105- `kernel/naming/NAMING-RELATIONSHIPS.yml` — relationship naming
106- `kernel/naming/URLS.yml` — URL conventions
107- `kernel/drivers/README.md` — driver index
108- `kernel/drivers/cursor.yml` — Cursor-specific driver
109- `kernel/drivers/generic.yml` — baseline driver
110- `kernel/drivers/custom.yml` — site-specific overrides
111- `kernel/drivers/claude-code.yml` — Claude Code driver
112- `kernel/drivers/antigravity.yml` — experimental driver
113
114## Local Runtime Files (.moollm/)
115
116These are gitignored runtime files for session state, scratch, and logs.
117
118- `.moollm/working-set.yml` — current focus and active files
119- `.moollm/hot.yml` — priority hints
120- `.moollm/cold.yml` — cold-start state
121- `.moollm/startup.yml` — startup context
122- `.moollm/output.md` — append-only output log
123- `.moollm/session-log.md` — append-only session log
124- `.moollm/bootstrap-probe.yml` — bootstrap probes and checks
125
126## Cursor Boot Optimization (cursor-mirror)
127
128Use cursor-mirror to inspect boot state, reduce context bloat, and verify setup.
129
130Commands (need composer ID):
131- `tree` — list sessions/composers
132- `status` — quick health check
133- `tail --limit 50` — recent messages
134- `timeline <composer>` — full event sequence
135- `thinking <composer>` — reasoning blocks
136- `tools <composer>` — tool call history
137- `grep <pattern>` — search transcripts
138
139Use this to:
140- confirm which bootstrap ran
141- locate missing context
142- triage performance issues
143- audit tool-call provenance
144
145## Plan: MOOLLM Linter, Mirror, Compiler
146
147### Phase 0 — Meta Inhale (Planning Only)
148
1491. Inventory the repository structure and file types.
1502. Define categories: essential, primary, secondary, hidden.
1513. Establish ignore rules (build output, caches, temp files, editor artifacts).
1524. Identify canonical docs to preserve: top-level `README.md`, `designs/`, `docs/`.
1535. Map root entry points to their authoritative specs (skills, kernels, protocols).
1546. Reverse-engineer the root `README.md` into a structured spec:
155 - Purpose
156 - Audience
157 - Sections
158 - Source references
159 - Link strategy
1607. Define a report format for validation output:
161 - Structural warnings
162 - Missing declarations
163 - Naming consistency
164 - Cross-link integrity
1658. Define "what to hide" for human-facing outputs (noise, duplication, low-signal).
1669. Define "what to surface" for quick navigation (skills index, starting points).
16710. Define sister-script scope: lint, mirror, compile.
16811. Write a sister-script design brief (no code yet).
169
170## Inputs
171
172- User questions about MOOLLM
173- Requests for help or navigation
174- Philosophical inquiries
175
176## Outputs
177
178- Clear explanations
179- Skill recommendations
180- Navigation guidance
181- Philosophy articulation
182
183## Dovetails With
184
185- **[skill/](../skill/)** — How skills work
186- **[k-lines/](../k-lines/)** — K-lines and naming
187- **[play-learn-lift/](../play-learn-lift/)** — The methodology
188- **[kernel/constitution-core.md](../../kernel/constitution-core.md)** — The constitution
189
190## Protocol Symbol
191
192```
193MOOLLM-HELP
194```
195
196Invoke when: User is confused, lost, or wants to understand the system.
197
198See: [PROTOCOLS.yml](../../PROTOCOLS.yml#MOOLLM-HELP)