@bonesofspring/ai-rules 0.2.14 → 0.2.16

package/presets/cursor/ios-swift/rules/xcode-tooling.mdc

@@ -1,20 +1,20 @@
 ---
-description: Перед xcodebuild / SwiftLint / SwiftFormat определять toolchain и схемы репозитория и использовать только их
+description: Before xcodebuild / SwiftLint / SwiftFormat, detect the repo toolchain and schemes and use only those
 alwaysApply: false
 ---
 
-# Xcode tooling (терминал)
+# Xcode tooling (terminal)
 
-Перед **`xcodebuild` / `swift build` / `swift test` / SwiftLint / SwiftFormat / `simctl`** определи toolchain репозитория и **используй только его**.
+Before **`xcodebuild` / `swift build` / `swift test` / SwiftLint / SwiftFormat / `simctl`**, detect the repository toolchain and **use only it**.
 
-## Как определить
+## How to detect
 
-1. **Workspace / project:** `.xcworkspace` (CocoaPods) → workspace; иначе `.xcodeproj`; SPM-only — `Package.swift`.
-2. **Scheme / destination:** как в CI, `Makefile`, `fastlane`, `scripts/` — не угадывать.
-3. **Lint:** `.swiftlint.yml` / `SwiftLint` в PATH или Mint/mise — если конфига нет, не запускать «чужой» lint.
-4. **Format:** `.swiftformat` / SwiftFormat — только если принято в репо.
-5. **Simulator:** `xcrun simctl list` + destination из CI; не хардкодить UDID.
+1. **Workspace / project:** `.xcworkspace` (CocoaPods) → workspace; else `.xcodeproj`; SPM-only — `Package.swift`.
+2. **Scheme / destination:** as in CI, `Makefile`, `fastlane`, `scripts/` — do not guess.
+3. **Lint:** `.swiftlint.yml` / `SwiftLint` on PATH or Mint/mise — if there is no config, do not run a foreign lint.
+4. **Format:** `.swiftformat` / SwiftFormat — only if adopted in the repo.
+5. **Simulator:** `xcrun simctl list` + destination from CI; do not hardcode UDID.
 
-Примеры: `xcodebuild -scheme App -destination 'platform=iOS Simulator,name=iPhone 16' build`, `swiftlint lint --quiet`, `swiftformat . --lint`.
+Examples: `xcodebuild -scheme App -destination 'platform=iOS Simulator,name=iPhone 16' build`, `swiftlint lint --quiet`, `swiftformat . --lint`.
 
-Долгие сборки и DerivedData — нормальны; не блокировать `xcodebuild`/`simctl`/`xcrun` shell-guard’ом.
+Long builds and DerivedData are normal; do not block `xcodebuild`/`simctl`/`xcrun` with the shell guard.

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

@@ -1,7 +1,7 @@
 # `.cursor/skills` (preset ios-swift)
 
-| Skill | Назначение |
-|-------|------------|
+| Skill | Purpose |
+|-------|---------|
 | `feature-delivery` | Domain → Data → VM → View → tests → post-change-build |
 | `code-review` | iOS MR checklist |
 | `unit-testing` | XCTest / Swift Testing |
@@ -11,4 +11,4 @@
 | `technical-retro` | Retro facilitation |
 | `write-adr` | Architecture Decision Record (context / decision / consequences) |
 
-Копируется в `.cursor/skills/` при init.
+Copied to `.cursor/skills/` on init.

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

@@ -1,6 +1,6 @@
 # Agent team artifacts (ios-swift)
 
-Каталог артефактов пайплайна «команда агентов» для iOS.
+Artifact directory for the iOS agent-team pipeline.
 
 ## Layout
 

package/presets/cursor/java/AGENTS.md

@@ -2,17 +2,17 @@
 
 **Repo-root agents:** see [`AGENTS.md`](../../AGENTS.md) at the project root (cross-tool setup, commands, security, living conventions pointers).
 
-| Задача | Куда смотреть |
+| Task | Where to look |
 |--------|----------------|
-| Новая work-задача | `/task` → `commands/task.md` + `agent-team-orchestrator.mdc` |
-| Фича end-to-end | skill `feature-delivery` + `feature-delivery-workflow.mdc` |
-| Стек и слои | `java-app-core.mdc`, `architecture-boundaries.mdc` |
-| После правок Java | `post-change-test.mdc` (+ `java-tooling.mdc`) |
+| New work task | `/task` → `commands/task.md` + `agent-team-orchestrator.mdc` |
+| Feature end-to-end | skill `feature-delivery` + `feature-delivery-workflow.mdc` |
+| Stack and layers | `java-app-core.mdc`, `architecture-boundaries.mdc` |
+| After Java edits | `post-change-test.mdc` (+ `java-tooling.mdc`) |
 | Integration tests | `integration-test-*` + skill `integration-testing` |
 | Unit tests | `unit-test-*` + skill `unit-testing` |
 | Code review | skill `code-review` + `code-review-mr.mdc` |
 | ADR | skill `write-adr` (on-demand) |
-| Как работает X | agent `codebase-analyzer` (explain-as-is; без `/task`) |
+| How does X work | agent `codebase-analyzer` (explain-as-is; without `/task`) |
 
 ## Install
 
@@ -20,7 +20,7 @@
 npx @bonesofspring/ai-rules init cursor --preset java
 ```
 
-Копирует rules/agents/hooks/skills/commands/team + `REPO_AGENTS.md` → корневой `AGENTS.md`.
+Copies rules/agents/hooks/skills/commands/team + `REPO_AGENTS.md` → root `AGENTS.md`.
 
 ## Inventory
 
@@ -28,10 +28,10 @@ npx @bonesofspring/ai-rules init cursor --preset java
 - **8 skills** — `feature-delivery`, `unit-testing`, `integration-testing`, `ci-investigation`, `debug-investigation`, `code-review`, `technical-retro`, `write-adr`
 - **5 commands** — `/task`, `/task-continue`, `/feature-start`, `/feature-continue`, `/technical-retro`
 
-## Dogfood (5 сценариев)
+## Dogfood (5 scenarios)
 
-1. `/task` — новый use case (domain → ports → adapters → wire).
-2. Баг маппинга HTTP — debugger + MockMvc/focused controller test.
+1. `/task` — new use case (domain → ports → adapters → wire).
+2. HTTP mapping bug — debugger + MockMvc/focused controller test.
 3. Repository contract — integration-test trio (Testcontainers).
 4. Unit use case — unit-test planner/generator (JUnit 5 + port fake/mock).
 5. Secrets in logs — security-reviewer + `security-java`.

package/presets/cursor/java/MCP.md

@@ -1,15 +1,15 @@
 # MCP (preset `java`, Cursor)
 
-Копируется в `.cursor/mcp.json` при `ai-rules init cursor --preset java`.
+Copied to `.cursor/mcp.json` on `ai-rules init cursor --preset java`.
 
 ## Servers
 
-| Name | Package | Зачем |
+| Name | Package | Why |
 |------|---------|--------|
-| `context7` | `@upstash/context7-mcp` | Актуальная документация Java / Spring / JDK / популярных библиотек |
+| `context7` | `@upstash/context7-mcp` | Up-to-date Java / Spring / JDK / popular library docs |
 
-Figma и browser e2e MCP (Playwright / Chrome DevTools) **не** входят в java-пресет (backend-only).
+Figma and browser e2e MCP (Playwright / Chrome DevTools) are **not** part of the java preset (backend-only).
 
-Секреты в файл не кладём. Опционально: `CONTEXT7_API_KEY` в окружении.
+Do not put secrets in the file. Optional: `CONTEXT7_API_KEY` in the environment.
 
-После init: Settings → MCP → включить серверы. `init` перезаписывает одноимённый `mcp.json`.
+After init: Settings → MCP → enable servers. `init` overwrites the same-named `mcp.json`.

package/presets/cursor/java/agents/README.md

@@ -1,10 +1,10 @@
 # `.cursor/agents` (preset java)
 
-Ролевые subagents для командного пайплайна Cursor (Java hexagonal).
+Role subagents for the Cursor agent-team pipeline (Java hexagonal).
 
 ## Analysis (on-demand)
 
-| Agent | Файл | Production-код |
+| Agent | File | Production code |
 |-------|------|----------------|
 | Codebase analyzer | `codebase-analyzer.md` | no (explain-as-is only) |
 
@@ -25,7 +25,7 @@
 
 ## Frontmatter `readonly`
 
-Все agents — **`readonly: false`** (нужна запись в `.cursor/team/**`). Ограничения production — в теле промпта.
+All agents are **`readonly: false`** (need write access to `.cursor/team/**`). Production constraints are in the prompt body.
 
 ## Model matrix (frontmatter `model`)
 

package/presets/cursor/java/agents/task-router.md

@@ -17,21 +17,21 @@ You are a task router for a **Java hexagonal backend** agent team. You **do not*
 
 | intent | Signals | Default steps |
 |--------|---------|---------------|
-| `feature` | «добавь», «новая», «реализуй», use case/API/adapter | task-analyst → feature-developer → build-verifier → code-reviewer → qa-tester or **integration-test** trio when adapter AC |
-| `bugfix` | «баг», «fix», «не работает», «падает» | debugger → feature-developer (skipIf debugger.fixed) → build-verifier → code-reviewer |
-| `ci-fix` | «CI», «красный PR», «failing check» | ci-investigator → feature-developer (skipIf resolved) → build-verifier → code-reviewer |
-| `migration` | «миграция», «upgrade», «обнови JDK/Maven-Gradle» | task-analyst → migration-specialist → feature-developer → build-verifier → code-reviewer |
-| `perf-audit` | «производительность», «JFR/async-profiler», «медленно» | performance-auditor |
-| `review-only` | «ревью», «review MR», «проверь diff» | code-reviewer |
-| `test-only` | «покрой тестами» (unit+integration, no impl) | task-analyst → qa-tester |
-| `unit-only` | «unit», «юнит», «покрой use case» | unit-test-planner → unit-test-generator, or unit-test-healer |
+| `feature` | «добавь» (add), «новая» (new), «реализуй» (implement), use case/API/adapter | task-analyst → feature-developer → build-verifier → code-reviewer → qa-tester or **integration-test** trio when adapter AC | <!-- i18n-keep: E4 -->
+| `bugfix` | «баг» (bug), «fix», «не работает» (doesn't work), «падает» (crashes) | debugger → feature-developer (skipIf debugger.fixed) → build-verifier → code-reviewer | <!-- i18n-keep: E4 -->
+| `ci-fix` | «CI», «красный PR» (red PR), «failing check» | ci-investigator → feature-developer (skipIf resolved) → build-verifier → code-reviewer | <!-- i18n-keep: E4 -->
+| `migration` | «миграция» (migration), «обнови JDK/Maven-Gradle» (upgrade), "update JDK/Maven-Gradle" | task-analyst → migration-specialist → feature-developer → build-verifier → code-reviewer | <!-- i18n-keep: E4 -->
+| `perf-audit` | «производительность» (performance), «JFR/async-profiler», «медленно» (slow) | performance-auditor | <!-- i18n-keep: E4 -->
+| `review-only` | «ревью» (review), «проверь diff» (review MR), "check diff" | code-reviewer | <!-- i18n-keep: E4 -->
+| `test-only` | «покрой тестами» (cover with tests), (unit+integration, no impl) | task-analyst → qa-tester | <!-- i18n-keep: E4 -->
+| `unit-only` | «юнит» (unit), «покрой use case» (cover use case) | unit-test-planner → unit-test-generator, or unit-test-healer | <!-- i18n-keep: E4 -->
 | `e2e-only` / integration | «integration», «e2e», «MockMvc», «Testcontainers» | **integration-test-planner** → **integration-test-generator**, or **integration-test-healer** |
-| `docs-only` | «документация», «README», «changelog» | task-analyst → tech-writer |
-| `refactor` | «рефакторинг», «без изменения поведения» | task-analyst → feature-developer → build-verifier → code-reviewer |
-| `spike` | «исследуй», «spike», proof of concept | task-analyst → solution-architect |
-| `retro` | «ретро», «postmortem» | (orchestrator → `/technical-retro`) |
+| `docs-only` | «документация» (docs), "README", "changelog" | task-analyst → tech-writer | <!-- i18n-keep: E4 -->
+| `refactor` | «рефакторинг» (refactor), «без изменения поведения» (no behavior change) | task-analyst → feature-developer → build-verifier → code-reviewer | <!-- i18n-keep: E4 -->
+| `spike` | «исследуй» (explore), "spike", proof of concept | task-analyst → solution-architect | <!-- i18n-keep: E4 -->
+| `retro` | «ретро» (retro), "postmortem" | (orchestrator → `/technical-retro`) | <!-- i18n-keep: E4 -->
 
-**Never schedule** Playwright (`playwright-test-*`), XCUITest (`xcuitest-test-*`), or `accessibility-reviewer`. Put them in `skipped` with reason «Java backend uses integration-test trio».
+**Never schedule** Playwright (`playwright-test-*`), XCUITest (`xcuitest-test-*`), or `accessibility-reviewer`. Put them in `skipped` with reason "Java backend uses integration-test trio".
 
 ## Pipeline profiles
 

package/presets/cursor/java/commands/README.md

@@ -1,54 +1,54 @@
 # `.cursor/commands` (preset java)
 
-Slash-команды копируются в `.cursor/commands/` при `ai-rules init cursor --preset java`.
+Slash commands are copied to `.cursor/commands/` on `ai-rules init cursor --preset java`.
 
-## Команда агентов
+## Agent commands
 
-| Command | Назначение |
+| Command | Purpose |
 |---------|------------|
-| **`/task <описание>`** | **Главная точка входа:** router → pipeline.json → нужные роли по порядку |
-| `/task-continue <slug>` | После human gate или паузы |
-| `/feature-start <описание>` | Legacy: только analyst (без router) |
+| **`/task <description>`** | **Main entry point:** router → pipeline.json → required roles in order |
+| `/task-continue <slug>` | After a human gate or pause |
+| `/feature-start <description>` | Legacy: analyst only (no router) |
 | `/feature-continue <slug>` | Alias task-continue |
-| `/technical-retro [slug]` | Ретро; с slug — блок «Работа агентов» |
+| `/technical-retro [slug]` | Retro; with slug — “Agent work” block |
 
-## Примеры `/task`
+## `/task` examples
 
 ```
-/task Добавить CancelOrder use case (domain → ports → HTTP)
+/task Добавить CancelOrder use case (domain → ports → HTTP) (Add CancelOrder use case) <!-- i18n-keep: E4 -->
 → analyst → developer → build-verifier → reviewer → QA (integration)
 
-/task MockMvc CreateOrder падает на пустом body
+/task MockMvc CreateOrder падает на пустом body (MockMvc CreateOrder crashes on empty body) <!-- i18n-keep: E4 -->
 → debugger → developer → reviewer → QA (regression)
 
-/task CI упал на mvn test / ./gradlew test / static analysis в PR #142
+/task CI упал на mvn test / ./gradlew test / static analysis в PR #142 (CI failed on mvn test / ./gradlew test / static analysis in PR #142) <!-- i18n-keep: E4 -->
 → ci-investigator → developer → reviewer
 
-/task Миграция на JDK 21 / обновление Spring Boot
+/task Миграция на JDK 21 / обновление Spring Boot (Migrate to JDK 21 / update Spring Boot) <!-- i18n-keep: E4 -->
 → analyst → migration-specialist → developer → reviewer → QA
 
-/task Проверь OpenAPI drift для /orders
+/task Проверь OpenAPI drift для /orders (Check OpenAPI drift for /orders) <!-- i18n-keep: E4 -->
 → api-contract-reviewer (or analyst → …)
 
-/task Покрой unit-тестами CancelOrder use case
+/task Покрой unit-тестами CancelOrder use case (Cover CancelOrder use case with unit tests) <!-- i18n-keep: E4 -->
 → unit-planner → unit-generator
 
-/task Напиши README для нового adapter persistence
+/task Напиши README для нового adapter persistence (Write README for new persistence adapter) <!-- i18n-keep: E4 -->
 → analyst → tech-writer
 
-/task Сделай ревью изменений в adapters/inbound/http
+/task Сделай ревью изменений в adapters/inbound/http (Review changes in adapters/inbound/http) <!-- i18n-keep: E4 -->
 → reviewer only
 
-/task Repository contract для OrderRepository
-→ integration-test-planner → generator → healer (или QA e2e-only = integration)
+/task Repository contract для OrderRepository (Repository contract for OrderRepository) <!-- i18n-keep: E4 -->
+→ integration-test-planner → generator → healer (or QA e2e-only = integration)
 ```
 
-## Связанные файлы
+## Related files
 
-- Subagents: `../agents/` (**21** ролей, включая `task-router.md`, `codebase-analyzer.md` и `integration-test-{planner,generator,healer}`; без `accessibility-reviewer` / Playwright / XCUITest)
-- Оркестратор: `../rules/agent-team-orchestrator.mdc`
+- Subagents: `../agents/` (**21** roles, including `task-router.md`, `codebase-analyzer.md`, and `integration-test-{planner,generator,healer}`; no `accessibility-reviewer` / Playwright / XCUITest)
+- Orchestrator: `../rules/agent-team-orchestrator.mdc`
 - Skills: `../skills/` (`feature-delivery`, `code-review`, `debug-investigation`, `ci-investigation`, `unit-testing`, `integration-testing`, `technical-retro`)
-- Артефакты: `../team/README.md` (`pipeline.json`, `status.json`)
+- Artifacts: `../team/README.md` (`pipeline.json`, `status.json`)
 - Hooks: `../hooks.json`, `../hooks/chain-team-phases.sh`
 
-Создавать и редактировать команды можно через `/commands` в Cursor или напрямую в этой папке пресета.
+Create and edit commands via `/commands` in Cursor or directly in this preset folder.

package/presets/cursor/java/commands/feature-continue.md

@@ -5,15 +5,15 @@ description: Legacy alias for /task-continue that resumes a feature pipeline aft
 
 # Feature continue — legacy alias
 
-> **Предпочтительно:** `/task-continue <slug>` — то же поведение, учитывает `pipeline.json`.
+> **Preferred:** `/task-continue <slug>` — same behavior, respects `pipeline.json`.
 
-Продолжение после human gate. Полная логика — в **`task-continue.md`**.
+Continue after a human gate. Full logic lives in **`task-continue.md`**.
 
-## Кратко
+## Short version
 
-1. Прочитай `pipeline.json` (если есть) и `status.json`.
-2. Сбрось `awaitingHumanGate`; определи следующий step по `pipelineIndex`.
-3. Вызови subagent для `currentAgent`.
-4. Hook продолжит цепочку при `autoChain: true`.
+1. Read `pipeline.json` (if present) and `status.json`.
+2. Clear `awaitingHumanGate`; determine the next step from `pipelineIndex`.
+3. Call the subagent for `currentAgent`.
+4. The hook continues the chain when `autoChain: true`.
 
-См. `task-continue.md` для деталей и таблицы handoff.
+See `task-continue.md` for details and the handoff table.

package/presets/cursor/java/commands/feature-start.md

@@ -5,29 +5,29 @@ description: Legacy analyst-only feature intake. Prefer /task for new work becau
 
 # Feature start — legacy (analyst only)
 
-> **Предпочтительно:** `/task <описание>` — router выберет роли и порядок автоматически.
+> **Preferred:** `/task <description>` — the router picks roles and order automatically.
 
-Запуск **фазы анализа** без router. Родительский агент действует как оркестратор (см. `agent-team-orchestrator.mdc`).
+Starts the **analysis phase** without the router. The parent agent acts as orchestrator (see `agent-team-orchestrator.mdc`).
 
-## Что делать
+## What to do
 
-1. Извлеки описание задачи из аргументов команды (всё после `/feature-start`).
-2. Сгенерируй **slug** (kebab-case, до 48 символов) из заголовка задачи.
-3. Создай `.cursor/team/tasks/<slug>/` если его ещё нет — через **Write** артефакта (не Shell `mkdir`).
-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** на этом этапе.
+1. Extract the task description from command arguments (everything after `/feature-start`).
+2. Generate a **slug** (kebab-case, up to 48 characters) from the task title.
+3. Create `.cursor/team/tasks/<slug>/` if it does not exist yet — via **Write** of an artifact (not Shell `mkdir`).
+4. Write `.cursor/team/active-task.json` → `{ "slug": "<slug>" }`.
+5. Optionally: minimal `pipeline.json` with fixed steps (analyst → developer → reviewer → qa-tester).
+6. Invoke subagent **task-analyst** (Task tool) with the full task description and artifact paths.
+7. Wait for the analyst to finish. **Do not invoke developer** at this stage.
 
 ## Human gate
 
-После аналитика:
+After the analyst:
 
-- Покажи пользователю ссылки на `brief.md` и `decomposition.md`.
-- Попроси проверить и утвердить или прислать правки.
-- Для продолжения: `/task-continue <slug>` или `/feature-continue <slug>`.
+- Show the user links to `brief.md` and `decomposition.md`.
+- Ask them to review and approve or send edits.
+- To continue: `/task-continue <slug>` or `/feature-continue <slug>`.
 
-## Если slug уже существует
+## If slug already exists
 
-- Если `status.json` в `awaiting_approval` — предложи ревью или continue.
-- Если задача в работе — спроси, продолжать или начать новый slug.
+- If `status.json` is `awaiting_approval` — offer review or continue.
+- If the task is in progress — ask whether to continue or start a new slug.

package/presets/cursor/java/commands/task-continue.md

@@ -3,25 +3,25 @@ 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 или паузы
+# Task continue — after human gate or pause
 
-Продолжение пайплайна из `pipeline.json`. Алиас по смыслу: `/feature-continue`.
+Resume the pipeline from `pipeline.json`. Semantic alias: `/feature-continue`.
 
-## Аргументы
+## Arguments
 
-`<slug>` — идентификатор задачи.
+`<slug>` — task identifier.
 
 ## Preconditions
 
-1. Прочитай `.cursor/team/tasks/<slug>/pipeline.json` и `status.json`.
-2. Продолжай если:
-   - `awaitingHumanGate: true` или `state: awaiting_approval`, **или**
-   - `state: changes_requested` (после review), **или**
-   - задача прервана и нужно возобновить с `pipelineIndex`.
+1. Read `.cursor/team/tasks/<slug>/pipeline.json` and `status.json`.
+2. Continue if:
+   - `awaitingHumanGate: true` or `state: awaiting_approval`, **or**
+   - `state: changes_requested` (after review), **or**
+   - the task was interrupted and must resume from `pipelineIndex`.
 
-## Алгоритм
+## Algorithm
 
-1. Запиши `.cursor/team/active-task.json` → `{ "slug": "<slug>" }`.
+1. Write `.cursor/team/active-task.json` → `{ "slug": "<slug>" }`.
 2. **Human gate resume** (`awaitingHumanGate` / `awaiting_approval`):
    1. **Do not** manually increment `pipelineIndex` or invent `currentAgent` first.
    2. Close the gate + activate the next attempt via the **installed** hook (single authority for ledger + status):
@@ -36,10 +36,10 @@ printf '%s\n' '{"status":"completed","action":"end_human_gate","activateNext":tr
 4. **Other resume**: restore `pipelineIndex` / `currentAgent` from status and invoke that agent.
 5. After the invoked agent completes, `chain-team-phases.sh` on `subagentStop` continues the chain when `autoChain: true`.
 
-## Артефакты для handoff
+## Artifacts for handoff
 
-| Agent | Прочитать |
-|-------|-----------|
+| Agent | Read |
+|-------|------|
 | 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 |

package/presets/cursor/java/commands/task.md

@@ -3,52 +3,52 @@ 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)
+# Task — unified entry point (router + pipeline)
 
-Главная команда для постановки задачи. Родительский агент = оркестратор (`agent-team-orchestrator.mdc`). Intake для work-запросов без `/task` — `agent-team-intake.mdc`.
+Main command for task intake. Parent agent = orchestrator (`agent-team-orchestrator.mdc`). Intake for work requests without `/task` — `agent-team-intake.mdc`.
 
-## Аргументы
+## Arguments
 
-Всё после `/task` — описание задачи на естественном языке.
+Everything after `/task` is the task description in natural language.
 
-Примеры:
+Examples:
 
-- `/task Добавить use case отмены заказа`
-- `/task Handler падает при пустом body — пофикси`
-- `/task CI упал на mvn test / gradlew test в PR`
-- `/task Миграция на новый JDK / обновление Maven-Gradle модуля`
-- `/task Покрой unit-тестами OrderService`
-- `/task Напиши changelog для релиза фильтров`
-- `/task Сделай ревью моих изменений в application/`
-- `/task Напиши integration tests для persistence adapter`
+- `/task Добавить use case отмены заказа` (Add cancel-order use case) <!-- i18n-keep: E4 -->
+- `/task Handler падает при пустом body — пофикси` (Handler crashes on empty body — fix it) <!-- i18n-keep: E4 -->
+- `/task CI упал на mvn test / gradlew test в PR` (CI failed on mvn test / gradlew test in PR) <!-- i18n-keep: E4 -->
+- `/task Миграция на новый JDK / обновление Maven-Gradle модуля` (Migrate to a new JDK / update Maven-Gradle module) <!-- i18n-keep: E4 -->
+- `/task Покрой unit-тестами OrderService` (Cover OrderService with unit tests) <!-- i18n-keep: E4 -->
+- `/task Напиши changelog для релиза фильтров` (Write changelog for filters release) <!-- i18n-keep: E4 -->
+- `/task Сделай ревью моих изменений в application/` (Review my changes in application/) <!-- i18n-keep: E4 -->
+- `/task Напиши integration tests для persistence adapter` (Write integration tests for persistence adapter) <!-- i18n-keep: E4 -->
 
-## Алгоритм
+## Procedure
 
-1. **Slug** — kebab-case из описания (≤48 символов). Создай `.cursor/team/tasks/<slug>/` через **Write** (например placeholder `pipeline.json` или пустой marker) — runtime/hook владеет `status.json` — **не** через Shell `mkdir` (песочница → `Operation not permitted`).
-2. **Router** — вызови subagent **task-router** с описанием задачи и путём к slug.
-3. **План** — покажи пользователю таблицу из `pipeline.json`: intent, steps, skipped, humanGates.
-4. **Intent retro** — если `intent === "retro"`, выполни `/technical-retro` и **остановись**.
-5. **Старт** — после router:
-   - подтверди `pipeline.json` и `active-task.json`;
-   - **не** пиши lifecycle-поля `status.json` / `metrics.json` сам — их владеет orchestration runtime/hook (см. **agent-artifact-contracts**). Если `status.json` отсутствует, допустим только минимальный bootstrap (`slug`, `intent`, `pipelineIndex: 0`, `currentAgent: steps[0]`, `state: in_progress`) — **не** увеличивай `pipelineIndex` вручную;
-   - вызови subagent для `pipeline.steps[0].agent` (slug, пути к артефактам, scope).
-6. **После каждого агента** — дождись hook handoff / reconciliation terminal receipt → `status.state`; не запускай следующий шаг, пока `status.json` не отражает handoff (или пока нет `followup_message` от hook).
-7. **Human gate** — если после текущего шага есть gate в `humanGates` (`after:<agent>`), после завершения агента **остановись** и попроси `/task-continue <slug>` (или `/feature-continue <slug>`).
+1. **Slug** — kebab-case from the description (≤48 characters). Create `.cursor/team/tasks/<slug>/` via **Write** (e.g. placeholder `pipeline.json` or empty marker) — runtime/hook owns `status.json` — **not** via Shell `mkdir` (sandbox → `Operation not permitted`).
+2. **Router** — invoke subagent **task-router** with the task description and slug path.
+3. **Plan** — show the user the table from `pipeline.json`: intent, steps, skipped, humanGates.
+4. **Intent retro** — if `intent === "retro"`, run `/technical-retro` and **stop**.
+5. **Start** — after router:
+   - confirm `pipeline.json` and `active-task.json`;
+   - **do not** write lifecycle fields in `status.json` / `metrics.json` yourself — orchestration runtime/hook owns them (see **agent-artifact-contracts**). If `status.json` is missing, only minimal bootstrap is allowed (`slug`, `intent`, `pipelineIndex: 0`, `currentAgent: steps[0]`, `state: in_progress`) — **do not** increment `pipelineIndex` manually;
+   - invoke subagent for `pipeline.steps[0].agent` (slug, artifact paths, scope).
+6. **After each agent** — wait for hook handoff / reconciliation terminal receipt → `status.state`; do not start the next step until `status.json` reflects handoff (or until there is a `followup_message` from the hook).
+7. **Human gate** — if after the current step there is a gate in `humanGates` (`after:<agent>`), after the agent finishes **stop** and ask for `/task-continue <slug>` (or `/feature-continue <slug>`).
 
-## Не делать
+## Do not
 
-- Не вызывать developer до router и (если в pipeline) analyst/architect.
-- Не hardcode порядок ролей — только `pipeline.json`.
-- Не пропускать human gate без явного continue.
+- Invoke developer before router and (if in pipeline) analyst/architect.
+- Hardcode role order — only `pipeline.json`.
+- Skip human gate without explicit continue.
 
-## Если slug занят
+## If slug is taken
 
-- `awaitingHumanGate` / `state: awaiting_approval` → предложи ревью артефактов или `/task-continue <slug>`.
-- `in_progress` → спроси: продолжить или новый slug.
+- `awaitingHumanGate` / `state: awaiting_approval` → offer artifact review or `/task-continue <slug>`.
+- `in_progress` → ask: continue or new slug.
 
 ## Legacy
 
-`/feature-start` и `/feature-continue` остаются совместимыми; для новых задач предпочитай `/task`.
+`/feature-start` and `/feature-continue` remain compatible; for new tasks prefer `/task`.
 
 ## Metrics