@bonesofspring/ai-rules 0.2.14 → 0.2.16

package/presets/claude/nuxt/rules/tooling-and-review/preset-no-cross-stack-leakage.md

@@ -2,20 +2,21 @@
 description: Preset authoring: forbid cross-stack agent/path leakage in hooks and agents.
 paths: packages/ai-rules/presets/**
 ---
-<!-- shared-core: meta/preset-no-cross-stack-leakage.md -->
 
+<!-- shared-core: meta/preset-no-cross-stack-leakage.md -->
 
 # Preset no cross-stack leakage
 
-Запрет протекания stack-specific имён, путей и handoff stems между пресетами.
+Ban leakage of stack-specific names, paths, and handoff stems across presets.
 
 ## Principles
 
-- `next` must not require iOS-only agents/tooling (`xcuitest-*`, `xcodebuild` as required handoff, Keychain-only rules).
-- `nuxt` must not require iOS-only agents/tooling (`xcuitest-*`, `xcodebuild` as required handoff, Keychain-only rules).
-- `svelte` must not require iOS-only agents/tooling (`xcuitest-*`, `xcodebuild` as required handoff, Keychain-only rules).
-- `ios-swift` must not ship Playwright handoffs or Next lint recipes as required commands.
-- `go` / `java` / `php-hexagonal` / `php-laravel` / `mcp-ts` must not ship Playwright, XCUITest, Next lint recipes, or `xcodebuild`/`SwiftLint` as required handoffs.
+- `next` must not require iOS-only or Android-only agents/tooling (`xcuitest-*`, `instrumentation-test-*`, `xcodebuild` as required handoff, Keychain-only rules).
+- `nuxt` must not require iOS-only or Android-only agents/tooling (`xcuitest-*`, `instrumentation-test-*`, `xcodebuild` as required handoff, Keychain-only rules).
+- `svelte` must not require iOS-only or Android-only agents/tooling (`xcuitest-*`, `instrumentation-test-*`, `xcodebuild` as required handoff, Keychain-only rules).
+- `ios-swift` must not ship Playwright handoffs, Android `instrumentation-test-*` handoffs, or Next lint recipes as required commands.
+- `android-kotlin` must not ship Playwright, XCUITest, `xcodebuild`, or Next lint recipes as required handoffs.
+- `go` / `java` / `php-hexagonal` / `php-laravel` / `mcp-ts` must not ship Playwright, XCUITest, Android instrumentation agents, Next lint recipes, or `xcodebuild`/`SwiftLint` as required handoffs.
 - `mcp-ts` must not ship Go tool commands (`go test`, `go vet`, `golangci-lint`) or `integration-test-*` agents as required delivery gates.
 - Shared core must not embed stack paths (`app/src/**`, `Features/**`, `playwright`, `xcodebuild`).
 
@@ -24,25 +25,37 @@ paths: packages/ai-rules/presets/**
 In ios-swift `chain-team-phases.sh` / agent handoffs (Cursor + Claude):
 
 - `playwright-test-`, `playwright-agents`, `playwright-e2e`, `user-playwright`
+- `instrumentation-test-` as required Android handoffs
 - `app/__tests__/e2e` as a required path
 - Positive yarn recipes `lint:js` / `lint:css` as commands to run (negation prose alone is weak — prefer zero occurrences)
 
 Required instead: `xcuitest-test-*` stems; build-verifier mentions `xcodebuild` or `post-change-build` / `xcode-tooling`.
 
+## Forbidden in android-kotlin hooks/agents (FAIL)
+
+In android-kotlin `chain-team-phases.sh` / agent handoffs (Cursor + Claude):
+
+- `playwright-test-`, `playwright-agents`, `playwright-e2e`, `user-playwright`
+- `app/__tests__/e2e` as a required path
+- `xcuitest-test-`, positive `xcodebuild` / `SwiftLint` as required handoffs
+- Positive yarn recipes `lint:js` / `lint:css` as commands to run
+
+Required instead: `instrumentation-test-*` stems; build-verifier mentions `gradle-tooling` and/or `post-change-build` (Gradle wrapper discovery — not `xcodebuild` as the default gate).
+
 ## Forbidden in next hooks/agents (FAIL when present as required)
 
-- `xcuitest-test-` as handoff stems
+- `xcuitest-test-` / `instrumentation-test-` as handoff stems
 - Requiring `xcodebuild` / SwiftLint as the default post-change gate for Next app work
 
 ## Forbidden in nuxt hooks/agents (FAIL when present as required)
 
-- `xcuitest-test-` as handoff stems
+- `xcuitest-test-` / `instrumentation-test-` as handoff stems
 - Requiring `xcodebuild` / SwiftLint as the default post-change gate for Nuxt app work
 - Frontend profile mirrors `next`: Playwright / `lint:js` / `lint:css` allowed
 
 ## Forbidden in svelte hooks/agents (FAIL when present as required)
 
-- `xcuitest-test-` as handoff stems
+- `xcuitest-test-` / `instrumentation-test-` as handoff stems
 - Requiring `xcodebuild` / SwiftLint as the default post-change gate for SvelteKit app work
 - Frontend profile mirrors `next` / `nuxt`: Playwright / `lint:js` / `lint:css` allowed
 
@@ -52,7 +65,7 @@ Shared backend-stack bans (`go`, `java`, `php-hexagonal`, and `php-laravel`):
 
 - `playwright-test-`, `playwright-e2e`, `user-playwright`, `app/__tests__/e2e`
 - Positive yarn recipes `lint:js` / `lint:css`
-- `xcuitest-test-`, `xcodebuild`, `SwiftLint` as required handoffs
+- `xcuitest-test-`, `instrumentation-test-`, `xcodebuild`, `SwiftLint` as required handoffs
 - Agent file `accessibility-reviewer` (no UI surface)
 
 Required instead: `integration-test-*`; build-verifier / `post-change-test` plus stack tooling — `go-tooling` (`go test`, `go vet`), `java-tooling` (`mvn test` / `./gradlew test`), or `php-tooling` (`php artisan test` / `composer test` / `vendor/bin/phpunit`).
@@ -63,9 +76,9 @@ Same UI/mobile bans as backend stacks, plus:
 
 - `playwright-test-`, `playwright-agents`, `playwright-e2e`, `user-playwright`, `app/__tests__/e2e`
 - Positive yarn recipes `lint:js` / `lint:css` as required gates
-- `xcuitest-test-`, `xcodebuild`, `SwiftLint` as required handoffs
+- `xcuitest-test-`, `instrumentation-test-`, `xcodebuild`, `SwiftLint` as required handoffs
 - Go tool commands as required MCP delivery gates: `go test`, `go vet`, `golangci-lint`
-- Agent files: `playwright-test-*`, `xcuitest-test-*`, `integration-test-*`, `accessibility-reviewer`
+- Agent files: `playwright-test-*`, `xcuitest-test-*`, `instrumentation-test-*`, `integration-test-*`, `accessibility-reviewer`
 
 Required instead: package-manager–discovered typecheck/test (`mcp-ts-tooling`, `post-change-test`); Phase 1 gates `build-verifier` + `security-reviewer`.
 
@@ -76,4 +89,4 @@ Required instead: package-manager–discovered typecheck/test (`mcp-ts-tooling`,
 
 ## Chain fork
 
-`hooks/chain-team-phases.sh` must differ **byte-wise** pairwise among `next`, `nuxt`, `svelte`, `ios-swift`, `go`, `java`, `mcp-ts`, `php-hexagonal`, and `php-laravel` (per platform).
+`hooks/chain-team-phases.sh` must differ **byte-wise** pairwise among `next`, `nuxt`, `svelte`, `ios-swift`, `android-kotlin`, `go`, `java`, `mcp-ts`, `php-hexagonal`, and `php-laravel` (per platform).

package/presets/claude/nuxt/rules/tooling-and-review/preset-pr-checklist.md

@@ -2,21 +2,21 @@
 description: Preset authoring: PR checklist for twin sync, budget, leakage, README. Use on preset PRs.
 paths: packages/ai-rules/presets/**
 ---
-<!-- shared-core: meta/preset-pr-checklist.md -->
 
+<!-- shared-core: meta/preset-pr-checklist.md -->
 
 # Preset PR checklist
 
-Чеклист для PR, затрагивающих `packages/ai-rules/presets/**` (и dogfood `.cursor/` sync).
+Checklist for PRs that touch `packages/ai-rules/presets/**` (and dogfood `.cursor/` sync).
 
 ## Before merge
 
-- [ ] **SoT:** правки в `packages/…` (не только root `.cursor/`)
-- [ ] **Core:** если менялся `_shared/core/**` — обновлены все `<!-- shared-core: … -->` consumers (или documented intentional fork)
-- [ ] **Twin:** Cursor change → Claude twin **same PR** (**FAIL** if missing on next, nuxt, svelte, ios-swift, go, java, mcp-ts, php-hexagonal, and php-laravel — см. `preset-twin-sync`)
-- [ ] **Mapping:** `claude/<stack>/rules/README.md` mapping table актуален
+- [ ] **SoT:** edits in `packages/…` (not only root `.cursor/`)
+- [ ] **Core:** if `_shared/core/**` changed — all `<!-- shared-core: … -->` consumers updated (or documented intentional fork)
+- [ ] **Twin:** Cursor change → Claude twin **same PR** (**FAIL** if missing on next, nuxt, svelte, ios-swift, android-kotlin, go, java, mcp-ts, php-hexagonal, and php-laravel — see `preset-twin-sync`)
+- [ ] **Mapping:** `claude/<stack>/rules/README.md` mapping table is current
 - [ ] **Token budget:** alwaysApply / session-start ≤ 3; meta rules not always-on
-- [ ] **Leakage:** нет чужих stack agent stems / handoff strings (`preset-no-cross-stack-leakage`)
+- [ ] **Leakage:** no foreign stack agent stems / handoff strings (`preset-no-cross-stack-leakage`)
 - [ ] **Twin depth:** domain ≥15 lines; thin aliases documented
 - [ ] **README:** stack `rules/README.md` core→stack mapping / catalog updated if stems added
 - [ ] **CHANGELOG / package README:** note when public preset paths or install surface change

package/presets/claude/nuxt/rules/tooling-and-review/preset-token-budget.md

@@ -6,21 +6,20 @@ paths:
 
 <!-- shared-core: meta/preset-token-budget.md -->
 
-
 # Preset token budget
 
-Инварианты загрузки правил в **установленном** пресете (consumer app).
+Invariants for rule loading in an **installed** preset (consumer app).
 
 ## Hard caps
 
 | Platform | Always-on | Cap |
 |----------|-----------|-----|
 | Cursor | `alwaysApply: true` | **≤ 3** |
-| Claude | rules **without** `paths:` | **ровно 3** |
+| Claude | rules **without** `paths:` | **exactly 3** |
 
 **Claude Option A (README exclusion):** when counting Claude rules without `paths:` / session-start, **exclude `**/README.md`** (topic indexes are not session-start rules). The intended session-start trio remains **exactly 3**; body budget sums **only those 3** rules.
 
-Session-start body budget (где задокументировано): ≤140 строк суммарно (stretch ≤120).
+Session-start body budget (where documented): ≤140 lines total (stretch ≤120).
 
 ## Meta / author rules
 

package/presets/claude/nuxt/rules/tooling-and-review/preset-twin-sync.md

@@ -2,8 +2,8 @@
 description: Preset authoring: Cursor SoT → Claude twin same PR. Use when editing preset rules.
 paths: packages/ai-rules/presets/**
 ---
-<!-- shared-core: meta/preset-twin-sync.md -->
 
+<!-- shared-core: meta/preset-twin-sync.md -->
 
 # Preset twin sync
 
@@ -22,6 +22,7 @@ Cursor `.mdc` — **SoT per stack**. Claude topic `.md` — derived twin.
 | `mcp-ts` | `presets/cursor/mcp-ts/rules/*.mdc` | `presets/claude/mcp-ts/rules/<topic>/` | Keep in `claude/mcp-ts/rules/README.md` |
 | `php-hexagonal` | `presets/cursor/php-hexagonal/rules/*.mdc` | `presets/claude/php-hexagonal/rules/<topic>/` | Keep in `claude/php-hexagonal/rules/README.md` |
 | `php-laravel` | `presets/cursor/php-laravel/rules/*.mdc` | `presets/claude/php-laravel/rules/<topic>/` | Keep in `claude/php-laravel/rules/README.md` |
+| `android-kotlin` | `presets/cursor/android-kotlin/rules/*.mdc` | `presets/claude/android-kotlin/rules/<topic>/` | Keep in `claude/android-kotlin/rules/README.md` |
 
 ## Same-PR checklist
 
@@ -46,5 +47,6 @@ Cursor `.mdc` — **SoT per stack**. Claude topic `.md` — derived twin.
 - **mcp-ts:** missing Claude twin for a changed Cursor rule → **FAIL** (same as next / ios-swift / go / java; mapping table required).
 - **php-hexagonal:** missing Claude twin for a changed Cursor rule → **FAIL** (same as next / ios-swift / go / java / mcp-ts; mapping table required).
 - **php-laravel:** missing Claude twin for a changed Cursor rule → **FAIL** (same as next / ios-swift / go / java / mcp-ts / php-hexagonal; mapping table required).
+- **android-kotlin:** missing Claude twin for a changed Cursor rule → **FAIL** (same as next / ios-swift / go / java / mcp-ts / php-*; mapping table required).
 
 Dogfood: sync packages → root `.cursor/` after Cursor SoT changes (not the reverse). Use `packages/ai-rules/scripts/sync-dogfood-cursor.sh`.

package/presets/claude/nuxt/rules/tooling-and-review/technical-retro.md

@@ -1,15 +1,16 @@
 ---
-description: Роль агента для проведения технического ретроспективы (retro) команды / спринта. On-demand — предпочтительнее slash-команда /technical-retro.
+description: Agent role for running a technical retrospective (retro) for a team / sprint. On-demand — prefer the /technical-retro slash command.
 paths: .claude/team/**
 ---
+
 <!-- shared-core: review/technical-retro.md -->
 
-# Техническое ретро — rule alias
+# Technical retro — rule alias
 
-Полный сценарий (включая блок **«Работа агентов»** для slug из team tasks) — в slash-команде:
+Full scenario (including the **“Agent work”** block for a slug from team tasks) lives in the slash command:
 
 **`commands/technical-retro.md`** → `/technical-retro`
 
 When a task has `metrics.json`, use the local aggregation script and state the cohort, sample size, incomplete artifacts, attribution confidence, active attempt duration, and human-gate wait separately. Do not score malformed artifacts or gate wait as agent work.
 
-Используй rule только если command недоступен. Не дублируй содержимое command в ответе — следуй command-файлу и skill `technical-retro`.
+Use this rule only if the command is unavailable. Do not duplicate the command contents in the response — follow the command file and skill `technical-retro`.

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

@@ -1,12 +1,12 @@
 # UI and accessibility
 
-Компоненты, стили, пропсы.
+Components, styles, props.
 
-| Файл | Содержание | Загрузка |
-|------|------------|----------|
-| `no-v-bind-spread.md` | Явные пропсы, без `v-bind="obj"` | `paths: **/*.{vue,tsx,jsx}` |
-| `css-property-order.md` | Порядок CSS (Stylelint idiomatic-order) | `paths: **/*.{css,scss,vue}` |
-| `vue-ui.md` | Структура SFC, стили, composables | `paths: components|pages|layouts/**/*.{vue,ts}` |
-| `vue-a11y-coding.md` | A11y при написании UI | `paths: components|pages|layouts/**/*.{vue,ts}` |
+| File | Contents | Loading |
+|------|----------|---------|
+| `no-v-bind-spread.md` | Explicit props, no `v-bind="obj"` | `paths: **/*.{vue,tsx,jsx}` |
+| `css-property-order.md` | CSS property order (Stylelint idiomatic-order) | `paths: **/*.{css,scss,vue}` |
+| `vue-ui.md` | SFC structure, styles, composables | `paths: components|pages|layouts/**/*.{vue,ts}` |
+| `vue-a11y-coding.md` | A11y while writing UI | `paths: components|pages|layouts/**/*.{vue,ts}` |
 
 Deprecated stub `component-styles.md` **removed** — styles colocation lives in `vue-ui.md`.

package/presets/claude/nuxt/rules/ui-and-accessibility/vue-ui.md

@@ -5,15 +5,16 @@ paths:
   - "pages/**/*.{vue,ts}"
   - "layouts/**/*.{vue,ts}"
 ---
+
 # Vue UI (Nuxt)
 
-- Предпочитать **SFC** с `<script setup lang="ts">` (`script-setup-conventions`).
-- Явные `defineProps` / `defineEmits` (typed); без массового `v-bind="object"` (`no-v-bind-spread`).
-- Стили: scoped / CSS modules / design tokens — как у соседей; порядок свойств — `css-property-order-stylelint`.
-- Данные: читать Pinia / composables; **не** вызывать HTTP из SFC — только через `~/api` / store actions.
-- Навигация: `<NuxtLink>`, `navigateTo`, `useRouter` / `useRoute` — не `next/link` / `next/navigation`.
+- Prefer **SFC** with `<script setup lang="ts">` (`script-setup-conventions`).
+- Explicit `defineProps` / `defineEmits` (typed); no bulk `v-bind="object"` (`no-v-bind-spread`).
+- Styles: scoped / CSS modules / design tokens — as neighbors; property order — `css-property-order-stylelint`.
+- Data: read Pinia / composables; **do not** call HTTP from SFC — only via `~/api` / store actions.
+- Navigation: `<NuxtLink>`, `navigateTo`, `useRouter` / `useRoute` — not `next/link` / `next/navigation`.
 - A11y: `vue-a11y-coding`.
-- Границы UI: `architecture-boundaries-ui` — no DTO in templates; map in `api/**`.
+- UI boundaries: `architecture-boundaries-ui` — no DTO in templates; map in `api/**`.
 
 ## Incorrect
 

package/presets/claude/nuxt/skills/README.md

@@ -1,9 +1,9 @@
 # `.claude/skills` (preset nuxt)
 
-[Skills](https://code.claude.com/docs/en/skills) в Claude Code — сценарии, которые подгружаются по необходимости, а не в каждой сессии целиком. Они синхронизированы по смыслу с `.cursor/skills` из Cursor-пресета.
+[Skills](https://code.claude.com/docs/en/skills) in Claude Code are scenarios loaded on demand, not wholesale every session. They are semantically synced with `.cursor/skills` from the Cursor preset.
 
-| Skill | Когда использовать |
-|-------|--------------------|
+| Skill | When to use |
+|-------|-------------|
 | `feature-delivery` | End-to-end feature work across types, API, store, UI, tests |
 | `code-review` | MR/diff review using project architecture and test standards |
 | `debug-investigation` | Reproducing and fixing bugs with root-cause evidence |
@@ -14,4 +14,4 @@
 | `write-adr` | Author an Architecture Decision Record (context / decision / consequences) |
 | `vue-performance` | Implementer checklist: bundle, SSR/payload/client, memo, waterfalls, CWV (not a perf audit agent) |
 
-Папка копируется в `.claude/skills/` при `ai-rules init claude --preset nuxt`, если существует.
+The folder is copied to `.claude/skills/` on `ai-rules init claude --preset nuxt` when it exists.

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

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

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

@@ -1,6 +1,6 @@
 # Agent team artifacts
 
-Каталог артефактов пайплайна «команда агентов» Claude.
+Artifact directory for the Claude Code “agent team” pipeline.
 
 ## Layout
 
@@ -97,16 +97,20 @@ Prefer **`executing`** for pipeline mode. Legacy: `analysis`, `development`, `re
 ## Workflow entry
 
 ```bash
-/task <описание задачи>
+/task <task description>
 /task-continue <slug>
 /technical-retro <slug>
 ```
 
 Legacy: `/feature-start`, `/feature-continue`.
 
+## Creating task dirs
+
+Bootstrap `<slug>/` by **writing** `pipeline.json` (Write tool). Runtime/hook owns `status.json` lifecycle; parent may only create a minimal bootstrap if missing. Do **not** use Shell `mkdir -p` — Cursor’s default sandbox returns `Operation not permitted` (especially for repos on macOS Desktop/Documents).
+
 ## Git
 
-Commit task artifacts if you want them to survive `ai-rules clean claude`. Or copy finished tasks to `docs/agent-workflow/tasks/<slug>/`.
+Commit task artifacts if you want them to survive `ai-rules clean cursor`. Or copy finished tasks to `docs/agent-workflow/tasks/<slug>/`.
 
 ## Artifact manifest and receipts
 
@@ -131,6 +135,6 @@ After a human gate, `/task-continue` closes wait via the installed hook (do not
 printf '%s\n' '{"status":"completed","action":"end_human_gate","activateNext":true}' | bash .claude/hooks/chain-team-phases.sh
 ```
 
-That appends `human_gate_ended` before the next `attempt_started`. Cursor twin uses the same payload against `.cursor/hooks/chain-team-phases.sh`. Other installable stacks ship the same ledger contract in their `team/README.md`.
+That appends `human_gate_ended` before the next `attempt_started`. Claude twins use the same payload against `.claude/hooks/chain-team-phases.sh`. Other installable stacks ship the same ledger contract in their `team/README.md`.
 
 Aggregate with `node packages/ai-rules/scripts/aggregate-agent-task-metrics.mjs --team-root .claude/team`. It reports role/agent count, completed count, total/average duration, distinct completed run IDs, separate human-gate wait, and incomplete artifacts. For retros, see `/technical-retro` → **Metrics evidence**.

package/presets/claude/php-hexagonal/MCP.md

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

package/presets/claude/php-hexagonal/agents/README.md

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

package/presets/claude/php-hexagonal/agents/task-router.md

@@ -17,19 +17,19 @@ You are a task router for a **PHP 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», «обнови PHP/Composer-Composer» | 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), «upgrade», «обнови PHP/Composer» (upgrade PHP/Composer) | 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), «review MR», «проверь diff» (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», «юнит» (unit), «покрой use case» (cover use case) | unit-test-planner → unit-test-generator, or unit-test-healer | <!-- i18n-keep: E4 -->
 | `e2e-only` / integration | «integration», «e2e», «HTTP controller tests», «integration DB fixtures» | **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` | «документация» (documentation), «README», «changelog» | task-analyst → tech-writer | <!-- i18n-keep: E4 -->
+| `refactor` | «рефакторинг» (refactoring), «без изменения поведения» (no behavior change) | task-analyst → feature-developer → build-verifier → code-reviewer | <!-- i18n-keep: E4 -->
+| `spike` | «исследуй» (investigate), «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 «PHP backend uses integration-test trio».
 

package/presets/claude/php-hexagonal/commands/README.md

@@ -1,13 +1,13 @@
 # `.claude/commands` (preset php-hexagonal)
 
-Определения slash-команд и on-demand сценариев. Копируются в `.claude/commands/` при `ai-rules init claude --preset php-hexagonal`.
+Slash-command definitions and on-demand scenarios. Copied to `.claude/commands/` on `ai-rules init claude --preset php-hexagonal`.
 
-| Файл | Назначение |
-|------|------------|
-| `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` | Фасилитация технического ретро, включая блок «Работа агентов» |
+| File | Purpose |
+|------|---------|
+| `task.md` | Unified entry point: router → dynamic pipeline → first agent |
+| `task-continue.md` | Continue after human gate / pause using `pipeline.json` |
+| `feature-start.md` | Legacy analyst-only start without router |
+| `feature-continue.md` | Legacy continue; with `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 uses `skills/`, `agents/`, `hooks/`, and `team/` in addition to `rules/` and `commands/`.

package/presets/claude/php-hexagonal/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/php-hexagonal/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-team 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 through `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 yet — by writing a file (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/php-hexagonal/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`.
 
-## Алгоритм
+## Procedure
 
-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 |