К основному содержанию
скилл CX Codex

local-first — скилл для Claude Code: что делает и как установить

Скилл local-first помогает решить, нужна ли веб-приложению локальная база с синхронизацией, и выбрать движок и стратегию разрешения конфликтов.

MIT 173 установок ★ 29 обновлён 2026-08-17

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add oakoss/agent-skills --skill local-first -a claude-code
Открыть на GitHub

Что делает local-first

Скилл даёт агенту рамку для выбора архитектуры веб-приложения. Внутри таблица решений: серверная схема, local-first или гибрид, путь чтения и записи, движок синхронизации, хранилище на клиенте, разрешение конфликтов. Отдельная таблица собирает типичные ошибки — например, local-first ради простого CRUD или выбор движка до того, как описана модель данных.

Дальше идут справочники: паттерны архитектуры, сравнение движков (ElectricSQL, Zero, PowerSync, Replicache, LiveStore, Triplit), варианты клиентского хранилища (IndexedDB, OPFS, SQLite WASM, PGlite), стратегии конфликтов, офлайн-паттерны, миграции схемы, шифрование и гайд по переходу с серверной схемы. Настройку ElectricSQL, WebTransport и деталей CRDT он передаёт скиллам electricsql, realtime-sync, tanstack-db и tanstack-start, если те установлены.

Слэш-команды нет: в файле стоит user-invocable: false, поэтому модель подхватывает скилл сама, когда разговор заходит о хранилище или синхронизации. CRDT на каждое поле — лишняя машинерия, для большинства полей хватает LWW или победы сервера. Если сеть стабильна и запросы простые, серверная схема обойдётся дешевле.

Какие задачи решает

  • решить, тянуть ли приложение в local-first или остаться на серверной схеме
  • выбрать движок синхронизации под Postgres
  • сравнить IndexedDB, OPFS и PGlite по ёмкости и сложности запросов
  • продумать разрешение конфликтов до того, как они всплывут в проде
  • расписать миграции локальной схемы без потери данных

Примеры запросов агенту

  • Мы делаем канбан с офлайн-режимом: стоит ли уходить в local-first и какой движок синхронизации взять под Postgres?
  • Сравни IndexedDB и PGlite для хранения заявок на клиенте, если нужны сложные запросы.
  • Какая стратегия конфликтов подойдёт для полей карточки товара: LWW или CRDT?

Как установить local-first

1Через Skills CLI (Vercel)

npx skills add oakoss/agent-skills --skill local-first -a claude-code

2Вручную: положить файлы

~/.claude/skills/local-first/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/local-first/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о local-first

Как установить local-first в Claude Code?

Выполните npx skills add oakoss/agent-skills --skill local-first -a claude-code. Файл скилла окажется в ~/.claude/skills/local-first/SKILL.md.

Что делает local-first?

Даёт агенту рамку выбора архитектуры: local-first против серверной схемы и гибрида, движок синхронизации, клиентское хранилище, разрешение конфликтов.

Он сам настроит синхронизацию?

Нет. Настройка уходит скиллам electricsql, realtime-sync, tanstack-db и tanstack-start, если они стоят. Этот скилл сравнивает варианты и показывает, где что ломается.

Исходный текст

SKILL.md · MIT
---
name: local-first
description: |
  Local-first architecture decision framework for web applications. Covers when to go local-first vs server-based vs hybrid, sync engine selection (ElectricSQL, Zero, PowerSync, Replicache, LiveStore, Triplit), client-side storage options (IndexedDB, OPFS, SQLite WASM, PGlite), and conflict resolution strategies (LWW, CRDTs, server-wins, field-level merge).

  Use when deciding whether to adopt local-first architecture, choosing a sync engine, selecting client storage, or designing conflict resolution strategies.
license: MIT
metadata:
  author: oakoss
  version: '1.0'
user-invocable: false
---

# Local-First

## Overview

Local-first is an architecture where the application reads and writes to a local database, with changes syncing to the server in the background. The local database is the source of truth for the UI, providing instant reads, offline support, and optimistic writes by default.

**When to use:** Collaborative apps needing offline support, latency-sensitive UIs where instant response matters, apps with unreliable network conditions, real-time multiplayer features, mobile apps with intermittent connectivity.

**When NOT to use:** Simple CRUD apps with reliable connectivity, server-authoritative workflows (payments, inventory), content-heavy sites with minimal interactivity, apps where data freshness from the server is critical on every render.

## Quick Reference

| Decision                | Options                                                 | Key Consideration                                      |
| ----------------------- | ------------------------------------------------------- | ------------------------------------------------------ |
| Architecture model      | Server-based, local-first, hybrid                       | Offline needs and latency tolerance drive the choice   |
| Read path               | Server fetch, local DB read, cache-then-network         | Local reads are instant; server reads block on network |
| Write path              | Server mutation, optimistic update, local-first write   | Local writes never fail; sync handles delivery         |
| Sync engine             | Electric, Zero, PowerSync, Replicache, LiveStore        | Postgres integration vs framework-agnostic             |
| Client storage          | IndexedDB, OPFS, SQLite WASM, PGlite                    | Capacity limits, query capability, browser support     |
| Conflict resolution     | LWW, CRDTs, server-wins, field-level merge              | Complexity vs correctness tradeoff                     |
| Data model              | Normalized tables, document store, CRDT documents       | Query patterns determine the best model                |
| Partial replication     | Shapes, subscriptions, query-based sync                 | Sync only what the client needs                        |
| Progressive enhancement | Server-first with local cache, full local-first         | Start simple, add local-first incrementally            |
| CQRS separation         | Separate read/write models, unified model               | Local-first naturally separates reads from writes      |
| Initial sync            | Full snapshot, incremental, progressive loading         | First-load performance vs completeness                 |
| Auth integration        | Token-based shape filtering, row-level security         | Security lives at the sync layer, not the client       |
| Schema evolution        | Additive migrations, versioned shapes                   | Local DB schema must evolve without data loss          |
| State management        | Replace React Query, coexist, hybrid approach           | Local-first can replace or complement server state     |
| Testing strategy        | Mock sync engine, test offline scenarios, seed local DB | Test both online and offline code paths                |

## Common Mistakes

| Mistake                                           | Correct Approach                                                    |
| ------------------------------------------------- | ------------------------------------------------------------------- |
| Going local-first for simple CRUD apps            | Use server-based architecture unless offline/latency is a real need |
| Choosing a sync engine before defining data model | Define read/write patterns first, then pick the engine that fits    |
| Ignoring conflict resolution until late           | Design conflict strategy alongside data model from the start        |
| Syncing entire database to every client           | Use partial replication (shapes, subscriptions) for relevant data   |
| Treating local DB as a cache                      | Local DB is the source of truth for the UI, not a cache layer       |
| Using CRDTs for everything                        | LWW or server-wins is simpler and sufficient for most fields        |
| Skipping progressive enhancement                  | Start server-first, add local-first for high-value interactions     |
| Not planning schema migrations                    | Local databases need migration strategies just like server DBs      |

## Delegation

> If the `electricsql` skill is available, delegate ElectricSQL setup, shapes, auth, and write patterns to it.
> Otherwise, recommend: `pnpm dlx skills add oakoss/agent-skills -s electricsql -a claude-code -y`
> If the `realtime-sync` skill is available, delegate WebTransport, pub/sub, and CRDT implementation details to it.
> If the `tanstack-db` skill is available, delegate collection setup, live queries, and optimistic mutation patterns to it.
> Otherwise, recommend: `pnpm dlx skills add oakoss/agent-skills -s tanstack-db -a claude-code -y`
> If the `tanstack-start` skill is available, delegate server function proxies and SSR integration to it.
> Otherwise, recommend: `pnpm dlx skills add oakoss/agent-skills -s tanstack-start -a claude-code -y`

- **Architecture review**: Use `Plan` agent to evaluate local-first vs server-based tradeoffs
- **Sync engine comparison**: Use `Explore` agent to research current engine capabilities
- **Storage benchmarking**: Use `Task` agent to test storage options for specific data patterns

## References

- [Architecture patterns and decision framework](references/architecture-patterns.md)
- [Sync engine comparison and selection guide](references/sync-engines.md)
- [Client-side storage options and limits](references/client-storage.md)
- [Conflict resolution strategies](references/conflict-resolution.md)
- [Offline resilience patterns](references/offline-patterns.md)
- [Schema versioning and migration](references/schema-evolution.md)
- [Multi-tenant data governance patterns](references/multi-tenant.md)
- [Testing strategies for local-first apps](references/testing.md)
- [End-to-end encryption for synced data](references/encryption.md)
- [DevTools and debugging utilities](references/devtools-debugging.md)
- [Server-first to local-first migration guide](references/migration-guide.md)

© oakoss · MIT · oakoss/agent-skills

Похожие скиллы

Все скиллы по теме «Фронтенд и UI» →
linear-local-first-architecture boraoztunc Скилл linear-local-first-architecture задаёт агенту архитектуру веб-приложения, которое реагирует мгновенно: данные живут в IndexedDB, правки применяются локально, синхронизация идёт фоном. CX Codex +1 201установок remem-mcp — Local-first MCP Memory + CodeGraph + Wiki tinhien11 remem-mcp — Local-first MCP Memory + CodeGraph + Wiki — MCP-сервер для Claude Code хранит память агента, строит граф кода и ведёт Wiki в SQLite, сохраняя контекст между сессиями. CX Codex +1 ★ 9звёзд репо progressive-web-app aj-geddes Скилл progressive-web-app для Claude Code, который подсказывает, как собрать прогрессивное веб-приложение с service worker, манифестом и офлайн-режимом. Включается, когда обычной странице нужны установка на телефон и работа без сети. CX Codex +1 531установок mnema Zimac-AI Локальная верифицированная база памяти для ИИ-ассистентов. Хранит историю в ~/.mnema и даёт агентам общий контекст без привязки к облаку. CX Codex +1 Graphiti Local renezander030 Graphiti Local — MCP-сервер для Claude Code, который хранит решения проекта в графе и передаёт их агенту через шесть инструментов только для чтения. Правки одобряет человек. CX Codex +1 ★ 5звёзд репо capacitor-offline-first Cap-go Скилл capacitor-offline-first проектирует оффлайн-режим для приложений на Capacitor с локальной базой SQLite. Помогает настроить очередь отправки, разрешение конфликтов и защиту от потери данных на iOS. CX Codex +1 1 100установок

Из того же набора106

Весь набор →
technical-docs Скилл technical-docs для Claude Code помогает писать и обновлять техническую документацию, строить диаграммы Mermaid и сверять документацию с кодом. Помогает вести doc-as-code и проверять покрытие. CX Codex +1 177установок mermaid-diagrams Скилл mermaid-diagrams помогает создавать Mermaid-диаграммы в Markdown: от блок-схем и ERD до графиков, mindmap и архитектурных схем. CX Codex +1 177установок motion Скилл обучает ИИ-агента правильно применять библиотеку Motion (framer-motion) в React и Next.js. Помогает настроить жесты, скролл-эффекты и избежать просадок FPS. CX Codex +1 176установок shadcn-ui Учит агента работать с shadcn/ui: добавлять компоненты через CLI, настраивать темы на oklch и собирать формы с проверкой через Zod. CX Codex +1 176установок tanstack-query Помогает агенту писать запросы и мутации на TanStack Query v5, переводить код с v4 и настраивать инвалидацию кэша. CX Codex +1 170установок threejs Помогает создавать 3D-сцены на Three.js, подключать WebGPU и React Three Fiber. Помогает настраивать шейдеры, загружать модели и повышать производительность. CX Codex +1 167установок accessibility Скилл accessibility помогает создавать и проверять интерфейсы по WCAG 2.2 AA: от семантической HTML-разметки до клавиатурной навигации и поддержки скринридеров. CX Codex +1 164установок react-performance Скилл react-performance для Claude Code собирает паттерны оптимизации React и включается автоматически в задачах о скорости приложения. CX Codex +1 163установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой