@bonesofspring/ai-rules 0.2.1 → 0.2.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +10 -20
- package/bin/cli.js +73 -260
- package/package.json +4 -13
- package/presets/claude/ios-swift/CLAUDE.md +27 -0
- package/presets/claude/ios-swift/README.md +29 -0
- package/presets/claude/ios-swift/commands/README.md +3 -0
- package/presets/claude/ios-swift/rules/README.md +44 -0
- package/presets/claude/ios-swift/rules/api-and-data/README.md +9 -0
- package/presets/claude/ios-swift/rules/api-and-data/networking.md +49 -0
- package/presets/claude/ios-swift/rules/architecture/README.md +10 -0
- package/presets/claude/ios-swift/rules/architecture/boundaries.md +33 -0
- package/presets/claude/ios-swift/rules/architecture/feature-delivery.md +60 -0
- package/presets/claude/ios-swift/rules/stack/README.md +10 -0
- package/presets/claude/ios-swift/rules/stack/ios-app-core.md +42 -0
- package/presets/claude/ios-swift/rules/stack/swift-conventions.md +51 -0
- package/presets/claude/ios-swift/rules/testing/README.md +10 -0
- package/presets/claude/ios-swift/rules/testing/ui.md +41 -0
- package/presets/claude/ios-swift/rules/testing/unit.md +41 -0
- package/presets/claude/ios-swift/rules/tooling-and-review/README.md +11 -0
- package/presets/claude/ios-swift/rules/tooling-and-review/code-quality.md +38 -0
- package/presets/claude/ios-swift/rules/tooling-and-review/code-review.md +41 -0
- package/presets/claude/ios-swift/rules/tooling-and-review/post-change-build.md +31 -0
- package/presets/claude/ios-swift/rules/ui-and-accessibility/README.md +10 -0
- package/presets/claude/ios-swift/rules/ui-and-accessibility/swiftui.md +61 -0
- package/presets/claude/ios-swift/rules/ui-and-accessibility/viewmodels.md +43 -0
- package/presets/claude/next/CLAUDE.md +5 -33
- package/presets/claude/next/README.md +0 -10
- package/presets/claude/next/agents/README.md +0 -126
- package/presets/claude/next/agents/playwright-test-generator.md +65 -16
- package/presets/claude/next/agents/playwright-test-healer.md +51 -16
- package/presets/claude/next/agents/playwright-test-planner.md +55 -15
- package/presets/claude/next/commands/README.md +2 -10
- package/presets/claude/next/hooks/README.md +2 -5
- package/presets/claude/next/rules/README.md +11 -29
- package/presets/claude/next/rules/api-and-data/README.md +1 -7
- package/presets/claude/next/rules/architecture/README.md +2 -10
- package/presets/claude/next/rules/stack/README.md +1 -10
- package/presets/claude/next/rules/testing/README.md +1 -9
- package/presets/claude/next/rules/tooling-and-review/README.md +1 -14
- package/presets/claude/next/rules/ui-and-accessibility/README.md +1 -7
- package/presets/claude/next/skills/README.md +1 -11
- package/presets/cursor/ios-swift/README.md +17 -0
- package/presets/cursor/ios-swift/commands/README.md +3 -0
- package/presets/cursor/ios-swift/rules/README.md +33 -0
- package/presets/cursor/ios-swift/rules/architecture-boundaries.mdc +34 -0
- package/presets/cursor/ios-swift/rules/code-quality-and-refactoring.mdc +39 -0
- package/presets/cursor/ios-swift/rules/code-review-mr.mdc +42 -0
- package/presets/cursor/ios-swift/rules/feature-delivery-workflow.mdc +61 -0
- package/presets/cursor/ios-swift/rules/ios-app-core.mdc +43 -0
- package/presets/cursor/ios-swift/rules/networking-services.mdc +49 -0
- package/presets/cursor/ios-swift/rules/post-change-build.mdc +32 -0
- package/presets/cursor/ios-swift/rules/state-and-viewmodels.mdc +43 -0
- package/presets/cursor/ios-swift/rules/swift-conventions.mdc +51 -0
- package/presets/cursor/ios-swift/rules/swiftui-ui.mdc +61 -0
- package/presets/cursor/ios-swift/rules/tests-ui.mdc +41 -0
- package/presets/cursor/ios-swift/rules/tests-unit.mdc +41 -0
- package/presets/cursor/next/commands/README.md +1 -49
- package/presets/cursor/next/rules/README.md +0 -67
- package/presets/cursor/next/rules/api-services.mdc +10 -12
- package/presets/cursor/next/rules/architecture-boundaries.mdc +12 -31
- package/presets/cursor/next/rules/code-quality-and-refactoring.mdc +4 -5
- package/presets/cursor/next/rules/code-review-mr.mdc +40 -21
- package/presets/cursor/next/rules/next-app-core.mdc +61 -18
- package/presets/cursor/next/rules/no-props-spread.mdc +4 -27
- package/presets/cursor/next/rules/playwright-agents.mdc +1 -2
- package/presets/cursor/next/rules/react-ui.mdc +3 -33
- package/presets/cursor/next/rules/store-rtk.mdc +6 -13
- package/presets/cursor/next/rules/tests-unit.mdc +10 -30
- package/CHANGELOG.md +0 -22
- package/CONTRIBUTING.md +0 -102
- package/fragments/BUGBOT.md +0 -23
- package/presets/claude/next/BUGBOT.md +0 -16
- package/presets/claude/next/agents/accessibility-reviewer.md +0 -65
- package/presets/claude/next/agents/api-contract-reviewer.md +0 -69
- package/presets/claude/next/agents/build-verifier.md +0 -64
- package/presets/claude/next/agents/ci-investigator.md +0 -62
- package/presets/claude/next/agents/code-reviewer.md +0 -62
- package/presets/claude/next/agents/debugger.md +0 -63
- package/presets/claude/next/agents/feature-developer.md +0 -27
- package/presets/claude/next/agents/migration-specialist.md +0 -69
- package/presets/claude/next/agents/performance-auditor.md +0 -68
- package/presets/claude/next/agents/qa-tester.md +0 -56
- package/presets/claude/next/agents/security-reviewer.md +0 -64
- package/presets/claude/next/agents/solution-architect.md +0 -70
- package/presets/claude/next/agents/task-analyst.md +0 -109
- package/presets/claude/next/agents/task-router.md +0 -94
- package/presets/claude/next/agents/tech-writer.md +0 -60
- package/presets/claude/next/agents/unit-test-generator.md +0 -37
- package/presets/claude/next/agents/unit-test-healer.md +0 -38
- package/presets/claude/next/agents/unit-test-planner.md +0 -62
- package/presets/claude/next/commands/feature-continue.md +0 -51
- package/presets/claude/next/commands/feature-start.md +0 -30
- package/presets/claude/next/commands/task-continue.md +0 -49
- package/presets/claude/next/commands/task.md +0 -50
- package/presets/claude/next/commands/technical-retro.md +0 -58
- package/presets/claude/next/hooks/chain-team-phases.sh +0 -342
- package/presets/claude/next/hooks/guard-shell-command.sh +0 -77
- package/presets/claude/next/hooks.json +0 -17
- package/presets/claude/next/rules/api-and-data/api-services.md +0 -57
- package/presets/claude/next/rules/api-and-data/http-client.md +0 -40
- package/presets/claude/next/rules/api-and-data/store-rtk.md +0 -65
- package/presets/claude/next/rules/architecture/api-public-imports.md +0 -8
- package/presets/claude/next/rules/architecture/architecture-boundaries-ui.md +0 -15
- package/presets/claude/next/rules/architecture/architecture-boundaries.md +0 -75
- package/presets/claude/next/rules/architecture/feature-delivery-workflow.md +0 -79
- package/presets/claude/next/rules/architecture/layer-barrel-exports.md +0 -58
- package/presets/claude/next/rules/architecture/public-imports.md +0 -46
- package/presets/claude/next/rules/architecture/reference-features.md +0 -37
- package/presets/claude/next/rules/architecture/types-public-imports.md +0 -8
- package/presets/claude/next/rules/stack/arrow-functions.md +0 -45
- package/presets/claude/next/rules/stack/navigation-router-ui.md +0 -15
- package/presets/claude/next/rules/stack/navigation-router.md +0 -62
- package/presets/claude/next/rules/stack/next-app-core.md +0 -33
- package/presets/claude/next/rules/stack/next-app-router.md +0 -36
- package/presets/claude/next/rules/stack/no-type-assertion.md +0 -59
- package/presets/claude/next/rules/stack/types-jsdoc.md +0 -37
- package/presets/claude/next/rules/testing/playwright-agents.md +0 -74
- package/presets/claude/next/rules/testing/tests-e2e-structure.md +0 -52
- package/presets/claude/next/rules/testing/tests-unit.md +0 -66
- package/presets/claude/next/rules/tooling-and-review/agent-team-intake.md +0 -15
- package/presets/claude/next/rules/tooling-and-review/agent-team-orchestrator.md +0 -140
- package/presets/claude/next/rules/tooling-and-review/code-quality.md +0 -42
- package/presets/claude/next/rules/tooling-and-review/code-review-mr.md +0 -30
- package/presets/claude/next/rules/tooling-and-review/package-manager.md +0 -11
- package/presets/claude/next/rules/tooling-and-review/post-change-lint.md +0 -33
- package/presets/claude/next/rules/ui-and-accessibility/css-property-order.md +0 -14
- package/presets/claude/next/rules/ui-and-accessibility/no-props-spread.md +0 -57
- package/presets/claude/next/rules/ui-and-accessibility/react-a11y-coding.md +0 -37
- package/presets/claude/next/rules/ui-and-accessibility/react-ui.md +0 -91
- package/presets/claude/next/skills/ci-investigation/SKILL.md +0 -36
- package/presets/claude/next/skills/code-review/SKILL.md +0 -26
- package/presets/claude/next/skills/debug-investigation/SKILL.md +0 -28
- package/presets/claude/next/skills/feature-delivery/SKILL.md +0 -15
- package/presets/claude/next/skills/playwright-e2e/SKILL.md +0 -31
- package/presets/claude/next/skills/technical-retro/SKILL.md +0 -40
- package/presets/claude/next/skills/unit-testing/SKILL.md +0 -32
- package/presets/claude/next/team/README.md +0 -47
- package/presets/claude/next/team/fixtures/bugfix-standard.json +0 -15
- package/presets/claude/next/team/fixtures/feature-full.json +0 -16
- package/presets/claude/next/team/fixtures/feature-light.json +0 -17
- package/presets/claude/next/team/tasks/.gitkeep +0 -1
- package/presets/cursor/next/AGENTS.md +0 -36
- package/presets/cursor/next/BUGBOT.md +0 -16
- package/presets/cursor/next/agents/README.md +0 -159
- package/presets/cursor/next/agents/accessibility-reviewer.md +0 -67
- package/presets/cursor/next/agents/api-contract-reviewer.md +0 -71
- package/presets/cursor/next/agents/build-verifier.md +0 -66
- package/presets/cursor/next/agents/ci-investigator.md +0 -64
- package/presets/cursor/next/agents/code-reviewer.md +0 -64
- package/presets/cursor/next/agents/debugger.md +0 -64
- package/presets/cursor/next/agents/feature-developer.md +0 -27
- package/presets/cursor/next/agents/migration-specialist.md +0 -71
- package/presets/cursor/next/agents/performance-auditor.md +0 -70
- package/presets/cursor/next/agents/playwright-test-generator.md +0 -26
- package/presets/cursor/next/agents/playwright-test-healer.md +0 -26
- package/presets/cursor/next/agents/playwright-test-planner.md +0 -28
- package/presets/cursor/next/agents/qa-tester.md +0 -57
- package/presets/cursor/next/agents/security-reviewer.md +0 -66
- package/presets/cursor/next/agents/solution-architect.md +0 -71
- package/presets/cursor/next/agents/task-analyst.md +0 -112
- package/presets/cursor/next/agents/task-router.md +0 -95
- package/presets/cursor/next/agents/tech-writer.md +0 -62
- package/presets/cursor/next/agents/unit-test-generator.md +0 -39
- package/presets/cursor/next/agents/unit-test-healer.md +0 -40
- package/presets/cursor/next/agents/unit-test-planner.md +0 -64
- package/presets/cursor/next/commands/feature-continue.md +0 -19
- package/presets/cursor/next/commands/feature-start.md +0 -33
- package/presets/cursor/next/commands/task-continue.md +0 -49
- package/presets/cursor/next/commands/task.md +0 -50
- package/presets/cursor/next/commands/technical-retro.md +0 -81
- package/presets/cursor/next/hooks/README.md +0 -8
- package/presets/cursor/next/hooks/chain-team-phases.sh +0 -380
- package/presets/cursor/next/hooks/guard-shell-command.sh +0 -77
- package/presets/cursor/next/hooks.json +0 -17
- package/presets/cursor/next/rules/agent-team-intake.mdc +0 -14
- package/presets/cursor/next/rules/agent-team-orchestrator.mdc +0 -139
- package/presets/cursor/next/rules/api-public-imports.mdc +0 -8
- package/presets/cursor/next/rules/architecture-boundaries-ui.mdc +0 -15
- package/presets/cursor/next/rules/arrow-functions.mdc +0 -46
- package/presets/cursor/next/rules/css-property-order-stylelint.mdc +0 -16
- package/presets/cursor/next/rules/feature-delivery-workflow.mdc +0 -76
- package/presets/cursor/next/rules/http-client.mdc +0 -42
- package/presets/cursor/next/rules/layer-barrel-exports.mdc +0 -59
- package/presets/cursor/next/rules/navigation-router-stack.mdc +0 -62
- package/presets/cursor/next/rules/navigation-router-ui.mdc +0 -16
- package/presets/cursor/next/rules/next-app-router.mdc +0 -36
- package/presets/cursor/next/rules/no-cross-component-styles-import.mdc +0 -8
- package/presets/cursor/next/rules/no-type-assertion-as-import-export.mdc +0 -60
- package/presets/cursor/next/rules/package-manager.mdc +0 -16
- package/presets/cursor/next/rules/post-change-lint.mdc +0 -38
- package/presets/cursor/next/rules/public-imports.mdc +0 -48
- package/presets/cursor/next/rules/react-a11y-coding.mdc +0 -37
- package/presets/cursor/next/rules/reference-features.mdc +0 -39
- package/presets/cursor/next/rules/technical-retro.mdc +0 -12
- package/presets/cursor/next/rules/types-jsdoc.mdc +0 -42
- package/presets/cursor/next/rules/types-public-imports.mdc +0 -8
- package/presets/cursor/next/skills/README.md +0 -15
- package/presets/cursor/next/skills/ci-investigation/SKILL.md +0 -36
- package/presets/cursor/next/skills/code-review/SKILL.md +0 -26
- package/presets/cursor/next/skills/debug-investigation/SKILL.md +0 -28
- package/presets/cursor/next/skills/feature-delivery/SKILL.md +0 -15
- package/presets/cursor/next/skills/playwright-e2e/SKILL.md +0 -31
- package/presets/cursor/next/skills/technical-retro/SKILL.md +0 -40
- package/presets/cursor/next/skills/unit-testing/SKILL.md +0 -32
- package/presets/cursor/next/team/README.md +0 -105
- package/presets/cursor/next/team/fixtures/bugfix-standard.json +0 -15
- package/presets/cursor/next/team/fixtures/feature-full.json +0 -16
- package/presets/cursor/next/team/fixtures/feature-light.json +0 -17
- package/presets/cursor/next/team/tasks/.gitkeep +0 -0
- package/scripts/README.md +0 -84
- package/scripts/golden-prompts.json +0 -276
- package/scripts/preset-manifest.json +0 -72
- package/scripts/regression-results/.gitkeep +0 -0
- package/scripts/validate-preset.sh +0 -484
|
@@ -1,38 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: Обязательный прогон ESLint и Stylelint после любых изменений кода
|
|
3
|
-
alwaysApply: true
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Линтеры после изменений кода
|
|
7
|
-
|
|
8
|
-
## Когда применять
|
|
9
|
-
|
|
10
|
-
После **любого** изменения исходников в `app/**` (TS/TSX/JS/MJS, CSS, styled/Linaria в `.ts`/`.tsx`).
|
|
11
|
-
|
|
12
|
-
Исключения: правки документации вне `app/`, конфигов CI, `.cursor/rules/**`, если исполняемый код приложения не менялся.
|
|
13
|
-
|
|
14
|
-
**Pipeline exception:** если задача идёт через agent team и следующий шаг — `build-verifier`, developer может ограничиться lint/type-check **изменённых файлов**; полный прогон — обязанность `build-verifier`. В single-agent режиме (без pipeline) — всегда полный прогон.
|
|
15
|
-
|
|
16
|
-
## Обязательные команды
|
|
17
|
-
|
|
18
|
-
Рабочий каталог — **`app/`**. Менеджер пакетов — **`package-manager.mdc`**.
|
|
19
|
-
|
|
20
|
-
1. **`lint:js`** — полный ESLint по проекту.
|
|
21
|
-
2. **`lint:css`** — полный Stylelint (`**/*.{css,ts}`).
|
|
22
|
-
|
|
23
|
-
Точечный lint на один файл **не заменяет** полный прогон перед завершением задачи (кроме pipeline exception выше).
|
|
24
|
-
|
|
25
|
-
## Алгоритм
|
|
26
|
-
|
|
27
|
-
1. Завершить правки кода.
|
|
28
|
-
2. Запустить **`lint:js`** и **`lint:css`** из `app/`.
|
|
29
|
-
3. Проанализировать весь вывод; исправить errors/warnings в изменённых файлах; для Stylelint — **`lint:css --fix`** если автоисправимо.
|
|
30
|
-
4. Повторить до exit code 0 или зафиксировать блокер в ответе пользователю.
|
|
31
|
-
5. **`type-check`** при изменениях TypeScript. CI-уровень: **`lint`** (= `lint:js` + `lint:css` + `type-check`).
|
|
32
|
-
|
|
33
|
-
## Что исправлять
|
|
34
|
-
|
|
35
|
-
- **Errors** — обязательно.
|
|
36
|
-
- **Warnings** — обязательно в файлах задачи; вне скоупа — упомянуть, если мешают нулевому exit code.
|
|
37
|
-
|
|
38
|
-
Конфиги: `app/eslint.config.mjs`, `app/.stylelintrc` (порядок CSS — `css-property-order-stylelint.mdc`).
|
|
@@ -1,48 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: Импорт доменных типов и API только через публичные barrel @/types и @/api
|
|
3
|
-
globs:
|
|
4
|
-
- app/src/ui/**/*
|
|
5
|
-
- app/src/store/**/*
|
|
6
|
-
- app/src/lib/**/*
|
|
7
|
-
- app/src/types/**/*
|
|
8
|
-
- app/src/api/**/*
|
|
9
|
-
alwaysApply: false
|
|
10
|
-
---
|
|
11
|
-
|
|
12
|
-
# Публичные импорты (`@/types`, `@/api`)
|
|
13
|
-
|
|
14
|
-
**Коллизии:** импорт типов — раздел `@/types` ниже; API вне `app/src/api/**` — раздел `@/api` ниже (дублирует ESLint `no-restricted-imports` в `app/eslint.config.mjs`).
|
|
15
|
-
|
|
16
|
-
## `@/types`
|
|
17
|
-
|
|
18
|
-
- **Публичный API типов** — barrel `app/src/types/index.ts`; импортировать типы только как `@/types` (или `@/types/index`).
|
|
19
|
-
- **Запрещено** обходить barrel: `@/types/<что‑угодно>`, кроме enum.
|
|
20
|
-
- **Enum** — только `@/types/enums` / `@/types/enums.ts`.
|
|
21
|
-
- Внутри `app/src/types/**` — относительные импорты между файлами слоя.
|
|
22
|
-
|
|
23
|
-
```typescript
|
|
24
|
-
// ✅
|
|
25
|
-
import type { TUserProfile } from '@/types'
|
|
26
|
-
import { SomeEnum } from '@/types/enums'
|
|
27
|
-
|
|
28
|
-
// ❌
|
|
29
|
-
import type { TUserProfile } from '@/types/User.types'
|
|
30
|
-
```
|
|
31
|
-
|
|
32
|
-
Новые публичные типы — реэкспорт в `app/src/types/index.ts` по **`layer-barrel-exports.mdc`**.
|
|
33
|
-
|
|
34
|
-
## `@/api`
|
|
35
|
-
|
|
36
|
-
- **Публичный API** — barrel `app/src/api/index.ts`. Вне `app/src/api/**` — только `import … from '@/api'` (или `@/api/index`).
|
|
37
|
-
- **Запрещено** снаружи слоя: `@/api/<что‑угодно>`, кроме `@/api/index`.
|
|
38
|
-
- Внутри `app/src/api/**` — относительные импорты и `@/api/services/**`, `@/api/clients/**`.
|
|
39
|
-
|
|
40
|
-
```typescript
|
|
41
|
-
// ✅ в store, UI, lib вне app/src/api
|
|
42
|
-
import { MedcardApiService } from '@/api'
|
|
43
|
-
|
|
44
|
-
// ❌ снаружи app/src/api
|
|
45
|
-
import { MedcardApiService } from '@/api/services/MedcardApiService/MedcardApiService'
|
|
46
|
-
```
|
|
47
|
-
|
|
48
|
-
Новые публичные символы API — реэкспорт в `app/src/api/index.ts` по **`layer-barrel-exports.mdc`**.
|
|
@@ -1,37 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: Accessibility при написании React UI — семантика, формы, focus, keyboard
|
|
3
|
-
globs: app/src/ui/**/*.tsx,app/src/ui/**/*.ts
|
|
4
|
-
alwaysApply: false
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# A11y при разработке UI
|
|
8
|
-
|
|
9
|
-
Reviewer (`accessibility-reviewer`) проверяет diff; эти правила — **при написании** кода.
|
|
10
|
-
|
|
11
|
-
## Семантика и ARIA
|
|
12
|
-
|
|
13
|
-
- Предпочитать **нативные элементы** (`button`, `a`, `label`, `input`) вместо `div` с `onClick`.
|
|
14
|
-
- **`role` / `aria-*`** — только когда нативного аналога нет; не дублировать то, что даёт семантика.
|
|
15
|
-
- Заголовки — иераархия `h1`–`h6` без пропусков уровней ради стилей.
|
|
16
|
-
|
|
17
|
-
## Формы
|
|
18
|
-
|
|
19
|
-
- Каждый input связан с **`label`** (`htmlFor` / `id` или обёртка).
|
|
20
|
-
- Сообщения об ошибках — **`aria-describedby`**, `aria-invalid` при validation errors.
|
|
21
|
-
- Кнопки submit vs button — явный `type`.
|
|
22
|
-
|
|
23
|
-
## Клавиатура и focus
|
|
24
|
-
|
|
25
|
-
- Все интерактивные элементы **достижимы с Tab** и активируются Enter/Space где ожидается.
|
|
26
|
-
- **Modals/drawers** — focus trap, возврат focus на trigger при закрытии, Esc закрывает (если по UX).
|
|
27
|
-
- Не удалять видимый **focus outline** без замены на доступный custom focus style.
|
|
28
|
-
|
|
29
|
-
## Контент
|
|
30
|
-
|
|
31
|
-
- Изображения — **`alt`** (пустой `alt` только для декора).
|
|
32
|
-
- Иконки-кнопки — **`aria-label`** или visually hidden text.
|
|
33
|
-
- Динамические обновления — `aria-live` для критичных status/error (умеренно).
|
|
34
|
-
|
|
35
|
-
## Проверка
|
|
36
|
-
|
|
37
|
-
- При сомнении — devtools a11y tree или `accessibility-reviewer` в pipeline для UI-heavy фич.
|
|
@@ -1,39 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: Эталонные фичи репозитория — копировать структуру при реализации новых задач. Заполните пути после init в целевом репо.
|
|
3
|
-
globs:
|
|
4
|
-
- app/src/ui/**/*
|
|
5
|
-
- app/src/store/**/*
|
|
6
|
-
- app/src/api/**/*
|
|
7
|
-
- app/src/types/**/*
|
|
8
|
-
alwaysApply: false
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
# Эталонные фичи (reference features)
|
|
12
|
-
|
|
13
|
-
Перед реализацией найди фичу того же типа и **повтори её структуру**, не изобретая новую организацию файлов.
|
|
14
|
-
|
|
15
|
-
## Таблица эталонов
|
|
16
|
-
|
|
17
|
-
Замени **TBD** на реальные пути после договорённости в команде (или при `ai-rules init` в целевом репо):
|
|
18
|
-
|
|
19
|
-
| Слой | Эталон | Что копировать |
|
|
20
|
-
|------|--------|----------------|
|
|
21
|
-
| UI page | **TBD** `app/src/ui/pages/<Example>/` | `components/`, `*.data.ts`, `styles.ts`, barrel |
|
|
22
|
-
| Store slice | **TBD** `app/src/store/slices/<example>/` | slice, thunks, selectors, types |
|
|
23
|
-
| API service | **TBD** `app/src/api/services/<example>/` | service, mappers, barrel |
|
|
24
|
-
| Types module | **TBD** `app/src/types/<example>/` | domain types, JSDoc, barrel export |
|
|
25
|
-
| Unit tests | **TBD** рядом с эталонным mapper/service | `*.spec.ts`, describe/it naming |
|
|
26
|
-
| E2E area | **TBD** `app/__tests__/e2e/<Area>/` | `*.cases.md`, page objects, `_shared/` |
|
|
27
|
-
|
|
28
|
-
## Как использовать
|
|
29
|
-
|
|
30
|
-
1. Определи затронутые слои из `decomposition.md` или задачи.
|
|
31
|
-
2. Открой эталон из таблицы (после заполнения путей).
|
|
32
|
-
3. Зеркаль именование, порядок файлов, паттерны импортов и тестов.
|
|
33
|
-
4. Если эталона нет — выбери **самую близкую** существующую фичу того же слоя и зафиксируй выбор в handoff.
|
|
34
|
-
|
|
35
|
-
## Связанные правила
|
|
36
|
-
|
|
37
|
-
- `code-quality-and-refactoring.mdc` — повторять паттерны, не deep-import.
|
|
38
|
-
- `feature-delivery-workflow.mdc` — порядок слоёв.
|
|
39
|
-
- skill `feature-delivery` — end-to-end сценарий.
|
|
@@ -1,12 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: Роль агента для проведения технического ретроспективы (retro) команды / спринта. On-demand — предпочтительнее slash-команда /technical-retro.
|
|
3
|
-
alwaysApply: false
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Техническое ретро — rule alias
|
|
7
|
-
|
|
8
|
-
Полный сценарий (включая блок **«Работа агентов»** для slug из `.cursor/team/tasks/`) — в slash-комmand:
|
|
9
|
-
|
|
10
|
-
**`.cursor/commands/technical-retro.md`** → `/technical-retro`
|
|
11
|
-
|
|
12
|
-
Используй rule только если command недоступен. Не дублируй содержимое command в ответе — следуй command-файлу.
|
|
@@ -1,42 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: Стиль JSDoc для доменных и транспортных типов в app/src/types
|
|
3
|
-
globs: app/src/types/**/*.ts
|
|
4
|
-
alwaysApply: false
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# Документация типов в `app/src/types`
|
|
8
|
-
|
|
9
|
-
При добавлении или существенном изменении типов в этом слое **следовать уже принятому в репозитории стилю JSDoc** (см. примеры: `User.types.ts`, `Common.types.ts`, `ServerValidation.types.ts`, `TreatmentPlan/*.types.ts`).
|
|
10
|
-
|
|
11
|
-
## Язык и форма
|
|
12
|
-
|
|
13
|
-
- Текст комментариев — **на русском**, кратко и по делу: что означает тип или поле в предметной области или в контракте с API.
|
|
14
|
-
- **Не опираться** на теги в духе `@param`, `@returns`, `@see`, `@deprecated` для описания типов — в этом слое они **не используются**; достаточно обычного текста в `/** … */`.
|
|
15
|
-
|
|
16
|
-
## Экспортируемый `type` / `interface`
|
|
17
|
-
|
|
18
|
-
- Сразу **перед объявлением** — блок `/** … */`.
|
|
19
|
-
- Если нужно пояснить источник данных, ограничения или неочевидности — **второй абзац** в том же блоке (в JSDoc для абзаца — пустая строка между строками текста).
|
|
20
|
-
- Для **вложенных** объектов в том же файле каждый такой тип документируется отдельным блоком над своим объявлением.
|
|
21
|
-
|
|
22
|
-
## Поля
|
|
23
|
-
|
|
24
|
-
- У **каждого** публичного свойства — **однострочный** `/** … */` на строке непосредственно **над** полем.
|
|
25
|
-
- Если поле **не приходит с бэкенда «как есть»**, а вычисляется или дополняется на фронте (маппер, селектор, UI) — начать описание с префикса **`[computed]`** (как в `TUserProfile`, типах плана лечения).
|
|
26
|
-
- Для форматов данных указывать это **в тексте**: например дата `YYYY-MM-DD`, пример отображаемой строки в кавычках.
|
|
27
|
-
|
|
28
|
-
## Классы и прочие объявления
|
|
29
|
-
|
|
30
|
-
- Для **классов** (например ошибки транспорта) при изменении публичного API — краткий блок над классом и **комментарии к публичным полям** по тем же правилам, что у свойств интерфейса.
|
|
31
|
-
|
|
32
|
-
## `enum`
|
|
33
|
-
|
|
34
|
-
- В `enums.ts` исторически часто **без JSDoc** на каждом члене; для новых enum допустимо короткое описание **над самим enum**, если назначение неочевидно из имени. Подписи для UI — как принято, через объекты `*Names` рядом с enum.
|
|
35
|
-
|
|
36
|
-
## Практика для агента
|
|
37
|
-
|
|
38
|
-
- Добавляя новый тип или поле, **не оставлять** новые публичные поля без пояснения, если смысл не равен имени на 100%.
|
|
39
|
-
- Правя файл, где уже есть такие комментарии, **поддерживать тот же стиль**, а не смешивать с англоязычными или «теговыми» блоками.
|
|
40
|
-
- Не раздувать комментарии: одна-две фразы на тип, одна строка на поле — норма; исключение — действительно сложная доменная оговорка.
|
|
41
|
-
|
|
42
|
-
См. также импорты и barrel: `public-imports.mdc`.
|
|
@@ -1,15 +0,0 @@
|
|
|
1
|
-
# `.cursor/skills` (preset next)
|
|
2
|
-
|
|
3
|
-
Project skills for Cursor. They keep long workflows out of always-on rules while preserving the same team conventions as the Claude preset.
|
|
4
|
-
|
|
5
|
-
| Skill | When to use |
|
|
6
|
-
|-------|-------------|
|
|
7
|
-
| `feature-delivery` | End-to-end feature work across types, API, store, UI, tests |
|
|
8
|
-
| `code-review` | MR/diff review using project architecture and test standards |
|
|
9
|
-
| `debug-investigation` | Reproducing and fixing bugs with root-cause evidence |
|
|
10
|
-
| `ci-investigation` | Diagnosing and fixing failing CI checks on PRs/branches |
|
|
11
|
-
| `unit-testing` | Planning, generating, or healing unit test coverage |
|
|
12
|
-
| `playwright-e2e` | Planning, generating, or healing Playwright e2e coverage |
|
|
13
|
-
| `technical-retro` | Technical retrospective for a task, sprint, incident, or agent pipeline |
|
|
14
|
-
|
|
15
|
-
Skills are copied to `.cursor/skills/` by `ai-rules init cursor --preset next`.
|
|
@@ -1,36 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: ci-investigation
|
|
3
|
-
description: Investigates failing CI checks on PRs and branches — lint, type-check, unit, e2e — with local reproduction and minimal fixes. Use when CI is red or for ci-fix pipeline tasks.
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# CI Investigation
|
|
7
|
-
|
|
8
|
-
## Workflow
|
|
9
|
-
|
|
10
|
-
1. Identify the **first failing check** (lint, type-check, unit, e2e, build).
|
|
11
|
-
2. Capture error output — ignore cascading failures until root cause is found.
|
|
12
|
-
3. Reproduce locally with the same commands CI uses from `app/`:
|
|
13
|
-
- `lint:js`, `lint:css`, `type-check`
|
|
14
|
-
- targeted unit test file or suite
|
|
15
|
-
- affected Playwright spec if e2e failed
|
|
16
|
-
4. Inspect git diff for changed files related to the failure.
|
|
17
|
-
5. Apply **minimal fix** — no unrelated refactors.
|
|
18
|
-
|
|
19
|
-
## Artifact
|
|
20
|
-
|
|
21
|
-
Write `ci-report.md` under the task slug folder:
|
|
22
|
-
|
|
23
|
-
- Failed check name and link/log excerpt
|
|
24
|
-
- Root cause classification
|
|
25
|
-
- Fix applied (or handoff to feature-developer)
|
|
26
|
-
- Validation commands and results
|
|
27
|
-
|
|
28
|
-
## Handoff Rules
|
|
29
|
-
|
|
30
|
-
- Config-only or one-line fixes → fix in place, re-run check.
|
|
31
|
-
- Missing tests or architecture work → document and route to `feature-developer` or `qa-tester`.
|
|
32
|
-
- Flaky e2e → prefer `playwright-test-healer` after ci-investigator identifies the spec.
|
|
33
|
-
|
|
34
|
-
## Validation
|
|
35
|
-
|
|
36
|
-
Always re-run the failing command locally before marking complete. If environment blocks execution, state the exact command and blocker.
|
|
@@ -1,26 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: code-review
|
|
3
|
-
description: Reviews pull requests, merge requests, git diffs, and branch changes using the preset's architecture, import, UI, API, and testing standards. Use when the user asks for review or when code-reviewer runs in an agent pipeline.
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Code Review
|
|
7
|
-
|
|
8
|
-
## Inputs
|
|
9
|
-
|
|
10
|
-
Use the local repository as the source of truth: `git status`, `git diff`, task artifacts under `.cursor/team/tasks/<slug>/` when present, and opened files. Do not invent hosting metadata such as labels, CI status, or reviewers.
|
|
11
|
-
|
|
12
|
-
## Review Order
|
|
13
|
-
|
|
14
|
-
1. Understand the intent and affected layers.
|
|
15
|
-
2. Check correctness and regressions first.
|
|
16
|
-
3. Verify architecture boundaries: UI does not know DTO/transport, store does not depend on UI, API services do not pull UI/store.
|
|
17
|
-
4. Check public imports through `@/types` and `@/api`, plus barrel updates for new public symbols.
|
|
18
|
-
5. Review UI consistency, styling conventions, and prop shape.
|
|
19
|
-
6. Check tests: unit for mapper/domain logic, behavior tests for HTTP client changes, e2e plan/spec updates for user flows.
|
|
20
|
-
7. Report validation gaps: lint, stylelint, type-check, or relevant tests not run.
|
|
21
|
-
|
|
22
|
-
## Output
|
|
23
|
-
|
|
24
|
-
Lead with findings ordered by severity. Each finding should include the file, the problem, impact, and a concrete fix direction. If there are no findings, say so and call out remaining test or validation risk.
|
|
25
|
-
|
|
26
|
-
For agent team tasks, write `.cursor/team/tasks/<slug>/review.md` and set `status.json` to `completed` or `changes_requested`.
|
|
@@ -1,28 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: debug-investigation
|
|
3
|
-
description: Investigates bugs, failing tests, crashes, and incorrect behavior with runtime evidence before applying minimal fixes. Use for bugfix tasks, debugger agent runs, regressions, and flaky test diagnosis.
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Debug Investigation
|
|
7
|
-
|
|
8
|
-
## Process
|
|
9
|
-
|
|
10
|
-
1. Reproduce the issue or collect the closest available evidence: error output, failing test, browser snapshot, logs, or user steps.
|
|
11
|
-
2. Define expected vs actual behavior in one sentence.
|
|
12
|
-
3. Trace the failing path through the smallest relevant slice of the codebase.
|
|
13
|
-
4. Identify the root cause before editing. Avoid broad refactors during bugfixes.
|
|
14
|
-
5. Apply the smallest fix that preserves existing architecture and public contracts.
|
|
15
|
-
6. Add or update a regression test when the behavior is user-facing or likely to recur.
|
|
16
|
-
7. Run the narrow failing check first, then relevant lint/type/test validation.
|
|
17
|
-
|
|
18
|
-
## Artifacts
|
|
19
|
-
|
|
20
|
-
For agent team tasks, write `.cursor/team/tasks/<slug>/debug-report.md` with:
|
|
21
|
-
|
|
22
|
-
- Reproduction steps or evidence source.
|
|
23
|
-
- Root cause.
|
|
24
|
-
- Fix scope.
|
|
25
|
-
- Regression coverage.
|
|
26
|
-
- Remaining risk.
|
|
27
|
-
|
|
28
|
-
Update `status.json` when complete.
|
|
@@ -1,15 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: feature-delivery
|
|
3
|
-
description: Delivers Next.js frontend features end-to-end across domain types, API services, store, UI, mocks, tests, and validation. Use when implementing or extending a feature, especially through /task or feature-developer.
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Feature Delivery
|
|
7
|
-
|
|
8
|
-
1. Read task brief, acceptance criteria, and decomposition if present.
|
|
9
|
-
2. Read **`feature-delivery-workflow.mdc`** and **`reference-features.mdc`** — follow layer order and mirror closest reference feature.
|
|
10
|
-
3. Add or update focused tests for changed behavior.
|
|
11
|
-
4. Validation from `app/`: see **`post-change-lint.mdc`** (pipeline: scoped lint OK if next step is `build-verifier`).
|
|
12
|
-
|
|
13
|
-
## Handoff
|
|
14
|
-
|
|
15
|
-
Summarize by layer, validation results, and known gaps. Agent team: update `.cursor/team/tasks/<slug>/status.json`.
|
|
@@ -1,31 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: playwright-e2e
|
|
3
|
-
description: Plans, generates, and heals Playwright e2e tests using this preset's app/__tests__/e2e layout, *.cases.md plans, page objects, and shared helpers. Use for e2e planning, test generation, or fixing failing browser tests.
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Playwright E2E
|
|
7
|
-
|
|
8
|
-
## Project Layout
|
|
9
|
-
|
|
10
|
-
- Test root: `app/__tests__/e2e`.
|
|
11
|
-
- Test plans: `*.cases.md` files under the matching feature folder.
|
|
12
|
-
- Executable specs: `*.spec.ts` files in the same folder.
|
|
13
|
-
- Seed/setup reference: `app/__tests__/e2e/seed.spec.ts`.
|
|
14
|
-
|
|
15
|
-
Do not introduce top-level `specs/` or `tests/` folders for real coverage unless the user explicitly asks for a sandbox.
|
|
16
|
-
|
|
17
|
-
## Planner
|
|
18
|
-
|
|
19
|
-
Create or update the relevant `*.cases.md` file. Each scenario should include title, preconditions, steps, and expected result. Cover happy path, important edge cases, validation, and error states.
|
|
20
|
-
|
|
21
|
-
## Generator
|
|
22
|
-
|
|
23
|
-
Generate specs from `*.cases.md` into the same folder. Reuse existing page objects and `_shared/` helpers. Keep test names aligned with scenario names.
|
|
24
|
-
|
|
25
|
-
## Healer
|
|
26
|
-
|
|
27
|
-
Fix selectors, waits, setup, or page-object details without weakening business assertions. Use the matching `*.cases.md` file as the behavior contract.
|
|
28
|
-
|
|
29
|
-
## Validation
|
|
30
|
-
|
|
31
|
-
Run the affected spec when feasible. If the environment blocks execution, report the command that should be run and the blocker.
|
|
@@ -1,40 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: technical-retro
|
|
3
|
-
description: Facilitates technical retrospectives for tasks, sprints, incidents, releases, and agent-team pipelines. Use when the user asks for retro, postmortem, process review, or action items after delivery.
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Technical Retro
|
|
7
|
-
|
|
8
|
-
## Inputs
|
|
9
|
-
|
|
10
|
-
Ask for missing period, focus, task slug, participants, or format constraints. If a slug is provided, read `.cursor/team/tasks/<slug>/` artifacts and local git status/diff. Do not invent facts not present in artifacts or the user's message.
|
|
11
|
-
|
|
12
|
-
## Facilitation Principles
|
|
13
|
-
|
|
14
|
-
- Focus on process and system behavior, not blame.
|
|
15
|
-
- Separate facts, interpretations, and proposed actions.
|
|
16
|
-
- Balance what worked with what slowed delivery.
|
|
17
|
-
- Keep action items concrete, owned, and measurable.
|
|
18
|
-
|
|
19
|
-
## Default Structure
|
|
20
|
-
|
|
21
|
-
1. Goal and scope.
|
|
22
|
-
2. Timeline or factual observations.
|
|
23
|
-
3. What worked.
|
|
24
|
-
4. What hurt quality, speed, or confidence.
|
|
25
|
-
5. Root causes for the top one or two issues.
|
|
26
|
-
6. Experiments and action items.
|
|
27
|
-
|
|
28
|
-
## Agent Team Block
|
|
29
|
-
|
|
30
|
-
For `/task` pipelines, include router, analyst, developer, **build-verifier**, reviewer, QA/e2e, hooks, and rules.
|
|
31
|
-
|
|
32
|
-
## Preset feedback loop
|
|
33
|
-
|
|
34
|
-
If the same issue appeared in 2+ tasks, add section **Preset updates**:
|
|
35
|
-
|
|
36
|
-
- Proposed change to `.cursor/rules/`, `.cursor/agents/`, or `.cursor/skills/`
|
|
37
|
-
- One concrete diff or file path to update
|
|
38
|
-
- Whether it belongs in always-on rules vs globs vs skill
|
|
39
|
-
|
|
40
|
-
Do not apply preset changes without user approval.
|
|
@@ -1,32 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: unit-testing
|
|
3
|
-
description: Plans, generates, and heals unit tests for mappers, thunks, HTTP client behavior, and React components using colocated *.spec.ts files and tests-unit rules. Use for unit test planning, generation, or fixing failing unit tests.
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Unit Testing
|
|
7
|
-
|
|
8
|
-
## Project Layout
|
|
9
|
-
|
|
10
|
-
- Specs colocated with source: `*.spec.ts` / `*.spec.tsx` next to the module under test.
|
|
11
|
-
- Legacy `*.test.ts` / `*.test.tsx` — do not rename without a separate task.
|
|
12
|
-
- Runner: Jest or Vitest as configured in the target repo; components use `@testing-library/react`.
|
|
13
|
-
|
|
14
|
-
Follow **`tests-unit.mdc`** (Cursor) or **`rules/testing/tests-unit.md`** (Claude).
|
|
15
|
-
|
|
16
|
-
## Planner
|
|
17
|
-
|
|
18
|
-
Write or update `.cursor/team/tasks/<slug>/unit-test-plan.md` (or `.claude/team/...`).
|
|
19
|
-
|
|
20
|
-
Each scenario needs a Russian `it()` title (capital letter after each sentence). Cover mappers, thunks, client behavior branches, and component interactions per AC.
|
|
21
|
-
|
|
22
|
-
## Generator
|
|
23
|
-
|
|
24
|
-
Implement specs from `unit-test-plan.md`. Reuse project test-store, HTTP mocks, and existing test utilities. Do not change production code.
|
|
25
|
-
|
|
26
|
-
## Healer
|
|
27
|
-
|
|
28
|
-
Fix mocks, async timing, selectors, and setup — preserve business assertions. Use `unit-test-plan.md` and `brief.md` as the behavior contract.
|
|
29
|
-
|
|
30
|
-
## Validation
|
|
31
|
-
|
|
32
|
-
Run affected unit tests from `app/` when feasible. Report command, pass/fail, and remaining gaps vs plan.
|
|
@@ -1,105 +0,0 @@
|
|
|
1
|
-
# Agent team artifacts
|
|
2
|
-
|
|
3
|
-
Каталог артефактов пайплайна «команда агентов» Cursor.
|
|
4
|
-
|
|
5
|
-
## Layout
|
|
6
|
-
|
|
7
|
-
```
|
|
8
|
-
.cursor/team/
|
|
9
|
-
active-task.json
|
|
10
|
-
fixtures/ # pipeline profile examples (feature-full, feature-light, bugfix-standard)
|
|
11
|
-
tasks/
|
|
12
|
-
<slug>/
|
|
13
|
-
pipeline.json
|
|
14
|
-
status.json
|
|
15
|
-
brief.md
|
|
16
|
-
decomposition.md
|
|
17
|
-
debug-report.md # fixApplied: true/false
|
|
18
|
-
validation-report.md # build-verifier: PASS | FAIL
|
|
19
|
-
architecture.md
|
|
20
|
-
migration-plan.md
|
|
21
|
-
ci-report.md
|
|
22
|
-
a11y-review.md
|
|
23
|
-
perf-report.md
|
|
24
|
-
security-review.md
|
|
25
|
-
api-contract-review.md
|
|
26
|
-
unit-test-plan.md
|
|
27
|
-
documentation.md
|
|
28
|
-
review.md
|
|
29
|
-
```
|
|
30
|
-
|
|
31
|
-
## pipeline.json schema
|
|
32
|
-
|
|
33
|
-
```json
|
|
34
|
-
{
|
|
35
|
-
"slug": "order-history-date-filter",
|
|
36
|
-
"intent": "feature",
|
|
37
|
-
"summary": "Add date filter to Order History",
|
|
38
|
-
"steps": [
|
|
39
|
-
{ "agent": "task-analyst", "label": "Clarify and decompose" },
|
|
40
|
-
{ "agent": "feature-developer", "label": "Implement + unit tests", "scope": "unit-in-dev" },
|
|
41
|
-
{ "agent": "build-verifier", "label": "Validation gate" },
|
|
42
|
-
{ "agent": "code-reviewer", "label": "Code review" },
|
|
43
|
-
{ "agent": "qa-tester", "label": "E2E", "scope": "e2e-only" }
|
|
44
|
-
],
|
|
45
|
-
"humanGates": ["after:task-analyst"],
|
|
46
|
-
"autoChain": true,
|
|
47
|
-
"skipped": []
|
|
48
|
-
}
|
|
49
|
-
```
|
|
50
|
-
|
|
51
|
-
### Step fields
|
|
52
|
-
|
|
53
|
-
| Field | Description |
|
|
54
|
-
|-------|-------------|
|
|
55
|
-
| `agent` | kebab-case name or array when `parallel: true` |
|
|
56
|
-
| `label` | Human-readable step name |
|
|
57
|
-
| `scope` | Passed to agents (e.g. `unit-in-dev`, `e2e-only`) |
|
|
58
|
-
| `skipIf` | `debugger.fixed` \| `ci-investigator.resolved` |
|
|
59
|
-
| `parallel` | Invoke all `agent` values in one parent turn |
|
|
60
|
-
|
|
61
|
-
## status.json (pipeline mode)
|
|
62
|
-
|
|
63
|
-
```json
|
|
64
|
-
{
|
|
65
|
-
"slug": "order-history-date-filter",
|
|
66
|
-
"intent": "feature",
|
|
67
|
-
"pipelineIndex": 0,
|
|
68
|
-
"currentAgent": "task-analyst",
|
|
69
|
-
"phase": "executing",
|
|
70
|
-
"state": "in_progress",
|
|
71
|
-
"awaitingHumanGate": false,
|
|
72
|
-
"parallelCompleted": [],
|
|
73
|
-
"retryAfterFix": null,
|
|
74
|
-
"updatedAt": "2026-05-29T12:00:00.000Z"
|
|
75
|
-
}
|
|
76
|
-
```
|
|
77
|
-
|
|
78
|
-
### phase
|
|
79
|
-
|
|
80
|
-
Prefer **`executing`** for pipeline mode. Legacy: `analysis`, `development`, `review`, `testing`, `done`.
|
|
81
|
-
|
|
82
|
-
### state
|
|
83
|
-
|
|
84
|
-
| Value | Description |
|
|
85
|
-
|-------|-------------|
|
|
86
|
-
| `in_progress` | Current step running |
|
|
87
|
-
| `completed` | Current step finished |
|
|
88
|
-
| `awaiting_approval` | Human gate; use `/task-continue` |
|
|
89
|
-
| `changes_requested` | Reviewer requires fixes |
|
|
90
|
-
| `validation_failed` | build-verifier failed |
|
|
91
|
-
| `approved` | Legacy continue |
|
|
92
|
-
|
|
93
|
-
## Workflow entry
|
|
94
|
-
|
|
95
|
-
```bash
|
|
96
|
-
/task <описание задачи>
|
|
97
|
-
/task-continue <slug>
|
|
98
|
-
/technical-retro <slug>
|
|
99
|
-
```
|
|
100
|
-
|
|
101
|
-
Legacy: `/feature-start`, `/feature-continue`.
|
|
102
|
-
|
|
103
|
-
## Git
|
|
104
|
-
|
|
105
|
-
Commit task artifacts if you want them to survive `ai-rules clean cursor`. Or copy finished tasks to `docs/agent-workflow/tasks/<slug>/`.
|
|
@@ -1,15 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"slug": "example-bugfix-standard",
|
|
3
|
-
"intent": "bugfix",
|
|
4
|
-
"profile": "standard",
|
|
5
|
-
"summary": "Regression fix with review",
|
|
6
|
-
"steps": [
|
|
7
|
-
{ "agent": "debugger", "label": "Root cause" },
|
|
8
|
-
{ "agent": "feature-developer", "label": "Fix if needed", "skipIf": "debugger.fixed" },
|
|
9
|
-
{ "agent": "build-verifier", "label": "Validation gate" },
|
|
10
|
-
{ "agent": "code-reviewer", "label": "Code review" }
|
|
11
|
-
],
|
|
12
|
-
"humanGates": [],
|
|
13
|
-
"autoChain": true,
|
|
14
|
-
"skipped": []
|
|
15
|
-
}
|
|
@@ -1,16 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"slug": "example-feature-full",
|
|
3
|
-
"intent": "feature",
|
|
4
|
-
"profile": "full",
|
|
5
|
-
"summary": "Multi-layer feature with e2e coverage",
|
|
6
|
-
"steps": [
|
|
7
|
-
{ "agent": "task-analyst", "label": "Clarify and decompose" },
|
|
8
|
-
{ "agent": "feature-developer", "label": "Implement + unit tests", "scope": "unit-in-dev" },
|
|
9
|
-
{ "agent": "build-verifier", "label": "Validation gate" },
|
|
10
|
-
{ "agent": "code-reviewer", "label": "Code review" },
|
|
11
|
-
{ "agent": "qa-tester", "label": "E2E", "scope": "e2e-only" }
|
|
12
|
-
],
|
|
13
|
-
"humanGates": ["after:task-analyst"],
|
|
14
|
-
"autoChain": true,
|
|
15
|
-
"skipped": []
|
|
16
|
-
}
|
|
@@ -1,17 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"slug": "example-feature-light",
|
|
3
|
-
"intent": "feature",
|
|
4
|
-
"profile": "light",
|
|
5
|
-
"summary": "Trivial single-file change with explicit AC",
|
|
6
|
-
"steps": [
|
|
7
|
-
{ "agent": "feature-developer", "label": "Implement" },
|
|
8
|
-
{ "agent": "build-verifier", "label": "Validation gate" }
|
|
9
|
-
],
|
|
10
|
-
"humanGates": [],
|
|
11
|
-
"autoChain": true,
|
|
12
|
-
"skipped": [
|
|
13
|
-
{ "agent": "task-analyst", "reason": "Explicit AC and single-file scope" },
|
|
14
|
-
{ "agent": "code-reviewer", "reason": "Light profile — non-trivial app changes should use standard" },
|
|
15
|
-
{ "agent": "qa-tester", "reason": "No e2e AC" }
|
|
16
|
-
]
|
|
17
|
-
}
|
|
File without changes
|