@bonesofspring/ai-rules 0.2.14 → 0.2.15

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

@@ -1,54 +1,54 @@
 # `.cursor/commands` (preset php-hexagonal)
 
-Slash-команды копируются в `.cursor/commands/` при `ai-rules init cursor --preset php-hexagonal`.
+Slash commands are copied to `.cursor/commands/` on `ai-rules init cursor --preset php-hexagonal`.
 
-## Команда агентов
+## Agent commands
 
-| Command | Назначение |
-|---------|------------|
-| **`/task <описание>`** | **Главная точка входа:** router → pipeline.json → нужные роли по порядку |
-| `/task-continue <slug>` | После human gate или паузы |
-| `/feature-start <описание>` | Legacy: только analyst (без router) |
-| `/feature-continue <slug>` | Alias task-continue |
-| `/technical-retro [slug]` | Ретро; с slug — блок «Работа агентов» |
+| Command | Purpose |
+|---------|---------|
+| **`/task <description>`** | **Main entry point:** router → pipeline.json → required roles in order |
+| `/task-continue <slug>` | After human gate or pause |
+| `/feature-start <description>` | Legacy: analyst only (no router) |
+| `/feature-continue <slug>` | Alias for task-continue |
+| `/technical-retro [slug]` | Retro; with slug — “Agent work” section |
 
-## Примеры `/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 HTTP controller tests CreateOrder падает на пустом body
+/task HTTP controller tests CreateOrder падает на пустом body (CreateOrder HTTP controller tests fail on empty body) <!-- i18n-keep: E4 -->
 → debugger → developer → reviewer → QA (regression)
 
-/task CI упал на composer test / vendor/bin/phpunit / static analysis в PR #142
+/task CI упал на composer test / vendor/bin/phpunit / static analysis в PR #142 (CI failed on composer test / phpunit / static analysis in PR #142) <!-- i18n-keep: E4 -->
 → ci-investigator → developer → reviewer
 
-/task Миграция на PHP 21 / обновление PHP framework edge
+/task Миграция на PHP 21 / обновление PHP framework edge (Migrate to PHP 21 / update PHP framework edge) <!-- 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/php-hexagonal/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/php-hexagonal/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/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. Прочитай `.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`.
 
-## Алгоритм
+## Procedure
 
-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/php-hexagonal/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 упал на composer test / composer test в PR`
-- `/task Миграция на новый PHP / обновление Composer-Composer модуля`
-- `/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 упал на composer test / composer test в PR` (CI failed on composer test in PR) <!-- i18n-keep: E4 -->
+- `/task Миграция на новый PHP / обновление Composer модуля` (Migrate to new PHP / update Composer 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
 

package/presets/cursor/php-hexagonal/commands/technical-retro.md

@@ -3,82 +3,82 @@ name: technical-retro
 description: Facilitate a technical retrospective for a period, incident, release, or completed agent-team task slug.
 ---
 
-# Техническое ретро
+# Technical retrospective
 
-Агент выступает как **нейтральный фасилитатор технической ретроспективы**, а не как ревьюер кода или оценщик людей. Используй skill **`technical-retro`** как основной сценарий.
+The agent acts as a **neutral facilitator of a technical retrospective**, not as a code reviewer or people evaluator. Use skill **`technical-retro`** as the primary scenario.
 
-## Когда включать
+## When to use
 
-- Пользователь просит: «ретро», «техническое ретро», «разбор спринта/итерации», «action items после релиза».
-- После завершения пайплайна команды агентов (`/feature-start` → `/feature-continue`).
-- Есть контекст: период, тема (релиз, инцидент), slug задачи, заметки.
+- User asks: "retro", "technical retro", "sprint/iteration review", "action items after release" — also common RU phrasing: «ретро» (retro), «техническое ретро» (technical retro), «разбор спринта/итерации» (sprint/iteration review) <!-- i18n-keep: E4 -->.
+- After completing the agent-team pipeline (`/feature-start` → `/feature-continue`).
+- Context available: period, topic (release, incident), task slug, notes.
 
-## Входные данные (собрать, не выдумывать)
+## Inputs (gather; do not invent)
 
-Запросить при нехватке:
+Request when missing:
 
-- **Период и фокус**.
-- **Slug задачи** (если ретро по работе команды агентов).
-- **Участники/роли** (если важно).
-- **Ограничения**: время, формат (async vs синхрон).
+- **Period and focus**.
+- **Task slug** (if retro is about agent-team work).
+- **Participants/roles** (if relevant).
+- **Constraints**: time, format (async vs sync).
 
-### Артефакты команды агентов (если есть slug)
+### Agent-team artifacts (if slug present)
 
-Прочитать из репозитория:
+Read from the repository:
 
 - `.cursor/team/tasks/<slug>/pipeline.json`
 - `.cursor/team/tasks/<slug>/brief.md`
 - `.cursor/team/tasks/<slug>/decomposition.md`
 - `.cursor/team/tasks/<slug>/status.json`
-- Git diff / `git status` для изменённых файлов
+- Git diff / `git status` for changed files
 
-Не приписывать факты, которых нет в артефактах, diff или сообщении пользователя.
+Do not attribute facts not present in artifacts, diff, or the user's message.
 
-## Принципы фасилитации
+## Facilitation principles
 
-- **Безопасность**: процесс и система, не «виноватые».
-- **Конкретика**: от абстракций к наблюдаемым событиям.
-- **Баланс**: позитив и зоны роста.
-- **Action items**: владелец и срок у каждого.
-- **Не смешивать с code review** — развести блоки, если запросили оба.
+- **Safety**: process and system, not "blame".
+- **Specificity**: from abstractions to observable events.
+- **Balance**: positives and growth areas.
+- **Action items**: owner and deadline for each.
+- **Do not mix with code review** — separate blocks if both were requested.
 
-## Структура сессии (по умолчанию)
+## Default session structure
 
-1. **Цель и рамки**.
-2. **Сбор фактов**: хорошо / мешало / сюрпризы.
-3. **Группировка тем** (3–7).
-4. **Корневые причины** для 1–2 болезненных тем.
-5. **Эксперименты** (1–3 изменения процесса).
-6. **Action items**: что / владелец / до когда / критерий успеха.
+1. **Goal and scope**.
+2. **Fact gathering**: went well / blocked / surprises.
+3. **Theme grouping** (3–7).
+4. **Root causes** for 1–2 painful themes.
+5. **Experiments** (1–3 process changes).
+6. **Action items**: what / owner / by when / success criteria.
 
-## Блок «Работа агентов» (обязателен при slug)
+## "Agent work" block (required when slug present)
 
-Если ретро связано с пайплайном `/feature-start`:
+If retro is tied to a `/feature-start` pipeline:
 
-| Вопрос | Что фиксировать |
+| Question | What to capture |
 |--------|-----------------|
-| Router | Ошибка intent, лишние/пропущенные steps в pipeline |
-| Аналитик | Ошибки в assumptions, пропущенные AC, лишние/недостающие таски |
-| Декомпозиция | Неполное покрытие слоёв, неверный порядок, blocked-зависимости |
-| Developer | Scope creep, пропущенные правила, lint/type gaps |
-| Reviewer | Пропущенные дефекты, false positives, качество чеклиста |
-| QA | Покрытие AC тестами, flakiness, пробелы в e2e планах |
+| Router | Intent error, extra/missing pipeline steps |
+| Analyst | Assumption errors, missed AC, extra/missing tasks |
+| Decomposition | Incomplete layer coverage, wrong order, blocked dependencies |
+| Developer | Scope creep, missed rules, lint/type gaps |
+| Reviewer | Missed defects, false positives, checklist quality |
+| QA | AC test coverage, flakiness, e2e plan gaps |
 
-**Action items** в этом блоке — на улучшение **промптов, subagents и rules** (не только кода).
+**Action items** in this block — improve **prompts, subagents, and rules** (not only code).
 
-## Формат ответа
+## Response format
 
-- Шапка: период, фокус, slug (если есть), допущения.
-- Повестка по этапам.
-- Блок **«Работа агентов»** (если применимо).
-- Темы — буллеты; спорное — **вопросы команде**.
-- **Action items** в конце.
+- Header: period, focus, slug (if any), assumptions.
+- Agenda by stage.
+- **"Agent work"** block (if applicable).
+- Themes — bullets; disputed points — **questions for the team**.
+- **Action items** at the end.
 
-## Ограничения
+## Constraints
 
-- Не приписывать цитаты и факты без входа.
-- Не выдавать HR‑рекомендации.
-- Если просят только шаблон — **шаблон повестки** без выдуманного контента.
+- Do not attribute quotes or facts without input.
+- No HR recommendations.
+- If only a template is requested — **agenda template** without invented content.
 
 ### Metrics evidence
 

package/presets/cursor/php-hexagonal/rules/README.md

@@ -18,7 +18,7 @@
 
 ## Loading strategy
 
-- **`alwaysApply: true`** (Cursor) / **без `paths:`** (Claude) — только базовые инварианты (**3**): `php-app-core`, `architecture-boundaries`, `code-quality-and-refactoring`
+- **`alwaysApply: true`** (Cursor) / **without `paths:`** (Claude) — only base invariants (**3**): `php-app-core`, `architecture-boundaries`, `code-quality-and-refactoring`
 - **On-demand / requestable** — `post-change-test`, `php-tooling`, `agent-team-intake`, `agent-team-orchestrator`, hexagonal domain/adapters, tests, feature-delivery-workflow, reference-features, `design-guidance`, `anti-sycophancy-discipline`, `technical-retro`
 - **Preset author meta** (globs `packages/ai-rules/presets/**`, never alwaysApply): `preset-layering`, `preset-twin-sync`, `preset-token-budget`, `preset-pr-checklist`, `preset-no-cross-stack-leakage`
 - **Skills** — `feature-delivery`, `code-review`, `integration-testing`, `unit-testing`, …
@@ -88,7 +88,7 @@ Claude twins + Cursor→Claude map: `presets/claude/php-hexagonal/rules/README.m
 | `tests-integration` | full | DB/HTTP contracts; integration-test-* |
 | `tests-e2e` | full | optional smoke; prefer integration-test-* |
 
-**Всего topic `.mdc`:** 29 domain + 5 preset-meta (без README) = 34.
+**Total topic `.mdc` files:** 29 domain + 5 preset-meta (excluding README) = 34.
 
 ## Defaults (human-locked)
 

package/presets/cursor/php-hexagonal/rules/agent-team-intake.mdc

@@ -11,9 +11,9 @@ When the user message looks like a **work request** (implement, add, fix, refact
 
 1. Prefer **`/task <their request>`** or invoke **task-router** first.
 2. Do not jump straight to coding without router + pipeline when scope is non-trivial.
-3. Pure questions («как работает X», «объясни») — prefer agent **`codebase-analyzer`** (explain-as-is); trivial one-liners may be answered inline. Do not open `/task`.
+3. Pure questions (“how does X work”, “explain”) — prefer agent **`codebase-analyzer`** (explain-as-is); trivial one-liners may be answered inline. Do not open `/task`.
 
-Exceptions: user explicitly says «без pipeline», «просто сделай», or continues an active slug.
+Exceptions: user explicitly says “no pipeline”, “just do it”, or continues an active slug.
 
 ## Stack notes
 

package/presets/cursor/php-hexagonal/rules/agent-team-orchestrator.mdc

@@ -9,7 +9,7 @@ alwaysApply: false
 
 Parent agent = **manager**. Router plans; specialists execute. Artifacts: `.cursor/team/tasks/<slug>/` (Claude: `.claude/team/tasks/<slug>/`).
 
-Work request без `/task` — см. **agent-team-intake** (когда предлагать router вместо прямого кодинга).
+Work request without `/task` — see **agent-team-intake** (when to suggest the router instead of coding directly).
 
 ## Entry points
 
@@ -162,12 +162,12 @@ If `pipeline.json` is missing (old `/feature-start` tasks), fall back to fixed p
 
 Do **not** run `/task` + router for:
 
-- Pure questions («как работает X», «объясни») — prefer agent **`codebase-analyzer`** for deep traces; inline OK for trivial one-liners.
+- Pure questions («как работает X» (how does X work), «объясни» (explain)) — prefer agent **`codebase-analyzer`** for deep traces; inline OK for trivial one-liners. <!-- i18n-keep: E4 -->
 - Typo / one-file fix / trivial config with no architecture risk.
-- User explicitly says «без pipeline», «просто сделай», or continues an active slug.
+- User explicitly says «без pipeline» (no pipeline), «просто сделай» (just do it), or continues an active slug. <!-- i18n-keep: E4 -->
 - Single-line `docs-only` with no code impact.
 
-Borderline work requests — см. **agent-team-intake**.
+Borderline work requests — see **agent-team-intake**.
 
 ## Auto-detection (optional)
 

package/presets/cursor/php-hexagonal/rules/architecture-boundaries.mdc

@@ -4,22 +4,22 @@ alwaysApply: true
 ---
 
 
-# Границы слоёв (hexagonal)
+# Layer boundaries (hexagonal)
 
 - **Domain** (`**/Domain/**`, `**/domain/**`):
-  - Может: entities, value objects, domain services, domain errors; PHP stdlib / same BC domain.
-  - Не должен: framework HTTP kernels, Eloquent/Doctrine as domain types, broker SDKs, transport DTOs.
+  - May: entities, value objects, domain services, domain errors; PHP stdlib / same BC domain.
+  - Must not: framework HTTP kernels, Eloquent/Doctrine as domain types, broker SDKs, transport DTOs.
 - **Application** (`**/Application/**`, `**/application/**`):
-  - Может: use cases; **define ports** (inbound/outbound interfaces) with domain types in signatures.
-  - Не должен: concrete adapters, SQL/DQL, controller/framework types as domain input.
+  - May: use cases; **define ports** (inbound/outbound interfaces) with domain types in signatures.
+  - Must not: concrete adapters, SQL/DQL, controller/framework types as domain input.
 - **Ports**: interfaces only — no adapter implementations in port packages.
 - **Driving adapters** (`Adapters/Inbound/**`, `adapters/inbound/**`): map DTO ↔ application/domain at the edge; no business rules/SQL in controllers.
 - **Driven adapters** (`Adapters/Outbound/**`, `adapters/outbound/**`): implement outbound ports; map rows/messages → domain; do not leak persistence models upward.
 - **Composition** (`Composition/`, `composition/`, bootstrap): wires the graph; no business logic.
 
-# Зависимости
+# Dependencies
 
-- Направление: **adapters → application → domain**.
+- Direction: **adapters → application → domain**.
 - Driven adapters implement outbound ports defined by application.
 - Domain never imports adapters or frameworks.
 - Cross-feature access — only via public ports / module API, not deep imports of another feature's internals.
@@ -30,7 +30,7 @@ alwaysApply: true
 - Inbound HTTP/gRPC → `adapters-driving` + `api-http` / `api-grpc`; outbound persistence/messaging → `adapters-driven` + matching `*-adapters`
 - `**/Composition/**`, bootstrap → `composition-root`; after `*.php` edits → `post-change-test` (+ `php-tooling`)
 
-# Требование к агенту
+# Agent requirement
 
-- Класть файлы в правильный слой; не «коротить» слои ради скорости.
-- DI / wiring только в composition / bootstrap.
+- Place files in the correct layer; do not short-circuit layers for speed.
+- DI / wiring only in composition / bootstrap.