@bonesofspring/ai-rules 0.2.2 → 0.2.3

package/presets/cursor/ios-swift/agents/xcuitest-test-planner.md

@@ -0,0 +1,67 @@
+---
+name: xcuitest-test-planner
+description: XCUITest planning specialist. Use when the task is to create or update UI test scenarios, *.cases.md plans, or QA coverage for an iOS user flow.
+readonly: false
+model: inherit
+---
+
+You are an expert UI test planner for an **iOS** app using XCUITest.
+
+## Project structure
+
+Follow `tests-ui.mdc` and the **`xcuitest-e2e` skill**:
+
+- UI Test target: `*UITests/` (as in the Xcode project)
+- Optional plans: `*.cases.md` under the UITests area when the repo uses them
+- Screen/Page objects with `accessibilityIdentifier`
+- Launch / seed patterns already present (`-UITesting`, mock base URL, reset state)
+
+**Never Playwright**, `app/__tests__/e2e`, or browser MCP.
+
+## Inputs
+
+1. `.cursor/team/tasks/<slug>/brief.md` and `decomposition.md`.
+2. Existing UI plans/specs for the affected flow.
+3. Presentation Views to inventory stable identifiers (`{screen}__{element}`).
+
+## Work
+
+1. Map AC to user journeys (happy path, validation, empty/error, permission denial if relevant).
+2. List required `accessibilityIdentifier`s; note missing ones for `feature-developer`.
+3. Keep scenarios independent — one flow per case; no unrelated assertions bundled.
+4. Name scenarios in **Russian** with entity prefix when following repo convention (e.g. `OH-001 …`).
+5. Specify preconditions: launch args, logged-in state, mock data.
+
+## Output
+
+Write or update the relevant `*.cases.md` (or equivalent plan). Suggested shape:
+
+```markdown
+# <Flow> UI cases
+
+## <ID> <Russian title>
+### Preconditions
+...
+### Steps
+1. ...
+### Expected
+...
+```
+
+For agent team tasks, summarize planned scenarios and update `.cursor/team/tasks/<slug>/status.json`.
+
+## On completion
+
+Update `status.json`:
+
+```json
+{
+  "slug": "<slug>",
+  "currentAgent": "xcuitest-test-planner",
+  "phase": "executing",
+  "state": "completed",
+  "updatedAt": "<ISO8601>"
+}
+```
+
+Do not write XCUITest Swift sources — that is `xcuitest-test-generator`'s job.

package/presets/cursor/ios-swift/commands/README.md

@@ -1,3 +1,51 @@
 # Cursor commands (ios-swift preset)
 
-Place command definitions for this preset here. They are copied to `.cursor/commands` when you run `ai-rules init cursor --preset ios-swift`.
+Slash-команды копируются в `.cursor/commands/` при `ai-rules init cursor --preset ios-swift`.
+
+## Команда агентов
+
+| Command | Назначение |
+|---------|------------|
+| **`/task <описание>`** | **Главная точка входа:** router → pipeline.json → нужные роли по порядку |
+| `/task-continue <slug>` | После human gate или паузы |
+| `/feature-start <описание>` | Legacy: только analyst (без router) |
+| `/feature-continue <slug>` | Alias task-continue |
+| `/technical-retro [slug]` | Ретро; с slug — блок «Работа агентов» |
+
+## Примеры `/task`
+
+```
+/task Добавить фильтр по дате в Order History
+→ analyst → developer → reviewer → QA
+
+/task Order History падает при пустом списке
+→ debugger → developer → reviewer → QA (regression)
+
+/task CI упал на lint в PR #142
+→ ci-investigator → developer → reviewer
+
+/task Миграция на iOS Swift 15
+→ analyst → migration-specialist → developer → reviewer → QA
+
+/task Проверь доступность модалки оплаты
+→ analyst → developer → a11y-reviewer → code-reviewer
+
+/task Покрой unit-тестами mapper orders
+→ unit-planner → unit-generator
+
+/task Напиши README для новой фичи фильтров
+→ analyst → tech-writer
+
+/task Сделай ревью изменений в Features/Orders
+→ reviewer only
+```
+
+## Связанные файлы
+
+- Subagents: `../agents/` (21 ролей, включая `task-router.md` и `xcuitest-test-{planner,generator,healer}`)
+- Оркестратор: `../rules/agent-team-orchestrator.mdc`
+- Skills: `../skills/` (`feature-delivery`, `code-review`, `debug-investigation`, `ci-investigation`, `unit-testing`, `xcuitest-e2e`, `technical-retro`)
+- Артефакты: `../team/README.md` (`pipeline.json`, `status.json`)
+- Hooks: `../hooks.json`, `../hooks/chain-team-phases.sh`
+
+Создавать и редактировать команды можно через `/commands` в Cursor или напрямую в этой папке пресета.

package/presets/cursor/ios-swift/commands/feature-continue.md

@@ -0,0 +1,19 @@
+---
+name: feature-continue
+description: Legacy alias for /task-continue that resumes a feature pipeline after human approval or pause.
+---
+
+# Feature continue — legacy alias
+
+> **Предпочтительно:** `/task-continue <slug>` — то же поведение, учитывает `pipeline.json`.
+
+Продолжение после human gate. Полная логика — в **`task-continue.md`**.
+
+## Кратко
+
+1. Прочитай `pipeline.json` (если есть) и `status.json`.
+2. Сбрось `awaitingHumanGate`; определи следующий step по `pipelineIndex`.
+3. Вызови subagent для `currentAgent`.
+4. Hook продолжит цепочку при `autoChain: true`.
+
+См. `task-continue.md` для деталей и таблицы handoff.

package/presets/cursor/ios-swift/commands/feature-start.md

@@ -0,0 +1,33 @@
+---
+name: feature-start
+description: Legacy analyst-only feature intake. Prefer /task for new work because it uses router and dynamic pipeline.
+---
+
+# Feature start — legacy (analyst only)
+
+> **Предпочтительно:** `/task <описание>` — router выберет роли и порядок автоматически.
+
+Запуск **фазы анализа** без router. Родительский агент действует как оркестратор (см. `agent-team-orchestrator.mdc`).
+
+## Что делать
+
+1. Извлеки описание задачи из аргументов команды (всё после `/feature-start`).
+2. Сгенерируй **slug** (kebab-case, до 48 символов) из заголовка задачи.
+3. Создай каталог `.cursor/team/tasks/<slug>/` если его ещё нет.
+4. Запиши `.cursor/team/active-task.json` → `{ "slug": "<slug>" }`.
+5. Опционально: минимальный `pipeline.json` с фиксированными steps (analyst → developer → reviewer → qa-tester).
+6. Вызови subagent **task-analyst** (Task tool) с полным описанием задачи и путём к артефактам.
+7. Дождись завершения аналитика. **Не вызывай developer** на этом этапе.
+
+## Human gate
+
+После аналитика:
+
+- Покажи пользователю ссылки на `brief.md` и `decomposition.md`.
+- Попроси проверить и утвердить или прислать правки.
+- Для продолжения: `/task-continue <slug>` или `/feature-continue <slug>`.
+
+## Если slug уже существует
+
+- Если `status.json` в `awaiting_approval` — предложи ревью или continue.
+- Если задача в работе — спроси, продолжать или начать новый slug.

package/presets/cursor/ios-swift/commands/task-continue.md

@@ -0,0 +1,49 @@
+---
+name: task-continue
+description: Continue an agent-team task after a human gate, pause, or review changes request using pipeline.json and status.json.
+---
+
+# Task continue — после human gate или паузы
+
+Продолжение пайплайна из `pipeline.json`. Алиас по смыслу: `/feature-continue`.
+
+## Аргументы
+
+`<slug>` — идентификатор задачи.
+
+## Preconditions
+
+1. Прочитай `.cursor/team/tasks/<slug>/pipeline.json` и `status.json`.
+2. Продолжай если:
+   - `awaitingHumanGate: true` или `state: awaiting_approval`, **или**
+   - `state: changes_requested` (после review), **или**
+   - задача прервана и нужно возобновить с `pipelineIndex`.
+
+## Алгоритм
+
+1. Запиши `.cursor/team/active-task.json` → `{ "slug": "<slug>" }`.
+2. Сбрось gate: `awaitingHumanGate: false`.
+3. Определи **следующий шаг**:
+   - После approval analyst/architect: `pipelineIndex + 1` → следующий agent в `steps`.
+   - После `changes_requested`: снова **feature-developer** (тот же index или найди developer в steps).
+4. Обнови `status.json`:
+   ```json
+   {
+     "pipelineIndex": <n>,
+     "currentAgent": "<steps[n].agent>",
+     "phase": "executing",
+     "state": "in_progress",
+     "awaitingHumanGate": false
+   }
+   ```
+5. Вызови subagent для `currentAgent` с контекстом slug и артефактов.
+6. Hook `chain-team-phases.sh` продолжит цепочку по `pipeline.json`, если `autoChain: true`.
+
+## Артефакты для handoff
+
+| Agent | Прочитать |
+|-------|-----------|
+| feature-developer | brief.md, decomposition.md, validation-report.md (if retry), review.md (if retry), architecture.md |
+| build-verifier | git diff, decomposition.md |
+| code-reviewer | brief.md, validation-report.md, git diff |
+| qa-tester | brief.md, decomposition.md, scope from pipeline step |

package/presets/cursor/ios-swift/commands/task.md

@@ -0,0 +1,50 @@
+---
+name: task
+description: Route a natural-language task through the agent-team pipeline: task-router, pipeline.json, and the first planned specialist.
+---
+
+# Task — единая точка входа (router + pipeline)
+
+Главная команда для постановки задачи. Родительский агент = оркестратор (`agent-team-orchestrator.mdc`). Intake для work-запросов без `/task` — `agent-team-intake.mdc`.
+
+## Аргументы
+
+Всё после `/task` — описание задачи на естественном языке.
+
+Примеры:
+
+- `/task Добавить фильтр по дате в Order History`
+- `/task Order History падает при пустом списке — пофикси`
+- `/task CI упал на xcodebuild в PR`
+- `/task Миграция сетевого клиента / SPM зависимости`
+- `/task Проверь a11y формы логина`
+- `/task Покрой unit-тестами OrderMapper`
+- `/task Напиши changelog для релиза фильтров`
+- `/task Сделай ревью моих изменений в Features/Orders`
+- `/task Напиши XCUITest для сценария оплаты`
+
+## Алгоритм
+
+1. **Slug** — kebab-case из описания (≤48 символов). Создай `.cursor/team/tasks/<slug>/`.
+2. **Router** — вызови subagent **task-router** с описанием задачи и путём к slug.
+3. **План** — покажи пользователю таблицу из `pipeline.json`: intent, steps, skipped, humanGates.
+4. **Intent retro** — если `intent === "retro"`, выполни `/technical-retro` и **остановись**.
+5. **Старт** — вызови subagent для `pipeline.steps[0].agent`:
+   - передай slug, пути к артефактам, scope из step (если есть);
+   - обнови `status.json`: `pipelineIndex: 0`, `currentAgent`, `state: in_progress`.
+6. **Human gate** — если после текущего шага есть gate в `humanGates` (`after:<agent>`), после завершения агента **остановись** и попроси `/task-continue <slug>` (или `/feature-continue <slug>`).
+
+## Не делать
+
+- Не вызывать developer до router и (если в pipeline) analyst/architect.
+- Не hardcode порядок ролей — только `pipeline.json`.
+- Не пропускать human gate без явного continue.
+
+## Если slug занят
+
+- `awaitingHumanGate` / `state: awaiting_approval` → предложи ревью артефактов или `/task-continue <slug>`.
+- `in_progress` → спроси: продолжить или новый slug.
+
+## Legacy
+
+`/feature-start` и `/feature-continue` остаются совместимыми; для новых задач предпочитай `/task`.

package/presets/cursor/ios-swift/commands/technical-retro.md

@@ -0,0 +1,81 @@
+---
+name: technical-retro
+description: Facilitate a technical retrospective for a period, incident, release, or completed agent-team task slug.
+---
+
+# Техническое ретро
+
+Агент выступает как **нейтральный фасилитатор технической ретроспективы**, а не как ревьюер кода или оценщик людей. Используй skill **`technical-retro`** как основной сценарий.
+
+## Когда включать
+
+- Пользователь просит: «ретро», «техническое ретро», «разбор спринта/итерации», «action items после релиза».
+- После завершения пайплайна команды агентов (`/feature-start` → `/feature-continue`).
+- Есть контекст: период, тема (релиз, инцидент), slug задачи, заметки.
+
+## Входные данные (собрать, не выдумывать)
+
+Запросить при нехватке:
+
+- **Период и фокус**.
+- **Slug задачи** (если ретро по работе команды агентов).
+- **Участники/роли** (если важно).
+- **Ограничения**: время, формат (async vs синхрон).
+
+### Артефакты команды агентов (если есть slug)
+
+Прочитать из репозитория:
+
+- `.cursor/team/tasks/<slug>/pipeline.json`
+- `.cursor/team/tasks/<slug>/brief.md`
+- `.cursor/team/tasks/<slug>/decomposition.md`
+- `.cursor/team/tasks/<slug>/status.json`
+- Git diff / `git status` для изменённых файлов
+
+Не приписывать факты, которых нет в артефактах, diff или сообщении пользователя.
+
+## Принципы фасилитации
+
+- **Безопасность**: процесс и система, не «виноватые».
+- **Конкретика**: от абстракций к наблюдаемым событиям.
+- **Баланс**: позитив и зоны роста.
+- **Action items**: владелец и срок у каждого.
+- **Не смешивать с code review** — развести блоки, если запросили оба.
+
+## Структура сессии (по умолчанию)
+
+1. **Цель и рамки**.
+2. **Сбор фактов**: хорошо / мешало / сюрпризы.
+3. **Группировка тем** (3–7).
+4. **Корневые причины** для 1–2 болезненных тем.
+5. **Эксперименты** (1–3 изменения процесса).
+6. **Action items**: что / владелец / до когда / критерий успеха.
+
+## Блок «Работа агентов» (обязателен при slug)
+
+Если ретро связано с пайплайном `/feature-start`:
+
+| Вопрос | Что фиксировать |
+|--------|-----------------|
+| Router | Ошибка intent, лишние/пропущенные steps в pipeline |
+| Аналитик | Ошибки в assumptions, пропущенные AC, лишние/недостающие таски |
+| Декомпозиция | Неполное покрытие слоёв, неверный порядок, blocked-зависимости |
+| Developer | Scope creep, пропущенные правила, lint/type gaps |
+| Reviewer | Пропущенные дефекты, false positives, качество чеклиста |
+| QA | Покрытие AC тестами, flakiness, пробелы в e2e планах |
+
+**Action items** в этом блоке — на улучшение **промптов, subagents и rules** (не только кода).
+
+## Формат ответа
+
+- Шапка: период, фокус, slug (если есть), допущения.
+- Повестка по этапам.
+- Блок **«Работа агентов»** (если применимо).
+- Темы — буллеты; спорное — **вопросы команде**.
+- **Action items** в конце.
+
+## Ограничения
+
+- Не приписывать цитаты и факты без входа.
+- Не выдавать HR‑рекомендации.
+- Если просят только шаблон — **шаблон повестки** без выдуманного контента.

package/presets/cursor/ios-swift/hooks/README.md

@@ -0,0 +1,8 @@
+# `.cursor/hooks` (preset ios-swift)
+
+| File | Purpose |
+|------|---------|
+| `guard-shell-command.sh` | Destructive git / JS package-manager mismatch; **does not** block `xcodebuild` / `simctl` / `xcrun` |
+| `chain-team-phases.sh` | Auto-chain pipeline steps on `subagentStop` |
+
+See root `hooks.json` for registration (`beforeShellExecution`, `subagentStop`).