# brendbook — Aproject 3.0 central design source

**Domain**: `brendbook.aproject.com` (DNS на global server `72.56.99.104`)
**Status**: bootstrapped 2026-06-10, design bundle v0.1.0 imported
**Scope**: единственный источник дизайна для **chat**, **pilot**, **team**, **web** (landing) сервисов

## Что здесь живёт

```
brendbook/
├── CLAUDE.md                                ← вы здесь
├── README.md                                ← human entry
├── design/
│   └── chat-aproject-v0.1.0/                ← Claude Design handoff bundle
│       ├── README.md                        ← Claude Design instructions
│       ├── chats/chat1.md                   ← полный transcript итераций
│       └── project/
│           ├── Меню chat.aproject.html      ← главный артефакт меню
│           ├── Aproject Sidebar.html        ← floating sidebar variant
│           ├── sidebar.jsx, design-canvas.jsx
│           ├── data.jsx, icons.jsx
│           ├── js/ (15 .jsx — shell, chat, pilot, team, etc.)
│           ├── styles/ (theme.css + components.css + pilot.css + mobile.css)
│           └── screenshots/
├── docs/                                    ← публичная документация для сервисов-консьюмеров
└── .claude/state/active.md                  ← single-screen overview
```

## Workflow — Claude Design + периодическое обновление

1. Юлия / дизайнер итерирует в **claude.ai/design** (Claude Design)
2. По вехе экспортирует **handoff bundle** через "Open in Claude Code"
3. Bundle коммитится в `brendbook/design/<artifact>-v<X.Y.Z>/`
4. Consumer-сервисы (chat, pilot, team, web/landing) подтягивают через:
   - **A. Реимплементация** в native stack — пиксель-перфект на shadcn/ui + Tailwind по design tokens из `theme.css`
   - **B. Прямое использование** — для landing-страниц web достаточно подключить HTML/CSS as-is

## Design tokens (источник)

Канонический `theme.css` живёт в актуальной версии design-bundle. Текущий — `design/chat-aproject-v0.1.0/project/styles/theme.css`:

- **Palette**: warm paper light (`#faf9f6` background, `#bd4b1e` primary terracotta accent) + парный dark theme
- **Sidebar surface**: `#f4f2ec` (light) / `#1a1916` (dark)
- **Radius**: `0.625rem`
- **Font**: ui-sans-serif system stack + `Newsreader` Georgia serif для wordmark
- **Tokens scope**: `.app-shell` — каждый artboard может темиться независимо

Любое изменение токенов = **новая версия бандла** + bump consumers. Не патчи поверх.

## Consumer-сервисы

| Сервис | Что забирает | Как |
|---|---|---|
| core/chat | Меню (sidebar), Chat view, Chat settings, User settings, Plans | Реимплементация на Next.js 16 + bun + shadcn/ui |
| core/pilot | Pilot view (`pilot.jsx` 737 LOC), pilot.css | Реимплементация на Next.js 15 + bun |
| core/team | Team view (`team.jsx`), Project detail, File manager | Реимплементация на Next.js + paperclip fork |
| core/web (landing) | Landing-страницы | Возможна прямая выгрузка HTML или реимплементация |

См. §12 `dev-regulation.md` в workspace `.claude/docs/` для официального статуса.

## Versioning

Bundles тэгаются `chat-aproject-v<X.Y.Z>`:
- **MAJOR** — несовместимое изменение design tokens или layout structure
- **MINOR** — новые экраны/компоненты
- **PATCH** — fix визуальных дефектов в существующих экранах

Consumer-сервисы фиксируют версию в своём `package.json` или CHANGELOG-привязке.

## Не делать

- ❌ Патчить design-файлы напрямую в brendbook — все изменения через Claude Design (или с явной аннотацией)
- ❌ Реимплементировать дизайн в consumer без сверки с актуальной версией бандла
- ❌ Использовать токены вне `.app-shell` без явного scope