@bonesofspring/ai-rules 0.2.1 → 0.2.3

package/presets/claude/next/hooks/chain-team-phases.sh

@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
-# Chains agent team phases after subagent completion when wired into Claude Code hooks.
+# Chains agent team steps from pipeline.json after subagentStop.
+# Falls back to legacy phase-based flow when pipeline.json is absent.
 
 set -euo pipefail
 
@@ -89,7 +90,7 @@ function getStepAgents(step) {
   return Array.isArray(step.agent) ? step.agent : [step.agent];
 }
 
-function skipIfMatches(skipIf) {
+function skipIfMatches(skipIf, dir) {
   if (!skipIf) return false;
   if (skipIf === 'debugger.fixed') {
     const text = readArtifact('debug-report.md');
@@ -102,9 +103,9 @@ function skipIfMatches(skipIf) {
   return false;
 }
 
-function findNextExecutableStep(steps, startIdx) {
+function findNextExecutableStep(steps, startIdx, dir) {
   for (let i = startIdx; i < steps.length; i++) {
-    if (!skipIfMatches(steps[i].skipIf)) {
+    if (!skipIfMatches(steps[i].skipIf, dir)) {
       return { step: steps[i], index: i };
     }
   }
@@ -114,47 +115,54 @@ function findNextExecutableStep(steps, startIdx) {
 const AGENT_HANDOFF = {
   'task-analyst': (s) =>
     `Invoke task-analyst for slug "${s}". Write brief.md and decomposition.md under .claude/team/tasks/${s}/. ` +
-    `Set status.json: phase executing, state awaiting_approval if human gate applies.`,
+    `Set status.json: phase executing, state awaiting_approval if human gate applies. Do not use legacy phase analysis.`,
   debugger: (s) =>
-    `Invoke debugger subagent for slug "${s}". Write debug-report.md with fixApplied: true/false. Update status.json when done.`,
+    `Invoke debugger subagent for slug "${s}". Investigate root cause; write debug-report.md with fixApplied: true/false. ` +
+    `Update status.json when done.`,
   'solution-architect': (s) =>
     `Invoke solution-architect for slug "${s}". Read brief.md; write architecture.md. Update status.json when done.`,
   'migration-specialist': (s) =>
     `Invoke migration-specialist for slug "${s}". Read brief.md; write migration-plan.md. Update status.json when done.`,
   'api-contract-reviewer': (s) =>
-    `Invoke api-contract-reviewer for slug "${s}". Write api-contract-review.md. Update status.json when done.`,
+    `Invoke api-contract-reviewer (readonly) for slug "${s}". Write api-contract-review.md. Update status.json when done.`,
   'ci-investigator': (s) =>
-    `Invoke ci-investigator for slug "${s}". Use ci-investigation skill. Write ci-report.md. Update status.json when done.`,
+    `Invoke ci-investigator for slug "${s}". Diagnose CI failure; write ci-report.md; apply minimal fix. ` +
+    `Use ci-investigation skill. Update status.json when done.`,
   'feature-developer': (s) =>
-    `Invoke feature-developer for slug "${s}". Read brief.md, decomposition.md, validation-report.md, review.md if present. ` +
-    `Follow rules/architecture/feature-delivery-workflow.md and architecture/reference-features.md. Include unit tests before handoff. Update status.json when done.`,
+    `Invoke feature-developer for slug "${s}". Read brief.md, decomposition.md, validation-report.md, review.md, architecture.md, migration-plan.md, api-contract-review.md, debug-report.md if present. ` +
+    `Follow architecture/feature-delivery-workflow.md and architecture/reference-features.md. Include unit tests for mappers/logic before handoff. Update status.json when done.`,
   'build-verifier': (s) =>
-    `Invoke build-verifier for slug "${s}". Run lint:js, lint:css, type-check, targeted unit tests from app/. ` +
+    `Invoke build-verifier (readonly) for slug "${s}". Run lint:js, lint:css, type-check, and targeted unit tests from app/. ` +
     `Write validation-report.md. Set state completed or validation_failed. Do not edit production code.`,
   'accessibility-reviewer': (s) =>
-    `Invoke accessibility-reviewer for slug "${s}". Write a11y-review.md. Update status.json when done.`,
+    `Invoke accessibility-reviewer (readonly) for slug "${s}". Review UI diff; write a11y-review.md. Update status.json when done.`,
   'performance-auditor': (s) =>
-    `Invoke performance-auditor for slug "${s}". Write perf-report.md. Update status.json when done.`,
+    `Invoke performance-auditor (readonly) for slug "${s}". Write perf-report.md. Update status.json when done.`,
   'code-reviewer': (s) =>
-    `Invoke code-reviewer for slug "${s}". Review git diff per rules/tooling-and-review/code-review-mr.md. Update status.json when done.`,
+    `Invoke code-reviewer subagent (readonly) for slug "${s}". Review git diff vs brief.md per tooling-and-review/code-review-mr.md. ` +
+    `Update status.json when done.`,
   'security-reviewer': (s) =>
-    `Invoke security-reviewer for slug "${s}". Write security-review.md. Update status.json when done.`,
+    `Invoke security-reviewer (readonly) for slug "${s}". Write security-review.md. Update status.json when done.`,
   'qa-tester': (s, scope) =>
-    `Invoke qa-tester for slug "${s}"${scope ? ` (scope: ${scope})` : ''}. Update status.json when done.`,
+    `Invoke qa-tester for slug "${s}"${scope ? ` (scope: ${scope})` : ''}. ` +
+    `Add/update tests per brief. Follow testing/playwright-agents.md. Update status.json when done.`,
   'unit-test-planner': (s) =>
-    `Invoke unit-test-planner for slug "${s}". Use unit-testing skill. Update status.json when done.`,
+    `Invoke unit-test-planner for slug "${s}". Write unit-test-plan.md. Use unit-testing skill. Update status.json when done.`,
   'unit-test-generator': (s) =>
-    `Invoke unit-test-generator for slug "${s}". Use unit-testing skill. Update status.json when done.`,
+    `Invoke unit-test-generator for slug "${s}". Implement specs from unit-test-plan.md. Use unit-testing skill. Update status.json when done.`,
   'unit-test-healer': (s) =>
-    `Invoke unit-test-healer for slug "${s}". Use unit-testing and debug-investigation skills. Update status.json when done.`,
+    `Invoke unit-test-healer for slug "${s}". Fix failing unit tests. Use unit-testing and debug-investigation skills. Update status.json when done.`,
   'playwright-test-planner': (s) =>
-    `Invoke playwright-test-planner for slug "${s}". Follow rules/testing/playwright-agents.md and playwright-e2e skill. Update status.json when done.`,
+    `Invoke playwright-test-planner for slug "${s}". Create/update app/__tests__/e2e/**/*.cases.md. ` +
+    `Follow testing/playwright-agents.md and the playwright-e2e skill. Update status.json when done.`,
   'playwright-test-generator': (s) =>
-    `Invoke playwright-test-generator for slug "${s}". Use Playwright MCP tools when available. Update status.json when done.`,
+    `Invoke playwright-test-generator for slug "${s}". Generate/update *.spec.ts from matching *.cases.md. ` +
+    `Use user-playwright MCP when available. Follow testing/playwright-agents.md and the playwright-e2e skill. Update status.json when done.`,
   'playwright-test-healer': (s) =>
-    `Invoke playwright-test-healer for slug "${s}". Use Playwright MCP when available. Update status.json when done.`,
+    `Invoke playwright-test-healer for slug "${s}". Fix failing/flaky e2e while preserving cases.md assertions. ` +
+    `Use user-playwright MCP when available. Follow testing/playwright-agents.md and debug-investigation. Update status.json when done.`,
   'tech-writer': (s) =>
-    `Invoke tech-writer for slug "${s}". Write documentation.md. Update status.json when done.`,
+    `Invoke tech-writer for slug "${s}". Write documentation.md from task artifacts. Update status.json when done.`,
 };
 
 const REVIEW_AGENTS = new Set([
@@ -173,7 +181,7 @@ function handoffForParallelStep(step) {
   const agents = getStepAgents(step);
   return (
     `Invoke IN PARALLEL (one message, multiple Task calls): ${agents.join(' AND ')} for slug "${slug}". ` +
-    `Each agent appends itself to status.json parallelCompleted when done.`
+    `Each agent writes its artifact and appends itself to status.json parallelCompleted when done.`
   );
 }
 
@@ -186,7 +194,11 @@ function hasGateAfterStep(step, humanGates) {
 }
 
 function legacyFlow() {
-  if (status.phase === 'development' && status.state === 'completed') {
+  if (status.phase === 'analysis') {
+    process.stdout.write('{}');
+    process.exit(0);
+  }
+  if (status.phase === 'development' && (status.state === 'completed' || status.state === 'in_progress')) {
     writeStatus({ phase: 'executing', state: 'in_progress', currentAgent: 'build-verifier' });
     out(handoffForAgent('build-verifier'));
     process.exit(0);
@@ -208,16 +220,23 @@ function legacyFlow() {
       phase: 'executing',
       retryAfterFix: status.currentAgent,
     });
-    out(handoffForAgent('feature-developer') + ` After fixes, re-run ${status.currentAgent}.`);
+    out(
+      handoffForAgent('feature-developer') +
+        ` After fixes, re-run ${status.currentAgent}.`,
+    );
     process.exit(0);
   }
-  if (status.state === 'validation_failed') {
+  if (status.state === 'validation_failed' && status.currentAgent === 'build-verifier') {
     writeStatus({
       currentAgent: 'feature-developer',
       state: 'in_progress',
+      phase: 'executing',
       retryAfterFix: 'build-verifier',
     });
-    out(handoffForAgent('feature-developer') + ` Read validation-report.md. Re-run build-verifier after fixes.`);
+    out(
+      handoffForAgent('feature-developer') +
+        ` Read validation-report.md. After fixes, re-run build-verifier.`,
+    );
     process.exit(0);
   }
   if (status.state === 'completed' && status.retryAfterFix) {
@@ -265,7 +284,10 @@ if (status.state === 'changes_requested' && REVIEW_AGENTS.has(status.currentAgen
     phase: 'executing',
     retryAfterFix: reviewer,
   });
-  out(handoffForAgent('feature-developer') + ` After fixes, re-run ${reviewer}.`);
+  out(
+    handoffForAgent('feature-developer') +
+      ` After fixes, re-run ${reviewer}.`,
+  );
   process.exit(0);
 }
 
@@ -276,7 +298,10 @@ if (status.state === 'validation_failed' && status.currentAgent === 'build-verif
     phase: 'executing',
     retryAfterFix: 'build-verifier',
   });
-  out(handoffForAgent('feature-developer') + ` Read validation-report.md. Re-run build-verifier after fixes.`);
+  out(
+    handoffForAgent('feature-developer') +
+      ` Read validation-report.md. After fixes, re-run build-verifier.`,
+  );
   process.exit(0);
 }
 
@@ -300,9 +325,12 @@ const stepAgents = getStepAgents(currentStep);
 
 if (currentStep.parallel && stepAgents.length > 1) {
   const done = [...(status.parallelCompleted || [])];
-  if (completedAgent && !done.includes(completedAgent)) done.push(completedAgent);
+  if (completedAgent && !done.includes(completedAgent)) {
+    done.push(completedAgent);
+  }
   writeStatus({ parallelCompleted: done });
-  if (stepAgents.filter((a) => !done.includes(a)).length > 0) {
+  const remaining = stepAgents.filter((a) => !done.includes(a));
+  if (remaining.length > 0) {
     process.stdout.write('{}');
     process.exit(0);
   }
@@ -310,14 +338,24 @@ if (currentStep.parallel && stepAgents.length > 1) {
 }
 
 if (hasGateAfterStep(currentStep, pipeline.humanGates)) {
-  writeStatus({ awaitingHumanGate: true, state: 'awaiting_approval', currentAgent: completedAgent });
+  writeStatus({
+    awaitingHumanGate: true,
+    state: 'awaiting_approval',
+    currentAgent: completedAgent,
+  });
   process.stdout.write('{}');
   process.exit(0);
 }
 
-const next = findNextExecutableStep(steps, idx + 1);
+const next = findNextExecutableStep(steps, idx + 1, taskDir);
 if (!next) {
-  writeStatus({ pipelineIndex: steps.length, phase: 'done', state: 'completed', currentAgent: null });
+  writeStatus({
+    pipelineIndex: steps.length,
+    phase: 'done',
+    state: 'completed',
+    currentAgent: null,
+    awaitingHumanGate: false,
+  });
   out(`Pipeline complete for "${slug}". Run /technical-retro ${slug}.`);
   process.exit(0);
 }

package/presets/claude/next/rules/README.md

@@ -4,13 +4,22 @@
 
 ## Loading strategy
 
-- **Session start (no `paths:`):** `stack/next-app-core`, `tooling-and-review/post-change-lint`, `tooling-and-review/package-manager`, `tooling-and-review/code-quality` — **4 files only**
-- **On-demand (`paths:` or via commands):** `agent-team-intake`, `agent-team-orchestrator`, `code-review-mr`, architecture, imports, UI, tests, feature-delivery-workflow, reference-features, next-app-router, react-a11y-coding
+- **Session start (no `paths:`):** ровно **3** — `next-app-core`, `package-manager`, `code-quality`
+- **On-demand (`paths:` or via commands):** `post-change-lint` (**обязателен после правок кода**), `agent-team-intake`, `agent-team-orchestrator`, `code-review-mr`, architecture, imports, UI, tests, feature-delivery-workflow, reference-features, next-app-router, react-a11y-coding
 - **Skills:** long workflows (`feature-delivery`, `code-review`, …)
 
 ### UI edit bundle (consolidated paths)
 
-При правке `app/src/ui/**/*.tsx` — уменьшенный набор paths (см. `ui-and-accessibility/react-ui.md`, `architecture/architecture-boundaries-ui.md`, `stack/navigation-router-ui.md`). Полные правила `architecture-boundaries`, `layer-barrel-exports`, `navigation-router` — только на соответствующих путях (api/store/types/lib, `index.ts`, `app/src/app/**`).
+При правке `app/src/ui/**/*.tsx` подгружается **уменьшенный** набор:
+
+| Rule | Назначение |
+|------|------------|
+| `ui-and-accessibility/react-ui.md` | Структура, стили, пропсы |
+| `architecture/architecture-boundaries-ui.md` | Slim границы UI-слоя |
+| `ui-and-accessibility/react-a11y-coding.md` | A11y |
+| `stack/navigation-router-ui.md` | Краткий ориентир навигации |
+
+**Не грузятся на типичный UI edit:** `architecture/architecture-boundaries.md` (api/store/types/lib), `architecture/layer-barrel-exports.md` (только `index.ts`), `stack/navigation-router.md` (только `app/src/app/**`). Стили колокации — в `react-ui.md` (не отдельный stub).
 
 ## С чего начать
 
@@ -26,6 +35,10 @@
 | `stack/next-app-router.md` | App Router, RSC |
 | `ui-and-accessibility/react-a11y-coding.md` | A11y при кодинге UI |
 | `architecture/feature-delivery-workflow.md` | Сквозной чеклист (paths) |
+| `architecture/architecture-boundaries-ui.md` | Slim границы UI при правках компонентов |
+| `architecture/architecture-boundaries.md` | Полная карта UI / store / API |
+| `stack/navigation-router-ui.md` | Навигация в UI-компонентах (slim) |
+| `stack/navigation-router.md` | Полный аудит стека навигации |
 | `tooling-and-review/agent-team-orchestrator.md` | Pipeline, build-verifier, parallel |
 | `agents/build-verifier.md` | Validation gate agent |
 

package/presets/claude/next/rules/architecture/README.md

@@ -3,9 +3,10 @@
 | Файл | Назначение |
 |------|------------|
 | `public-imports.md` | Импорты `@/types`, `@/types/enums`, `@/api` (вне `app/src/api/**`) |
-| `types-public-imports.md`, `api-public-imports.md` | Deprecated stubs → `public-imports.md` |
 | `architecture-boundaries-ui.md` | Slim границы UI при правках компонентов |
 | `architecture-boundaries.md` | Полная карта UI / store / API (api, store, types, lib) |
 | `layer-barrel-exports.md` | Двухуровневые barrel для слоёв с public API |
 | `feature-delivery-workflow.md` | Сквозной чеклист новой фичи |
 | `reference-features.md` | Эталонные пути UI/store/API/types |
+
+Deprecated stubs `types-public-imports.md` / `api-public-imports.md` **removed** — use `public-imports.md`.

package/presets/claude/next/rules/stack/README.md

@@ -8,5 +8,5 @@
 | `arrow-functions.md` | Стрелочный синтаксис | session start |
 | `no-type-assertion.md` | Ограничение `as` на границах модулей | session start |
 | `navigation-router-ui.md` | Навигация в UI-компонентах (slim) | `paths: app/src/ui/**/*.tsx` |
-| `navigation-router.md` | Полный аудит стека навигации | `paths: app/src/app/**` |
+| `navigation-router.md` | Полный аудит стека навигации (App Router / SPA) | `paths: app/src/app/**` |
 | `types-jsdoc.md` | JSDoc в `app/src/types` | `paths: app/src/types/**/*.ts` |

package/presets/claude/next/rules/stack/navigation-router.md

@@ -6,6 +6,8 @@ paths:
 
 # Навигация и роутинг: сначала стек проекта
 
+Краткий ориентир для UI-компонентов: **`stack/navigation-router-ui.md`**.
+
 **При любой задаче, связанной с навигацией, переходами между страницами, URL, редиректами, хлебными крошками, защищёнными маршрутами или программной сменой маршрута** — перед предложением кода или импортов **нельзя** опираться на «типичный React» по умолчанию. Нужно **явно свериться со стеком целевого репозитория** и использовать **один** согласованный с проектом механизм.
 
 ## Зависимости: что проверить в первую очередь

package/presets/claude/next/rules/stack/next-app-core.md

@@ -25,7 +25,7 @@
 
 - Архитектура и импорты: `architecture/architecture-boundaries.md`, `architecture/public-imports.md`
 - Фичи: `architecture/feature-delivery-workflow.md` + skill `feature-delivery`
-- После правок: `tooling-and-review/post-change-lint.md`; менеджер пакетов: `tooling-and-review/package-manager.md`
+- После правок: **вызвать** `tooling-and-review/post-change-lint.md` (requestable, обязателен после code edits); менеджер пакетов: `tooling-and-review/package-manager.md`
 - Копировать паттерны соседних файлов в целевом слое; не использовать `any` (предпочитать `unknown` + сужение)
 
 Задачи на **сеть, HTTP, новые эндпоинты**: `api-and-data/http-client.md` + `api-and-data/api-services.md` + `api-and-data/store-rtk.md`.

package/presets/claude/next/rules/tooling-and-review/README.md

@@ -1,16 +1,14 @@
 # Tooling and review
 
-Lint, package manager, качество кода, code review MR.
-
-| Файл | Содержание |
-|------|------------|
-| `package-manager.md` | yarn / pnpm / npm / bun — определить по lockfile |
-| `agent-team-intake.md` | Когда предлагать `/task` и router pipeline |
-| `agent-team-orchestrator.md` | Dynamic agent team workflow: router, pipeline, gates |
-| `post-change-lint.md` | Обязательный `lint:js` + `lint:css` после изменений |
-| `code-quality.md` | Boy scout rule, рефакторинг, ESLint |
-| `code-review-mr.md` | Чеклист ревью merge request |
-
-Все — **session start**.
-
-On-demand: **`commands/technical-retro.md`** (фасилитация ретро, не грузится как rule).
+Lint, package manager, качество кода, agent team, code review MR.
+
+| Файл | Содержание | Загрузка |
+|------|------------|----------|
+| `package-manager.md` | yarn / pnpm / npm / bun — определить по lockfile | session start |
+| `post-change-lint.md` | `lint:js` + `lint:css` после изменений (**обязателен** при code edits) | `paths:` commands/team/agents + `app/**` |
+| `code-quality.md` | Boy scout rule, рефакторинг, ESLint | session start |
+| `agent-team-intake.md` | Когда предлагать `/task` и router pipeline | `paths:` commands/team |
+| `agent-team-orchestrator.md` | Dynamic agent team: router, pipeline, gates | `paths:` commands/team/agents |
+| `code-review-mr.md` | Чеклист ревью merge request | `paths:` review-related |
+
+On-demand (не rule): **`commands/technical-retro.md`** (фасилитация ретро).

package/presets/claude/next/rules/tooling-and-review/agent-team-orchestrator.md

@@ -2,6 +2,7 @@
 paths:
   - .claude/commands/**/*
   - .claude/team/**/*
+  - .claude/agents/**/*
 ---
 
 # Agent team orchestrator

package/presets/claude/next/rules/tooling-and-review/code-review-mr.md

@@ -1,8 +1,9 @@
 ---
 paths:
-  - .claude/agents/code-reviewer.md
   - .claude/commands/**/*
-  - .claude/team/**/*
+  - .claude/agents/code-reviewer.md
+  - .claude/skills/code-review/**/*
+  - .claude/team/**/review.md
 ---
 
 # Code review merge requests
@@ -21,7 +22,6 @@ On-demand rule for review flows. **Procedure and output format:** skill `code-re
 
 - User asks for review/MR/diff
 - Pipeline step `code-reviewer`
-- BUGBOT automated review
 
 ## Constraints
 

package/presets/claude/next/rules/tooling-and-review/post-change-lint.md

@@ -1,5 +1,16 @@
+---
+description: Прогон ESLint и Stylelint после изменений кода. Requestable — подгружать после правок app/**; агенты обязаны запускать после code edits.
+paths:
+  - .claude/commands/**/*
+  - .claude/team/**/*
+  - .claude/agents/**/*
+  - app/**/*.{ts,tsx,js,jsx,mjs,css}
+---
+
 # Линтеры после изменений кода
 
+**Requestable, но обязателен при изменениях кода:** правило не session-start (экономия контекста); после правок исходников агент **должен** следовать этому чеклисту.
+
 ## Когда применять
 
 После **любого** изменения исходников в `app/**` (TS/TSX/JS/MJS, CSS, styled/Linaria в `.ts`/`.tsx`).

package/presets/claude/next/rules/ui-and-accessibility/README.md

@@ -4,6 +4,9 @@
 
 | Файл | Содержание | Загрузка |
 |------|------------|----------|
-| `no-props-spread.md` | Явные пропсы, без `{...props}` | session start |
-| `css-property-order.md` | Порядок CSS (Stylelint idiomatic-order) | `paths: styles.ts`, `.css` |
-| `react-ui.md` | Структура компонентов, `.data.ts`, хуки | `paths: app/src/ui/**` |
+| `no-props-spread.md` | Явные пропсы, без `{...props}` | `paths: app/src/**/*.tsx` |
+| `css-property-order.md` | Порядок CSS (Stylelint idiomatic-order) | `paths:` styles/css |
+| `react-ui.md` | Структура, стили (`Root`), `.data.ts`, хуки | `paths: app/src/ui/**` |
+| `react-a11y-coding.md` | A11y при написании UI | `paths: app/src/ui/**` |
+
+Deprecated stub `component-styles.md` **removed** — styles colocation lives in `react-ui.md`.

package/presets/claude/next/skills/feature-delivery/SKILL.md

@@ -8,7 +8,7 @@ description: Delivers Next.js frontend features end-to-end across domain types,
 1. Read task brief, acceptance criteria, and decomposition if present.
 2. Read **`rules/architecture/feature-delivery-workflow.md`** and **`rules/architecture/reference-features.md`** — follow layer order and mirror closest reference feature.
 3. Add or update focused tests for changed behavior.
-4. Validation from `app/`: see **`rules/tooling-and-review/post-change-lint.md`** (pipeline: scoped lint OK if next step is `build-verifier`).
+4. Validation from `app/`: **invoke** **`rules/tooling-and-review/post-change-lint.md`** after code edits (requestable, not session-start — but mandatory when code changed). Pipeline: scoped lint OK if next step is `build-verifier`.
 
 ## Handoff
 

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

@@ -1,6 +1,6 @@
 # Agent team artifacts
 
-Каталог артефактов пайплайна «команда агентов» Claude Code.
+Каталог артефактов пайплайна «команда агентов» Claude.
 
 ## Layout
 
@@ -14,8 +14,8 @@
       status.json
       brief.md
       decomposition.md
-      debug-report.md
-      validation-report.md
+      debug-report.md          # fixApplied: true/false
+      validation-report.md     # build-verifier: PASS | FAIL
       architecture.md
       migration-plan.md
       ci-report.md
@@ -30,18 +30,76 @@
 
 ## pipeline.json schema
 
-Same as Cursor preset — see `agents/task-router.md` for examples with `build-verifier`, `skipIf`, and `parallel` steps.
+```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 + unit tests", "scope": "unit-in-dev" },
+    { "agent": "build-verifier", "label": "Validation gate" },
+    { "agent": "code-reviewer", "label": "Code review" },
+    { "agent": "qa-tester", "label": "E2E", "scope": "e2e-only" }
+  ],
+  "humanGates": ["after:task-analyst"],
+  "autoChain": true,
+  "skipped": []
+}
+```
+
+### Step fields
+
+| Field | Description |
+|-------|-------------|
+| `agent` | kebab-case name or array when `parallel: true` |
+| `label` | Human-readable step name |
+| `scope` | Passed to agents (e.g. `unit-in-dev`, `e2e-only`) |
+| `skipIf` | `debugger.fixed` \| `ci-investigator.resolved` |
+| `parallel` | Invoke all `agent` values in one parent turn |
+
+## status.json (pipeline mode)
+
+```json
+{
+  "slug": "order-history-date-filter",
+  "intent": "feature",
+  "pipelineIndex": 0,
+  "currentAgent": "task-analyst",
+  "phase": "executing",
+  "state": "in_progress",
+  "awaitingHumanGate": false,
+  "parallelCompleted": [],
+  "retryAfterFix": null,
+  "updatedAt": "2026-05-29T12:00:00.000Z"
+}
+```
+
+### phase
+
+Prefer **`executing`** for pipeline mode. Legacy: `analysis`, `development`, `review`, `testing`, `done`.
 
-## status.json
+### state
 
-Use **`phase: executing`** in pipeline mode. Optional fields: `parallelCompleted`, `retryAfterFix`, `validation_failed` state.
+| Value | Description |
+|-------|-------------|
+| `in_progress` | Current step running |
+| `completed` | Current step finished |
+| `awaiting_approval` | Human gate; use `/task-continue` |
+| `changes_requested` | Reviewer requires fixes |
+| `validation_failed` | build-verifier failed |
+| `approved` | Legacy continue |
 
 ## Workflow entry
 
 ```bash
-/task <описание>
+/task <описание задачи>
 /task-continue <slug>
 /technical-retro <slug>
 ```
 
 Legacy: `/feature-start`, `/feature-continue`.
+
+## Git
+
+Commit task artifacts if you want them to survive `ai-rules clean claude`. Or copy finished tasks to `docs/agent-workflow/tasks/<slug>/`.

package/presets/cursor/ios-swift/AGENTS.md

@@ -0,0 +1,47 @@
+# iOS Swift stack — Cursor agent team
+
+Краткая точка входа для Cursor. Подробные правила — `.cursor/rules/*.mdc`; сценарии — `.cursor/skills/**`.
+
+See `.cursor/rules/README.md` for the full catalog and loading strategy.
+
+## Quick start
+
+| Задача | Куда смотреть |
+|--------|----------------|
+| Любая новая work-задача | `/task` → `commands/task.md` + `agent-team-orchestrator.mdc` (+ `agent-team-intake.mdc` on-demand) |
+| Новая фича end-to-end | skill `feature-delivery` + `feature-delivery-workflow.mdc` |
+| Стек и слои | `ios-app-core.mdc` |
+| Эталонные Feature | `reference-features.mdc` (примеры `Features/Orders/…`; заменить на реальные пути) |
+| Toolchain / схемы | `xcode-tooling.mdc` (requestable) |
+| После правок Swift | `post-change-build.mdc` (**requestable**, обязателен после edits; полный gate — `build-verifier`) |
+| Code review MR | skill `code-review` + `code-review-mr.mdc` |
+| UI-тесты | skill `xcuitest-e2e` + agents `xcuitest-test-*` |
+| Security / Keychain | `security-ios.mdc` |
+| Валидация перед review | agent `build-verifier` (для preset: ещё проверка chain≠next) |
+| Техническое ретро | `/technical-retro` + skill `technical-retro` |
+
+## Dogfood (5 сценариев)
+
+1. `/task` — новая Feature под `Features/<Name>`.
+2. Баг ViewModel — debugger + unit test.
+3. Mapper — unit-test-planner/generator.
+4. UI flow — xcuitest trio.
+5. Auth/Keychain — security-reviewer + `security-ios.mdc`.
+
+## Когда использовать `/task`
+
+- Реализация, багфикс, миграция, тесты, ревью MR, CI-fix — **предпочтительно через `/task`**.
+- Простой one-liner без архитектурного риска — можно без pipeline, если пользователь явно просит.
+- Вопросы «как работает X» — ответ без `/task`.
+
+## Pipeline routing
+
+Intent detection, profiles (`full` / `standard` / `light`), and default steps — **only** in `agents/task-router.md`. Schema and rename map (Playwright → XCUITest) — `agents/README.md`.
+
+## Install
+
+```bash
+npx @bonesofspring/ai-rules init cursor --preset ios-swift
+```
+
+Копирует rules, commands, agents, hooks, skills, team, `hooks.json`, `BUGBOT.md`, `AGENTS.md`.

package/presets/cursor/ios-swift/BUGBOT.md

@@ -0,0 +1,15 @@
+# Cursor Bugbot Review Guidelines (iOS)
+
+Follow the **`code-review` skill** and **`code-review-mr.mdc`** for the full checklist.
+
+## Priorities
+
+1. Correctness regressions and runtime bugs (crashes, wrong state, concurrency races).
+2. Architecture boundary violations (`architecture-boundaries.mdc`): View↛API/DTO, Domain↛SwiftUI, Data↛Presentation.
+3. Missing unit tests for mappers / use cases / non-trivial ViewModel logic; XCUITest updates for user flows (`tests-unit.mdc`, `tests-ui.mdc`).
+4. Concurrency and safety (`swift-conventions.mdc`): `@MainActor`, typed errors, no unjustified force unwrap; SPM public API / no deep-imports (`module-public-api.mdc`).
+5. Security-sensitive diffs: Keychain, tokens, PII, ATS (`security-ios.mdc`).
+
+## Review style
+
+Lead with concrete findings: file, impact, fix direction. Skip style-only nits unless they violate SwiftLint/project conventions.

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

@@ -0,0 +1,36 @@
+# iOS Swift preset (Cursor)
+
+Правила и agent-team surface для iOS (Swift / SwiftUI / XCTest / XCUITest).
+
+## Install
+
+```bash
+npx @bonesofspring/ai-rules init cursor --preset ios-swift
+```
+
+Копирует:
+
+| Path | Содержание |
+|------|------------|
+| `AGENTS.md` | Quick-start |
+| `BUGBOT.md` | Cursor Bugbot review priorities (iOS) |
+| `rules/**` | `.mdc` + README (alwaysApply ≤3) |
+| `agents/**` | **21** ролей (+ README rename map) |
+| `skills/**` | **7** skills (в т.ч. `xcuitest-e2e`) |
+| `commands/**` | task, task-continue, feature-start/continue, technical-retro |
+| `hooks.json` + `hooks/**` | guard-shell + chain-team-phases |
+| `team/**` | fixtures + README |
+
+## alwaysApply (≤3)
+
+`ios-app-core`, `architecture-boundaries`, `code-quality-and-refactoring`.
+
+Requestable (не always-on): `post-change-build`, `xcode-tooling`, `agent-team-*`, `code-review-mr`, `feature-delivery-workflow`, `reference-features`.
+
+## Sync with Claude
+
+SoT = этот Cursor-пресет. После правок `.mdc` / agents / skills — обновить twin в `presets/claude/ios-swift/` **в том же PR**.
+
+`BUGBOT.md` — **Cursor-only** (нет Claude twin); для Claude Code — skill `code-review` + `tooling-and-review/code-review.md`.
+
+См. `rules/README.md`, `AGENTS.md`.