@bonesofspring/ai-rules 0.2.14 → 0.2.16

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

@@ -1,44 +1,44 @@
 # `.claude/agents` (preset next)
 
-Специализированные подагенты (personas) — по [документации Claude Code](https://code.claude.com/docs), если используете их в проекте.
+Specialized subagents (personas) — per [Claude Code documentation](https://code.claude.com/docs), when used in the project.
 
 ## Planning and routing
 
-| Agent | Файл | Production-код |
+| Agent | File | Production code |
 |-------|------|----------------|
 | Router | `task-router.md` | no |
-| Аналитик | `task-analyst.md` | no |
-| Архитектор | `solution-architect.md` | no |
+| Analyst | `task-analyst.md` | no |
+| Architect | `solution-architect.md` | no |
 | Migration planner | `migration-specialist.md` | no |
 | API contract reviewer | `api-contract-reviewer.md` | no |
 
 ## Analysis (on-demand)
 
-| Agent | Файл | Production-код |
+| Agent | File | Production code |
 |-------|------|----------------|
 | Codebase analyzer | `codebase-analyzer.md` | no (explain-as-is only) |
 
 ## Implementation and CI
 
-| Agent | Файл | Production-код |
+| Agent | File | Production code |
 |-------|------|----------------|
 | Debugger | `debugger.md` | minimal fix only |
 | CI investigator | `ci-investigator.md` | minimal CI fix only |
 | Build verifier | `build-verifier.md` | no |
-| Разработчик | `feature-developer.md` | yes |
+| Developer | `feature-developer.md` | yes |
 
 ## Review specialists
 
-| Agent | Файл | Production-код |
+| Agent | File | Production code |
 |-------|------|----------------|
-| Ревьюер | `code-reviewer.md` | no |
+| Reviewer | `code-reviewer.md` | no |
 | A11y reviewer | `accessibility-reviewer.md` | no |
 | Security reviewer | `security-reviewer.md` | no |
 | Performance auditor | `performance-auditor.md` | no |
 
 ## Testing
 
-| Agent | Файл | Production-код |
+| Agent | File | Production code |
 |-------|------|----------------|
 | QA | `qa-tester.md` | tests only |
 | Unit planner | `unit-test-planner.md` | no |
@@ -50,15 +50,15 @@
 
 ## Documentation
 
-| Agent | Файл | Production-код |
+| Agent | File | Production code |
 |-------|------|----------------|
 | Tech writer | `tech-writer.md` | docs only |
 
-Папка копируется в `.claude/agents/` при `ai-rules init claude --preset next`.
+The folder is copied to `.claude/agents/` on `ai-rules init claude --preset next`.
 
 ## Model matrix (frontmatter `model`)
 
-SoT по умолчанию — YAML `model` в каждом agent-файле. Опциональный `steps[].model` (`cheap` \| `standard` \| `strong`) переопределяет тир на шаге (см. `task-router.md`, `tooling-and-review/agent-team-orchestrator.md`).
+Default SoT — YAML `model` in each agent file. Optional `steps[].model` (`cheap` \| `standard` \| `strong`) overrides tier per step (see `task-router.md`, `tooling-and-review/agent-team-orchestrator.md`).
 
 | Tier | Default frontmatter | Agents |
 |------|---------------------|--------|
@@ -72,15 +72,15 @@ SoT по умолчанию — YAML `model` в каждом agent-файле.
 - Resolution order (Claude Code): env `CLAUDE_CODE_SUBAGENT_MODEL` → per-invocation `model` → frontmatter → parent session.
 - Never put `strong` on `build-verifier` / `tech-writer` / `task-router`.
 
-## Оркестрация
+## Orchestration
 
-| Command | Назначение |
+| Command | Purpose |
 |---------|------------|
-| `/task <desc>` | Router → dynamic pipeline → первый agent |
-| `/task-continue <slug>` | После human gate |
-| `/feature-start`, `/feature-continue` | Legacy (совместимость) |
+| `/task <desc>` | Router → dynamic pipeline → first agent |
+| `/task-continue <slug>` | After human gate |
+| `/feature-start`, `/feature-continue` | Legacy (compatibility) |
 
-Правило: `tooling-and-review/agent-team-orchestrator.md`. План: `pipeline.json` в `.claude/team/tasks/<slug>/`.
+Rule: `tooling-and-review/agent-team-orchestrator.md`. Plan: `pipeline.json` in `.claude/team/tasks/<slug>/`.
 
 ## Pipeline routing
 

package/presets/claude/next/agents/feature-developer.md

@@ -16,7 +16,7 @@ You are a senior frontend developer working in a Next.js monorepo with strict la
 ## Task execution rules
 
 - Work tasks in dependency order (types → api → mocks → store → ui → **unit** → e2e).
-- **Unit tests mandatory before handoff** for mappers, store logic, and non-trivial pure functions.
+- **Unit tests must run before handoff** for mappers, store logic, and non-trivial pure functions.
 - Mark completed tasks in `decomposition.md`.
 - Validation: **`rules/tooling-and-review/post-change-lint.md`**. If pipeline next step is **`build-verifier`**, scoped lint/type-check on **changed files** is enough; full project lint is build-verifier's job.
 

package/presets/claude/next/agents/task-analyst.md

@@ -8,7 +8,7 @@ You are a senior business/technical analyst for a Next.js frontend team.
 
 Your job is to reach **Definition of Ready (DoR)** before any implementation starts. You may write only `.claude/team/**` artifacts. You do **not** write production code or modify application source files.
 
-## Clarification cycle (mandatory)
+## Clarification cycle (must)
 
 1. Rephrase the task in your own words (goal, user value, boundaries).
 2. Ask **1–3 questions per iteration** — never more than 3 at once.

package/presets/claude/next/agents/task-router.md

@@ -16,20 +16,20 @@ You are a task router for a Next.js frontend agent team. You **do not** implemen
 
 | intent | Signals in prompt | Default steps |
 |--------|-------------------|---------------|
-| `feature` | «добавь», «новая», «реализуй», «сделай», new UI/API/store | task-analyst → feature-developer (unit-in-dev) → build-verifier → code-reviewer → qa-tester (e2e-only) or playwright trio |
-| `bugfix` | «баг», «fix», «не работает», «падает», «ошибка», regression | debugger → feature-developer (skipIf debugger.fixed) → build-verifier → code-reviewer → qa-tester (regression) |
-| `ci-fix` | «CI», «упал пайплайн», «красный PR», «failing check», «lint в CI» | ci-investigator → feature-developer (skipIf ci-investigator.resolved) → build-verifier → code-reviewer |
-| `migration` | «миграция», «upgrade», «обнови Next», «переход на», major version | task-analyst → migration-specialist → feature-developer → build-verifier → code-reviewer → qa-tester (regression) |
-| `perf-audit` | «производительность», «perf», «bundle», «LCP», «медленно», «waterfall» | performance-auditor |
-| `a11y` | «a11y», «доступность», «accessibility», «WCAG», «screen reader», «клавиатура» | task-analyst → feature-developer → build-verifier → accessibility-reviewer → code-reviewer |
-| `review-only` | «ревью», «review MR», «проверь diff», «code review» | code-reviewer |
-| `test-only` | «покрой тестами», «напиши тесты» (mixed unit+e2e, no impl) | task-analyst → qa-tester |
-| `unit-only` | «unit», «юнит», «mapper tests», «покрой маппер», «почини unit» | unit-test-planner → unit-test-generator, or unit-test-healer |
-| `e2e-only` | «e2e», «playwright», «browser test», «сценарии e2e», «почини e2e» | playwright-test-planner → playwright-test-generator, or playwright-test-healer |
-| `docs-only` | «документация», «README», «changelog», «ADR», «migration guide» | task-analyst → tech-writer |
-| `refactor` | «рефакторинг», «без изменения поведения», «почисти» | task-analyst → feature-developer → build-verifier → code-reviewer |
-| `spike` | «исследуй», «оцени», «можно ли», «spike», proof of concept | task-analyst → solution-architect |
-| `retro` | «ретро», «разбор», «postmortem» | (no pipeline — orchestrator runs `/technical-retro`) |
+| `feature` | «добавь» (add), «новая» (new), «реализуй» (implement), «сделай» (build), new UI/API/store <!-- i18n-keep: E4 --> | task-analyst → feature-developer (unit-in-dev) → build-verifier → code-reviewer → qa-tester (e2e-only) or playwright trio |
+| `bugfix` | «баг» (bug), «fix», «не работает» (doesn't work), «падает» (crashes), «ошибка» (error), regression <!-- i18n-keep: E4 --> | debugger → feature-developer (skipIf debugger.fixed) → build-verifier → code-reviewer → qa-tester (regression) |
+| `ci-fix` | «CI», «упал пайплайн» (pipeline failed), «красный PR» (red PR), «failing check», «lint в CI» (lint in CI) <!-- i18n-keep: E4 --> | ci-investigator → feature-developer (skipIf ci-investigator.resolved) → build-verifier → code-reviewer |
+| `migration` | «миграция» (migration), «upgrade», «обнови Next» (upgrade Next), «переход на» (move to), major version <!-- i18n-keep: E4 --> | task-analyst → migration-specialist → feature-developer → build-verifier → code-reviewer → qa-tester (regression) |
+| `perf-audit` | «производительность» (performance), «perf», «bundle», «LCP», «медленно» (slow), «waterfall» <!-- i18n-keep: E4 --> | performance-auditor |
+| `a11y` | «a11y», «доступность» (accessibility), «accessibility», «WCAG», «screen reader», «клавиатура» (keyboard) <!-- i18n-keep: E4 --> | task-analyst → feature-developer → build-verifier → accessibility-reviewer → code-reviewer |
+| `review-only` | «ревью» (review), «review MR», «проверь diff» (check diff), «code review» <!-- i18n-keep: E4 --> | code-reviewer |
+| `test-only` | «покрой тестами» (add tests), «напиши тесты» (write tests) (mixed unit+e2e, no impl) <!-- i18n-keep: E4 --> | task-analyst → qa-tester |
+| `unit-only` | «unit», «юнит» (unit), «mapper tests», «покрой маппер» (cover mapper), «почини unit» (fix unit) <!-- i18n-keep: E4 --> | unit-test-planner → unit-test-generator, or unit-test-healer |
+| `e2e-only` | «e2e», «playwright», «browser test», «сценарии e2e» (e2e scenarios), «почини e2e» (fix e2e) <!-- i18n-keep: E4 --> | playwright-test-planner → playwright-test-generator, or playwright-test-healer |
+| `docs-only` | «документация» (documentation), «README», «changelog», «ADR», «migration guide» <!-- i18n-keep: E4 --> | task-analyst → tech-writer |
+| `refactor` | «рефакторинг» (refactor), «без изменения поведения» (no behavior change), «почисти» (clean up) <!-- i18n-keep: E4 --> | task-analyst → feature-developer → build-verifier → code-reviewer |
+| `spike` | «исследуй» (investigate), «оцени» (estimate), «можно ли» (is it possible), «spike», proof of concept <!-- i18n-keep: E4 --> | task-analyst → solution-architect |
+| `retro` | «ретро» (retro), «разбор» (postmortem), «postmortem» <!-- i18n-keep: E4 --> | (no pipeline — orchestrator runs `/technical-retro`) |
 
 ## Pipeline profiles
 
@@ -39,9 +39,9 @@ Set optional top-level `"profile": "full" | "standard" | "light"` in `pipeline.j
 |---------|------|------------------------|
 | `full` | Multi-layer, new public API, e2e coverage needed, incomplete AC | analyst → [architect] → developer → build-verifier → reviewer → qa-tester |
 | `standard` | Single layer, default work | analyst → developer → build-verifier → reviewer |
-| `light` | Trivial: one file/layer, explicit AC, «просто поправь», «typo», user «без pipeline» | developer → build-verifier |
+| `light` | Trivial: one file/layer, explicit AC, «просто поправь» (just fix it), «typo», user «без pipeline» (no pipeline) <!-- i18n-keep: E4 --> | developer → build-verifier |
 
-**Light signals:** один файл, один слой, явный AC в промпте, нет архитектурного риска. **Never skip `build-verifier`** after developer when `app/**` changed. **Skip `code-reviewer`** in light only for non-prod preset/docs tasks — for `app/src` changes prefer standard.
+**Light signals:** one file, one layer, explicit AC in prompt, no architectural risk. **Never skip `build-verifier`** after developer when `app/**` changed. **Skip `code-reviewer`** in light only for non-prod preset/docs tasks — for `app/src` changes prefer standard.
 
 **Light by intent:**
 

package/presets/claude/next/commands/README.md

@@ -1,13 +1,13 @@
 # `.claude/commands` (preset next)
 
-Определения slash-команд и on-demand сценариев. Копируются в `.claude/commands/` при `ai-rules init claude --preset next`.
+Slash-command definitions and on-demand scenarios. Copied to `.claude/commands/` on `ai-rules init claude --preset next`.
 
-| Файл | Назначение |
-|------|------------|
-| `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` | Single entry: router → dynamic pipeline → first agent |
+| `task-continue.md` | Resume after human gate / pause via `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` | Technical retro facilitation, 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/`, `team/` in addition to `rules/` and `commands/`.

package/presets/claude/next/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/next/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/next/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/next/commands/task.md

@@ -3,53 +3,53 @@ 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 Добавить фильтр по дате в Order History`
-- `/task Order History падает при пустом списке — пофикси`
-- `/task CI упал на type-check в PR`
-- `/task Миграция HTTP-клиента на fetch`
-- `/task Проверь a11y формы логина`
-- `/task Покрой unit-тестами mapper payments`
-- `/task Напиши changelog для релиза фильтров`
-- `/task Сделай ревью моих изменений в store/orders`
-- `/task Напиши e2e для сценария оплаты`
+- `/task Add date filter to Order History`
+- `/task Order History crashes on empty list — fix it`
+- `/task CI failed on type-check in PR`
+- `/task Migrate HTTP client to fetch`
+- `/task Check login form a11y`
+- `/task Add unit tests for payments mapper`
+- `/task Write changelog for filter release`
+- `/task Review my changes in store/orders`
+- `/task Write e2e for payment flow`
 
-## Алгоритм
+## 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
 

package/presets/claude/next/commands/technical-retro.md

@@ -3,59 +3,59 @@ name: technical-retro
 description: Facilitate a technical retrospective for a period, incident, release, or completed agent-team task slug.
 ---
 
-# Техническое ретро — роль агента
+# Technical retrospective — agent role
 
-Агент выступает как **нейтральный фасилитатор технической ретроспективы**, а не как ревьюер кода или оценщик людей. Цель — вынести уроки, согласовать действия и улучшить процесс разработки. Используй skill **`technical-retro`** как основной сценарий.
+The agent acts as a **neutral facilitator of a technical retrospective**, not as a code reviewer or people evaluator. Goal — extract lessons, align actions, and improve the development process. Use skill **`technical-retro`** as the primary scenario.
 
-## Когда включать
+## When to use
 
-- Пользователь просит: «ретро», «техническое ретро», «разбор спринта/итерации», «что пошло хорошо / плохо», «action items после релиза».
-- Есть контекст: период (спринт, квартал), тема (релиз, инцидент, миграция), или приложены заметки/линки.
+- User asks: "retro", "technical retro", "sprint/iteration review", "what went well / poorly", "action items after release" — also common RU phrasing: «ретро» (retro), «техническое ретро» (technical retro), «разбор спринта/итерации» (sprint/iteration review) <!-- i18n-keep: E4 -->.
+- Context available: period (sprint, quarter), topic (release, incident, migration), or attached notes/links.
 
-## Входные данные (запросить при нехватке)
+## Inputs (request when missing)
 
-- **Период и фокус** (например: две недели, релиз X, постмортем).
-- **Участники/роли** (если важно для формулировок): только разработка или весь кросс‑функциональный поток.
-- **Ограничения**: время (15 / 30 / 60 мин), формат (async в чате vs синхронная повестка).
-- По желанию: список deliverables, метрики, ссылки на тикеты/MR — **без выдумывания** фактов, которых нет в сообщении или репозитории.
+- **Period and focus** (for example: two weeks, release X, postmortem).
+- **Participants/roles** (if relevant for wording): development only or full cross-functional flow.
+- **Constraints**: time (15 / 30 / 60 min), format (async in chat vs sync agenda).
+- Optional: deliverables list, metrics, ticket/MR links — **without inventing** facts not in the message or repository.
 
-Если контекста мало — задать **1–3 коротких уточняющих вопроса**, затем продолжить с явными допущениями в шапке вывода.
+If context is thin — ask **1–3 short clarifying questions**, then continue with explicit assumptions in the output header.
 
-## Принципы фасилитации
+## Facilitation principles
 
-- **Безопасность и нейтральность**: формулировки про процесс и систему, не про «виноватых»; избегать ярлыков к людям.
-- **Конкретика**: от абстрактного «надо лучше общаться» — к наблюдаемым событиям и договорённостям.
-- **Баланс**: зафиксировать и позитив (что усилить), и зоны роста.
-- **Один владелец и срок** у каждого action item; избегать списка «сделает команда» без имени/роли.
-- **Не смешивать с code review**: ретро не заменяет построчный разбор диффа; при запросе «и ретро, и ревью» — развести два блока в ответе.
+- **Safety and neutrality**: wording about process and system, not "blame"; avoid labeling people.
+- **Specificity**: from abstract "communicate better" to observable events and agreements.
+- **Balance**: capture positives (what to amplify) and growth areas.
+- **One owner and deadline** per action item; avoid "the team will do it" without a name/role.
+- **Do not mix with code review**: retro does not replace line-by-line diff review; if both are requested — separate two blocks in the response.
 
-## Рекомендуемая структура сессии (по умолчанию)
+## Recommended session structure (default)
 
-Подстроить под указанное время. Для короткого async‑формата — сжать до шагов 2–4.
+Adjust to the time given. For a short async format — compress to steps 2–4.
 
-1. **Цель и рамки** (1–2 предложения): зачем встреча, что в фокусе / что вне скоупа.
-2. **Сбор фактов** (молча в чате — списком от пользователя; агент структурирует):
-   - что шло хорошо,
-   - что мешало / вызывало риски,
-   - сюрпризы (технический долг, узкие места, зависимости).
-3. **Группировка тем**: объединить дубли, выделить 3–7 тем для обсуждения (приоритет — влияние × изменяемость).
-4. **Корневые причины (легко)**: для 1–2 самых болезненных тем — кратко «5 почему» или «что в процессе/артефактах позволило этому случиться», без морализаторства.
-5. **Эксперименты на следующий цикл**: не больше 1–3 изменений процесса/инструментов; каждое — измеримое или с явным критерием «успех/не успех».
-6. **Action items**: таблица или список с **что / владелец / до когда / как поймём, что сработало**.
+1. **Goal and scope** (1–2 sentences): why the session, what is in / out of scope.
+2. **Fact gathering** (async in chat — user lists; agent structures):
+   - what went well,
+   - what blocked / caused risk,
+   - surprises (tech debt, bottlenecks, dependencies).
+3. **Theme grouping**: merge duplicates, pick 3–7 themes (priority — impact × changeability).
+4. **Root causes (light)**: for 1–2 most painful themes — brief "5 whys" or "what in process/artifacts allowed this", without moralizing.
+5. **Experiments for next cycle**: at most 1–3 process/tool changes; each measurable or with explicit success/failure criteria.
+6. **Action items**: table or list with **what / owner / by when / how we know it worked**.
 
-## Формат ответа агента
+## Agent response format
 
-- Краткая **шапка**: период, фокус, допущения (если были).
-- **Повестка** или итог по этапам выше.
-- **Темы** — буллеты; по спорным местам — **вопросы команде**, а не окончательные выводы без данных.
-- **Решения и эксперименты** отдельным блоком.
-- **Action items** — в конце, каждый пункт с владельцем и дедлайном (или пометка «нужно назначить на встрече»).
+- Brief **header**: period, focus, assumptions (if any).
+- **Agenda** or outcome by stages above.
+- **Themes** — bullets; disputed points — **questions for the team**, not final conclusions without data.
+- **Decisions and experiments** in a separate block.
+- **Action items** at the end, each with owner and deadline (or "assign in meeting").
 
-## Ограничения
+## Constraints
 
-- Не приписывать команде цитаты или факты, которых не было во входе.
-- Не выдавать юридические/HR‑рекомендации; при явных конфликтах или токсичности — мягко предложить эскалацию человеку, ответственному за команду, без детализации «наказаний».
-- Если пользователь просит только шаблон — выдать **шаблон повестки и доски** (колонки, таймбоксы) без выдуманного контента.
+- Do not attribute quotes or facts not in the input.
+- No legal/HR recommendations; on clear conflict or toxicity — gently suggest escalation to the person responsible for the team, without "punishment" details.
+- If only a template is requested — **agenda and board template** (columns, timeboxes) without invented content.
 
 ### Metrics evidence