fix: исправить архив skill SLM Design

- добавлен видимый путь slm-design/SKILL.md в zip-архив skill

- обновлена ссылка на SKILL.md в карточке документации

.dockerignore

@@ -8,6 +8,8 @@ docs/*/.vitepress/dist
 docs/*/content
 public/slm-design
 public/figma-adaptive-standards
+public/template-sync-strategy
+public/agents
 *.log
 .DS_Store
 .env*

.gitea/workflows/ci.yml

@@ -20,19 +20,7 @@ jobs:
       - name: Установка зависимостей
         run: npm ci
 
-      - name: Сборка документации SLM Design
-        run: npm run docs:build:slm-design
-
-      - name: Сборка документации NextJS Style Guide
-        run: npm run docs:build:nextjs-style-guide
-
-      - name: Сборка документации Figma Adaptive Standards
-        run: npm run docs:build:figma-adaptive-standards
-
-      - name: Генерация корневых артефактов
-        run: npm run site:generate
-
-      - name: Сборка лендинга
+      - name: Сборка артефактов проекта
         run: npm run build
 
   docker:

.gitignore

@@ -13,12 +13,13 @@ dist-ssr
 *.local
 
 # Generated docs
-docs/*/content/
-docs/*/.vitepress/cache/
+projects/*/docs/content/
+projects/*/docs/.vitepress/cache/
 public/llms.txt
 public/slm-design/
 public/nextjs-style-guide/
 public/figma-adaptive-standards/
+public/template-sync-strategy/
 
 # Editor directories and files
 .vscode/*

Caddyfile

@@ -21,8 +21,11 @@
 	@figmaAdaptiveStandards path /figma-adaptive-standards /figma-adaptive-standards/*
 	header @figmaAdaptiveStandards Link "</figma-adaptive-standards/llms.txt>; rel=\"llms\""
 
+	@templateSyncStrategy path /template-sync-strategy /template-sync-strategy/*
+	header @templateSyncStrategy Link "</template-sync-strategy/llms.txt>; rel=\"llms\""
+
 	@root {
-		not path /slm-design /slm-design/* /nextjs-style-guide /nextjs-style-guide/* /react-style-guide /react-style-guide/* /figma-adaptive-standards /figma-adaptive-standards/*
+		not path /slm-design /slm-design/* /nextjs-style-guide /nextjs-style-guide/* /react-style-guide /react-style-guide/* /figma-adaptive-standards /figma-adaptive-standards/* /template-sync-strategy /template-sync-strategy/*
 	}
 	header @root Link "</llms.txt>; rel=\"llms\""
 

Dockerfile

@@ -6,7 +6,7 @@ COPY package*.json ./
 RUN npm ci
 
 COPY . .
-RUN npm run docs:build:slm-design && npm run docs:build:nextjs-style-guide && npm run docs:build:figma-adaptive-standards && npm run build
+RUN npm run build
 
 FROM caddy:2-alpine
 

README.md

@@ -10,8 +10,10 @@
 - VitePress-сборка для `SLM Design`.
 - VitePress-сборка для `NextJS Style Guide`.
 - VitePress-сборка для `Figma Adaptive Standards`.
+- VitePress-сборка для `Template Sync Strategy`.
 - Корневой `llms.txt` как карта всех документаций.
 - Собственные `llms.txt` и `llms-full.txt` внутри каждой документации.
+- ZIP-архивы Markdown-контента для каждой документации.
 - Docker/Caddy-конфигурация для публикации статической сборки.
 - Gitea CI/CD для ветки `master`.
 
@@ -21,18 +23,21 @@
 - `NextJS Style Guide` — практический стайлгайд для разработки frontend-приложений на Next.js и TypeScript.
 - `React Style Guide` — будущие правила написания React-кода.
 - `Figma Adaptive Standards` — стандарты подготовки адаптивных макетов в Figma.
+- `Template Sync Strategy` — стратегия создания проектов от шаблона и долгосрочного обновления приложений через Git.
 
 ## Структура
 
 ```text
-canons/                 исходные материалы и черновики
-docs/slm-design/        VitePress-сайт SLM Design
-docs/nextjs-style-guide/ VitePress-сайт NextJS Style Guide
-docs/figma-adaptive-standards/ VitePress-сайт Figma Adaptive Standards
-scripts/docs/           подготовка контента для документаций
-scripts/site/           генерация корневых артефактов сайта
-src/                    React-лендинг
-public/                 статические файлы и сгенерированные документации
+build.ts                       сборка всего репозитория
+projects/<slug>/build.ts       сборка конкретного проекта
+projects/<slug>/canons/        исходные Markdown-материалы проекта
+projects/<slug>/docs/          VitePress-конфигурация проекта
+projects/<slug>/scripts/       уникальные вспомогательные скрипты проекта
+projects/_shared/lib/          общие библиотечные функции сборки
+projects/_shared/docs/         общая VitePress-тема
+src/                           React-лендинг
+public/                        статические файлы и сгенерированные документации
+dist/                          итоговая статическая сборка
 ```
 
 ## Команды
@@ -43,23 +48,39 @@ npm run dev
 ```
 
 ```bash
-npm run docs:build:slm-design
-npm run docs:build:nextjs-style-guide
-npm run docs:build:figma-adaptive-standards
-npm run site:generate
 npm run build
 ```
 
 Основные скрипты:
 
 - `npm run dev` — запускает Vite dev server.
-- `npm run docs:build:slm-design` — подготавливает и собирает VitePress-документацию SLM Design.
-- `npm run docs:build:nextjs-style-guide` — подготавливает и собирает VitePress-документацию NextJS Style Guide.
-- `npm run docs:build:figma-adaptive-standards` — подготавливает и собирает VitePress-документацию Figma Adaptive Standards.
-- `npm run site:generate` — генерирует корневой `public/llms.txt` из `src/config/docs.config.ts` и хардкод-секций.
-- `npm run build` — генерирует корневые артефакты и собирает лендинг.
+- `npm run build` — одной командой собирает проектные документации, ZIP-архивы, корневой `llms.txt`, агентов и лендинг.
+- `npm run build:slm-design` — собирает только проект `SLM Design`.
+- `npm run build:nextjs-style-guide` — собирает только проект `NextJS Style Guide`.
+- `npm run build:figma-adaptive-standards` — собирает только проект `Figma Adaptive Standards`.
+- `npm run build:template-sync-strategy` — собирает только проект `Template Sync Strategy`.
+- `npm run app:build` — собирает React/Vite-лендинг без проектных артефактов.
 - `npm run lint` — запускает ESLint.
 
+## Проекты
+
+Каждая документация живёт в собственной папке `projects/<slug>` и сама владеет исходниками, конфигами и сборкой.
+
+```text
+projects/slm-design/
+  build.ts
+  project.config.ts
+  canons/
+  docs/
+    docs.config.ts
+    .vitepress/
+  scripts/
+```
+
+Общая команда `npm run build` запускает корневой `build.ts`. Он последовательно вызывает `projects/<slug>/build.ts`, затем собирает общие артефакты репозитория.
+
+Если скрипт является библиотечной функцией сборки, он лежит в `projects/_shared/lib`. Если скрипт уникален для проекта, он лежит в `projects/<slug>/scripts`.
+
 ## LLM-артефакты
 
 Корневой файл:
@@ -79,6 +100,12 @@ npm run build
 /nextjs-style-guide/llms-full.txt
 /figma-adaptive-standards/llms.txt
 /figma-adaptive-standards/llms-full.txt
+/template-sync-strategy/llms.txt
+/template-sync-strategy/llms-full.txt
+/slm-design/slm-design.zip
+/nextjs-style-guide/nextjs-style-guide.zip
+/figma-adaptive-standards/figma-adaptive-standards.zip
+/template-sync-strategy/template-sync-strategy.zip
 ```
 
 Корневой `llms-full.txt` намеренно не создаётся. Полные bundles остаются внутри конкретных документаций.
@@ -91,6 +118,7 @@ npm run build
 - `/nextjs-style-guide/*` → `/nextjs-style-guide/llms.txt`
 - `/react-style-guide/*` → `/react-style-guide/llms.txt`
 - `/figma-adaptive-standards/*` → `/figma-adaptive-standards/llms.txt`
+- `/template-sync-strategy/*` → `/template-sync-strategy/llms.txt`
 - остальные пути → `/llms.txt`
 
 Редиректов `llms.txt` в корень нет.
@@ -106,9 +134,6 @@ docker build -t all-docs:test .
 Docker-сборка выполняет:
 
 ```bash
-npm run docs:build:slm-design
-npm run docs:build:nextjs-style-guide
-npm run docs:build:figma-adaptive-standards
 npm run build
 ```
 

build.ts

@@ -0,0 +1,9 @@
+import { generateRootLlms } from './projects/_shared/lib/root-llms';
+import { run } from './projects/_shared/lib/run';
+
+run('npm', ['run', 'build:slm-design']);
+run('npm', ['run', 'build:nextjs-style-guide']);
+run('npm', ['run', 'build:figma-adaptive-standards']);
+run('npm', ['run', 'build:template-sync-strategy']);
+generateRootLlms();
+run('npm', ['run', 'app:build']);

canons/slm-design/examples/react/composition-provider.md

@@ -1,249 +0,0 @@
----
-title: Композиция через Provider
-description: Пример композиции бизнес-фабрик screen-модуля через React Provider
----
-
-# Композиция через Provider
-
-Раздел показывает, как screen-модуль может получить готовую композицию бизнес-доменов через React Context, не вызывая фабрики внутри себя.
-
-## Идея
-
-Screen получает готовый API бизнес-доменов через React Context. Граф фабрик собирается снаружи, например в роутере, а внутренние `parts/` достают нужные домены через хук без пропс-дриллинга.
-
-## Принципы
-
-1. **Принадлежность.** Provider, Context и хук принадлежат конкретному screen-модулю и лежат в его сегментах.
-2. **Внутренний тип.** Тип композиции не экспортируется наружу — это закрывает доступ из бизнес-модулей.
-3. **Внутренний хук.** Хук доступа не экспортируется — доступен только внутри screen и его `parts/`.
-4. **Публичный Provider.** Только Provider экспортируется через `index.ts`, чтобы роутер мог обернуть screen.
-5. **Сборка снаружи.** Граф фабрик собирается в роутере или другом композиторе, screen фабрики не вызывает.
-6. **Запрет для бизнеса.** Бизнес-модули не используют провайдеры композиции. Cross-domain зависимости передаются только через аргументы фабрики.
-
-## Структура модуля
-
-```text
-screens/main/
-├── main.screen.tsx
-├── providers/
-│   └── main-composition.provider.tsx
-├── hooks/
-│   └── use-main-composition.hook.ts
-├── types/
-│   └── main-composition.type.ts
-├── parts/
-│   └── featured-products/
-│       ├── featured-products.tsx
-│       └── index.ts
-└── index.ts
-```
-
-Сегмент `providers/` — расширение стандартного набора SLM. Спецификация это разрешает: команда сама определяет, какие сегменты используются.
-
-## Распределение по сегментам
-
-| Файл | Сегмент | Назначение |
-|------|---------|------------|
-| `main-composition.type.ts` | `types/` | TypeScript-тип композиции |
-| `main-composition.provider.tsx` | `providers/` | Context и Provider-компонент |
-| `use-main-composition.hook.ts` | `hooks/` | React-хук доступа |
-| `main.screen.tsx` | корень | Корневой компонент screen-модуля |
-| `featured-products/` | `parts/` | Вложенный модуль со своим публичным API |
-
-## Тип композиции
-
-Файл: `screens/main/types/main-composition.type.ts`.
-
-Тип описывает, какие бизнес-домены доступны на этой странице. Он не экспортируется через `index.ts`, чтобы другие модули не зависели от внутренней формы композиции screen.
-
-```ts
-import type { CatalogApi } from '@/business/catalog'
-import type { CartApi } from '@/business/cart'
-
-export type MainComposition = {
-  catalog: CatalogApi
-  cart: CartApi
-}
-```
-
-## Context и Provider
-
-Файл: `screens/main/providers/main-composition.provider.tsx`.
-
-Context — внутренняя деталь Provider, наружу он не экспортируется. Значение `null` по умолчанию нужно, чтобы хук мог проверить отсутствие Provider в дереве.
-
-Provider-компонент экспортируется через `index.ts`. Роутер передаёт в `value` уже собранный граф фабрик со стабильной ссылкой.
-
-```tsx
-import { createContext, type ReactNode } from 'react'
-import type { MainComposition } from '../types/main-composition.type'
-
-export const MainCompositionContext = createContext<MainComposition | null>(null)
-
-type Props = {
-  value: MainComposition
-  children: ReactNode
-}
-
-export const MainCompositionProvider = ({ value, children }: Props) => (
-  <MainCompositionContext.Provider value={value}>
-    {children}
-  </MainCompositionContext.Provider>
-)
-```
-
-## Хук доступа
-
-Файл: `screens/main/hooks/use-main-composition.hook.ts`.
-
-Хук остаётся внутренним и не экспортируется через `index.ts` модуля. Он доступен только внутри screen и его `parts/`.
-
-Если хук используется вне Provider, он бросает ошибку. Это даёт раннюю диагностику неправильной композиции дерева.
-
-```ts
-import { useContext } from 'react'
-import { MainCompositionContext } from '../providers/main-composition.provider'
-
-export const useMainComposition = () => {
-  const ctx = useContext(MainCompositionContext)
-  if (!ctx) {
-    throw new Error('useMainComposition must be used within MainCompositionProvider')
-  }
-  return ctx
-}
-```
-
-## Сборка графа в роутере
-
-Файл: `app/router.tsx`.
-
-Роутер или другой композитор собирает граф фабрик в точке использования screen. Каждый домен получает свои зависимости через аргументы фабрики.
-
-Фабрики вызываются вне React-компонента, если не зависят от runtime-параметров. Так API доменов не пересоздаётся на каждый рендер route-компонента.
-
-```tsx
-import { MainScreen, MainCompositionProvider } from '@/screens/main'
-import { catalogFactory } from '@/business/catalog'
-import { cartFactory } from '@/business/cart'
-import { authFactory } from '@/business/auth'
-
-const auth = authFactory()
-const catalog = catalogFactory()
-const cart = cartFactory({ auth })
-
-const MainRoute = () => (
-  <MainCompositionProvider value={{ catalog, cart }}>
-    <MainScreen />
-  </MainCompositionProvider>
-)
-```
-
-## Корневой компонент screen
-
-Файл: `screens/main/main.screen.tsx`.
-
-Screen получает нужные домены из композиции и достаёт из API готовые хуки, компоненты или функции. В JSX используются уже локальные `useCategories` и `CategoryList`, а не обращение к фабричному API через точку.
-
-```tsx
-import { useMainComposition } from './hooks/use-main-composition.hook'
-import { FeaturedProducts } from './parts/featured-products'
-
-export const MainScreen = () => {
-  const { catalog } = useMainComposition()
-  const { useCategories, CategoryList } = catalog
-  const categories = useCategories()
-
-  return (
-    <div>
-      <CategoryList categories={categories} />
-      <FeaturedProducts />
-    </div>
-  )
-}
-```
-
-## Вложенный part
-
-Файл: `screens/main/parts/featured-products/featured-products.tsx`.
-
-Вложенный модуль получает доступ к той же композиции родительского screen. Промежуточные компоненты не прокидывают домены через props.
-
-Из API доменов достаются готовые сущности: `useFeatured`, `ProductCard` и `addItem`. Компонент работает с ними напрямую.
-
-```tsx
-import { useMainComposition } from '../../hooks/use-main-composition.hook'
-
-export const FeaturedProducts = () => {
-  const { catalog, cart } = useMainComposition()
-  const { useFeatured, ProductCard } = catalog
-  const { addItem } = cart
-  const products = useFeatured()
-
-  return (
-    <div>
-      {products.map((product) => (
-        <ProductCard
-          key={product.id}
-          product={product}
-          onAdd={() => addItem(product.id)}
-        />
-      ))}
-    </div>
-  )
-}
-```
-
-Файл: `screens/main/parts/featured-products/index.ts`.
-
-```ts
-export { FeaturedProducts } from './featured-products'
-```
-
-## Публичный API screen-модуля
-
-Файл: `screens/main/index.ts`.
-
-Наружу экспортируются только screen и его Provider. `MainComposition`, `MainCompositionContext` и `useMainComposition` остаются деталями реализации.
-
-```ts
-export { MainScreen } from './main.screen'
-export { MainCompositionProvider } from './providers/main-composition.provider'
-```
-
-## Почему тип композиции не экспортируется
-
-Внутренний тип закрывает доступ к форме композиции из внешних модулей. Бизнес-модуль не должен знать, какие домены собраны для конкретного screen.
-
-Такой импорт из бизнес-модуля не должен быть возможен через публичный API screen.
-
-```ts
-import type { MainComposition } from '@/screens/main'
-```
-
-Когда тип остаётся внутренним, такая связь невозможна через публичный API screen-модуля.
-
-## Почему хук не экспортируется
-
-Если хук доступа сделать публичным, любой модуль сможет вызвать его напрямую. Внутренний хук доступен только через относительные импорты внутри screen-модуля и его `parts/`.
-
-## Почему Provider экспортируется
-
-Provider безопасно экспортировать: сам по себе он не даёт доступ к данным, а только принимает готовую композицию и передаёт её детям внутри React-дерева.
-
-## Стабильность value
-
-Фабрики создаются на уровне модуля, поэтому `catalog` и `cart` сохраняют ссылки между рендерами `MainRoute`.
-
-Если домены зависят от runtime-параметров, граф нужно собирать в отдельном композиторе для этих параметров и передавать в Provider уже готовую композицию.
-
-## Расширение на другие screen-модули
-
-Паттерн повторяется для каждого screen, которому нужна композиция бизнес-доменов.
-
-```text
-screens/checkout/providers/checkout-composition.provider.tsx
-screens/checkout/hooks/use-checkout-composition.hook.ts
-screens/checkout/types/checkout-composition.type.ts
-```
-
-Имена включают имя screen-модуля. Не используйте универсальные названия вроде `useComposition` или `useScope`: по имени файла должно быть понятно, к какой странице привязан Context.

canons/slm-design/examples/react/factory-composition.md

@@ -1,52 +0,0 @@
----
-title: Композиция фабрик
-description: Пример композиции business-фабрик на уровне screen-модуля в React-проекте
----
-
-# Композиция фабрик
-
-Раздел показывает, как собрать API нескольких business-модулей в React screen-модуле. Пример подходит для простой композиции, когда screen сам является точкой использования доменов.
-
-## Идея
-
-Композиция фабрик выполняется в модуле-потребителе: screen, layout или другом модуле группы «Композиция». Business-модули не импортируют runtime-код друг друга напрямую, а cross-domain зависимости получают только через аргументы фабрик.
-
-## Структура screen-модуля
-
-```text
-screens/home/
-├── home.screen.tsx
-└── index.ts
-```
-
-## Сборка фабрик
-
-Файл: `screens/home/home.screen.tsx`.
-
-```tsx
-import { customerFactory } from '@/business/customer'
-import { orderFactory } from '@/business/order'
-
-const customer = customerFactory()
-const order = orderFactory({ customer })
-
-const { useOrder, OrderCard } = order
-
-export const HomeScreen = () => {
-  const currentOrder = useOrder()
-
-  return <OrderCard order={currentOrder} />
-}
-```
-
-`customerFactory` создаётся первой, потому что `orderFactory` зависит от части API домена `customer`. Модуль `order` не импортирует `customer` в runtime — зависимость передаётся снаружи.
-
-## Публичный API screen-модуля
-
-Файл: `screens/home/index.ts`.
-
-```ts
-export { HomeScreen } from './home.screen'
-```
-
-Screen экспортирует только собственный публичный API. Собранные экземпляры business API остаются деталями реализации screen-модуля.

docs/figma-adaptive-standards/.vitepress/theme/index.ts

@@ -1 +0,0 @@
-export { default } from '../../../shared/vitepress/theme';

docs/nextjs-style-guide/.vitepress/theme/index.ts

@@ -1 +0,0 @@
-export { default } from '../../../shared/vitepress/theme';

docs/slm-design/.vitepress/theme/index.ts

@@ -1 +0,0 @@
-export { default } from '../../../shared/vitepress/theme';

eslint.config.js

@@ -8,8 +8,8 @@ import { defineConfig, globalIgnores } from 'eslint/config'
 export default defineConfig([
   globalIgnores([
     'dist',
-    'docs/*/content',
-    'docs/*/.vitepress/cache',
+    'projects/*/docs/content',
+    'projects/*/docs/.vitepress/cache',
     'public',
   ]),
   {

index.html

@@ -86,6 +86,50 @@
         margin-top: 14px;
       }
 
+      .static-actions-list,
+      .static-action-list {
+        display: grid;
+        gap: 8px;
+        margin: 14px 0 0;
+        padding-left: 20px;
+      }
+
+      .static-action-list {
+        margin-top: 6px;
+      }
+
+      .static-action-list-nested {
+        gap: 10px;
+      }
+
+      .static-action-sections {
+        display: grid;
+        gap: 18px;
+        margin-top: 18px;
+      }
+
+      .static-action-section,
+      .static-action-group {
+        display: grid;
+        gap: 8px;
+      }
+
+      .static-action-title {
+        color: color-mix(in srgb, LinkText 80%, CanvasText);
+        font-size: 12px;
+        font-weight: 800;
+        letter-spacing: 0.08em;
+        text-transform: uppercase;
+      }
+
+      .static-action-group-title {
+        color: color-mix(in srgb, CanvasText 58%, Canvas);
+        font-size: 11px;
+        font-weight: 800;
+        letter-spacing: 0.08em;
+        text-transform: uppercase;
+      }
+
       .static-shell a {
         color: LinkText;
       }
@@ -111,6 +155,7 @@
           </div>
         </header>
 
+        <!-- STATIC_DOCS_START -->
         <section aria-labelledby="static-docs-title">
           <h2 id="static-docs-title">Список документаций</h2>
           <ul class="static-docs">
@@ -118,57 +163,96 @@
               <article>
                 <div class="static-meta">Архитектура · Доступно</div>
                 <h2><a href="/slm-design/">SLM Design</a></h2>
-                <p>
-                  Архитектура frontend-приложений, где слои задают направление зависимостей,
-                  модули становятся границами ответственности, а явный DI через фабрики удерживает домены изолированными и предсказуемыми.
-                </p>
-                <div class="static-links" aria-label="LLM-артефакты SLM Design">
-                  <a href="/slm-design/llms.txt">llms.txt</a>
-                  <a href="/slm-design/llms-full.txt">llms-full.txt</a>
-                </div>
+                <p>Архитектура frontend-приложений, где слои задают направление зависимостей, модули становятся границами ответственности, а явный DI через фабрики удерживает домены изолированными и предсказуемыми.</p>
+              <ul class="static-actions-list">
+                <li>
+                  <span class="static-action-title">Открыть</span>
+                  <ul class="static-action-list static-action-list-nested">
+                    <li>
+                      <span class="static-action-group-title">Читать</span>
+                      <ul class="static-action-list"><li><a href="/slm-design/" target="_blank" rel="noopener noreferrer">SLM Документация</a></li></ul>
+                    </li>
+                    <li>
+                      <span class="static-action-group-title">Skill для CLI-агентов</span>
+                      <ul class="static-action-list"><li><a href="/slm-design/skill/slm-design/SKILL.md" target="_blank" rel="noopener noreferrer">slm-design/SKILL.md</a></li></ul>
+                    </li>
+                    <li>
+                      <span class="static-action-group-title">AI агентам</span>
+                      <ul class="static-action-list"><li><a href="/slm-design/llms.txt" target="_blank" rel="noopener noreferrer">llms.txt</a></li><li><a href="/slm-design/llms-full.txt" target="_blank" rel="noopener noreferrer">llms-full.txt</a></li></ul>
+                    </li>
+                  </ul>
+                </li>
+                <li>
+                  <span class="static-action-title">Скачать</span>
+                  <ul class="static-action-list static-action-list-nested">
+                    <li>
+                      <span class="static-action-group-title">Документация MD</span>
+                      <ul class="static-action-list"><li><a href="/slm-design/slm-design.zip" download>slm-design.zip</a></li></ul>
+                    </li>
+                    <li>
+                      <span class="static-action-group-title">Skills (Claude code / OpenCode)</span>
+                      <ul class="static-action-list"><li><a href="/slm-design/skill/slm-design.skill.zip" download>slm-design.skill.zip</a></li></ul>
+                    </li>
+                  </ul>
+                </li>
+              </ul>
               </article>
             </li>
-
             <li class="static-card">
               <article>
                 <div class="static-meta">Стайлгайд · Доступно</div>
                 <h2><a href="/nextjs-style-guide/">NextJS Style Guide</a></h2>
-                <p>
-                  Практический стайлгайд для разработки frontend-приложений на Next.js и TypeScript.
-                </p>
-                <div class="static-links" aria-label="LLM-артефакты NextJS Style Guide">
-                  <a href="/nextjs-style-guide/llms.txt">llms.txt</a>
-                  <a href="/nextjs-style-guide/llms-full.txt">llms-full.txt</a>
-                </div>
+                <p>Практический стайлгайд для разработки frontend-приложений на Next.js и TypeScript.</p>
+              <ul class="static-actions-list">
+                <li>
+                  <span class="static-action-title">AI</span>
+                  <ul class="static-action-list"><li><a href="/nextjs-style-guide/llms.txt" target="_blank" rel="noopener noreferrer">llms.txt</a></li><li><a href="/nextjs-style-guide/llms-full.txt" target="_blank" rel="noopener noreferrer">llms-full.txt</a></li></ul>
+                </li>
+              </ul>
               </article>
             </li>
-
             <li class="static-card">
               <article>
                 <div class="static-meta">Стайлгайд · Скоро</div>
                 <h2>React Style Guide</h2>
-                <p>
-                  Практический стайлгайд для разработки frontend-приложений на React и TypeScript.
-                </p>
+                <p>Практический стайлгайд для разработки frontend-приложений на React и TypeScript.</p>
+              <ul class="static-actions-list">
+                <li>
+                  <span class="static-action-title">AI</span>
+                  <ul class="static-action-list"><li><a href="/react-style-guide/llms.txt" target="_blank" rel="noopener noreferrer">llms.txt</a></li><li><a href="/react-style-guide/llms-full.txt" target="_blank" rel="noopener noreferrer">llms-full.txt</a></li></ul>
+                </li>
+              </ul>
               </article>
             </li>
-
             <li class="static-card">
               <article>
                 <div class="static-meta">Макеты · Доступно</div>
                 <h2><a href="/figma-adaptive-standards/">Figma Adaptive Standards</a></h2>
-                <p>
-                  Стандарты и требования к подготовке адаптивных макетов в Figma: брейкпоинты,
-                  ресайз в диапазоне, Auto Layout/Constraints, компоненты, сетка, типографика, состояния UI, A11y и передача в разработку.
-                </p>
-                <div class="static-links" aria-label="LLM-артефакты Figma Adaptive Standards">
-                  <a href="/figma-adaptive-standards/llms.txt">llms.txt</a>
-                  <a href="/figma-adaptive-standards/llms-full.txt">llms-full.txt</a>
-                </div>
+                <p>Стандарты и требования к подготовке адаптивных макетов в Figma: брейкпоинты, ресайз в диапазоне, Auto Layout/Constraints, компоненты, сетка, типографика, состояния UI, A11y и передача в разработку.</p>
+              <ul class="static-actions-list">
+                <li>
+                  <span class="static-action-title">AI</span>
+                  <ul class="static-action-list"><li><a href="/figma-adaptive-standards/llms.txt" target="_blank" rel="noopener noreferrer">llms.txt</a></li><li><a href="/figma-adaptive-standards/llms-full.txt" target="_blank" rel="noopener noreferrer">llms-full.txt</a></li></ul>
+                </li>
+              </ul>
+              </article>
+            </li>
+            <li class="static-card">
+              <article>
+                <div class="static-meta">Стратегия · Доступно</div>
+                <h2><a href="/template-sync-strategy/">Template Sync Strategy</a></h2>
+                <p>Стратегия как поддерживать проекты на общей шаблонной базе: отделять изменения шаблона от бизнес-кода и проводить обновления через контролируемый merge-процесс.</p>
+              <ul class="static-actions-list">
+                <li>
+                  <span class="static-action-title">AI</span>
+                  <ul class="static-action-list"><li><a href="/template-sync-strategy/llms.txt" target="_blank" rel="noopener noreferrer">llms.txt</a></li><li><a href="/template-sync-strategy/llms-full.txt" target="_blank" rel="noopener noreferrer">llms-full.txt</a></li></ul>
+                </li>
+              </ul>
               </article>
             </li>
           </ul>
         </section>
+        <!-- STATIC_DOCS_END -->
 
         <footer class="static-footer">
           Автор документации: <a href="https://gromlab.ru/gromov">Сергей Громов</a>

package-lock.json

@@ -8,6 +8,9 @@
       "name": "all-docs",
       "version": "0.0.0",
       "dependencies": {
+        "@mantine/core": "^9.2.1",
+        "@mantine/hooks": "^9.2.1",
+        "@phosphor-icons/react": "^2.1.10",
         "react": "^19.2.6",
         "react-dom": "^19.2.6"
       },
@@ -191,7 +194,6 @@
       "integrity": "sha512-gA8oJOV1LnQQkDf91iebNnFInHuW0gRPEgLSOQ7EfipCEjYTHm5swm1DlH9H5RaRw4RrHuzHBegnlzc0MAstcg==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@algolia/client-common": "5.52.1",
         "@algolia/requester-browser-xhr": "5.52.1",
@@ -314,7 +316,6 @@
       "version": "7.29.0",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@babel/code-frame": "^7.29.0",
         "@babel/generator": "^7.29.0",
@@ -591,17 +592,6 @@
         }
       }
     },
-    "node_modules/@docsearch/js/node_modules/scheduler": {
-      "version": "0.23.2",
-      "resolved": "https://registry.npmjs.org/scheduler/-/scheduler-0.23.2.tgz",
-      "integrity": "sha512-UOShsPwz7NrMUqhR6t0hWjFduvOzbtv7toDH1/hIrfRNIDBnnBWd0CwJTGvTpngVlmwGCdP9/Zl/tVrDqcuYzQ==",
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "dependencies": {
-        "loose-envify": "^1.1.0"
-      }
-    },
     "node_modules/@esbuild/aix-ppc64": {
       "version": "0.21.5",
       "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.21.5.tgz",
@@ -1257,6 +1247,59 @@
         "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
       }
     },
+    "node_modules/@floating-ui/core": {
+      "version": "1.7.5",
+      "resolved": "https://registry.npmjs.org/@floating-ui/core/-/core-1.7.5.tgz",
+      "integrity": "sha512-1Ih4WTWyw0+lKyFMcBHGbb5U5FtuHJuujoyyr5zTaWS5EYMeT6Jb2AuDeftsCsEuchO+mM2ij5+q9crhydzLhQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@floating-ui/utils": "^0.2.11"
+      }
+    },
+    "node_modules/@floating-ui/dom": {
+      "version": "1.7.6",
+      "resolved": "https://registry.npmjs.org/@floating-ui/dom/-/dom-1.7.6.tgz",
+      "integrity": "sha512-9gZSAI5XM36880PPMm//9dfiEngYoC6Am2izES1FF406YFsjvyBMmeJ2g4SAju3xWwtuynNRFL2s9hgxpLI5SQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@floating-ui/core": "^1.7.5",
+        "@floating-ui/utils": "^0.2.11"
+      }
+    },
+    "node_modules/@floating-ui/react": {
+      "version": "0.27.19",
+      "resolved": "https://registry.npmjs.org/@floating-ui/react/-/react-0.27.19.tgz",
+      "integrity": "sha512-31B8h5mm8YxotlE7/AU/PhNAl8eWxAmjL/v2QOxroDNkTFLk3Uu82u63N3b6TXa4EGJeeZLVcd/9AlNlVqzeog==",
+      "license": "MIT",
+      "dependencies": {
+        "@floating-ui/react-dom": "^2.1.8",
+        "@floating-ui/utils": "^0.2.11",
+        "tabbable": "^6.0.0"
+      },
+      "peerDependencies": {
+        "react": ">=17.0.0",
+        "react-dom": ">=17.0.0"
+      }
+    },
+    "node_modules/@floating-ui/react-dom": {
+      "version": "2.1.8",
+      "resolved": "https://registry.npmjs.org/@floating-ui/react-dom/-/react-dom-2.1.8.tgz",
+      "integrity": "sha512-cC52bHwM/n/CxS87FH0yWdngEZrjdtLW/qVruo68qg+prK7ZQ4YGdut2GyDVpoGeAYe/h899rVeOVm6Oi40k2A==",
+      "license": "MIT",
+      "dependencies": {
+        "@floating-ui/dom": "^1.7.6"
+      },
+      "peerDependencies": {
+        "react": ">=16.8.0",
+        "react-dom": ">=16.8.0"
+      }
+    },
+    "node_modules/@floating-ui/utils": {
+      "version": "0.2.11",
+      "resolved": "https://registry.npmjs.org/@floating-ui/utils/-/utils-0.2.11.tgz",
+      "integrity": "sha512-RiB/yIh78pcIxl6lLMG0CgBXAZ2Y0eVHqMPYugu+9U0AeT6YBeiJpf7lbdJNIugFP5SIjwNRgo4DhR1Qxi26Gg==",
+      "license": "MIT"
+    },
     "node_modules/@humanfs/core": {
       "version": "0.19.2",
       "dev": true,
@@ -1370,6 +1413,46 @@
         "@jridgewell/sourcemap-codec": "^1.4.14"
       }
     },
+    "node_modules/@mantine/core": {
+      "version": "9.2.1",
+      "resolved": "https://registry.npmjs.org/@mantine/core/-/core-9.2.1.tgz",
+      "integrity": "sha512-CicPg9i2dM2pGp1jj+dMiR/63OFDsPjgJke4v5+0nbfJ+C7gn4C+7ltrp4RIETDMZHcj0fFuDRG0qtbiyBxvWA==",
+      "license": "MIT",
+      "dependencies": {
+        "@floating-ui/react": "^0.27.19",
+        "clsx": "^2.1.1",
+        "react-number-format": "^5.4.5",
+        "react-remove-scroll": "^2.7.2",
+        "type-fest": "^5.6.0"
+      },
+      "peerDependencies": {
+        "@mantine/hooks": "9.2.1",
+        "react": "^19.2.0",
+        "react-dom": "^19.2.0"
+      }
+    },
+    "node_modules/@mantine/hooks": {
+      "version": "9.2.1",
+      "resolved": "https://registry.npmjs.org/@mantine/hooks/-/hooks-9.2.1.tgz",
+      "integrity": "sha512-IX/ztVG9eWmQTRsN7G8odyW4JckNvN8qv5A2ULzXyazjtAKLuaUpuMz0c6XhRp10J0g4bVfV3rhrTgWeImqxqg==",
+      "license": "MIT",
+      "peerDependencies": {
+        "react": "^19.2.0"
+      }
+    },
+    "node_modules/@phosphor-icons/react": {
+      "version": "2.1.10",
+      "resolved": "https://registry.npmjs.org/@phosphor-icons/react/-/react-2.1.10.tgz",
+      "integrity": "sha512-vt8Tvq8GLjheAZZYa+YG/pW7HDbov8El/MANW8pOAz4eGxrwhnbfrQZq0Cp4q8zBEu8NIhHdnr+r8thnfRSNYA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=10"
+      },
+      "peerDependencies": {
+        "react": ">= 16.8",
+        "react-dom": ">= 16.8"
+      }
+    },
     "node_modules/@rolldown/pluginutils": {
       "version": "1.0.0-beta.27",
       "resolved": "https://registry.npmjs.org/@rolldown/pluginutils/-/pluginutils-1.0.0-beta.27.tgz",
@@ -1939,24 +2022,14 @@
       "version": "24.12.4",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "undici-types": "~7.16.0"
       }
     },
-    "node_modules/@types/prop-types": {
-      "version": "15.7.15",
-      "resolved": "https://registry.npmjs.org/@types/prop-types/-/prop-types-15.7.15.tgz",
-      "integrity": "sha512-F6bEyamV9jKGAFBEmlQnesRPGOQqS2+Uwi0Em15xenOxHaf2hv6L8YCVn3rPdPJOiJfPiCnLIRyvwVaqMY3MIw==",
-      "dev": true,
-      "license": "MIT",
-      "optional": true
-    },
     "node_modules/@types/react": {
       "version": "19.2.14",
-      "dev": true,
+      "devOptional": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "csstype": "^3.2.2"
       }
@@ -2022,7 +2095,6 @@
       "version": "8.59.3",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@typescript-eslint/scope-manager": "8.59.3",
         "@typescript-eslint/types": "8.59.3",
@@ -2502,7 +2574,6 @@
       "integrity": "sha512-UVJyE9MttOsBQIDKw1skb9nAwQuR5wuGD3+82K6JgJlm/Y+KI92oNsMNGZCYdDsVtRHSak0pcV5Dno5+4jh9sw==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "bin": {
         "acorn": "bin/acorn"
       },
@@ -2541,7 +2612,6 @@
       "integrity": "sha512-fHA8+kXTbjagw3jkLiaS7KKrH8qe2DyOsiUhGlN4cdT77PEsfqXZl7ewDk1hsg+pJnPlnE50XtLxjR91iJOpmg==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@algolia/abtesting": "1.18.1",
         "@algolia/client-abtesting": "5.52.1",
@@ -2664,7 +2734,6 @@
         }
       ],
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "baseline-browser-mapping": "^2.10.12",
         "caniuse-lite": "^1.0.30001782",
@@ -2784,6 +2853,15 @@
         "node": ">=12"
       }
     },
+    "node_modules/clsx": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/clsx/-/clsx-2.1.1.tgz",
+      "integrity": "sha512-eYm0QWBtUrBWZWG0d386OGAw16Z995PiOVo2B7bjWSbHedGl5e0ZWaq65kOGgUSNesEIDkB9ISbTg/JK9dhCZA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
     "node_modules/color-convert": {
       "version": "2.0.1",
       "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz",
@@ -2858,7 +2936,7 @@
     },
     "node_modules/csstype": {
       "version": "3.2.3",
-      "dev": true,
+      "devOptional": true,
       "license": "MIT"
     },
     "node_modules/debug": {
@@ -2906,6 +2984,12 @@
         "node": ">=6"
       }
     },
+    "node_modules/detect-node-es": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/detect-node-es/-/detect-node-es-1.1.0.tgz",
+      "integrity": "sha512-ypdmJU/TbBby2Dxibuv7ZLW3Bs1QEmM7nHjEANfohJLvE0XVujisn1qPJcZxg+qDucsr+bP6fLD1rPS3AhJ7EQ==",
+      "license": "MIT"
+    },
     "node_modules/devlop": {
       "version": "1.1.0",
       "resolved": "https://registry.npmjs.org/devlop/-/devlop-1.1.0.tgz",
@@ -3016,7 +3100,6 @@
       "integrity": "sha512-XoMjdBOwe/esVgEvLmNsD3IRHkm7fbKIUGvrleloJXUZgDHig2IPWNniv+GwjyJXzuNqVjlr5+4yVUZjycJwfQ==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@eslint-community/eslint-utils": "^4.8.0",
         "@eslint-community/regexpp": "^4.12.1",
@@ -3375,7 +3458,6 @@
       "integrity": "sha512-/yNdlIkpWbM0ptxno3ONTuf+2g318kh2ez3KSeZN5dZ8YC6AAmgeWz+GasYYiBJPFaYcSAPeu4GfhUaChzIJXA==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "tabbable": "^6.4.0"
       }
@@ -3422,6 +3504,15 @@
         "node": "6.* || 8.* || >= 10.*"
       }
     },
+    "node_modules/get-nonce": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/get-nonce/-/get-nonce-1.0.1.tgz",
+      "integrity": "sha512-FJhYRoDaiatfEkUK8HKlicmu/3SGFD51q3itKDGoSTysQJBnfOcxU5GxnhE1E6soB76MbT0MBtnKJuXyAx+96Q==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
     "node_modules/get-tsconfig": {
       "version": "4.14.0",
       "resolved": "https://registry.npmjs.org/get-tsconfig/-/get-tsconfig-4.14.0.tgz",
@@ -3806,20 +3897,6 @@
         "url": "https://github.com/sponsors/wooorm"
       }
     },
-    "node_modules/loose-envify": {
-      "version": "1.4.0",
-      "resolved": "https://registry.npmjs.org/loose-envify/-/loose-envify-1.4.0.tgz",
-      "integrity": "sha512-lyuxPGr/Wfhrlem2CL/UcnUc1zcqKAImBDzukY7Y5F/yQiNdko6+fRLevlw1HgMySw7f611UIY408EtxRSoK3Q==",
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "dependencies": {
-        "js-tokens": "^3.0.0 || ^4.0.0"
-      },
-      "bin": {
-        "loose-envify": "cli.js"
-      }
-    },
     "node_modules/lru-cache": {
       "version": "5.1.1",
       "dev": true,
@@ -4693,7 +4770,6 @@
       "version": "4.0.4",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "engines": {
         "node": ">=12"
       },
@@ -4794,7 +4870,6 @@
     "node_modules/react": {
       "version": "19.2.6",
       "license": "MIT",
-      "peer": true,
       "engines": {
         "node": ">=0.10.0"
       }
@@ -4809,6 +4884,16 @@
         "react": "^19.2.6"
       }
     },
+    "node_modules/react-number-format": {
+      "version": "5.4.5",
+      "resolved": "https://registry.npmjs.org/react-number-format/-/react-number-format-5.4.5.tgz",
+      "integrity": "sha512-y8O2yHHj3w0aE9XO8d2BCcUOOdQTRSVq+WIuMlLVucAm5XNjJAy+BoOJiuQMldVYVOKTMyvVNfnbl2Oqp+YxGw==",
+      "license": "MIT",
+      "peerDependencies": {
+        "react": "^0.14 || ^15.0.0 || ^16.0.0 || ^17.0.0 || ^18.0.0 || ^19.0.0",
+        "react-dom": "^0.14 || ^15.0.0 || ^16.0.0 || ^17.0.0 || ^18.0.0 || ^19.0.0"
+      }
+    },
     "node_modules/react-refresh": {
       "version": "0.17.0",
       "resolved": "https://registry.npmjs.org/react-refresh/-/react-refresh-0.17.0.tgz",
@@ -4819,6 +4904,75 @@
         "node": ">=0.10.0"
       }
     },
+    "node_modules/react-remove-scroll": {
+      "version": "2.7.2",
+      "resolved": "https://registry.npmjs.org/react-remove-scroll/-/react-remove-scroll-2.7.2.tgz",
+      "integrity": "sha512-Iqb9NjCCTt6Hf+vOdNIZGdTiH1QSqr27H/Ek9sv/a97gfueI/5h1s3yRi1nngzMUaOOToin5dI1dXKdXiF+u0Q==",
+      "license": "MIT",
+      "dependencies": {
+        "react-remove-scroll-bar": "^2.3.7",
+        "react-style-singleton": "^2.2.3",
+        "tslib": "^2.1.0",
+        "use-callback-ref": "^1.3.3",
+        "use-sidecar": "^1.1.3"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "peerDependencies": {
+        "@types/react": "*",
+        "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0 || ^19.0.0-rc"
+      },
+      "peerDependenciesMeta": {
+        "@types/react": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/react-remove-scroll-bar": {
+      "version": "2.3.8",
+      "resolved": "https://registry.npmjs.org/react-remove-scroll-bar/-/react-remove-scroll-bar-2.3.8.tgz",
+      "integrity": "sha512-9r+yi9+mgU33AKcj6IbT9oRCO78WriSj6t/cF8DWBZJ9aOGPOTEDvdUDz1FwKim7QXWwmHqtdHnRJfhAxEG46Q==",
+      "license": "MIT",
+      "dependencies": {
+        "react-style-singleton": "^2.2.2",
+        "tslib": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "peerDependencies": {
+        "@types/react": "*",
+        "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0"
+      },
+      "peerDependenciesMeta": {
+        "@types/react": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/react-style-singleton": {
+      "version": "2.2.3",
+      "resolved": "https://registry.npmjs.org/react-style-singleton/-/react-style-singleton-2.2.3.tgz",
+      "integrity": "sha512-b6jSvxvVnyptAiLjbkWLE/lOnR4lfTtDAl+eUC7RZy+QQWc6wRzIV2CE6xBuMmDxc2qIihtDCZD5NPOFl7fRBQ==",
+      "license": "MIT",
+      "dependencies": {
+        "get-nonce": "^1.0.0",
+        "tslib": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "peerDependencies": {
+        "@types/react": "*",
+        "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0 || ^19.0.0-rc"
+      },
+      "peerDependenciesMeta": {
+        "@types/react": {
+          "optional": true
+        }
+      }
+    },
     "node_modules/regex": {
       "version": "6.1.0",
       "resolved": "https://registry.npmjs.org/regex/-/regex-6.1.0.tgz",
@@ -5206,9 +5360,20 @@
       "version": "6.4.0",
       "resolved": "https://registry.npmjs.org/tabbable/-/tabbable-6.4.0.tgz",
       "integrity": "sha512-05PUHKSNE8ou2dwIxTngl4EzcnsCDZGJ/iCLtDflR/SHB/ny14rXc+qU5P4mG9JkusiV7EivzY9Mhm55AzAvCg==",
-      "dev": true,
       "license": "MIT"
     },
+    "node_modules/tagged-tag": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/tagged-tag/-/tagged-tag-1.0.0.tgz",
+      "integrity": "sha512-yEFYrVhod+hdNyx7g5Bnkkb0G6si8HJurOoOEgC8B/O0uXLHlaey/65KRv6cuWBNhBgHKAROVpc7QyYqE5gFng==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=20"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
     "node_modules/tinyglobby": {
       "version": "0.2.16",
       "dev": true,
@@ -5264,6 +5429,12 @@
         "typescript": ">=4.8.4"
       }
     },
+    "node_modules/tslib": {
+      "version": "2.8.1",
+      "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz",
+      "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==",
+      "license": "0BSD"
+    },
     "node_modules/tsx": {
       "version": "4.21.0",
       "resolved": "https://registry.npmjs.org/tsx/-/tsx-4.21.0.tgz",
@@ -5728,13 +5899,27 @@
         "node": ">= 0.8.0"
       }
     },
+    "node_modules/type-fest": {
+      "version": "5.6.0",
+      "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-5.6.0.tgz",
+      "integrity": "sha512-8ZiHFm91orbSAe2PSAiSVBVko18pbhbiB3U9GglSzF/zCGkR+rxpHx6sEMCUm4kxY4LjDIUGgCfUMtwfZfjfUA==",
+      "license": "(MIT OR CC0-1.0)",
+      "dependencies": {
+        "tagged-tag": "^1.0.0"
+      },
+      "engines": {
+        "node": ">=20"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
     "node_modules/typescript": {
       "version": "5.8.3",
       "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.8.3.tgz",
       "integrity": "sha512-p1diW6TqL9L07nNxvRMM7hMMw4c5XOo/1ibL4aAIGmSAt9slTE1Xgw5KWuof2uTOvCg9BY7ZRi+GaF+7sfgPeQ==",
       "dev": true,
       "license": "Apache-2.0",
-      "peer": true,
       "bin": {
         "tsc": "bin/tsc",
         "tsserver": "bin/tsserver"
@@ -5923,6 +6108,49 @@
         "punycode": "^2.1.0"
       }
     },
+    "node_modules/use-callback-ref": {
+      "version": "1.3.3",
+      "resolved": "https://registry.npmjs.org/use-callback-ref/-/use-callback-ref-1.3.3.tgz",
+      "integrity": "sha512-jQL3lRnocaFtu3V00JToYz/4QkNWswxijDaCVNZRiRTO3HQDLsdu1ZtmIUvV4yPp+rvWm5j0y0TG/S61cuijTg==",
+      "license": "MIT",
+      "dependencies": {
+        "tslib": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "peerDependencies": {
+        "@types/react": "*",
+        "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0 || ^19.0.0-rc"
+      },
+      "peerDependenciesMeta": {
+        "@types/react": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/use-sidecar": {
+      "version": "1.1.3",
+      "resolved": "https://registry.npmjs.org/use-sidecar/-/use-sidecar-1.1.3.tgz",
+      "integrity": "sha512-Fedw0aZvkhynoPYlA5WXrMCAMm+nSWdZt6lzJQ7Ok8S6Q+VsHmHpRWndVRJ8Be0ZbkfPc5LRYH+5XrzXcEeLRQ==",
+      "license": "MIT",
+      "dependencies": {
+        "detect-node-es": "^1.1.0",
+        "tslib": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "peerDependencies": {
+        "@types/react": "*",
+        "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0 || ^19.0.0-rc"
+      },
+      "peerDependenciesMeta": {
+        "@types/react": {
+          "optional": true
+        }
+      }
+    },
     "node_modules/vfile": {
       "version": "6.0.3",
       "resolved": "https://registry.npmjs.org/vfile/-/vfile-6.0.3.tgz",
@@ -5959,7 +6187,6 @@
       "integrity": "sha512-o5a9xKjbtuhY6Bi5S3+HvbRERmouabWbyUcpXXUA1u+GNUKoROi9byOJ8M0nHbHYHkYICiMlqxkg1KkYmm25Sw==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "esbuild": "^0.21.3",
         "postcss": "^8.4.43",
@@ -6091,7 +6318,6 @@
       "integrity": "sha512-WdLBG9gm02OgJIG9axd5Hpx0TFLdzVgfG2evFFu8Rur5O/IoGc5cMjnjh3tPL6GnRGsYvUhBSKVPYVcxRKpMCA==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@vue/compiler-dom": "3.5.34",
         "@vue/compiler-sfc": "3.5.34",
@@ -6207,7 +6433,6 @@
       "version": "4.4.3",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "funding": {
         "url": "https://github.com/sponsors/colinhacks"
       }

package.json

@@ -4,19 +4,21 @@
   "version": "0.0.0",
   "type": "module",
   "scripts": {
-    "dev": "vite",
-    "build": "npm run site:generate && tsc -b && vite build",
-    "docs:prepare:slm-design": "tsx scripts/docs/prepare.ts slm-design",
-    "docs:build:slm-design": "npm run docs:prepare:slm-design && vitepress build docs/slm-design",
-    "docs:prepare:nextjs-style-guide": "tsx scripts/docs/prepare.ts nextjs-style-guide",
-    "docs:build:nextjs-style-guide": "npm run docs:prepare:nextjs-style-guide && vitepress build docs/nextjs-style-guide",
-    "docs:prepare:figma-adaptive-standards": "tsx scripts/docs/prepare.ts figma-adaptive-standards",
-    "docs:build:figma-adaptive-standards": "npm run docs:prepare:figma-adaptive-standards && vitepress build docs/figma-adaptive-standards",
-    "site:generate": "tsx scripts/site/generate-artifacts.ts",
+    "dev": "npm run prepare:static-index && vite",
+    "build": "tsx build.ts",
+    "app:build": "npm run prepare:static-index && tsc -b && vite build",
+    "prepare:static-index": "tsx scripts/prepare-static-index.ts",
+    "build:slm-design": "tsx projects/slm-design/build.ts",
+    "build:nextjs-style-guide": "tsx projects/nextjs-style-guide/build.ts",
+    "build:figma-adaptive-standards": "tsx projects/figma-adaptive-standards/build.ts",
+    "build:template-sync-strategy": "tsx projects/template-sync-strategy/build.ts",
     "lint": "eslint .",
     "preview": "vite preview"
   },
   "dependencies": {
+    "@mantine/core": "^9.2.1",
+    "@mantine/hooks": "^9.2.1",
+    "@phosphor-icons/react": "^2.1.10",
     "react": "^19.2.6",
     "react-dom": "^19.2.6"
   },

projects/_shared/lib/prepare-docs.ts

@@ -0,0 +1,112 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+
+type Page = {
+  source: string;
+  target: string;
+};
+
+type RouteRewrite = {
+  from: string;
+  to: string;
+};
+
+type DocsConfig = {
+  mounts: Page[];
+  routeRewrites?: RouteRewrite[];
+};
+
+type ProjectConfig = {
+  slug: string;
+  docsDir: string;
+};
+
+const MD_LINK_RE = /\]\((?!#|[a-z][a-z0-9+.-]*:|\/\/)([^)\s]+)(#[^)]*)?\)/gi;
+
+function normalizePath(value: string) {
+  return value.split(path.sep).join('/').replace(/^\.\//, '');
+}
+
+function formatRelativeMarkdownPath(fromTarget: string, toTarget: string) {
+  const relative = path.relative(path.dirname(fromTarget), toTarget).split(path.sep).join('/');
+  return relative.startsWith('.') ? relative : `./${relative}`;
+}
+
+async function loadDocsConfig(configPath: string) {
+  return (await import(`${pathToFileURL(configPath).href}?t=${Date.now()}`)) as DocsConfig;
+}
+
+export async function prepareDocs(projectDir: string, config: ProjectConfig) {
+  const docsDir = path.join(projectDir, config.docsDir);
+  const contentDir = path.join(docsDir, 'content');
+  const docsConfig = await loadDocsConfig(path.join(docsDir, 'docs.config.ts'));
+  const targetBySource = new Map(
+    docsConfig.mounts.map((page) => [normalizePath(path.resolve(projectDir, page.source)), normalizePath(page.target)]),
+  );
+  const routeRewrites = [...(docsConfig.routeRewrites ?? [])].sort((a, b) => b.from.length - a.from.length);
+
+  function applyRouteRewrites(route: string) {
+    for (const rewrite of routeRewrites) {
+      if (route === rewrite.from || route.startsWith(`${rewrite.from}/`) || route.startsWith(`${rewrite.from}#`)) {
+        return `${rewrite.to}${route.slice(rewrite.from.length)}`;
+      }
+    }
+
+    return undefined;
+  }
+
+  function formatDocsRoute(route: string) {
+    const rewritten = applyRouteRewrites(route);
+    if (rewritten) return rewritten;
+    if (route === '/docs') return '/';
+    if (route.startsWith('/docs/')) return route.slice('/docs'.length);
+    return undefined;
+  }
+
+  function formatRelativeRoute(hrefPath: string, sourceDir: string) {
+    const sourcePath = normalizePath(path.relative(projectDir, path.resolve(sourceDir, hrefPath)));
+    if (sourcePath.startsWith('canons/')) return formatDocsRoute(`/docs/${sourcePath.slice('canons/'.length)}`);
+    return undefined;
+  }
+
+  function transformMarkdownLinks(content: string, page: Page) {
+    const sourceDir = path.dirname(path.resolve(projectDir, page.source));
+
+    return content.replace(MD_LINK_RE, (match, href: string, hash = '') => {
+      const [hrefPath, query = ''] = href.split('?');
+      const queryPart = query ? `?${query}` : '';
+
+      if (hrefPath.startsWith('/')) {
+        const route = formatDocsRoute(hrefPath) ?? applyRouteRewrites(hrefPath);
+        return route ? `](${route}${queryPart}${hash})` : match;
+      }
+
+      if (!hrefPath.endsWith('.md')) {
+        const route = formatRelativeRoute(hrefPath, sourceDir);
+        return route ? `](${route}${queryPart}${hash})` : match;
+      }
+
+      const target = targetBySource.get(normalizePath(path.resolve(sourceDir, hrefPath)));
+      if (!target) return match;
+
+      return `](${formatRelativeMarkdownPath(page.target, `${target}${queryPart}`)}${hash})`;
+    });
+  }
+
+  fs.rmSync(contentDir, { recursive: true, force: true });
+  fs.mkdirSync(contentDir, { recursive: true });
+
+  for (const page of docsConfig.mounts) {
+    const sourcePath = path.resolve(projectDir, page.source);
+    const targetPath = path.join(contentDir, page.target);
+
+    if (!fs.existsSync(sourcePath)) throw new Error(`Не найден канон: ${sourcePath}`);
+
+    fs.mkdirSync(path.dirname(targetPath), { recursive: true });
+    fs.writeFileSync(targetPath, transformMarkdownLinks(fs.readFileSync(sourcePath, 'utf8'), page), 'utf8');
+    console.log(`${page.target} -> ${path.relative(projectDir, sourcePath)}`);
+  }
+
+  console.log(`Подготовлен VitePress content для ${config.slug}: ${docsConfig.mounts.length} страниц`);
+}

projects/_shared/lib/root-llms.ts

@@ -0,0 +1,51 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+import { docs } from '../../../src/config/docs.config';
+
+const siteTitle = 'Документация';
+const siteDescription = 'Единое пространство для идей, черновиков и первых версий документаций, которые ещё формируются и постепенно становятся самостоятельными материалами.';
+
+function formatMarkdownLink(label: string, href: string, description: string) {
+  return `- [${label}](${href}): ${description}`;
+}
+
+function findDocLink(doc: (typeof docs)[number], label: string) {
+  return doc.links.find((link) => link.label === label);
+}
+
+export function generateRootLlms(rootDir = process.cwd()) {
+  const publicDir = path.join(rootDir, 'public');
+  const llmsPath = path.join(publicDir, 'llms.txt');
+  const content = [
+    `# ${siteTitle}`,
+    '',
+    `> ${siteDescription}`,
+    '',
+    'Этот файл является корневой картой документаций. Для работы с конкретным направлением используйте его собственный `llms.txt`.',
+    '',
+    '## Documentation',
+    '',
+    ...docs
+      .map((doc) => {
+        const link = findDocLink(doc, 'llms.txt');
+        return link ? formatMarkdownLink(doc.title, link.href, doc.description) : undefined;
+      })
+      .filter(Boolean),
+    '',
+    '## Optional',
+    '',
+    ...docs
+      .map((doc) => {
+        const link = findDocLink(doc, 'llms-full.txt');
+        return link ? formatMarkdownLink(`${doc.title} full`, link.href, `Полный bundle документации: ${doc.label.toLowerCase()}.`) : undefined;
+      })
+      .filter(Boolean),
+    '',
+  ].join('\n');
+
+  fs.mkdirSync(publicDir, { recursive: true });
+  fs.writeFileSync(llmsPath, content, 'utf8');
+
+  console.log(`Сгенерирован ${path.relative(rootDir, llmsPath)}`);
+}

projects/_shared/lib/run.ts

@@ -0,0 +1,12 @@
+import { spawnSync } from 'node:child_process';
+
+export function run(command: string, args: string[], cwd = process.cwd()) {
+  const result = spawnSync(command, args, {
+    cwd,
+    stdio: 'inherit',
+    shell: process.platform === 'win32',
+  });
+
+  if (result.error) throw result.error;
+  if (result.status !== 0) throw new Error(`Command failed: ${[command, ...args].join(' ')}`);
+}

projects/_shared/lib/zip.ts

@@ -0,0 +1,136 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+type ZipEntry = {
+  name: string;
+  content: Buffer;
+};
+
+function collectFiles(dir: string, baseDir = dir, archiveRoot = path.basename(dir)): ZipEntry[] {
+  return fs
+    .readdirSync(dir, { withFileTypes: true })
+    .flatMap((entry) => {
+      const entryPath = path.join(dir, entry.name);
+
+      if (entry.isDirectory()) return collectFiles(entryPath, baseDir, archiveRoot);
+
+      const relativePath = path.relative(baseDir, entryPath).split(path.sep).join('/');
+
+      return [
+        {
+          name: archiveRoot ? `${archiveRoot}/${relativePath}` : relativePath,
+          content: fs.readFileSync(entryPath),
+        },
+      ];
+    })
+    .sort((a, b) => a.name.localeCompare(b.name));
+}
+
+function createCrc32Table() {
+  return Array.from({ length: 256 }, (_, index) => {
+    let value = index;
+
+    for (let bit = 0; bit < 8; bit += 1) {
+      value = value & 1 ? 0xedb88320 ^ (value >>> 1) : value >>> 1;
+    }
+
+    return value >>> 0;
+  });
+}
+
+const crc32Table = createCrc32Table();
+
+function crc32(buffer: Buffer) {
+  let crc = 0xffffffff;
+
+  for (const byte of buffer) {
+    crc = crc32Table[(crc ^ byte) & 0xff] ^ (crc >>> 8);
+  }
+
+  return (crc ^ 0xffffffff) >>> 0;
+}
+
+function writeUInt16(value: number) {
+  const buffer = Buffer.alloc(2);
+  buffer.writeUInt16LE(value, 0);
+  return buffer;
+}
+
+function writeUInt32(value: number) {
+  const buffer = Buffer.alloc(4);
+  buffer.writeUInt32LE(value >>> 0, 0);
+  return buffer;
+}
+
+function createZip(entries: ZipEntry[]) {
+  const localParts: Buffer[] = [];
+  const centralParts: Buffer[] = [];
+  const dosTime = 0;
+  const dosDate = ((2026 - 1980) << 9) | (1 << 5) | 1;
+  let offset = 0;
+
+  for (const entry of entries) {
+    const fileName = Buffer.from(entry.name, 'utf8');
+    const checksum = crc32(entry.content);
+    const size = entry.content.length;
+
+    const localHeader = Buffer.concat([
+      writeUInt32(0x04034b50),
+      writeUInt16(20),
+      writeUInt16(0),
+      writeUInt16(0),
+      writeUInt16(dosTime),
+      writeUInt16(dosDate),
+      writeUInt32(checksum),
+      writeUInt32(size),
+      writeUInt32(size),
+      writeUInt16(fileName.length),
+      writeUInt16(0),
+      fileName,
+    ]);
+
+    localParts.push(localHeader, entry.content);
+
+    centralParts.push(Buffer.concat([
+      writeUInt32(0x02014b50),
+      writeUInt16(20),
+      writeUInt16(20),
+      writeUInt16(0),
+      writeUInt16(0),
+      writeUInt16(dosTime),
+      writeUInt16(dosDate),
+      writeUInt32(checksum),
+      writeUInt32(size),
+      writeUInt32(size),
+      writeUInt16(fileName.length),
+      writeUInt16(0),
+      writeUInt16(0),
+      writeUInt16(0),
+      writeUInt16(0),
+      writeUInt32(0),
+      writeUInt32(offset),
+      fileName,
+    ]));
+
+    offset += localHeader.length + size;
+  }
+
+  const centralDirectory = Buffer.concat(centralParts);
+  const endOfCentralDirectory = Buffer.concat([
+    writeUInt32(0x06054b50),
+    writeUInt16(0),
+    writeUInt16(0),
+    writeUInt16(entries.length),
+    writeUInt16(entries.length),
+    writeUInt32(centralDirectory.length),
+    writeUInt32(offset),
+    writeUInt16(0),
+  ]);
+
+  return Buffer.concat([...localParts, centralDirectory, endOfCentralDirectory]);
+}
+
+export function writeZipFromDirectory(sourceDir: string, zipPath: string, archiveRoot = path.basename(sourceDir)) {
+  fs.mkdirSync(path.dirname(zipPath), { recursive: true });
+  fs.writeFileSync(zipPath, createZip(collectFiles(sourceDir, sourceDir, archiveRoot)));
+}

projects/figma-adaptive-standards/build.ts

@@ -0,0 +1,20 @@
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import { prepareDocs } from '../_shared/lib/prepare-docs';
+import { run } from '../_shared/lib/run';
+import { writeZipFromDirectory } from '../_shared/lib/zip';
+import config from './project.config';
+
+const projectDir = path.dirname(fileURLToPath(import.meta.url));
+const rootDir = path.resolve(projectDir, '../..');
+const docsDir = path.join(projectDir, config.docsDir);
+
+await prepareDocs(projectDir, config);
+run('npx', ['vitepress', 'build', docsDir], rootDir);
+
+if (config.archive) {
+  const zipPath = path.join(rootDir, 'public', config.slug, `${config.slug}.zip`);
+  writeZipFromDirectory(path.join(docsDir, 'content'), zipPath, config.slug);
+  console.log(`Собран ${path.relative(rootDir, zipPath)}`);
+}

projects/figma-adaptive-standards/docs/.vitepress/config.ts

@@ -1,7 +1,7 @@
 import { defineConfig } from 'vitepress';
 import taskLists from 'markdown-it-task-lists';
 import llmstxt from 'vitepress-plugin-llms';
-import { themeSyncHead } from '../../shared/vitepress/themeHead';
+import { themeSyncHead } from '../../../_shared/docs/vitepress/themeHead';
 import { sidebar, site } from '../docs.config';
 
 export default defineConfig({

projects/figma-adaptive-standards/docs/.vitepress/theme/index.ts

@@ -0,0 +1 @@
+export { default } from '../../../../_shared/docs/vitepress/theme';

projects/figma-adaptive-standards/docs/docs.config.ts

@@ -2,22 +2,22 @@ export const site = {
   title: 'Figma Adaptive Standards',
   description: 'Стандарты подготовки адаптивных макетов в Figma',
   base: '/figma-adaptive-standards/',
-  outDir: '../../public/figma-adaptive-standards',
+  outDir: '../../../public/figma-adaptive-standards',
 };
 
 /**
  * Карта монтирования исходных канонов в VitePress-документацию.
  *
  * `source` указывает на markdown-файл внутри `canons/`.
- * `target` задаёт путь, по которому этот файл попадёт в `docs/figma-adaptive-standards/content/`
+ * `target` задаёт путь, по которому этот файл попадёт в `docs/content/`
  * и станет страницей итоговой документации.
  */
 export const mounts = [
-  { target: 'index.md', source: 'figma/index.md' },
-  { target: 'overview.md', source: 'figma/index.md' },
-  { target: 'adaptive-layout-requirements/short.md', source: 'figma/adaptive-layout-requirements.short.md' },
-  { target: 'adaptive-layout-requirements/full.md', source: 'figma/adaptive-layout-requirements.full.md' },
-  { target: 'adaptive-layout-requirements/checklist.md', source: 'figma/adaptive-layout-requirements.checklist.md' },
+  { target: 'index.md', source: 'canons/index.md' },
+  { target: 'overview.md', source: 'canons/index.md' },
+  { target: 'adaptive-layout-requirements/short.md', source: 'canons/adaptive-layout-requirements.short.md' },
+  { target: 'adaptive-layout-requirements/full.md', source: 'canons/adaptive-layout-requirements.full.md' },
+  { target: 'adaptive-layout-requirements/checklist.md', source: 'canons/adaptive-layout-requirements.checklist.md' },
 ];
 
 export const sidebar = [

projects/figma-adaptive-standards/project.config.ts

@@ -0,0 +1,5 @@
+export default {
+  slug: 'figma-adaptive-standards',
+  docsDir: 'docs',
+  archive: true,
+} as const;

projects/nextjs-style-guide/build.ts

@@ -0,0 +1,20 @@
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import { prepareDocs } from '../_shared/lib/prepare-docs';
+import { run } from '../_shared/lib/run';
+import { writeZipFromDirectory } from '../_shared/lib/zip';
+import config from './project.config';
+
+const projectDir = path.dirname(fileURLToPath(import.meta.url));
+const rootDir = path.resolve(projectDir, '../..');
+const docsDir = path.join(projectDir, config.docsDir);
+
+await prepareDocs(projectDir, config);
+run('npx', ['vitepress', 'build', docsDir], rootDir);
+
+if (config.archive) {
+  const zipPath = path.join(rootDir, 'public', config.slug, `${config.slug}.zip`);
+  writeZipFromDirectory(path.join(docsDir, 'content'), zipPath, config.slug);
+  console.log(`Собран ${path.relative(rootDir, zipPath)}`);
+}

projects/nextjs-style-guide/canons/index.md

@@ -16,7 +16,7 @@ description: Практический стайлгайд для разработ
 
 **Для проекта:**
 
-- [nextjs-style-guide.zip](/nextjs-style-guide.zip) — Набор Markdown-файлов для распаковки в `./ai/nextjs-style-guide/` или другую папку проекта.
+- [nextjs-style-guide.zip](/nextjs-style-guide/nextjs-style-guide.zip) — Набор Markdown-файлов для распаковки в `./ai/nextjs-style-guide/` или другую папку проекта.
 
 ## Структура документации
 

projects/nextjs-style-guide/docs/.vitepress/config.ts

@@ -0,0 +1,28 @@
+import { defineConfig } from 'vitepress';
+import taskLists from 'markdown-it-task-lists';
+import llmstxt from 'vitepress-plugin-llms';
+import { themeSyncHead } from '../../../_shared/docs/vitepress/themeHead';
+import { sidebar, site } from '../docs.config';
+
+export default defineConfig({
+  title: site.title,
+  description: site.description,
+  base: site.base,
+  outDir: site.outDir,
+  srcDir: 'content',
+  cleanUrls: true,
+  ignoreDeadLinks: [/^\/slm-design\//],
+  head: [...themeSyncHead],
+  vite: {
+    plugins: [llmstxt()],
+  },
+  markdown: {
+    config(md) {
+      md.use(taskLists);
+    },
+  },
+  themeConfig: {
+    sidebar,
+    socialLinks: [],
+  },
+});

projects/nextjs-style-guide/docs/.vitepress/theme/index.ts

@@ -0,0 +1 @@
+export { default } from '../../../../_shared/docs/vitepress/theme';

projects/nextjs-style-guide/docs/docs.config.ts

@@ -2,71 +2,71 @@ export const site = {
   title: 'NextJS Style Guide',
   description: 'Практический стайлгайд для разработки frontend-приложений на Next.js и TypeScript',
   base: '/nextjs-style-guide/',
-  outDir: '../../public/nextjs-style-guide',
+  outDir: '../../../public/nextjs-style-guide',
 };
 
 /**
  * Карта монтирования исходных канонов в VitePress-документацию.
  *
- * SLM-разделы берутся только из корневого `canons/slm-design/`, чтобы
- * NextJS-гайд не содержал собственных дублей архитектурного канона.
+ * SLM-разделы берутся из проекта `slm-design`, чтобы NextJS-гайд не содержал
+ * собственных дублей архитектурного канона.
  */
 export const mounts = [
-  { target: 'index.md', source: 'style-guide/index.md' },
-  { target: 'workflow.md', source: 'style-guide/workflow.md' },
+  { target: 'index.md', source: 'canons/index.md' },
+  { target: 'workflow.md', source: 'canons/workflow.md' },
 
-  { target: 'slm-design/architecture/index.md', source: 'slm-design/architecture/index.md' },
-  { target: 'slm-design/architecture/layers.md', source: 'slm-design/architecture/layers.md' },
-  { target: 'slm-design/architecture/modules.md', source: 'slm-design/architecture/modules.md' },
-  { target: 'slm-design/architecture/segments.md', source: 'slm-design/architecture/segments.md' },
-  { target: 'slm-design/architecture/monorepo.md', source: 'slm-design/architecture/monorepo.md' },
-  { target: 'slm-design/examples/react/factory.md', source: 'slm-design/examples/react/factory.md' },
-  { target: 'slm-design/examples/react/factory-composition.md', source: 'slm-design/examples/react/factory-composition.md' },
-  { target: 'slm-design/examples/react/composition-provider.md', source: 'slm-design/examples/react/composition-provider.md' },
+  { target: 'slm-design/architecture/index.md', source: '../slm-design/canons/architecture/index.md' },
+  { target: 'slm-design/architecture/layers.md', source: '../slm-design/canons/architecture/layers.md' },
+  { target: 'slm-design/architecture/modules.md', source: '../slm-design/canons/architecture/modules.md' },
+  { target: 'slm-design/architecture/segments.md', source: '../slm-design/canons/architecture/segments.md' },
+  { target: 'slm-design/architecture/monorepo.md', source: '../slm-design/canons/architecture/monorepo.md' },
+  { target: 'slm-design/examples/react/factory.md', source: '../slm-design/canons/examples/react/factory.md' },
+  { target: 'slm-design/examples/react/factory-composition.md', source: '../slm-design/canons/examples/react/factory-composition.md' },
+  { target: 'slm-design/examples/react/composition-provider.md', source: '../slm-design/canons/examples/react/composition-provider.md' },
 
-  { target: 'basics/tech-stack.md', source: 'style-guide/basics/tech-stack.md' },
-  { target: 'basics/naming.md', source: 'style-guide/basics/naming.md' },
-  { target: 'basics/code-style.md', source: 'style-guide/basics/code-style.md' },
-  { target: 'basics/documentation.md', source: 'style-guide/basics/documentation.md' },
-  { target: 'basics/typing.md', source: 'style-guide/basics/typing.md' },
+  { target: 'basics/tech-stack.md', source: 'canons/basics/tech-stack.md' },
+  { target: 'basics/naming.md', source: 'canons/basics/naming.md' },
+  { target: 'basics/code-style.md', source: 'canons/basics/code-style.md' },
+  { target: 'basics/documentation.md', source: 'canons/basics/documentation.md' },
+  { target: 'basics/typing.md', source: 'canons/basics/typing.md' },
 
-  { target: 'applied/creating-project/from-template.md', source: 'style-guide/applied/creating-project/from-template.md' },
-  { target: 'applied/creating-project/manual.md', source: 'style-guide/applied/creating-project/manual.md' },
-  { target: 'applied/creating-project/nextjs.md', source: 'style-guide/applied/creating-project/nextjs.md' },
-  { target: 'applied/project-structure.md', source: 'style-guide/applied/project-structure.md' },
-  { target: 'applied/page-level.md', source: 'style-guide/applied/page-level.md' },
-  { target: 'applied/component.md', source: 'style-guide/applied/component.md' },
-  { target: 'applied/module.md', source: 'style-guide/applied/module.md' },
-  { target: 'applied/rest-client/index.md', source: 'style-guide/applied/rest-client/index.md' },
-  { target: 'applied/rest-client/setup/index.md', source: 'style-guide/applied/rest-client/setup/index.md' },
-  { target: 'applied/rest-client/setup/auto.md', source: 'style-guide/applied/rest-client/setup/auto.md' },
-  { target: 'applied/rest-client/setup/manual.md', source: 'style-guide/applied/rest-client/setup/manual.md' },
-  { target: 'applied/rest-client/setup/hooks.md', source: 'style-guide/applied/rest-client/setup/hooks.md' },
-  { target: 'applied/rest-client/usage.md', source: 'style-guide/applied/rest-client/usage.md' },
-  { target: 'applied/data-fetch/index.md', source: 'style-guide/applied/data-fetch/index.md' },
-  { target: 'applied/data-fetch/server-await.md', source: 'style-guide/applied/data-fetch/server-await.md' },
-  { target: 'applied/data-fetch/parallel-server-requests.md', source: 'style-guide/applied/data-fetch/parallel-server-requests.md' },
-  { target: 'applied/data-fetch/pass-promise-down.md', source: 'style-guide/applied/data-fetch/pass-promise-down.md' },
-  { target: 'applied/data-fetch/client-hooks-initial-data.md', source: 'style-guide/applied/data-fetch/client-hooks-initial-data.md' },
-  { target: 'applied/data-fetch/client-get-hook.md', source: 'style-guide/applied/data-fetch/client-get-hook.md' },
-  { target: 'applied/data-fetch/business-composition.md', source: 'style-guide/applied/data-fetch/business-composition.md' },
-  { target: 'applied/styles/styles-setup.md', source: 'style-guide/applied/styles/styles-setup.md' },
-  { target: 'applied/styles/styles-usage.md', source: 'style-guide/applied/styles/styles-usage.md' },
-  { target: 'applied/svg-sprites/svg-sprites-intro.md', source: 'style-guide/applied/svg-sprites/svg-sprites-intro.md' },
-  { target: 'applied/svg-sprites/svg-sprites-setup.md', source: 'style-guide/applied/svg-sprites/svg-sprites-setup.md' },
-  { target: 'applied/svg-sprites/svg-sprites-usage.md', source: 'style-guide/applied/svg-sprites/svg-sprites-usage.md' },
-  { target: 'applied/images.md', source: 'style-guide/applied/images.md' },
-  { target: 'applied/fonts.md', source: 'style-guide/applied/fonts.md' },
-  { target: 'applied/aliases.md', source: 'style-guide/applied/aliases.md' },
-  { target: 'applied/templates/templates-intro.md', source: 'style-guide/applied/templates/templates-intro.md' },
-  { target: 'applied/templates/templates-setup.md', source: 'style-guide/applied/templates/templates-setup.md' },
-  { target: 'applied/templates/templates-create.md', source: 'style-guide/applied/templates/templates-create.md' },
-  { target: 'applied/templates/templates-usage.md', source: 'style-guide/applied/templates/templates-usage.md' },
-  { target: 'applied/biome.md', source: 'style-guide/applied/biome.md' },
-  { target: 'applied/postcss.md', source: 'style-guide/applied/postcss.md' },
-  { target: 'applied/vscode.md', source: 'style-guide/applied/vscode.md' },
-  { target: 'applied/localization.md', source: 'style-guide/applied/localization.md' },
-  { target: 'applied/stores.md', source: 'style-guide/applied/stores.md' },
+  { target: 'applied/creating-project/from-template.md', source: 'canons/applied/creating-project/from-template.md' },
+  { target: 'applied/creating-project/manual.md', source: 'canons/applied/creating-project/manual.md' },
+  { target: 'applied/creating-project/nextjs.md', source: 'canons/applied/creating-project/nextjs.md' },
+  { target: 'applied/project-structure.md', source: 'canons/applied/project-structure.md' },
+  { target: 'applied/page-level.md', source: 'canons/applied/page-level.md' },
+  { target: 'applied/component.md', source: 'canons/applied/component.md' },
+  { target: 'applied/module.md', source: 'canons/applied/module.md' },
+  { target: 'applied/rest-client/index.md', source: 'canons/applied/rest-client/index.md' },
+  { target: 'applied/rest-client/setup/index.md', source: 'canons/applied/rest-client/setup/index.md' },
+  { target: 'applied/rest-client/setup/auto.md', source: 'canons/applied/rest-client/setup/auto.md' },
+  { target: 'applied/rest-client/setup/manual.md', source: 'canons/applied/rest-client/setup/manual.md' },
+  { target: 'applied/rest-client/setup/hooks.md', source: 'canons/applied/rest-client/setup/hooks.md' },
+  { target: 'applied/rest-client/usage.md', source: 'canons/applied/rest-client/usage.md' },
+  { target: 'applied/data-fetch/index.md', source: 'canons/applied/data-fetch/index.md' },
+  { target: 'applied/data-fetch/server-await.md', source: 'canons/applied/data-fetch/server-await.md' },
+  { target: 'applied/data-fetch/parallel-server-requests.md', source: 'canons/applied/data-fetch/parallel-server-requests.md' },
+  { target: 'applied/data-fetch/pass-promise-down.md', source: 'canons/applied/data-fetch/pass-promise-down.md' },
+  { target: 'applied/data-fetch/client-hooks-initial-data.md', source: 'canons/applied/data-fetch/client-hooks-initial-data.md' },
+  { target: 'applied/data-fetch/client-get-hook.md', source: 'canons/applied/data-fetch/client-get-hook.md' },
+  { target: 'applied/data-fetch/business-composition.md', source: 'canons/applied/data-fetch/business-composition.md' },
+  { target: 'applied/styles/styles-setup.md', source: 'canons/applied/styles/styles-setup.md' },
+  { target: 'applied/styles/styles-usage.md', source: 'canons/applied/styles/styles-usage.md' },
+  { target: 'applied/svg-sprites/svg-sprites-intro.md', source: 'canons/applied/svg-sprites/svg-sprites-intro.md' },
+  { target: 'applied/svg-sprites/svg-sprites-setup.md', source: 'canons/applied/svg-sprites/svg-sprites-setup.md' },
+  { target: 'applied/svg-sprites/svg-sprites-usage.md', source: 'canons/applied/svg-sprites/svg-sprites-usage.md' },
+  { target: 'applied/images.md', source: 'canons/applied/images.md' },
+  { target: 'applied/fonts.md', source: 'canons/applied/fonts.md' },
+  { target: 'applied/aliases.md', source: 'canons/applied/aliases.md' },
+  { target: 'applied/templates/templates-intro.md', source: 'canons/applied/templates/templates-intro.md' },
+  { target: 'applied/templates/templates-setup.md', source: 'canons/applied/templates/templates-setup.md' },
+  { target: 'applied/templates/templates-create.md', source: 'canons/applied/templates/templates-create.md' },
+  { target: 'applied/templates/templates-usage.md', source: 'canons/applied/templates/templates-usage.md' },
+  { target: 'applied/biome.md', source: 'canons/applied/biome.md' },
+  { target: 'applied/postcss.md', source: 'canons/applied/postcss.md' },
+  { target: 'applied/vscode.md', source: 'canons/applied/vscode.md' },
+  { target: 'applied/localization.md', source: 'canons/applied/localization.md' },
+  { target: 'applied/stores.md', source: 'canons/applied/stores.md' },
 ];
 
 export const routeRewrites = [

projects/nextjs-style-guide/project.config.ts

@@ -0,0 +1,5 @@
+export default {
+  slug: 'nextjs-style-guide',
+  docsDir: 'docs',
+  archive: true,
+} as const;

projects/slm-design/build.ts

@@ -0,0 +1,22 @@
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import { prepareDocs } from '../_shared/lib/prepare-docs';
+import { run } from '../_shared/lib/run';
+import { writeZipFromDirectory } from '../_shared/lib/zip';
+import config from './project.config';
+
+const projectDir = path.dirname(fileURLToPath(import.meta.url));
+const rootDir = path.resolve(projectDir, '../..');
+const docsDir = path.join(projectDir, config.docsDir);
+
+await prepareDocs(projectDir, config);
+run('npx', ['vitepress', 'build', docsDir], rootDir);
+
+if (config.archive) {
+  const zipPath = path.join(rootDir, 'public', config.slug, `${config.slug}.zip`);
+  writeZipFromDirectory(path.join(docsDir, 'content'), zipPath, config.slug);
+  console.log(`Собран ${path.relative(rootDir, zipPath)}`);
+}
+
+await import('./scripts/build-skill');

projects/slm-design/canons/architecture/index.md

@@ -4,6 +4,7 @@ description: Назначение архитектуры, ключевые пр
 ---
 
 # SLM Design
+
 Scoped Layered Module Design — модульная архитектура фронтенд-приложений. Код организован по слоям ответственности, а модуль содержит всё, что ему нужно: компоненты, хуки, сторы, типы, стили.
 
 ## Разделы спецификации
@@ -13,12 +14,16 @@ Scoped Layered Module Design — модульная архитектура фр
 - [Слои](/architecture/layers) — уровни организации `src/`, направление зависимостей и зона ответственности каждого слоя.
 - [Модули](/architecture/modules) — границы ответственности, публичный API, типы модулей и отличие модуля от компонента.
 - [Сегменты](/architecture/segments) — внутренние папки модуля (`ui/`, `parts/`, `hooks/`, `types/` и другие) и правила размещения файлов.
-- [Монорепозитории](/architecture/monorepo) — применение SLM в `apps/` и `packages/`, правила выноса общих слоёв и ограничения для business.
+- [Монорепозитории](/architecture/monorepo) — применение SLM в `apps/` и `packages/`, правила выноса общих слоёв и ограничения для business/compositions.
 
 Рекомендуемый порядок чтения: обзор → слои → модули → сегменты → монорепозитории.
 
 ## Преимущества
 
+### Единый слой композиции
+
+Страницы, маршруты и крупные продуктовые части интерфейса собираются в `compositions`. Слой не навязывает жёсткую структуру: команда может использовать `pages/layouts/screens/widgets` или другую организацию под свой фреймворк и продукт.
+
 ### Вертикальная организация домена
 
 Бизнес-домен не разбивается по техническим слоям — сценарии, сущности, типы и UI живут в одном модуле. Это сокращает время навигации и упрощает сопровождение: все изменения домена локализованы.
@@ -29,27 +34,27 @@ Cross-domain зависимости в бизнес-слое реализуют
 
 ### Разделение ответственности без перегрузки слоёв
 
-Сервисы приложения (`infra/`), UI-кит (`ui/`) и общие ресурсы (`shared/`) — три разных слоя с разной природой. Ни один слой не превращается в свалку разнородного кода.
+Композиция приложения (`compositions/`), сервисы приложения (`infra/`), UI-кит (`ui/`) и общие ресурсы (`shared/`) — разные слои с разной природой. Ни один слой не превращается в свалку разнородного кода.
+
+### Графовая композиция там, где она нужна
+
+Внутри `compositions` допускается граф импортов через публичный API. Это позволяет page-level store, provider или business composition использовать одновременно в layout, screen и widget, не перенося продуктовый runtime-state в `infra` или `shared`.
 
 ### Горизонтальная инкапсуляция
 
-Вложенные модули (`parts/`) и направление зависимостей позволяют нескольким разработчикам работать над одной областью приложения параллельно, не затрагивая код друг друга.
+Вложенные модули (`parts/`) и публичные API позволяют нескольким разработчикам работать над одной областью приложения параллельно, не затрагивая код друг друга.
 
 ### Колокация по умолчанию
 
 Код начинает жизнь рядом с местом использования и поднимается в общие слои только при реальной потребности. Глобальные слои не засоряются преждевременными абстракциями.
 
-### Явное разделение каркаса и контента
-
-Каркас группы маршрутов (`layouts/`) и контент конкретной страницы (`screens/`) — независимые слои с собственной ответственностью.
-
 ### Масштабирование через группировку
 
-При росте проекта слои не теряют структуру — модули группируются по естественным признакам: бизнес-домены по субдоменам, страницы по разделам, UI-компоненты по уровню абстракции (примитивы и композиции).
+При росте проекта слои не теряют структуру — модули группируются по естественным признакам: композиции по страницам и маршрутам, бизнес-домены по субдоменам, UI-компоненты по уровню абстракции.
 
 ### Адаптация к монорепозиториям
 
-SLM применяется внутри каждого приложения, а `packages/*` используются только для общего кода из слоёв `ui`, `infra` и `shared`. Бизнес-домены остаются внутри приложений, чтобы не размывать продуктовые границы.
+SLM применяется внутри каждого приложения, а `packages/*` используются только для общего кода из слоёв `ui`, `infra` и `shared`. `compositions` и бизнес-домены остаются внутри приложений, чтобы не размывать продуктовые границы.
 
 ## Происхождение
 
@@ -66,20 +71,20 @@ SLM Design вырос на основе:
 src/
 ├── app/
 │
-├── layouts/
-│   ├── main/
-│   └── dashboard/
-│
-├── screens/
-│   ├── home/
-│   ├── products/
-│   ├── product-detail/
-│   └── about/
-│
-├── widgets/
-│   ├── page-heading/
-│   ├── hero-section/
-│   └── promo-banner/
+├── compositions/
+│   ├── pages/
+│   │   ├── home/
+│   │   ├── profile/
+│   │   └── product-detail/
+│   ├── layouts/
+│   │   ├── main/
+│   │   └── dashboard/
+│   ├── screens/
+│   │   ├── home/
+│   │   └── profile/
+│   └── widgets/
+│       ├── page-heading/
+│       └── promo-banner/
 │
 ├── business/
 │   ├── auth/
@@ -108,7 +113,10 @@ src/
 
 ## Принципы
 
-- **Домен — единое целое.** Всё, что относится к домену, живёт в одном модуле.
+- **Композиция — отдельный слой.** Страницы, маршруты и крупные продуктовые части интерфейса собираются в `compositions`.
+- **Структура композиции свободна.** Команда сама выбирает организацию внутри `compositions`; базовая рекомендация — `pages/layouts/screens/widgets`.
+- **Домен — единое целое.** Всё, что относится к домену, живёт в одном business-модуле.
 - **Колокация.** Код рождается рядом с местом использования и поднимается только при необходимости.
-- **Зависимости однонаправлены.** Импорты только сверху вниз, только через публичный API.
-- **Архитектура — каркас, не клетка.** Правила фиксируют направление зависимостей и структуру модуля, остальное определяет команда.
+- **Зависимости однонаправлены за пределами compositions.** Глобальная стрелка: `app → compositions → business → infra → ui → shared`.
+- **Внутри compositions допустим граф.** Composition modules могут импортировать друг друга через public API.
+- **Архитектура — каркас, не клетка.** Правила фиксируют границы ответственности и public API, а внутреннюю форму композиции определяет команда.

projects/slm-design/canons/architecture/layers.md

@@ -9,7 +9,7 @@ description: Иерархия слоёв от app до shared, правила з
 
 ## Определение
 
-**Слой — уровень организации кода внутри `src/`. Каждый слой отвечает за свою область (каркас страницы, бизнес-логика, UI-кит) и задаёт правила для кода внутри: направление импортов, именование, допустимые связи между модулями.**
+**Слой — уровень организации кода внутри `src/`. Каждый слой отвечает за свою область и задаёт правила для кода внутри: направление импортов, именование, допустимые связи между модулями.**
 
 ## Группы слоёв
 
@@ -17,7 +17,7 @@ description: Иерархия слоёв от app до shared, правила з
 
 | Группа | Слои | Описание |
 |--------|------|----------|
-| Композиция | `app`, `layouts`, `screens`, `widgets` | Собирают интерфейс из готовых блоков: маршруты, каркасы, страницы |
+| Композиция | `app`, `compositions` | Подключают приложение к фреймворку и собирают страницы, маршруты и крупные продуктовые части интерфейса |
 | Ядро | `business`, `infra`, `ui` | Реализация продукта: бизнес-домены, техсервисы, UI-кит |
 | Фундамент | `shared` | Общие ресурсы: утилиты, хелперы, стили, конфиги |
 
@@ -25,20 +25,24 @@ description: Иерархия слоёв от app до shared, правила з
 
 Любой импорт между модулями — только через публичный API.
 
-```
-app → [ layouts | screens ] → widgets → business → infra → ui → shared
+```text
+app → compositions → business → infra → ui → shared
 ```
 
-- `layouts` и `screens` — параллельные слои, не импортируют друг друга
-- Модули одного слоя в группе «Композиция» изолированы друг от друга
-- Модули одного слоя `infra` и `ui` могут импортировать друг друга через публичный API
-- Модули `business` — cross-domain зависимости по коду через фабрику, `import type` напрямую
+- `app` подключает приложение к фреймворку и импортирует готовые модули из нижних слоёв
+- `compositions` импортирует `business`, `infra`, `ui`, `shared`
+- `business` импортирует `infra`, `ui`, `shared`
+- `infra` импортирует `infra`, `ui`, `shared`
+- `ui` импортирует `ui` и `shared`
+- `shared` не импортирует другие SLM-слои
+- `business`, `infra`, `ui`, `shared` не импортируют `compositions`
+- Внутри `compositions` направление импортов между composition modules не фиксируется, но импорты разрешены только через публичный API
+- Модули `business` используют runtime-зависимости на другие домены только через фабрику, `import type` — напрямую
 - Импорт типов (`import type`) в «Ядре» разрешён в обоих направлениях
 
-
 ## Слой App
 
-Точка входа приложения. Отвечает за запуск, роутинг и композицию маршрутов из layout и screen.
+Точка входа приложения. Отвечает за запуск, роутинг и подключение composition modules к фреймворку.
 
 В отличие от остальных слоёв, `app/` не содержит модулей SLM. Здесь живут только инфраструктурные файлы, которые не могут быть никаким другим слоем: файлы фреймворка роутинга, точка запуска и код инициализации.
 
@@ -46,90 +50,77 @@ app → [ layouts | screens ] → widgets → business → infra → ui → shar
 
 - Не содержит модулей SLM — только файлы фреймворка, роутинг, инициализация
 - Содержит: файлы маршрутов, bootstrap, обработку ошибок верхнего уровня (404, error boundary), подключение глобальных стилей и ассетов
-- Провайдеры и гарды — только подключает готовые из нижних слоёв, не реализует
+- Провайдеры, guards, layouts, screens и страницы — только подключает готовые из `compositions` или нижних слоёв, не реализует
 - Не содержит бизнес-логику, UI-компоненты, хуки, сторы, сервисы
 - Никем не импортируется
 
-## Слой Layouts
+## Слой Compositions
 
-Каркас страницы: общие элементы, одинаковые для группы маршрутов (header, footer, sidebar).
+`compositions/` — слой сборки страниц, маршрутов и крупных продуктовых частей интерфейса.
+
+На этом слое собираются page, layout, screen, widget и другие composition modules. Они связываются между собой и с нижними слоями: `business`, `infra`, `ui`, `shared`.
+
+SLM не фиксирует жёсткую структуру внутри `compositions`. Команда выбирает организацию под фреймворк, роутинг, CMS и продуктовую задачу.
+
+Базовая рекомендация:
 
 ```text
-src/layouts/
-├── main/
-├── dashboard/
-└── auth/
+src/compositions/
+├── pages/
+├── layouts/
+├── screens/
+└── widgets/
+```
+
+`pages`, `layouts`, `screens` и `widgets` внутри `compositions` не являются отдельными SLM-слоями. Это типы композиционных модулей.
+
+Composition module может содержать обычные сегменты SLM: `ui/`, `parts/`, `hooks/`, `stores/`, `services/`, `mappers/`, `types/`, `styles/`, `lib/`, `config/`, `providers/`.
+
+Page-level store, provider, guard или business composition размещаются внутри page composition module, если они нужны всей странице.
+
+```text
+compositions/pages/profile/
+├── profile.page.tsx
+├── profile-business-composition.ts
+├── providers/
+├── hooks/
+├── stores/
+├── types/
+└── index.ts
+```
+
+Layout, screen и widget могут получать данные page composition через публичный API соответствующего composition module.
+
+```ts
+import { useProfilePageStore } from '@/compositions/pages/profile'
+```
+
+Внутри `compositions` направление импортов между composition modules не фиксируется. Допустим граф, но все импорты идут только через public API.
+
+```ts
+// Хорошо
+import { useProfilePageStore } from '@/compositions/pages/profile'
+
+// Плохо
+import { useProfilePageStore } from '@/compositions/pages/profile/hooks/use-profile-page-store.hook'
 ```
 
 ### Требования
 
-- Содержит только модули
-- Не содержит бизнес-логику
-- Контекстно-зависимые блоки принимает через пропсы от `app`, не импортирует напрямую
-
-## Слой Screens
-
-Контент конкретной страницы: собирает её из модулей нижних слоёв.
-
-```text
-src/screens/
-├── home/
-├── products/
-├── product-detail/
-├── about/
-└── contacts/
-```
-
-Когда количество страниц затрудняет навигацию — вводится группировка по разделам. Группа — папка для организации, не модуль (без `index.ts`).
-
-```text
-src/screens/
-├── shop/
-│   ├── home/
-│   ├── products/
-│   ├── product-detail/
-│   └── cart/
-├── account/
-│   ├── profile/
-│   ├── settings/
-│   └── order-history/
-└── info/
-    ├── about/
-    ├── contacts/
-    └── faq/
-```
-
-### Требования
-
-- Содержит только модули
-- Не содержит бизнес-логику
-- Локальные одноразовые секции живут внутри screen-модуля, не выносятся в `widgets`/`business`
-
-## Слой Widgets
-
-Составной блок интерфейса, который компонует модули ядра, но не принадлежит конкретному бизнес-домену. Widget появляется когда блок используется в нескольких screens или layouts.
-
-Если блок принадлежит домену — он живёт в `business/{area}/`, даже если переиспользуется. Если блок нужен только в одном месте — это `screens/{name}/parts/` или `layouts/{name}/parts/`, а не widget.
-
-```text
-src/widgets/
-├── page-heading/
-├── hero-section/
-├── onboarding-checklist/
-├── promo-banner/
-└── error-boundary/
-```
-
-### Требования
-
-- Не принадлежит конкретному бизнес-домену. Если блок доменный — он живёт в `business/`
-- Используется в нескольких screens или layouts
+- `compositions` содержит composition modules страниц, маршрутов и крупных продуктовых частей интерфейса
+- Структура внутри `compositions` выбирается командой
+- Базовая рекомендация: `pages/`, `layouts/`, `screens/`, `widgets/`
+- `pages`, `layouts`, `screens`, `widgets` внутри `compositions` не являются отдельными SLM-слоями
+- Providers, stores, guards и business composition размещаются внутри того composition module, которому они принадлежат
+- Внутри `compositions` импорты между composition modules разрешены в любую сторону, но только через public API
+- Deep imports внутрь composition modules запрещены
+- `business`, `infra`, `ui` и `shared` не импортируют `compositions`
 
 ## Слой Business
 
 Бизнес-домены приложения: auth, catalog, orders, checkout, chat. Каждый домен — отдельный модуль со своими типами, логикой, UI и сервисами.
 
-Слой входит в группу «Ядро». Импортирует `infra/`, `ui/`, `shared/`. Каждый бизнес-модуль создаёт публичный runtime API через фабрику в корне. Cross-domain зависимости: runtime — через аргументы фабрики, типы — напрямую через `import type`.
+Слой входит в группу «Ядро». Импортирует `infra/`, `ui/`, `shared/`. Каждый бизнес-модуль создаёт публичный API фабрики в корне. Cross-domain зависимости: runtime — через аргументы фабрики, типы — напрямую через `import type`.
 
 Business объединяет то, что в FSD разделено на `features` и `entities`: пользовательские сценарии и бизнес-сущности живут вместе, внутри одного домена. Внутри домена сегменты разделяют ответственность: `types/` — доменная модель, `hooks/` и `services/` — сценарии и логика, `mappers/` — трансформация данных, `parts/` — составные блоки.
 
@@ -160,7 +151,7 @@ src/business/
 
 - Один модуль = один бизнес-домен
 - Циклические зависимости между доменами запрещены
-- Публичный runtime API — через фабрику в корне модуля (`{name}.factory.ts`). `index.ts` экспортирует только фабрику и type-only экспорты
+- Публичный API фабрики — через фабрику в корне модуля (`{name}.factory.ts`). `index.ts` экспортирует только фабрику и type-only экспорты
 - Импорт runtime-кода между доменами — через фабрику. `import type` — напрямую
 - Доменные типы (`User`, `Product`) живут здесь, не в `shared/`
 
@@ -187,6 +178,7 @@ src/infra/
 
 - Один модуль = один техсервис
 - Импортирует `infra/`, `ui/`, `shared/`
+- Не содержит продуктовые composition modules конкретных страниц или маршрутов
 
 ## Слой UI
 
@@ -252,3 +244,4 @@ src/shared/
 ### Требования
 
 - Не имеет runtime-состояния
+- Не знает о продуктовых composition modules

projects/slm-design/canons/architecture/modules.md

@@ -1,6 +1,6 @@
 ---
 title: Модули
-description: Структура модуля, типы (UI, бизнес, инфра), публичный API, отличие модуля от компонента
+description: Структура модуля, типы (композиционный, UI, бизнес, инфра), публичный API, отличие модуля от компонента
 ---
 
 # Модули
@@ -13,7 +13,7 @@ description: Структура модуля, типы (UI, бизнес, инф
 
 Модуль может содержать всё, что нужно этой области: компоненты, вложенные модули, хуки, сторы, сервисы, типы, стили, конфиги и утилиты. Набор сегментов не фиксирован — модуль включает только то, что реально нужно.
 
-Модуль не обязан быть UI-блоком. Это может быть страница, виджет, бизнес-домен, инфраструктурный сервис или UI-kit сущность.
+Модуль не обязан быть UI-блоком. Это может быть page composition, layout composition, screen composition, widget composition, бизнес-домен, инфраструктурный сервис или UI-kit сущность.
 
 Главная граница модуля — не папка, а ответственность.
 
@@ -63,30 +63,62 @@ auth/
 
 Примеры модулей:
 
-- `screens/home/` — модуль страницы.
-- `widgets/page-heading/` — модуль виджета.
+- `compositions/pages/home/` — модуль page composition.
+- `compositions/layouts/main/` — модуль layout composition.
+- `compositions/screens/profile/` — модуль screen composition.
+- `compositions/widgets/page-heading/` — модуль widget composition.
 - `business/auth/` — модуль бизнес-домена.
 - `infra/theme/` — модуль инфраструктурного сервиса.
 - `ui/button/` — модуль UI-kit сущности.
-- `screens/home/parts/hero-section/` — вложенный модуль страницы.
+- `compositions/pages/home/parts/hero-section/` — вложенный модуль page composition.
 
 Не считаются модулями:
 
-- `ui/`, `parts/`, `hooks/`, `types/`, `styles/`, `config/` — это сегменты.
-- `screens/shop/`, `business/commerce/` — это группы, если в них нет `index.ts`.
-- `screens/home/ui/user-card/` — это компонент, если он находится в `ui/` и соблюдает ограничения компонента.
+- `ui/`, `parts/`, `hooks/`, `types/`, `styles/`, `config/`, `providers/` — это сегменты.
+- `compositions/pages/`, `business/commerce/` — это группы, если в них нет `index.ts`.
+- `compositions/pages/home/ui/user-card/` — это компонент, если он находится в `ui/` и соблюдает ограничения компонента.
 
 ## Типы модулей
 
 Тип модуля определяет обязательный корневой файл и стартовую структуру.
 
+### Композиционный модуль
+
+Композиционный модуль — модуль внутри `compositions`, который участвует в сборке страниц, маршрутов и крупных продуктовых частей интерфейса.
+
+Он может быть page, layout, screen, widget, block, entry-point, CMS-entry, route segment или другим типом композиции, выбранным командой.
+
+```text
+compositions/pages/profile/
+├── profile.page.tsx
+├── profile-business-composition.ts
+├── providers/
+├── hooks/
+├── stores/
+├── parts/
+├── types/
+└── index.ts
+```
+
+Композиционный модуль может импортировать другие composition modules через public API. Это отличие слоя `compositions`: внутри него допускается графовая композиция.
+
+При этом deep imports запрещены.
+
+```ts
+// Хорошо
+import { useProfilePageStore } from '@/compositions/pages/profile'
+
+// Плохо
+import { useProfilePageStore } from '@/compositions/pages/profile/hooks/use-profile-page-store.hook'
+```
+
 ### UI-модуль
 
 Модуль строится вокруг основного UI-компонента и обязан иметь основной `.tsx` файл в корне:
 
 ```text
-header/
-├── header.tsx
+button/
+├── button.tsx
 └── index.ts
 ```
 
@@ -94,7 +126,7 @@ header/
 
 ### Бизнес-модуль
 
-Бизнес-модуль — модуль, который строится вокруг публичного runtime API.
+Бизнес-модуль — модуль, который строится вокруг публичного API фабрики.
 
 Бизнес-модуль обязан иметь фабрику в корне:
 
@@ -105,7 +137,7 @@ auth/
 └── types/
 ```
 
-Фабрика возвращает публичный runtime API модуля.
+Фабрика возвращает публичный API модуля для использования в runtime.
 
 ### Инфраструктурный модуль
 
@@ -140,6 +172,7 @@ backend-api/
 ├── {module-name}.tsx            # корневой файл модуля (опционален)
 ├── ui/                          # компоненты модуля
 ├── parts/                       # вложенные модули
+├── providers/                   # провайдеры модуля
 ├── hooks/                       # хуки
 ├── stores/                      # сторы состояния
 ├── services/                    # внешние источники данных
@@ -184,32 +217,49 @@ export type { CustomerDeps } from './types/customer-deps.type'
 export type { CustomerFactory } from './types/customer-factory.type'
 ```
 
+Composition module экспортирует через `index.ts` только безопасный контракт, который нужен другим composition modules или `app`: page/layout/screen/widget, provider, hooks доступа, типы. Внутренние stores, context objects и функции создания состояния не экспортируются без необходимости.
+
+Если layout, screen или widget импортируют hooks из page composition, не смешивайте в одном public API готовую page composition и hooks для дочерних модулей: это может создать runtime-цикл.
+
+```ts
+// compositions/pages/profile/index.ts
+export { ProfilePageProvider } from './providers/profile-page.provider'
+export { useProfilePageStore } from './hooks/use-profile-page-store.hook'
+export { useProfileBusinessComposition } from './hooks/use-profile-business-composition.hook'
+
+export type { ProfilePageState } from './types/profile-page-state.type'
+```
+
 ## Фабрика
 
-Business-модуль всегда экспортирует фабрику. Фабрика лежит в корне модуля (`{name}.factory.ts`), типизируется через `{Name}Factory` и возвращает публичный runtime API модуля.
+Business-модуль всегда экспортирует фабрику. Фабрика лежит в корне модуля (`{name}.factory.ts`), типизируется через `{Name}Factory` и возвращает публичный API фабрики.
 
 Всё, что нужно внешнему коду в runtime, должно быть частью API, который возвращает фабрика.
 
 Модуль без cross-domain зависимостей экспортирует фабрику без аргументов. Модуль с зависимостями — фабрику, принимающую зависимости доменными именами. Типы всегда экспортируются напрямую через `export type` — `import type` не является runtime-зависимостью.
 
-Компоновка фабрик происходит на уровне модуля-потребителя: screen, layout, widget или любой другой модуль группы «Композиция».
+Компоновка фабрик происходит в модуле-потребителе на слое `compositions`.
 
 ### Примеры
 
 Пример реализации фабрики в React см. в [Создание фабрики](/examples/react/factory).
 
-Пример композиции фабрик в React screen-модуле см. в [Композиция фабрик](/examples/react/factory-composition).
+Пример композиции фабрик в React composition module см. в [Композиция фабрик](/examples/react/factory-composition).
 
-Пример композиции фабрик через React Provider см. в [Композиция через Provider](/examples/react/composition-provider).
+Пример page-level Provider в React см. в [Композиция через Provider](/examples/react/composition-provider).
+
+Примеры разных структур слоя `compositions` см. в [Структуры compositions](/examples/react/composition-structures).
 
 ## Жизненный цикл
 
 Модуль рождается на самом низком уровне использования и поднимается выше только при реальной потребности.
 
-- Нужен на одной странице → `screens/{name}/parts/`
-- Появился в 2+ местах → поднимается по природе:
-  - абстрактный UI → `ui/`
-  - блок с данными/логикой → `widgets/`
-  - представление бизнес-домена → `business/{area}/parts/`
+- Нужен одной странице, route branch или крупной продуктовой части интерфейса → внутри соответствующего composition module.
+- Нужен нескольким частям одной страницы → внутри page composition или другого общего composition scope.
+- Нужен нескольким страницам или маршрутам → отдельный composition module внутри `compositions`.
+- Абстрактный UI без бизнес-логики → `ui/`.
+- Представление или сценарий бизнес-домена → `business/{domain}/`.
+- Технический сервис → `infra/`.
+- Общая чистая утилита → `shared/`.
 
 Подъём — обычный рефакторинг в рамках задачи, а не отдельная активность.

projects/slm-design/canons/architecture/monorepo.md

@@ -21,9 +21,7 @@ repo/
 │   ├── web/
 │   │   └── src/
 │   │       ├── app/
-│   │       ├── layouts/
-│   │       ├── screens/
-│   │       ├── widgets/
+│   │       ├── compositions/
 │   │       ├── business/
 │   │       ├── infra/
 │   │       ├── ui/
@@ -78,17 +76,17 @@ packages/shared/
 
 ## Что остаётся в приложении
 
-Слои `app`, `layouts`, `screens`, `widgets` и `business` остаются внутри конкретного приложения.
+Слои `app`, `compositions` и `business` остаются внутри конкретного приложения.
 
 ```text
 apps/web/src/app/
-apps/web/src/layouts/
-apps/web/src/screens/
-apps/web/src/widgets/
+apps/web/src/compositions/
 apps/web/src/business/
 ```
 
-`app`, `layouts` и `screens` привязаны к роутингу, каркасу и страницам конкретного приложения. `widgets` не выносятся в пакеты, потому что это слой композиции интерфейса приложения.
+`app` привязан к фреймворку и entry points приложения.
+
+`compositions` привязан к страницам, маршрутам и крупным продуктовым частям интерфейса конкретного приложения. Этот слой не выносится в `packages/*`, потому что отражает продуктовую сборку приложения.
 
 `business` не выносится в `packages/*`. Домены остаются рядом со сценариями приложения, чтобы не превращать монорепозиторий в общий бизнес-слой.
 
@@ -193,7 +191,7 @@ packages -/→ apps
 Внутри приложения продолжает действовать обычное направление зависимостей SLM.
 
 ```text
-app → [ layouts | screens ] → widgets → business → infra → ui → shared
+app → compositions → business → infra → ui → shared
 ```
 
 Пакеты не должны нарушать природу своей группы: `packages/ui/*` не импортирует `packages/infra/*`, `packages/shared` не импортирует другие группы, а `packages/infra/*` не знает о приложениях.
@@ -206,11 +204,11 @@ app → [ layouts | screens ] → widgets → business → infra → ui → shar
 
 ```text
 # Плохо
-apps/web/src/screens/home/parts/promo-section/
+apps/web/src/compositions/pages/home/parts/promo-section/
 packages/ui/promo-section/
 ```
 
-Если блок нужен только одной странице или отражает продуктовую композицию конкретного приложения, он остаётся локальным `parts/`-модулем.
+Если блок нужен только одной странице или отражает продуктовую композицию конкретного приложения, он остаётся локальным composition module.
 
 ## Конфигурационные пакеты
 
@@ -227,7 +225,7 @@ packages/ui/promo-section/
 - В `packages/infra/*` размещаются пакеты самостоятельных инфраструктурных модулей.
 - `packages/shared` является единым пакетом для переиспользуемых утилит и helpers.
 - Модуль можно размещать в пакете, если он потенциально будет использоваться в двух и более фронтенд-приложениях.
-- `business`, `app`, `layouts`, `screens`, `widgets` не выносятся в пакеты.
+- `app`, `compositions` и `business` не выносятся в пакеты.
 - Проектные стили, типы приложения и продуктовые конфиги не выносятся в `packages/shared`.
 - Пакеты не импортируют приложения.
 - Межпакетные импорты идут только через публичный API.

projects/slm-design/canons/architecture/segments.md

@@ -1,6 +1,6 @@
 ---
 title: Сегменты
-description: Сегменты внутри модуля (ui/, model/, lib/ и др.), назначение и правила размещения файлов
+description: Сегменты внутри модуля (ui/, parts/, hooks/ и др.), назначение и правила размещения файлов
 ---
 
 # Сегменты
@@ -17,6 +17,7 @@ description: Сегменты внутри модуля (ui/, model/, lib/ и д
 |---------|------------|
 | `ui/` | Презентационные компоненты родительского модуля |
 | `parts/` | Вложенные модули со своими сегментами |
+| `providers/` | Провайдеры модуля |
 | `hooks/` | React-хуки |
 | `stores/` | Сторы состояния |
 | `services/` | Работа с внешними источниками данных |
@@ -26,6 +27,8 @@ description: Сегменты внутри модуля (ui/, model/, lib/ и д
 | `lib/` | Утилиты и хелперы модуля |
 | `config/` | Константы и конфигурация |
 
+Сегменты не являются обязательными. Например, `providers/` нужен только модулю, который владеет провайдерами. Если provider, store или guard относится к конкретной странице или маршруту, он размещается внутри соответствующего composition module, а не в `infra` или `shared`.
+
 ## Сегмент ui/
 
 Презентационные компоненты родительского модуля. `ui/` содержит только компоненты, которые отвечают за отображение части интерфейса и не выходят за границы своего модуля.
@@ -72,7 +75,7 @@ user/
 Вложенные модули со своими сегментами. `parts/` содержит только модули: каждый элемент `parts/` — папка полноценного модуля с собственным публичным API. Отдельные `.tsx`, стили, хуки или произвольные файлы в `parts/` не размещаются.
 
 ```text
-home/
+compositions/pages/home/
 ├── parts/
 │   ├── hero-section/
 │   │   ├── hero-section.tsx
@@ -86,7 +89,7 @@ home/
 │       ├── features-section.tsx
 │       ├── hooks/
 │       └── index.ts
-├── home.screen.tsx
+├── home.page.tsx
 └── index.ts
 ```
 
@@ -96,6 +99,18 @@ home/
 
 Если вложенный модуль обрастает своими `parts/` — это сигнал, что он достаточно самостоятельный для подъёма на уровень выше.
 
+## Сегмент providers/
+
+Провайдеры модуля: React Context providers, провайдеры scope-состояния, провайдеры композиции фабрик или другие обёртки, которые принадлежат модулю.
+
+```text
+providers/
+├── profile-page.provider.tsx
+└── profile-business-composition.provider.tsx
+```
+
+Provider размещается в том модуле, который владеет соответствующим состоянием или композицией. Page-level provider живёт в page composition module; application-level provider, завязанный на фреймворк, подключается в `app`, но реализуется в нижнем подходящем слое.
+
 ## Сегмент hooks/
 
 React-хуки модуля. Инкапсулируют логику, состояние, подписки, побочные эффекты.
@@ -117,6 +132,8 @@ stores/
 └── session.store.ts
 ```
 
+Стор размещается в модуле-владельце. Если состояние нужно всей странице, оно живёт в page composition module. Если состояние относится к бизнес-домену, оно живёт в business-модуле.
+
 ## Сегмент services/
 
 Работа с внешними источниками данных: API-вызовы, запросы, подписки.

projects/slm-design/canons/examples/react/composition-provider.md

@@ -0,0 +1,286 @@
+---
+title: Композиция через Provider
+description: Пример page-level Provider для composition modules в React-проекте
+---
+
+# Композиция через Provider
+
+Раздел показывает, как page composition может владеть provider, store и business composition, которые нужны layout, screen и другим composition modules.
+
+## Идея
+
+Page composition хранит состояние и композицию бизнес-доменов на уровне страницы. Layout и screen не импортируют друг друга: они получают доступ к page-level данным через публичный API page composition.
+
+В примере page composition владеет scope-контрактом страницы, но не экспортирует готовый `ProfilePage`, потому что layout и screen импортируют hooks из `pages/profile`. Дерево страницы собирается в `app` или в отдельном entry-point composition module.
+
+## Принципы
+
+1. **Владение.** Page-level store, provider и business composition принадлежат page composition module.
+2. **Обычные сегменты.** Provider, hooks, stores и types лежат в обычных сегментах модуля: `providers/`, `hooks/`, `stores/`, `types/`.
+3. **Публичный контракт.** Page composition экспортирует только безопасные hooks, provider и типы, которые нужны другим composition modules или `app`.
+4. **Сборка снаружи business.** Business-модули не используют page-level providers. Cross-domain зависимости передаются только через аргументы фабрики.
+5. **Без deep imports.** Layout и screen импортируют hooks только из public API page composition.
+
+## Структура модулей
+
+```text
+compositions/pages/profile/
+├── profile-business-composition.ts
+├── providers/
+│   └── profile-page.provider.tsx
+├── hooks/
+│   ├── use-profile-page-store.hook.ts
+│   └── use-profile-business-composition.hook.ts
+├── stores/
+│   └── profile-page.store.ts
+├── types/
+│   └── profile-page-state.type.ts
+└── index.ts
+
+compositions/layouts/profile-main/
+├── profile-main.layout.tsx
+└── index.ts
+
+compositions/screens/profile/
+├── profile.screen.tsx
+└── index.ts
+```
+
+## Тип состояния страницы
+
+Файл: `compositions/pages/profile/types/profile-page-state.type.ts`.
+
+```ts
+export type ProfilePageState = {
+  title: string
+  isSidebarOpen: boolean
+  setSidebarOpen: (value: boolean) => void
+}
+```
+
+## Store страницы
+
+Файл: `compositions/pages/profile/stores/profile-page.store.ts`.
+
+```ts
+import { createStore } from 'zustand/vanilla'
+import type { ProfilePageState } from '../types/profile-page-state.type'
+
+export const createProfilePageStore = () =>
+  createStore<ProfilePageState>((set) => ({
+    title: 'Profile',
+    isSidebarOpen: false,
+    setSidebarOpen: (value) => set({ isSidebarOpen: value }),
+  }))
+```
+
+`createProfilePageStore` не экспортируется через public API модуля. Это внутренняя деталь создания состояния.
+
+## Business composition страницы
+
+Файл: `compositions/pages/profile/profile-business-composition.ts`.
+
+```ts
+import { authFactory } from '@/business/auth'
+import { profileFactory } from '@/business/profile'
+
+export const createProfileBusinessComposition = () => {
+  const auth = authFactory()
+  const profile = profileFactory({ auth })
+
+  return { auth, profile }
+}
+```
+
+Business composition собирается на слое `compositions`, а не внутри business-модулей.
+
+## Provider страницы
+
+Файл: `compositions/pages/profile/providers/profile-page.provider.tsx`.
+
+```tsx
+import { createContext, useRef, type ReactNode } from 'react'
+import type { StoreApi } from 'zustand/vanilla'
+import { createProfileBusinessComposition } from '../profile-business-composition'
+import { createProfilePageStore } from '../stores/profile-page.store'
+import type { ProfilePageState } from '../types/profile-page-state.type'
+
+type ProfileBusinessComposition = ReturnType<typeof createProfileBusinessComposition>
+
+type ProfilePageProviderValue = {
+  store: StoreApi<ProfilePageState>
+  business: ProfileBusinessComposition
+}
+
+export const ProfilePageContext = createContext<ProfilePageProviderValue | null>(null)
+
+type Props = {
+  children: ReactNode
+}
+
+export const ProfilePageProvider = ({ children }: Props) => {
+  const valueRef = useRef<ProfilePageProviderValue | null>(null)
+
+  if (!valueRef.current) {
+    valueRef.current = {
+      store: createProfilePageStore(),
+      business: createProfileBusinessComposition(),
+    }
+  }
+
+  return (
+    <ProfilePageContext.Provider value={valueRef.current}>
+      {children}
+    </ProfilePageContext.Provider>
+  )
+}
+```
+
+Context object остаётся технической деталью provider и не должен использоваться внешними модулями напрямую. Наружу экспортируются hooks доступа.
+
+## Hooks доступа
+
+Файл: `compositions/pages/profile/hooks/use-profile-page-store.hook.ts`.
+
+```ts
+import { useContext } from 'react'
+import { useStore } from 'zustand'
+import { ProfilePageContext } from '../providers/profile-page.provider'
+import type { ProfilePageState } from '../types/profile-page-state.type'
+
+export const useProfilePageStore = <T,>(selector: (state: ProfilePageState) => T) => {
+  const ctx = useContext(ProfilePageContext)
+
+  if (!ctx) {
+    throw new Error('useProfilePageStore must be used within ProfilePageProvider')
+  }
+
+  return useStore(ctx.store, selector)
+}
+```
+
+Файл: `compositions/pages/profile/hooks/use-profile-business-composition.hook.ts`.
+
+```ts
+import { useContext } from 'react'
+import { ProfilePageContext } from '../providers/profile-page.provider'
+
+export const useProfileBusinessComposition = () => {
+  const ctx = useContext(ProfilePageContext)
+
+  if (!ctx) {
+    throw new Error('useProfileBusinessComposition must be used within ProfilePageProvider')
+  }
+
+  return ctx.business
+}
+```
+
+## Layout использует page-level store
+
+Файл: `compositions/layouts/profile-main/profile-main.layout.tsx`.
+
+```tsx
+import type { ReactNode } from 'react'
+import { useProfilePageStore } from '@/compositions/pages/profile'
+
+type Props = {
+  children: ReactNode
+}
+
+export const ProfileMainLayout = ({ children }: Props) => {
+  const title = useProfilePageStore((state) => state.title)
+  const isSidebarOpen = useProfilePageStore((state) => state.isSidebarOpen)
+
+  return (
+    <div data-sidebar-open={isSidebarOpen}>
+      <header>{title}</header>
+      <main>{children}</main>
+    </div>
+  )
+}
+```
+
+Layout импортирует hook из public API page composition. Он не импортирует screen и не лезет во внутренние файлы `pages/profile`.
+
+## Screen использует business composition
+
+Файл: `compositions/screens/profile/profile.screen.tsx`.
+
+```tsx
+import { useProfileBusinessComposition } from '@/compositions/pages/profile'
+
+export const ProfileScreen = () => {
+  const { profile } = useProfileBusinessComposition()
+  const { useCurrentProfile, ProfileCard } = profile
+  const currentProfile = useCurrentProfile()
+
+  return <ProfileCard profile={currentProfile} />
+}
+```
+
+Screen получает готовые доменные API из page composition и не собирает граф фабрик самостоятельно.
+
+## Публичный API page composition
+
+Файл: `compositions/pages/profile/index.ts`.
+
+```ts
+export { ProfilePageProvider } from './providers/profile-page.provider'
+export { useProfilePageStore } from './hooks/use-profile-page-store.hook'
+export { useProfileBusinessComposition } from './hooks/use-profile-business-composition.hook'
+
+export type { ProfilePageState } from './types/profile-page-state.type'
+```
+
+Внутренние `createProfilePageStore`, `createProfileBusinessComposition` и `ProfilePageContext` не экспортируются через public API.
+
+Если нужен готовый `ProfilePage`, его лучше собрать в отдельном entry-point composition module или прямо в роутере. Не смешивайте в одном public API и готовую page composition, и hooks, которые импортируют её дочерние layout/screen modules: это может создать runtime-цикл.
+
+## Подключение в app
+
+В React Router можно собрать дерево прямо в route config:
+
+```tsx
+import { ProfilePageProvider } from '@/compositions/pages/profile'
+import { ProfileMainLayout } from '@/compositions/layouts/profile-main'
+import { ProfileScreen } from '@/compositions/screens/profile'
+
+export const profileRoute = {
+  path: '/profile',
+  element: (
+    <ProfilePageProvider>
+      <ProfileMainLayout>
+        <ProfileScreen />
+      </ProfileMainLayout>
+    </ProfilePageProvider>
+  ),
+}
+```
+
+В Next App Router композиция может быть физически разложена по файлам `app`, но реализация остаётся в `compositions`.
+
+```tsx
+// app/(profile)/layout.tsx
+import { ProfilePageProvider } from '@/compositions/pages/profile'
+import { ProfileMainLayout } from '@/compositions/layouts/profile-main'
+
+export default function Layout({ children }: { children: React.ReactNode }) {
+  return (
+    <ProfilePageProvider>
+      <ProfileMainLayout>{children}</ProfileMainLayout>
+    </ProfilePageProvider>
+  )
+}
+```
+
+```tsx
+// app/(profile)/page.tsx
+import { ProfileScreen } from '@/compositions/screens/profile'
+
+export default function Page() {
+  return <ProfileScreen />
+}
+```
+
+`app` размещает готовые composition modules по правилам фреймворка, но не реализует их внутри себя.

projects/slm-design/canons/examples/react/composition-structures.md

@@ -0,0 +1,73 @@
+---
+title: Структуры compositions
+description: Примеры организации слоя compositions под разные способы сборки React-приложения
+---
+
+# Структуры compositions
+
+Раздел показывает, что SLM не фиксирует жёсткую структуру внутри `compositions`. Команда выбирает организацию под фреймворк, роутинг, CMS и продуктовую задачу.
+
+## Базовая рекомендация
+
+Подходит для большинства приложений, где есть явные страницы, layouts, screens и переиспользуемые композиционные блоки.
+
+```text
+src/compositions/
+├── pages/
+│   ├── home/
+│   └── profile/
+├── layouts/
+│   ├── main/
+│   └── dashboard/
+├── screens/
+│   ├── home/
+│   └── profile/
+└── widgets/
+    ├── page-heading/
+    └── promo-banner/
+```
+
+`pages`, `layouts`, `screens` и `widgets` здесь не являются отдельными SLM-слоями. Это типы composition modules внутри одного слоя `compositions`.
+
+## Entry-points и blocks
+
+Подходит для проектов, где точка сборки не всегда является страницей: CMS registry, embedded UI, route entries, feature entries.
+
+```text
+src/compositions/
+├── entry-points/
+│   ├── cms-profile/
+│   └── embedded-checkout/
+├── pages/
+│   └── profile/
+├── layouts/
+│   └── profile-main/
+├── screens/
+│   └── profile/
+└── blocks/
+    ├── profile-summary/
+    └── recommended-products/
+```
+
+## Группировка вокруг продукта
+
+Подходит, когда удобнее держать все части одной крупной области рядом.
+
+```text
+src/compositions/
+└── profile/
+    ├── page/
+    ├── layout/
+    ├── screen/
+    └── blocks/
+```
+
+## Главное правило
+
+Любая структура допустима, если соблюдаются границы слоя:
+
+- `app` подключает готовые composition modules к фреймворку.
+- `compositions` может импортировать `business`, `infra`, `ui`, `shared`.
+- `business`, `infra`, `ui`, `shared` не импортируют `compositions`.
+- Импорты между composition modules идут только через public API.
+- Deep imports внутрь composition modules запрещены.

projects/slm-design/canons/examples/react/factory-composition.md

@@ -0,0 +1,54 @@
+---
+title: Композиция фабрик
+description: Пример композиции business-фабрик на уровне composition module в React-проекте
+---
+
+# Композиция фабрик
+
+Раздел показывает, как собрать API нескольких business-модулей в React composition module. Пример подходит для простой композиции, когда page composition сама является точкой использования доменов.
+
+## Идея
+
+Композиция фабрик выполняется в модуле-потребителе на слое `compositions`: page, layout, screen, widget или другом composition module.
+
+Business-модули не импортируют runtime-код друг друга напрямую, а cross-domain зависимости получают только через аргументы фабрик.
+
+## Структура page composition
+
+```text
+compositions/pages/home/
+├── home.page.tsx
+└── index.ts
+```
+
+## Сборка фабрик
+
+Файл: `compositions/pages/home/home.page.tsx`.
+
+```tsx
+import { customerFactory } from '@/business/customer'
+import { orderFactory } from '@/business/order'
+
+const customer = customerFactory()
+const order = orderFactory({ customer })
+
+const { useOrder, OrderCard } = order
+
+export const HomePage = () => {
+  const currentOrder = useOrder()
+
+  return <OrderCard order={currentOrder} />
+}
+```
+
+`customerFactory` создаётся первой, потому что `orderFactory` зависит от части API домена `customer`. Модуль `order` не импортирует `customer` в runtime — зависимость передаётся снаружи.
+
+## Публичный API page composition
+
+Файл: `compositions/pages/home/index.ts`.
+
+```ts
+export { HomePage } from './home.page'
+```
+
+Page composition экспортирует только собственный публичный API. Собранные экземпляры business API остаются деталями реализации модуля.

projects/slm-design/canons/examples/react/factory.md

@@ -5,7 +5,7 @@ description: Пример создания фабрики business-модуля
 
 # Создание фабрики
 
-Раздел показывает, как оформить фабрику business-модуля в React-проекте: описать публичный API, зависимости и функцию, возвращающую runtime API.
+Раздел показывает, как оформить фабрику business-модуля в React-проекте: описать публичный API, зависимости и функцию, возвращающую API фабрики.
 
 ## Структура business-модуля
 
@@ -25,7 +25,7 @@ business/customer/
 
 ## Тип публичного API
 
-Публичный API описывает runtime-возможности, которые модуль отдаёт потребителям: хуки, компоненты и сценарные методы.
+Публичный API описывает возможности, которые модуль отдаёт потребителям через фабрику: хуки, компоненты и сценарные методы.
 
 ```ts
 // business/customer/types/customer-api.type.ts

projects/slm-design/docs/.vitepress/config.ts

@@ -1,7 +1,7 @@
 import { defineConfig } from 'vitepress';
 import taskLists from 'markdown-it-task-lists';
 import llmstxt from 'vitepress-plugin-llms';
-import { themeSyncHead } from '../../shared/vitepress/themeHead';
+import { themeSyncHead } from '../../../_shared/docs/vitepress/themeHead';
 import { sidebar, site } from '../docs.config';
 
 export default defineConfig({

projects/slm-design/docs/.vitepress/theme/index.ts

@@ -0,0 +1 @@
+export { default } from '../../../../_shared/docs/vitepress/theme';

projects/slm-design/docs/docs.config.ts

@@ -2,26 +2,27 @@ export const site = {
   title: 'SLM Design',
   description: 'Каноны архитектуры SLM Design',
   base: '/slm-design/',
-  outDir: '../../public/slm-design',
+  outDir: '../../../public/slm-design',
 };
 
 /**
  * Карта монтирования исходных канонов в VitePress-документацию.
  *
  * `source` указывает на markdown-файл внутри `canons/`.
- * `target` задаёт путь, по которому этот файл попадёт в `docs/slm-design/content/`
+ * `target` задаёт путь, по которому этот файл попадёт в `docs/content/`
  * и станет страницей итоговой документации.
  */
 export const mounts = [
-  { target: 'index.md', source: 'slm-design/architecture/index.md' },
-  { target: 'architecture/index.md', source: 'slm-design/architecture/index.md' },
-  { target: 'architecture/layers.md', source: 'slm-design/architecture/layers.md' },
-  { target: 'architecture/modules.md', source: 'slm-design/architecture/modules.md' },
-  { target: 'architecture/segments.md', source: 'slm-design/architecture/segments.md' },
-  { target: 'architecture/monorepo.md', source: 'slm-design/architecture/monorepo.md' },
-  { target: 'examples/react/factory.md', source: 'slm-design/examples/react/factory.md' },
-  { target: 'examples/react/factory-composition.md', source: 'slm-design/examples/react/factory-composition.md' },
-  { target: 'examples/react/composition-provider.md', source: 'slm-design/examples/react/composition-provider.md' },
+  { target: 'index.md', source: 'canons/architecture/index.md' },
+  { target: 'architecture/index.md', source: 'canons/architecture/index.md' },
+  { target: 'architecture/layers.md', source: 'canons/architecture/layers.md' },
+  { target: 'architecture/modules.md', source: 'canons/architecture/modules.md' },
+  { target: 'architecture/segments.md', source: 'canons/architecture/segments.md' },
+  { target: 'architecture/monorepo.md', source: 'canons/architecture/monorepo.md' },
+  { target: 'examples/react/factory.md', source: 'canons/examples/react/factory.md' },
+  { target: 'examples/react/factory-composition.md', source: 'canons/examples/react/factory-composition.md' },
+  { target: 'examples/react/composition-provider.md', source: 'canons/examples/react/composition-provider.md' },
+  { target: 'examples/react/composition-structures.md', source: 'canons/examples/react/composition-structures.md' },
 ];
 
 export const sidebar = [
@@ -41,6 +42,7 @@ export const sidebar = [
       { text: 'Создание фабрики', link: '/examples/react/factory' },
       { text: 'Композиция фабрик', link: '/examples/react/factory-composition' },
       { text: 'Композиция через Provider', link: '/examples/react/composition-provider' },
+      { text: 'Структуры compositions', link: '/examples/react/composition-structures' },
     ],
   },
 ];

projects/slm-design/project.config.ts

@@ -0,0 +1,5 @@
+export default {
+  slug: 'slm-design',
+  docsDir: 'docs',
+  archive: true,
+} as const;