Loro

Use this skill as the single entry point for all Loro work. Load one primary chapter first. Load a second chapter only when the task clearly crosses domains.

Select A Chapter

• Read references/topic-map.md if the task is broad and you need to route it.
• Read references/fit-and-architecture.md for CRDT fit, local-first framing, setup, and high-level architecture.
• Read references/containers-and-encoding.md for container choice, composition, encoding, persistence, shallow snapshots, and redaction.
• Read references/sync-versioning-and-events.md for sync flows, frontiers, version vectors, checkout, import status, timestamps, event timing, and Inspector.
• Read references/richtext-and-editors.md for LoroText, cursors, applyDelta, updateByLine, loro-prosemirror, Tiptap, and CodeMirror.
• Read references/mirror-and-react.md for loro-mirror, $cid, idSelector, validation, selectors, and React integration.
• Read references/wasm-maintenance.md for crates/loro-wasm, #[wasm_bindgen], pending-event flushing, wrapper decoration, and tests.
• Read references/performance-and-research.md for benchmarks, Eg-Walker tradeoffs, movable-tree context, rich-text design context, and project history.

Route Common Tasks

• “Build a collaborative document model / choose data types / persist history”
  • Start with containers-and-encoding.md
  • Add sync-versioning-and-events.md if version/history behavior matters
• “Debug checkout / detached mode / missing imports / event timing”
  • Start with sync-versioning-and-events.md
• “Integrate ProseMirror, Tiptap, CodeMirror, or custom rich text”
  • Start with richtext-and-editors.md
  • Add sync-versioning-and-events.md if undo/version/event behavior matters
• “Model app state with loro-mirror or loro-mirror-react”
  • Start with mirror-and-react.md
  • Add containers-and-encoding.md if schema semantics depend on container choice
• “Change wasm bindings or debug pending event flushing”
  • Start with wasm-maintenance.md
• “Decide whether Loro is even the right tool / explain tradeoffs”
  • Start with fit-and-architecture.md
  • Add performance-and-research.md if benchmark or research context matters

Execute The Task

1. Classify the task before reading everything.
2. Load one primary chapter.
3. Load at most one secondary chapter for cross-domain work.
4. Keep solutions grounded in Loro semantics:
   • choose data types by merge behavior,
   • distinguish state version from history version,
   • keep ephemeral state out of persisted CRDT data,
   • respect the binding/runtime invariants in crates/loro-wasm.

Keep Guardrails

• Do not assume CRDTs are the right fit for hard invariants, exclusivity, or authorization-at-write-time problems.
• Do not model editable text as plain strings when user intent requires merged edits.
• Do not reuse peer IDs across concurrent sessions.
• Do not confuse detached documents with detached containers.
• Do not change wasm-exposed mutators without checking pending-event flushing behavior.