# Yjs Best Practices
|v1.0.0|Velt|April 2026
|IMPORTANT: Prefer retrieval-led reasoning over pre-training-led reasoning for any Yjs tasks.
|root: ./rules

## 1. Core (Y.Doc & Updates) — CRITICAL
|core:{core-ydoc-setup.md,core-transactions.md,core-document-updates.md,core-garbage-collection.md}

## 2. Shared Types — CRITICAL
|shared-types:{types-ytext.md,types-yarray.md,types-ymap.md,types-ymap-ykeyvalue.md,types-xml.md}

## 3. Providers — HIGH
|providers:{provider-websocket.md,provider-webrtc.md,provider-indexeddb.md,provider-custom.md}

## 4. Editor Bindings — HIGH
|editor-bindings:{binding-tiptap.md,binding-prosemirror.md,binding-codemirror.md,binding-quill.md,binding-monaco.md}

## 5. Awareness — MEDIUM-HIGH
|awareness:{awareness-protocol.md}

## 6. Undo/Redo — MEDIUM
|undo:{undo-manager.md}

## 7. Pitfalls & Debugging — MEDIUM
|pitfalls:{pitfall-duplicate-imports.md,pitfall-subdocuments.md,pitfall-v2-encoding.md}
|debug:{debug-common-issues.md}