Skip to content
  • head's avatar
    55e89458
    docs: comprehensive handover package for future sessions · 55e89458
    head authored
    Четыре документа — чтобы новая Claude-сессия или я через N недель
    могли сразу въехать без «что это» / «как запустить» / «почему так».
    
    - CLAUDE.md (переписан) — первичный briefing. Что, стек, cold start,
      скрипты, текущее состояние, карта файлов, критичные gotchas
      (NextAuth email+db strategy, Tailwind 4 spacing collision, Nodemailer
      id, концурренси-паттерн, realtime graceful degrade, dev .magic-link.txt),
      skill routing, конвенции стиля. Это файл который автоматически
      читается как project instructions в каждой сессии.
    
    - ARCHITECTURE.md (новый) — глубокий структурный референс. Директорное
      дерево с комментариями, data model, auth flow, catalog filter
      architecture с faceted counts, realtime model, admin model,
      testing setup. Плюс явный список что НЕ имплементировано.
    
    - CHANGELOG.md (новый) — хронология milestone-by-milestone с привязкой
      к коммитам. Все баги-саги (authSafe, JWE cookies, JWT→DB migration,
      Tailwind 4, Playfair swap, wizard submit) задокументированы.
    
    - README.md (переписан) — полированная входная точка. Что, стек,
      quick-start, ссылки на остальные доки, what-done/what-left, команды.
    
    - PLAN.md (добавлен retrospective footer) — что реально шипнули vs
      оригинальный scope. M9/M10/wizard-v2/hero-chart/white-palette/seed
      expansion/filter rework — не были в плане, добавились по ходу.
      Зафиксированы evolutions (auth migration, font swap и т.д.).
    55e89458
    docs: comprehensive handover package for future sessions
    head authored
    Четыре документа — чтобы новая Claude-сессия или я через N недель
    могли сразу въехать без «что это» / «как запустить» / «почему так».
    
    - CLAUDE.md (переписан) — первичный briefing. Что, стек, cold start,
      скрипты, текущее состояние, карта файлов, критичные gotchas
      (NextAuth email+db strategy, Tailwind 4 spacing collision, Nodemailer
      id, концурренси-паттерн, realtime graceful degrade, dev .magic-link.txt),
      skill routing, конвенции стиля. Это файл который автоматически
      читается как project instructions в каждой сессии.
    
    - ARCHITECTURE.md (новый) — глубокий структурный референс. Директорное
      дерево с комментариями, data model, auth flow, catalog filter
      architecture с faceted counts, realtime model, admin model,
      testing setup. Плюс явный список что НЕ имплементировано.
    
    - CHANGELOG.md (новый) — хронология milestone-by-milestone с привязкой
      к коммитам. Все баги-саги (authSafe, JWE cookies, JWT→DB migration,
      Tailwind 4, Playfair swap, wizard submit) задокументированы.
    
    - README.md (переписан) — полированная входная точка. Что, стек,
      quick-start, ссылки на остальные доки, what-done/what-left, команды.
    
    - PLAN.md (добавлен retrospective footer) — что реально шипнули vs
      оригинальный scope. M9/M10/wizard-v2/hero-chart/white-palette/seed
      expansion/filter rework — не были в плане, добавились по ходу.
      Зафиксированы evolutions (auth migration, font swap и т.д.).
Loading