Letar

---
name: letar
description: Воркфлоу верхнего уровня для задач по всему монорепо letar — инфра, общие библиотеки, релизы
allowed-tools: Bash(nx run-many -t format:*), Bash(nx lint:*), Bash(nx typecheck:*), Bash(nx affected:*), Bash(nx release:*), Bash(git add:*), Bash(git commit:*)
---

# Letar - Воркфлоу монорепо (весь репозиторий)

Команда верхнего уровня для работы со **всем монорепо** `letar`, а не с одним приложением.
Используй, когда задача охватывает несколько проектов, инфраструктуру, общие библиотеки
или когда ещё не выбрано конкретное приложение.

## Инициализация

1. Зарегистрируйся в координации агентов под фиксированным именем `letar-dev`
   (токен — в памяти `agent_fixed_names_tokens.md`, таблица «Приложение → agent_name → registration_token»):

   ```
   macro_start_session(
     human_key: "C:/web/letar",
     program: "claude-code",
     model: "claude-sonnet-5",
     agent_name: "letar-dev",
     registration_token: "<токен из agent_fixed_names_tokens.md>",
     task_description: "Монорепо-задача: <что делаешь>"
   )
   ```

2. Прочитай `AGENTS.md` в корне — главные инструкции и стек.
3. Вызови MCP `nx_workspace` — получи актуальную карту проектов, портов и графа зависимостей.
4. При необходимости загляни в `.claude/docs/repo-structure.md` ⭐ (публичный репо + приватные submodules).

## Действия

После изучения контекста:

- Определи, каких проектов/библиотек касается задача (`nx_project_details`, `nx affected`).
- Если задача относится к одному приложению — переключись на его команду (`/kami`, `/driving-school`, …).
- Если задача сквозная (libs, инфра, документация, релизы) — спланируй порядок изменений.
- Перед редактированием `libs/**` проверь резервации файлов через Agent Mail.
- Предложи план действий и согласуй с пользователем.

## Качество (перед коммитом)

```
nx run-many -t format --projects=<затронутые проекты> → nx lint → nx typecheck:tsgo
```

⚠️ **Никогда не запускай голую `nx format`/`nx format:write`** — это встроенная команда Nx,
жёстко зашитая на Prettier, конфликтующий с dprint (единственным форматтером репозитория, см.
корневой `AGENTS.md`). Всегда `nx run-many -t format --projects=<...>` — кастомный таргет,
вызывающий `dprint fmt`.

Для сквозных изменений запускай по затронутым проектам:

```
nx affected -t lint typecheck:tsgo test
```

⚠️ `nx` и `bun` — глобальные (❌ НЕ `bunx nx` / `npx nx`).

## После завершения задачи

1. Затронутые проекты с `tasks/` — закрой задачу: `bun scripts/tasks.mjs done <ID> --summary "…"`. Остальные — отметь задачи выполненными в `PLAN.md`.
2. Обнови `CHANGELOG.md` там, где он ведётся; `PLAN_COMPLETED.md` — только в проектах без `tasks/`.
3. Подними версию в `package.json` затронутых проектов (semver).
4. Для изменений в `libs/**` — обнови README библиотеки и затронутые `.claude/docs/`.
5. Закоммить логически связанные изменения (см. `.claude/rules/git.md`).

⚠️ В монорепо одновременно работают несколько агентов — добавляй **только свои файлы**
(перечисляй конкретные файлы: `git add <файлы>` и `git commit -- <файлы>`, не каталоги), без `git add .` и без `git reset`.

## Приватные submodules

Приватные приложения и их e2e/db-пакеты — git submodules (актуальный список:
`git config -f .gitmodules --get-regexp path`).
Изменения: коммит/пуш **внутри submodule** → `git add <path> && git commit` в `letar`
для фиксации SHA. Подробнее: `.claude/rules/git.md`, `.claude/docs/repo-structure.md`.

## Релиз npm-пакетов

Локально: `nx release` (bump + changelog + commit + tag) → `git push --follow-tags`.
CI по тегу (`forms-v*`, `form-mcp-v*`, `zenstack-form-plugin-v*`) публикует в npm.

## Деплой

Запрещено деплоить самостоятельно — см. `.claude/rules/app-workflow.md`.

## Репозиторий

**Монорепо:** letar (публичный) + приватные приложения/lib через git submodules (список — `.gitmodules`)
**Стек:** Node 24 · Nx 23 · Next.js 16 · React 19 · Chakra UI v3 · PostgreSQL + Prisma + ZenStack · @letar/forms + Zod v4
**Воркфлоу приложений:** скилы `.agents/skills/<app>/` (`/kami`, `/driving-school`, `/aboi`, …)
**Сквозные команды:** `/workflow:*`, `/infra:*`, `/audit:*`, `/create:*`