@bonesofspring/ai-rules 0.1.36 → 0.1.39

package/presets/cursor/next/rules/technical-retro.mdc

@@ -1,58 +1,12 @@
 ---
-description: Роль агента для проведения технического ретроспективы (retro) команды / спринта
+description: Роль агента для проведения технического ретроспективы (retro) команды / спринта. On-demand — предпочтительнее slash-команда /technical-retro.
 alwaysApply: false
 ---
 
-# Техническое ретро — роль агента
+# Техническое ретро — rule alias
 
-Агент выступает как **нейтральный фасилитатор технической ретроспективы**, а не как ревьюер кода или оценщик людей. Цель — вынести уроки, согласовать действия и улучшить процесс разработки.
+Полный сценарий (включая блок **«Работа агентов»** для slug из `.cursor/team/tasks/`) — в slash-комmand:
 
-## Когда включать
+**`.cursor/commands/technical-retro.md`** → `/technical-retro`
 
-- Пользователь просит: «ретро», «техническое ретро», «разбор спринта/итерации», «что пошло хорошо / плохо», «action items после релиза».
-- Есть контекст: период (спринт, квартал), тема (релиз, инцидент, миграция), или приложены заметки/линки.
-
-## Входные данные (запросить при нехватке)
-
-- **Период и фокус** (например: две недели, релиз X, постмортем).
-- **Участники/роли** (если важно для формулировок): только разработка или весь кросс‑функциональный поток.
-- **Ограничения**: время (15 / 30 / 60 мин), формат (async в чате vs синхронная повестка).
-- По желанию: список deliverables, метрики, ссылки на тикеты/MR — **без выдумывания** фактов, которых нет в сообщении или репозитории.
-
-Если контекста мало — задать **1–3 коротких уточняющих вопроса**, затем продолжить с явными допущениями в шапке вывода.
-
-## Принципы фасилитации
-
-- **Безопасность и нейтральность**: формулировки про процесс и систему, не про «виноватых»; избегать ярлыков к людям.
-- **Конкретика**: от абстрактного «надо лучше общаться» — к наблюдаемым событиям и договорённостям.
-- **Баланс**: зафиксировать и позитив (что усилить), и зоны роста.
-- **Один владелец и срок** у каждого action item; избегать списка «сделает команда» без имени/роли.
-- **Не смешивать с code review**: ретро не заменяет построчный разбор диффа; при запросе «и ретро, и ревью» — развести два блока в ответе.
-
-## Рекомендуемая структура сессии (по умолчанию)
-
-Подстроить под указанное время. Для короткого async‑формата — сжать до шагов 2–4.
-
-1. **Цель и рамки** (1–2 предложения): зачем встреча, что в фокусе / что вне скоупа.
-2. **Сбор фактов** (молча в чате — списком от пользователя; агент структурирует):
-   - что шло хорошо,
-   - что мешало / вызывало риски,
-   - сюрпризы (технический долг, узкие места, зависимости).
-3. **Группировка тем**: объединить дубли, выделить 3–7 тем для обсуждения (приоритет — влияние × изменяемость).
-4. **Корневые причины (легко)**: для 1–2 самых болезненных тем — кратко «5 почему» или «что в процессе/артефактах позволило этому случиться», без морализаторства.
-5. **Эксперименты на следующий цикл**: не больше 1–3 изменений процесса/инструментов; каждое — измеримое или с явным критерием «успех/не успех».
-6. **Action items**: таблица или список с **что / владелец / до когда / как поймём, что сработало**.
-
-## Формат ответа агента
-
-- Краткая **шапка**: период, фокус, допущения (если были).
-- **Повестка** или итог по этапам выше.
-- **Темы** — буллеты; по спорным местам — **вопросы команде**, а не окончательные выводы без данных.
-- **Решения и эксперименты** отдельным блоком.
-- **Action items** — в конце, каждый пункт с владельцем и дедлайном (или пометка «нужно назначить на встрече»).
-
-## Ограничения
-
-- Не приписывать команде цитаты или факты, которых не было во входе.
-- Не выдавать юридические/HR‑рекомендации; при явных конфликтах или токсичности — мягко предложить эскалацию человеку, ответственному за команду, без детализации «наказаний».
-- Если пользователь просит только шаблон — выдать **шаблон повестки и доски** (колонки, таймбоксы) без выдуманного контента.
+Используй rule только если command недоступен. Не дублируй содержимое command в ответе — следуй command-файлу.

package/presets/cursor/next/rules/tests-unit.mdc

@@ -15,6 +15,7 @@ alwaysApply: false
 - **Именование unit‑тестов** (строки в `describe` / `it` / `test`):
   - формулировки **только на русском языке** — понятные бизнес‑фразы (что проверяется и какой ожидается результат);
   - **каждое предложение** в названии **начинается с заглавной буквы** (в том числе после `.`, `!`, `?` и при нескольких предложениях в одной строке); первая буква всей строки — тоже заглавная.
+  - **Проверка в CI:** ESLint (`jest/valid-title` в `app/eslint.config.mjs`) требует, чтобы строка начиналась с русской заглавной (А–Я, Ё), и запрещает пробел после точки, за которым сразу идёт строчная буква (типичный случай нарушения «с заглавной после точки»).
 
 ```typescript
 // ✅ Хорошо

package/presets/cursor/next/rules/types-public-imports.mdc

@@ -27,3 +27,4 @@ import { TransportError } from '@/types/TransportError'
 ```
 
 При ревью и правках кода **не добавлять** новые импорты типов из `@/types/...` кроме `@/types` и `@/types/enums`.
+- Новые публичные типы — реэкспорт в `app/src/types/index.ts` по **`layer-barrel-exports.mdc`**.

package/presets/cursor/next/team/README.md

@@ -0,0 +1,106 @@
+# Agent team artifacts
+
+Каталог артефактов пайплайна «команда агентов» Cursor.
+
+## Layout
+
+```
+.cursor/team/
+  active-task.json              # { "slug": "current-task-slug" }
+  tasks/
+    <slug>/
+      pipeline.json             # Router: intent, steps, humanGates
+      status.json               # Current step and state machine
+      brief.md                  # Analyst: Definition of Ready
+      decomposition.md          # Analyst: task breakdown
+      debug-report.md           # Debugger (bugfix)
+      architecture.md           # Solution architect (spike / complex)
+```
+
+## Slug
+
+- kebab-case, derived from task title
+- max 48 characters
+- example: `order-history-date-filter`
+
+## pipeline.json schema
+
+```json
+{
+  "slug": "order-history-date-filter",
+  "intent": "feature",
+  "summary": "Add date filter to Order History",
+  "steps": [
+    { "agent": "task-analyst", "label": "Clarify and decompose" },
+    { "agent": "feature-developer", "label": "Implement" },
+    { "agent": "code-reviewer", "label": "Code review" },
+    { "agent": "qa-tester", "label": "Tests", "scope": "full" }
+  ],
+  "humanGates": ["after:task-analyst"],
+  "autoChain": true,
+  "skipped": []
+}
+```
+
+### intent values
+
+`feature` | `bugfix` | `review-only` | `test-only` | `refactor` | `spike` | `retro`
+
+## status.json schema (pipeline mode)
+
+```json
+{
+  "slug": "order-history-date-filter",
+  "intent": "feature",
+  "pipelineIndex": 0,
+  "currentAgent": "task-analyst",
+  "phase": "executing",
+  "state": "in_progress",
+  "awaitingHumanGate": false,
+  "updatedAt": "2026-05-29T12:00:00.000Z"
+}
+```
+
+### phase
+
+| Value | Description |
+|-------|-------------|
+| `executing` | Pipeline step in progress (preferred) |
+| `analysis` | Legacy: analyst phase |
+| `development` | Legacy: developer phase |
+| `review` | Legacy: review phase |
+| `testing` | Legacy: QA phase |
+| `done` | All steps complete |
+
+### state
+
+| Value | Description |
+|-------|-------------|
+| `in_progress` | Current step running |
+| `completed` | Current step finished |
+| `awaiting_approval` | Human gate; use `/task-continue` |
+| `changes_requested` | Reviewer requires fixes |
+| `approved` | Legacy: approved via continue |
+
+## Git
+
+Commit task artifacts if you want them to survive `ai-rules clean cursor`. Alternatively copy finished tasks to `docs/agent-workflow/tasks/<slug>/`.
+
+## Workflow entry
+
+```bash
+/task <описание задачи>
+# при human gate после analyst:
+/task-continue <slug>
+# или
+/feature-continue <slug>
+# после пайплайна:
+/technical-retro <slug>
+```
+
+Legacy:
+
+```bash
+/feature-start <описание>
+/feature-continue <slug>
+```