sfera/CLAUDE.md

СИСТЕМНЫЕ ПРАВИЛА ДЛЯ CLAUDE CODE

🚨 ОБЯЗАТЕЛЬНЫЕ ФАЙЛЫ ДЛЯ ПРОВЕРКИ

ПЕРЕД ЛЮБЫМ ИЗМЕНЕНИЕМ КОДА ВСЕГДА ЧИТАТЬ:

1. development-checklist.md - Критические проверки и запреты
2. rules-unified.md - Полная база знаний системы (v4.0)
3. fulfillment-cabinet-rules.md - Правила кабинета фулфилмента
4. visual-design-rules.md - Правила визуального дизайна

Архивированы: rules.md, rules1.md, rules2.md → archive/

🔄 WORKFLOW РАЗРАБОТКИ

Шаг 1: Анализ задачи

• Прочитать development-checklist.md
• Проверить применимые правила из всех файлов правил
• Убедиться что задача не нарушает критические запреты

Шаг 2: Планирование

• Использовать TodoWrite для планирования задач
• Проверить соответствие архитектуре системы
• Учесть все обязательные проверки

Шаг 3: Реализация

• Следовать техническим правилам (GraphQL, TypeScript)
• Соблюдать систему партнерства и типизацию
• Добавлять необходимое логирование

Шаг 4: Проверка

• Проверить все пункты checklist'а
• Протестировать функциональность
• Убедиться в отсутствии нарушений запретов

🎯 КЛЮЧЕВЫЕ ПРИНЦИПЫ

1. НЕ ПРЕДПОЛАГАТЬ - всегда уточнять при сомнениях
2. ПРОВЕРЯТЬ СХЕМЫ - GraphQL и Prisma должны соответствовать коду
3. СЛЕДОВАТЬ WORKFLOW - не нарушать последовательность статусов
4. ДОКУМЕНТИРОВАТЬ - обновлять правила при решении проблем

📋 КРИТИЧЕСКИЕ ФАЙЛЫ

Файлы с правилами (ВСЕГДА ПРОВЕРЯТЬ):

• development-checklist.md - ОБЯЗАТЕЛЬНЫЕ проверки
• rules-unified.md - Полная база знаний системы (v4.0)
• fulfillment-cabinet-rules.md - Правила кабинета фулфилмента
• visual-design-rules.md - Правила визуального дизайна

Технические файлы:

• prisma/schema.prisma - Схема базы данных
• src/graphql/typedefs.ts - GraphQL схема
• src/graphql/resolvers.ts - GraphQL резолверы

🚨 НАПОМИНАНИЕ

ЭТОТ ФАЙЛ СЛУЖИТ ПОСТОЯННЫМ НАПОМИНАНИЕМ О НЕОБХОДИМОСТИ ПРОВЕРКИ ВСЕХ ФАЙЛОВ С ПРАВИЛАМИ ПЕРЕД КАЖДЫМ ИЗМЕНЕНИЕМ КОДА!