DESIGN.md

Этот файл — точка входа в дизайн. Держите его кратким и используйте, чтобы маршрутизировать в более детальные файлы в docs/design-docs/.

Назначение

Фиксировать долговечные продуктовые и системные дизайн-решения, которые должны пережить отдельный чат, спринт или память ревьюера.

Когда читать

• вам нужна текущая дизайн-философия
• вы собираетесь ввести новый паттерн
• вам нужно понять, какие дизайн-решения утверждены, а какие ещё открыты

Канонические дизайн-документы

• docs/design-docs/index.md: индекс принятых, предложенных и устаревших документов
• docs/design-docs/core-beliefs.md: общепроектные agent-first убеждения

Правила дизайна

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