FDA

Fractal Domain Architecture — архитектура для приложений на метафреймворках вроде SvelteKit, Next.js и Nuxt.

Код организуется вокруг бизнес-доменов, а не вокруг технических типов файлов. Внутри каждого домена — одинаковый набор слоёв и контрактов, и эта структура повторяется от компонента до приложения.

Что это

По мере роста проекта код, разложенный по техническим папкам (components/, hooks/, utils/), превращается в кашу: логика одной фичи размазана по всему проекту, и «где лежит корзина» не отвечает никто. FDA разворачивает организацию вокруг бизнеса — код живёт в доменах cart, auth, dashboard, и у каждого одинаковая внутренняя структура:

• Фрактальность — одинаковая структура на всех уровнях: компонент → подмодуль → домен → приложение.
• Слои — внутри домена данные проходят один путь: repo → model → RPC → контроллер → UI, импорты смотрят только вниз.
• Явные контракты — каждый файл имеет одну роль и один набор экспортов.
• Framework-agnostic — SvelteKit, Next.js и Nuxt различаются именами файлов роутинга, но не структурой.

Для лендингов и прототипов FDA избыточна. Архитектура окупается на проектах среднего размера и выше, где бизнес-домены различимы и проект живёт дольше одного спринта.

Как выглядит домен

src/routes/cart/          # домен «корзина»
├── +page.svelte          # UI: разметка
├── +page.server.ts       # server load и actions
├── stores.ts             # контроллер: реактивное состояние
├── rpc.ts                # API для других доменов
├── model.server.ts       # операции с данными
└── items/                # подмодуль — та же структура внутри

Каждый файл имеет контракт: model.server.ts — только операции с данными, types.ts — только типы, policy.ts — только правила доступа. Домены общаются между собой только через rpc.ts соседа — остальное считается внутренностями и можно менять, не спрашивая соседей. Живой разбор домена cart — в документации.

Документация

Публикуется на https://fda-docs.vercel.app:

1. Введение — зачем нужна FDA и для каких проектов подходит
2. Основные концепции — фрактальность, слои, контракты
3. Структура проекта — дерево каталогов и «куда положить код»
4. Домены и подмодули — уровни вложенности и взаимодействие модулей
5. Контракты файлов — роль каждого файла с примерами из живого кода
6. FAQ и чеклист — проверка модуля перед мержем
7. Скилл для AI-агентов — правила FDA для Qwen Code, Claude Code и других

Скилл для AI-агентов

FDA доступна как устанавливаемый скилл по кросс-агентному стандарту .agents/skills:

mkdir -p .agents/skills/fda

Скопируйте полный текст скилла в .agents/skills/fda/SKILL.md и перезапустите сессию агента. После установки агент собирает домены по контракту, ловит нарушения слоёв на ревью и адаптирует правила под ваш стек.

Примеры

Приложение	Фреймворк	Статус
apps/example-sveltekit	SvelteKit	✅ домен cart
apps/example-next	Next.js	🚧 в работе
apps/example-nuxt	Nuxt	🚧 в работе

Быстрый старт

git clone https://github.com/chord-ts/fda.git
cd fda
pnpm install

pnpm dev                              # документация
pnpm --filter example-sveltekit dev   # пример корзины

Лицензия

MIT © Din Dmitriy