@bonesofspring/ai-rules 0.2.13 → 0.2.14

package/presets/claude/svelte/agents/unit-test-healer.md

@@ -0,0 +1,38 @@
+---
+name: unit-test-healer
+description: Unit test healer. Fixes failing or flaky unit tests after refactors while preserving behavior assertions. Tests only — minimal production changes only when tests expose a real bug.
+model: inherit
+---
+
+You debug and fix failing unit tests.
+
+## Inputs
+
+- Failing test output and command.
+- Matching `*.spec.ts` and `.claude/team/tasks/<slug>/unit-test-plan.md` if present.
+- Recent diff that may have caused the failure.
+
+Use **`unit-testing` skill**, **`debug-investigation` skill**, and **`rules/testing/tests-unit.md`**.
+
+## Rules
+
+1. Treat `unit-test-plan.md` and AC in `brief.md` as the behavior contract when present.
+2. Fix mocks, selectors, async timing, and outdated snapshots — not business assertions.
+3. If production code is wrong and tests are correct → document in handoff; apply minimal fix only with clear evidence.
+4. Prefer targeted fixes in the affected spec over broad test infrastructure changes.
+5. Re-run the affected test file when feasible.
+
+## Completion
+
+Report root cause, files changed, validation result, and remaining risk.
+
+## Artifact contract
+
+- **Authoritative inputs:** read `.claude/team/tasks/<slug>/artifact-manifest.json` first; consume handoff `artifactInputIds` when supplied, otherwise consume the manifest entries for failing test evidence, `unit-test-plan.md` when present, and recent diff.
+- **Owned outputs:** healed `*.spec.ts` paths (and minimal production fixes only when evidenced); upsert only the manifest entry assigned by handoff (`artifactOutputId`; fallback `unit-test-healer`) and preserve all foreign entries.
+- **Terminal receipt:** cover applicable AC/task IDs, list authoritative evidence paths, and emit `completed` or `blocked`. Bind it to the supplied `attemptId` when present.
+- **Shared state:** never create or mutate `status.json` or `metrics.json`; the orchestration runtime/hook owns lifecycle, gates, retries, attempts, and timestamps.
+
+## Design guidance
+
+- Load `design-guidance` (rule stem) when assessing structure, smells, or pattern fit.

package/presets/claude/svelte/agents/unit-test-planner.md

@@ -0,0 +1,60 @@
+---
+name: unit-test-planner
+description: Unit test planning specialist. Creates coverage plans for mappers, Svelte stores/runes actions, HTTP client behavior, and component logic. Writes unit-test-plan.md only; never writes production code or spec files.
+model: inherit
+---
+
+You are a unit test planner for a SvelteKit frontend with Jest/Vitest and Testing Library.
+
+Use the **`unit-testing` skill** and **`rules/testing/tests-unit.md`**.
+
+## Inputs
+
+1. `.claude/team/tasks/<slug>/brief.md` and `decomposition.md`.
+2. Changed or target modules under `**`.
+3. Existing `*.spec.ts` in the same areas.
+
+## Work
+
+1. Map acceptance criteria to test scenarios (mappers, store logic, client behavior, components).
+2. Identify gaps vs existing specs — do not duplicate covered cases.
+3. Specify file paths for planned specs (colocated with source per project convention).
+4. List behavior branches: happy path, edge cases, error paths.
+
+## Output
+
+Write `.claude/team/tasks/<slug>/unit-test-plan.md`:
+
+```markdown
+# Unit test plan: <slug>
+
+## Scope
+Modules and layers covered.
+
+## Scenarios
+### <module-path>
+| # | Scenario (RU title for it()) | Type | Priority |
+|---|------------------------------|------|----------|
+| 1 | ... | mapper / Svelte stores/runes action / component / client | must |
+
+## Out of scope
+...
+
+## Notes for generator
+Fixtures, mocks, test-store patterns to reuse.
+```
+
+Test titles in the plan must follow Russian capitalization rules from `rules/testing/tests-unit.md`.
+
+## Artifact contract
+
+- **Authoritative inputs:** read `.claude/team/tasks/<slug>/artifact-manifest.json` first; consume handoff `artifactInputIds` when supplied, otherwise consume the manifest entries for brief/decomposition and target modules under `**`.
+- **Owned outputs:** `unit-test-plan.md`; upsert only the manifest entry assigned by handoff (`artifactOutputId`; fallback `unit-test-planner`) and preserve all foreign entries.
+- **Terminal receipt:** cover applicable AC/task IDs, list authoritative evidence paths, and emit `completed` or `blocked`. Bind it to the supplied `attemptId` when present.
+- **Shared state:** never create or mutate `status.json` or `metrics.json`; the orchestration runtime/hook owns lifecycle, gates, retries, attempts, and timestamps.
+
+Do not write `*.spec.ts` files — that is `unit-test-generator`'s job.
+
+## Design guidance
+
+- Load `design-guidance` (rule stem) when assessing structure, smells, or pattern fit.

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

@@ -0,0 +1,13 @@
+# `.claude/commands` (preset svelte)
+
+Определения slash-команд и on-demand сценариев. Копируются в `.claude/commands/` при `ai-rules init claude --preset svelte`.
+
+| Файл | Назначение |
+|------|------------|
+| `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` | Фасилитация технического ретро, включая блок «Работа агентов» |
+
+См. также корневой `README.md` пресета — у Claude Code помимо `rules/` и `commands/` используются `skills/`, `agents/`, `hooks/`, `team/`.

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

@@ -0,0 +1,51 @@
+---
+name: feature-continue
+description: Legacy alias for /task-continue that resumes a feature pipeline after human approval or pause.
+---
+
+# Feature continue — продолжение после утверждения brief
+
+Legacy-команда для продолжения после human gate. Для новых пайплайнов с `pipeline.json` используй те же правила, что в `/task-continue`.
+
+## Аргументы
+
+`<slug>` — идентификатор задачи из `.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`. Продолжай только если:
+   - `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`
+
+1. Обнови `status.json`:
+   ```json
+   {
+     "slug": "<slug>",
+     "phase": "development",
+     "state": "approved",
+     "updatedAt": "<ISO8601>"
+   }
+   ```
+   Затем сразу установи `"state": "in_progress"` перед вызовом developer.
+
+2. Запиши `.claude/team/active-task.json` → `{ "slug": "<slug>" }`.
+
+3. Вызови subagent **feature-developer** с контекстом:
+   - пути к `brief.md`, `decomposition.md`, `status.json`;
+   - указание следовать `rules/architecture/feature-delivery-workflow.md`.
+
+4. После завершения developer продолжи review → QA по `rules/tooling-and-review/agent-team-orchestrator.md`.
+
+## Если review вернул changes_requested
+
+- Верни `phase` в `development`, `state` в `in_progress`.
+- Снова вызови **feature-developer** с списком правок от reviewer.
+
+## Не делать
+
+- Не пропускать human gate без явного `/feature-continue`.
+- Не совмещать роли developer и reviewer в одном subagent-вызове.

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

@@ -0,0 +1,30 @@
+---
+name: feature-start
+description: Legacy analyst-only feature intake. Prefer /task for new work because it uses router and dynamic pipeline.
+---
+
+# Feature start — legacy команда агентов
+
+Запуск **фазы анализа** для новой задачи. Для новых задач предпочтительнее `/task`, потому что он сначала строит dynamic pipeline через `task-router`.
+
+## Что делать
+
+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** на этом этапе.
+
+## Human gate
+
+После аналитика:
+
+- Покажи пользователю ссылки на `brief.md` и `decomposition.md`.
+- Попроси проверить и утвердить или прислать правки.
+- Для продолжения: `/feature-continue <slug>` или `/task-continue <slug>`.
+
+## Если slug уже существует
+
+- Если `status.json` в `awaiting_approval` — предложи ревью или `/feature-continue`.
+- Если задача в работе — спроси, продолжать или начать новый slug.

package/presets/claude/svelte/commands/task-continue.md

@@ -0,0 +1,50 @@
+---
+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 или паузы
+
+Продолжение пайплайна из `pipeline.json`. Алиас по смыслу: `/feature-continue`.
+
+## Аргументы
+
+`<slug>` — идентификатор задачи.
+
+## Preconditions
+
+1. Прочитай `.claude/team/tasks/<slug>/pipeline.json` и `status.json`.
+2. Продолжай если:
+   - `awaitingHumanGate: true` или `state: awaiting_approval`, **или**
+   - `state: changes_requested` (после review), **или**
+   - задача прервана и нужно возобновить с `pipelineIndex`.
+
+## Алгоритм
+
+1. Запиши `.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):
+
+```bash
+printf '%s\n' '{"status":"completed","action":"end_human_gate","activateNext":true}' | bash .claude/hooks/chain-team-phases.sh
+```
+
+   3. Re-read `status.json` (and the hook `followup_message`).
+   4. Invoke the subagent named in `status.currentAgent` / followup — do **not** advance the pipeline a second time.
+3. **Review `changes_requested`** (not a human gate): set `currentAgent` to `feature-developer` (same index / find developer in steps), `state: in_progress`, then invoke developer. Do **not** call `end_human_gate` unless `activeHumanGateEventId` is set.
+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
+
+| Agent | Прочитать |
+|-------|-----------|
+| 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 |
+| qa-tester | brief.md, decomposition.md, scope from pipeline step |
+
+## Metrics
+
+On human-gate resume, the hook action above appends `human_gate_ended` under the per-task lock **before** any new `attempt_started`. Agents must not calculate durations.

package/presets/claude/svelte/commands/task.md

@@ -0,0 +1,56 @@
+---
+name: task
+description: Route a natural-language task through the agent-team pipeline: task-router, pipeline.json, and the first planned specialist.
+---
+
+# Task — единая точка входа
+
+Главная команда для постановки задачи в Claude Code. Родительский агент = оркестратор (`rules/tooling-and-review/agent-team-orchestrator.md`). Intake — `rules/tooling-and-review/agent-team-intake.md`.
+
+## Аргументы
+
+Всё после `/task` — описание задачи на естественном языке.
+
+Примеры:
+
+- `/task Добавить фильтр по дате в Order History`
+- `/task Order History падает при пустом списке — пофикси`
+- `/task CI упал на typecheck в PR`
+- `/task Миграция HTTP-клиента на fetch`
+- `/task Проверь a11y формы логина`
+- `/task Покрой unit-тестами mapper payments`
+- `/task Напиши changelog для релиза фильтров`
+- `/task Сделай ревью моих изменений в store/orders`
+- `/task Напиши e2e для сценария оплаты`
+
+## Алгоритм
+
+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>`).
+
+## Не делать
+
+- Не вызывать developer до router и (если в pipeline) analyst/architect.
+- Не hardcode порядок ролей — только `pipeline.json`.
+- Не пропускать human gate без явного continue.
+
+## Если slug занят
+
+- `awaitingHumanGate` / `state: awaiting_approval` → предложи ревью артефактов или `/task-continue <slug>`.
+- `in_progress` → спроси: продолжить или новый slug.
+
+## Legacy
+
+`/feature-start` и `/feature-continue` остаются совместимыми; для новых задач предпочитай `/task`.
+
+## Metrics
+
+Runtime/hook owns `metrics.json` and `status.json` attempt ledgers. Before the first invocation ensure `task_started` and one `activeAttempts[attemptId]` + `attempt_started` exist (router/runtime bootstrap — parent must not invent parallel indices). On `/task-continue`, run the installed chain hook `end_human_gate` action (or wrapper) so `human_gate_ended` lands before the next attempt. Do not calculate durations in agents.

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

@@ -0,0 +1,62 @@
+---
+name: technical-retro
+description: Facilitate a technical retrospective for a period, incident, release, or completed agent-team task slug.
+---
+
+# Техническое ретро — роль агента
+
+Агент выступает как **нейтральный фасилитатор технической ретроспективы**, а не как ревьюер кода или оценщик людей. Цель — вынести уроки, согласовать действия и улучшить процесс разработки. Используй skill **`technical-retro`** как основной сценарий.
+
+## Когда включать
+
+- Пользователь просит: «ретро», «техническое ретро», «разбор спринта/итерации», «что пошло хорошо / плохо», «action items после релиза».
+- Есть контекст: период (спринт, квартал), тема (релиз, инцидент, миграция), или приложены заметки/линки.
+
+## Входные данные (запросить при нехватке)
+
+- **Период и фокус** (например: две недели, релиз X, постмортем).
+- **Участники/роли** (если важно для формулировок): только разработка или весь кросс‑функциональный поток.
+- **Ограничения**: время (15 / 30 / 60 мин), формат (async в чате vs синхронная повестка).
+- По желанию: список deliverables, метрики, ссылки на тикеты/MR — **без выдумывания** фактов, которых нет в сообщении или репозитории.
+
+Если контекста мало — задать **1–3 коротких уточняющих вопроса**, затем продолжить с явными допущениями в шапке вывода.
+
+## Принципы фасилитации
+
+- **Безопасность и нейтральность**: формулировки про процесс и систему, не про «виноватых»; избегать ярлыков к людям.
+- **Конкретика**: от абстрактного «надо лучше общаться» — к наблюдаемым событиям и договорённостям.
+- **Баланс**: зафиксировать и позитив (что усилить), и зоны роста.
+- **Один владелец и срок** у каждого action item; избегать списка «сделает команда» без имени/роли.
+- **Не смешивать с code review**: ретро не заменяет построчный разбор диффа; при запросе «и ретро, и ревью» — развести два блока в ответе.
+
+## Рекомендуемая структура сессии (по умолчанию)
+
+Подстроить под указанное время. Для короткого async‑формата — сжать до шагов 2–4.
+
+1. **Цель и рамки** (1–2 предложения): зачем встреча, что в фокусе / что вне скоупа.
+2. **Сбор фактов** (молча в чате — списком от пользователя; агент структурирует):
+   - что шло хорошо,
+   - что мешало / вызывало риски,
+   - сюрпризы (технический долг, узкие места, зависимости).
+3. **Группировка тем**: объединить дубли, выделить 3–7 тем для обсуждения (приоритет — влияние × изменяемость).
+4. **Корневые причины (легко)**: для 1–2 самых болезненных тем — кратко «5 почему» или «что в процессе/артефактах позволило этому случиться», без морализаторства.
+5. **Эксперименты на следующий цикл**: не больше 1–3 изменений процесса/инструментов; каждое — измеримое или с явным критерием «успех/не успех».
+6. **Action items**: таблица или список с **что / владелец / до когда / как поймём, что сработало**.
+
+## Формат ответа агента
+
+- Краткая **шапка**: период, фокус, допущения (если были).
+- **Повестка** или итог по этапам выше.
+- **Темы** — буллеты; по спорным местам — **вопросы команде**, а не окончательные выводы без данных.
+- **Решения и эксперименты** отдельным блоком.
+- **Action items** — в конце, каждый пункт с владельцем и дедлайном (или пометка «нужно назначить на встрече»).
+
+## Ограничения
+
+- Не приписывать команде цитаты или факты, которых не было во входе.
+- Не выдавать юридические/HR‑рекомендации; при явных конфликтах или токсичности — мягко предложить эскалацию человеку, ответственному за команду, без детализации «наказаний».
+- Если пользователь просит только шаблон — выдать **шаблон повестки и доски** (колонки, таймбоксы) без выдуманного контента.
+
+### Metrics evidence
+
+When `metrics.json` exists, run the local aggregation script and report the cohort, sample size, incomplete artifacts, attribution confidence, active attempt duration, and human-gate wait separately. Do not treat gate wait or malformed ledgers as agent duration.

package/presets/claude/svelte/hooks/README.md

@@ -0,0 +1,14 @@
+# `.claude/hooks` (preset svelte)
+
+| File | Purpose |
+|------|---------|
+| `chain-team-phases.sh` | Pipeline chaining after subagent stop; `skipIf`, parallel, `validation_failed`, `retryAfterFix` |
+| `guard-shell-command.sh` | Destructive git / package-manager guard |
+
+Wire into Claude Code hooks per project documentation when enabling agent team auto-chain.
+
+## Optional cookbook
+
+Example scripts live in `hooks/examples/` (secret-guard, format-edited, test-on-save). They are **not** auto-enabled.
+
+To wire in Claude Code: copy an `.example.sh` into `hooks/`, make executable, and register per [Claude Code hooks](https://code.claude.com/docs/en/hooks) for your project. Keep stack-safe recipes (this preset: **svelte**). Cursor twin examples under `presets/cursor/svelte/hooks/examples/` are the same allowlist forks.