@bonesofspring/ai-rules 0.2.14 → 0.2.15

package/presets/claude/ios-swift/rules/ui-and-accessibility/swiftui.md

@@ -1,24 +1,24 @@
 ---
-description: Паттерны SwiftUI, View и Design System (preset)
+description: SwiftUI, View, and Design System patterns (preset)
 paths:
   - "**/{Presentation,DesignSystem}/**/*.swift"
 ---
 
-# Общие правила View
+# General View rules
 
-- **SwiftUI** — приоритет; UIKit — только по конвенции репо (wrapper, legacy).
-- View должна быть **тонкой**:
-  - отображает state из ViewModel;
-  - делегирует действия через методы/closures ViewModel;
-  - не содержит бизнес-логики, маппинга DTO, сетевых вызовов.
-- Перед новым кастомным контролом — искать компонент в `DesignSystem/` или существующих фичах.
-- Повторяемую UI-логику выносить в `ViewModifier`, `@ViewBuilder` helpers или subviews.
+- **SwiftUI** preferred; UIKit only by repo convention (wrapper, legacy).
+- Views must be **thin**:
+  - render state from the ViewModel;
+  - delegate actions through ViewModel methods/closures;
+  - contain no business logic, DTO mapping, or network calls.
+- Before a new custom control — look for a component in `DesignSystem/` or existing features.
+- Extract repeated UI logic into `ViewModifier`, `@ViewBuilder` helpers, or subviews.
 
-# ViewModel и binding
+# ViewModel and binding
 
-- ViewModel — `@MainActor`, `@Observable` (iOS 17+) или `ObservableObject` — как принято в проекте.
-- View читает state и вызывает **явные методы** ViewModel (`submit()`, `load()`), а не мутирует внутреннее состояние напрямую.
-- Для навигации — coordinator/router или enum route в ViewModel, не размазанные `NavigationLink` с бизнес-условиями в View.
+- ViewModel — `@MainActor`, `@Observable` (iOS 17+) or `ObservableObject` — as adopted in the project.
+- The View reads state and calls **explicit ViewModel methods** (`submit()`, `load()`); it does not mutate internal state directly.
+- For navigation — coordinator/router or a route enum in the ViewModel, not scattered `NavigationLink`s with business conditions in the View.
 
 # Lifecycle, ownership, hit testing
 
@@ -28,42 +28,42 @@ paths:
 - Transparent stacks that should receive taps: `.contentShape(Rectangle())`.
 - High-frequency visual updates — prefer `TimelineView` (or repo pattern) over ad-hoc `Timer` in Views.
 
-# Структура файлов
+# File structure
 
-Для экрана фичи:
-- `FeatureView.swift` — композиция subviews.
+For a feature screen:
+- `FeatureView.swift` — subview composition.
 - `FeatureViewModel.swift` — state + intents.
-- `FeatureView+Subviews.swift` — при большом дереве (опционально).
-- `FeatureRoute.swift` — навигация (если используется).
+- `FeatureView+Subviews.swift` — for a large tree (optional).
+- `FeatureRoute.swift` — navigation (when used).
 
-Для компонента Design System:
-- Папка `ComponentName/`:
+For a Design System component:
+- Folder `ComponentName/`:
   - `ComponentName.swift`
-  - `ComponentName+Preview.swift` (опционально)
-  - `ComponentNameStyle.swift` — стили/варианты (опционально)
+  - `ComponentName+Preview.swift` (optional)
+  - `ComponentNameStyle.swift` — styles/variants (optional)
 
-# Стили и Design System
+# Styles and Design System
 
-- Цвета, шрифты, отступы — из **токенов/Theme** проекта (`DesignSystem`, `Assets`, generated tokens).
-- Избегать:
-  - «магических» литералов (`.padding(17)`, `Color(red: 0.2, ...)`), если есть токены;
-  - дублирования стилей, уже закрытых примитивами.
-- `Preview` — для компонентов и экранов с mock ViewModel.
+- Colors, fonts, spacing — from project **tokens/Theme** (`DesignSystem`, `Assets`, generated tokens).
+- Avoid:
+  - “magic” literals (`.padding(17)`, `Color(red: 0.2, ...)`) when tokens exist;
+  - duplicating styles already covered by primitives.
+- `Preview` — for components and screens with a mock ViewModel.
 
 # Accessibility
 
-- Интерактивные элементы: осмысленные `accessibilityLabel`, `accessibilityHint` где нужно.
-- Для UI-тестов — стабильные `accessibilityIdentifier` на ключевых элементах (согласовать с `testing/ui.md`).
-- Поддерживать Dynamic Type и контраст, не ломать layout при крупном шрифте.
+- Interactive elements: meaningful `accessibilityLabel`, `accessibilityHint` where needed.
+- For UI tests — stable `accessibilityIdentifier` on key elements (align with `testing/ui.md`).
+- Support Dynamic Type and contrast; do not break layout at large text sizes.
 
-# Previews и локализация
+# Previews and localization
 
-- Строки UI — через `String(localized:)` / `LocalizedStringKey`, не hardcoded в production без причины.
-- `#Preview` с реалистичными mock-данными; для ViewModel — stub use cases.
+- UI strings via `String(localized:)` / `LocalizedStringKey`, not hardcoded in production without reason.
+- `#Preview` with realistic mock data; for ViewModels — stub use cases.
 
-# Требование к агенту
+# Agent requirement
 
-При создании/изменении UI:
-- Следовать существующим экранам и компонентам как эталону.
-- Не импортировать Data-слой во View/ViewModel.
-- Subview выделять, когда body превышает ~40–60 строк или повторяется.
+When creating/changing UI:
+- Follow existing screens and components as the reference.
+- Do not import the Data layer into View/ViewModel.
+- Extract a subview when body exceeds ~40–60 lines or repeats.

package/presets/claude/ios-swift/rules/ui-and-accessibility/viewmodels.md

@@ -1,43 +1,43 @@
 ---
-description: ViewModels, состояние экрана и domain flow
+description: ViewModels, screen state, and domain flow
 paths:
   - "**/{Presentation,Domain}/**/*ViewModel*.swift"
 ---
 
-# Общие принципы
+# General principles
 
-- ViewModel — **единственная точка** orchestration для экрана: load, submit, validation, navigation intents.
-- Хранить и отдавать во View **domain models** и UI-specific state (loading, error message, selected tab).
-- `@MainActor` на ViewModel; тяжёлую работу — в use case / repository (`async`), не блокировать main thread.
+- ViewModel is the **single orchestration point** for a screen: load, submit, validation, navigation intents.
+- Store and expose to the View **domain models** and UI-specific state (loading, error message, selected tab).
+- `@MainActor` on ViewModel; heavy work — in use case / repository (`async`); do not block the main thread.
 - Unidirectional flow: View → intent → ViewModel → use case → state update → View.
 
 # State
 
-- Явный enum или struct для UI state где уместно:
-  - `idle`, `loading`, `loaded(Data)`, `failed(Error)` — или аналог из репо.
-- Избегать множества несинхронизированных `@Published` флагов, если один enum покрывает сценарий.
-- `@Observable` / `ObservableObject` — как в проекте; не смешивать стили в одной фиче без причины.
+- Explicit enum or struct for UI state where appropriate:
+  - `idle`, `loading`, `loaded(Data)`, `failed(Error)` — or the repo’s analog.
+- Avoid many unsynchronized `@Published` flags when one enum covers the scenario.
+- `@Observable` / `ObservableObject` — as in the project; do not mix styles in one feature without reason.
 
-# Use cases и repositories
+# Use cases and repositories
 
-- ViewModel зависит от **протоколов** (`LoadOrdersUseCase`, `OrderRepository`), не от `*RepositoryImpl`.
-- Один use case — одна бизнес-операция; не раздувать ViewModel сотнями строк — выносить use cases в Domain.
-- Кэширование и offline — в repository/Data, не во ViewModel.
+- ViewModel depends on **protocols** (`LoadOrdersUseCase`, `OrderRepository`), not `*RepositoryImpl`.
+- One use case — one business operation; do not inflate ViewModels to hundreds of lines — extract use cases into Domain.
+- Caching and offline — in repository/Data, not in ViewModel.
 
 # Side effects
 
-- Analytics, haptics, deep links — через injected services или middleware-паттерн, не hardcode синглтонов.
-- `Task` в ViewModel: отмена при `deinit` / `onDisappear` где нужно (`task(id:)`, хранение `Task?` с cancel).
+- Analytics, haptics, deep links — via injected services or a middleware pattern, not hardcoded singletons.
+- `Task` in ViewModel: cancel on `deinit` / `onDisappear` when needed (`task(id:)`, store `Task?` with cancel).
 
-# Тестируемость
+# Testability
 
-- Инициализатор ViewModel принимает протоколы (DI); без скрытых singleton для сети/БД.
-- Бизнес-ветки покрывать unit-тестами с mock use cases.
+- ViewModel initializer takes protocols (DI); no hidden network/DB singletons.
+- Cover business branches with unit tests using mock use cases.
 
-# Требование к агенту
+# Agent requirement
 
-При создании ViewModel:
-- Не вызывать `URLSession` / API client напрямую.
-- Не парсить JSON и не объявлять DTO во ViewModel.
-- Именование: `FeatureViewModel`, методы — глаголы (`loadOrders()`, `submitOrder()`).
-- Следовать стилю существующих ViewModels в той же фиче.
+When creating a ViewModel:
+- Do not call `URLSession` / API client directly.
+- Do not parse JSON or declare DTOs in the ViewModel.
+- Naming: `FeatureViewModel`, methods as verbs (`loadOrders()`, `submitOrder()`).
+- Follow the style of existing ViewModels in the same feature.

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

@@ -1,7 +1,7 @@
 # `.claude/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) |
 
-Копируется в `.claude/skills/` при init.
+Copied to `.claude/skills/` on init.

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

@@ -1,11 +1,11 @@
 # Agent team artifacts (ios-swift)
 
-Каталог артефактов пайплайна «команда агентов» для iOS.
+Artifact directory for the iOS agent-team pipeline.
 
 ## Layout
 
 ```
-.claude/team/   # Claude: .claude/team/
+.claude/team/
   active-task.json
   fixtures/
   tasks/<slug>/
@@ -26,6 +26,10 @@
 
 **Never** schedule Playwright-only steps without skip rationale. Use `xcuitest-test-*` for UI-test-only intents.
 
+## Creating task dirs
+
+Bootstrap `tasks/<slug>/` by **writing** artifacts (Write tool), not Shell `mkdir`. Cursor sandbox → `Operation not permitted` otherwise (worse on Desktop/Documents).
+
 ## Artifact manifest and receipts
 
 Each slug stores one context index at `.claude/team/tasks/<slug>/artifact-manifest.json`. Schema v1 is defined by shared core `agent-team/agent-artifact-contracts.md`: every entry declares its producer, status, authoritative paths, acceptance-criteria IDs, decomposition task IDs, timestamps, and a terminal completion receipt.

package/presets/claude/java/MCP.md

@@ -1,13 +1,13 @@
 # MCP (preset `java`, Claude)
 
-Копируется в `.mcp.json` при `ai-rules init claude --preset java`.
+Copied to `.mcp.json` on `ai-rules init claude --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.

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

@@ -1,10 +1,10 @@
 # `.claude/agents` (preset java)
 
-Ролевые subagents для командного пайплайна Claude Code (Java hexagonal).
+Role subagents for the Claude Code agent-team pipeline (Java hexagonal).
 
 ## Analysis (on-demand)
 
-| Agent | Файл | Production-код |
+| Agent | File | Production code |
 |-------|------|----------------|
 | Codebase analyzer | `codebase-analyzer.md` | no (explain-as-is only) |
 

package/presets/claude/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/claude/java/commands/README.md

@@ -1,13 +1,13 @@
 # `.claude/commands` (preset java)
 
-Определения slash-команд и on-demand сценариев. Копируются в `.claude/commands/` при `ai-rules init claude --preset java`.
+Slash-command and on-demand scenario definitions. Copied to `.claude/commands/` on `ai-rules init claude --preset java`.
 
-| Файл | Назначение |
+| File | Purpose |
 |------|------------|
-| `task.md` | Единая точка входа: router → dynamic pipeline → первый agent |
-| `task-continue.md` | Продолжение после human gate / паузы по `pipeline.json` |
-| `feature-start.md` | Legacy analyst-only старт без router |
-| `feature-continue.md` | Legacy продолжение; для `pipeline.json` делегирует смысл `/task-continue` |
-| `technical-retro.md` | Фасилитация технического ретро, включая блок «Работа агентов» |
+| `task.md` | Single entry point: router → dynamic pipeline → first agent |
+| `task-continue.md` | Continue after human gate / pause per `pipeline.json` |
+| `feature-start.md` | Legacy analyst-only start without router |
+| `feature-continue.md` | Legacy continue; for `pipeline.json` delegates to `/task-continue` semantics |
+| `technical-retro.md` | Facilitate a technical retro, including the “Agent work” block |
 
-См. также корневой `README.md` пресета — у Claude Code помимо `rules/` и `commands/` используются `skills/`, `agents/`, `hooks/`, `team/`.
+See also the preset root `README.md` — Claude Code also uses `skills/`, `agents/`, beyond `rules/` and `commands/`; `hooks/`, `team/`.

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

@@ -3,25 +3,25 @@ name: feature-continue
 description: Legacy alias for /task-continue that resumes a feature pipeline after human approval or pause.
 ---
 
-# Feature continue — продолжение после утверждения brief
+# Feature continue — resume after brief approval
 
-Legacy-команда для продолжения после human gate. Для новых пайплайнов с `pipeline.json` используй те же правила, что в `/task-continue`.
+Legacy command to continue after a human gate. For new pipelines with `pipeline.json`, use the same rules as `/task-continue`.
 
-## Аргументы
+## Arguments
 
-`<slug>` — идентификатор задачи из `.claude/team/tasks/<slug>/`.
+`<slug>` — task id under `.claude/team/tasks/<slug>/`.
 
 ## Preconditions
 
-1. Прочитай `.claude/team/tasks/<slug>/brief.md` и `decomposition.md`.
-2. Если есть `pipeline.json`, делегируй поведение `/task-continue <slug>`.
-3. Если `pipeline.json` нет, прочитай `status.json`. Продолжай только если:
+1. Read `.claude/team/tasks/<slug>/brief.md` and `decomposition.md`.
+2. If `pipeline.json` exists, delegate behavior to `/task-continue <slug>`.
+3. If there is no `pipeline.json`, read `status.json`. Continue only if:
    - `phase` is `analysis` and `state` is `awaiting_approval` (user explicitly approved via this command), **or**
    - `phase` is `development`/`review`/`testing` and work should resume.
 
-## Legacy алгоритм без `pipeline.json`
+## Legacy algorithm without `pipeline.json`
 
-1. Обнови `status.json`:
+1. Update `status.json`:
    ```json
    {
      "slug": "<slug>",
@@ -30,22 +30,22 @@ Legacy-команда для продолжения после human gate. Дл
      "updatedAt": "<ISO8601>"
    }
    ```
-   Затем сразу установи `"state": "in_progress"` перед вызовом developer.
+   Then immediately set `"state": "in_progress"` before calling the developer.
 
-2. Запиши `.claude/team/active-task.json` → `{ "slug": "<slug>" }`.
+2. Write `.claude/team/active-task.json` → `{ "slug": "<slug>" }`.
 
-3. Вызови subagent **feature-developer** с контекстом:
-   - пути к `brief.md`, `decomposition.md`, `status.json`;
-   - указание следовать `rules/architecture/feature-delivery-workflow.md`.
+3. Call subagent **feature-developer** with context:
+   - paths to `brief.md`, `decomposition.md`, `status.json`;
+   - instruction to follow `rules/architecture/feature-delivery-workflow.md`.
 
-4. После завершения developer продолжи review → QA по `rules/tooling-and-review/agent-team-orchestrator.md`.
+4. After the developer finishes, continue review → QA per `rules/tooling-and-review/agent-team-orchestrator.md`.
 
-## Если review вернул changes_requested
+## If review returned changes_requested
 
-- Верни `phase` в `development`, `state` в `in_progress`.
-- Снова вызови **feature-developer** с списком правок от reviewer.
+- Set `phase` back to `development`, `state` to `in_progress`.
+- Call **feature-developer** again with the reviewer’s change list.
 
-## Не делать
+## Do not
 
-- Не пропускать human gate без явного `/feature-continue`.
-- Не совмещать роли developer и reviewer в одном subagent-вызове.
+- Skip the human gate without an explicit `/feature-continue`.
+- Combine developer and reviewer roles in one subagent call.

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

@@ -3,28 +3,28 @@ name: feature-start
 description: Legacy analyst-only feature intake. Prefer /task for new work because it uses router and dynamic pipeline.
 ---
 
-# Feature start — legacy команда агентов
+# Feature start — legacy agent command
 
-Запуск **фазы анализа** для новой задачи. Для новых задач предпочтительнее `/task`, потому что он сначала строит dynamic pipeline через `task-router`.
+Starts the **analysis phase** for a new task. For new work, prefer `/task` because it builds a dynamic pipeline via `task-router` first.
 
-## Что делать
+## What to do
 
-1. Извлеки описание задачи из аргументов команды (всё после `/feature-start`).
-2. Сгенерируй **slug** (kebab-case, до 48 символов) из заголовка задачи.
-3. Создай `.claude/team/tasks/<slug>/` если его ещё нет — через запись файла (Write / Edit), не через Shell `mkdir`.
-4. Запиши `.claude/team/active-task.json` → `{ "slug": "<slug>" }`.
-5. Вызови subagent **task-analyst** с полным описанием задачи и путём к артефактам.
-6. Дождись завершения аналитика. **Не вызывай 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 `.claude/team/tasks/<slug>/` if it does not exist — via Write / Edit, not Shell `mkdir`.
+4. Write `.claude/team/active-task.json` → `{ "slug": "<slug>" }`.
+5. Invoke subagent **task-analyst** with the full task description and artifact paths.
+6. Wait for the analyst to finish. **Do not invoke developer** at this stage.
 
 ## Human gate
 
-После аналитика:
+After the analyst:
 
-- Покажи пользователю ссылки на `brief.md` и `decomposition.md`.
-- Попроси проверить и утвердить или прислать правки.
-- Для продолжения: `/feature-continue <slug>` или `/task-continue <slug>`.
+- Show the user links to `brief.md` and `decomposition.md`.
+- Ask them to review and approve or send edits.
+- To continue: `/feature-continue <slug>` or `/task-continue <slug>`.
 
-## Если slug уже существует
+## If slug already exists
 
-- Если `status.json` в `awaiting_approval` — предложи ревью или `/feature-continue`.
-- Если задача в работе — спроси, продолжать или начать новый slug.
+- If `status.json` is `awaiting_approval` — offer review or `/feature-continue`.
+- If the task is in progress — ask whether to continue or start a new slug.

package/presets/claude/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. Прочитай `.claude/team/tasks/<slug>/pipeline.json` и `status.json`.
-2. Продолжай если:
-   - `awaitingHumanGate: true` или `state: awaiting_approval`, **или**
-   - `state: changes_requested` (после review), **или**
-   - задача прервана и нужно возобновить с `pipelineIndex`.
+1. Read `.claude/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. Запиши `.claude/team/active-task.json` → `{ "slug": "<slug>" }`.
+1. Write `.claude/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/claude/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 — единая точка входа
+# Task — single entry point
 
-Главная команда для постановки задачи в Claude Code. Родительский агент = оркестратор (`rules/tooling-and-review/agent-team-orchestrator.md`). Intake — `rules/tooling-and-review/agent-team-intake.md`.
+Main command for submitting work in Claude Code. Parent agent = orchestrator (`rules/tooling-and-review/agent-team-orchestrator.md`). Intake — `rules/tooling-and-review/agent-team-intake.md`.
 
-## Аргументы
+## 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 Add cancel-order use case`
+- `/task Handler crashes on empty body — fix it`
+- `/task CI failed on mvn test / gradlew test in PR`
+- `/task Migrate to a new JDK / update Maven-Gradle module`
+- `/task Cover OrderService with unit tests`
+- `/task Write changelog for filters release`
+- `/task Review my changes in application/`
+- `/task Write integration tests for persistence adapter`
 
-## Алгоритм
+## Algorithm
 
-1. **Slug** — kebab-case из описания (≤48 символов). Создай `.claude/team/tasks/<slug>/` через запись файла (Write / Edit); runtime/hook владеет `status.json` — **не** полагайся на Shell `mkdir` как единственный способ создать каталог.
-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 description (≤48 characters). Create `.claude/team/tasks/<slug>/` via Write / Edit; runtime/hook owns `status.json` — **do not** rely on Shell `mkdir` as the only way to create the directory.
+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 hook returns `followup_message`).
+7. **Human gate** — if there is a gate in `humanGates` after the current step (`after:<agent>`), **stop** after the agent finishes 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