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

client-localstorage-schema — правило для Claude Code

Правило client-localstorage-schema учит версионировать ключи localStorage и сохранять только нужные интерфейсу поля. Оно пригодится при работе с настройками и кэшем пользовательских данных.

MIT ★ 7 191 обновлён 2026-10-24

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/rules/client-localstorage-schema.md
Открыть на GitHub

Что делает client-localstorage-schema

Правило предлагает добавлять версию к ключам localStorage, чтобы изменения формата данных не смешивались со старыми записями. Для перехода между версиями в примере есть миграция: она преобразует старые настройки и удаляет прежний ключ.

В хранилище предлагается класть только поля, нужные интерфейсу, а чтение и запись оборачивать в try-catch. Это уменьшает риск сохранить токены, персональные данные или внутренние флаги. В приватном режиме браузера, при переполнении квоты или отключённом localStorage операции могут выбросить исключение — без обработки приложение может столкнуться с ошибкой.

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

  • разделить записи разных версий схемы
  • перенести настройки со старого ключа на новый
  • сохранить в кэше только нужные интерфейсу поля
  • обработать сбой чтения или записи localStorage

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

  • Проверь код настроек и примени правило client-localstorage-schema к работе с localStorage.
  • Добавь версию ключа и миграцию для старых настроек по правилу client-localstorage-schema.
  • Пересмотри кэш пользователя: оставь только нужные интерфейсу поля и обработай ошибки localStorage.

Как установить client-localstorage-schema

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

.claude/rules/client-localstorage-schema.md

Поле paths во frontmatter ограничивает файлы

По шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать

Вопросы о client-localstorage-schema

Как установить client-localstorage-schema в Claude Code?

Добавьте файл правила по пути .claude/rules/client-localstorage-schema.md.

Что делает client-localstorage-schema?

Правило рекомендует версионировать ключи localStorage, хранить только необходимые поля и обрабатывать ошибки чтения и записи.

Что происходит с настройками при смене версии ключа?

В примере правило переносит данные из userConfig:v1 в ключ новой версии, преобразует настройки и удаляет старый ключ.

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

client-localstorage-schema.md · MIT
---
title: Version and Minimize localStorage Data
impact: MEDIUM
impactDescription: prevents schema conflicts, reduces storage size
tags: client, localStorage, storage, versioning, data-minimization
---

## Version and Minimize localStorage Data

Add version prefix to keys and store only needed fields. Prevents schema conflicts and accidental storage of sensitive data.

**Incorrect:**

```typescript
// No version, stores everything, no error handling
localStorage.setItem('userConfig', JSON.stringify(fullUserObject))
const data = localStorage.getItem('userConfig')
```

**Correct:**

```typescript
const VERSION = 'v2'

function saveConfig(config: { theme: string; language: string }) {
  try {
    localStorage.setItem(`userConfig:${VERSION}`, JSON.stringify(config))
  } catch {
    // Throws in incognito/private browsing, quota exceeded, or disabled
  }
}

function loadConfig() {
  try {
    const data = localStorage.getItem(`userConfig:${VERSION}`)
    return data ? JSON.parse(data) : null
  } catch {
    return null
  }
}

// Migration from v1 to v2
function migrate() {
  try {
    const v1 = localStorage.getItem('userConfig:v1')
    if (v1) {
      const old = JSON.parse(v1)
      saveConfig({ theme: old.darkMode ? 'dark' : 'light', language: old.lang })
      localStorage.removeItem('userConfig:v1')
    }
  } catch {}
}
```

**Store minimal fields from server responses:**

```typescript
// User object has 20+ fields, only store what UI needs
function cachePrefs(user: FullUser) {
  try {
    localStorage.setItem('prefs:v1', JSON.stringify({
      theme: user.preferences.theme,
      notifications: user.preferences.notifications
    }))
  } catch {}
}
```

**Always wrap in try-catch:** `getItem()` and `setItem()` throw in incognito/private browsing (Safari, Firefox), when quota exceeded, or when disabled.

**Benefits:** Schema evolution via versioning, reduced storage size, prevents storing tokens/PII/internal flags.

© tech-leads-club · MIT · tech-leads-club/agent-skills

Похожие правила IDE

Все правила IDE по теме «Фронтенд и UI» →
zustand-5 prowler-cloud Скилл с паттернами управления состоянием в Zustand 5: базовые хранилища, селекторы, persist-middleware и разделение логики на слайсы. Помогает писать чистый реактивный код без лишних ре-рендеров. CX Codex +1 912установок competition-browser-persistence zhaoxuya520 Скилл competition-browser-persistence для Claude Code разбирает сохранённое состояние браузера в CTF-песочнице. Помогает расследовать сессии, кэши и поведение страниц после перезагрузки. CX Codex +1 109установок tweaks nexu-io Скилл tweaks добавляет к готовой HTML-странице боковую панель с живыми настройками: акцент, шрифт, плотность, тема, анимации. Варианты подбираешь сам, без новых промптов. CX Codex +1 243установок Next.js arre-ankit Промпт задаёт архитектурные правила для Next.js: ограничивает набор хуков, запрещает делать page.tsx клиентским и фиксирует выбор shadcn/ui. GP ChatGPT ★ 178 201звёзд репо build-game-changelog MengTo Скилл build-game-changelog для проектирования и ведения внутриигрового чейнджлога: версии, провенанс деплоя, навигация по меню. CX Codex +1 1 600установок apollo-client apollographql Скилл apollo-client для Claude Code помогает собирать React-приложения с Apollo Client 4.x. Он включается при настройке клиента, работе с GraphQL-запросами и мутациями или разборе ошибок. CX Codex +1 5 900установок

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

Весь набор →
js-length-check-first Правило js-length-check-first для Claude Code, которое подсказывает проверять длину массивов перед дорогими операциями вроде сортировки или глубокого сравнения. Если длины не совпадают, массивы точно не равны — операция не нужна. CX Codex +1 ★ 7 191звёзд репо js-tosorted-immutable Правило js-tosorted-immutable заменяет мутирующий .sort() на .toSorted(), чтобы сортировка не меняла массивы в props и state React. CX Codex +1 ★ 7 191звёзд репо patterns-children-over-render-props Правило patterns-children-over-render-props для Claude Code описывает композицию React-компонентов через children вместо renderX-пропсов, в том числе для формы с разросшимися колбэками. CX Codex +1 ★ 7 191звёзд репо js-cache-function-results Правило js-cache-function-results предписывает агенту кешировать результаты повторных вызовов чистых функций через Map на уровне модуля. Это снижает лишние вычисления при рендере в React и обычном JavaScript. CX Codex +1 ★ 7 191звёзд репо client-event-listeners Правило client-event-listeners для Claude сводит глобальные подписки к одному слушателю: сколько бы компонентов ни вызывало хук, window получает один обработчик keydown. CX Codex +1 ★ 7 191звёзд репо server-after-nonblocking Правило server-after-nonblocking учит агента переносить логирование, аналитику и фоновые задачи в функцию after() из Next.js. Это убирает задержку при отправке ответа клиенту. CX Codex +1 ★ 7 191звёзд репо rerender-lazy-state-init Правило rerender-lazy-state-init напоминает передавать в useState функцию, если начальное значение требует дорогих вычислений. Это пригодится в React-компонентах с данными из хранилища или сложными структурами. CX Codex +1 ★ 7 191звёзд репо async-defer-await Правило async-defer-await учит откладывать операции await только на те ветки кода, где они действительно нужны. Это избегает блокировки путей выполнения, которые могут вернуться раньше. CX Codex +1 ★ 7 191звёзд репо

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

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