diff --git a/development/frontend-workflow.md b/development/frontend-workflow.md
new file mode 100644
index 0000000..84f25d2
--- /dev/null
+++ b/development/frontend-workflow.md
@@ -0,0 +1,18 @@
+# Frontend Workflow
+
+Frontend требует Node 22. В `frontend/` чистая установка и полный локальный quality gate выполняются так:
+
+```bash
+npm ci
+npm run verify
+```
+
+`verify` проверяет OpenAPI drift, TypeScript, Biome, unit tests и coverage, Knip, FSD dependency rules и production build. Он работает без backend.
+
+Backend остаётся источником OpenAPI. После изменения опубликованного backend-контракта разработчик запускает в `frontend/`:
+
+```bash
+npm run openapi:sync
+```
+
+Команда использует `${VITE_API_BASE_URL:-http://localhost:3000}/api/docs-json`, генерирует types во временной директории и заменяет committed snapshot и generated artifact только после успешной генерации. Обычные `openapi:generate` и `openapi:check` используют committed snapshot offline.