client-localstorage-schema — правило для Claude Code
Правило client-localstorage-schema учит версионировать ключи localStorage и сохранять только нужные интерфейсу поля. Оно пригодится при работе с настройками и кэшем пользовательских данных.
MIT ★ 7 191 обновлён 2026-10-24
.claude/rules/client-localstorage-schema.mdЧто делает 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
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/client-localstorage-schema.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/client-localstorage-schema.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/client-localstorage-schema.mdВручную: положить файлы
.clinerules/client-localstorage-schema.mdПо шагам, с командами для каждой платформы: 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